Authorization notice. Freellmapi is dual-use. Only use it on software, sites and systems you own or have explicit permission to test.
Account pooling. Spreading traffic across several free-tier keys and providers may conflict with each provider's terms, so check those terms before relying on it.
Remote script. The one-line installer pipes a remote script into bash, so read the script first, as the README suggests.
Who it is forA developer building a prototype or side project who already uses the OpenAI SDK and wants to avoid paying for tokens while experimenting.
The problemEach free provider has its own SDK, rate limits, and failure modes, so stacking them by hand means many integrations and manual retries.
The outcomeThe app sends normal OpenAI-style requests to one local endpoint, and the router picks a model and falls over to another provider when one is rate-limited.
What you need first
- Node 20 or newer, or Docker for the one-liner install
- API keys from one or more free-tier providers (for example Google, Groq, Cerebras, Mistral, OpenRouter)
- A machine that can run the router on localhost:3001
Steps
- Run
curl -fsSL https://freellmapi.co/install.sh | bash(Docker required) or follow the local setup in docs/en/install/01-install.md. - Open http://localhost:3001, add your provider keys on the Keys page, and reorder the Fallback Chain if you want a preference.
- Copy the unified API key from the Keys page header.
- Set your OpenAI client base URL to http://localhost:3001/v1 and use the unified key as the API key.
- Send a chat request from your app and confirm a normal completion comes back.
Prompt for your agent
In the freellmapi repo (tashfeenahmed/freellmapi), start the router locally and set the OpenAI SDK base URL in <project-path> to http://localhost:3001/v1 with the unified key from the Keys page. Expected output: a successful chat completion from the app. Verify that the response includes a model name and that the router dashboard shows one request logged.
Caveat. The README describes the project as for personal experimentation only, so do not treat it as production infrastructure.
Get 5 new use cases every morning. Free, one short email, unsubscribe anytime.
Get them freeShare: X LinkedIn Hacker News Email Copy link
Disclaimer
Deduped lists open-source repositories that belong to other people. We do not own, maintain, audit, or vouch for any of them, and a repo appearing here is not an endorsement or a safety check. The use cases, steps, and prompts are written by AI and may be incomplete, outdated, or just wrong. Where a use case is marked "Seen in the wild", we link to public posts where someone described something similar, but we have not verified those posts and the use case itself is still our AI's own write-up. Use all of this at your own risk. Only run code, commands, or agents on systems and accounts you are authorized to use, and read the code and every command before you run it, especially anything that touches credentials, files, or the network. Nothing here is professional, security, legal, or financial advice. All trademarks and project names belong to their respective owners, and their use here does not imply affiliation. Content is provided as is, without warranties of any kind. Found a mistake, a safety problem, or something you want removed? Email [email protected] and we will look at it promptly. Full disclaimer page