HKUDS /AutoSwarm

AutoSwarm: Unify All Your Agents. Break Context Barriers. Watch Them Work Together for You.

★ 2,557⑂ 428👁 23⑃ 40● 35▤ 1
PythonMITCreated 2026-07-01arxiv.org/abs/2610.33048
下载:AutoSwarm Desk 0.1.0desk-v0.1.0 ↓0.1.02026-11-06
2,557
stars
428
forks
23
watchers
40
prs
35
issues
1
releases

README

AutoSwarm: All Your Agents. One AI Swarm



https://github.com/user-attachments/assets/89a077a9-168e-441f-8aac-48de321aa968

English

让你常用的 agent,带领多个 agent 协作。

将 AutoSwarm 作为轻量插件接入正在使用的 agent,由它按需组织本地多个 agent 产品协作,负责分工、沟通与结果整合。你只需像往常一样提出任务。

  

  

新:AutoSwarm Desk 桌面版(Windows 和 macOS)。 私人助理、所有 Agent、它们的工作进展和审批,都在一个窗口里。
运行安装程序即可开始:自带 Python,Windows 版会自动更新。了解功能



 ✨ 三个适合 AutoSwarm 的场景

- 🧩 跨产品能力互补:任务需要不同 agent 或模型的优势、工具与数据入口时,组织合适的 agent 协作完成。
- ⚡ 大量任务并行处理:例如快速阅读 100 份资料,让多个 agent 并行提炼,再由主 agent 统一汇总;也支持同时调用多个同款 agent。
- 🔍 重要任务一做一审:例如关键代码开发,由一个 agent 实现,另一个独立审查与验证,提高交付质量。

 🚀 开始使用

把本仓库地址发给你正在使用的 agent,直接说:

 请为当前 agent 安装或更新 AutoSwarm,复用已有配置,验证本地已有 agent 的可用性。

配置完成后,主 agent 会告诉你哪些助手已经可以协作。想加入其他助手,直接告诉它名称,它会负责配置和验证。

日常需要 swarm 时,在任务前加上 “使用 autoswarm”,例如:

 使用 autoswarm,阅读这 100 份资料,归纳技术路线与主要分歧。

由主 agent 自行选择协作者、灵活安排串并行。

 🤖 支持的 agent


  
    Codex
    Claude Code
    OpenCode
    Cursor
  
  
    GitHub Copilot CLI
    Meta Muse Code
    CodeBuddy
    Hermes
  
  
    Nanobot
    DeepSeek Harness
    Grok Build
    Kimi Code
  


支持 Windows、macOS、Linux。可在支持 Skill 和本地命令执行的 App、CLI 或 IDE 扩展中使用;被调用的 agent 需有可用的本地 CLI。

 🖥️ AutoSwarm Desk 应用界面



 📰 News

- AutoSwarm Desk macOS 版发布:同一个应用,支持 Apple 芯片和 Intel 芯片的 Mac,自带 Python。Apple 芯片版 · Intel 版 · 使用说明
- AutoSwarm Desk(Windows 桌面版)发布:在一个窗口里和私人助理对话,用已支持的十二个 Agent 开会话,查看它们如何分工协作,并处理审批。一个安装程序,自带 Python,自动更新。下载 · 使用说明
- OpenOPC → AutoSwarm:v2 将 swarm 能力带入用户已有的 agent。旧版完整实现保留在 v1.0.0 归档中。

 后续计划

- 接入更多 agent 产品及原生能力。
- 持续完善协作、通信、可靠性与安装使用体验。

 🌟 Citation

If you find this work helpful to your research, please kindly consider citing our paper.

bibtex
@misc{li2026autoswarm,
      title={AutoSwarm: Automating Agent Swarms},
      author={Zhonghang Li and Zongwei Li and Chao Huang},
      year={2026},
      eprint={2610.33048}
}


 给 agent 的说明


安装与更新指南——供负责配置的 agent 阅读(点击展开)

 安装

1. 确认当前宿主及已有 Python 3.10+、CLI 安装,复用原生模型、认证、代理和项目上下文。确实缺少所需 CLI 才询问是否安装,只配置需要的 agent。
2. 首次安装使用 git clone 获取官方仓库,再安装包并为当前宿主安装 Skill;已有仓库时直接复用。以 Codex 为例:

   bash
   git clone https://github.com/HKUDS/AutoSwarm.git
   cd AutoSwarm
   uv tool install --force .
   autoswarm setup --host codex
   

   其他宿主标识:claude-code、opencode、cursor、copilot、muse、codebuddy、hermes、nanobot、dsh、grok、kimi。没有 uv 时,在专用 Python 3.10+ 环境执行 python -m pip install .,保留该解释器,不复用归档 v1 环境。
3. 读取 setup 返回路径下的 SKILL.md,其中包含完整启动参数与使用方法。App 找不到 autoswarm 时使用该启动器。在实际宿主环境运行 agents;已有 CLI 不在 PATH 时,将其绝对 argv 合并到返回的 AutoSwarm home/config.json 的 providers..command,保留无关配置。
4. 在实际项目中验证所需 agent,按实际情况替换示例产品与目录:

   bash
   autoswarm doctor --agent codex --probe --cwd /项目路径
   

   可重复 --agent 选择多个产品。该操作消耗模型调用,检查回复和原生续接;verified: true 才确认本次验证通过。版本检查仅发现可执行文件,原生认证列表为空不代表必须登录。遇到原生批准或提问,按已安装 Skill 的规则处理后完成验证。

Setup 安装 Skill、运行时与宿主集成;按返回说明完成重载和信任操作,再简要列出已验证可协作的助手,并说明用户可以直接提出想接入的助手名称。如果暂时没有可用协作者,提出合适的接入建议;补齐必要安装授权后,由主 agent 配置并验证。原生配置、权限及连接排障见配置与恢复指引。

 更新已有安装

从原来源获取所需版本。使用 Git 仓库时,先保留本地修改、收齐正在执行的子任务,再在目标分支执行:

bash
git pull --ff-only
uv tool install --reinstall .
autoswarm setu

Top issues

Latest release

AutoSwarm Desk 0.1.0 desk-v0.1.0 2026-11-06
Windows: download AutoSwarm-Desk-Setup.exe and run it. It installs for the current user, includes Python, and updates itself.
Without installing: unzip AutoSwarm-Desk-0.1.0-win-x64.zip and run AutoSwarm Desk.exe.

macOS: download AutoSwarm-Desk-mac-arm64.dmg for Apple silicon (M1 and later) or AutoSwarm-Desk-mac-x64.dmg for Intel Macs, open it and drag AutoSwarm Desk to Applications. Python is included. Desk is not signed with an Apple Developer ID: the first time, choose Done, then System Settings → Privacy & Security → Open Anyway (under Security). A Mac copy does not update itself; the side

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON