v0.3.0a7 / mit
5 providers · 1 endpoint

Free.
AI for everyone.

A local gateway that orchestrates free-tier inference across five providers. When one rate-limits, the next takes over. Your agent never knows.

install · macos / linux
$ curl -sSL https://api.free-ride.xyz/install.sh | sh
scroll↓
OpenRouter/Groq/NVIDIA NIM/Cloudflare Workers AI/HuggingFace/OpenAI-compatible/BYO keys/local-first/MIT/
01failover

Hits a rate limit.
Fails over.

Per request, FreeRide walks (provider, key) pairs. A 429 cools the key for 120 seconds. A model-not-found skips the provider. The 200 ships.
RATE_LIMIT
next key
AUTH
next key
MODEL_NOT_FOUND
next provider
QUOTA_EXHAUSTED
next provider
5xx / TIMEOUT
next pair
200 OK
ship + stamp header
live trace
tail -f /var/log/freeride
02providers

Five free tiers.
One endpoint.

01
OpenRouter
chat / streaming / tools / vision
free models tier
02
Groq
Llama 3.x · Gemma 2 · Mixtral · DeepSeek-R1
daily token cap
03
NVIDIA NIM
curated allowlist
credits per account
04
Cloudflare Workers AI
cheap-per-neuron chat models
10K Neurons / day
05
HuggingFace
router catalog · :fastest / :cheapest pin
$0.10/mo Free · $2/mo PRO
Bring your own keys for whichever you've signed up for. FreeRide doesn't issue any. One is enough to get started; more = better failover.
03agents

Bind any agent.
One command.

FreeRide writes the gateway URL into your agent's config — atomically, preserving unrelated keys. Aider, Continue, Hermes, OpenClaw all work without further setup.
bind~/.config/<agent>
$ freeride bind aider
$ freeride bind continue
$ freeride bind hermes
$ freeride bind openclaw
or anything else: OPENAI_API_BASE=http://localhost:11343/v1
04principles
01

Local-first

The gateway runs on your machine. Prompts and completions never touch a FreeRide server. We can't see your data because we never receive it.

02

BYO keys

FreeRide doesn't issue API keys. You sign up for the providers you want; FreeRide just orchestrates between them.

03

Free-only

No paid fallback. No upsell. If every provider is exhausted, the request fails. Better than a surprise bill at month's end.

/v1/chat/completions//v1/models//health/X-FreeRide-Provider/uv tool install freeride-gateway/localhost:11343/

One curl.
That's it.

install
$ curl -sSL https://api.free-ride.xyz/install.sh | sh