Authorization notice. Open Agent Core is dual-use. Only use it on software, sites and systems you own or have explicit permission to test.
Credentials. Keeping the Project API key in environment variables means anyone with access to that environment can start Sessions on your Core.
Who it is forAn engineer with an application already built on the OpenAI SDK who needs to move the backend to infrastructure they control.
The problemRewriting an app for a new API costs time, and the app may need to keep its current SDK calls.
The outcomeThe same SDK code sends agent Sessions to your Core installation, with no change to the request shape.
What you need first
- Docker installed on Linux, macOS or Windows (the installer requires it)
- A machine where you can run the Core, Web and PostgreSQL installer
- A model provider you can configure in Web
- Python with the official OpenAI SDK for the example call
Steps
- Install Core and Web with
curl -fsSL https://openagentcore.dev/install.sh | bashon Linux or macOS, or the PowerShell command from the README on Windows. - In Web, configure the public address, set a default model and issue a Project API key.
- Set OPENAI_BASE_URL to https://core.example/v1 (your own API base URL) and OPENAI_API_KEY to the Project API key in the app's environment. (inferred, check the README)
- Add the extra_body agent setting with x_agents_core and harness from the README to choose the harness per Session.
- Run the app's existing test or a single request and check the returned Session ID.
Prompt for your agent
In the MiniMax-AI/OpenAgentCore repo, follow the README Quickstart to point an existing OpenAI SDK app at a Core installation at <API base URL>. Change only OPENAI_BASE_URL and OPENAI_API_KEY, then run <app test command> and confirm the request returns a Session ID from the self-hosted endpoint.
Caveat. The README says the Agents API uses the same protocol as OpenAI's Agents API, but it does not list every endpoint, so test the exact calls your app makes.
Get 5 new use cases every morning. Free, one short email, unsubscribe anytime.
Get them freeShare: X LinkedIn Hacker News Email Copy link
Disclaimer
Deduped lists open-source repositories that belong to other people. We do not own, maintain, audit, or vouch for any of them, and a repo appearing here is not an endorsement or a safety check. The use cases, steps, and prompts are written by AI and may be incomplete, outdated, or just wrong. Where a use case is marked "Seen in the wild", we link to public posts where someone described something similar, but we have not verified those posts and the use case itself is still our AI's own write-up. Use all of this at your own risk. Only run code, commands, or agents on systems and accounts you are authorized to use, and read the code and every command before you run it, especially anything that touches credentials, files, or the network. Nothing here is professional, security, legal, or financial advice. All trademarks and project names belong to their respective owners, and their use here does not imply affiliation. Content is provided as is, without warranties of any kind. Found a mistake, a safety problem, or something you want removed? Email [email protected] and we will look at it promptly. Full disclaimer page