OpenAGI
为 AIOS 创建、组织、上传和下载 Python Agent 的开发包。
- Star 数
- ★ 2.3k
- 最近更新
- 1 年前
- License
- MIT
- 主语言
- Python
- FA 评分
- 18/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 平台专用
- 费用
- 免费，无需付费服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 为 AIOS 开发自定义 Agent 的 Python 开发者，需要按作者和 Agent 名称维护标准目录结构。
- 不适合
- 需要跨平台运行智能体的团队，该项目面向 AIOS 构建
- 已按 README 建议迁移到 Cerebrum 的开发者
- 需要文档化认证、服务端点或错误处理的团队
这个 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。
如何安装或部署这个 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 当前 | 18 · 缺口较多 | 命令行工具免费 | ★ 2.3k | 1 年前 | Python | — |
| LightAgent | 60 · 存在缺口 | 代码库 / SDK免费 + 模型费 | ★ 1.2k | 13 天前 | Python | OpenAI API |
| Langroid 多智能体框架 | 70 · 存在缺口 | 代码库 / SDK免费 + 模型费 | ★ 4.1k | 4 天前 | Python | Claude Code · OpenAI API |
| AgenticX 多智能体平台 | 64 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 235 | 今天 | Python | Claude Code · OpenAI API · Claude API |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示：仓库未提供权限管理、用户确认、数据流透明性、敏感数据处理、依赖安全、外部影响、回滚或来源归属的明确机制。因此所有信任标准得分为0。扣分原因：缺乏这些方面的文档或实现。
证据显示：README和pyproject.toml中的描述一致，但存在不一致之处，如README中的克隆URL错误（agiresearch/OpenAGI vs 实际仓库）。依赖列表在requirements.txt中列出，但未提供版本锁定或完整性校验。失败消息未在文档中说明。因此自一致性得1分，依赖可用性得1分，失败消息得0分。
证据显示：README描述了目标受众（AIOS用户）和场景（创建代理）。能力边界未明确说明，但提供了添加新代理的指南。触发精度未涉及。环境适配部分提供了安装说明，但未提及操作系统或Python版本的具体要求。因此受众和场景得1分，能力边界得1分，触发精度得0分，环境适配得1分。
证据显示：信息架构清晰，有README、LICENSE、pyproject.toml等。安装说明存在，但本地安装命令中的URL有误。命名稳定性未明确，但版本号存在。示例和FAQ部分有基本示例，但无FAQ。已知限制未提及。许可证为MIT，但版权年份为2024，与仓库创建时间可能不符。版本变更日志缺失。维护责任未明确，但贡献指南存在。因此信息架构得1分，安装说明得2分，命名稳定性得1分，示例和FAQ得1分，已知限制得0分，许可证得2分，版本变更日志得0分，维护责任得1分。
证据显示：输出可用性未明确，但提供了使用示例。边际价值在于提供代理创建框架，但未与其他方案比较。成本效益未讨论。因此输出可用性得1分，边际价值得1分，成本效益得1分。
证据显示：README中引用了论文，但未提供具体实现细节。跨来源验证不足，因为只有单一来源。事实与推断未明确区分。因此声明可追溯性得1分，跨来源验证得0分，事实与推断分离得0分。
- 源码中未见：最小权限约束只授予完成任务所需的权限：用专用账号或只读令牌，并限定可访问的目录和仓库。
- 源码中未见：执行前用户确认开启或自行加上执行前确认；先在沙箱或测试环境跑通，确认行为后再接入真实数据。
- 源码中未见：数据流向说明运行时观察它连接了哪些外部服务（代理或防火墙日志）；弄清数据去向之前不要输入敏感数据。
- 源码中未见：敏感信息处理使用专用、低权限、可随时吊销的 API 密钥，不要复用生产凭据，也不要让密钥出现在日志里。
- 源码中未见：依赖安全审查安装前固定版本并做一次依赖扫描（如 npm audit、pip-audit）；优先放在容器里运行。
- 源码中未见：外部影响披露先弄清它会写入、发送或修改哪些外部系统，用测试账号或测试仓库验证后再接入正式环境。
- 源码中未见：回滚或恢复路径运行前先备份，或在 git 分支、快照上操作，确保改动可以撤销。
- 源码中未见：来源归属可核验从官方仓库或包源安装，核对发布者和仓库地址，避免同名仿冒包。
- README中的克隆URL错误（agiresearch/OpenAGI vs 实际仓库），可能导致用户安装失败。
- 依赖未固定版本，存在供应链风险。
- 未提供安全相关文档，如权限管理、数据流透明性等。
- 未提供已知限制和版本变更日志，影响用户评估。