xerrors/Yuxi

Yuxi – 프라이빗 배포, 멀티 테넌트 지식 에이전트 플랫폼

정의 – Yuxi(발음: “윤시”)는 RAG 엔진, 지식 그래프 빌더, LangGraph 기반 멀티 에이전트 오케스트레이션, 샌드박스 파일 도구 및 세분화된 팀 수준 권한 관리를 단일 Docker Compose 스택에 번들로 제공합니다. 자체 AI 에이전트를 온프레미스에서 실행하고, 데이터와 모델 자격 증명을 내부에 유지하며, 많은 사용자가 맞춤형 에이전트를 만들고 공유할 수 있도록 하려는 기업을 대상으로 합니다.

핵심 기능

모듈	기능
통합 에이전트 워크벤치	채팅, 도구 호출, 작업 상태 및 파일 다운로드를 위한 웹 UI(Vue). @ 멘션을 지원하여 지식 베이스 문서, 개인 파일 또는 스킬을 불러옵니다.
지식 베이스 및 RAG	PDF, Word, PPT, Excel, Markdown 등을 업로드합니다. 자동 파싱(MinerU, PaddleOCR), 청킹, 임베딩 및 벡터 인덱싱(Milvus). 내장 리랭크 및 평가 대시보드(Langfuse 스타일).
지식 그래프	청크에서 엔티티/관계를 추출하여 Neo4j에 저장하고, 대화형 그래프 및 계층적 지식 맵으로 시각화합니다.
멀티 에이전트 및 확장성	기본 LLM을 구성하고 지식, 도구, 하위 에이전트, 스킬 및 MCP(모델 컨텍스트 프로토콜) 서비스를 연결합니다. 병렬 하위 에이전트 실행 및 플러그인 스킬을 지원합니다.
샌드박스 워크스페이스	에이전트를 위한 격리된 파일 시스템. 생성된 Markdown, HTML, CSV, 코드 등을 브라우저에서 미리 보고 다운로드할 수 있습니다.
팀 거버넌스	사용자, 부서 및 공유 범위를 갖춘 멀티 테넌트 모델. OpenAI, Anthropic, DeepSeek, Qwen, vLLM 등을 위한 중앙 집중식 API 키 볼트. 사용량, 토큰 소비 및 작업 큐에 대한 대시보드.

기술 스택

• 프론트엔드: Vue (http://localhost:5173) – 워크벤치, 관리 콘솔, 대시보드.
• 백엔드: FastAPI (http://localhost:5050) – REST API, OpenAPI 문서.
• 오케스트레이션: LangGraph를 사용한 에이전트 흐름 제어.
• 벡터 스토어: Milvus.
• 그래프 DB: Neo4j.
• 데이터베이스: PostgreSQL.
• 문서 파싱: MinerU, PaddleOCR, RapidOCR.
• 컨테이너화: Docker Compose(모든 서비스가 함께 시작).

빠른 시작

1. Docker Engine 및 Docker Compose를 설치합니다.
2. 태그 v0.7.3에서 리포지토리를 클론하고 ./scripts/init.sh(또는 PowerShell 해당 명령)를 실행하여 대형 모델 API 키(예: SiliconFlow)가 포함된 .env를 생성합니다.
3. docker compose up --build -d를 실행합니다.
4. http://localhost:5050/api/system/ready가 ready를 반환하면 http://localhost:5173을 열고 슈퍼 관리자를 만든 다음 지식 베이스, 에이전트 및 스킬 생성을 시작합니다.

일반적인 사용 사례

• 회사 매뉴얼, 정책 및 코드 베이스에서 답변하는 내부 헬프데스크 봇.
• 에이전트가 데이터를 가져오고 샌드박스에서 분석을 실행하고 형식화된 PDF/HTML을 반환하는 자동 보고서 생성.
• 기술 문서에서 추출된 엔티티를 연결하는 R&D 팀을 위한 지식 그래프 기반 발견.
• 인간 승인을 포함한 다단계 워크플로 자동화(예: 법률 계약 초안 작성).

확장성

• 내장 플러그인 관리자를 통해 새로운 스킬 추가(스크립트 설치, 권한 구성).
• 사용자 정의 모델 백엔드를 위한 추가 MCP 서비스 연결.
• 통합 리트리버를 통해 Dify 또는 Notion과 같은 외부 지식 소스 연결.

라이선스 – Yuxi 코드베이스는 MIT 라이선스입니다. 타사 구성 요소는 원래 라이선스를 유지합니다(LICENSE 및 배포 문서 참조).

리소스

• 프로젝트 사이트: https://xerrors.github.io/Yuxi/
• 문서: 빠른 시작, 모델 구성, 지식 베이스, 에이전트 구성, 배포.
• 데모 비디오: README의 Bilibili 링크.
• 스폰서: Fluxion AI(할인 모델 API 액세스).

---

Yuxi는 기업이 프라이빗 문서와 그래프 구조화 지식을 추론하는 AI 에이전트를 구축, 실행 및 관리할 수 있게 하는 풀스택 자체 호스팅 플랫폼입니다.