AutoSwarm README

项目的 README,来自 github.com/HKUDS/AutoSwarm。合并为一个 markdown 文件:README.md。

AutoSwarm logo AutoSwarm: Unify All Your Agents. Break Context Barriers.

简体中文

Paper Feishu WeChat

Download AutoSwarm for Windows Download AutoSwarm for Mac (Apple silicon) Download AutoSwarm for Mac (Intel)

New: AutoSwarm Desktop Released — All Your Agents in One Private Workspace

One window to coordinate agents, share context, review approvals, and track progress.

Watch all your agents work together for you. What AutoSwarm does

HKUDS%2FAutoSwarm | Trendshift

AutoSwarm Desk

Why AutoSwarm?

No single agent can do everything. You don’t need another agent—you need all your agents working as one.

Different agents come with different:

Today, you are forced to switch interfaces, repeat information, coordinate subtasks, and manually combine results.

AutoSwarm turns fragmented agents into one coordinated team.

Give AutoSwarm a task once. It unifies all your agents into one coordinated team:

🤖 Agents AutoSwarm Can Call


Codex


Claude Code


OpenCode


Cursor


GitHub Copilot CLI


Meta Muse Code


CodeBuddy


Hermes


Nanobot


DeepSeek Harness


Grok Build

Kimi Code logo
Kimi Code

AutoSwarm works across Windows, macOS, and Linux. Use AutoSwarm through:

The main host needs Skill support and local command execution. Collaborators need compatible local CLIs; your assistant can help connect missing ones.

🖥️ AutoSwarm Desk App

AutoSwarm Desk app

🚀 Easy to use

One Lightweight Plug-in. Any Agent as Your Entry Point. All Your Agent at Work.

How to Use AutoSwarm

Give AutoSwarm to any agent you already use and ask:

Install or update AutoSwarm for this agent. Reuse my existing configuration and verify which locally installed agents are available.

Your assistant will report which collaborators are ready. To add another, tell it the agent's name; it will handle setup and verification.

Then start any task with:

Use AutoSwarm to read these 100 documents and summarize the key approaches and disagreements.

AutoSwarm selects, connects, and coordinates the right agents for every task.

🤖 AutoSwarm in Action

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

📰 News

🗺️ Roadmap

-🔌 Expand Integrations — Support more agent products, models, tools, and native capabilities.
-🤝 Improve Coordination — Strengthen context sharing, communication, task routing, and parallel execution.
-🛡️ Enhance Reliability — Improve setup, monitoring, error recovery, verification, and overall user experience.

🌟 Citation

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

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

For agents: How to use AutoSwarm

Installation and updates — instructions for the configuring agent (click to expand)

Install

  1. Inspect the current host and existing Python 3.10+ / CLI installations. Reuse native models, credentials, proxy settings and project context. Ask before installing a missing provider CLI; configure only the agents needed.

  2. For a first installation, use git clone to obtain the official repository, then install the package and Skill for the current host. Reuse an existing checkout when available. Example for Codex:

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

    Other host IDs: claude-code, opencode, cursor, copilot, muse, codebuddy, hermes, nanobot, dsh, grok, kimi. Without uv, use a dedicated Python 3.10+ environment and python -m pip install .; keep its interpreter available. Do not reuse the archived v1 environment.

  3. Read the installed SKILL.md at the path returned by setup. It contains the launcher argv and usage instructions. Use that exact launcher when the App cannot find autoswarm. Run agents in the actual host environment; if needed, merge an existing CLI's absolute argv into providers.<provider>.command in the reported AutoSwarm home/config.json. Preserve unrelated settings.

  4. Verify requested providers in the actual project, replacing the example provider and directory as appropriate:

    autoswarm doctor --agent codex --probe --cwd /path/to/project
    

    Repeat --agent for several providers. This spends model calls to check a reply and native resume; verified: true confirms the probe. Version checks only establish executable discovery. An empty native authentication list does not prove that login is required. Handle pending native approvals/questions under the installed Skill's rules, then finish verification.

