Yuxi

把知识库和图谱串起来,快速搭建多租户智能代理应用

Yuxi 是一个面向多租户场景的 Agent Harness 平台,核心定位是将知识库与知识图谱管理深度整合,为构建智能代理提供一体化基础设施。它基于 LangChain、Vue 和 FastAPI 构建,支持 DeepAgents、MinerU PDF 解析、Neo4j 图数据库以及 MCP 协议,解决了企业在复杂知识管理场景中难以统一调度代理、知识检索和图谱关联的问题。平台提供知识库管理、知识图谱构建与查询、多租户隔离、代理编排等核心能力,使开发者能够快速搭建基于私有知识库的智能问答、文档分析等应用。其亮点在于将 LightRAG 轻量级检索增强生成与知识图谱结合,提升回答的准确性和可解释性,同时通过 MCP 支持外部工具集成,扩展性强。总体而言,Yuxi 是一个面向企业级知识密集型场景的综合性 Agent 开发与运行平台。

开源 free 搜索知识
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 7171
维护状态 活跃
是否开源 是
定价模式 free

项目数据

分类搜索知识
开发团队xerrors
所属国家
定价模式free
价格说明开源项目,MIT许可证,可自行部署,无在线服务,完全免费。
访问状态
是否开源是
开源协议MIT
主要语言Python
技术栈/模型agentic-rag,ai-agents,deepagents,docker,document-ai,fastapi,harness,kbqa,kgqa,knowledge-base,knowledge-graph,langgraph,llms,mcp,milvus,multi-agent,neo4j,rag,self-hosted,vue
GitHub 星标★ 7171
30天Star增速
HF 下载量
上线时间2024-07-05 00:00:00
最近更新2026-09-22 00:00:00
维护状态活跃
中文支持
访问方式
移动端支持
综合评分
收录时间2026-08-09
浏览次数2

使用教程

难度:入门 约 15 分钟 部署方式:Docker 4 步

环境要求

  • 已安装 Docker Engine 与 Docker Compose
  • 准备一个可用的大模型 API(用于接入模型能力)
  • 当前仓库默认配置对应 v0.7.3 版本

安装与启动步骤

  1. 1获取代码

    按 v0.7.3 标签浅克隆仓库,只拉取该版本代码,避免拉取完整历史。

    git clone --branch v0.7.3 --depth 1 https://github.com/xerrors/Yuxi.git
    cd Yuxi
  2. 2启动开发环境

    用 Docker Compose 构建并后台启动全部服务,首次构建耗时较长,请耐心等待。

    docker compose up --build -d
  3. 3查看服务状态

    确认各容器是否正常运行,并检查后端就绪接口是否返回 ready。

    docker compose ps
    curl --fail http://localhost:5050/api/system/ready
  4. 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

项目介绍

Yuxi 是智能体领域的开源项目,由 xerrors 开发,2024 年首次发布。

在全站 13,014 个收录项目中,它的 GitHub 星标数(7,171)位列前 7%,在智能体分类的 2,499 个项目里位列前 7%。

近 41 天,它的 GitHub 星标从 6,440 增加到 7,171,净增 731。

项目目前处于活跃维护状态,最近一次代码更新于 2026-09-22。MIT许可证,可自行部署,无在线服务,完全免费。

它主要面向的使用场景是:企业私有知识库智能问答助手。同类可对比的替代方案包括 Dify、FastGPT、RAGFlow。

上一篇:garden-skills

下一篇:LaVague

同类项目推荐

xinchao-dynamic-mind 开源

给 AI 装上疲惫和欲望,让交互更真实

独立、可自托管的 AI 动态心智状态引擎:驱动力、念头池、疲惫、睡眠与意图。

★ 199 2026-08-09
deepseek-harness 开源

把 AI 能力拆成乐高积木,拼出你的专属智能体。

DeepSeek Harness: Everything is a Plugin.

★ 233327 2026-08-15
AutoGPT 开源

开箱即用的 AI 员工,交代任务就自己干完

AutoGPT is the vision of accessible AI for everyone, to use and to build on. Our mis···

★ 187492 2026-08-09
EvoAgentX 开源

让 AI 智能体自己迭代变强,越用越聪明

EvoAgentX: Building a Self-Evolving Ecosystem of AI Agents

★ 3351 2026-09-12