llmbroker
Turn a crowd of free, rate-limited LLMs into one reliable model — no premium subscription, no single point of failure. No LangChain, no heavy deps.
pip install llmbroker
llmbroker env freetier > .env # which API keys to get, and where
broker = llmbroker.Broker() # no config file: the curated pool of free models
reply = broker.ask("Explain decorators in one sentence")
print(reply.text) # groq rate-limited? gemini answers instead
Fill in whichever keys are easy — models without keys just stay inactive.
Why another router? LiteLLM or OpenRouter forward your request and hand back the error; llmbroker runs the pool for you: backs off on rate limits and retries with the next model inside the same call, disables dead keys on its own, and learns which models are weak at which tasks. Set it up once, never administer it.
| Automatic failover | broker.ask(...) — next model answers when one is down |
| Chat, tools & agents | broker.chat(messages, tools=...), run_tool_loop(...) |
| Async & streaming | AsyncBroker — same engine for FastAPI / agents / workers, token by token |
| A paid model by name | Broker(direct=["opus"]) — an eternal alias, called past the pool |
| Scale out | Broker("postgresql://…") — sqlite / Postgres / MongoDB, calling code unchanged |
| Self-regulating pool | reply.record_quality(0.3) — weak models sink per task kind; rate later with broker.record_quality(...) |
| Nothing hidden | broker.snapshot(), the call journal, tracing by your own trace_id |
| Pluggable secrets | env vars, DB, AWS, Vault, or your own backend |
| Multi-user mode | per-user API keys on top of one shared pool |
Development
Do not forget to run . ./activate.sh. It needs uv installed.
Use pre-commit hooks for code quality:
pre-commit install
Install invoke preferably with uv tool:
uv tool install invoke
For a list of available scripts run invoke --list; for details on one, invoke <script> --help.
The bundled freetier preset drifts as providers change their free tiers; refresh
it with invoke catalog-refresh, which prints the maintenance runbook
(src/llmbroker/presets/freetier-refresh-prompt.md).
Reports:
Created with cookiecutter using template
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file llmbroker-1.5.2.tar.gz.
File metadata
- Download URL: llmbroker-1.5.2.tar.gz
- Upload date:
- Size: 497.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
161cdfaff67d956caa7d2dc1e227d87106c60912a4101d9df87e3ee140c81133
|
|
| MD5 |
b8dd750ad391e71708bd4fdae82494b8
|
|
| BLAKE2b-256 |
7ae651b3e39657ecefac37e9d51d02a577e9a61a6592b6f66245580fb89544e9
|
File details
Details for the file llmbroker-1.5.2-py3-none-any.whl.
File metadata
- Download URL: llmbroker-1.5.2-py3-none-any.whl
- Upload date:
- Size: 121.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b2a374610efe069548bcc5f6f320268da0a52945a10758d25cd0f4d20dbc8cf4
|
|
| MD5 |
983a3bd5a70382aca6bd8394588b468d
|
|
| BLAKE2b-256 |
0893d6508efe83018e6af4ab4613b24eda9112154eb17d809b134aa16b984c9d
|
