MetaGPT

环境要求

• Python 3.9 或更高，但必须低于 3.12
• 建议使用 conda 创建独立虚拟环境
• 已安装 node 和 pnpm（实际使用前必须安装）
• 一个可用的 LLM API Key（如 OpenAI、Azure、Ollama、Groq 等）

安装与启动步骤

1. 1检查 Python 版本

   确认系统 Python 版本满足 3.9 ≤ 版本 < 3.12，版本不符会安装失败。

   python --version

   复制

2. 2创建虚拟环境

   用 conda 创建名为 metagpt 的环境并激活，避免污染全局依赖。

   conda create -n metagpt python=3.9 && conda activate metagpt

   复制

3. 3安装 MetaGPT

   通过 pip 安装最新版 metagpt 包；也可从 GitHub 源码安装。

   pip install --upgrade metagpt

   复制

4. 4安装 node 和 pnpm

   实际使用前需安装 node 与 pnpm，具体方式见官方下载页与安装文档。

5. 5初始化配置文件

   执行后会在 ~/.metagpt/config2.yaml 生成默认配置，按需修改。

   metagpt --init-config

   复制

6. 6填写模型配置

   编辑 ~/.metagpt/config2.yaml，填入 api_type、model、base_url 和 api_key。

7. 7运行 CLI 生成项目

   用一句自然语言描述需求，MetaGPT 会在 ./workspace 下生成代码仓库。

   metagpt "Create a 2048 game"

   复制

关键配置

如何确认成功

运行 metagpt "Create a 2048 game"，若在 ./workspace 目录下成功生成项目仓库和文件即表示正常。

常见问题

注意事项

• config2.yaml 中的 api_key 需替换为真实密钥，不要提交到公开仓库。
• 安装命令提供了三种方式：pip 安装、从 git 仓库安装、clone 后以编辑模式安装，任选其一即可。
• 更详细的安装与配置说明请查看官方 cli_install、docker_install 和 configuration 文档。
• 简单任务可直接用 CLI；复杂任务可参考 Data Interpreter 示例编写 Python 脚本调用。