Yuxi – Self-Hosted Multi-Tenant Knowledge Agent Platform
Unify RAG, knowledge graphs, multi-agent orchestration, MCP/Skills, sandbox, and permissions in one self-hosted platform.
- Source repo
- xerrors/Yuxi
- Stars
- ★ 7.4k
- Last updated
- 2d ago
- License
- MIT
- Primary language
- Python
- FA score
- 41/100 · Major gaps
At a glance
- How it runs
- Works with
- Universal · cross-platformOpenAI API
- Cost
- Free software; you pay for model usage
- Setup effort
- High · needs real infrastructure
- You'll need
- Typical use
- Enterprise knowledge management teams: need internal knowledge bases combined with graph reasoning to give employees accurate, cited answers via chat.
- Not a fit if
- Individuals wanting a zero-ops tool without databases or middleware
- Teams without resources for PostgreSQL, Milvus, Neo4j and more
- Source review
- 41/100 · Major gaps 3 safety controls not found
What does this agent do, and when should you use it?
Yuxi is a self-hosted, multi-tenant knowledge agent platform designed for teams. It combines RAG (Milvus-based), knowledge graphs (Neo4j and Milvus), LangGraph multi-agent orchestration, MCP/Skills, sandbox tools, and permission management in a single workbench. Administrators can connect model providers, build knowledge bases, and configure user and department permissions; users interact through a unified chat interface to access knowledge, tools, and subagents, receiving answers with source citations, graph-context reasoning, and downloadable artifacts. The platform deploys via Docker Compose, uses a Vue 3 frontend and FastAPI backend, and integrates DeepAgents as its deep agent framework. It acknowledges inspirations from LightRAG, DeerFlow, and RAGflow, and is licensed under MIT.
Yuxi runs a unified chat interface where users can ask questions and receive answers with source citations and knowledge-graph context. It executes LangGraph and DeepAgents-based agents, supporting subagents, Skills, MCP, tools, and middleware, with ARQ async workers for long-running tasks. Administrators configure model providers (OpenAI-compatible APIs) and API keys. The system extracts entities and relationships from knowledge-base documents, builds and retrieves knowledge graphs in Milvus and Neo4j, and visualizes subgraphs in the frontend. The sandbox provides an isolated filesystem where artifacts like text, images, PDFs, and HTML can be saved, previewed, and downloaded. The platform also includes user/department permission management, model provider configuration, and API key usage monitoring and evaluation.
- Enterprise knowledge management teams: need internal knowledge bases combined with graph reasoning to give employees accurate, cited answers via chat.
- AI application developers: want to integrate multi-agent, RAG, and knowledge graphs in a self-hosted platform to avoid external SaaS dependencies.
- Research institutions: require private deployment of knowledge bases and graphs to support literature retrieval and synthesis.
- IT operations staff: need multi-tenancy and user/department permission control to integrate the platform with existing model APIs.
- Document-heavy organizations: need to extract entities from documents and build knowledge graphs for complex queries.
- Teams requiring task delivery: use sandbox and tools to execute long-running tasks and generate downloadable artifacts like PDFs or HTML.
How do you install or deploy this agent?
Prerequisites: Docker and Docker Compose installed, plus at least one OpenAI-compatible LLM API.
- Clone and initialize:
git clone --branch v0.7.1 --depth 1 https://github.com/xerrors/Yuxi.git
cd Yuxi
# Linux/macOS
./scripts/init.sh
# Windows PowerShell
.\scripts\init.ps1- Start with Docker:
docker compose up --build- Access the platform: open http://localhost:5173 and log in with the admin account generated during initialization.
How do you use this agent?
After installation, log in with the admin account. Admins can configure model providers (OpenAI-compatible API), build knowledge bases (supporting multiple document formats), and set user/department permissions. Users interact through the unified chat interface, invoking knowledge bases, knowledge graphs, tools, subagents, etc. The system returns answers with citations and reasoning, and artifacts can be previewed and downloaded in the sandbox. For a lighter start without knowledge base/graph dependencies, use make up-lite to run in LITE mode for faster cold start. For detailed configuration, production deployment, and troubleshooting, see the project documentation (https://xerrors.github.io/Yuxi/intro/quick-start).
What are this agent's strengths and limitations?
- Integrates RAG, knowledge graphs, multi-agent, and sandbox into one platform, reducing integration overhead.
- Supports multi-tenancy and user/department permissions, designed for teams rather than single-user demos.
- Docker Compose provides a clear out-of-the-box deployment path.
- Artifacts can be previewed and downloaded, suitable for task delivery scenarios.
- MIT license allows commercial use and modification.
- Heavy dependency stack (PostgreSQL, Redis, MinIO, Milvus, Neo4j) requires significant resources.
- Requires at least one OpenAI-compatible LLM API, otherwise the platform cannot function.
- Early-stage project (v0.7.1) may have stability and documentation gaps.
- Sandbox security relies on Docker isolation; permission configuration is complex.
- Third-party components like Neo4j (GPL-3.0) and MinIO (AGPL-3.0) may impose license constraints on redistribution.
How does this agent compare with similar options?
The project references LightRAG, DeerFlow, and RAGflow as inspirations, but does not explicitly position Yuxi as a drop-in replacement. It can be seen as an integration and extension of these projects.
Key facts side by side with the most closely related agents.
| Agent | Source review | Form / cost | Stars | Updated | Language | Full support on |
|---|---|---|---|---|---|---|
| Yuxi – Self-Hosted Multi-Tenant Knowledge Agent Platform This agent | 41 · Major gaps | Self-hosted serviceFree + model costs | ★ 7.4k | 2d ago | Python | OpenAI API |
| Graphiti: Temporal Context Graph Engine for AI Agents | 50 · Major gaps | Library / SDKFree + model costs | ★ 32k | today | Python | OpenAI API · Claude API |
| SimpleMem: Efficient Lifelong Memory for LLM Agents | 43 · Major gaps | Library / SDKFree + model costs | ★ 3.8k | 2mo ago | Python | ChatGPT · Claude Code |
| EvoScientist: Self-Evolving AI Scientist | 51 · Major gaps | CLIFree + model costs | ★ 5k | 2d ago | Python | OpenAI API · Claude API |
How does FollowAgents rate this agent?
Why each dimension lost points
Evidence shows role-based access control (user/department permissions) and API key authentication, but no detailed implementation of least privilege. User confirmation mechanism not documented. Data flow transparency partial: README mentions retrieval sources backfilled as citations, but no data flow details. Sensitive data handling: API key authentication mentioned, but storage method not specified. Dependency security: no mention of vulnerability scanning or security audit. External effects: sandbox tools and file system mentioned, but sandbox isolation strength not specified. Rollback: not mentioned. Source attribution: README acknowledges several open-source projects, but no specific code references.
Self-consistency: README features align with code structure (e.g., FastAPI, LangGraph), but not deeply verified. Dependency availability: dependencies listed in README, but no version pinning or mirrors. Failure messages: test code has failure messages, but product docs do not explain error handling.
Audience and scenarios: README clearly states suitable for teams needing private deployment, organizational access control, multiple knowledge sources, and extensible agents. Capability boundaries: README states unsuitable scenarios (e.g., minimal single-document chat UI or fully managed SaaS). Trigger precision: no detailed description of agent trigger conditions. Environment fit: Docker Compose and LITE mode provided, but not all environment requirements.
Information architecture: README well-structured with navigation and doc links. Install notes: quick start steps provided, but no detailed configuration. Naming stability: no mention of API or config stability. Examples and FAQ: screenshots and demo provided, but no FAQ. Known limitations: not explicitly listed. License: MIT license, but third-party component licenses noted. Versioning and changelog: changelog link provided, but no specific content. Maintenance responsibility: no explicit maintainer or contribution guidelines.
Output usability: previewable, downloadable artifacts provided, but format not specified. Marginal value: knowledge graph and sandbox features compared to existing platforms, but not quantified. Cost-benefit: no performance or cost data.
Claim traceability: feature claims in README lack code references. Cross-source corroboration: no external verification. Fact-inference separation: no clear distinction between facts and inferences.
- Not found in source: confirmation before actingTurn on (or add) a confirmation step before it acts, and try it in a sandbox or test environment before real data.
- Not found in source: dependency securityPin versions and run a dependency audit (npm audit, pip-audit) before installing; prefer running it in a container.
- Not found in source: rollback or recovery pathBack up first, or work on a git branch or snapshot, so its changes can be undone.
- No detailed implementation of least privilege; permission model needs review.
- Storage and encryption of sensitive data (e.g., API keys) not specified.
- Dependency security not mentioned; check for vulnerabilities.
- Sandbox isolation strength not specified; needs verification.
- Rollback mechanism missing; needs confirmation.
Recent releases
Latest entries from the project's GitHub Releases. Notes are quoted from upstream as written, not rewritten or tested by FollowAgents.
-
v0.7.2 v0.7.2 正式版
Release notes excerpt
Yuxi v0.7.2 正式版 Yuxi v0.7.2 是自 v0.7.1 以来的一次完整运行时与工作区升级，重点重构了 Project/Workdir、Agent 调度与恢复、知识库处理、安全边界和 CLI 工具链。以下内容按 v0.7.1 → v0.7.2 汇总，包含 beta1、beta2 以及正式版收尾的全部主要变化。 主要更新 Project、Workspace 与持久化 - 新增 Project 业务资源，作为 Conversation Workdir 的持久化 Owner；支持创建、选择、更新和删除 Project，并完成侧边栏项目分组与生命周期同步。 - 顶层 Conversation 与子 Agent 共用稳定的 runtime scope，不同顶层 Conversation 即使绑定同一目录也保持运行隔离。 - 统一 UserWorkspace、Workdir、Viewer、附件和 artifact 的文件边界，移除开发期 file-bridge 与旧 Thread 文件浏览路径。 - 提供 v0.7.1 存储迁移流程，将历史 Conversation、附件、产物、共享 Skill 和运行身份迁移到新布局。 Agent 运行、队列与调试 …View on GitHub ↗ -
v0.7.1 v0.7.1 正式版
Release notes excerpt
Yuxi v0.7.1 正式版 Yuxi v0.7.1 重点增强了生产部署安全性、Agent 运行能力、知识库大规模文件处理能力，并正式完善了 Yuxi CLI 工具链。 主要更新 - 强化生产部署安全：隔离动态沙箱网络，引入 Sandbox Provisioner Token，收紧生产环境默认凭证、CORS、Dashboard 权限及 MinIO 访问边界。 - 增强 Agent 能力：支持异步子智能体、Agent Invocation、Agent Eval、Summary 上下文压缩状态、Token Usage 面板及图片 OCR 自动回退。 - 升级知识库体验：支持大规模文件分页与懒加载、增量思维导图、PaddleOCR 云端解析、分块策略接口及异步文档处理。 - 完善 Skills 与工具系统：知识库能力迁移为内置 Skill，新增 search_file、ocr_parse_file 等工具，并增强工具结果卸载与运行时配置同步。 - 发布 Yuxi CLI 0.1.3：支持浏览器/API Key 登录、知识库批量上传、重复文件预检、Agent Eval 及远程实例管理。 - 优化稳定性与性能：修复数据库连接长期占用、Redis SSE 连接竞争、Tasker 关闭死锁、Milvus 同步调用阻塞事件循环等问题。 重要升级说明 …View on GitHub ↗ -
Release notes excerpt
Yuxi 0.7.0 发布说明 > 发布日期：2026-06-13 · 许可证：MIT > 1. [版本变更记录](https://xerrors.github.io/Yuxi/develop-guides/changelog.html#v0-7-0-2026-06-13) 2. [语析 Yuxi 0.7 发布-小红书](http://xhslink.com/o/5Y6QWnmjF2d) 3. [开源语析 Yuxi 0.7 Beta 多智能体协同调度演示 - Bilibili](https://www.bilibili.com/video/BV1TZEx6NEit/?share_source=copy_web&vd_source=37b0bdbf95b72ea38b2dc959cfadc4d8) 4. [开源语析 Yuxi 0.7 知识库、知识图谱演示 - Bilibili](https://www.bilibili.com/video/BV1erE26iEgv/?share_source=copy_web&vd_source=37b0bdbf95b72ea38b2dc959cfadc4d8) --- …View on GitHub ↗
FAQ
What hardware resources are needed to deploy Yuxi?
How do I configure model providers?
How secure is the sandbox?
Does it support knowledge graph construction and query?
What are the limitations of LITE mode?
make up-lite) skips heavy dependencies like knowledge base and graph services, so those features may be unavailable. It is intended for rapid demos or testing.