HKUDS /AutoSwarm
AutoSwarm: Unify All Your Agents. Break Context Barriers. Watch Them Work Together for You.
★ 2,557⑂ 428👁 23⑃ 40● 35▤ 1
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 setuTop issues
#35人工评审没反应3 comments · 2026-08-09#52Answering the final delivery-feedback checkpoint leaves Task/WorkItem desynced and permanently wedges the session2 comments · 2026-08-27#68No Kimi?1 comments · 2026-11-01#65Windows Company + Codex:Task 可用,多角色交接未完成,求沙箱初始化建议1 comments · 2026-10-18#54Per-Task copies of runtime_topology make the tasks table and engine memory grow with org_size x task_count1 comments · 2026-08-27#51service restart has failed1 comments · 2026-08-27#41Remote (streamable-HTTP) MCP servers fail to connect — reproducible with public DeepWiki MCP; stdio works1 comments · 2026-08-20#74autoswarm desk对话框可以支持图片格式的输入吗?0 comments · 2026-11-12
Latest release
AutoSwarm Desk 0.1.0 desk-v0.1.0 2026-11-06Windows: 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