# freellmpool

> Free, open-source, OpenAI-compatible gateway that pools the free tiers of 18 LLM
> providers (Groq, Cerebras, NVIDIA, Gemini, OpenRouter, Cloudflare, Mistral, Cohere
> and more) behind one endpoint, with automatic failover and per-day quota tracking.
> Works as a CLI, a Python library, a local proxy, and an MCP server. Keyless to
> start (`pip install freellmpool`); the proxy speaks the OpenAI and Anthropic APIs,
> so Codex, Claude Code, and aider run on pooled free models unchanged. MIT licensed.
> Capacity tools (`freellmpool capacity status`, `providers health`, `keys add`) show which
> free tiers are usable right now and help configure more.

## Docs
- [README](https://github.com/0xzr/freellmpool/blob/main/README.md): install, CLI, library, proxy, MCP, provider keys, routing.
- [Landing page / FAQ](https://0xzr.github.io/freellmpool/): what it is, how it compares, frequently asked questions.
- [Capacity & provider health](https://github.com/0xzr/freellmpool/blob/main/docs/CAPACITY.md): capacity status, health checks, key inventory, external catalog. Guide: https://0xzr.github.io/freellmpool/capacity-management.html
- [CHANGELOG](https://github.com/0xzr/freellmpool/blob/main/CHANGELOG.md): release history.
- [Integrations](https://github.com/0xzr/freellmpool/blob/main/docs/INTEGRATIONS.md): opencode, aider, Continue, Cline, Cursor, Open WebUI, LangChain, LlamaIndex, and more.
- [Run OpenCode on free models](https://0xzr.github.io/freellmpool/run-opencode-on-free-models.html): OpenCode setup with an embedded TUI dashboard, quality routing (auto/fast/quality/fair), and usage tools.
- [MCP server](https://github.com/0xzr/freellmpool/blob/main/docs/MCP.md): use free models from Claude Desktop/Code/Cursor.

## Install
- PyPI: `pip install freellmpool` (https://pypi.org/project/freellmpool/)
