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.
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/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
Source
- GitHub: github.com/r2hu1/freerouter