Auto-GPT-ZH

环境要求

• Python 环境（后端依赖用 Poetry 管理）
• Poetry （执行 poetry run cli gen-encrypt-key 需要）
• Node.js 与 npm（前端安装依赖、启动开发服务器）
• 能访问 GitHub 的网络环境

安装与启动步骤

1. 1克隆项目仓库

   把 Auto-GPT-ZH 仓库拉到本地，后续所有命令都在仓库根目录下执行。

   git clone https://github.com/kaqijiang/Auto-GPT-ZH.git

   复制

2. 2进入后端目录

   进入 autogpt_platform 目录，后端配置与密钥生成都在这里进行。

   cd autogpt_platform

   复制

3. 3生成加密密钥

   用 CLI 生成加密密钥，然后手动把密钥写入 autogpt_platform/backend/.env 文件中。

   poetry run cli gen-encrypt-key

   复制

4. 4配置前端环境变量

   进入 frontend 目录，从示例文件复制出正式的环境变量文件。

   cd frontend
   cp .env.example .env

   复制

5. 5安装前端依赖

   按 package.json 安装前端所需依赖，耗时取决于网络速度，建议配置国内镜像。

   npm install

   复制

6. 6启动前端服务

   以开发模式启动前端，默认监听 3000 端口，保持终端窗口不要关闭。

   npm run dev

   复制

7. 7验证部署

   浏览器打开 http://localhost:3000 看前端界面；同时确认 8001、8006 端口有服务。

关键配置

如何确认成功

浏览器访问 http://localhost:3000 能打开前端界面，且 WebSocket 8001、REST API 8006 端口正常监听。

常见问题

注意事项

• README 未提供后端服务的启动命令，本教程只覆盖 README 中明确写出的步骤
• 执行 npm install 前建议进入 frontend 目录并已复制好 .env，否则可能读取不到配置
• 经典版已停止维护，不要基于它做生产部署
• 本仓库是 Auto-GPT 中文同步 fork，分支跟随 Stable 最新分支