{
 "schema_version": 1,
 "generated": "2026-10-20",
 "id": "minimax-ai-openagentcore--point-existing-openai-app-at-self-hosted-core",
 "repo": "MiniMax-AI/OpenAgentCore",
 "repo_url": "https://github.com/MiniMax-AI/OpenAgentCore",
 "repo_slug": "minimax-ai-openagentcore",
 "title": "Point an existing OpenAI SDK app at self-hosted Core",
 "page_title": "How to point an existing OpenAI SDK app at self-hosted Core with Open Agent Core",
 "summary": "Change the base URL and key so an OpenAI SDK app runs agent Sessions on your own Core.",
 "who": "An engineer with an application already built on the OpenAI SDK who needs to move the backend to infrastructure they control.",
 "problem": "Rewriting an app for a new API costs time, and the app may need to keep its current SDK calls.",
 "outcome": "The same SDK code sends agent Sessions to your Core installation, with no change to the request shape.",
 "steps": [
  "Install Core and Web with `curl -fsSL https://openagentcore.dev/install.sh | bash` on 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."
 ],
 "agent_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.",
 "agents": [
  "any"
 ],
 "difficulty": "Intermediate",
 "time": "60 minutes",
 "basis": "readme",
 "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.",
 "category": "Software and DevOps",
 "tags": [
  "Software and DevOps"
 ],
 "lang": "go",
 "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"
 ],
 "risk": "dual-use",
 "seen_in_the_wild": false,
 "mentioned_publicly": false,
 "risks": [
  {
   "tag": "credentials",
   "notice": "Keeping the Project API key in environment variables means anyone with access to that environment can start Sessions on your Core."
  }
 ],
 "best": false,
 "score": 0.9,
 "evidence": [],
 "url": "https://dedupedai.com/use-cases/minimax-ai-openagentcore/point-existing-openai-app-at-self-hosted-core/",
 "md": "https://dedupedai.com/use-cases/minimax-ai-openagentcore/point-existing-openai-app-at-self-hosted-core/index.md",
 "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 hello@dedupedai.com and we will look at it promptly.",
 "api": "https://dedupedai.com/api/v1/usecases/minimax-ai-openagentcore--point-existing-openai-app-at-self-hosted-core.json",
 "api_version": "v1"
}