仓库：https://github.com/SuperAGI-ai/SuperAGI 许可证：MIT（以仓库 LICENSE 为准） 运行形态：Docker Compose 多服务 Web 平台，默认端口 3000
1. 项目简介
SuperAGI 是一个 dev-first 的开源自治 AI Agent 框架：让开发者构建、管理、运行有用的自治 Agent。官方定位是可并发运行多个 Agent、用工具包扩展 Agent 能力，Agent 在每次运行后持续自我改进。
1.1 核心信息一览
| 项目 | 内容 |
|---|---|
| 仓库 | SuperAGI-ai/SuperAGI（旧名 TransformerOptimus/SuperAGI） |
| 定位 | 开源自治 AI Agent 构建 / 管理 / 运行平台 |
| 部署方式 | Docker Compose（普通 / GPU 两版） |
| 访问地址 | http://localhost:3000 |
| 配置文件 | config.yaml（由 config_template.yaml 复制） |
| 状态 | 官方标注 Under Development |
1.2 适用场景
- 想在本地起一个带 GUI 的自治 Agent 平台；
- 需要并发跑多个 Agent、给 Agent 配工具包；
- 想用向量库、记忆存储、性能遥测做 Agent 实验。
1.3 能力边界（官方口径）
- ⚠️ 官方标注项目处于 Under Development，可能仍有问题；
- 有 SuperAGI Cloud 托管版；
- 模型 Provider API Key 需在设置里添加。
2. 功能特性
- 供应 / 派生 / 部署自治 Agent：生产级可扩展的 Agent；
- Toolkits 工具包市场：从市场加工具包扩展 Agent 工作流；
- 图形界面：通过 GUI 管理 Agent；
- Action Console：给 Agent 输入与权限交互；
- 多向量库：接入多种 Vector DB；
- 性能遥测：洞察 Agent 表现；
- Token 用量优化：控制成本；
- Agent 记忆存储：让 Agent 学习与适应；
- Workflows：用 ReAct LLM 预定义步骤自动化任务。
3. 官方界面预览
官方 README 的架构图（Architecture / Agent Workflow / Tools / ER Diagram）为仓库图片，未单独抓取可用位图，按规程不强行配图。
4. 官方跳转链接汇总
- 仓库主页：https://github.com/SuperAGI-ai/SuperAGI
- SuperAGI Cloud：https://cloud.superagi.com/（以官网为准）
- Discord：仓库 README 链接
- Issues：https://github.com/SuperAGI-ai/SuperAGI/issues
5. 前置要求与服务器配置
- 已安装并运行 Docker Desktop / Docker Engine；
- 端口 3000 不被占用；
- 用本地 LLM + GPU 时另起 GPU 版 compose；
- 模型 Provider API Key（在账号设置 Model Providers 中添加）。
6. 方式一：Docker Compose 本地部署（推荐）
git clone https://github.com/SuperAGI-ai/SuperAGI.git
cd SuperAGI
# 复制配置模板
cp config_template.yaml config.yaml
# 普通部署
docker compose -f docker-compose.yaml up --build浏览器打开 http://localhost:3000。
GPU + 本地 LLM 场景：
docker compose -f docker-compose-gpu.yml up --build7. 方式二：SuperAGI Cloud 与一键部署
- Cloud：用 GitHub 账号登录 SuperAGI Cloud，在 Model Providers 加 API Key 即可；
- DigitalOcean 一键部署：见仓库 README 的一键按钮。
8. 配置项说明
| 配置 | 说明 |
|---|---|
config.yaml |
由 config_template.yaml 复制后修改 |
docker-compose.yaml |
普通多服务编排 |
docker-compose-gpu.yml |
GPU / 本地 LLM 编排 |
| Model Providers | 账号设置里加各模型 API Key |
9. 常用运维命令
# 构建并启动
docker compose -f docker-compose.yaml up --build
# 停止
docker compose -f docker-compose.yaml down
# 看日志
docker compose -f docker-compose.yaml logs -f
# GPU 版
docker compose -f docker-compose-gpu.yml up --build10. 常见故障排查
- 起不来：确认 Docker
已运行、
config.yaml已复制； - 3000 被占：改宿主机映射端口；
- GPU 版报错：确认 NVIDIA 驱动 / nvidia-container-toolkit 就绪；
- 项目仍在开发：遇到问题先查 open issues，官方明示可能有未解决问题。
11. 风险与合规说明
- 许可证以仓库 LICENSE 为准；
- ⚠️ 官方标注 Under Development，生产使用前自行评估；
- 模型调用费用由对应 Provider 账号承担；
- 本文为社区部署笔记，命令以官方 README 最新版本为准。