What it is
underclass is a local, OpenAI-compatible proxy designed to pool multiple subscriptions, such as ChatGPT/Codex and GitHub Copilot, behind a single endpoint. It manages these subscriptions by pinning sessions to specific accounts, cooling down quota-exhausted subscriptions until their usage window resets, and ensuring that the proxy behaves like one well-provisioned provider to the client.
How it works
The proxy pools various subscriptions into a single endpoint, allowing clients to interact with it using a standard OpenAI-compatible interface. Sessions are sticky, meaning requests carrying a prompt_cache_key are always routed to the same subscription, which keeps upstream prompt caches warm.
When an account exhausts its quota, it enters a cooling state until its window resets. If all eligible accounts are cooling, the proxy fails fast by returning the earliest Retry-After time instead of queuing requests. This mechanism ensures that the proxy avoids hanging when all resources are exhausted.
TWSC experience
Not yet tested by TWSC.
Related
Sources
The Web Scraping Wiki is compiled from the tests and research published on The Web Scraping Club, the newsletter for web scraping professionals. Subscribe to get the next article in your inbox.