Rusty Llama 开源项目快速入门指南

Rusty Llama 开源项目快速入门指南

rusty_llama A simple ChatGPT clone in Rust on both the frontend and backend. Uses open source language models and TailwindCSS. 项目地址: https://gitcode.com/gh_mirrors/ru/rusty_llama

项目概述

Rusty Llama 是一个精简版的 ChatGPT 克隆应用，它完全使用 Rust 编写，包括前端和后端。这个项目结合了开源语言模型和 TailwindCSS 来创建交互式的聊天界面，展示了如何利用 Rust 构建高性能的Web应用程序。

1. 项目目录结构及介绍

项目采用了清晰的分层结构来确保代码的组织性与可维护性：

• src: 核心代码所在目录，包括前端和后端的实现。

  • main.rs: Rust 后端的主入口点，这里处理服务器的设置和逻辑流程。
  • 前端部分虽然提到了，但在给出的信息中没有详细列出具体的文件夹结构，通常可能包含用Rust编写的WebAssembly（wasm）代码或与前端框架集成的相关文件。

• assets: 存放静态资源，比如图片、图标等。

• styles: 包含CSS样式，特别是TailwindCSS配置和输出的CSS文件。

• .env: 包含环境变量配置，如模型路径(MODEL_PATH)等。

• Cargo.toml: Rust项目的元数据和依赖管理文件。

• Cargo.lock, rust-toolchain.toml: 分别锁定当前项目的依赖版本和指定Rust工具链版本。

• 其他: 如.gitignore, LICENSE, 和README.md等标准项目文件。

2. 项目的启动文件介绍

要运行Rusty Llama，核心在于两个主要步骤：服务端的启动与前端资源的准备。

后端启动

• 使用命令行工具，首先确保已安装所需的Rust工具链，包括夜间版(nightly)及其必要的组件，例如wasm32-unknown-unknown目标、trunk和cargo-leptos工具。
• 在终端里，进入项目根目录并执行cargo leptos watch来启动后端服务。

前端资源编译

• 安装TailwindCSS，运行npm install -D tailwindcss。
• 编译前端样式，执行npx tailwindcss -i ./input.css -o ./style/output.css --watch，这将监控input.css的更改并实时编译到output.css。

3. 项目的配置文件介绍

• .env: 这个文件是项目的关键配置点，定义了MODEL_PATH变量，你需要将其替换为你所选择的GGML格式的模型文件的全路径。模型可以从开源社区获取，如Wizard-Vicuna系列的模型。
• Cargo.toml: 此文件配置了项目的所有外部依赖项，还包括了编译时的特性标志（如启用或禁用Metal加速）。在开发过程中，你可能需要调整特性标志来适配不同的硬件环境。
• 其它配置：虽然直接的配置文件不多，但Cargo.toml中的配置对于控制项目编译和特性至关重要，尤其是当涉及到不同平台的支持或特定于部署的设置时。

---

遵循以上步骤，你就能顺利搭建和运行Rusty Llama项目，体验用Rust构建的高效且现代化的Web应用开发。

rusty_llama A simple ChatGPT clone in Rust on both the frontend and backend. Uses open source language models and TailwindCSS. 项目地址: https://gitcode.com/gh_mirrors/ru/rusty_llama