GETTING STARTED

pool-anything is an agentic-code-tool-style helper for API keys: it reads your provider list, gathers keys into pools, rotates them, and integrates with your development tools. Available on your machine, behind one local endpoint, with a browser UI.

pool-anything is an AI-powered quota assistant that helps you build features, fix bugs, and automate development tasks. It understands your entire key inventory and can work across multiple providers and tools to get things done.

Get started

pool-anything runs as one server: the web UI, the JSON API, and the proxy. Choose how you run it below to get started. Most setups require a Node.js 22+ subscription or a local checkout. The terminal, Docker, and source builds all support custom providers.

npm i -g pool-anything # one-time install (server core: 0 deps; shell: Ink + React)
pool-anything           # → assistant shell (list pools, add keys…)
pool-anything serve     # → http://localhost:3000, data in ~/.pool-anything/

npm install # dev deps only: tsx, typescript
npm run dev     # http://localhost:3000, reloads as you edit

npm install; npm run dev  # → http://localhost:3000

npm install && npm run dev

curl localhost:3000/health        # → ok
curl localhost:3000/api/db/ping   # → {"ok":true,…}

docker run -p 3000:3000 -v ./data:/app/data pool-anything

PORT=3000 docker compose up

npm run build && npm run start:dist

npm run db:init -- --seed

If you see The token '&&' is not a valid statement separator, you're in PowerShell, not CMD. If you see 'npm' is not recognized as an internal or external command, you're in CMD, not PowerShell. Your prompt shows PS C:\… when you're in PowerShell and C:\… when you're in CMD.

If the install command fails with syntax errors near unexpected token '<', a 403, or another curl error, see Troubleshoot installation to match the error to a fix and for alternative install methods.

36 providers ship preconfigured so pool-anything can use the registry auth style. If a provider is missing, setups do not need a code change: a pool with your own base_url works instead.

You can also install with apt, dnf, or apk equivalents for Node 22 on Debian, Fedora, RHEL, and Alpine.

Then start pool-anything in any project. Replace your-project with the path to a project directory on your machine:

cd your-project
npm run dev

You'll be prompted to add keys on first run. If you've set the LOCAL_DB_PATH environment variable, pool-anything skips the default path and asks you to approve the key instead. That's it! Continue with the Quickstart →

Use pool-anything everywhere

Each surface connects to the same underlying pool engine, so your repo's pools, keys, and usage files, settings, and MCP servers work across all of them.

Beyond the Terminal and UI surfaces above, pool-anything integrates with scripted, chat, and browser workflows:

Next steps

Once you've installed pool-anything, these guides help you go deeper.

• Quickstart: walk through your first real pool, from creating it to sending a proxied call
• Store rotation and usage: give pools persistent cursors with SQLite-backed SUM() rollups
• Proxy and best practices: patterns for getting the most out of header vs query injection
• Provider registry: free self-paced course material, including poolable flags and keyFields
• A cursor for every task: how the pool uses dynamic cursors to orchestrate many keys at once
• Scripts: customize pool-anything for your workflow
• Troubleshooting: solutions for common issues
• pool-anything home: demos, rotation visual, and product details

curl -X POST localhost:3000/api/pools/1/proxy \
  -H 'content-type: application/json' \
  -d '{"path":"/openai/v1/models","method":"GET"}'

npm i -g pool-anything # one-time install
pool-anything           # assistant shell (list pools, add keys to groq, serve)
pool-anything serve     # http://localhost:3000 (--port, --open, --db, --data-dir)

CREATE TABLE pools (id, provider, name, cursor, …);
CREATE TABLE pool_keys (id, pool_id, label, api_key, …);
CREATE TABLE usage (id, pool_id, key_id, tokens, …);

{ "provider": "groq", "name": "groq pool" }

{ "key_id": 2, "label": "key 2", "masked": "gsk_…9f" }

{ "path": "/chat/completions", "method": "POST", "tokens": 24 }

pool-anything/
├── src/server.ts        # UI + JSON API + proxy (:3000)
├── src/pool/            # schema, providers, rotation
├── data/providers.json  # the registry
└── landing/             # this site