仓库：https://github.com/reworkd/AgentGPT 在线 Demo：https://agentgpt.reworkd.ai 文档：https://reworkd.ai/docs 默认端口：3000 技术栈：Next.js 13 + TypeScript + FastAPI + Prisma + SQLModel + MySQL
1. 项目简介
AgentGPT 是一个能在浏览器里"组装、配置、部署自主 AI Agent"的开源项目。给你的 AI 起个名字、定一个目标，它就会自己思考下一步、执行、从结果中学习，直到完成目标。
1.1 核心信息一览
| 项目 | 内容 |
|---|---|
| 仓库 | reworkd/AgentGPT |
| 定位 | 浏览器里的自主 AI Agent 编排 |
| 前端 | Next.js 13 + TypeScript + TailwindCSS + HeadlessUI |
| 后端 | FastAPI + SQLModel |
| 数据库 | MySQL |
| ORM | Prisma / SQLModel |
| 认证 | Next-Auth.js |
| LLM 工具 | LangChain |
| Node 要求 | ≥ 18 |
1.2 适用场景
- 想在浏览器里体验"给 Agent 一个目标让它自己跑"；
- 想研究 Next.js + FastAPI + MySQL 全栈 Agent 应用结构；
- 想基于此二次开发自己的自主 Agent 产品。
1.3 能力边界（官方口径）
- 在线 demo 是托管版；自托管需要自己准备 OpenAI API Key；
- 官方提供 setup.sh / setup.bat 一键脚本，但仍需本机装 Docker、Node、Git；
- 项目活跃度与维护状态以 GitHub 仓库最新为准。
2. 功能特性
- 浏览器内配置 Agent：起名、定目标、定任务；
- 自主思考-执行-反馈循环：Agent 自己列任务、执行、学习；
- 一键 setup 脚本：自动配环境变量、MySQL、后端、前端；
- 完整现代技术栈：Next.js 13、FastAPI、Prisma、Zod、Pydantic、Tailwind；
- 可选 Serper / Replicate：增强搜索与多模态能力。
3. 官方界面预览
官方 README 顶部 banner，自托管启动后访问
http://localhost:3000 进入相同界面。
4. 官方跳转链接汇总
- 仓库主页：https://github.com/reworkd/AgentGPT
- 在线体验：https://agentgpt.reworkd.ai
- 文档：https://reworkd.ai/docs
.env.example：https://github.com/reworkd/AgentGPT/blob/main/.env.example- Discord：https://discord.gg/gcmNyAAFfV
- 中文 README：https://github.com/reworkd/AgentGPT/blob/main/docs/README.zh-HANS.md
5. 前置要求与服务器配置
- 代码编辑器（VS Code）；
- Node.js ≥ 18；
- Git；
- Docker（用于跑 MySQL 等依赖）；
- OpenAI API Key（必需）；
- 可选：Serper API Key（搜索）、Replicate API Token（多模态）。
6. 方式一：setup.sh 一键部署（官方推荐）
Mac / Linux：
git clone https://github.com/reworkd/AgentGPT.git
cd AgentGPT
./setup.shWindows：
git clone https://github.com/reworkd/AgentGPT.git
cd AgentGPT
./setup.bat脚本会自动：
- 准备
.env与 API Key； - 拉起 MySQL；
- 启动 FastAPI 后端；
- 启动 Next.js 前端。
全部起来后浏览器打开 http://localhost:3000。
7. 方式二：手动分模块运行
仓库结构（官方 README 说明）：
db/：MySQL 相关；platform/：FastAPI 后端；next/：Next.js 前端；.env.example：环境变量模板。
手动运行需先配好 .env（参考
.env.example），再分别启动后端与前端。具体端口与启动命令以仓库最新
package.json / pyproject.toml 为准。
8. 配置项说明
| 配置 | 说明 |
|---|---|
OPENAI_API_KEY |
必需，OpenAI API Key |
SERPER_API_KEY |
可选，搜索能力 |
REPLICATE_API_TOKEN |
可选，多模态 |
.env |
从 .env.example 复制 |
9. 常用运维命令
# 一键启动
./setup.sh
# 查看 docker 依赖
docker ps
# 前端开发
cd next && npm run dev
# 后端开发
cd platform && uvicorn main:app --reload10. 常见故障排查
- Node 版本过低：必须 ≥ 18；
- Docker 没启动：setup.sh 会失败，先打开 Docker Desktop；
- 3000 端口被占：改 Next.js 端口或停掉占用进程；
- OpenAI 401：检查
.env里的OPENAI_API_KEY； - 数据库连不上：确认 MySQL 容器已 healthy。
11. 风险与合规说明
- 许可证以仓库 LICENSE 为准；
- Agent 自主执行可能消耗大量 OpenAI token，注意额度；
- 自托管数据存在你自己的 MySQL 里；
- 本文为社区部署笔记，命令以官方 README 最新版本为准。