How j2085123997/yuxi works
Yuxi is a self-hosted, multi-tenant knowledge-agent platform. Its main user journey is to submit a request in the workspace, have an Agent use knowledge retrieval and tools (including subagents where configured), then return a response or deliverable that can be previewed or downloaded. Separate product branches cover knowledge ingestion, graph exploration, evaluation, and team administration. The README documents these capabilities; the source excerpts provide only partial implementation evidence, so undocumented runtime links are omitted.
Main entry points: agents Agent runtime · routers FastAPI routers · manager.py Knowledge ingestion · auth_dept_router.py Users and departments
Components 21
Agent workspace
- Web application
web/src/App.vue - Chat interface
web/src/components/AgentChatComponent.vue - FastAPI routers
backend/server/routers - Chat service
backend/package/yuxi/services/chat_service.py
Knowledge services
- Knowledge ingestion
backend/package/yuxi/knowledge/manager.py - Parsing and chunking
backend/package/yuxi/knowledge/parser - Knowledge retrieval
backend/package/yuxi/knowledge/base.py - Knowledge graph
backend/package/yuxi/knowledge/graphs/milvus_graph_service.py - RAG evaluation
backend/package/yuxi/knowledge/eval/service.py - Milvus
backend/package/yuxi/knowledge/implementations/milvus.py - Neo4j
backend/package/yuxi/storage/neo4j/manager.py
Agent execution
- Agent runtime
backend/package/yuxi/agents - Subagents
backend/package/yuxi/agents/buildin/subagent/graph.py - Tools, Skills, MCP
backend/package/yuxi/agents/toolkits
Workspace delivery
- Sandbox workspace
backend/package/yuxi/workspace/filesystem.py - Artifact delivery
backend/package/yuxi/services/artifact_service.py
Team governance
- Authentication
backend/server/utils/auth_middleware.py - Users and departments
backend/server/routers/auth_dept_router.py - Resource permissions
backend/package/yuxi/permissions/resource_permission.py - PostgreSQL
backend/package/yuxi/storage/postgres/manager.py
Other components
- User
Connections 21
- User → Web application: uses
README.md - Web application → Chat interface: opens chat
README.md - Chat interface → FastAPI routers: submits requests
README.md - FastAPI routers → Chat service: handles chat
- Chat service → Agent runtime: runs Agent
- Agent runtime → Knowledge retrieval: retrieves context
README.md - Agent runtime → Tools, Skills, MCP: uses capabilities
README.md - Agent runtime → Subagents: dispatches tasks
README.md - Knowledge retrieval → Knowledge ingestion: queries indexed knowledge
backend/package/yuxi/knowledge/manager.py - Knowledge ingestion → Parsing and chunking: parses and chunks
README.md - Knowledge ingestion → Milvus: indexes chunks
README.md - Knowledge ingestion → Knowledge graph: extracts relations
README.md - Knowledge graph → Neo4j: stores graph
README.md - RAG evaluation → Knowledge retrieval: evaluates retrieval
README.md - Agent runtime → Sandbox workspace: works with files
README.md - Sandbox workspace → Artifact delivery: provides deliverables
README.md - FastAPI routers → Authentication: authenticates requests
backend/server/utils/auth_middleware.py - FastAPI routers → Users and departments: manages users
backend/server/routers/auth_dept_router.py - Users and departments → Resource permissions: sets access scope
README.md - Authentication → PostgreSQL: checks user records
backend/server/utils/auth_middleware.py - Users and departments → PostgreSQL: persists governance data