EpicStaff/EpicStaff

Source-available, self-hosted platform for building AI agent flows - visual editor over a Django backend.

EpicStaff – セルフホスト型 AI エージェントオーケストレーションプラットフォーム

概要 – EpicStaff は、チームがマルチエージェント AI ワークフローを設計、実行、監査できるソース利用可能なウェブアプリケーションです。ビジュアルなノードベースのエディタが Django バックエンド上に構築されており、各ノードにはカスタム Python コード、LLM/エンベッダーへの呼び出し、内蔵ベクターストアに対する RAG、または MCP プロトコルを介した統合を含めることができます。スタック全体が Docker（または Podman）で自社サーバー上で実行されるため、運用チームはフローに対する完全な所有権、セキュリティ、監査可能性を維持できます。

重要性 – 現在の LLM エージェントのほとんどは、エンジニアだけが読んだり変更したりできるスクリプトとしてコード化されています。EpicStaff は、統合を構築するエンジニアと、プロセスを所有、検査、制御する必要がある運用・監査担当者の間のギャップを埋めます。エージェントが行うすべての決定はセッションレジャーに永続化され、コードを再デプロイすることなく UI でレビューまたは編集できます。

クイックスタート（3 ステップの要約）

Git と Docker（または Podman）をインストールします。

リポジトリをクローンし、環境ファイルのサンプルをコピーします：

git clone https://github.com/EpicStaff/EpicStaff.git && cd EpicStaff/src
cp .env.example .env

Docker Compose スタックを実行します（README のスクリプトがシークレットキーを生成し、必要なボリュームとネットワークを作成します）：
```
docker compose up --build
```
その後、ブラウザで http://localhost を開き、ビジュアルなワークフロービルダーを起動します。

コア技術機能（AI エンジニア向け）

機能	説明
ノードベース UI	ドラッグ＆ドロップのグラフエディタ。各ノードにカスタム Python、LLM 呼び出し、RAG ロジックを保持できます。
LLM およびエンベッダープロバイダー	OpenAI、Anthropic、セルフホストモデルを切り替え可能。互換性のある推論エンドポイントをプラグインできます。
検索拡張生成（RAG）	UI から直接ドキュメントをアップロードし、ベクターインデックス（Naive または GraphRAG）を構築。エージェントは実行中にクエリできます。
カスタム Python ツール	任意の Python 関数を作成し、エージェントノードから呼び出し可能なツールとして利用できます。
永続的なエージェントメモリ	短期のウィンドウコンテキストと長期の状態を PostgreSQL（pgvector）と Redis に保存し、セッション間で共有します。
Webhook と API トリガー	HTTP POST でフローを開始でき、CRM やチケットシステムなどとの統合が可能です。
本番対応の永続化	ユーザー/組織変数の状態管理が組み込まれており、すべての決定がセッションレジャーに記録されます。
Django バックエンド	堅牢で低遅延の Python サーバーがグラフを実行し、エージェントごとの権限を強制し、監査証跡を提供します。

ビジネス向けの利点

ビジュアルワークフロービルダー により、非技術系の運用スタッフがコードに触れずに自動化を作成・変更できます。
エンタープライズセキュリティ – ロールベースのアクセス制御とエージェントごとの権限を備えています。
監査可能性 – エージェントのすべての決定が保存され、検査やロールバックが可能です。
マルチエージェントコラボレーション – 複数のエージェントが連携して部門全体を自動化する「デジタルクルー」を構築できます。
拡張可能な Python ツール により、内部 API との統合が無限に可能です。
音声およびウェブスクレイピング機能 により、ハンズフリーのデータ収集とコンテンツ生成が可能です。

EpicStaff を最大限に活用するために

UI でエージェントを定義し、適切な LLM プロバイダーと必要なカスタム Python ツールをアタッチします。
ナレッジコレクションを作成（ドキュメントをアップロードしてインデックス化）して、RAG による応答を強化したい場合に備えます。
内部システムに接続 – MCP または直接の Python 呼び出しを使用。プラットフォームは実行をサンドボックス化し、設定した権限を強制します。
デプロイ – Docker スタックを自社サーバーまたはプライベートクラウドに展開します。提供されている cosign 検証ワークフローを使用して、イメージの信頼性を確保します。
監視と監査 – 組み込みのフローメッセージとセッションレジャーを通じて実行。必要に応じて手動レビューのために任意のステップを一時停止できます。

コミュニティと貢献

EpicStaff では、プルリクエスト、問題報告、新しいツールの貢献を歓迎しています。このプロジェクトは、Foblex コミュニティのオープンソース f‑flow ライブラリに基づいており、リポジトリには詳細な貢献ガイドライン（CONTRIBUTING.md）が含まれています。スターとフォークは通常の GitHub シールドで追跡されます。

要約 – EpicStaff は、マルチエージェント AI ワークフローの構築、実行、監査のための、セルフホスト型で Django をバックエンドにしたビジュアルプラットフォームを提供します。ドラッグ＆ドロップのオーケストレーション、永続メモリ、RAG、カスタム Python ツールを組み合わせ、エンタープライズグレードのセキュリティと完全な監査可能性を実現します。