HKUDS/AutoSwarm

AutoSwarm – 自动化 AI 智能体集群

它是什么

• 一个开源的 Python 框架，允许你创建、运行并演化整个人工智能驱动的组织（即“公司”），以处理复杂的现实世界任务。
• 它结合了 CLI 和 基于 Web 的 Office UI (React + Phaser)，因此你可以通过终端或可视化“办公室”与集群进行交互，其中每个角色都显示为动画头像。

核心理念

阶段	过程
自构建	给定一个目标，AutoSwarm 会起草组织架构图，为每个角色选择或聘请 AI “员工”（智能体），并将其存储以供将来重用。
自运行	团队在看板上工作。状态机驱动每个工作项经历 计划 → 执行 → 审查 → 集成 → 返工 阶段，处理依赖关系、阻塞点，并在需要时升级给人类处理。
自增长	运行结束后，成果会归因于负责的角色，经验会被提炼成私有的经验档案，并为下一个项目生成可重用的剧本。

主要功能

• 公司模式 – 运行具有明确汇报关系的多角色集群；角色可以使用不同的 LLM 后端（Claude、Codex、OpenAI 等）。
• 自适应团队创建 – 招聘人员智能体可以自动设计组织架构图并从人才库中招聘。
• 看板驱动的编排 – 可视化看板显示每个项目的列、所有者和就绪状态；并行工作会自动调度。
• 剧本学习 – 每个角色的经验会被持久化并共享，使集群随着时间的推移变得更聪明。
• JiuwenSwarm 集成 – 将 JiuwenSwarm 单智能体或团队作为不透明组件插入。
• 双重界面 – 用于脚本/CI 的 autoswarm CLI 和用于交互式监控的 Office UI (http://localhost:8765)。
• 可扩展插件 – 外部智能体（例如 Codex、Cursor）可以按角色替换；系统会清晰地报告缺失的功能。

典型工作流

1. 设置 – 使用 uv 安装，运行 autoswarm init 创建配置、内存和项目文件夹。
2. 启动 UI – autoswarm ui (或 opc ui) 打开 Office UI。
3. 创建聊天 – 选择 Company 模式，选择预构建的组织（例如 Corporate）或让系统自动组队。
4. 定义目标 – 招聘人员起草角色、聘请智能体，你批准该计划。
5. 运行 – 集群执行任务，你在看板或办公室视图中观察进度，并在需要时干预阻塞点。
6. 学习 – 完成后，AutoSwarm 更新角色经验并为未来的运行生成剧本。

安装（快速）

# Install uv (recommended)
brew install uv   # macOS
# or curl https://astral.sh/uv/install.sh | sh  # Linux/Windows

# Clone and set up the repo
git clone https://github.com/HKUDS/AutoSwarm.git
cd AutoSwarm
uv python install 3.12   # any >=3.10 works
uv venv --python 3.12
source .venv/bin/activate   # or .venv\Scripts\activate on Windows
uv pip install -e .
uv run autoswarm init
uv run autoswarm ui   # opens the UI at http://localhost:8765

（对于无头模式使用，请将 autoswarm ui 替换为 autoswarm chat 或 autoswarm exec。）

适用人群

• 产品团队：希望拥有 AI “助手团队”来原型化功能、编写代码或生成内容。
• 研究人员：构建多智能体模拟或评估 LLM 驱动的工作流。
• 顾问：利用自组织 AI 员工自动化重复性业务流程（例如市场研究、投资备忘录）。
• 开发者：需要一个可编程、可复现的环境来处理复杂的、多步骤的 AI 任务。

路线图亮点

• 更具弹性的公司会话（2026 年 7 月）。
• JiuwenSwarm 0.2.4b4 兼容性（2026 年 9 月）。
• UI 性能改进和更流畅的实时更新。
• 持久化审批和更智能的自动化决策流。

许可证 – MIT (参见 LICENSE)。

---

所有细节均直接取自仓库的 README；未添加任何外部假设。