JiuwenSwarm：Leader 拆任务、Teammate 分工，能装能跑的多 Agent 协作框架

多 Agent 协作框架不缺概念稿，缺的是「装得上、跑得起来、Leader 能拆任务、Teammate 能分工、Skill 还能自己演进」这一整套能交付的工程实现。JiuwenSwarm 是其中一份：单机或集群部署，浏览器、终端、已有的聊天应用都能接进去。

项目信息

• GitHub：（6,549 stars）
• Swarm Skills Hub：
• 官网：
• GitCode 镜像：
• License：Apache-2.0；PyPI 包名：jiuwenswarm；Python >= 3.11；支持 Windows / macOS / Linux / HarmonyOS
• 文档：README.md（英文）· README_CN.md（中文）· docs/README_EN.md（英文文档）· docs/README.md（文档）

能力一览

安装

桌面端

一键安装，不需要配环境，试起来最快的方式。

Linux 走下面的命令行安装或源码安装。

命令行

# 安装 JiuwenSwarm
pip install jiuwenswarm

# 使用国内镜像（推荐）
pip install jiuwenswarm -i https://pypi.tuna.tsinghua.edu.cn/simple

# 初始化 JiuwenSwarm（首次使用）
jiuwenswarm-init

# 启动 JiuwenSwarm
jiuwenswarm-start

启动后访问 http://localhost:5173 打开前端。

需要使用 TUI（终端界面）时，在启动 JiuwenSwarm 之后另开一个终端：

# 安装 JiuwenSwarm-tui
pip install jiuwenswarm-tui

# 使用国内镜像（推荐）
pip install jiuwenswarm-tui -i https://pypi.tuna.tsinghua.edu.cn/simple

# 启动 JiuwenSwarm-tui
jiuwenswarm-tui

源码安装

git clone https://github.com/openJiuwen-ai/jiuwenswarm.git
cd jiuwenswarm
uv venv
uv pip install -e .

快速开始

配置模型

JiuwenSwarm 支持多家模型平台：华为云 MaaS、OpenAI、DeepSeek、DashScope、SiliconFlow、OpenRouter 等 OpenAI 兼容 API，以及本地模型部署。

默认模型是唯一一项不能跳过的配置。可以在 Web UI 的「更多 → 配置」里设置，也可以直接编辑 ~/.jiuwenswarm/config/config.yaml。这个文件在第一次执行 jiuwenswarm-start 时生成，保存后配置即时重载，不用重启。

以 DeepSeek 为例：

model_name: deepseek-v4-flash
api_base: https://api.deepseek.com
api_key: sk-your-api-key
model_provider: OpenAI

开始对话

工作台分两个空间，从左上角选择器切换：Work 面向办公、协作和通用任务，Code 面向在项目目录里查看和修改代码。

每个会话从聊天输入区的选择器里选一种执行模式：

Cluster 模式（默认）示例输入：

Conduct an in-depth research on the new energy vehicle industry and generate an analysis report.

Agent 模式示例输入：

Check today's weather in Beijing, and recommend 3 books about artificial intelligence.

在 IM 频道和 TUI 里，/mode 命令可以切换到更细粒度的子模式：agent.plan、agent.fast、code.normal、code.team、team。详见 Modes 文档。

默认情况下，工具执行前会请求审批。如果不希望每一步都确认，可在 Tool Permissions & Security 文档里调整策略。

Channels

在 Web UI 里启用某个频道，或在 config.yaml 中把该平台的 enabled 设为 true 并填好凭证，就能从已经开着的聊天应用里和同一个 agent 对话。

国内：小艺、飞书、钉钉、企业微信、个人微信。国际：Telegram、Discord、Slack、WhatsApp。

各平台能力不同。小艺和 WhatsApp 仅支持私聊；飞书、企业微信、钉钉、Telegram、Discord、Slack 还支持群聊，通常通过 @ 机器人触发。飞书和企业微信额外支持数字人功能。

文档

完整索引：docs/README_EN.md

• 安装与首次运行：Install Guide · Quick Start
• Web UI 布局：Page Overview
• 配置模型提供方：Configuration
• 构建与演进能力：Skills · Skill Self-Evolution
• 多 Agent 与集群：Agent Team · Distributed Team
• 记忆：Memory · Task Memory · Coding Memory
• 自动化：Scheduled Tasks
• 终端：Quick Start (TUI) · Slash Commands · SwarmFlow (TUI)
• 扩展与集成：MCP Configuration · A2A · E2A Protocol

最新更新

• 2026-08-06 — v0.2.4.beta3 重点降低 Agent 实例启动路径上的冷启动延迟。
• 2026-07-28 — v0.2.4.beta2 改进任务调度机制，细化前端交互逻辑。
• 2026-07-24 — v0.2.4.beta1 建立 Code 工作模式体系及其前端支持：工作区选择与切换、代码 diff 展示。
• 2026-07-14 — v0.2.3 增强 cluster 模式的协作能力，新增浏览器子 agent 隔离、同一会话内在线会话等特性；支持图片附件与多模态对话；Skill-Omni 把视觉知识转成可复用的多模态 Skill，并通过使用体验回路改进 skill 调度；新增 TUI 命令 /keybindings、/simplify、/review、/security-review、/btw；稳定性修复。

FAQ

常见问题的解决方案见 FAQ 文档。

贡献

报 Bug 走 Issues，提交代码走 Pull Requests，分享 Skill 走 Swarm Skills Hub。动手前先看 Contributing Guide。

社区

License

Apache License 2.0。本产品仅作为工作流编排工具，不内置任何 AI 模型能力。