Meta GPT 五分钟入门指南
本文旨在通过简洁明了的讲解，帮助读者快速了解 MetaGPT 的核心概念、主要优势，并掌握其基本使用方法，实现应用代码的快速生成。
MetaGPT 概念
MetaGPT 是一个基于大型语言模型（如 GPT 系列）的高级框架，通过模拟多角色协作与任务分解，提升复杂任务的自动化处理能力。其核心是将单一模型扩展为多角色协同系统，克服传统 GPT 在复杂任务中的局限性。
MetaGPT 优点
高效任务分解
MetaGPT 能将复杂任务拆解为多个子任务，由不同“角色”并行处理，提升执行效率与输出质量。各子任务模块化独立运行，便于管理与优化。
多角色协作
系统模拟虚拟团队，如产品经理、开发、测试等角色各司其职，实现专业化分工与高效协作，确保流程严谨、结果精准。
自动化与智能化
从任务拆解到结果生成全程自动化，减少人工干预。依托大模型能力，系统可进行智能决策，动态优化执行路径与输出效果。
灵活性与可扩展性
支持用户自定义角色与工作流程，灵活适配不同场景。框架设计开放，易于集成外部工具或技术，满足多样化复杂需求。
MetaGPT 快速入门
环境准备
- Python 3.9
- 任意 Python IDE（如 PyCharm）
- DeepSeek API Key
创建 Python 项目
使用 IDE 创建 Python 项目，建议选择 virtualenv 环境，避免污染全局 Python 环境。
注意：红框部分需选择 virtualenv，以隔离项目依赖。
安装 MetaGPT
在项目根目录执行以下命令安装 MetaGPT：
pip install metagpt -i https://pypi.tuna.tsinghua.edu.cn/simple
配置大语言模型
MetaGPT 基于大语言模型运行，需配置对应 API 信息。本文以 Deepseek 为例，步骤如下：
- 在项目目录创建
config文件夹，新增config2.yaml文件； - 复制示例配置内容；
- 替换
api_key为个人密钥。
llm:
api_type: 'openai' # or azure / ollama / groq etc.
api_key: 'xx' # YOUR_API_KEY
model: 'deepseek-chat'
base_url: 'https://api.deepseek.com'使用 MetaGPT 开发 2048 游戏
创建 setup.py 文件，导入所需角色：
import asyncio
from metagpt.roles import (
Architect,
Engineer,
ProductManager,
ProjectManager,
)
from metagpt.team import Team因开发游戏需多角色协同，故引入产品经理、架构师、项目经理和工程师。
初始化团队，配置角色、预算及项目需求：
async def startup(idea: str):
# 创建团队
company = Team()
# 雇佣角色
company.hire([
ProductManager(),
Architect(),
ProjectManager(),
Engineer(),
])
# 设置预算
company.invest(investment=3.0)
# 创建项目
company.run_project(idea=idea)
# 运行项目
await company.run(n_round=5)运行项目：
if __name__ == "__main__":
asyncio.run(startup('创建一个2048游戏,使用可视化界面'))当控制台持续输出执行日志时，表示 MetaGPT 已开始任务拆分与执行，过程约需 3–5 分钟，请耐心等待。
生成完成后，代码将位于 workspace 目录下，结构因人而异，请自行确认。
执行 main.py，即可弹出 2048 游戏界面，整个开发流程完成，操作高效便捷。
用户也可尝试生成其他小游戏，如带可视化界面的 21 点游戏，进一步体验 MetaGPT 的自动化开发能力。
注意事项
- TypeError: __init__() got an unexpected keyword argument 'proxies'
此问题由 httpx 版本冲突引起。默认安装版本为 0.28.0，建议降级至 0.27.2：
pip install httpx==0.27.2 - Mermaid CLI 报错（ERR_MODULE_NOT_FOUND）
若提示无法找到 puppeteer 或 mermaid 相关包，请执行全局安装：
npm install -g @mermaid-js/mermaid-cli或修改配置使用 playwright、pyppeteer 等替代引擎。
通过本次快速入门，您已掌握 MetaGPT 的核心概念与基础操作。作为强大的多智能体协作框架，MetaGPT 可有效支持复杂任务的自动化构建与管理。后续可深入探索自定义智能体、优化执行流程，或将该技术应用于实际业务场景中。