让开源，少一点语言距离。
npm包中文文档

@desplega.ai/agent-swarm

中文文档
2.11.0发布于 2026/11/11MITES Module构建来源已验证近 30 天下载 1.9万

agent-swarm.dev——AI工作的开源操作系统:一个牵头代理将目标突破成任务,引导目标到克洛德代码或Codex等专业工人手中,将每个工人运行在一个孤立的容器中,并保留共享的记忆,工具,时间表,

中文使用文档
中文原文
文档目录8 节
  1. 你得到的东西
  2. 快速启动
  3. 一体化
  4. 学多点
  5. 捐款
  6. 恒星历史
  7. 许可证
  8. 特性默认

GitHub Stars MIT License PRs Welcome

斯汉姆探员 是开源的自托管的AI公司操作系统,由 德普勒加实验室。 。 。 .

[TIP] 这种回波每天都在演化. 现在看

▸ 每支队伍,一队 • 妇女 每日演变 • 妇女 制作

Website Docs Dashboard Join Discord Follow on X Desplega Labs on LinkedIn Desplega Labs on YouTube

swarm.dev是一个用于AI工作的开源操作系统. 首席特工代表的目标为克劳德·克德克或克德克思等工人. 隔开的容器、共享的内存、工具、时间表和审查闸门保存各会的工作.

你得到的东西

  • 接收来自Slack、寄存器、发行跟踪器、电子邮件或API的作品的牵头代理
  • 任务结果 用于需要结构化 JSON 输出的呼叫者
  • 被推迟的任务 当所有或任何被监视的任务都达到结果或最后期限时
  • 内置工具结果图像 在任务日志中,带有以全尺寸打开的预览
  • Dashboard 文件附件 通过粘贴、拖放或文件拾取器
  • 与开发环境隔绝的多克容器中的工人
  • 内存和身份在会话中长期存在,默认情况下启用了引用评级和自评提示
  • 经常性工作的工作流程、时间表、脚本和应用程序
  • 扩展 用于信任的 TypeScript 钩子,作为代理拥有的惰性草稿安装,并由信任的铅、操作员或仪表板用户激活
  • 实时会议室 用于共享页面状态、存在和直播频道
  • 你对绳索和模型的选择:克洛德代码, Codex, pi,开口代码, 光标, Amp, (英语), 格鲁克, (中文(简体) ), fx 时速或非加太公司代理人
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

或者把它安装为插件 :

节奏命令
克劳德代码/plugin marketplace add desplega-ai/agent-swarm 接下来 /plugin install agent-swarm@agent-swarm
代码codex plugin marketplace add desplega-ai/agent-swarm && codex plugin add agent-swarm@agent-swarm (或使用) npx skills 上文)
光标/add-plugin desplega-ai/agent-swarm
双子座CLIgemini extensions install https://github.com/desplega-ai/agent-swarm
抗重力/工厂机器人droid plugin marketplace add https://github.com/desplega-ai/agent-swarm 接下来 droid plugin install agent-swarm@agent-swarm
OpenCode, pi, Devin, Kimi, 其他人的游戏npx skills add desplega-ai/agent-swarm

该插件的 隐私 财务报告和审定财务报表 术语 链接描述 Swarm探员网站和 云服务. 自动托管的软件仍由该软件覆盖 MIT 许可证。 。 。 .

或自为主. docker-compose.example.yml 是参考部署:默认部署其中的每个代理(1个领导和11个工作人员在正式模板上),仅在有正当理由时才删除代理.

计划至少4 vCPU,8 GB RAM和40 GB的自由磁盘,以及升级后prune老多克图像. 见 主机要求和磁盘清理。 。 。 .

单发安装器检查 Docker 和 Compose v2, 丢失时安装 Bun, 运行 agent-swarm onboard --yes --preset full (每个正式模板;它运行一个编码器,其中实例运行两个),并打印仪表板 /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 以保持当地.

没有服务器吗? 在一击中部署铁路模板:

Deploy on Railway

