Repolode
omnirexflora-labs

omnirexflora-labs/omnicoreagent

一个 Python 智能体运行时,为大模型提供工具、记忆、逐步策略审批、命令沙箱、崩溃后可恢复的运行记录与完整执行追踪。

Star
252
Fork
57
未关闭 Issue
0
最近提交
13天前

这是什么?

OmniCoreAgent 是一个用 Python 构建大模型智能体的运行时。它提供模型周边的工具循环(支持自定义 Python 函数和 MCP 服务器)、会话记忆、上下文管理、文件工作区以及子智能体,可以在 Python 代码、命令行或 HTTP 服务中使用。

针对会执行真实操作的智能体,它增加了控制能力:策略可对工具、MCP 服务器、沙箱、网络和任务委派设置允许、询问或拒绝规则,“询问”会暂停运行等待人工审批。命令可在 Docker、E2B、Modal 等沙箱中执行,预算可按金额、token 或调用次数限制。运行过程保存检查点,进程崩溃后可以续跑,且不会静默重复已中断的工具调用。

每次运行都会生成完整追踪,包括模型调用、工具调用、审批和预算决策,可导出到 OTLP、LangSmith、Opik 或 JSONL。运行结束后还可以补充结果反馈,并导出为训练记录。

核心功能

  • 01工具循环支持自定义 Python 函数,以及通过 stdio、SSE、streamable HTTP 接入的 MCP 服务器。
  • 02策略支持允许、询问、拒绝三类规则,覆盖工具、沙箱、网络和任务委派。
  • 03命令可在 Docker、E2B、Modal、Daytona 等沙箱中执行。
  • 04预算可按美元、token 或调用次数设置,作用于单次请求、会话或每日。
  • 05运行可在进程崩溃后从检查点恢复,不会静默重复已中断的调用。
  • 06每次运行生成完整追踪,可导出到 OTLP、LangSmith、Opik 或 JSONL。

适用场景

  • 构建需要调用内部接口的客服智能体,并对退款等操作加入人工审批。
  • 在 CI 中运行编码智能体,在沙箱内修复失败测试并设置预算上限。
  • 通过 REST 和 SSE 接口对外提供智能体服务,并运行后台任务。
  • 通过阅读模型调用和工具调用的完整追踪来审计智能体行为。

快速上手

  1. 1

    使用 pip 安装包

    pip install omnicoreagent
  2. 2

    设置你的 LLM 提供商 API 密钥

    export LLM_API_KEY=your_api_key
  3. 3

    将 README 中的快速开始代码保存为 Python 文件并运行

使用前须知

  • 需要 Python 3.12 至 3.14;在 Python 3.10 或 3.11 上安装会中止。
  • 运行智能体需要受支持的 LLM 提供商的 API 密钥。

标签

常见问题

omnicoreagent 是什么?
一个 Python 智能体运行时,为大模型提供工具、记忆、逐步策略审批、命令沙箱、崩溃后可恢复的运行记录与完整执行追踪。 OmniCoreAgent 是一个用 Python 构建大模型智能体的运行时。它提供模型周边的工具循环(支持自定义 Python 函数和 MCP 服务器)、会话记忆、上下文管理、文件工作区以及子智能体,可以在 Python 代码、命令行或 HTTP 服务中使用。
omnicoreagent 可以免费使用吗?用的什么许可证?
omnicoreagent 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
omnicoreagent 还在维护吗?
活跃维护中。omnicoreagent 最近一次提交是在 2026年10月9日。
omnicoreagent 适合用来做什么?
构建需要调用内部接口的客服智能体,并对退款等操作加入人工审批。 在 CI 中运行编码智能体,在沙箱内修复失败测试并设置预算上限。 通过 REST 和 SSE 接口对外提供智能体服务,并运行后台任务。 通过阅读模型调用和工具调用的完整追踪来审计智能体行为。
omnicoreagent 怎么安装和运行?
使用 pip 安装包: pip install omnicoreagent 设置你的 LLM 提供商 API 密钥: export LLM_API_KEY=your_api_key 将 README 中的快速开始代码保存为 Python 文件并运行
在哪里获取 omnicoreagent?
源代码和安装说明在 GitHub 上:https://github.com/omnirexflora-labs/omnicoreagent

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目