Agent Swarm

Agent Swarmは、Desplega Labsが開発した、オープンソースでセルフホスト可能なAI企業向けオペレーティングシステムです。

ヒント

このリポジトリは毎日進化しています。 今すぐウォッチ →

_{▸ すべてのチームをひとつのスウォームに · 日々の進化 · メイキング}

agent-swarm.devは、AIを活用した業務のためのオープンソースのオペレーティングシステムです。リードエージェントがClaude CodeやCodexなどのワーカーに目標を割り当てます。分離されたコンテナ、共有メモリ、ツール、スケジュール、レビューゲートによって、セッションをまたいで作業を継続できます。

利用できる機能

• Slack、リポジトリ、イシュートラッカー、メール、または API から作業を受け取るリードエージェント
• 構造化された JSON 出力を必要とする呼び出し元向けのスキーマ検証済みタスク結果
• 監視対象のすべてまたはいずれかのタスクが結果に到達したとき、または期限が到来したときに起動する遅延タスク
• タスクログ内のインラインツール結果画像。プレビューを開くとフルサイズで表示できます
• 貼り付け、ドラッグ＆ドロップ、またはファイル選択で追加できるダッシュボードのファイル添付
• 開発環境を備えた、分離された Docker コンテナ内のワーカー
• セッションをまたいで保持されるメモリーとアイデンティティ。引用評価と自己評価のヒントはデフォルトで有効です
• 定期的な作業のためのワークフロー、スケジュール、スクリプト、アプリ
• 信頼された TypeScript フック用の拡張機能。エージェント所有の非アクティブなドラフトとしてインストールされ、信頼されたリード、オペレーター、またはダッシュボードユーザーによって有効化されます
• 状態、プレゼンス、ライブチャンネルを共有するためのリアルタイムルーム
• お好みのハーネスとモデルを利用できます：Claude Code、Codex、pi、opencode、Cursor、Amp、Grok、Devin、または ACP エージェント

flowchart LR
    subgraph IN["Tasks come in"]
        direction TB
        S["Slack"]
        G["GitHub / GitLab"]
        E["Email"]
        A["API / CLI"]
    end

    LEAD(["Lead Agent<br/>plans &amp; delegates"])

    subgraph WORKERS["Workers in Docker"]
        direction TB
        W1["Worker"]
        W2["Worker"]
        W3["Worker"]
    end

    subgraph BRAIN["Persistent brain"]
        direction TB
        MEM["Memory<br/>(vector search)"]
        ID["Identity<br/>(SOUL, CLAUDE.md)"]
    end

    subgraph OUT["Work ships"]
        direction TB
        PR["Pull Requests"]
        REPLY["Slack replies"]
        EMAIL["Email replies"]
    end

    IN --> LEAD --> WORKERS
    WORKERS -->|reads context| BRAIN
    WORKERS -->|writes learnings| BRAIN
    WORKERS --> OUT

クイックスタート

Docker Compose または Kubernetes のオペレータースキルをコーディングエージェントに渡します。

npx skills add desplega-ai/agent-swarm

または、ハーネスのプラグインとしてインストールします。

ハーネス	コマンド
Claude Code	/plugin marketplace add desplega-ai/agent-swarm then /plugin install agent-swarm@agent-swarm
Codex	codex plugin marketplace add desplega-ai/agent-swarm && codex plugin add agent-swarm@agent-swarm（または上記の npx skills を使用）
Cursor	/add-plugin desplega-ai/agent-swarm
Gemini CLI	gemini extensions install https://github.com/desplega-ai/agent-swarm
Antigravity / Factory Droid	droid plugin marketplace add https://github.com/desplega-ai/agent-swarm then droid plugin install agent-swarm@agent-swarm
OpenCode, pi, Devin, Kimi, その他	npx skills add desplega-ai/agent-swarm

プラグインのプライバシーと 利用規約へのリンクには、Agent Swarm のウェブサイトと Cloud サービスについて記載されています。セルフホスト可能なソフトウェアには、引き続き MIT License が適用されます。

または、セルフホストします。docker-compose.example.yml がリファレンスデプロイです。デフォルトでは、そこにあるエージェントをすべてデプロイしてください（公式テンプレートでは、リード 1 体とワーカー 11 体）。エージェントを削除するのは、必要な理由がある場合に限ります。

