Skip to content

开源 · 可自部署 · OpenAI Agents API

OpenAI Agents API 的开源实现。用官方 OpenAI SDK,在你自己的模型和机器上运行 Codex、Claude Code 或 MiniMax Code。

$ curl -fsSL https://github.com/MiniMax-AI/OpenAgentCore/releases/latest/download/install.sh | bash

Linux amd64 · Docker · Python 3.9+

api
/v1 · OpenAI Agents API
harness
codex | claude_sdk | mcode
protocol
responses | anthropic | chat_completions
sandbox
docker | microsandbox | e2b
machine
linux | macos | windows
认识 OpenAgentCore
// 01自由组合

Agent、模型、机器,自由组合。

选一个组合,看看对应的 API 调用。

$ harness
$ 模型协议
$ 执行环境
session.py
 1from openai import OpenAI
 2
 3client = OpenAI()  # OPENAI_BASE_URL → your Core
 4
 5session = client.beta.agents.sessions.create(
 6    environment={"type": "openai_hosted"},
 7    input="修复失败的测试,并说明改动。",
 8    extra_body={
 9        "agent": {"model": MODEL, "x_agents_core": {"harness": "codex"}},
10        "x_agents_core": {"model_provider": {
11            "protocol": "responses",
12            "base_url": BASE_URL, "api_key": API_KEY,
13        }},
14    },
15)
✓通过校验 · Session 已创建

支持哪些组合,由每个 Harness 明确声明,而不是猜测。 Harness 能力表 →

// 02每条边界都是协议

一个 API,部件自由替换。

Core 编排,原生 Harness 执行,协议连接各个部件。

上层应用通过 Agents API 接入,Harness、模型服务和计算资源通过各自边界连接。阅读架构文档 →
// 03可管理的执行

Session is all you need.

提交任务,追踪进度,继续对话。

Session 架构演示01 · 原生 Agent
application你的应用OpenAI SDK · Agents API
control plane

OpenAgentCore

Session 与 Turnsession_01

调度 · 取消 · 交互

事件 · 结果 · 持久状态

Sandbox Provider创建与回收计算资源
EnvironmentSession A
Runtime环境准备 · 执行管理
Codex
原生 Agent 循环
contextmodelresulttools
工作目录 · Shell · 工具Docker
EnvironmentSession B
Runtime
Claude Code
E2B
EnvironmentSession C
Runtime
MiniMax Code
Your machine
模型服务Responses API
模型服务Messages API
模型服务Configured API
Runtime 准备环境,原生 Harness 运行模型与工具循环。
原生 Agent统一执行自由组合
Session 生命周期 →
// 04看见运行

运行情况,看得见。

Session 状态 · 计算资源 · 用量

web · overview
Web 控制台概览:服务状态、运行中的 Session、沙箱容量、节点与 Project。

截图数值仅用于展示界面。用量可见性取决于原生 Harness 提供的数据。

一个内核,开放的生态。

Harness 与模型

  • Codex
  • Claude Code
  • MiniMax Code
  • Kimi
  • DeepSeek
  • Qwen
  • GLM
  • Gemini
  • Grok
  • Mistral
  • Meta
  • OpenAI
  • Cohere
  • Doubao

云计算与沙箱

  • AWS
  • Microsoft Azure
  • Google Cloud
  • Alibaba Cloud
  • Tencent Cloud
  • Huawei Cloud
  • Volcengine
  • Baidu AI Cloud
  • DigitalOcean
  • Hetzner
  • Docker
  • E2B
// 05开始使用

从安装到第一个 Session。

Linux amd64 · Docker · Python 3.9+

$ curl -fsSL https://github.com/MiniMax-AI/OpenAgentCore/releases/latest/download/install.sh | bash
  1. 01安装并登录
  2. 02配置模型与计算资源
  3. 03运行第一个 Session

基于 MIT 许可证发布。