desplega-ai/agent-swarm

agent‑swarm – 面向 AI 原生工作的开源操作系统

是什么 – agent-swarm 是一个框架，允许一个「主控」AI代理从日常渠道（Slack、邮件、GitHub、API 等）接收任务，然后将这些任务委派给在隔离的 Docker 容器中运行的专用工作代理。工作代理共享一个持久化的「大脑」（向量搜索内存和身份存储），可在会话间保持上下文，系统可自动为您创建拉取请求、Slack 回复或邮件回复。

核心组件

• 主控代理 – 规划、优先级排序并路由传入的工作。
• 工作代理 – Docker 隔离的运行时，可运行任何支持的模型（Claude Code、Codex、Pi、Open‑Code、Devin、ACP 等）。
• 持久大脑 – 向量搜索内存 + 身份（SOUL、CLAUDE.md），重启后仍保持。
• 集成 – 提供 Slack、GitHub/GitLab、Linear、Jira、WhatsApp、Sentry 等的预构建连接器。
• 实时房间 – 用于协作调试或实时监控的共享状态和存在通道。
• 可扩展的 harness – 您可自由选择底层 LLM 提供商；平台与模型无关。

典型用例

• 直接从 Slack 或问题追踪器自动化代码审查和 PR 创建。
• 在完整上下文下运行计划的维护脚本（例如，每晚依赖项更新）。
• 构建内部「AI 助手」，可读取工单、编写代码并回复客户，无需人工干预。
• 为希望将数据保留在本地的团队提供自托管的 AI 原生后端。

快速开始

# 如果您使用 Desplega 技能系统，可将技能添加到现有操作员
npx skills add desplega-ai/agent-swarm

# 或直接运行仓库
git clone https://github.com/desplega-ai/agent-swarm.git && cd agent-swarm
cp .env.docker.example .env   # 填写 API_KEY、harness 凭据和八个代理 UUID
openssl rand -base64 32 > encryption_key && chmod 600 encryption_key
docker compose -f docker-compose.example.yml --env-file .env up -d

API 将在 http://localhost:3013 可用，Swagger 文档位于 /docs。同时提供 Web 仪表板 https://app.agent-swarm.dev 用于可视化监控。

文档与社区

• 完整文档：https://docs.agent-swarm.dev
• 实时演示站点：https://agent-swarm.dev
• Discord 社区，用于支持和功能讨论。
• 贡献指南和开放 PR 政策（参见 CONTRIBUTING.md）。

许可证 – MIT（2025–2026，Desplega Labs）。项目积极维护，欢迎社区贡献。