Installation

Routeplane runs as a local proxy — a single binary on your machine, Apache-2.0 licensed, with your own provider keys. No cloud dependency, no vendor lock-in.

Private preview

The source repository is private while I build, and there’s no public download right now. To run Routeplane, request access: leave your email and I’ll read it personally. Signups are the signal I use to decide when — and to whom — the code opens up.

Once you have the binary

Set your provider keys in the environment and start the proxy:

export OPENAI_API_KEY=sk-...    # ANTHROPIC_API_KEY / GOOGLE_API_KEY also work
routeplane start
# Proxy running at http://127.0.0.1:4356

Routeplane auto-detects any key set in the environment — no config file needed. Any provider whose key is present is immediately available. See BYOK for the full list of recognized variables, or local & private models to point Routeplane at Ollama, vLLM, or LM Studio for free.

For advanced routing rules, guardrails, or multi-account failover, scaffold a config file:

routeplane init          # writes ./routeplane.yaml (override with `-c <path>`)
routeplane start

Point your agent at the proxy

However you start it, Routeplane is a drop-in proxy. Point your agent runtime at the proxy base URL — http://127.0.0.1:4356 — and model calls route through Routeplane. OpenAI-compatible harnesses usually need only the base URL; some native harnesses take extra wiring, covered in the integration guides.