OpenAgentCore README

The project's README from github.com/MiniMax-AI/OpenAgentCore. As one markdown file: README.md.

OpenAgentCore — One core. Many agents.

OpenAgentCore

An open-source, self-hosted implementation of the OpenAI Agents API with multiple native harnesses.

Website · Install · Call the API · Documentation · Contributing

English · 简体中文

What it is

OpenAgentCore runs AI agents on your own infrastructure behind the OpenAI Agents API.

How it fits together

OpenAgentCore architecture

Applications and operators use these Core APIs:

API Path Used by
Agents API /v1 Your applications. Same protocol as OpenAI's Agents API
Core API /core/v1 Operators, through Web

Core keeps durable execution state. The Runtime runs the chosen harness inside the Environment. Each connection is a defined protocol, so any part can be replaced on its own. See the architecture guide.

Screenshots

Overview Agent metrics
Deployment overview Agent metrics

Install

On Linux or macOS with Docker configured:

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

Windows PowerShell:

irm https://github.com/MiniMax-AI/OpenAgentCore/releases/latest/download/install.ps1 | iex

Then:

  1. Sign in to Web, the admin console, with the Core key the installer created, and configure the domain and HTTPS.
  2. Set a default model and issue a Project API key.
  3. Add execution capacity: a node, E2B, or your own machine.
  4. Run your first Session with the OpenAI SDK.

The installation guide covers each step, HTTPS and a quick local trial. Listen addresses, ports and other options: installation options.

Documentation

I want to Start with
Install and operate an installation Installation, then operations
Build an application on the API Quickstart, then the Agents API guide
See a complete application Examples
Run agents on my own machine Self-hosted execution
Check Harness capabilities and limits Harness capabilities
Understand the design Architecture
Add a sandbox, harness or other component Developer guide

All pages: documentation index. Before changing code, read the contributor rules.

OpenAgentCore (MiniMax-AI/OpenAgentCore)

Searching Database…

Что это?OpenAgentCore — это open-source реализация OpenAI Agents API для самостоятельного хостинга, позволяющая запускать AI-агентов на собственной инфраструктуре с использованием подключаемых нативных harness-сред вроде Codex, Claude Code или MiniMax Code.
Это библиотека, которую я импортирую, или сервер, который я запускаю?Это бэкенд-сервис для самостоятельного хостинга, состоящий из компонентов Core и Runtime; ваши приложения общаются с ним по тому же протоколу Agents API, что и OpenAI, или по обычному HTTP, а не импортируя библиотеку.
Как его запустить?На Linux или macOS запустите установщик с настроенным Docker или используйте установщик PowerShell для Windows; затем войдите в Web, админ-консоль, со сгенерированным ключом Core, настройте домен/HTTPS, задайте модель по умолчанию и выпустите Project API-ключ.
Нужен ли Docker для его установки?На Linux или macOS Docker должен быть уже настроен до запуска установщика; Windows вместо этого использует отдельный установщик PowerShell.
Нужно ли самому предоставлять провайдера модели и вычислительную мощность?Да — после установки всё ещё нужно задать модель по умолчанию и добавить вычислительную мощность, например node, E2B или свою машину, прежде чем вы сможете запустить первую сессию.
На кого это рассчитано?Для команд, которые хотят сами хостить и обслуживать AI-агентов для кодинга вместо зависимости от хостингового Agents API от OpenAI, используя собственных провайдеров моделей и свою инфраструктуру.
Где агенты реально выполняются?Агенты выполняются внутри управляемой песочницы (Docker, microsandbox или E2B) или напрямую на вашей собственной машине с Linux, macOS или Windows — в зависимости от того, как вы настроите вычислительную мощность.
Каких кодинг-агентов он поддерживает?Каждая Session запускает одну из трёх нативных harness-сред — Codex, Claude Code или MiniMax Code — в паре с любым настроенным вами провайдером модели.
Можно ли заменять части системы?Да, песочницы, harness-среды и провайдеры моделей подключаются через определённые протоколы, так что любой компонент можно заменить независимо.
Как отслеживаются долгоживущие сессии?Core хранит долговременное состояние выполнения, пока Runtime запускает выбранную harness-среду внутри Environment, так что сессии могут переживать перезапуски и переподключения.
Есть ли админ-интерфейс?Да, 'Web' — это админ-консоль оператора, используемая для входа с ключом Core, настройки домена/HTTPS и управления моделями и API-ключами.
Creator
MiniMax-AI
Size
33.6 MB
Stars
233
Age
26d
Commits · 90 Days