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. The Core key and Project API key grant access to your installation, so store them in a secrets manager and do not commit them to code.
Who it is forA developer who wants to call a coding agent from an application and keep the runtime on their own infrastructure.
The problemHosted agent APIs may not fit where code, models or data must stay under your control.
The outcomeA self-hosted Core installation that returns a Session ID from an OpenAI SDK call, with the agent able to create files in /workspace.
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
- 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)
- Run the Python quickstart from the README, which calls client.beta.agents.sessions.create with harness set to codex, and print session.id.
Prompt for your agent
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.
Caveat. The README says the install needs Docker and that you must add sandbox capacity (a node or E2B) before Sessions can run.
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