ChatDev 2.0 DevAll：OpenBMB 零代码多 Agent 编排平台｜部署与使用全指南

ChatDev / DevAll 官方 logo

仓库：https://github.com/OpenBMB/ChatDev 旧版分支：https://github.com/OpenBMB/ChatDev/tree/chatdev1.0 许可证：以仓库 LICENSE 为准运行形态：FastAPI 后端（6400）+ Vite/Vue 前端（5173）

1. 项目简介

ChatDev 2.0（DevAll）是 OpenBMB 推出的零代码多 Agent 编排平台，官方定位"A Zero-Code Multi-Agent Platform for Developing Everything"：用户通过简单配置即可搭建并执行自定义多 Agent 系统，无需写代码——定义 Agent、工作流、任务，即可编排数据可视化、3D 生成、深度研究等复杂场景。旧版 ChatDev 1.0 是"虚拟软件公司"（CEO/CTO/程序员等角色开会自动化软件开发全流程），已移至 chatdev1.0 分支维护。

1.1 核心信息一览

项目	内容
仓库	OpenBMB/ChatDev
定位	零代码多 Agent 编排平台（2.0 DevAll）
Python	3.12+
Node.js	18+
包管理	uv（后端）+ npm（前端）
后端端口	6400（`server_main.py --port 6400`）
前端端口	5173（Vite 开发）

1.2 适用场景

想零代码搭一个多 Agent 系统并跑复杂工作流；
想体验"虚拟软件公司"式多角色协作（1.0 分支）；
做数据可视化、3D 生成、深度研究等编排实验。

1.3 能力边界（官方口径）

2.0 为零代码配置式平台，1.0 软件开发多 Agent 已转至 chatdev1.0 分支维护；
需自备 LLM Provider 的 API_KEY 与 BASE_URL；
部分能力按官方公告演进，以仓库最新 README 为准。

2. 功能特性

零代码多 Agent 编排：配置定义 Agent、工作流、任务；
通用场景：数据可视化、3D 生成、深度研究等；
前后端分离：FastAPI 后端 + Vite/Vue3 前端；
环境变量配置：.env 里配 API_KEY / BASE_URL，YAML 用 ${VAR} 引用；
1.0 经典范式：CEO/CTO/程序员/测试等角色开会，覆盖设计、编码、测试、文档全流程。

3. 官方界面预览

ChatDev DevAll 官方 logo

上图为官方 README 引用的 DevAll Logo（README 官方素材）。

4. 官方跳转链接汇总

仓库主页：https://github.com/OpenBMB/ChatDev
ChatDev 1.0 旧版：https://github.com/OpenBMB/ChatDev/tree/chatdev1.0
官方发布公告：https://x.com/OpenBMB/status/2008916790399701335
论文（NeurIPS 2025）：https://arxiv.org/abs/2505.19591
多 Agent 电子书：https://thinkwee.top/multiagent_ebook

5. 前置要求与服务器配置

OS：macOS / Linux / WSL / Windows；
Python 3.12+；
Node.js 18+；
包管理器：uv；
LLM Provider 的 API Key 与 BASE_URL。

6. 方式一：Makefile 一键启动（推荐）

git clone https://github.com/OpenBMB/ChatDev.git
cd ChatDev

# 后端依赖（uv 管理）
uv sync

# 前端依赖
cd frontend && npm install && cd ..

# 环境变量
cp .env.example .env
# 编辑 .env：填 API_KEY 与 BASE_URL

# 同时起前后端
make dev

打开 http://localhost:5173 访问 Web Console。

7. 方式二：手动分进程启动

# 后端（项目根目录）
uv run python server_main.py --port 6400 --reload

# 另开终端：前端
cd frontend
npm run dev

--reload 只监听后端 Python 源码目录；WareHouse/ 下 Agent 生成文件不会触发重启。

8. 配置项说明

配置	说明
`.env`	复制自 `.env.example`，填 `API_KEY`、`BASE_URL`
YAML `${VAR}`	配置文件里用 `${API_KEY}` 等引用环境变量
`server_main.py --port 6400 --reload`	后端端口与热重载
`make dev`	同时拉起前后端

9. 常用运维命令

# 安装依赖
uv sync
cd frontend && npm install && cd ..

# 启动
make dev

# 后端单独
uv run python server_main.py --port 6400 --reload

# 前端单独
cd frontend && npm run dev

10. 常见故障排查

Python 版本不对：需 3.12+；
Node 版本不对：需 18+；
模型 401：检查 .env 的 API_KEY / BASE_URL；
前端起不来：确认 frontend && npm install 完成；
想用经典 1.0 软件开发：切到 chatdev1.0 分支。

11. 风险与合规说明

许可证以仓库 LICENSE 为准；
模型调用费用由对应 Provider 账号承担；
2.0 与 1.0 分支定位不同，按需求选分支；
本文为社区部署笔记，命令以官方 README 最新版本为准。