What do you want to do?
3 use cases
-
Run a coding agent Session through the OpenAI SDK
Install Core and Web, then start a Codex Session from Python using the OpenAI SDK.
- Open Agent Core
- Software and DevOps
- Intermediate
View prompt
Using the MiniMax-AI/OpenAgentCore repo, install Core and Web on <target machine> and configure a default model and Project API key. Then run the README Python quickstart with OPENAI_BASE_URL set to <API base URL> and confirm it prints a Session ID. Verify that the Session finishes and that /workspace/hello.txt exists in the Session output.
-
Point an existing OpenAI SDK app at self-hosted Core
Change the base URL and key so an OpenAI SDK app runs agent Sessions on your own Core.
- Open Agent Core
- Software and DevOps
- Intermediate
View prompt
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.
-
Run agent Sessions on your own Linux, macOS or Windows machine
Add a personal machine as sandbox capacity so Sessions run on hardware you own.
- Open Agent Core
- Software and DevOps
- Advanced
View prompt
Using the MiniMax-AI/OpenAgentCore repo, set up Core and Web on <target machine>, add that machine as sandbox capacity in Web, and start one Session that writes a file to /workspace. Report the Session ID and confirm the file exists on the machine after the Session completes.
How to use Open Agent Core
- Check you have what it needs: 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.
- Open MiniMax-AI/OpenAgentCore on GitHub and read the README and license.
- Run
curl -fsSL https://openagentcore.dev/install.sh | bashon Linux or macOS, orirm https://github.com/MiniMax-AI/OpenAgentCore/releases/latest/download/install.ps1 | iexin PowerShell on Windows. - Open Web, sign in with the Core key the installer prints, set the public address and a default model.
- In Web, issue a Project API key and add sandbox capacity (a node or E2B).
- Export the variables: set OPENAI_BASE_URL to your API base URL (for example https://core.example/v1) and OPENAI_API_KEY to the Project API key. (inferred, check the README)
These steps come from our top use case, Run a coding agent Session through the OpenAI SDK, which also has a copy-paste agent prompt.
Get 5 new use cases every morning. Free, one short email, unsubscribe anytime.
Get them freeOpen Agent Core alternatives · Best AI repos for Software and DevOps
About this repo
- Who it is forDevelopers and platform operators who want an OpenAI-compatible agent backend running on their own machines and models.
- Why it is hot
- LanguageGo
- Sourcegithub.com/MiniMax-AI/OpenAgentCore · Back to Hot repos
Requirements
- 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
Maintain Open Agent Core? Add the Featured on Deduped badge
Paste this into your README:
[](https://dedupedai.com/use-cases/minimax-ai-openagentcore/?ref=badge)
Questions about Open Agent Core
What is Open Agent Core?
OpenAgentCore is a self-hosted, open source Agents API that runs Codex, Claude Code or MiniMax Code inside sandboxes, using the official OpenAI SDK. It is an open-source project on GitHub: https://github.com/MiniMax-AI/OpenAgentCore.
Who is Open Agent Core for?
Developers and platform operators who want an OpenAI-compatible agent backend running on their own machines and models.
What can I do with Open Agent Core?
3 use cases so far, for example: Run a coding agent Session through the OpenAI SDK; Point an existing OpenAI SDK app at self-hosted Core; Run agent Sessions on your own Linux, macOS or Windows machine. Each has steps and a copy-paste agent prompt.
What do I need to run Open Agent Core?
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.
What are alternatives to Open Agent Core?
Other hot AI repos in Software and DevOps: Harness2, iFixAi, Orca, Diagram Design, AI Memory.
Is Open Agent Core safe to run?
Deduped does not own, audit or vouch for it. Read the README and license, run it on your own systems first and review every command before you run it.