最低でも 4 vCPU、8 GB RAM、40 GB の空きディスク容量を確保し、アップグレード後は古い Docker イメージを削除してください。ホスト要件とディスクのクリーンアップを参照してください。

ワンショットインストーラーは Docker と Compose v2 を確認し、Bun がない場合はインストールします。続いて agent-swarm onboard --yes --preset full を実行し（公式テンプレートをすべて使用します。サンプルではコーダーを 2 体実行するのに対し、こちらでは 1 体を実行します）、ダッシュボードの /setup リンクを表示します。

curl -fsSL https://agent-swarm.dev/install.sh | bash

生の GitHub URL（https://raw.githubusercontent.com/desplega-ai/agent-swarm/main/install.sh）から同じスクリプトを取得できます。デフォルトではトンネル経由で API を公開し、API キーで保護します。ローカル環境に限定するには、bash -s -- --no-tunnel を追加してください。

または、サンプルを直接使用します。

git clone https://github.com/desplega-ai/agent-swarm.git && cd agent-swarm
cp .env.docker.example .env  # Set API_KEY and the credential for your HARNESS_PROVIDER.
openssl rand -base64 32 > encryption_key
chmod 600 .env encryption_key
docker compose -f docker-compose.example.yml --env-file .env up -d

エージェント ID の変数は省略可能です。各コンテナは初回起動時に UUID を生成し、専用ボリュームに保持するため、再起動後も ID は維持されます。既存の ID を維持する場合や、ボリュームを削除した後も ID を維持する場合に限り、.env で *_AGENT_ID を固定してください。

起動前にCompose チェックリストをお読みください。API のアドレスは http://localhost:3013 です。/docs と /openapi.json も利用できます。 次に、ダッシュボードを開き、API_KEY を使って API に接続してください。新規インストールでは、プロバイダー、エージェント、メモリ、インテグレーション、最初のタスクを扱う、ガイド付き初回セットアップの /setup が表示されます。 Kubernetes の場合：OCI Helm チャートをインストールしてください。

インテグレーション

Slack · GitHub · GitLab · Azure DevOps · Linear · Jira · AgentMail · WhatsApp (Kapso) · Telegram、Teams、Discord（Chat SDK） · Composio · Sentry · Devin · Serply search。インテグレーションガイド。

AgentMail は、確認済みの受信メールを承認前にアーカイブし、タスクのルーティング対象外のメールも含めて、アーカイブを 30 日間保持します。保持期間、対象範囲の制限、ロールアウト手順については、問い合わせ受信トリアージの運用手順書を参照してください。

詳細を見る

• はじめに · アーキテクチャ · プレイブック · CLI · API リファレンス
• オーケストレーションパターン — 委任、並列展開、人間による承認、再試行、複数ステップのエージェント作業の永続化を行う5つのパターン
• エージェントテンプレート
• 公開ランキング：Get ranked（Settings → Configuration → Branding）でオプトインすると、agent-swarm.dev/rankingで使用トークン数に基づいてインストール環境がランキングされます。次の1時間ごとの更新時に表示されます。トークンの合計数は公開され、正確な値です。テレメトリー、組織名、ウェブサイトを設定する必要があります。
• ヘルプ：[email protected] · Discord

貢献

CONTRIBUTING.mdを読み、リポジトリをフォークしてブランチを作成し、PRを作成してください。アイデアについてはDiscordで話し合ってください。

エージェントですか？npx skills add desplega-ai/agent-swarmを実行するか、オペレータースキルをお読みください。

スター履歴

ライセンス

MIT · 2025-2026 desplega.sh

機能のデフォルト設定

新規デプロイでは、Slack スレッドレンダラー v2、リードへの Slack ステアリングのキューイング、 タスクのステアリング、複数ランタイムのワーカー、RBAC、タスクツールの事前読み込みが有効になります。ハイブリッドメモリ 検索とグラフ展開も有効になります。明示的な環境変数／設定によるオーバーライドも 引き続きサポートされます。環境変数リファレンスをご覧ください。 古いワーカーをアップグレードする場合は、ランタイム ID に対応するまで MULTI_RUNTIME_ENABLED=falseを維持してください。Slack の委任表示は引き続きオプトイン方式で、データベースの保持期間は 引き続きデフォルトでドライランです。