FreeRouter
Completely free ($0 cost) routing across free LLM models and providers. Like OpenRouter, but for free models.
FreeRouter routes LLM requests across 13 free model providers - all at $0 cost - with automatic failover, per-key health isolation, and OpenAI-compatible HTTP endpoints.
@freerouter/sdk
TypeScript SDK - BYOK routing layer compatible with Vercel AI SDK v7. ~87 free models across 13 providers.
@freerouter/api
HTTP API Server - OpenAI-compatible REST endpoints wrapping the SDK. Bring your own free provider keys.
@freerouter/gateway
Self-hosted gateway - OpenAI-compatible proxy with encrypted key storage, gateway-key auth, a dashboard, and analytics.
Packages
| Package | Description |
|---|---|
@freerouter/sdk | Core SDK - model registry, alias resolution, health tracking, failover LanguageModelV4 wrapper |
@freerouter/api | HTTP API - Hono server exposing OpenAI-compatible /v1/chat/completions, /v1/models, /health |
@freerouter/gateway | Self-hosted gateway - SDK + encrypted key storage + dashboard + analytics + gateway-key auth (run via npx @freerouter/gateway serve) |
@freerouter/db | Database-backed health stores (coming soon) |
Quick Links
- SDK Installation - Install, quickstart, first request
- SDK Usage Guide - Streaming, structured output, multi-user
- SDK Core Concepts - Aliases, resolution, provider priority
- SDK API Reference -
createFreeRouter(),languageModel(), types - SDK Providers - All 13 providers with 87+ model tables
- API Installation - Clone, run, first request
- API Usage Guide - OpenAI SDK, Vercel AI SDK, streaming
- API Routes - Full request/response schemas
- API Reference - Auth, errors, deployment
- Gateway Overview - Self-hosted gateway with dashboard & analytics
- Gateway Getting Started - Install, run, first request
- Gateway Configuration - Data dir, CORS, encryption
- Gateway Provider Keys - Connect free provider keys
- Gateway Keys - Issue & use client keys
- Gateway API Reference - Every route
Source
- GitHub: github.com/r2hu1/freerouter