Skip to content

Meet OpenAgentCore

The OpenAI Agents API, open source and self-hosted. Run Codex, Claude Code or MiniMax Code on your own machines with your own models, through the official OpenAI SDK.

$ curl -fsSL https://openagentcore.dev/install.sh | bash
Harness
Model protocol
Environment
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="Fix the failing test and explain the change.",
 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)
✓accepted · Session created

Each Harness declares the protocols it speaks; Core rejects other combinations before it creates the Session. Harness capabilities →

One API. Replaceable parts.

Applications call Core through the Agents API; native Harnesses run inside sandboxes and call models directly. Separate adapters manage compute and persistent workspace storage.Applications call Core through the Agents API; native Harnesses run inside sandboxes and call models directly. Separate adapters manage compute and persistent workspace storage.
Architecture →

One Session, from request to result.

applicationYour applicationOpenAI SDK · Agents API
control plane

OpenAgentCore

Sessions & Turnssession_01

Schedule · cancel · interact

Events · results · durable state

Sandbox ProviderProvision & reclaim compute
EnvironmentSession A
RuntimePrepare · execute · report
Codex
Native agent loop
contextmodelresulttools
Mounted workspace · shell · toolsmicrosandbox
EnvironmentSession B
Runtime
Claude Code
microsandbox
EnvironmentSession C
Runtime
MiniMax Code
Your machine
Model providerResponses API
Model providerMessages API
Model providerConfigured API
Runtime prepares the environment. The native Harness owns the model and tool loop.
Native agentManaged executionMany combinations
A Session, end to end →

Run it from one console.

Web console overview: service status, running Sessions, sandbox capacity, fleet and Projects.

An open ecosystem.

  • 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
  • E2B

Released under the MIT License. © 2026 MiniMax-AI