项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
技术标签
使用教程
—
环境要求
- 已安装并可使用 Docker(A0 Install 会复用现有 Docker CLI 配置、DOCKER_HOST、Docker context 等)
- 可访问 Docker Hub 以拉取 agent0ai/agent-zero 镜像
- 一个可用的大语言模型(LLM)提供商及其 API 密钥
- 本机 80 端口可用(或自行改为其他端口)
安装与启动步骤
-
1确认 Docker 环境
README 的 Quick Start 要求 Docker 已安装。若使用 A0 Install,它会先尝试复用当前 Docker CLI 配置、DOCKER_HOST、Docker contexts 和已知本地 Docker 端点。
-
2启动容器
README 给出的直接运行命令:映射 80 端口并挂载名为 a0_usr 的数据卷到容器内 /a0/usr,用于保存实例数据。
docker run -p 80:80 -v a0_usr:/a0/usr agent0ai/agent-zero -
3打开 Web UI
容器启动后打开内置 Web UI(本机映射到 80 端口),确认界面可以正常访问。
-
4配置 LLM 提供商
在 Web UI 中配置你的 LLM 提供商,这是 README 明确要求的下一步,未配置无法开始任务。
-
5下达具体任务
README 建议从一个具体的任务开始,让智能体在容器内的 Linux 桌面、终端、文件系统和浏览器中自主执行。
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
LLM 提供商 | 是 | 在 Web UI 中配置,智能体运行所需的模型来源 | OpenAI / Anthropic 等 |
a0_usr 数据卷 | 是 | 挂载到容器内 /a0/usr,用于持久化该实例数据 | a0_usr:/a0/usr |
端口映射 | 是 | Web UI 访问端口,README 示例为本机 80 映射容器 80 | -p 80:80 |
如何确认成功
浏览器访问 http://localhost 能打开 Agent Zero 的 Web UI,即表示容器启动成功。
常见问题
Q:不想用命令行安装怎么办?
A:README 除直接 docker run 外还提供 A0 Install,适合 SSH 会话、服务器、恢复 shell 或可脚本化的安装场景。
Q:数据会随容器删除而丢失吗?
A:不会。数据卷 a0_usr 挂载到容器内 /a0/usr,实例数据保存在卷中,容器重建后仍可复用。
Q:80 端口被占用怎么办?
A:可修改 docker run 中 -p 80:80 的左侧主机端口,README 只给出了 80:80 的示例,其他端口需自行确认可用。
Q:启动后第一步做什么?
A:打开 Web UI,先配置 LLM 提供商,然后下达一个具体的任务开始使用。
注意事项
- README 强调这是 Docker 化的 Linux 桌面环境,智能体可操作真实 GUI、终端与文件
- 每个实例数据挂载在容器内 /a0/usr,建议保留该卷以避免数据丢失
- 可通过 A0 CLI 将同一个智能体桥接到你本机的真实代码仓库
- 提示词、工具、插件、技能和设置都是可查看、可编辑的,便于二次定制
核心亮点
- 智能体拥有真实 Linux 终端与文件系统,能直接执行命令、写代码并验证结果,而非只输出文本
- 支持动态创建子智能体与工具,任务可递归拆解,具备一定的自主扩展能力
- 内置 Web 界面与持久记忆,多会话管理方便,开箱即可交互使用
不足之处
- 自主执行终端命令存在安全风险,需依赖容器或沙箱隔离,生产环境需谨慎配置
- 项目迭代快、文档与提示词体系仍在演进,新手上手和稳定复现有一定门槛
适用场景
- 让 AI 自动完成服务器巡检、日志分析与脚本编写
- 作为研究自主智能体与多智能体协作的实验平台
- 个人开发者用它搭建能读写代码、跑测试的自动化助手
替代项目
AutoGPT、OpenHands、MetaGPT
上一篇:craft-agents-oss
下一篇:memU
同类项目推荐
xinchao-dynamic-mind
开源
给 AI 装上疲惫和欲望,让交互更真实
独立、可自托管的 AI 动态心智状态引擎:驱动力、念头池、疲惫、睡眠与意图。
goutoujunshi
开源
先哄情绪再出招,恋爱难题给可执行方案
一个先接住情绪、再分析关系并给出可执行策略的 Codex 恋爱军师,内置心理、法律、社会、人···
geo-sleuth
开源
给 AI 装上地理侦探技能,一张照片顺藤摸瓜找到拍摄地
An agent skill that finds where a photo was taken — OpenStreetMap geometry, elevati···
deepseek-harness
开源
把 AI 能力拆成乐高积木,拼出你的专属智能体。
DeepSeek Harness: Everything is a Plugin.
