selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

OpenAgentCore logo

Self-host OpenAgentCore

v0.0.13

Open-source OpenAI Agents API for self-hosted AI agents

BetaOpen SourceMIT
Updated9 hours ago
LanguageGo
Setup difficultyAdvanced
Stars
302
Ports
8080 (Web console and API gateway), 8091 (Core internal API (container-internal))
Requires
Docker Compose, Docker Engine, PostgreSQL
Web console overview showing service status, running sessions, sandbox capacity, fleet and projectsConnect a host dialog in Web console showing the installation command for self-hosted sessions

What is OpenAgentCore?

OpenAgentCore is an open-source, self-hosted implementation of the OpenAI Agents API. It allows developers to run AI coding agents — Codex, Claude Code, and MiniMax Code — on their own infrastructure with any compatible model provider, using the standard OpenAI SDK by simply setting OPENAI_BASE_URL. The system consists of a Core control plane (with PostgreSQL persistence), a Web console for administration, and a Runtime that executes agent sessions inside sandboxed environments. It supports multiple sandbox providers including microsandbox (with checkpoint/resume), E2B, Docker, and self-hosted sessions on bare metal or VMs. Workspaces persist independently of compute. The project is MIT-licensed and developed by MiniMax-AI. It is currently in pre-1.0 development (v0.0.12 stable, v0.0.13-rc.2 pre-release) with active development.

Should you self-host OpenAgentCore?

OpenAgentCore scores 46/100 on selfhost.directory (how scoring works) and ranks #132 of 209 in AI Agents. It has 302 GitHub stars.

It shipped 6 stable releases in the past year. The latest, v0.0.13, came out on 25 October 2026. New versions land roughly every 5 days.

Setup is advanced: plan for several services and some ongoing maintenance. It is MIT-licensed and written mostly in Go.

Its closest alternative on selfhost.directory is Orca (91/100, 108 642 stars). It scores higher overall, so compare the two before you pick. See OpenAgentCore vs Orca side by side.

Features

  • Checkpoint and resumeRequires microsandbox provider
  • Cross-platform native installersWindows does not support MiniMax Code harness
  • Model provider flexibility
  • Replaceable sandbox providers
  • Self-hosted sessions
  • Web administration console

OpenAgentCore README

How to configure OpenAgentCore

  • OAC_DEFAULT_HARNESSCodexDefault harness for Core-hosted sessions (Codex, Claude Code, or MiniMax Code)

    Default harness for Core-hosted sessions (Codex, Claude Code, or MiniMax Code)

    values: codex, claude, minimax

  • OAC_DEV_HOME~/.oacDevelopment build output directory

    Development build output directory

  • OAC_INSTALL_GRANTShort-lived installation grant passed via environment variable to claim a machine's credential

    Short-lived installation grant passed via environment variable to claim a machine's credential

  • OAC_RUNTIME_HOME~/.oacAbsolute directory for the Runtime home (components, installations, capability snapshots)

    Absolute directory for the Runtime home (components, installations, capability snapshots)

  • OAC_TEST_DATABASE_URLPostgreSQL test database URL for CI

    PostgreSQL test database URL for CI

  • OAC_TEST_OFFICIAL_SDK_PYTHONPython interpreter for official SDK tests

    Python interpreter for official SDK tests

  • OAC_WRITE_AUDIT_RETENTIONRetention period for write audit history

    Retention period for write audit history

  • OPENAI_API_KEYProject API key issued from the Web console

    Project API key issued from the Web console

  • OPENAI_BASE_URLAPI base URL pointing to your OpenAgentCore installation (e.g., https://core.example/v1)

    API base URL pointing to your OpenAgentCore installation (e.g., https://core.example/v1)

OpenAgentCore releases & version history

More in Self-hosting

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…