Hermes Codex Pool

What Hermes Codex Pool does

Hermes Codex Pool lets Hermes run on an ordinary Claude Pro or Max subscription instead of a paid API key. The same gateway can hold ChatGPT Plus or Pro and Kimi subscriptions, with any number of accounts for each. The gateway is CLIProxyAPI, an open-source Go project, which sends requests to a free account and rests an account that hit its limit until reset. A morning report in Telegram shows the remaining quota on each account. The README is written in Russian.

This repository is the wrapper around that gateway: a config template (loopback only, panel and plugins disabled, round-robin with session affinity), a service, a watchdog, a token backup, quota report scripts for Codex and Claude, and a SKILL.md that a Hermes agent follows to install everything itself. The agent builds the gateway from source in about 3 to 10 minutes, guides you through each sign-in, adds a provider named pool at http://127.0.0.1:8317/v1 and verifies it with a real request. The repository name is historical, since it began as a Codex account pool.

Key features

• Claude, ChatGPT and Kimi subscriptions behind one local gateway
• Round-robin rotation with session affinity across accounts
• Cooldown for accounts that reach their limit
• Morning Telegram report of remaining quota per account
• Watchdog service and token backup
• SKILL.md that lets a Hermes agent install and configure the gateway

When to use it

• Running Hermes on a Claude subscription without a paid API key
• Spreading requests over several accounts of the same service
• Tracking how much quota is left on each account

Who it is for: Hermes Agent users on Linux who hold Claude, ChatGPT or Kimi subscriptions and read Russian.

How it fits with Hermes Agent

Hermes connects to the gateway through a provider named pool, and the whole setup is packaged as a Hermes skill that the agent executes.

Requirements: A Linux server or computer already running Hermes Agent, Python 3, git, curl, and at least one Claude Pro/Max, ChatGPT Plus/Pro or Kimi subscription

Note: It requires at least one paid Claude, ChatGPT or Kimi subscription, and the README warns that routing subscriptions through a third-party gateway may violate Anthropic and OpenAI rules and can get accounts restricted.

FAQ