OpenAGI
为 AIOS 创建、组织、上传和下载 Python Agent 的开发包。
- Star 数
- ★ 2.3k
- 最近更新
- 1 年前
- License
- MIT
- 主语言
- Python
- FA 评分
- 44/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 平台专用
- 费用
- 免费,无需付费服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 为 AIOS 开发自定义 Agent 的 Python 开发者,需要按作者和 Agent 名称维护标准目录结构。
- 不适合
- 需要跨平台运行智能体的团队,该项目面向 AIOS 构建
- 已按 README 建议迁移到 Cerebrum 的开发者
- 需要文档化认证、服务端点或错误处理的团队
- 官网
- docs.aios.foundation ↗ 来自 GitHub 仓库设置
- 维护状态
- 超过半年没有提交最近提交 2024-11-28
这个 Agent 能做什么,适合哪些场景?
OpenAGI 是一个名为 pyopenagi 的 Python Agent 创建包,定位为构建 AIOS Agent 的工具。开发者可在 pyopenagi/agents 下按作者和 Agent 名称建立目录,并提供 agent.py、config.json 与 meta_requirements.txt。仓库还说明可在 pyopenagi/tools/ 中添加开发中 Agent 所需的新工具,并将外部工具接入到 Agent。通过 pyopenagi/agents/interact.py 的 upload 或 download 模式,开发者可分享已开发和测试的 Agent,或获取其他人的实现。README 同时提示:若要为 AIOS 构建 Agent,应迁移至 Cerebrum;它被说明为连接 AIOS kernel 的最新 SDK。
开发者先在 pyopenagi/agents/<author>/<agent_name>/ 中创建 Agent 文件夹,放入 agent.py 作为执行逻辑、config.json 作为配置、meta_requirements.txt 作为依赖声明。需要外部工具时,可按 tools.md 的说明配置;需要新增工具时,可在 pyopenagi/tools/ 中添加工具文件。完成开发和测试后,运行 python pyopenagi/agents/interact.py --mode upload --agent <author_name/agent_name> 上传分享,其中 --agent 必须与本地文件夹路径一致。运行同一脚本并将 --mode 设为 download,可下载其他开发者的 Agent 实现。
- 为 AIOS 开发自定义 Agent 的 Python 开发者,需要按作者和 Agent 名称维护标准目录结构。
- 正在实现 Agent 执行逻辑的团队,需要将主代码、配置和依赖声明分别放入 agent.py、config.json 与 meta_requirements.txt。
- 需要让开发中的 Agent 使用外部工具的工程师,可按仓库提供的工具设置说明进行配置。
- 要为自研 Agent 新增工具文件的维护者,可在 pyopenagi/tools/ 目录扩展工具实现。
- 已经完成测试的 Agent 作者,需要通过 interact.py 的 upload 模式分享其本地 Agent。
- 想查看他人 Agent 实现的开发者,可通过 interact.py 的 download 模式获取指定 author_name/agent_name。
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 安装 / 启动命令
pip install -e
- 配置文件
config.json
如何安装或部署这个 Agent?
通过 PyPI 安装:pip install pyopenagi
本地安装:
git clone https://agiresearch/OpenAGI
cd OpenAGIpip install -e .
提供的材料未说明 Python 版本、认证方式、上传服务地址或外部工具所需凭据。
如何使用这个 Agent?
在 pyopenagi/agents 下创建 pyopenagi/agents/<author>/<agent_name>/,并至少放入 agent.py、config.json 和 meta_requirements.txt。上传已开发并测试的 Agent:python pyopenagi/agents/interact.py --mode upload --agent <author_name/agent_name>。下载其他 Agent:python pyopenagi/agents/interact.py --mode download --agent <author_name/agent_name>。README 明确要求 agent 参数与本地放置的文件夹路径完全一致。
这个 Agent 有哪些优点和局限?
- 明确规定 Agent 的执行代码、配置和依赖声明的目录与文件划分。
- 提供同一 interact.py 入口完成 Agent 上传与下载两类操作。
- 支持在 pyopenagi/tools/ 中添加新工具,并提供外部工具设置入口。
- 可通过 PyPI 安装,也支持 pip install -e . 的本地可编辑安装。
- 材料将其定位为 AIOS 的 Agent 创建包,跨平台或跨运行时使用没有文档证据。
- README 已提示为 AIOS 构建 Agent 应迁移到 Cerebrum,采用 OpenAGI 可能带来迁移规划需求。
- 未说明 Python 版本、上传下载所需认证、服务端点或失败处理方式。
- 外部工具的具体支持范围、凭据要求和运行依赖未在提供材料中列出。
这个 Agent 与同类方案有什么区别?
对于连接 AIOS kernel 的最新 SDK,README 指向 Cerebrum,并建议为 AIOS 构建 Agent 时迁移至该 SDK。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| OpenAGI 当前 | 44 · 缺口较多 | 命令行工具免费 | ★ 2.3k | 1 年前 | Python | — |
| LightAgent | 60 · 存在缺口 | 代码库 / SDK免费 + 模型费 | ★ 1.2k | 6 天前 | Python | OpenAI API |
| Promptulate (pne) | 41 · 缺口较多 | 代码库 / SDK免费 + 模型费 | ★ 511 | 8 个月前 | Python | OpenAI API |
| AG2:开源智能体操作系统 | 75 · 表现良好 | 代码库 / SDK免费 + 模型费 | ★ 5.1k | 1 天前 | Python | OpenAI API |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
证据显示该包用于创建和上传、下载 Agent,并可使用外部工具;依赖文件包含 Playwright 等能力,但材料没有说明权限边界、用户确认、数据流、敏感信息保护或副作用恢复,因此这些项仅给薄弱分;没有回滚机制证据,回滚为 0。README 将研究论文与代码仓库关联,LICENSE 标明版权归属,支持来源归属 2 分,但发布者身份仍未知。
CI 配置了 Python 3.11 和 pytest,样例测试检查 AgentProcess 的名称,币种工具测试在缺少 API key 时跳过并在有 key 时检查返回类型。测试覆盖与断言较窄,且依赖含未固定版本,因此自洽性、依赖可用性和失败反馈仅有部分支持。
README 明确面向开发者,给出新建 Agent 的目录结构、工具扩展方式及 AIOS 使用背景,支持常见开发场景。材料没有清楚界定能力边界或触发条件;Python >=3.9 和安装说明有助于环境适配,但解释的运行环境有限。
README、工具说明入口、贡献指南入口和目录结构组织较清楚,提供安装、添加、上传及下载示例。MIT 许可全文完整,给满分;限制说明仅指出迁移到 Cerebrum,未系统列出已知限制。版本为 0.0.11,但材料没有变更日志;贡献和问题入口可见,维护责任与更新路径仍不够明确。
该框架提供 Agent 目录约定、工具接入和共享流程,能为开发者提供实际起点,因此边际价值给 2 分。材料未展示 Agent 输出规范或实际结果质量,且安装、配置和外部 API key 等成本缺少权衡说明,故输出可用性与成本效益仅给 1 分。
安装命令、目录结构、版本、依赖和测试示例均可在所给文件中定位;README 的研究与产品关系有论文引用支持。README 声明的功能与测试之间只有有限交叉印证,测试未验证主要 Agent 能力。材料区分了使用说明与示例,但对性能、质量等产品主张没有充分证据。
- 源码中未见:回滚或恢复路径运行前先备份,或在 git 分支、快照上操作,确保改动可以撤销。
- 币种转换测试使用 RAPID_API_KEY,并会发起外部 API 请求;所给材料没有描述该凭据的存储与保护方式。
- 依赖中包含未固定版本的包,静态材料未提供漏洞审查或完整的依赖维护策略。
- README 建议 AIOS 用户迁移到 Cerebrum,表明 OpenAGI 的当前维护状态或长期支持范围需要进一步确认。
常见问题
OpenAGI 是否仍是为 AIOS 新建 Agent 的推荐选择?
上传时 agent 参数应如何填写?
使用上传和下载功能需要什么账号或凭据?
外部工具能否直接使用?
OpenAGI 官网是什么?
OpenAGI 免费吗?
OpenAGI 开源吗?
OpenAGI 安全吗?
OpenAGI 还在维护吗?
OpenAGI 是谁开发的?
谢谢反馈,我们会据此改进页面。