或者说 部署一个 在任何 VPS 上: 粘贴 deploy/cloud-init.yaml 作为新4 vCPU / 8 GB Ubuntu 服务器的用户数据(Hetzner, DigitalOcean, Lightsail, Vultr). 它安装了多克和凯迪,在HTTPS上服务API <ip>.sslip.io ,并显示 /setup 链接到登录时的 root。 先来看, 在E2B上试一小时;当沙盒停止时,该试验会删除其数据.

或者直接使用这些例子:

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并保持其个人体积,所以身份可以活下来重启. 键 *_AGENT_ID 内 .env 只为了保持现有身份或活下来去除体积.

读取 编写核对表 开始之前。 API: http://localhost: 30:13, 与 /docs 财务报告和审定财务报表 /openapi.json。 。 。 . 接下来,打开 仪表板 连接到您的 API API_KEY。在 /setup,引导第一运行,涵盖提供者,代理,内存,集成,以及第一任务. 库伯涅斯: 安装 OCI Helm 图表。 。 。 .

一体化

克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克聊天SDK· 混凝土-哨兵-德文- 紧急搜索。 。 。 . 融合指南。 。 。 .

AgentMail的档案在确认运入货物之前先进行核查,并将档案保存了30天,包括排除任务路线的邮件. 见 联系信箱分解程序簿 保留、范围限制和推出指示.

学多点

捐款

读取 捐款额,叉出存储器,创建分支,并打开公关. 讨论关于 解析器。 。 。 .

你是经纪人吗? 运行 npx skills add desplega-ai/agent-swarm 或读取 操作技能。 。 。 .

恒星历史

Star History Chart

许可证

麻省理工学院 · 2025-2026年 破伤风

特性默认

新的部署启用了 Slack 线程渲染器 v2, 排队的 Slack 向导到线索, 任务指导、多运行时间工人、非洲区域局和任务工具预装。 混合内存 搜索和图表扩展也启用。 明确的环境/配置覆盖 继续支持;见 环境参考。 。 。 . 当年长的工人升级时 MULTI_RUNTIME_ENABLED=false 直到他们支持 运行时间身份。 仍然选择使用和保留数据库 继续默认为干线运行.

版本与发布记录

@desplega.ai/agent-swarm 共发布 252 个版本，首次发布于 2025/12/18；过去 12 个月发布了 252 个版本。最新版本附带 npm provenance 构建来源证明，可追溯到公开的 CI 构建记录。

版本发布日期距今
2.11.0latest2026/11/11今天
2.10.02026/11/101 天前
2.9.12026/11/092 天前
2.9.02026/11/083 天前
2.8.32026/11/074 天前
2.8.22026/11/065 天前

关于 @desplega.ai/agent-swarm 的常见问题

@desplega.ai/agent-swarm 是什么？

agent-swarm.dev——AI工作的开源操作系统:一个牵头代理将目标突破成任务,引导目标到克洛德代码或Codex等专业工人手中,将每个工人运行在一个孤立的容器中,并保留共享的记忆,工具,时间表,

如何安装 @desplega.ai/agent-swarm？

在项目目录运行 npm install @desplega.ai/agent-swarm，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：typescript（^5）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。它还提供命令行工具 agent-swarm，可以用 npx agent-swarm 直接运行。

@desplega.ai/agent-swarm 支持 TypeScript 吗？

该包的 package.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/desplega.ai__agent-swarm 是否存在。

@desplega.ai/agent-swarm 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module，更早的版本需要改用动态 import()。

@desplega.ai/agent-swarm 可以商用吗？

@desplega.ai/agent-swarm 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

@desplega.ai/agent-swarm 的下载量有多少？

根据 npm 官方下载统计，@desplega.ai/agent-swarm 在 2026/10/12 – 2026/11/10 这 30 天内被下载 19,346 次，日均约 645 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

@desplega.ai/agent-swarm 还在维护吗？

最新版本 2.11.0 发布于 2026/11/11（今天）；至今共发布 252 个版本，其中过去 12 个月发布了 252 个；首次发布于 2025/12/18。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。