下载并运行自制RAG框架

项目部署

https://github.com/huangjia2019/rag-project01-framework

git clone https://github.com/huangjia2019/rag-project01-framework.git

 一 、 前端分部分部署

在 Ubuntu 系统 上安装 Node.js 和 npm（Node Package Manager），并初始化一个前端项目的步骤记录。

1. 检查 Node.js/npm 版本

• 命令：

  npm -v

• 输出：

  • 表示当前已安装的 npm 版本是 10.8.2 。

---

2. 在 Ubuntu 上安装 Node.js 和 npm

• 更新软件包列表：

  sudo apt update

• 安装 Node.js 和 npm：

  sudo apt install nodejs npm -y

  • 通过 Ubuntu 的默认软件源安装，但这种方式安装的版本可能较旧（建议后续通过 nvm 安装最新版）。

---

3. 初始化前端项目

• 进入前端目录：

  • 用户进入前端项目目录后运行了 npm install。
    

• 安装结果：

  • 添加了 343 个依赖包，检测到 344 个包。

  • 提示有 3 个中等严重性漏洞，建议运行以下命令修复：

    npm audit fix

  • 还提示 127 个依赖包正在寻求资助（可通过 npm fund 查看）。

启动前端页面

npm run dev

 

二、后端部分部署

RAG-FRAMEWORK 项目的后端部分配置 Python 虚拟环境 并安装依赖项的步骤说明。以下是详细解析：

---

1. 进入后端目录

---

2. 配置 Python 虚拟环境

步骤说明

1. 创建虚拟环境：

   python -m venv Project01

   • 生成一个名为 Project01 的虚拟环境目录，隔离项目依赖。

2. 激活虚拟环境：

   • Linux/macOS：

     source Project01/bin/activate
     
     

   • Windows：

     Project01\Scripts\activate

3. 安装依赖：

   pip install -r requirements_ubun.txt

• 需注意：实际应使用 requirements_win.txt 或 requirements_ubun.txt。

 

---

3. 进入后端目录并启动后端服务

• 使用 Uvicorn 运行 FastAPI 应用：

  uvicorn main:app --reload --port 8001

  • 参数说明：

    • main:app：表示从 main.py 文件中导入 app 实例（FastAPI 应用对象）。

    • --reload：开发模式，代码修改后自动重启服务。

    • --port 8001：指定服务端口为 8001（默认是 8000）。

• 预期输出：

  INFO:     Uvicorn running on http://127.0.0.1:8001 (Press CTRL+C to quit)
  
  

  服务启动后，可通过浏览器或工具（如 curl、Postman）访问 API。
   

三、 再次访问并使用前端界面