jiuwenswarm README

The project's README from github.com/openJiuwen-ai/jiuwenswarm. As one markdown file: README.md.

JiuwenSwarm Logo

JiuwenSwarm

Understands Your Intent, Evolves Autonomously — Swarm Collaboration for Complex Tasks

English · Chinese · Docs (EN) · Docs · Website · Swarm Skills Hub · GitCode

License Release Python Version OS Support

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.

Platform Download Notes
Windows Download Windows Version For Windows 10 / 11
macOS Download macOS Version For Intel / Apple Silicon
HarmonyOS Try now HarmonyOS PC, installed via the official site

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:

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.

Region Channels
China Xiaoyi, Feishu, DingTalk, WeCom, Personal WeChat
International Telegram, Discord, Slack, WhatsApp

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

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

Community

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.

jiuwenswarm (openJiuwen-ai/jiuwenswarm)

Searching Database…

7.5K ·GitHub
Jiuwenswarm
Что это такое?Система AI-агентов на базе openJiuwen: вы описываете задачу обычным языком, а она организует совместную работу нескольких агентов, самообучение Skill'ов и вызов инструментов, чтобы довести задачу до результата от начала до конца.
Так это веб-приложение, терминальная утилита или бот в моих мессенджерах?И то, и другое, и третье. Есть веб-верстак для браузера, TUI для терминала, а также каналы, которые подключают того же агента к Telegram, Discord, Slack, WhatsApp, Feishu, DingTalk, WeCom, Personal WeChat или Xiaoyi.
Как его запустить?Возьмите one-click установщик для рабочего стола под Windows 10/11 или macOS (Intel/Apple Silicon); HarmonyOS PC устанавливается с официального сайта. В Linux используйте командную строку или соберите из исходников, затем откройте фронтенд в браузере или запустите TUI в новом терминале.
Нужно ли подключать своего провайдера моделей или API-ключ?Да — модель по умолчанию это единственная настройка, без которой не обойтись. Поддерживаются Huawei Cloud MaaS, OpenAI, DeepSeek, DashScope, SiliconFlow, OpenRouter, другие OpenAI-совместимые API и локальные модели; настроить можно в веб-интерфейсе в разделе More → Configuration или отредактировав файл ~/.jiuwenswarm/config/config.yaml.
Проект уже достаточно стабилен или всё ещё в стадии беты?Это бета до версии 1.0: последний релиз — v0.2.4.beta3 от августа 2026 года, и в свежих версиях всё ещё переделывают такие вещи, как задержку холодного старта агентов и рабочий режим Code, так что будьте готовы к изменениям.
Есть ли что-то необычное в лицензии?Apache-2.0, но обратите внимание на дисклеймер: продукт — исключительно инструмент оркестрации рабочих процессов без встроенной AI-модели, и ответственность за соблюдение требований (например, EU AI Act) к подключаемым моделям несёте вы.
Что на самом деле значит самообучение Skill'ов?Система сама распознаёт сигналы об ошибках и недовольстве пользователя, а затем оптимизирует задействованные определения Skill'ов. Skill'ами также можно обмениваться через Swarm Skills Hub, где их можно искать, устанавливать, дорабатывать и публиковать.
Можно ли настроить повторяемые рабочие процессы, чтобы не писать промпт каждый раз?Да — Swarmflow описывает детерминированные многоэтапные рабочие процессы в виде Python-скриптов, где Leader передаёт работу между агентами этапов. Поддерживаются шаги с участием человека, бюджеты токенов для команды и просмотр дерева запусков /swarmflows в TUI.
Он работает в групповых чатах или только в личных сообщениях?Feishu, WeCom, DingTalk, Telegram, Discord и Slack работают в группах — обычно бота упоминают через @. Xiaoyi и WhatsApp работают только в личных чатах, а Feishu и WeCom к тому же поддерживают функцию Digital Avatar.
Для кого этот проект?Для разработчиков и команд, которым нужно автоматизировать сложные задачи — он рассчитан на запуск совместной работы нескольких агентов, эволюции Skill'ов и вызова инструментов из обычного языка, на одной машине или в кластере.
What are similar projects?EvoQuant, nanobot, brigade, LangBot, hermes-agent, Raven, AionUi, hive
Which topics is it in?feishu, whatsapp, slack, discord, wechat, telegram, multimodal, tui, openai-compatible, local-llm, agent-orchestration, skills
Creator
openJiuwen-ai
Size
398.3 MB
Stars
7.5K
Updated
CommitOct 19Releasev0.2.7Sep 30
Age
7mo
Commits · 90 Days