xerrors/Yuxi

Yuxi – プライベートデプロイ、マルチテナント知識エージェントプラットフォーム

概要 – Yuxi（発音は「ユンシー」）は、RAG エンジン、ナレッジグラフビルダー、LangGraph ベースのマルチエージェントオーケストレーション、サンドボックス化されたファイルツール、きめ細かいチームレベルの権限管理を単一の Docker Compose スタックにバンドルしています。これは、自社の AI エージェントをオンプレミスで実行し、データとモデル資格情報を社内に保持し、多くのユーザーがカスタムエージェントを作成して共有できるようにしたい企業を対象としています。

コア機能

モジュール	機能
統合エージェントワークベンチ	チャット、ツール呼び出し、タスクステータス、ファイルダウンロードのための Web 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 を返す自動レポート生成。
• 技術文書から抽出されたエンティティをリンクする、研究開発チーム向けのナレッジグラフ駆動のディスカバリー。
• 人間による承認を伴う多段階ワークフロー自動化（例: 法的契約書の作成）。

拡張性

• 組み込みのプラグインマネージャーを使用して新しいスキルを追加（スクリプトのインストール、権限の設定）。
• カスタムモデルバックエンド用に追加の MCP サービスを接続。
• 統合リトリーバーを介して Dify や Notion などの外部知識ソースを接続。

ライセンス – Yuxi コードベースは MIT ライセンス。サードパーティコンポーネントは元のライセンスを保持（LICENSE とデプロイメントドキュメントを参照）。

リソース

• プロジェクトサイト: https://xerrors.github.io/Yuxi/
• ドキュメント: クイックスタート、モデル設定、ナレッジベース、エージェント設定、デプロイメント。
• デモビデオ: README の Bilibili リンク。
• スポンサー: Fluxion AI（割引モデル API アクセス）。

---

Yuxi は、企業がプライベートドキュメントとグラフ構造化知識を推論する AI エージェントを構築、実行、管理できるようにするフルスタックのセルフホストプラットフォームです。