JiuwenSwarm
Understands Your Intent, Evolves Autonomously — Swarm Collaboration for Complex Tasks
English
·
Chinese
·
Docs (EN)
·
Docs
·
Website
·
Swarm Skills Hub
·
GitCode
JiuwenSwarm_Introduction.mp4
JiuwenSwarm is an Agent system that makes multi-agent collaboration truly work. Designed for developers and teams who need to automate complex tasks, it helps users drive multi-agent collaboration, Skill self-evolution, and tool invocation through natural language — delivering end-to-end from intent to result. It runs on a single machine or across a cluster, and you can reach it from a browser, a terminal, or the chat apps you already use.
Why JiuwenSwarm
| Capability |
Value |
| Multi-Agent Collaboration |
The Leader decomposes a complex task and assembles teams, multi agents specialize and negotiate dynamically. |
| Distributed Agent Swarm |
Leader and Teammates deploy across processes and machines, coordinating at scale. |
| Swarmflow |
Deterministic multi-stage workflows via Python scripts: the Leader hands off between stage agents; supports HITL (human / human_session), team token budget, and TUI /swarmflows run-tree monitoring. |
| Skill Self-Evolution |
Automatically detects error signals and user dissatisfaction, then optimizes Skill definitions |
| Skill Hub Sharing |
Capability assets are built once and reused everywhere, search, install, remix, and publish Skills through the Swarm Skills Hub |
| Auto Harness |
Evaluation drive end-to-end optimization of the Harness itself, which learns and improves in practice with no model-weight training |
| AI Infrastructure Compatibility |
Compatible with Huawei Cloud MaaS and other mainstream platforms, OpenAI-compatible APIs, and local models |
| Tool Permissions & Security |
Every step is under your control, tools require approval before execution, file access goes through a whitelist, and sensitive operations are intercepted |
Install
Desktop
One-click install, no environment setup — the quickest way to try JiuwenSwarm.
Download and follow the installer prompts to get started.
On Linux, install via Command Line or from source below.
Command Line
# Install JiuwenSwarm
pip install jiuwenswarm
# Use China mirror (recommended)
pip install jiuwenswarm -i https://pypi.tuna.tsinghua.edu.cn/simple
# Initialize JiuwenSwarm (first-time setup)
jiuwenswarm-init
# Start JiuwenSwarm
jiuwenswarm-start
After launching, visit http://localhost:5173 to open the frontend.
To use TUI (terminal interface), open a new terminal after starting JiuwenSwarm:
# Install JiuwenSwarm-tui
pip install jiuwenswarm-tui
# Use China mirror (recommended)
pip install jiuwenswarm-tui -i https://pypi.tuna.tsinghua.edu.cn/simple
# Start JiuwenSwarm-tui
jiuwenswarm-tui
From Source
git clone https://github.com/openJiuwen-ai/jiuwenswarm.git
cd jiuwenswarm
uv venv
uv pip install -e .
For detailed installation instructions, see: Install Guide
Quick Start
JiuwenSwarm supports multiple model platforms: Huawei Cloud MaaS, OpenAI, DeepSeek, DashScope, SiliconFlow, OpenRouter and other OpenAI-compatible APIs, as well as local model deployment.
A default model is the one piece of configuration you cannot skip. Set it in the web UI under More → Configuration, or edit ~/.jiuwenswarm/config/config.yaml directly. The file is created on your first jiuwenswarm-start, and saving it reloads the config without a restart.
For example, with DeepSeek：
model_name: deepseek-v4-flash
api_base: https://api.deepseek.com
api_key: sk-your-api-key
model_provider: OpenAI
Start a Conversation
The workbench has two spaces, switched from the top-left selector: Work, for office, collaboration, and general tasks, and Code, for viewing and modifying code in a project directory .
Each conversation runs in one of two execution modes, picked from the selector in the chat input area:
| Mode |
What it does |
Use it for |
| Agent mode |
Single agent handles tasks independently, supports task planning and dynamic adjustment |
Most daily tasks, Q&A, code generation, etc. |
| Cluster mode |
Multi-agent collaboration mode, with a Leader orchestrating multiple specialized agents |
Large, complex tasks that need multi-role collaboration |
Cluster Mode (default)
Example input:
Conduct an in-depth research on the new energy vehicle industry and generate an analysis report.
Agent Mode
Example input:
Check today's weather in Beijing, and recommend 3 books about artificial intelligence.
In IM channels and the TUI, the /mode command switches between finer-grained sub-modes (agent.plan, agent.fast, code.normal, code.team, team). See Modes.
By default, tools ask for approval before they run. If you would rather not confirm every step, adjust the policy in Tool Permissions & Security.
For detailed operation guide, see: Quick Start
Channels
Enable a channel from the Web UI, or in config.yaml with enabled: true and the credentials for that platform, and you can talk to the same agent from an app you already have open.
Capabilities differ per platform. Xiaoyi and WhatsApp are private chat only; Feishu, WeCom, DingTalk, Telegram, Discord, and Slack also work in groups, usually by @mentioning the bot. Feishu and WeCom additionally support the Digital Avatar feature. See Channels.
Documentation
Full index: Documentation
Latest Updates
- 2026-08-06 —
v0.2.4.beta3 Focuses on cutting cold-start latency in the Agent instance launch path.
- 2026-07-28 —
v0.2.4.beta2 Improves the scheduling mechanism for tasks and refines front-end interaction logic.
- 2026-07-24 —
v0.2.4.beta1 Builds out the Code work-mode system and its front-end support: workspace selection and switching, and code-diff display.
- 2026-07-14 —
v0.2.3 The collaboration capabilities in cluster mode have been enhanced, with new features such as browser sub-agent isolation and support for online sessions within the same session; image attachments and multimodal conversations; Skill-Omni turns visual knowledge into reusable multimodal Skills, with a usage-experience loop improving skill dispatch; new TUI commands (/keybindings, /simplify, /review, /security-review, /btw); stability fixes..
Full notes for every version are on GitHub Releases.
FAQ
For solutions to common issues, see: FAQ.
Contributing
We welcome developers to contribute to JiuwenSwarm. You can contribute in the following ways:
Read the Contributing Guide first for the debugging workflow, code style, and commit conventions. The contribution map is on the openJiuwen contribution page.
Contributors
Thanks to all developers who have contributed to JiuwenSwarm: View Contributor List
| Channel |
Purpose |
Link |
| Website |
Product info, updates, and ecosystem |
Visit Website |
| SIG |
Technical roadmap, engineering practices, ecosystem building |
Join SIG |
| Swarm Skills Hub |
Browse, publish, and reuse JiuwenSwarm Skills |
Visit Swarm Skills Hub |
License
This project is licensed under Apache License 2.0.
This product serves solely as a workflow orchestration tool and does not embed any AI model capabilities. When users integrate AI models for specific business scenarios, they shall bear full responsibility for compliance obligations under the EU AI Act and other relevant regulatory frameworks.
一个基于 openJiuwen 构建的 AI 智能体系统：你用自然语言描述任务，它会编排多智能体协作、Skill 自我进化和工具调用，端到端地交付结果。