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

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

Configure Model

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:

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

• Install and first run: Install Guide · Quick Start
• The Web UI layout: Page Overview
• Configure providers: Configuration
• Build and evolve capabilities: Skills · Skill Self-Evolution
• Multi-agent and cluster: Agent Team · Distributed Team
• Memory: Memory · Task Memory · Coding Memory
• Automation: Scheduled Tasks
• Terminal: Quick Start (TUI) · Slash Commands · SwarmFlow (TUI)
• Extend and integrate: MCP Configuration · A2A · E2A Protocol

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:

• Report bugs, feature requests, or usage issues: Issues
• Submit code, documentation, or examples: Pull Requests
• Share Skills: Swarm Skills Hub

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

Community

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.