Codex Pooler

Codex Pooler

The full featured self-hosted Codex gateway, for teams, agents and you. Works with:

English · 简体中文 · Español · 日本語

Website · Docs · Quick start · Harness · Configuration · Deployment · X · Reddit

  Upstreams
</td>
<td align="center" valign="top" width="33%">
  
    
  
  Pools
</td>
<td align="center" valign="top" width="33%">
  
    
  
  Request logs
</td>

Codex Pooler is a self-hosted gateway for running Codex-compatible agents, tools, and automation through stable Pool API keys. It works with one upstream Codex account for credential isolation, client normalization, metadata-only operations, and saved reset visibility; add more accounts when you want shared capacity and routing across eligible accounts.

Clients send familiar Codex backend or OpenAI-compatible requests; Codex Pooler selects an eligible account based on model support, quota evidence, limits, session continuity, routing policy, and health. The Pool key stays stable while upstream assignments, lifecycle state, reset policy, and capacity change behind it.

Operators get one place to manage Pools, accounts, API keys, saved resets, routing, request accounting, audit logs, and health without storing prompts, files, audio, images, bearer tokens, or raw Codex secrets. Instance owners keep the global administration surface, while instance admins work only with their assigned Pools.

Highlights

• 🧩 Use the tools you already know: connect Codex, OpenCode and other supported coding agents, plus apps built with OpenAI-compatible SDKs
• 🔑 One key for your apps: connect tools with a Pool API key that stays the same when you add or replace Codex accounts, without sharing account credentials
• ⚡ High cache reuse across protocols: over 95% cached input observed on HTTP/SSE and WebSockets, backed by cache-aware routing and connection reuse
• 🎯 Automatic account selection: send requests to accounts that can serve the chosen model, with available quota and account health taken into account
• 📏 Control how much each key can use: set request limits and daily or weekly AI usage allowances
• 🚀 Give agents more room to work: let them use several tools at once in Full mode, with Lite compatibility when needed
• 🖼️ Images and voice, too: generate and edit images or transcribe audio through supported apps, using the same Pool API key
• 🛡️ Keep conversation content private: track usage and troubleshoot requests without saving prompts, replies, uploaded files, images or audio
• 🔁 Keep conversations together: keep supported sessions linked to the right account when a client reconnects
• 🔭 Let users track their own usage: enable a personal Observatory dashboard for each key, showing activity, response times and estimated costs
• 🏦 Put saved resets to use: see available reset credits and use them to restore account quota, manually or automatically when enabled
• 🖥️ Manage everything in one place: add accounts, manage keys and invites, check usage and change settings from a browser
• 👥 Organize teams and projects: group accounts into Pools with their own access rules and model choices
• 🤝 **Connect acco