OmniRoute Dashboard # ๐Ÿš€ OmniRoute โ€” De gratis AI-gateway ### Stop nooit met coderen. Slimme routering naar **GRATIS en voordelige AI-modellen** met automatische terugval. _Uw universele API-proxy: รฉรฉn eindpunt, meer dan 36 providers, geen downtime._ **Chatvoltooiingen โ€ข Insluitingen โ€ข Afbeelding genereren โ€ข Audio โ€ข Herrangschikking โ€ข 100% TypeScript** --- ### ๐Ÿค– Gratis AI-provider voor uw favoriete codeeragenten _Verbind elke AI-aangedreven IDE- of CLI-tool via OmniRoute: gratis API-gateway voor onbeperkte codering._
OpenClaw
OpenClaw
โญ 205K 		NanoBot
NanoBot
โญ 20.9K 		PicoClaw
PicoClaw
โญ 14.6K 		ZeroClaw
ZeroClaw
โญ 9.9K 		IronClaw
IronClaw
โญ 2.1K
OpenCode
OpenCode
โญ 106K 		Codex CLI
Codex CLI
โญ 60.8K 		Claude Code
Claude Code
โญ 67.3K 		Gemini CLI
Gemini CLI
โญ 94.7K 		Kilo Code
Kilo Code
โญ 15.5K
๐Ÿ“ก Alle agenten maken verbinding via http://localhost:20128/v1 of http://cloud.omniroute.online/v1 โ€” รฉรฉn configuratie, onbeperkte modellen en quota --- [![npm version](https://img.shields.io/npm/v/omniroute?color=cb3837&logo=npm)](https://www.npmjs.com/package/omniroute) [![Docker Hub](https://img.shields.io/docker/v/diegosouzapw/omniroute?label=Docker%20Hub&logo=docker&color=2496ED)](https://hub.docker.com/r/diegosouzapw/omniroute) [![License](https://img.shields.io/github/license/diegosouzapw/OmniRoute)](https://github.com/diegosouzapw/OmniRoute/blob/main/LICENSE) [![Website](https://img.shields.io/badge/Website-omniroute.online-blue?logo=google-chrome&logoColor=white)](https://omniroute.online) [![WhatsApp](https://img.shields.io/badge/WhatsApp-Community-25D366?logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) [๐ŸŒ Website](https://omniroute.online) โ€ข [๐Ÿš€ Quick Start](#-quick-start) โ€ข [๐Ÿ’ก Features](#-key-features) โ€ข [๐Ÿ“– Docs](#-documentation) โ€ข [๐Ÿ’ฐ Pricing](#-pricing-at-a-glance) โ€ข [๐Ÿ’ฌ WhatsApp](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) ๐ŸŒ **Available in:** ๐Ÿ‡บ๐Ÿ‡ธ [English](README.md) | ๐Ÿ‡ง๐Ÿ‡ท [Portuguรชs (Brasil)](README.pt-BR.md) | ๐Ÿ‡ช๐Ÿ‡ธ [Espaรฑol](README.es.md) | ๐Ÿ‡ซ๐Ÿ‡ท [Franรงais](README.fr.md) | ๐Ÿ‡ฎ๐Ÿ‡น [Italiano](README.it.md) | ๐Ÿ‡ท๐Ÿ‡บ [ะ ัƒััะบะธะน](README.ru.md) | ๐Ÿ‡จ๐Ÿ‡ณ [ไธญๆ–‡ (็ฎ€ไฝ“)](README.zh-CN.md) | ๐Ÿ‡ฉ๐Ÿ‡ช [Deutsch](README.de.md) | ๐Ÿ‡ฎ๐Ÿ‡ณ [เคนเคฟเคจเฅเคฆเฅ€](README.in.md) | ๐Ÿ‡น๐Ÿ‡ญ [เน„เธ—เธข](README.th.md) | ๐Ÿ‡บ๐Ÿ‡ฆ [ะฃะบั€ะฐั—ะฝััŒะบะฐ](README.uk-UA.md) | ๐Ÿ‡ธ๐Ÿ‡ฆ [ุงู„ุนุฑุจูŠุฉ](README.ar.md) | ๐Ÿ‡ฏ๐Ÿ‡ต [ๆ—ฅๆœฌ่ชž](README.ja.md) | ๐Ÿ‡ป๐Ÿ‡ณ [Tiแบฟng Viแป‡t](README.vi.md) | ๐Ÿ‡ง๐Ÿ‡ฌ [ะ‘ัŠะปะณะฐั€ัะบะธ](README.bg.md) | ๐Ÿ‡ฉ๐Ÿ‡ฐ [Dansk](README.da.md) | ๐Ÿ‡ซ๐Ÿ‡ฎ [Suomi](README.fi.md) | ๐Ÿ‡ฎ๐Ÿ‡ฑ [ืขื‘ืจื™ืช](README.he.md) | ๐Ÿ‡ญ๐Ÿ‡บ [Magyar](README.hu.md) | ๐Ÿ‡ฎ๐Ÿ‡ฉ [Bahasa Indonesia](README.id.md) | ๐Ÿ‡ฐ๐Ÿ‡ท [ํ•œ๊ตญ์–ด](README.ko.md) | ๐Ÿ‡ฒ๐Ÿ‡พ [Bahasa Melayu](README.ms.md) | ๐Ÿ‡ณ๐Ÿ‡ฑ [Nederlands](README.nl.md) | ๐Ÿ‡ณ๐Ÿ‡ด [Norsk](README.no.md) | ๐Ÿ‡ต๐Ÿ‡น [Portuguรชs (Portugal)](README.pt.md) | ๐Ÿ‡ท๐Ÿ‡ด [Romรขnฤƒ](README.ro.md) | ๐Ÿ‡ต๐Ÿ‡ฑ [Polski](README.pl.md) | ๐Ÿ‡ธ๐Ÿ‡ฐ [Slovenฤina](README.sk.md) | ๐Ÿ‡ธ๐Ÿ‡ช [Svenska](README.sv.md) | ๐Ÿ‡ต๐Ÿ‡ญ [Filipino](README.phi.md)
--- ## ๐Ÿค” Waarom OmniRoute? **Stop met het verspillen van geld en het bereiken van grenzen:** - Het abonnementsquotum verloopt elke maand ongebruikt - Snelheidslimieten voorkomen dat u halverwege codeert - Dure API's ($20-50/maand per provider) - Handmatig schakelen tussen providers **OmniRoute lost dit op:** - โœ… **Maximaliseer abonnementen** - Houd quota bij, gebruik elk bit voordat u het opnieuw instelt - โœ… **Automatische fallback** - Abonnement โ†’ API-sleutel โ†’ Goedkoop โ†’ Gratis, geen downtime - โœ… **Multi-account** - Round-robin tussen accounts per provider - โœ… **Universeel** - Werkt met Claude Code, Codex, Gemini CLI, Cursor, Cline, OpenClaw, elke CLI-tool --- ## ๐Ÿ”„ Hoe het werkt ``` โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ Your CLI โ”‚ (Claude Code, Codex, Gemini CLI, OpenClaw, Cursor, Cline...) โ”‚ Tool โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚ http://localhost:20128/v1 โ†“ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ OmniRoute (Smart Router) โ”‚ โ”‚ โ€ข Format translation (OpenAI โ†” Claude) โ”‚ โ”‚ โ€ข Quota tracking + Embeddings + Images โ”‚ โ”‚ โ€ข Auto token refresh โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚ โ”œโ”€โ†’ [Tier 1: SUBSCRIPTION] Claude Code, Codex, Gemini CLI โ”‚ โ†“ quota exhausted โ”œโ”€โ†’ [Tier 2: API KEY] DeepSeek, Groq, xAI, Mistral, NVIDIA NIM, etc. โ”‚ โ†“ budget limit โ”œโ”€โ†’ [Tier 3: CHEAP] GLM ($0.6/1M), MiniMax ($0.2/1M) โ”‚ โ†“ budget limit โ””โ”€โ†’ [Tier 4: FREE] iFlow, Qwen, Kiro (unlimited) Result: Never stop coding, minimal cost ``` --- ## ๐ŸŽฏ What OmniRoute Solves โ€” 16 Real Pain Points > **Every developer using AI tools faces these problems daily.** OmniRoute was built to solve them all โ€” from cost overruns to regional blocks, from broken OAuth flows to zero observability.
๐Ÿ’ธ 1. "I pay for an expensive subscription but still get interrupted by limits" Developers pay $20โ€“200/month for Claude Pro, Codex Pro, or GitHub Copilot. Even paying, quota has a ceiling โ€” 5h of usage, weekly limits, or per-minute rate limits. Mid-coding session, the provider stops responding and the developer loses flow and productivity. **How OmniRoute solves it:** - **Smart 4-Tier Fallback** โ€” If subscription quota runs out, automatically redirects to API Key โ†’ Cheap โ†’ Free with zero manual intervention - **Real-Time Quota Tracking** โ€” Shows token consumption in real-time with reset countdown (5h, daily, weekly) - **Multi-Account Support** โ€” Multiple accounts per provider with auto round-robin โ€” when one runs out, switches to the next - **Custom Combos** โ€” Customizable fallback chains with 6 balancing strategies (fill-first, round-robin, P2C, random, least-used, cost-optimized) - **Codex Business Quotas** โ€” Business/Team workspace quota monitoring directly in the dashboard
๐Ÿ”Œ 2. "I need to use multiple providers but each has a different API" OpenAI uses one format, Claude (Anthropic) uses another, Gemini yet another. If a dev wants to test models from different providers or fallback between them, they need to reconfigure SDKs, change endpoints, deal with incompatible formats. Custom providers (FriendLI, NIM) have non-standard model endpoints. **How OmniRoute solves it:** - **Unified Endpoint** โ€” A single `http://localhost:20128/v1` serves as proxy for all 36+ providers - **Format Translation** โ€” Automatic and transparent: OpenAI โ†” Claude โ†” Gemini โ†” Responses API - **Response Sanitization** โ€” Strips non-standard fields (`x_groq`, `usage_breakdown`, `service_tier`) that break OpenAI SDK v1.83+ - **Role Normalization** โ€” Converts `developer` โ†’ `system` for non-OpenAI providers; `system` โ†’ `user` for GLM/ERNIE - **Think Tag Extraction** โ€” Extracts `` blocks from models like DeepSeek R1 into standardized `reasoning_content` - **Structured Output for Gemini** โ€” `json_schema` โ†’ `responseMimeType`/`responseSchema` automatic conversion - **`stream` defaults to `false`** โ€” Aligns with OpenAI spec, avoiding unexpected SSE in Python/Rust/Go SDKs
๐ŸŒ 3. "My AI provider blocks my region/country" Providers like OpenAI/Codex block access from certain geographic regions. Users get errors like `unsupported_country_region_territory` during OAuth and API connections. This is especially frustrating for developers from developing countries. **How OmniRoute solves it:** - **3-Level Proxy Config** โ€” Configurable proxy at 3 levels: global (all traffic), per-provider (one provider only), and per-connection/key - **Color-Coded Proxy Badges** โ€” Visual indicators: ๐ŸŸข global proxy, ๐ŸŸก provider proxy, ๐Ÿ”ต connection proxy, always showing the IP - **OAuth Token Exchange Through Proxy** โ€” OAuth flow also goes through the proxy, solving `unsupported_country_region_territory` - **Connection Tests via Proxy** โ€” Connection tests use the configured proxy (no more direct bypass) - **SOCKS5 Support** โ€” Full SOCKS5 proxy support for outbound routing - **TLS Fingerprint Spoofing** โ€” Browser-like TLS fingerprint via `wreq-js` to bypass bot detection
๐Ÿ†“ 4. "I want to use AI for coding but I have no money" Not everyone can pay $20โ€“200/month for AI subscriptions. Students, devs from emerging countries, hobbyists, and freelancers need access to quality models at zero cost. **How OmniRoute solves it:** - **Free Tier Providers Built-in** โ€” Native support for 100% free providers: iFlow (8 unlimited models), Qwen (3 unlimited models), Kiro (Claude for free), Gemini CLI (180K/month free) - **Free-Only Combos** โ€” Chain `gc/gemini-3-flash โ†’ if/kimi-k2-thinking โ†’ qw/qwen3-coder-plus` = $0/month with zero downtime - **NVIDIA NIM Free Credits** โ€” 1000 free credits integrated - **Cost Optimized Strategy** โ€” Routing strategy that automatically chooses the cheapest available provider
๐Ÿ”’ 5. "I need to protect my AI gateway from unauthorized access" When exposing an AI gateway to the network (LAN, VPS, Docker), anyone with the address can consume the developer's tokens/quota. Without protection, APIs are vulnerable to misuse, prompt injection, and abuse. **How OmniRoute solves it:** - **API Key Management** โ€” Generation, rotation, and scoping per provider with a dedicated `/dashboard/api-manager` page - **Model-Level Permissions** โ€” Restrict API keys to specific models (`openai/*`, wildcard patterns), with Allow All/Restrict toggle - **API Endpoint Protection** โ€” Require a key for `/v1/models` and block specific providers from the listing - **Auth Guard + CSRF Protection** โ€” All dashboard routes protected with `withAuth` middleware + CSRF tokens - **Rate Limiter** โ€” Per-IP rate limiting with configurable windows - **IP Filtering** โ€” Allowlist/blocklist for access control - **Prompt Injection Guard** โ€” Sanitization against malicious prompt patterns - **AES-256-GCM Encryption** โ€” Credentials encrypted at rest
๐Ÿ›‘ 6. "My provider went down and I lost my coding flow" AI providers can become unstable, return 5xx errors, or hit temporary rate limits. If a dev depends on a single provider, they're interrupted. Without circuit breakers, repeated retries can crash the application. **How OmniRoute solves it:** - **Circuit Breaker per-provider** โ€” Auto-open/close with configurable thresholds and cooldown (Closed/Open/Half-Open) - **Exponential Backoff** โ€” Progressive retry delays - **Anti-Thundering Herd** โ€” Mutex + semaphore protection against concurrent retry storms - **Combo Fallback Chains** โ€” If the primary provider fails, automatically falls through the chain with no intervention - **Combo Circuit Breaker** โ€” Auto-disables failing providers within a combo chain - **Health Dashboard** โ€” Uptime monitoring, circuit breaker states, lockouts, cache stats, p50/p95/p99 latency
๐Ÿ”ง 7. "Configuring each AI tool is tedious and repetitive" Developers use Cursor, Claude Code, Codex CLI, OpenClaw, Gemini CLI, Kilo Code... Each tool needs a different config (API endpoint, key, model). Reconfiguring when switching providers or models is a waste of time. **How OmniRoute solves it:** - **CLI Tools Dashboard** โ€” Dedicated page with one-click setup for Claude Code, Codex CLI, OpenClaw, Kilo Code, Antigravity, Cline - **GitHub Copilot Config Generator** โ€” Generates `chatLanguageModels.json` for VS Code with bulk model selection - **Onboarding Wizard** โ€” Guided 4-step setup for first-time users - **One endpoint, all models** โ€” Configure `http://localhost:20128/v1` once, access 36+ providers
๐Ÿ”‘ 8. "Managing OAuth tokens from multiple providers is hell" Claude Code, Codex, Gemini CLI, Copilot โ€” all use OAuth 2.0 with expiring tokens. Developers need to re-authenticate constantly, deal with `client_secret is missing`, `redirect_uri_mismatch`, and failures on remote servers. OAuth on LAN/VPS is particularly problematic. **How OmniRoute solves it:** - **Auto Token Refresh** โ€” OAuth tokens refresh in background before expiration - **OAuth 2.0 (PKCE) Built-in** โ€” Automatic flow for Claude Code, Codex, Gemini CLI, Copilot, Kiro, Qwen, iFlow - **Multi-Account OAuth** โ€” Multiple accounts per provider via JWT/ID token extraction - **OAuth LAN/Remote Fix** โ€” Private IP detection for `redirect_uri` + manual URL mode for remote servers - **OAuth Behind Nginx** โ€” Uses `window.location.origin` for reverse proxy compatibility - **Remote OAuth Guide** โ€” Step-by-step guide for Google Cloud credentials on VPS/Docker
๐Ÿ“Š 9. "I don't know how much I'm spending or where" Developers use multiple paid providers but have no unified view of spending. Each provider has its own billing dashboard, but there's no consolidated view. Unexpected costs can pile up. **How OmniRoute solves it:** - **Cost Analytics Dashboard** โ€” Per-token cost tracking and budget management per provider - **Budget Limits per Tier** โ€” Spending ceiling per tier that triggers automatic fallback - **Per-Model Pricing Configuration** โ€” Configurable prices per model - **Usage Statistics Per API Key** โ€” Request count and last-used timestamp per key - **Analytics Dashboard** โ€” Stat cards, model usage chart, provider table with success rates and latency
๐Ÿ› 10. "I can't diagnose errors and problems in AI calls" When a call fails, the dev doesn't know if it was a rate limit, expired token, wrong format, or provider error. Fragmented logs across different terminals. Without observability, debugging is trial-and-error. **How OmniRoute solves it:** - **Unified Logs Dashboard** โ€” 4 tabs: Request Logs, Proxy Logs, Audit Logs, Console - **Console Log Viewer** โ€” Real-time terminal-style viewer with color-coded levels, auto-scroll, search, filter - **SQLite Proxy Logs** โ€” Persistent logs that survive server restarts - **Translator Playground** โ€” 4 debugging modes: Playground (format translation), Chat Tester (round-trip), Test Bench (batch), Live Monitor (real-time) - **Request Telemetry** โ€” p50/p95/p99 latency + X-Request-Id tracing - **File-Based Logging with Rotation** โ€” Console interceptor captures everything to JSON log with size-based rotation
๐Ÿ—๏ธ 11. "Deploying and maintaining the gateway is complex" Installing, configuring, and maintaining an AI proxy across different environments (local, VPS, Docker, cloud) is labor-intensive. Problems like hardcoded paths, `EACCES` on directories, port conflicts, and cross-platform builds add friction. **How OmniRoute solves it:** - **npm global install** โ€” `npm install -g omniroute && omniroute` โ€” done - **Docker Multi-Platform** โ€” AMD64 + ARM64 native (Apple Silicon, AWS Graviton, Raspberry Pi) - **Docker Compose Profiles** โ€” `base` (no CLI tools) and `cli` (with Claude Code, Codex, OpenClaw) - **Electron Desktop App** โ€” Native app for Windows/macOS/Linux with system tray, auto-start, offline mode - **Split-Port Mode** โ€” API and Dashboard on separate ports for advanced scenarios (reverse proxy, container networking) - **Cloud Sync** โ€” Config synchronization across devices via Cloudflare Workers - **DB Backups** โ€” Automatic backup, restore, export and import of all settings
๐ŸŒ 12. "The interface is English-only and my team doesn't speak English" Teams in non-English-speaking countries, especially in Latin America, Asia, and Europe, struggle with English-only interfaces. Language barriers reduce adoption and increase configuration errors. **How OmniRoute solves it:** - **Dashboard i18n โ€” 30 Languages** โ€” All 500+ keys translated including Arabic, Bulgarian, Danish, German, Spanish, Finnish, French, Hebrew, Hindi, Hungarian, Indonesian, Italian, Japanese, Korean, Malay, Dutch, Norwegian, Polish, Portuguese (PT/BR), Romanian, Russian, Slovak, Swedish, Thai, Ukrainian, Vietnamese, Chinese, Filipino, English - **RTL Support** โ€” Right-to-left support for Arabic and Hebrew - **Multi-Language READMEs** โ€” 30 complete documentation translations - **Language Selector** โ€” Globe icon in header for real-time switching
๐Ÿ”„ 13. "I need more than chat โ€” I need embeddings, images, audio" AI isn't just chat completion. Devs need to generate images, transcribe audio, create embeddings for RAG, rerank documents, and moderate content. Each API has a different endpoint and format. **How OmniRoute solves it:** - **Embeddings** โ€” `/v1/embeddings` with 6 providers and 9+ models - **Image Generation** โ€” `/v1/images/generations` with 4 providers and 9+ models - **Audio Transcription** โ€” `/v1/audio/transcriptions` โ€” Whisper-compatible - **Text-to-Speech** โ€” `/v1/audio/speech` โ€” Multi-provider audio synthesis - **Moderations** โ€” `/v1/moderations` โ€” Content safety checks - **Reranking** โ€” `/v1/rerank` โ€” Document relevance reranking - **Responses API** โ€” Full `/v1/responses` support for Codex
๐Ÿงช 14. "I have no way to test and compare quality across models" Developers want to know which model is best for their use case โ€” code, translation, reasoning โ€” but comparing manually is slow. No integrated eval tools exist. **How OmniRoute solves it:** - **LLM Evaluations** โ€” Golden set testing with 10 pre-loaded cases covering greetings, math, geography, code generation, JSON compliance, translation, markdown, safety refusal - **4 Match Strategies** โ€” `exact`, `contains`, `regex`, `custom` (JS function) - **Translator Playground Test Bench** โ€” Batch testing with multiple inputs and expected outputs, cross-provider comparison - **Chat Tester** โ€” Full round-trip with visual response rendering - **Live Monitor** โ€” Real-time stream of all requests flowing through the proxy
๐Ÿ“ˆ 15. "I need to scale without losing performance" As request volume grows, without caching the same questions generate duplicate costs. Without idempotency, duplicate requests waste processing. Per-provider rate limits must be respected. **How OmniRoute solves it:** - **Semantic Cache** โ€” Two-tier cache (signature + semantic) reduces cost and latency - **Request Idempotency** โ€” 5s deduplication window for identical requests - **Rate Limit Detection** โ€” Per-provider RPM, min gap, and max concurrent tracking - **Editable Rate Limits** โ€” Configurable defaults in Settings โ†’ Resilience with persistence - **API Key Validation Cache** โ€” 3-tier cache for production performance - **Health Dashboard with Telemetry** โ€” p50/p95/p99 latency, cache stats, uptime
๐Ÿค– 16. "I want to control model behavior globally" Developers who want all responses in a specific language, with a specific tone, or want to limit reasoning tokens. Configuring this in every tool/request is impractical. **How OmniRoute solves it:** - **System Prompt Injection** โ€” Global prompt applied to all requests - **Thinking Budget Validation** โ€” Reasoning token allocation control per request (passthrough, auto, custom, adaptive) - **6 Routing Strategies** โ€” Global strategies that determine how requests are distributed - **Wildcard Router** โ€” `provider/*` patterns route dynamically to any provider - **Combo Enable/Disable Toggle** โ€” Toggle combos directly from the dashboard - **Provider Toggle** โ€” Enable/disable all connections for a provider with one click - **Blocked Providers** โ€” Exclude specific providers from `/v1/models` listing
## โšก Snelle start **1. Wereldwijd installeren:** ```bash npm install -g omniroute omniroute ``` ๐ŸŽ‰ Dashboard wordt geopend op `http://localhost:20128` | Commando | Beschrijving | | ----------------------- | ---------------------------------- | | `omniroute` | Startserver (standaardpoort 20128) | | `omniroute --port 3000` | Gebruik aangepaste poort | | `omniroute --no-open` | Browser niet automatisch openen | | `omniroute --help` | Hulp tonen | **2. Sluit een GRATIS provider aan:** Dashboard โ†’ Providers โ†’ **Claude Code** of **Antigravity** verbinden โ†’ OAuth-aanmelding โ†’ Klaar! **3. Gebruik in uw CLI-tool:** ``` Claude Code/Codex/Gemini CLI/OpenClaw/Cursor/Cline Settings: Endpoint: http://localhost:20128/v1 API Key: [copy from dashboard] Model: if/kimi-k2-thinking ``` **Dat is alles!** Begin met coderen met GRATIS AI-modellen. **Alternatief โ€” uitvoeren vanaf bron:** ```bash cp .env.example .env npm install PORT=20128 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run dev ``` --- ## ๐Ÿณ Docker OmniRoute is beschikbaar als openbare Docker-image op [Docker Hub](https://hub.docker.com/r/diegosouzapw/omniroute). **Snelle uitvoering:** ```bash docker run -d \ --name omniroute \ --restart unless-stopped \ -p 20128:20128 \ -v omniroute-data:/app/data \ diegosouzapw/omniroute:latest ``` **Met omgevingsbestand:** ```bash # Copy and edit .env first cp .env.example .env docker run -d \ --name omniroute \ --restart unless-stopped \ --env-file .env \ -p 20128:20128 \ -v omniroute-data:/app/data \ diegosouzapw/omniroute:latest ``` ** Docker Compose gebruiken:** ```bash # Base profile (no CLI tools) docker compose --profile base up -d # CLI profile (Claude Code, Codex, OpenClaw built-in) docker compose --profile cli up -d ``` | Afbeelding | Label | Maat | Beschrijving | | ------------------------ | -------- | ------ | ------------------------- | | `diegosouzapw/omniroute` | `latest` | ~250MB | Nieuwste stabiele release | | `diegosouzapw/omniroute` | `1.0.3` | ~250MB | Huidige versie | --- --- ## ๐Ÿ–ฅ๏ธ Desktop App โ€” Offline & Always-On > ๐Ÿ†• **NEW!** OmniRoute is now available as a **native desktop application** for Windows, macOS, and Linux. - ๐Ÿ–ฅ๏ธ **Native Window** โ€” Dedicated app window with system tray integration - ๐Ÿ”„ **Auto-Start** โ€” Launch OmniRoute on system login - ๐Ÿ”” **Native Notifications** โ€” Get alerts for quota exhaustion or provider issues - โšก **One-Click Install** โ€” NSIS (Windows), DMG (macOS), AppImage (Linux) - ๐ŸŒ **Offline Mode** โ€” Works fully offline with bundled server ```bash npm run electron:dev # Development mode npm run electron:build # Current platform npm run electron:build:win # Windows (.exe) npm run electron:build:mac # macOS (.dmg) npm run electron:build:linux # Linux (.AppImage) ``` ๐Ÿ“– Full documentation: [`electron/README.md`](electron/README.md) --- ## ๐Ÿ’ฐ Prijzen in รฉรฉn oogopslag | Niveau | Aanbieder | Kosten | Quotum opnieuw instellen | Beste voor | | ------------------ | ----------------- | ------------------------- | ------------------------ | -------------------------- | | **๐Ÿ’ณ ABONNEMENT** | Claude Code (Pro) | $ 20/maand | 5u + wekelijks | Al geabonneerd | | | Codex (Plus/Pro) | $ 20-200/maand | 5u + wekelijks | OpenAI-gebruikers | | | Tweeling CLI | **GRATIS** | 180K/maand + 1K/dag | Iedereen! | | | GitHub-copiloot | $ 10-19/maand | Maandelijks | GitHub-gebruikers | | **๐Ÿ”‘ API-SLEUTEL** | NVIDIA NIM | **GRATIS** (1000 credits) | Eenmalig | Gratis niveautesten | | | DeepSeek | Betalen per gebruik | Geen | Beste prijs/kwaliteit | | | Groq | Gratis niveau + betaald | Tarief beperkt | Ultrasnelle gevolgtrekking | | | xAI (Grok) | Betalen per gebruik | Geen | Grok-modellen | | | Mistral | Gratis niveau + betaald | Tarief beperkt | Europese AI | | | OpenRouter | Betalen per gebruik | Geen | 100+ modellen | | **๐Ÿ’ฐGOEDKOOP** | GLM-4.7 | $ 0,6/1 miljoen | Dagelijks 10.00 uur | Budgetback-up | | | MiniMax M2.1 | $ 0,2/1 miljoen | 5-uurs rollen | Goedkoopste optie | | | Kimi K2 | $ 9/maand plat | 10 miljoen tokens/maand | Voorspelbare kosten | | **๐Ÿ†“ GRATIS** | iFlow | $0 | Onbeperkt | 8 modellen gratis | | | Qwen | $0 | Onbeperkt | 3 modellen gratis | | | Kiro | $0 | Onbeperkt | Claude vrij | **๐Ÿ’ก Pro-tip:** Begin met Gemini CLI (180K gratis/maand) + iFlow (onbeperkt gratis) combo = $ 0 kosten! --- ## ๐Ÿ’ก Belangrijkste kenmerken ### ๐Ÿง  Kernroutering en intelligentie | Kenmerk | Wat het doet | | ------------------------------------------- | ------------------------------------------------------------------------------------------------- | | ๐ŸŽฏ **Slimme terugval op 4 niveaus** | Autoroute: Abonnement โ†’ API-sleutel โ†’ Goedkoop โ†’ Gratis | | ๐Ÿ“Š **Realtime quota bijhouden** | Live tokentelling + reset-aftelling per provider | | ๐Ÿ”„ **Formaatvertaling** | OpenAI โ†” Claude โ†” Gemini โ†” Cursor โ†” Kiro naadloos + responsopschoning | | ๐Ÿ‘ฅ **Ondersteuning voor meerdere accounts** | Meerdere accounts per aanbieder met intelligente selectie | | ๐Ÿ”„ **Automatische tokenvernieuwing** | OAuth-tokens worden automatisch vernieuwd bij nieuwe poging | | ๐ŸŽจ **Aangepaste combo's** | 6 strategieรซn: eerst vullen, round-robin, p2c, willekeurig, minst gebruikt, kostengeoptimaliseerd | | ๐Ÿงฉ **Aangepaste modellen** | Voeg elke model-ID toe aan elke provider | | ๐ŸŒ **Wildcard-router** | Stuur `provider/*` patronen dynamisch naar elke provider | | ๐Ÿง  **Denkbudget** | Passthrough-, automatische, aangepaste en adaptieve modi voor redeneermodellen | | ๐Ÿ”€ **Model Aliases** | Auto-forward deprecated model IDs to current replacements (built-in + custom) | | โšก **Background Degradation** | Auto-route background tasks (titles, summaries) to cheaper models | | ๐Ÿ’ฌ **Systeempromptinjectie** | Algemene systeemprompt toegepast op alle verzoeken | | ๐Ÿ“„ **Reacties-API** | Volledige OpenAI Responses API (`/v1/responses`) ondersteuning voor Codex | ### ๐ŸŽต Multimodale API's | Kenmerk | Wat het doet | | ------------------------ | --------------------------------------------------------- | | ๐Ÿ–ผ๏ธ **Beeldgeneratie** | `/v1/images/generations` โ€” 4 providers, 9+ modellen | | ๐Ÿ“ **Insluitingen** | `/v1/embeddings` โ€” 6 providers, 9+ modellen | | ๐ŸŽค **Audiotranscriptie** | `/v1/audio/transcriptions` โ€” Whisper-compatibel | | ๐Ÿ”Š **Tekst-naar-spraak** | `/v1/audio/speech` โ€” Audiosynthese van meerdere providers | | ๐Ÿ›ก๏ธ **Moderaties** | `/v1/moderations` โ€” Veiligheidscontroles van inhoud | | ๐Ÿ”€ **Herschikking** | `/v1/rerank` โ€” Herschikking van documentrelevantie | ### ๐Ÿ›ก๏ธ Veerkracht en veiligheid | Kenmerk | Wat het doet | | ------------------------------------- | ---------------------------------------------------------------------------------------- | | ๐Ÿ”Œ **Stroomonderbreker** | Automatisch openen/sluiten per provider met configureerbare drempels | | ๐Ÿ›ก๏ธ **Anti-donderende kudde** | Mutex + semafoorsnelheidslimiet voor API-sleutelproviders | | ๐Ÿง  **Semantische cache** | Tweelaagse cache (handtekening + semantisch) verlaagt de kosten en latentie | | โšก **Idempotentie aanvragen** | 5s ontdubbelingsvenster voor dubbele verzoeken | | ๐Ÿ”’ **TLS-vingerafdrukspoofing** | Omzeil TLS-gebaseerde botdetectie via wreq-js | | ๐ŸŒ **IP-filtering** | Toelatingslijst/blokkeerlijst voor API-toegangscontrole | | ๐Ÿ“Š **Bewerkbare tarieflimieten** | Configureerbare RPM, minimale tussenruimte en maximale gelijktijdigheid op systeemniveau | | ๐Ÿ’พ **Rate Limit Persistence** | Learned limits survive restarts via SQLite with 60s debounce + 24h staleness | | ๐Ÿ”„ **Token Refresh Resilience** | Per-provider circuit breaker (5 failsโ†’30min) + 30s timeout per attempt | | ๐Ÿ›ก **API-eindpuntbescherming** | Auth-gating + providerblokkering voor het `/models` eindpunt | | ๐Ÿ”’ **Proxyzichtbaarheid** | Kleurgecodeerde badges: ๐ŸŸข wereldwijd, ๐ŸŸก provider, ๐Ÿ”ต per verbinding met IP-display | | ๐ŸŒ **Proxyconfiguratie op 3 niveaus** | Configureer proxy's op globaal, per provider of per verbindingsniveau | ### ๐Ÿ“Š Waarneembaarheid en analyse | Kenmerk | Wat het doet | | ------------------------------------------------- | ------------------------------------------------------------------------------------------- | | ๐Ÿ“ **Logboekregistratie aanvragen** | Foutopsporingsmodus met volledige aanvraag-/antwoordlogboeken | | ๐Ÿ’พ **SQLite Proxy-logboeken** | Aanhoudende proxylogboeken overleven het opnieuw opstarten van de server | | ๐Ÿ“Š **Analytics-dashboard** | Recharts-aangedreven: statistische kaarten, modelgebruiksgrafiek, providertabel | | ๐Ÿ“ˆ **Voortgang bijhouden** | SSE-voortgangsgebeurtenissen aanmelden voor streaming | | ๐Ÿงช **LLM-evaluaties** | Gouden settesten met 4 wedstrijdstrategieรซn | | ๐Ÿ” **Telemetrie aanvragen** | p50/p95/p99 latentie-aggregatie + X-Request-Id-tracering | | ๐Ÿ“‹ **Logdashboard** | Uniforme pagina met 4 tabbladen: aanvraaglogboeken, proxylogboeken, auditlogboeken, console | | ๐Ÿ–ฅ๏ธ **Consolelogviewer** | Realtime viewer in terminalstijl met niveaufilter, zoeken, automatisch scrollen | | ๐Ÿ“‘ **Op bestanden gebaseerde logboekregistratie** | Console-interceptor legt alle uitvoer vast naar JSON-logbestand met rotatie | | ๐Ÿฅ **Gezondheidsdashboard** | Systeemuptime, status van stroomonderbrekers, uitsluitingen, cachestatistieken | | ๐Ÿ’ฐ **Kosten bijhouden** | Budgetbeheer + prijsconfiguratie per model | ### โ˜๏ธ Implementatie en synchronisatie | Kenmerk | Wat het doet | | ----------------------------- | ------------------------------------------------------------------------------- | | ๐Ÿ’พ **Cloudsynchronisatie** | Synchroniseer de configuratie op verschillende apparaten via Cloudflare Workers | | ๐ŸŒ **Overal implementeren** | Localhost, VPS, Docker, Cloudflare Workers | | ๐Ÿ”‘ **API-sleutelbeheer** | Genereer, roteer en bereik API-sleutels per provider | | ๐Ÿง™ **Onboarding-wizard** | Begeleide installatie in 4 stappen voor nieuwe gebruikers | | ๐Ÿ”ง **CLI Tools-dashboard** | Configureer met รฉรฉn klik Claude, Codex, Cline, OpenClaw, Kilo, Antigravity | | ๐Ÿ”„ **DB-back-ups** | Automatische back-up, herstel, export en import voor alle instellingen | | ๐ŸŒ **Internationalisering** | Volledige i18n met next-intl โ€” Engels + Portugees (Braziliรซ) ondersteuning | | ๐ŸŒ **Taalkiezer** | Wereldbolpictogram in koptekst voor realtime taalwisseling (๐Ÿ‡บ๐Ÿ‡ธ/๐Ÿ‡ง๐Ÿ‡ท) | | ๐Ÿ“‚ **Aangepaste gegevensmap** | `DATA_DIR` env var om standaard `~/.omniroute` opslagpad te overschrijven |
๐Ÿ“– Functiedetails ### ๐ŸŽฏ Slimme terugval op 4 niveaus Creรซer combo's met automatische terugval: ``` Combo: "my-coding-stack" 1. cc/claude-opus-4-6 (your subscription) 2. nvidia/llama-3.3-70b (free NVIDIA API) 3. glm/glm-4.7 (cheap backup, $0.6/1M) 4. if/kimi-k2-thinking (free fallback) โ†’ Auto switches when quota runs out or errors occur ``` ### ๐Ÿ“Š Realtime quota bijhouden - Tokenverbruik per aanbieder - Aftellen resetten (5 uur, dagelijks, wekelijks) - Kostenraming voor betaalde niveaus - Maandelijkse uitgavenrapporten ### ๐Ÿ”„ Formaatvertaling Naadloze vertaling tussen formaten: - **OpenAI** โ†” **Claude** โ†” **Gemini** โ†” **OpenAI-reacties** - Uw CLI-tool verzendt OpenAI-formaat โ†’ OmniRoute vertaalt โ†’ Provider ontvangt native formaat - Werkt met elke tool die aangepaste OpenAI-eindpunten ondersteunt - **Reactieopschoning** โ€” Verwijdert niet-standaardvelden voor strikte OpenAI SDK-compatibiliteit - **Rolnormalisatie** โ€” `developer` โ†’ `system` voor niet-OpenAI; `system` โ†’ `user` voor GLM/ERNIE-modellen - **Extractie van Think-tags** โ€” `` blokken โ†’ `reasoning_content` voor denkmodellen - **Gestructureerde uitvoer** โ€” `json_schema` โ†’ Gemini's `responseMimeType`/`responseSchema` ### ๐Ÿ‘ฅ Ondersteuning voor meerdere accounts - Voeg meerdere accounts per aanbieder toe - Automatische round-robin of op prioriteit gebaseerde routering - Terugval naar het volgende account wanneer รฉรฉn het quotum bereikt ### ๐Ÿ”„ Automatische tokenvernieuwing - OAuth-tokens worden automatisch vernieuwd voordat ze verlopen - Geen handmatige herauthenticatie nodig - Naadloze ervaring bij alle providers ### ๐ŸŽจ Aangepaste combo's - Creรซer onbeperkte modelcombinaties - 6 strategieรซn: eerst vullen, round-robin, macht van twee keuzes, willekeurig, minst gebruikt, kostengeoptimaliseerd - Deel combo's op verschillende apparaten met Cloud Sync ### ๐Ÿฅ Gezondheidsdashboard - Systeemstatus (uptime, versie, geheugengebruik) - Status van de stroomonderbrekers per provider (Gesloten/Open/Half-Open) - Tarieflimietstatus en actieve uitsluitingen - Kenmerkende cachestatistieken - Latency-telemetrie (p50/p95/p99) + promptcache - Reset de gezondheidsstatus met รฉรฉn klik ### ๐Ÿ”ง Vertalerspeeltuin OmniRoute bevat een krachtige ingebouwde Translator Playground met **4 modi** voor het debuggen, testen en monitoren van API-vertalingen: | Modus | Beschrijving | | ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **๐Ÿ’ป Speeltuin** | Directe formaatvertaling: plak de hoofdtekst van een API-verzoek en zie direct hoe OmniRoute deze vertaalt tussen providerformaten (OpenAI โ†” Claude โ†” Gemini โ†” Responses API). Bevat voorbeeldsjablonen en automatische detectie van formaten. | | **๐Ÿ’ฌ Chattester** | Stuur echte chatverzoeken via OmniRoute en bekijk het volledige overzicht: uw invoer, het vertaalde verzoek, het antwoord van de provider en het vertaalde antwoord terug. Van onschatbare waarde voor het valideren van combo-routering. | | **๐Ÿงช Proefbank** | Batchtestmodus: definieer meerdere testgevallen met verschillende inputs en verwachte outputs, voer ze allemaal tegelijk uit en vergelijk de resultaten van verschillende providers en modellen. | | **๐Ÿ“ฑLivemonitor** | Real-time monitoring van verzoeken: bekijk binnenkomende verzoeken terwijl ze door OmniRoute stromen, bekijk de formaatvertalingen live en identificeer problemen direct. | **Toegang:** Dashboard โ†’ Vertaler (zijbalk) ### ๐Ÿ’พCloudsynchronisatie - Synchroniseer providers, combo's en instellingen op verschillende apparaten - Automatische achtergrondsynchronisatie - Veilige gecodeerde opslag
--- ## ๐ŸŽฏ Gebruiksscenario's ### Geval 1: "Ik heb een Claude Pro-abonnement" **Probleem:** Quotum verloopt ongebruikt, snelheidslimieten tijdens intensief coderen ``` Combo: "maximize-claude" 1. cc/claude-opus-4-6 (use subscription fully) 2. glm/glm-4.7 (cheap backup when quota out) 3. if/kimi-k2-thinking (free emergency fallback) Monthly cost: $20 (subscription) + ~$5 (backup) = $25 total vs. $20 + hitting limits = frustration ``` ### Geval 2: "Ik wil geen kosten" **Probleem:** Ik kan geen abonnementen betalen, heb betrouwbare AI-codering nodig ``` Combo: "free-forever" 1. gc/gemini-3-flash (180K free/month) 2. if/kimi-k2-thinking (unlimited free) 3. qw/qwen3-coder-plus (unlimited free) Monthly cost: $0 Quality: Production-ready models ``` ### Geval 3: "Ik heb 24/7 codering nodig, geen onderbrekingen" **Probleem:** Deadlines, downtime is niet mogelijk ``` Combo: "always-on" 1. cc/claude-opus-4-6 (best quality) 2. cx/gpt-5.2-codex (second subscription) 3. glm/glm-4.7 (cheap, resets daily) 4. minimax/MiniMax-M2.1 (cheapest, 5h reset) 5. if/kimi-k2-thinking (free unlimited) Result: 5 layers of fallback = zero downtime ``` ### Case 4: "Ik wil GRATIS AI in OpenClaw" **Probleem:** AI-assistent nodig in berichtenapps, geheel gratis ``` Combo: "openclaw-free" 1. if/glm-4.7 (unlimited free) 2. if/minimax-m2.1 (unlimited free) 3. if/kimi-k2-thinking (unlimited free) Monthly cost: $0 Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal... ``` --- ## ๐Ÿ“– Installatiehandleiding
๐Ÿ’ณ Abonnementaanbieders ### Claude-code (Pro/Max) ```bash Dashboard โ†’ Providers โ†’ Connect Claude Code โ†’ OAuth login โ†’ Auto token refresh โ†’ 5-hour + weekly quota tracking Models: cc/claude-opus-4-6 cc/claude-sonnet-4-5-20250929 cc/claude-haiku-4-5-20251001 ``` **Pro-tip:** Gebruik Opus voor complexe taken, Sonnet voor snelheid. OmniRoute houdt quota bij per model! ### OpenAI-codex (Plus/Pro) ```bash Dashboard โ†’ Providers โ†’ Connect Codex โ†’ OAuth login (port 1455) โ†’ 5-hour + weekly reset Models: cx/gpt-5.2-codex cx/gpt-5.1-codex-max ``` ### Gemini CLI (GRATIS 180K/maand!) ```bash Dashboard โ†’ Providers โ†’ Connect Gemini CLI โ†’ Google OAuth โ†’ 180K completions/month + 1K/day Models: gc/gemini-3-flash-preview gc/gemini-2.5-pro ``` **Beste waarde:** Enorm gratis niveau! Gebruik dit vรณรณr betaalde niveaus. ### GitHub-copiloot ```bash Dashboard โ†’ Providers โ†’ Connect GitHub โ†’ OAuth via GitHub โ†’ Monthly reset (1st of month) Models: gh/gpt-5 gh/claude-4.5-sonnet gh/gemini-3-pro ```
๐Ÿ”‘ API-sleutelproviders ### NVIDIA NIM (GRATIS 1000 credits!) 1. Aanmelden: [build.nvidia.com](https://build.nvidia.com) 2. Ontvang een gratis API-sleutel (inclusief 1000 inferentiecredits) 3. Dashboard โ†’ Provider toevoegen โ†’ NVIDIA NIM: - API-sleutel: `nvapi-your-key` **Modellen:** `nvidia/llama-3.3-70b-instruct`, `nvidia/mistral-7b-instruct` en nog meer dan 50 **Pro-tip:** OpenAI-compatibele API โ€” werkt naadloos samen met de formaatvertaling van OmniRoute! ### Diepzoeken 1. Aanmelden: [platform.deepseek.com](https://platform.deepseek.com) 2. Haal de API-sleutel op 3. Dashboard โ†’ Provider toevoegen โ†’ DeepSeek **Modellen:** `deepseek/deepseek-chat`, `deepseek/deepseek-coder` ### Groq (gratis niveau beschikbaar!) 1. Aanmelden: [console.groq.com](https://console.groq.com) 2. Ontvang een API-sleutel (inclusief gratis laag) 3. Dashboard โ†’ Provider toevoegen โ†’ Groq **Modellen:** `groq/llama-3.3-70b`, `groq/mixtral-8x7b` **Pro-tip:** Ultrasnelle gevolgtrekking โ€” het beste voor realtime coderen! ### OpenRouter (meer dan 100 modellen) 1. Aanmelden: [openrouter.ai](https://openrouter.ai) 2. Haal de API-sleutel op 3. Dashboard โ†’ Provider toevoegen โ†’ OpenRouter **Modellen:** Krijg toegang tot meer dan 100 modellen van alle grote providers via รฉรฉn API-sleutel.
๐Ÿ’ฐ Goedkope providers (back-up) ### GLM-4.7 (dagelijkse reset, $0,6/1 miljoen) 1. Aanmelden: [Zhipu AI](https://open.bigmodel.cn/) 2. Haal de API-sleutel op uit het Coderingsplan 3. Dashboard โ†’ API-sleutel toevoegen: - Aanbieder: `glm` - API-sleutel: `your-key` **Gebruik:** `glm/glm-4.7` **Pro-tip:** Coderingsplan biedt 3ร— quotum tegen 1/7 kosten! Dagelijks resetten om 10:00 uur. ### MiniMax M2.1 (5 uur resetten, $0,20/1M) 1. Aanmelden: [MiniMax](https://www.minimax.io/) 2. Haal de API-sleutel op 3. Dashboard โ†’ API-sleutel toevoegen **Gebruik:** `minimax/MiniMax-M2.1` **Pro-tip:** Goedkoopste optie voor lange context (1 miljoen tokens)! ### Kimi K2 ($9/maand vast) 1. Abonneer je: [Moonshot AI](https://platform.moonshot.ai/) 2. Haal de API-sleutel op 3. Dashboard โ†’ API-sleutel toevoegen **Gebruik:** `kimi/kimi-latest` **Pro-tip:** Vaste $ 9/maand voor 10 miljoen tokens = $ 0,90/1 miljoen effectieve kosten!
๐Ÿ†“ GRATIS providers (noodback-up) ### iFlow (8 GRATIS modellen) ```bash Dashboard โ†’ Connect iFlow โ†’ iFlow OAuth login โ†’ Unlimited usage Models: if/kimi-k2-thinking if/qwen3-coder-plus if/glm-4.7 if/minimax-m2 if/deepseek-r1 ``` ### Qwen (3 GRATIS modellen) ```bash Dashboard โ†’ Connect Qwen โ†’ Device code authorization โ†’ Unlimited usage Models: qw/qwen3-coder-plus qw/qwen3-coder-flash ``` ### Kiro (Claude GRATIS) ```bash Dashboard โ†’ Connect Kiro โ†’ AWS Builder ID or Google/GitHub โ†’ Unlimited usage Models: kr/claude-sonnet-4.5 kr/claude-haiku-4.5 ```
๐ŸŽจ Combo's maken ### Voorbeeld 1: Maximaliseer abonnement โ†’ Goedkope back-up ``` Dashboard โ†’ Combos โ†’ Create New Name: premium-coding Models: 1. cc/claude-opus-4-6 (Subscription primary) 2. glm/glm-4.7 (Cheap backup, $0.6/1M) 3. minimax/MiniMax-M2.1 (Cheapest fallback, $0.20/1M) Use in CLI: premium-coding ``` ### Voorbeeld 2: Alleen gratis (geen kosten) ``` Name: free-combo Models: 1. gc/gemini-3-flash-preview (180K free/month) 2. if/kimi-k2-thinking (unlimited) 3. qw/qwen3-coder-plus (unlimited) Cost: $0 forever! ```
๐Ÿ”ง CLI-integratie ### Cursor-IDE ``` Settings โ†’ Models โ†’ Advanced: OpenAI API Base URL: http://localhost:20128/v1 OpenAI API Key: [from OmniRoute dashboard] Model: cc/claude-opus-4-6 ``` ### Claude-code Gebruik de pagina **CLI Tools** in het dashboard voor configuratie met รฉรฉn klik, of bewerk `~/.claude/settings.json` handmatig. ### Codex-CLI ```bash export OPENAI_BASE_URL="http://localhost:20128" export OPENAI_API_KEY="your-omniroute-api-key" codex "your prompt" ``` ### Open Klauw **Optie 1 โ€” Dashboard (aanbevolen):** ``` Dashboard โ†’ CLI Tools โ†’ OpenClaw โ†’ Select Model โ†’ Apply ``` **Optie 2 โ€” Handmatig:** Bewerk `~/.openclaw/openclaw.json`: ```json { "models": { "providers": { "omniroute": { "baseUrl": "http://127.0.0.1:20128/v1", "apiKey": "sk_omniroute", "api": "openai-completions" } } } } ``` > **Opmerking:** OpenClaw werkt alleen met lokale OmniRoute. Gebruik `127.0.0.1` in plaats van `localhost` om IPv6-resolutieproblemen te voorkomen. ### Cline / Doorgaan / RooCode ``` Settings โ†’ API Configuration: Provider: OpenAI Compatible Base URL: http://localhost:20128/v1 API Key: [from OmniRoute dashboard] Model: if/kimi-k2-thinking ```
--- ## ๐Ÿงช Evaluaties (Evals) OmniRoute bevat een ingebouwd evaluatieframework om de LLM-responskwaliteit te testen aan de hand van een gouden set. U kunt deze openen via **Analytics โ†’ Evaluaties** in het dashboard. ### Ingebouwde gouden set De vooraf geladen "OmniRoute Golden Set" bevat 10 testcases die betrekking hebben op: - Groeten, wiskunde, aardrijkskunde, codegeneratie - Naleving van JSON-formaat, vertaling, prijsverlaging - Veiligheidsweigering (schadelijke inhoud), tellen, booleaanse logica ### Evaluatiestrategieรซn | Strategie | Beschrijving | Voorbeeld | | ---------- | --------------------------------------------------------------------- | -------------------------------- | | `exact` | De uitvoer moet exact overeenkomen met | `"4"` | | `contains` | De uitvoer moet een subtekenreeks bevatten (niet hoofdlettergevoelig) | `"Paris"` | | `regex` | Uitvoer moet overeenkomen met regex-patroon | `"1.*2.*3"` | | `custom` | Aangepaste JS-functie retourneert waar/onwaar | `(output) => output.length > 10` | --- ## ๐Ÿ› Problemen oplossen
Klik om de probleemoplossingsgids uit te vouwen **"Taalmodel heeft geen berichten verstrekt"** - Providerquotum opgebruikt โ†’ Controleer dashboardquotumtracker - Oplossing: gebruik combo-fallback of schakel over naar een goedkoper niveau **Snelheidslimiet** - Abonnementquotum op โ†’ Terugval op GLM/MiniMax - Combinatie toevoegen: `cc/claude-opus-4-6 โ†’ glm/glm-4.7 โ†’ if/kimi-k2-thinking` **OAuth-token verlopen** - Automatisch vernieuwd door OmniRoute - Als de problemen aanhouden: Dashboard โ†’ Provider โ†’ Opnieuw verbinding maken **Hoge kosten** - Controleer gebruiksstatistieken in Dashboard โ†’ Kosten - Schakel het primaire model over naar GLM/MiniMax - Gebruik de gratis laag (Gemini CLI, iFlow) voor niet-kritieke taken **Dashboard opent op verkeerde poort** - Stel `PORT=20128` en `NEXT_PUBLIC_BASE_URL=http://localhost:20128` in **Cloudsynchronisatiefouten** - Controleer of `BASE_URL` verwijst naar uw actieve exemplaar - Controleer of `CLOUD_URL` verwijst naar uw verwachte cloudeindpunt - Houd `NEXT_PUBLIC_*` waarden afgestemd op de waarden op de server **Eerste login werkt niet** - Controleer `INITIAL_PASSWORD` in `.env` - Indien niet ingesteld, is het reservewachtwoord `123456` **Geen verzoeklogboeken** - Stel `ENABLE_REQUEST_LOGS=true` in in `.env` **Verbindingstest toont "Ongeldig" voor OpenAI-compatibele providers** - Veel providers stellen geen `/models` eindpunt beschikbaar - OmniRoute v1.0.6+ omvat fallback-validatie via chat-voltooiingen - Zorg ervoor dat de basis-URL het achtervoegsel `/v1` bevat ### ๐Ÿ” OAuth em Servidor Remoto (OAuth-installatie op afstand) > **โš ๏ธ BELANGRIJK voor gebruik met OmniRoute op VPS/Docker/server op afstand** ### Waarom werkt OAuth met Antigravity / Gemini CLI op externe servers? Deze bewijzen **Antigravity** en **Gemini CLI** gebruiken **Google OAuth 2.0** voor authenticatie. O Google vraagt โ€‹โ€‹dat `redirect_uri` geen OAuth-stroom gebruikt **exatamente** een van de URI's vรณรณr de kadaster zonder toepassing van Google Cloud Console. Omdat OAuth geen OmniRoute heeft geregistreerd, is dit **apenas para `localhost`**. Wanneer u OmniRoute op een externe server opent (bijvoorbeeld: `https://omniroute.meuservidor.com`), of Google een authenticatie aanvraagt: ``` Error 400: redirect_uri_mismatch ``` ### Oplossing: Configureer uw eigen OAuth-credenciais U kunt precies zien hoe **OAuth 2.0 Client ID** geen Google Cloud Console heeft met een URI van zijn server. #### Passo een passo **1. Toegang tot Google Cloud Console** Abra: [https://console.cloud.google.com/apis/credentials](https://console.cloud.google.com/apis/credentials) **2. Nieuwe OAuth 2.0 client-ID** - Klik op **"+ Credentials aanmaken"** โ†’ **"OAuth-client-ID"** - Applicatietip: **"Webapplicatie"** - Nome: escolha qualquer nome (bijvoorbeeld: `OmniRoute Remote`) **3. Adicione als geautoriseerde omleidings-URI's** Geen campagne **"Geautoriseerde omleidings-URI's"**, aanbevolen: ``` https://seu-servidor.com/callback ``` > Vervang `seu-servidor.com` door de domicilie of het IP-adres van uw server (inclusief een noodzakelijke poort, bijvoorbeeld: `http://45.33.32.156:20128/callback`). **4. Bewaar en kopieer als credenciais** U kunt ook op Google klikken op **Client-ID** en **Clientgeheim**. **5. Configureer als variรกveis de ambiente** Geen `.env` (of de verschillende omgevingen van Docker): ```bash # Para Antigravity: ANTIGRAVITY_OAUTH_CLIENT_ID=seu-client-id.apps.googleusercontent.com ANTIGRAVITY_OAUTH_CLIENT_SECRET=GOCSPX-seu-secret # Para Gemini CLI: GEMINI_OAUTH_CLIENT_ID=seu-client-id.apps.googleusercontent.com GEMINI_OAUTH_CLIENT_SECRET=GOCSPX-seu-secret GEMINI_CLI_OAUTH_CLIENT_SECRET=GOCSPX-seu-secret ``` **6. Reinicie van OmniRoute** ```bash # Se usando npm: npm run dev # Se usando Docker: docker restart omniroute ``` **7. Nieuwe verbinding** Dashboard โ†’ Providers โ†’ Antigravity (ou Gemini CLI) โ†’ OAuth Nadat Google de juiste verwijzing naar `https://seu-servidor.com/callback` heeft gemaakt, is deze autenticaal functioneel geworden. --- ### Tijdelijke tijdelijke oplossing (sem credenciais prรณprias configureren) Als u geen geloofwaardige geloofwaardigheid meer heeft, is het mogelijk om de stroom **handleiding van de URL** te gebruiken: 1. OmniRoute gebruikt een autorisatie-URL van Google 2. Als u de autorisatie heeft gegeven, zal Google de doorverwijzing naar `localhost` uitvoeren (die geen externe service biedt) 3. **Kopieer een volledige URL** door de browser van uw browser (het bericht dat de pagina niet verder gaat) 4. Cole essa URL is niet beschikbaar op de verbindingswijze van OmniRoute 5. Klik op **"Verbinden"** > Deze tijdelijke oplossing werkt door de autorisatiecode van de URL en is onafhankelijk van het omleiden naar uw autorisatie of niet.
--- ## ๐Ÿ› ๏ธTechnische stapel - **Runtime**: Node.js 18โ€“22 LTS (โš ๏ธ Node.js 24+ wordt **niet ondersteund** โ€” `better-sqlite3` native binaire bestanden zijn incompatibel) - **Taal**: TypeScript 5.9 โ€” **100% TypeScript** voor `src/` en `open-sse/` (v1.0.6) - **Framework**: Next.js 16 + React 19 + Tailwind CSS 4 - **Database**: LowDB (JSON) + SQLite (domeinstatus + proxylogboeken) - **Streaming**: door de server verzonden gebeurtenissen (SSE) - **Auth**: OAuth 2.0 (PKCE) + JWT + API-sleutels - **Testen**: Node.js-testloper (368+ unit-tests) - **CI/CD**: GitHub-acties (automatische npm-publicatie + Docker Hub bij release) - **Website**: [omniroute.online](https://omniroute.online) - **Pakket**: [npmjs.com/package/omniroute](https://www.npmjs.com/package/omniroute) - **Docker**: [hub.docker.com/r/diegosouzapw/omniroute](https://hub.docker.com/r/diegosouzapw/omniroute) - **Veerkracht**: stroomonderbreker, exponentieel uitstel, anti-donderkudde, TLS-spoofing --- ## ๐Ÿ“– Documentatie | Document | Beschrijving | | -------------------------------------------- | --------------------------------------------------- | | [User Guide](docs/USER_GUIDE.md) | Providers, combo's, CLI-integratie, implementatie | | [API Reference](docs/API_REFERENCE.md) | Alle eindpunten met voorbeelden | | [Troubleshooting](docs/TROUBLESHOOTING.md) | Veelvoorkomende problemen en oplossingen | | [Architecture](docs/ARCHITECTURE.md) | Systeemarchitectuur en internals | | [Contributing](CONTRIBUTING.md) | Ontwikkelingsopstelling en richtlijnen | | [OpenAPI Spec](docs/openapi.yaml) | OpenAPI 3.0-specificatie | | [Security Policy](SECURITY.md) | Kwetsbaarheidsrapportage en beveiligingspraktijken | | [VM Deployment](docs/VM_DEPLOYMENT_GUIDE.md) | Volledige gids: VM + nginx + Cloudflare-installatie | | [Features Gallery](docs/FEATURES.md) | Visuele dashboardrondleiding met screenshots | ### ๐Ÿ“ธ Dashboardvoorbeeld
Klik om dashboardscreenshots te bekijken | Pagina | Schermafbeelding | | --------------------- | ------------------------------------------------- | | **Aanbieders** | ![Providers](docs/screenshots/01-providers.png) | | **Combo's** | ![Combos](docs/screenshots/02-combos.png) | | **Analytics** | ![Analytics](docs/screenshots/03-analytics.png) | | **Gezondheid** | ![Health](docs/screenshots/04-health.png) | | **Vertaler** | ![Translator](docs/screenshots/05-translator.png) | | **Instellingen** | ![Settings](docs/screenshots/06-settings.png) | | **CLI-hulpmiddelen** | ![CLI Tools](docs/screenshots/07-cli-tools.png) | | **Gebruikslogboeken** | ![Usage](docs/screenshots/08-usage.png) | | **Eindpunt** | ![Endpoint](docs/screenshots/09-endpoint.png) |
--- ## ๐Ÿ—บ๏ธ Routekaart OmniRoute heeft **210+ functies gepland** over meerdere ontwikkelingsfasen. Dit zijn de belangrijkste gebieden: | Categorie | Geplande functies | Hoogtepunten | | ------------------------------- | ----------------- | --------------------------------------------------------------------------------------------------------- | | ๐Ÿง  **Routing en intelligentie** | 25+ | Routering met de laagste latentie, op tags gebaseerde routering, quota-preflight, P2C-accountselectie | | ๐Ÿ”’ **Beveiliging en naleving** | 20+ | SSRF-verharding, cloaking van inloggegevens, snelheidslimiet per eindpunt, scoping van beheersleutels | | ๐Ÿ“Š **Waarneembaarheid** | 15+ | OpenTelemetry-integratie, realtime quotabewaking, kostenregistratie per model | | ๐Ÿ”„ **Provider-integraties** | 20+ | Dynamisch modelregister, cooldowns van providers, Codex met meerdere accounts, parseren van Copilot-quota | | โšก **Prestaties** | 15+ | Dubbele cachelaag, promptcache, responscache, streaming keepalive, batch-API | | ๐ŸŒ **Ecosysteem** | 10+ | WebSocket API, configuratie hot-reload, gedistribueerde configuratieopslag, commerciรซle modus | ### ๐Ÿ”œ Binnenkort beschikbaar - ๐Ÿ”— **OpenCode-integratie** โ€” Native providerondersteuning voor de OpenCode AI-coderings-IDE - ๐Ÿ”— **TRAE-integratie** โ€” Volledige ondersteuning voor het TRAE AI-ontwikkelingsframework - ๐Ÿ“ฆ **Batch API** โ€” Asynchrone batchverwerking voor bulkaanvragen - ๐ŸŽฏ **Op tags gebaseerde routering** โ€” Routeer verzoeken op basis van aangepaste tags en metagegevens - ๐Ÿ’ฐ **Laagste kostenstrategie** โ€” Selecteer automatisch de goedkoopste beschikbare provider > ๐Ÿ“ Volledige functiespecificaties beschikbaar in [link](docs/new-features/) (217 gedetailleerde specificaties) --- ## ๐Ÿ“ง Ondersteuning > ๐Ÿ’ฌ **Word lid van onze community!** [WhatsApp Group](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) โ€” Krijg hulp, deel tips en blijf op de hoogte. - **Website**: [omniroute.online](https://omniroute.online) - **GitHub**: [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute) - **Problemen**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) - **WhatsApp**: [Community Group](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) - **Origineel project**: [9router by decolua](https://github.com/decolua/9router) --- ## ๐Ÿ‘ฅ Bijdragers [![Contributors](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=100&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors) ### Hoe u kunt bijdragen 1. Fork de repository 2. Maak uw feature branch (`git checkout -b feature/amazing-feature`) 3. Leg uw wijzigingen vast (`git commit -m 'Add amazing feature'`) 4. Duw naar het filiaal (`git push origin feature/amazing-feature`) 5. Open een Pull Request Zie [CONTRIBUTING.md](CONTRIBUTING.md) voor gedetailleerde richtlijnen. ### Er wordt een nieuwe versie uitgebracht ```bash # Create a release โ€” npm publish happens automatically gh release create v1.0.6 --title "v1.0.6" --generate-notes ``` --- ## ๐Ÿ“Š Sterrengeschiedenis Star History Chart --- ## ๐Ÿ™ Dankbetuigingen Speciale dank aan **[9router](https://github.com/decolua/9router)** door **[decolua](https://github.com/decolua)** โ€” het originele project dat deze vork inspireerde. OmniRoute bouwt voort op die ongelooflijke basis met extra functies, multimodale API's en een volledige TypeScript-herschrijving. Speciale dank aan **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** โ€” de originele Go-implementatie die deze JavaScript-port inspireerde. --- ## ๐Ÿ“„ Licentie MIT-licentie - zie [LICENSE](LICENSE) voor details. ---
Gebouwd met โค๏ธ voor ontwikkelaars die 24/7 coderen
omniroute.online