代码拉取完成，页面将自动刷新
学习链接 https://u.geekbang.org/subject/airag/1009927
一个从零开始实现的 RAG (Retrieval Augmented Generation) 系统，不依赖现有的 RAG 框架。该项目旨在提供一个轻量级、可定制的知识库问答解决方案。
本项目是一个完全自主实现的 RAG 系统，通过将文档分块、向量化存储、相似度检索等核心功能模块化实现，使用户能够构建自己的知识库问答系统。
你可以通过克隆此仓库到你的本地机器来开始：
git clone https://github.com/huangjia2019/rag-project01-framework.git
然后导航至目录，并按照部署前端或后端的指示开始操作。
cd frontend/）。npm -vsudo apt updatesudo apt install nodejs npm -ynode版本为v22.14.0 ， npm版本为10.9.2npm install 命令来安装项目依赖的前端组件。修改frontend\src\config\config.js中的代码环境地址apiBaseUrl
const config = {
development: {
apiBaseUrl: 'http://192.168.172.128:8001'
},
production: {
apiBaseUrl: 'http://api.example.com'
},
test: {
apiBaseUrl: 'http://localhost:8001'
}
};
运行 npm run dev 命令来安装项目依赖的前端组件。
# 默认是 development 环境
npm run dev
# 或者指定环境
npm run dev -- --mode production
node版本为v22.14.0 ， npm版本为10.9.2# 1. 安装Homebrew（若未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 2. 更新Homebrew
brew update
# 3. 安装Node.js（含npm）
brew install node
# 4. 验证安装
node -v # 输出Node.js版本号
npm -v # 输出npm版本号
# 进入前端项目目录并安装依赖
cd frontend && npm install
# 如果提示vite未安装，执行以下命令
npm install vite
# 启动项目
npm run dev
本项目使用 Python v3.10 开发，完整 Python 依赖软件包见requirements_ubun.txt 和 requirements_win.txt。
Windows 环境： requirements_win.txt
Ubuntu 环境： requirements_ubun.txt
关键依赖的官方文档如下：
mkdir -p ~/miniconda3
wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh -O ~/miniconda3/miniconda.sh
bash ~/miniconda3/miniconda.sh -b -u -p ~/miniconda3
rm -rf ~/miniconda3/miniconda.sh
安装完成后，建议新建一个 Python 虚拟环境，命名为 langchain。
conda create -n rag-project01 python=3.11.9
# 激活环境
conda activate rag-project01
注意： MacOS需要移除所有 NVIDIA 相关依赖和 tritonclient==3.0.0，以避免不必要的依赖安装。
# ubuntu
pip install -r requirements_ubun.txt
# mac
pip install -r requirements_mac.txt
根据你使用的命令行工具，在 ~/.bashrc 或 ~/.zshrc 中配置 OPENAI_API_KEY 环境变量：
export OPENAI_API_KEY="xxxx"
export DEEPSEEK_API_KEY="xxxx"
上述开发环境安装完成后，使用uvicorn启动后端
# 进入后端代码目录
cd backend/
# 启动
uvicorn main:app --reload --port 8001 --host 0.0.0.0
(请确保您的后端主文件是 main.py 并且 FastAPI 应用实例名为 app。如果端口 8001 被占用，请更换为其他可用端口。)
这条命令是使用 Uvicorn 运行一个 ASGI (Asynchronous Server Gateway Interface) 应用程序的指令。让我们分解一下它的各个部分：
uvicorn: 这是 Uvicorn 的命令行接口。Uvicorn 是一个闪电般快速的 ASGI 服务器，基于 uvloop 和 httptools 构建。它主要用于运行现代 Python Web 框架，如 FastAPI 和 Starlette。
main:app: 这部分指定了要运行的 ASGI 应用程序的位置。
main: 这通常指的是一个名为 main.py 的 Python 文件（模块）。
app: 这指的是在 main.py 文件中定义的一个名为 app的变量。这个变量应该是一个 ASGI 应用程序实例。例如，如果你在使用 FastAPI，你可能会在 main.py 中有类似这样的代码：
from fastapi import FastAPI
app = FastAPI()
@app.get("/")
async def read_root():
return {"Hello": "World"}
--reload: 这是一个非常有用的开发选项。当使用这个标志时，Uvicorn 会监视你的应用程序代码文件的更改。一旦检测到任何更改，它会自动重新启动服务器。这使得在开发过程中可以快速迭代，而无需手动停止和启动服务器。
--port 8001: 这个选项指定了 Uvicorn 服务器应该监听的网络端口。在这里，服务器将被配置为在 8001 端口上接收传入的 HTTP 请求。如果不指定端口，Uvicorn 默认会使用 8000 端口。
总而言之，这条命令的作用是：
启动 Uvicorn ASGI 服务器，加载 main.py 文件中名为 app 的 ASGI 应用程序。服务器将在 8001 端口上监听传入的请求，并且在应用程序代码发生更改时自动重新加载。
这通常是在开发基于 ASGI 框架（如 FastAPI 或 Starlette）构建的 Web 应用程序时启动服务器的标准命令。
bac
├── main.py # 主入口文件
│
├── services/ # 服务层目录
│ ├── archive/ # 归档服务目录
│ │ └── vector_store_service_langchain.py # LangChain向量存储实现
│ │
│ ├── chunking_service.py # 文本分块服务
│ ├── embedding_service.py # 文本嵌入服务
│ ├── generation_service.py # 内容生成服务
│ ├── loading_service.py # 数据加载服务
│ ├── parsing_service.py # 文本解析服务
│ ├── search_service.py # 搜索服务
│ └── vector_store_service.py # 向量存储基础服务
│
└── utils/ # 工具目录
└── config.py # 配置文件
frontend/
├── public/ # 静态资源目录
│ └── vite.svg # Vite logo
├── src/ # 源代码目录
│ ├── assets/ # 项目资源文件(图片、字体等)
│ ├── components/ # 可复用的 React 组件
│ ├── pages/ # 页面级组件
│ ├── App.css # App 组件样式
│ ├── App.jsx # 根组件
│ ├── index.css # 全局样式
│ └── main.jsx # 应用入口文件
├── .gitignore # Git 忽略文件配置
├── eslint.config.js # ESLint 代码规范配置
├── index.html # 项目 HTML 模板
├── note.txt # 项目笔记
├── package.json # 项目依赖和脚本配置
├── package-lock.json # 依赖版本锁定文件
├── postcss.config.js # PostCSS 配置
├── README.md # 项目说明文档
├── tailwind.config.js # Tailwind CSS 配置
└── vite.config.js # Vite 构建工具配置
npm run dev
> frontend-241123@0.0.0 dev
> vite
file:///root/AI-Box/code/rag/rag-project01-framework/frontend/node_modules/vite/bin/vite.js:7
await import('source-map-support').then((r) => r.default.install())
^^^^^
SyntaxError: Unexpected reserved word
at Loader.moduleStrategy (internal/modules/esm/translators.js:133:18)
at async link (internal/modules/esm/module_job.js:42:21)
这个错误通常是因为 Node.js 版本过低导致的。Vite 需要 Node.js 14.18+ 或 16+ 版本才能正常运行。让我们来解决这个问题：
node -v
方法 1：使用 nvm（Node Version Manager）安装新版本（推荐）：
# 如果还没有安装 nvm，先安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
# 重新加载 shell 配置
source ~/.bashrc # 或 source ~/.zshrc
# 安装最新的 LTS 版本的 Node.js
nvm install --lts
# 使用新安装的版本
nvm use --lts
方法 2：直接通过包管理器更新（以 Ubuntu/Debian 为例）：
# 添加 NodeSource 仓库
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
# 安装 Node.js
sudo apt-get install -y nodejs
node -v
npm -v
cd /path/to/your/frontend/project
rm -rf node_modules package-lock.json
npm install
npm run dev
这样应该就能解决启动错误的问题了。如果还有其他问题，请告诉我具体的错误信息。
此处可能存在不合适展示的内容，页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容，可点击提交进行申诉，我们将尽快为您处理。
马建仓 AI 助手