Yuxi
结合 RAG 与知识图谱的多租户智能体平台
让企业知识可被检索、推理，并由智能体交付
[](https://github.com/xerrors/Yuxi/blob/main/docker-compose.yml)
[](https://github.com/xerrors/Yuxi/issues)
[](https://github.com/xerrors/Yuxi/blob/main/LICENSE)
[](https://deepwiki.com/xerrors/Yuxi)
[](https://zread.ai/xerrors/Yuxi)
[](https://www.bilibili.com/video/BV1TZEx6NEit/)
[[Docs]](https://xerrors.github.io/Yuxi) · [[中文]](README.md)
**图片由 GPT-Image-2 生成。**
## 简介
Yuxi 是一个由大语言模型（LLM）驱动的平台，用于构建知识库与知识图谱智能体。它将 **RAG 检索**、**基于 Milvus 的知识库内图谱**，以及 **LangGraph 多智能体编排** 统一于单一多租户工作空间：管理员配置知识库、模型与权限，用户则可在类 ChatGPT 的界面中与智能体对话——智能体可挂载 Skills、MCP、子智能体（SubAgents）与沙箱工具，并获得附带引用来源、基于图谱的推理以及可交付产物的回答。
导航：[简介](https://xerrors.github.io/Yuxi/) ｜ [快速开始](https://xerrors.github.io/Yuxi/intro/quick-start) ｜ [路线图](https://xerrors.github.io/Yuxi/develop-guides/roadmap); 最新更新请参见 [更新日志](https://xerrors.github.io/Yuxi/develop-guides/changelog).
## 核心功能
- 🤖 **智能体开发** — 基于 LangGraph，支持子智能体（SubAgents）、Skills、MCP、Tools 与中间件；长时间运行的任务在后台 worker 上异步执行，并由沙箱文件系统支持工具产物的持久化、预览与下载。
- 📚 **知识库（RAG）** — 多格式文档解析（MinerU / PaddleX / OCR），可配置 Embedding 与 Rerank 模型，知识库评测，应用内 PDF / 图片预览，检索来源回填为对话引用。
- 🕸️ **知识图谱** — 在 Milvus 知识库内构建、可视化并检索实体关系图谱，再将图谱命中与分块检索融合，供智能体推理使用。
- 🏢 **多租户与权限** — 用户 / 部门级访问控制，统一的模型提供商配置，以及面向外部系统集成的 API Key 认证。
- ⚙️ **平台与工程** — Vue + FastAPI 架构，开箱即用的 Docker Compose 部署，深色模式，轻量级 LITE 启动模式，以及生产级编排能力。
## 技术栈
| 层级 | 技术 |
| --- | --- |
| 前端 | Vue 3 · Vite · Pinia |
| 后端 | FastAPI · LangGraph · ARQ（异步 worker） |
| 存储 | PostgreSQL · Redis · MinIO · Milvus · Neo4j |
| 文档解析 | MinerU · PaddleX · RapidOCR |
| 部署 | Docker Compose |
## 快速开始
**前置条件**：[Docker](https://docs.docker.com/get-docker/) 与 Docker Compose 已安装，并至少拥有一个兼容 OpenAI 的 LLM API。
**1. 克隆并初始化**
```bash
git clone --branch v0.7.1.beta1 --depth 1 https://github.com/xerrors/Yuxi.git
cd Yuxi
# Linux/macOS
./scripts/init.sh
# Windows PowerShell
.\scripts\init.ps1
```
**2. 使用 Docker 启动**
```bash
docker compose up --build
```
**3. 打开平台**
服务就绪后，在浏览器中打开 `http://localhost:5173`，并使用初始化时生成的管理员账号登录。
> 💡 若不需要知识库 / 图谱等重型依赖，可运行 `make up-lite` 以启用轻量级 LITE 模式，冷启动更快。更多部署细节请参阅[文档](https://xerrors.github.io/Yuxi)。
## 示例与演示
