项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 7627
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- 已安装 Docker Engine 与 Docker Compose
- 准备一个可用的大模型 API(用于接入模型能力)
- 当前仓库默认配置对应 v0.7.3 版本
安装与启动步骤
-
1获取代码
按 v0.7.3 标签浅克隆仓库,只拉取该版本代码,避免拉取完整历史。
git clone --branch v0.7.3 --depth 1 https://github.com/xerrors/Yuxi.git cd Yuxi -
2启动开发环境
用 Docker Compose 构建并后台启动全部服务,首次构建耗时较长,请耐心等待。
docker compose up --build -d -
3查看服务状态
确认各容器是否正常运行,并检查后端就绪接口是否返回 ready。
docker compose ps curl --fail http://localhost:5050/api/system/ready -
4初始化管理员并登录
浏览器打开前端地址,按页面提示初始化超级管理员账号后登录使用。
如何确认成功
curl 就绪接口返回的 status 为 ready,且能打开 http://localhost:5173 完成超级管理员初始化并登录。
常见问题
Q:如何初始化超级管理员账号?
A:打开 http://localhost:5173,按页面提示完成超级管理员的初始化设置,然后使用该账号登录平台。
Q:后端 API 文档在哪里查看?
A:服务启动后访问 http://localhost:5050/docs 即可查看 FastAPI 自动生成的接口文档。
Q:从 v0.7.1 或 v0.7.2 升级能直接 docker compose up 吗?
A:不能。需先阅读 docs/advanced/deployment.md 的生产部署与升级说明,在停机窗口内完成备份和数据迁移。
Q:平台支持接入哪些大模型?
A:支持 OpenAI、Anthropic、DeepSeek、Qwen 以及本地 Ollama、vLLM 等主流供应商,凭据可集中管理。
注意事项
- 必须提前准备一个可用的大模型 API,否则模型能力无法正常调用。
- 首次执行 docker compose up --build -d 会构建镜像,耗时可能较久。
- 升级场景不要直接执行 docker compose up,需按官方文档在停机窗口做备份与迁移。
- 前端默认地址为 http://localhost:5173,后端默认地址为 http://localhost:5050。
核心亮点
- 深度整合 LightRAG 与知识图谱,回答更准确且可追溯
- 多租户架构,适合企业级隔离与权限管理
- 内置 MinerU PDF 解析,开箱即用处理文档知识
不足之处
- 项目较新,文档和社区生态尚待完善
- 依赖组件较多(Neo4j、FastAPI 等),部署复杂度较高
适用场景
- 企业私有知识库智能问答助手
- 多租户 SaaS 平台的知识代理后端
- 结合知识图谱的复杂文档分析与推理
替代项目
Dify、FastGPT、RAGFlow
上一篇:garden-skills
下一篇:LaVague
同类项目推荐
wuphf
开源
一键拉起AI同事团队,共享上下文协同干活
open source grok bot. gawk bots automate your menial work via AI models and build yo···
ai-companion-kit
开源
让 AI 有记忆会聊天,还能用 adb 操控你的安卓手机
给你的 AI 一副身体,和一点人味 —— 会记事、会看场合的 QQ 陪聊 + 能控制安卓手机的 MC···
wallfacer
开源
让 AI 自主写代码,你随时可以接管控制。
Chat, specs, tasks, and code. An autonomous engineering platform. Full autonomy when···
opencow
开源
每个任务配一个专属AI智能体,并行交付结果
One task, one agent, delivered. The open-source platform for task-driven autonomous ···
gru-ai
开源
让 AI 团队帮你从想法到上线,一个人也能开公司。
Autonomous AI agent team for one-man companies. Context engineering + harness engine···
collie
开源
手机随时管 herdr 智能体,推送通知+快捷操作,远程无忧
Herdr mobile client for iPhone and Android. A self-hosted PWA to drive Claude Code, ···
Octopus-SI-OS
开源
用操作系统思路调度智能体,让 AI 稳定执行桌面任务
A self-evolving agentic OS. A new architecture for agent execution, built on operati···
caspian-sdk
开源
一套 SDK,让 AI 智能体打通所有主流通信渠道
Agent communication SDK. The open-source agent communication layer for AI agents — ···
Wegent
开源
像管团队一样管 AI,让多智能体自动协作干活
Plan, build, and deliver with an open-source, self-hostable AI workspace for coding,···
