一、项目介绍

想搭一个能对话、能跑智能体、还能接工具的自托管 AI 平台，最头疼的是“前后端、数据库、模型接入全要拼”：你只想要一个开箱即用、 docker 起就用的底座，却被部署复杂度劝退。
Yuxi 是一个开箱即用的自托管 AI 智能体平台。它把对话、智能体编排、工具与后端服务打包成容器化方案，一条 docker compose 拉起，并暴露健康检查接口，让个人与团队快速拥有自己的 AI 工作台。

二、项目基本信息

信息项详情
项目名称Yuxi
GitHub地址https://github.com/xerrors/Yuxi
项目描述可私有部署的多租户知识智能体平台：统一 RAG、知识图谱、多智能体、MCP/Skills、沙盒与权限管理。Yuxi = Cloud Agents + Knowledge RAG, Self-hosted knowledge agent platform for RAG, knowledge graphs and multi-agent workflows.
作者xerrors
开源协议MIT License
开源状态公开
LanguagesPython
支持平台Windows / macOS / Linux
最后更新2026-10-29

三、核心优势

  • 容器化一键部署，开箱即用
  • 内置对话与智能体编排能力
  • 暴露健康检查接口，便于运维
  • 自托管，数据留在自己环境
  • 跨平台，桌面与服务器皆可运行

四、适用场景

适合想要快速自托管 AI 智能体平台、不愿从零拼前后端与模型的个人与团队。

五、安装教程

当前最新版本 latest。按下方命令安装（如遇网络问题可切换镜像源或代理）：

# 克隆指定版本
git clone --branch v0.8.0.beta5 --depth 1 https://github.com/xerrors/Yuxi.git
cd Yuxi

常见报错：依赖缺失时先升级运行环境（Node、Python、Go、JDK 等）到项目要求版本；网络超时多为镜像或代理问题，可重试或换源。权限类报错请确认已登录对应平台账号。

六、使用示例

下面是一段可直接参考的真实示例：

# 用容器编排启动
docker compose --profile container config --quiet
docker compose --profile container up --build -d
# 查看运行状态并做健康检查
docker compose --profile container ps
curl --fail http://localhost:5050/api/system/ready

七、常见问题

问：必须 Docker 吗？答：官方提供 docker compose 编排，最省事。问：模型从哪来？答：平台对接你配置的模型服务，自托管由你掌控密钥与数据。

八、总结

Yuxi 用一个清晰的设计，把把基础设施变成一键可用的服务这件反复劳动变成了可复用、可维护的能力。它不追求大而全，而是把核心痛点解决得足够扎实——这正是日常开发与团队落地时最需要的那种工具。如果你也在被同类问题困扰，不妨按上面的安装与使用步骤试一试，把它接进自己的工作流。