Setup installs the Skill, its runtime and the host's integration. Follow the returned reload/trust instructions, then briefly name the verified collaborators and explain that the user can request others by name. If none are ready, propose connecting a suitable agent; obtain any missing installation authorization and handle configuration and verification. See configuration and recovery for native profiles, permissions and connection diagnostics.

Update an existing installation

Obtain the requested revision from the original source. For an existing Git checkout, preserve local edits, collect active delegated work, then run on the intended branch:

git pull --ff-only
uv tool install --reinstall .
autoswarm setup --host codex

Use the actual host, existing AutoSwarm home and original installation destinations. Put --home <existing-home> before setup when needed; retain custom --skill-dir, --settings-file and --plugin-dir values. Refresh each host installation in use. For pip installations, use the existing dedicated interpreter to run python -m pip install --force-reinstall ., then python -m autoswarm setup --host codex with the same options.

Run setup from the updated package: the installed Skill has its own runtime copy, so updating the checkout or package alone is insufficient. The old Skill launcher cannot fetch a new version. Keep configuration, records and native authentication, reload the host as required, read the refreshed Skill and verify the needed providers. Finish with the same brief collaborator summary as installation. There is no automatic updater. See upgrade details.

Use and recover

Follow the installed Skill to select agents, delegate ready work, collect results with wait --any, handle intermediate questions/approvals and verify deliverables before answering. Ordinary tasks use the current conversation; native wake-up is optional and needs a supported host binding.

Read only the relevant references: capabilities and data scope, communication, native interactions, model selection. Diagnose retained calls and logs before retrying uncertain operations.

Architecture · Contributing and validation · MIT License

AutoSwarm (HKUDS/AutoSwarm)

正在搜索数据库…

这是什么?AutoSwarm 是一个协调器,能让你已经在用的智能体(Codex、Claude Code、Cursor 等)作为一个团队协同工作。你只需交给它一次任务,它会挑选合适的智能体,在它们之间共享上下文,并把各自的结果合并成一个答案。
它是一个新的 AI 智能体,还是构建在现有智能体之上的一层?它不是新的智能体。它是一个插件或 Skill,你把它添加到你已在用的某个智能体中,然后这个宿主智能体会把你的其他智能体连接进来,作为协作者。
我该怎样让它运行起来?使用 git clone 克隆官方仓库,用 python -m pip install .(或 uv)安装软件包,然后运行 python -m autoswarm setup --host codex。按照说明重新加载宿主,再询问助手哪些协作者已经就绪。
我首先需要准备什么?Python 3.10 或更高版本,以及一个支持 Skill 和本地命令执行的宿主智能体。你想使用的其他每个智能体,都需要安装其对应的兼容本地 CLI。
需要注意什么?验证会消耗你账户上的模型调用次数;安装时,若缺少服务商 CLI,设置程序会先询问你再安装。你添加的每个智能体都必须单独安装并登录。路线图中仍将错误恢复和可靠性列为进行中的工作。
它能在 Windows、macOS 和 Linux 上运行吗?README 中写明它可在 Windows、macOS 和 Linux 上运行。AutoSwarm Desk 桌面应用面向 Windows 和 macOS 提供,而 CLI 和 IDE 扩展是使用它的其他方式。
使用它是免费的吗?该项目采用 MIT 许可证。它所连接的智能体(如 Claude Code 或 Codex)有各自的账户和模型费用,需要你另行付费。
它如何决定由哪个智能体做什么?它根据各个智能体的能力来挑选智能体,连接可互补的工具,并行运行任务的各个部分,然后验证并合并结果,形成一个连贯的答案。
AutoSwarm Desk 相比 CLI 增加了什么?AutoSwarm Desk 是面向 Windows 和 macOS 的桌面应用。它提供一个私有助手和一个窗口,让你可以与受支持的智能体开始对话、查看它们如何分工协作,并回应它们的审批请求。它以包含 Python 的单个安装程序形式发布,并会自动更新。
这些智能体之间会共享记忆吗?会。每个智能体通常保有自己的上下文,而 AutoSwarm 的设计目标是在所有智能体之间共享上下文和记忆,因此你无需在不同工具之间重复提供相同信息。
作者
HKUDS
大小
21.4 MB
星标
2.6K
时长
4个月
提交 · 90 天