Skip to content

安装

我们提供了几种安装MetaGPT的方式,请选择最适合你的方式。

支持的系统和版本

系统版本Python版本是否支持
macOS 13.xpython 3.9
Windows 11python 3.9
Ubuntu 22.04python 3.9

请确保你的系统已安装Python 3.9+。你可以通过以下命令进行检查:

python3 --version
python3 --version

安装稳定版本

推荐大多数用户使用。你可以像使用任何python包一样导入MetaGPT,使用各种内置角色或团队,并构建自己的智能体来服务各种应用。

pip install metagpt
pip install metagpt

安装最新的开发版本

最适合体验最新功能的用户。

pip install git+https://github.com/geekan/MetaGPT
pip install git+https://github.com/geekan/MetaGPT

以开发模式安装

推荐给那些想要根据自己的独特需求定制框架、尝试新的想法或者利用框架创建复杂功能(如新颖的记忆机制)的开发者和研究者。

git clone https://github.com/geekan/MetaGPT.git
cd /your/path/to/MetaGPT
pip install -e .
git clone https://github.com/geekan/MetaGPT.git
cd /your/path/to/MetaGPT
pip install -e .

使用Docker安装

使用默认的MetaGPT镜像

bash
# 第1步:下载metagpt官方镜像并准备config.yaml
docker pull metagpt/metagpt:latest
mkdir -p /opt/metagpt/{config,workspace}
docker run --rm metagpt/metagpt:latest cat /app/metagpt/config/config.yaml > /opt/metagpt/config/key.yaml
vim /opt/metagpt/config/key.yaml # 修改配置

# 第2步:使用容器运行metagpt demo
docker run --rm \
    --privileged \
    -v /opt/metagpt/config/key.yaml:/app/metagpt/config/key.yaml \
    -v /opt/metagpt/workspace:/app/metagpt/workspace \
    metagpt/metagpt:latest \
    metagpt "Write a cli snake game"

# 你也可以启动一个容器并在其中执行命令
docker run --name metagpt -d \
    --privileged \
    -v /opt/metagpt/config/key.yaml:/app/metagpt/config/key.yaml \
    -v /opt/metagpt/workspace:/app/metagpt/workspace \
    metagpt/metagpt:latest

docker exec -it metagpt /bin/bash
$ metagpt "Write a cli snake game"
# 第1步:下载metagpt官方镜像并准备config.yaml
docker pull metagpt/metagpt:latest
mkdir -p /opt/metagpt/{config,workspace}
docker run --rm metagpt/metagpt:latest cat /app/metagpt/config/config.yaml > /opt/metagpt/config/key.yaml
vim /opt/metagpt/config/key.yaml # 修改配置

# 第2步:使用容器运行metagpt demo
docker run --rm \
    --privileged \
    -v /opt/metagpt/config/key.yaml:/app/metagpt/config/key.yaml \
    -v /opt/metagpt/workspace:/app/metagpt/workspace \
    metagpt/metagpt:latest \
    metagpt "Write a cli snake game"

# 你也可以启动一个容器并在其中执行命令
docker run --name metagpt -d \
    --privileged \
    -v /opt/metagpt/config/key.yaml:/app/metagpt/config/key.yaml \
    -v /opt/metagpt/workspace:/app/metagpt/workspace \
    metagpt/metagpt:latest

docker exec -it metagpt /bin/bash
$ metagpt "Write a cli snake game"

docker run ...命令做了以下事情:

  • 以特权模式运行,以获得运行浏览器的权限
  • 将主机配置文件/opt/metagpt/config/key.yaml映射到容器/app/metagpt/config/key.yaml
  • 将主机目录/opt/metagpt/workspace映射到容器/app/metagpt/workspace
  • 执行demo命令metagpt "Write a cli snake game"

自行构建镜像

bash
# 你也可以自行构建metagpt镜像。
git clone https://github.com/geekan/MetaGPT.git
cd MetaGPT && docker build -t metagpt:custom .
# 你也可以自行构建metagpt镜像。
git clone https://github.com/geekan/MetaGPT.git
cd MetaGPT && docker build -t metagpt:custom .

安装全部功能

如果你想生成一些图表,比如象限图,系统设计图,顺序流程图等,这非常有用。如果你运行软件启动示例,它们将作为中间结果提供给你。

Mermaid

Mermaid是一种使用文本生成流程图、饼图、甘特图和其他图表的语言。MetaGPT使用Mermaid创建流程图、序列图和甘特图等图表。Mermaid是在Node.js中实现的,直接安装可能有些昂贵。MetaGPT提供以下Mermaid引擎将Mermaid文本转换为图表:

nodejs 通过nodejs直接安装mermaid-cli。MetaGPT调用命令行将Mermaid文本转换为图表。你需要先安装nodejs,然后使用npm进行安装:

npm install -g @mermaid-js/mermaid-cli
npm install -g @mermaid-js/mermaid-cli

这是mermaid提供的官方方法,通过nodejs安装,因此它基本上支持所有平台,也支持输出png/svg/pdf格式。然而,它需要安装nodejs和mermaid-cli,安装和使用有一定的成本,并且在运行时需要浏览器环境。

pyppeteer Mermaid也可以通过JavaScript调用,pyppeteer是一个用Python实现的web自动化测试工具,可以执行JavaScript脚本。因此,使用pyppeteer + mermaidjs可以将Mermaid文本转换为图表。你可以使用pip安装pyppeteer:

pip install pyppeteer
pip install pyppeteer

这种方法安装相对简单,没有平台限制,并支持输出png/svg/pdf格式。然而,它需要依赖于浏览器,所以你需要先安装一个浏览器,并在运行时设置浏览器路径:

export PUPPETEER_EXECUTABLE_PATH=/path/to/your/chromium  # 或者edge或chrome
export PUPPETEER_EXECUTABLE_PATH=/path/to/your/chromium  # 或者edge或chrome

(注意:pyppeteer已经不再维护)

playwright 由于pyppeteer已经不再维护,它推荐使用playwright-python作为替代。使用playwright运行mermaid的原理与pyppeteer相同。然而,playwright-python需要安装其自己提供的浏览器,不能使用已经安装的浏览器。官方只支持以下平台:

  • Windows 10+,Windows Server 2016+或Windows Subsystem for Linux (WSL)。
  • MacOS 12 Monterey或MacOS 13 Ventura。
  • Debian 11,Debian 12,Ubuntu 20.04或Ubuntu 22.04。
pip install playwright
playwright install --with-deps chromium
pip install playwright
playwright install --with-deps chromium

ink Mermaid.ink 项目提供了将 Mermaid 文本在线转换为图表的功能,请参阅 Mermaid.ink。因此,任何连接到互联网的设备都可以使用ink方法,而无需本地浏览器或其他依赖关系。然而,此方法仅支持生成 PNG 和 SVG,不支持 PDF,并且在操作过程中需要访问 Mermaid.ink,可能会受到网络和其他因素的影响,可能导致稳定性受到影响。

对比

Mermaid引擎nodejspyppeteerplaywrightink
安装简易度★★★★★★★★★★
平台兼容性★★★★★★★★★★★★★★★★★
生成png
生成svg
生成pdf
离线运行

Released under the MIT License.