Freeway: self-hosted OpenAI-compatible gateway for free-tier providers
One endpoint in front of every free LLM tier, with automatic failover and no provider key ever leaving the box. Providers are data, not code: adding one is a JSON file plus an env var, never a TypeScript change. Ships 12 providers pre-written; `verify-provider --apply` derives the live model list from your own key. - core: registry, bucketed quota meter (rolling + UTC-calendar windows), key-pool store, 6-step model router with diagnostic rejection reasons - gateway: node:http, failover that commits to a stream only after 200 headers, SSE passthrough with usage sniffing, virtual keys with admin/inference roles - context engine: sqlite sessions and a 5-rung refit ladder, so a 128k thread keeps working when it fails over to an 8k model - cache: exact (sha256, safe-by-default) + opt-in semantic (flat Float32Array) - guard: inbound limits, quota forecasting, limit calibration from upstream headers, key health, secret/PII/injection scanning - dashboard: one self-contained HTML file, live SSE request log, token usage - sdk: zero-dep typed client, drop-in for the OpenAI SDK Zero runtime dependencies. 326 tests, 27-check smoke suite against a scripted mock upstream so routing is testable without spending quota. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
commit
cb985dcf9c
86 files changed
+16350
No files matched your search
@@ -0,0 +1,19 @@
|
||||
{
|
||||
"$schema": "./_schema.json",
|
||||
"id": "cerebras",
|
||||
"label": "Cerebras",
|
||||
"docs": "https://inference-docs.cerebras.ai/",
|
||||
"console": "https://cloud.cerebras.ai/platform",
|
||||
"priority": 15,
|
||||
"baseUrl": "https://api.cerebras.ai/v1",
|
||||
"auth": { "type": "bearer", "envKeys": ["CEREBRAS_API_KEY"] },
|
||||
"limits": { "rpm": 30, "rpd": 14400, "tpm": 60000, "tpd": 1000000 },
|
||||
"limitsSource": "docs",
|
||||
"verifiedOn": "2026-08-16",
|
||||
"modelsEndpoint": "/models",
|
||||
"modelsPath": "data[].id",
|
||||
"notes": "Largest daily token budget of the free tiers (~1M tokens/day), no card required. Cerebras reports windowed rate-limit headers (x-ratelimit-limit-tokens-day and friends), so calibration gets exact per-key numbers after the first request.",
|
||||
"models": [
|
||||
{ "id": "llama-3.3-70b", "label": "Llama 3.3 70B", "alias": ["fast", "big"], "context": 65536, "caps": ["chat", "tools", "json"], "priority": 10 }
|
||||
]
|
||||
}
|
||||
Reference in new issue
Block a user