icoretech/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
Reddit
Upstreams
Pools
Request logs
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 accounts by invitation: let account owners join a Pool through
a guided browser flow, without sending you credential files
🚨 Know when attention is needed: receive alerts about low capacity,
account problems and reset events in the dashboard, by email or through webhooks
🔎 Spot model downgrades: see when the provider