MetaGPT 快速上手教程（GitHub README 中文整理）

好的，这是根据您的要求整理的中文「快速上手」教程。

---

MetaGPT 快速上手教程

是什么

MetaGPT 是一个多智能体（Multi-Agent）框架。它的核心理念是：将不同的角色分配给不同的 GPT 模型，让它们像一家软件公司的员工一样协同工作，共同完成复杂的任务。

简单来说，MetaGPT 把软件开发的标准化流程（SOP）固化到了代码中，并应用到一个由大语言模型（LLM）组成的“虚拟团队”里。这个团队里有产品经理、架构师、项目经理和工程师，各司其职。

能干什么

MetaGPT 最核心的能力是：输入一行需求，输出完整的项目产出。

你只需要给它一个简单的需求描述（例如“创建一个2048游戏”），它就能自动生成：

• 用户故事
• 竞品分析
• 需求文档
• 数据结构
• API 接口
• 项目代码
• 相关文档

它把整个软件公司的协作流程自动化了，让你从想法直接跳到可运行的代码仓库。

怎么装

1. 环境准备

确保你的系统已安装 Python 3.9 或更高版本（但低于 3.12）。推荐使用 conda 创建虚拟环境：

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

2. 安装 MetaGPT

使用 pip 安装稳定版：

pip install --upgrade metagpt

或者从 GitHub 源码安装：

git clone https://github.com/geekan/MetaGPT.git
cd MetaGPT
pip install --upgrade -e .

3. 安装额外依赖

在实际使用前，还需要安装 node 和 pnpm。

4. 配置 API Key

运行以下命令初始化配置文件：

metagpt --init-config

这会在 ~/.metagpt/ 目录下生成 config2.yaml 文件。你需要编辑这个文件，填入你的 LLM API 信息。参考配置如下：

llm:
  api_type: "openai"  # 或 azure / ollama / groq 等
  model: "gpt-4-turbo"  # 或 gpt-3.5-turbo
  base_url: "https://api.openai.com/v1"  # 国内访问受限，请使用兼容的国产服务
  api_key: "YOUR_API_KEY"

注意：国内访问 OpenAI API 受限，推荐使用国产大模型服务（如 DeepSeek、通义千问等）作为替代。你需要将 api_type、base_url 和 api_key 替换为对应服务的配置。

怎么用第一个例子

安装配置完成后，你就可以用一行命令生成一个完整的项目了。

方式一：命令行

在终端中直接运行：

metagpt "Create a 2048 game"

MetaGPT 会开始工作，最终在 ./workspace 目录下生成一个包含完整代码的 2048 游戏项目。

方式二：作为 Python 库使用

你也可以在 Python 脚本中调用 MetaGPT：

from metagpt.software_company import generate_repo
from metagpt.utils.project_repo import ProjectRepo

repo: ProjectRepo = generate_repo("Create a 2048 game")
print(repo)  # 打印项目结构

社区资源

• GitHub 仓库: FoundationAgents/MetaGPT
• 官方文档: docs.deepwisdom.ai (英文)
• Discord 社区: 加入讨论
• Twitter: @MetaGPT_

---

翻译整理自 GitHub README，原文：https://github.com/FoundationAgents/MetaGPT