安装

相关源文件

• .gitignore
• .pre-commit-config.yaml
• README.md
• autogpt_platform/autogpt_libs/autogpt_libs/api_key/key_manager.py
• autogpt_platform/autogpt_libs/autogpt_libs/auth/depends.py
• autogpt_platform/autogpt_libs/autogpt_libs/feature_flag/__init__.py
• autogpt_platform/autogpt_libs/autogpt_libs/feature_flag/client_test.py
• autogpt_platform/autogpt_libs/autogpt_libs/feature_flag/config.py
• autogpt_platform/autogpt_libs/autogpt_libs/utils/__init__.py
• autogpt_platform/autogpt_libs/poetry.lock
• autogpt_platform/autogpt_libs/pyproject.toml
• autogpt_platform/backend/backend/data/api_key.py
• autogpt_platform/backend/backend/server/model.py
• autogpt_platform/backend/backend/util/metrics.py
• autogpt_platform/backend/docker-compose.test.yaml
• autogpt_platform/backend/linter.py
• autogpt_platform/backend/poetry.lock
• autogpt_platform/backend/pyproject.toml
• autogpt_platform/backend/run_tests.py
• classic/benchmark/poetry.lock

本指南提供了安装 AutoGPT 平台及其依赖项的详细步骤。它涵盖了 AutoGPT 平台（前端和后端组件）以及经典 AutoGPT 系统。有关安装后配置 AutoGPT 的信息，请参阅配置。

安装流程概述

在开始安装步骤之前，先了解将要安装的组件以及它们如何协同工作会很有帮助。

来源：README.md14-21 autogpt_platform/backend/pyproject.toml10-66 .pre-commit-config.yaml34-71

先决条件

在安装 AutoGPT 之前，请确保您的系统上已安装以下必备组件

必备组件	版本	描述
Python	>=3.10, <3.13	后端组件必需
Node.js	最近的 LTS 版本	前端组件必需
Docker	最新版	用于容器化依赖项
Docker Compose	最新版	用于编排多个容器
Git	最新版	用于克隆仓库
Poetry	>=2.0	Python 依赖项管理
VSCode (可选)	最新版	推荐编辑器

来源：autogpt_platform/backend/pyproject.toml11 README.md24

安装步骤

安装过程可分为几个关键步骤

1. 克隆仓库

首先，从 GitHub 克隆 AutoGPT 仓库

来源：README.md1-2

2. 后端安装

后端使用 Python 构建，并使用 Poetry 进行依赖管理。请按照以下步骤设置后端

2.1 安装 Python 依赖项

使用 Poetry 安装所需的 Python 包

这将安装 pyproject.toml 文件中指定的所有依赖项，包括

• FastAPI 用于 API 服务器
• Redis 和 PostgreSQL 客户端
• LLM 集成（OpenAI、Anthropic 等）
• 各种实用程序库

来源：autogpt_platform/backend/pyproject.toml10-66 .pre-commit-config.yaml26-34

2.2 设置数据库

AutoGPT 使用 PostgreSQL 并带有 pgvector 扩展进行向量存储。最简单的设置方法是使用 Docker Compose

数据库运行后，您需要运行 Prisma 迁移

来源：autogpt_platform/backend/docker-compose.test.yaml1-46 .pre-commit-config.yaml76-84 autogpt_platform/backend/run_tests.py63

3. 前端安装

前端使用 React 和 Next.js 构建。要安装它

来源：README.md26-41 .pre-commit-config.yaml173-182

4. 配置环境变量

在后端和前端目录中都创建一个 .env 文件来配置各种设置。您可以使用示例文件作为模板

需要配置的关键环境变量

可变	描述	位置
DB_URL	PostgreSQL 连接字符串	后端
REDIS_URL	Redis 连接字符串	后端
RABBITMQ_URL	RabbitMQ 连接字符串	后端
OPENAI_API_KEY	您的 OpenAI API 密钥（如果使用 OpenAI）	后端
ANTHROPIC_API_KEY	您的 Anthropic API 密钥（如果使用 Anthropic）	后端
NEXT_PUBLIC_API_URL	后端 API 的 URL	前端

来源：autogpt_platform/backend/docker-compose.test.yaml4-6 .gitignore2-24 autogpt_platform/backend/backend/util/metrics.py9-11

运行 AutoGPT

安装和配置好所有内容后，您就可以运行 AutoGPT 了

运行后端

这将启动多个组件

• REST API 服务器
• WebSocket 服务器
• 执行引擎
• 调度器

来源：autogpt_platform/backend/pyproject.toml86-94

运行前端

这将启动 Next.js 开发服务器，通常在 http://:3000 上运行。

安装图：代码实体和组件

此图显示了安装过程中涉及的关键代码实体以及它们如何交互

来源：autogpt_platform/backend/pyproject.toml86-94 autogpt_platform/backend/backend/server/model.py1-80 autogpt_platform/backend/docker-compose.test.yaml1-46

环境设置图

此图说明了环境变量的配置以及不同组件如何访问它们

来源：autogpt_platform/backend/backend/util/metrics.py9-24 autogpt_platform/backend/backend/util/settings.py (inferred) autogpt_platform/autogpt_libs/autogpt_libs/feature_flag/config.py4-16

疑难解答常见的安装问题

以下是安装过程中可能遇到的一些常见问题及其解决方法

1. 数据库连接问题:

   • 确保 PostgreSQL 正在运行：docker ps | grep postgres
   • 检查 .env 文件中的连接字符串
   • 运行 prisma migrate dev 以确保架构是最新的

2. Python 依赖项问题:

   • 确保您使用的是兼容的 Python 版本（3.10-3.12）
   • 尝试 poetry lock --no-update 然后执行 poetry install
   • 使用 poetry show --tree 检查是否存在冲突的依赖项

3. 前端构建问题:

   • 清除 Node.js 缓存：npm cache clean --force
   • 删除 node_modules 并重新安装：rm -rf node_modules && npm install
   • 确保您使用的是兼容的 Node.js 版本

4. API 密钥配置:

   • 验证您为 OpenAI/Anthropic 配置的 API 密钥是否正确
   • 检查环境变量中是否存在空格

来源: .gitignore114-131 autogpt_platform/backend/backend/util/metrics.py9-24

安装经典的 AutoGPT 组件

如果您还想安装经典的 AutoGPT 组件（Forge、Benchmark、CLI），请遵循以下额外步骤

您可以使用以下命令运行 CLI

来源: README.md94-147 .pre-commit-config.yaml44-71

结论

您现在已成功安装 AutoGPT 及其所有依赖项。下一步：

• 有关详细配置选项，请参阅 配置
• 查看 快速入门指南 来构建您的第一个代理
• 访问 AutoGPT 平台文档 了解平台的更多功能

如果您遇到任何问题，请咨询项目的 GitHub 仓库或加入 Discord 社区寻求支持。