OpenAGI

为 AIOS 创建、组织、上传和下载 Python Agent 的开发包。

Star 数
★ 2.3k
最近更新
1 年前
License
MIT
主语言
Python

30 秒速览

运行形态
命令行工具开发框架
可在哪里用
平台专用
费用
免费,无需付费服务
上手难度
低 · 几分钟可跑通
开始前需要
pipShell / 命令行网络访问本地文件系统
典型场景
为 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 实现。

  1. 为 AIOS 开发自定义 Agent 的 Python 开发者,需要按作者和 Agent 名称维护标准目录结构。
  2. 正在实现 Agent 执行逻辑的团队,需要将主代码、配置和依赖声明分别放入 agent.py、config.json 与 meta_requirements.txt。
  3. 需要让开发中的 Agent 使用外部工具的工程师,可按仓库提供的工具设置说明进行配置。
  4. 要为自研 Agent 新增工具文件的维护者,可在 pyopenagi/tools/ 目录扩展工具实现。
  5. 已经完成测试的 Agent 作者,需要通过 interact.py 的 upload 模式分享其本地 Agent。
  6. 想查看他人 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 OpenAGI

pip 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?

FollowAgents 源码审查 · FARS-2.1
缺口较多
44/ 100 五分制 2.2 / 5
信任安全 10/29
可靠稳定 5/14
适用触发 9/18
规范维护 10/18
有效结果 6/13
证据核验 4/8
查看各维度的扣分理由
信任安全10 / 29 · 1.7/5

证据显示该包用于创建和上传、下载 Agent,并可使用外部工具;依赖文件包含 Playwright 等能力,但材料没有说明权限边界、用户确认、数据流、敏感信息保护或副作用恢复,因此这些项仅给薄弱分;没有回滚机制证据,回滚为 0。README 将研究论文与代码仓库关联,LICENSE 标明版权归属,支持来源归属 2 分,但发布者身份仍未知。

可靠稳定5 / 14 · 1.8/5

CI 配置了 Python 3.11 和 pytest,样例测试检查 AgentProcess 的名称,币种工具测试在缺少 API key 时跳过并在有 key 时检查返回类型。测试覆盖与断言较窄,且依赖含未固定版本,因此自洽性、依赖可用性和失败反馈仅有部分支持。

适用触发9 / 18 · 2.5/5

README 明确面向开发者,给出新建 Agent 的目录结构、工具扩展方式及 AIOS 使用背景,支持常见开发场景。材料没有清楚界定能力边界或触发条件;Python >=3.9 和安装说明有助于环境适配,但解释的运行环境有限。

规范维护10 / 18 · 2.8/5

README、工具说明入口、贡献指南入口和目录结构组织较清楚,提供安装、添加、上传及下载示例。MIT 许可全文完整,给满分;限制说明仅指出迁移到 Cerebrum,未系统列出已知限制。版本为 0.0.11,但材料没有变更日志;贡献和问题入口可见,维护责任与更新路径仍不够明确。

有效结果6 / 13 · 2.3/5

该框架提供 Agent 目录约定、工具接入和共享流程,能为开发者提供实际起点,因此边际价值给 2 分。材料未展示 Agent 输出规范或实际结果质量,且安装、配置和外部 API key 等成本缺少权衡说明,故输出可用性与成本效益仅给 1 分。

证据核验4 / 8 · 2.5/5

安装命令、目录结构、版本、依赖和测试示例均可在所给文件中定位;README 的研究与产品关系有论文引用支持。README 声明的功能与测试之间只有有限交叉印证,测试未验证主要 Agent 能力。材料区分了使用说明与示例,但对性能、质量等产品主张没有充分证据。

风险与缓解建议
  • 源码中未见:回滚或恢复路径运行前先备份,或在 git 分支、快照上操作,确保改动可以撤销。
  • 币种转换测试使用 RAPID_API_KEY,并会发起外部 API 请求;所给材料没有描述该凭据的存储与保护方式。
  • 依赖中包含未固定版本的包,静态材料未提供漏洞审查或完整的依赖维护策略。
  • README 建议 AIOS 用户迁移到 Cerebrum,表明 OpenAGI 的当前维护状态或长期支持范围需要进一步确认。
证据充分度:低 评估于 2026年11月8日 审查版本 26c119e55b8d
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

徽章显示当前的评审分数和结论,点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/openagi.svg?lang=zh)](https://followagents.com/zh/agents/openagi)
<a href="https://followagents.com/zh/agents/openagi"><img src="https://followagents.com/badge/openagi.svg?lang=zh" alt="FARS 评测"></a>

常见问题

OpenAGI 是否仍是为 AIOS 新建 Agent 的推荐选择?
README 将 OpenAGI 描述为用于构建 AIOS Agent 的创建包,但同时建议为 AIOS 构建 Agent 时迁移到 Cerebrum。
上传时 agent 参数应如何填写?
填写 <author_name/agent_name>,且该值必须与本地 Agent 文件夹路径完全匹配。
使用上传和下载功能需要什么账号或凭据?
提供的材料没有说明认证、账号、令牌或服务端点要求。
外部工具能否直接使用?
README 说明应按照 tools.md 设置外部工具,但未在提供材料中列出具体工具、凭据或支持范围。
OpenAGI 官网是什么?
OpenAGI 的 GitHub 仓库填写的官网是 https://docs.aios.foundation。这个链接由仓库作者设置;源码在 GitHub(agiresearch/OpenAGI)。
OpenAGI 免费吗?
免费。OpenAGI 可以免费使用,不需要付费服务。
OpenAGI 开源吗?
开源。源码在 GitHub(agiresearch/OpenAGI),许可证是 MIT。
OpenAGI 安全吗?
FollowAgents 的 FARS 评审(2026年11月8日)给 OpenAGI 的“信任与安全”打了 10/29 分。评审没有在源码和文档里找到这些安全措施:回滚或恢复路径。接入真实账号或数据前:运行前先备份,或在 git 分支、快照上操作,确保改动可以撤销。
OpenAGI 还在维护吗?
GitHub 仓库自 2024-11-28 以来没有新提交,已超过半年。可能是项目已经完成,也可能已经停更,用之前建议先看看 issue 区。
OpenAGI 是谁开发的?
OpenAGI 由 GitHub 账号 agiresearch 发布。FollowAgents 没有核实这个账号背后是哪个人或公司。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关核心概念