ChatDev

环境要求

• 已安装 uv（用于管理后端 Python 依赖）
• 已安装 Node.js 与 npm（前端为 Vite + Vue 3）
• 使用容器方式启动时需安装 Docker 与 Docker Compose
• 可用的大模型服务 API_KEY 与 BASE_URL

安装与启动步骤

1. 1获取项目代码

   从 GitHub 克隆仓库并进入项目根目录，后续命令默认在此目录执行。

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

   复制

2. 2安装后端依赖

   后端使用 uv 管理 Python 依赖，在项目根目录执行同步命令，生成虚拟环境并安装依赖。

   uv sync

   复制

3. 3安装前端依赖

   进入 frontend 目录安装 Vite + Vue 3 前端依赖，安装完成后返回项目根目录。

   cd frontend && npm install

   复制

4. 4准备环境变量文件

   复制示例配置为 .env，再编辑填入模型服务的 API_KEY 与 BASE_URL。

   cp .env.example .env

   复制

5. 5容器方式启动

   Docker Compose 会自动构建前后端并启动服务；执行前需确保项目根目录已有 .env。

   docker compose up --build

   复制

6. 6访问服务

   后端监听 6400 端口，前端监听 5173 端口，用浏览器打开前端地址即可使用界面。

7. 7在界面中执行工作流

   切换到 Launch 标签，选择工作流，按需上传文件（如 .csv），再输入需求描述后运行。

关键配置

如何确认成功

Docker Compose 启动后，浏览器打开 http://localhost:5173 能看到前端界面，http://localhost:6400 后端可访问且日志无报错。

常见问题

注意事项

• README 的 Run the Application 章节为空，未给出本地启动命令，实际启动可优先使用 Docker Compose 方式。
• YAML 配置文件中可用 ${API_KEY} 这类占位符引用 .env 中的环境变量。
• Docker Compose 启动前必须确保项目根目录已存在 .env 文件，否则模型调用会失败。
• 容器会在服务崩溃后自动重启，本地文件改动会同步到容器内，便于调试。