OmniRoute/docs/i18n/sv/README.md

🚀 OmniRoute — The Free AI Gateway (Svenska)

🌐 Languages: 🇺🇸 English · 🇪🇸 es · 🇫🇷 fr · 🇩🇪 de · 🇮🇹 it · 🇷🇺 ru · 🇨🇳 zh-CN · 🇯🇵 ja · 🇰🇷 ko · 🇸🇦 ar · 🇮🇳 hi · 🇮🇳 in · 🇹🇭 th · 🇻🇳 vi · 🇮🇩 id · 🇲🇾 ms · 🇳🇱 nl · 🇵🇱 pl · 🇸🇪 sv · 🇳🇴 no · 🇩🇰 da · 🇫🇮 fi · 🇵🇹 pt · 🇷🇴 ro · 🇭🇺 hu · 🇧🇬 bg · 🇸🇰 sk · 🇺🇦 uk-UA · 🇮🇱 he · 🇵🇭 phi · 🇧🇷 pt-BR · 🇨🇿 cs · 🇹🇷 tr

---

Never stop coding. Smart routing to FREE & low-cost AI models with automatic fallback.

Din universella API-proxy — en slutpunkt, 60+ leverantörer, noll driftstopp. Nu medMCP Server (25 verktyg),A2A Protocol,Memory/Skills SystemsochElectron Desktop App.

Slutförda chattar • Inbäddningar • Bildgenerering • Video • Musik • Ljud • Omrankning •Webbsökning• MCP-server • A2A-protokoll • 100 % TypeScript---

🌐 Webbplats • 🚀 Snabbstart • 💡 Funktioner • 📖 Dokument • 💰 Prissättning • 💬 WhatsApp

🌐Tillgänglig på:🇺🇸 engelska | 🇧🇷 Português (Brasilien) | 🇪🇸 Español | 🇫🇷 Français | 🇮🇹 Italiano | 🇷🇺 Русский | 🇨🇳 中文 (简体) | 🇩🇪 tyska | 🇮🇳 हिन्दी | 🇹🇭 ไทย | 🇺🇦 Українська | 🇸🇦 العربية | 🇯🇵 日本語 | 🇻🇳 Tiếng Việt | 🇧🇬 Български | 🇩🇰 Dansk | 🇫🇮 Suomi | 🇮🇱 עברית | 🇭🇺 Magyar | 🇮🇩 Bahasa Indonesia | 🇰🇷 한국어 | 🇲🇾 Bahasa Melayu | 🇳🇱 Nederlands | 🇳🇴 norska | 🇵🇹 Português (Portugal) | 🇷🇴 Română | 🇵🇱 Polski | 🇸🇰 Slovenčina | 🇸🇪 Svenska | 🇵🇭 filippinska | 🇨🇿 Čeština---

🖼️ Main Dashboard

---

📸 Dashboard Preview

Klicka för att se skärmdumpar från instrumentpanelen

Sida	Skärmdump
Leverantörer
Kombos
Analytik
Hälsa
Översättare
Inställningar
CLI-verktyg
Användningsloggar
Slutpunkter

---

🤖 Free AI Provider for your favorite coding agents

Anslut alla AI-drivna IDE- eller CLI-verktyg via OmniRoute — gratis API-gateway för obegränsad kodning.

OpenClaw
_{⭐ 205K}
NanoBot
_{⭐ 20,9K}
PicoClaw
_{⭐ 14,6K}
ZeroClaw
_{⭐ 9,9K}
IronClaw
_{⭐ 2,1K}
OpenCode
_{⭐ 106K}
Codex CLI
_{⭐ 60,8K}
Claude Code
_{⭐ 67,3K}
Gemini CLI
_{⭐ 94,7K}
Kilokod
_{⭐ 15,5K}

_{📡 Alla agenter ansluter via http://localhost:20128/v1 eller http://cloud.omniroute.online/v1 — en konfiguration, obegränsade modeller och kvot}---

🤔 Why OmniRoute?

Sluta slösa pengar och nå gränser:

• Prenumerationskvoten löper ut oanvänd varje månad
• Prisgränser stoppar dig mellankodning
• Dyra API:er ($20-50/månad per leverantör)
• Manuellt byte mellan leverantörer

OmniRoute löser detta:

• ✅Maximera prenumerationer- Spåra kvot, använd varje bit innan återställning
• ✅Automatisk reserv- Prenumeration → API-nyckel → Billigt → Gratis, noll driftstopp
• ✅Multi-konto- Round-robin mellan konton per leverantör
• ✅Universal- Fungerar med Claude Code, Codex, Gemini CLI, Cursor, Cline, OpenClaw, vilket CLI-verktyg som helst---

📧 Support

💬Gå med i vår community!WhatsApp Group — Få hjälp, dela tips och håll dig uppdaterad.

-Webbplats: omniroute.online -GitHub: github.com/diegosouzapw/OmniRoute -Problem: github.com/diegosouzapw/OmniRoute/issues -WhatsApp: Community Group -Bidrar: Se CONTRIBUTING.md, öppna en PR eller välj ett "bra första nummer" -Original Project: 9router av decolua### 🐛 Reporting a Bug?

När du öppnar ett problem, kör kommandot systeminfo och bifoga den genererade filen:```bash npm run system-info

Detta genererar en `system-info.txt` med din Node.js-version, OmniRoute-version, OS-detaljer, installerade CLI-verktyg (qoder, gemini, claude, codex, antigravity, droid, etc.), Docker/PM2-status och systempaket - allt vi behöver för att snabbt reproducera ditt problem. Bifoga filen direkt till ditt GitHub-problem.---

## 🔄 How It Works

┌─────────────┐ │ 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] Qoder, Qwen, Kiro (unlimited)

Result: Never stop coding, minimal cost

---

## 🎯 What OmniRoute Solves — 30 Real Pain Points & Use Cases

>**Varje utvecklare som använder AI-verktyg möter dessa problem dagligen.**OmniRoute byggdes för att lösa dem alla — från kostnadsöverskridanden till regionala block, från trasiga OAuth-flöden till protokolloperationer och observerbarhet i företag.

<detaljer>
<summary><b>💸 1. "Jag betalar för en dyr prenumeration men blir ändå avbruten av limits"</b></summary>

Utvecklare betalar $20–200/månad för Claude Pro, Codex Pro eller GitHub Copilot. Även om du betalar har kvoten ett tak - 5 timmars användning, veckogränser eller gränser per minut. Mid-coding session, leverantören slutar svara och utvecklaren tappar flöde och produktivitet.

**Hur OmniRoute löser det:**

-**Smart 4-lagers fallback**— Om prenumerationskvoten tar slut, omdirigeras automatiskt till API-nyckel → Billigt → Gratis med noll manuellt ingrepp
-**Spårning av leverantörsgränser**— Cachade ögonblicksbilder av kvoter uppdateras på ett schema på serversidan (standard `PROVIDER_LIMITS_SYNC_INTERVAL_MINUTES=70`) med manuell uppdatering tillgänglig i användargränssnittet
-**Stöd för flera konton**- Flera konton per leverantör med automatisk round-robin - när ett tar slut, byter du till nästa
-**Anpassade kombinationer**— Anpassningsbara reservkedjor med 9 balanseringsstrategier (prioritet, viktad, fyll först, round-robin, P2C, slumpmässig, minst använda, kostnadsoptimerad, strikt slumpmässig)
-**Codex Business Quotas**— Övervakning av företags-/teamarbetsutrymmeskvoter direkt i instrumentpanelen</details>

<detaljer>
<summary><b>🔌 2. "Jag måste använda flera leverantörer men alla har olika API"</b></summary>

OpenAI använder ett format, Claude (Anthropic) använder ett annat, Gemini ännu ett annat. Om en utvecklare vill testa modeller från olika leverantörer eller fallback mellan dem måste de konfigurera om SDK:er, ändra slutpunkter, hantera inkompatibla format. Anpassade leverantörer (FriendLI, NIM) har icke-standardiserade modellslutpunkter.

**Hur OmniRoute löser det:**

-**Unified Endpoint**— En enda "http://localhost:20128/v1" fungerar som proxy för alla 60+ leverantörer
-**Formatöversättning**— Automatisk och transparent: OpenAI ↔ Claude ↔ Gemini ↔ Responses API
-**Response Sanitization**— Tar bort icke-standardiserade fält (`x_groq`, `usage_breakdown`, `service_tier`) som bryter OpenAI SDK v1.83+
-**Rollnormalisering**— Konverterar `utvecklare` → `system` för icke-OpenAI-leverantörer; `system` → `användare` för GLM/ERNIE
-**Think Tag Extraction**— Extraherar `<think>`-block från modeller som DeepSeek R1 till standardiserat `reasoning_content`
-**Structured Output for Gemini**— `json_schema` → `responseMimeType`/`responseSchema` automatisk konvertering
-**`stream` har som standard "false"**- Justerar med OpenAI-specifikationen, undviker oväntade SSE i Python/Rust/Go SDK:er</details>

<detaljer>
<summary><b>🌐 3. "Min AI-leverantör blockerar min region/land"</b></summary>

Leverantörer som OpenAI/Codex blockerar åtkomst från vissa geografiska regioner. Användare får fel som "unsupported_country_region_territory" under OAuth- och API-anslutningar. Detta är särskilt frustrerande för utvecklare från utvecklingsländer.

**Hur OmniRoute löser det:**

-**3-Level Proxy Config**— Konfigurerbar proxy på 3 nivåer: global (all trafik), per leverantör (endast en leverantör) och per anslutning/nyckel
-**Färgkodade proxymärken**— Visuella indikatorer: 🟢 global proxy, 🟡 leverantörsproxy, 🔵 anslutningsproxy, visar alltid IP:n
-**OAuth Token Exchange Through Proxy**— OAuth-flödet går också genom proxyn och löser "unsupported_country_region_territory"
-**Anslutningstester via proxy**— Anslutningstester använder den konfigurerade proxyn (ingen mer direkt förbikoppling)
-**SOCKS5-stöd**— Fullständigt SOCKS5-proxystöd för utgående routing
-**TLS Fingerprint Spoofing**— Webbläsarliknande TLS-fingeravtryck via "wreq-js" för att kringgå botdetektering
-**🔏 CLI Fingerprint Matching**— Ordnar om rubriker och kroppsfält för att matcha inbyggda CLI-binära signaturer, vilket drastiskt minskar risken för kontoflaggning. Proxy-IP:n bevaras – du får både smyg**och**IP-maskering samtidigt</details>

<detaljer>
<summary><b>🆓 4. "Jag vill använda AI för kodning men jag har inga pengar"</b></summary>

Alla kan inte betala $20–200/månad för AI-prenumerationer. Studenter, utvecklare från tillväxtländer, hobbyister och frilansare behöver tillgång till kvalitetsmodeller utan kostnad.

**Hur OmniRoute löser det:**

-**Gratis leverantörer inbyggda**— Inbyggt stöd för 100 % gratis leverantörer: Qoder (5 obegränsade modeller via OAuth: kimi-k2-thinking, qwen3-coder-plus, deepseek-r1, minimax-m2, kimi-k2), Qwen (4 unlimited-modeller:-r-modeller:-r qwen3-coder-flash, qwen3-coder-next, vision-model), Kiro (Claude + AWS Builder ID gratis), Gemini CLI (180K tokens/månad gratis)
-**Ollama Cloud**— Ollama-modeller med molnvärd på `api.ollama.com` med gratis nivå "Lätt användning"; använd prefixet `ollamacloud/<modell>`
-**Free-Only Combos**— Chain `gc/gemini-3-flash → if/kimi-k2-thinking → qw/qwen3-coder-plus` = $0/månad utan stilleståndstid
-**NVIDIA NIM fri tillgång**— ~40 RPM dev-för evigt fri tillgång till 70+ modeller på build.nvidia.com (övergång från krediter till rena hastighetsgränser)
-**Kostnadsoptimerad strategi**— Routingstrategi som automatiskt väljer den billigaste tillgängliga leverantören</details>

<detaljer>
<summary><b>🔒 5. "Jag måste skydda min AI-gateway från obehörig åtkomst"</b></summary>

När du exponerar en AI-gateway för nätverket (LAN, VPS, Docker) kan vem som helst med adressen konsumera utvecklarens tokens/kvot. Utan skydd är API:er sårbara för missbruk, snabb injektion och missbruk.

**Hur OmniRoute löser det:**

-**API Key Management**— Generering, rotation och omfattning per leverantör med en dedikerad `/dashboard/api-manager`-sida
-**Behörigheter på modellnivå**— Begränsa API-nycklar till specifika modeller ('openai/*', jokerteckenmönster), med växlingen Tillåt alla/Begränsa
-**API Endpoint Protection**— Kräv en nyckel för `/v1/modeller` och blockera specifika leverantörer från listan
-**Auth Guard + CSRF Protection**— Alla instrumentpanelsrutter skyddade med 'withAuth' middleware + CSRF-tokens
-**Rate Limiter**— Per-IP-hastighetsbegränsning med konfigurerbara fönster
-**IP-filtrering**— Tillåtelselista/blockeringslista för åtkomstkontroll
-**Prompt Injection Guard**— Sanering mot skadliga promptmönster
-**AES-256-GCM-kryptering**— Autentiseringsuppgifter krypterade i vila</details>

<detaljer>
<summary><b>🛑 6. "Min leverantör gick ner och jag tappade mitt kodningsflöde"</b></summary>

AI-leverantörer kan bli instabila, returnera 5xx-fel eller nå tillfälliga hastighetsgränser. Om en utvecklare är beroende av en enskild leverantör avbryts de. Utan strömbrytare kan upprepade försök krascha programmet.

**Hur OmniRoute löser det:**

-**Circuit Breaker per modell**— Autoöppning/stängning med konfigurerbara trösklar och nedkylning (stängd/öppen/halvöppen), omfattning per modell för att undvika kaskadblock
-**Exponentiell backoff**— Progressiva fördröjningar igen
-**Anti-Thundering Herd**— Mutex + semaforskydd mot samtidiga stormar igen
-**Combo reservkedjor**— Om den primära leverantören misslyckas, faller den automatiskt genom kedjan utan ingrepp
-**Combo Circuit Breaker**- Inaktiverar automatiskt felande leverantörer inom en kombinationskedja
-**Health Dashboard**— Drifttidsövervakning, strömbrytartillstånd, låsningar, cachestatistik, p50/p95/p99 latens</details>

<detaljer>
<summary><b>🔧 7. "Att konfigurera varje AI-verktyg är tråkigt och repetitivt"</b></summary>

Utvecklare använder Cursor, Claude Code, Codex CLI, OpenClaw, Gemini CLI, Kilo Code... Varje verktyg behöver en annan konfiguration (API-slutpunkt, nyckel, modell). Att konfigurera om när man byter leverantör eller modell är ett slöseri med tid.

**Hur OmniRoute löser det:**

-**CLI Tools Dashboard**— Dedikerad sida med ett-klicksinställningar för Claude Code, Codex CLI, OpenClaw, Kilo Code, Antigravity, Cline
-**GitHub Copilot Config Generator**— Genererar `chatLanguageModels.json` för VS-kod med bulkmodellval
-**Onboarding Wizard**— Guidad 4-stegs installation för förstagångsanvändare
-**En slutpunkt, alla modeller**— Konfigurera "http://localhost:20128/v1" en gång, åtkomst till 60+ leverantörer</details>

<detaljer>
<summary><b>🔑 8. "Hantera OAuth-tokens från flera leverantörer är ett helvete"</b></summary>

Claude Code, Codex, Gemini CLI, Copilot — alla använder OAuth 2.0 med utgående tokens. Utvecklare måste autentisera om hela tiden, hantera "klienthemlighet saknas", "redirect_uri_mismatch" och fel på fjärrservrar. OAuth på LAN/VPS är särskilt problematiskt.

**Hur OmniRoute löser det:**

-**Automatisk uppdatering av token**— OAuth-tokens uppdateras i bakgrunden innan de löper ut
-**OAuth 2.0 (PKCE) Inbyggd**— Automatiskt flöde för Claude Code, Codex, Gemini CLI, Copilot, Kiro, Qwen, Qoder
-**Multi-Account OAuth**— Flera konton per leverantör via JWT/ID-tokenextraktion
-**OAuth LAN/Remote Fix**— Privat IP-detektering för `redirect_uri` + manuellt URL-läge för fjärrservrar
-**OAuth Behind Nginx**— Använder `window.location.origin` för omvänd proxykompatibilitet
-**Remote OAuth Guide**— Steg-för-steg-guide för Google Cloud-uppgifter på VPS/Docker</details>

<detaljer>
<summary><b>📊 9. "Jag vet inte hur mycket jag spenderar eller var"</b></summary>

Utvecklare använder flera betalleverantörer men har ingen enhetlig syn på utgifter. Varje leverantör har sin egen faktureringspanel, men det finns ingen konsoliderad vy. Oväntade kostnader kan hopa sig.

**Hur OmniRoute löser det:**

-**Kostnadsanalysinstrumentpanel**— Kostnadsspårning per token och budgethantering per leverantör
-**Budgetgränser per nivå**— Utgiftstak per nivå som utlöser automatisk reserv
-**Priskonfiguration per modell**— Konfigurerbara priser per modell
-**Användningsstatistik per API-nyckel**— Antal förfrågningar och senast använda tidsstämpel per nyckel
-**Analytics Dashboard**— Statistikkort, modellanvändningsdiagram, leverantörstabell med framgångsfrekvens och latens</details>

<detaljer>
<summary><b>🐛 10. "Jag kan inte diagnostisera fel och problem i AI-samtal"</b></summary>

När ett samtal misslyckas vet inte utvecklaren om det var en hastighetsgräns, utgången token, fel format eller leverantörsfel. Fragmenterade loggar över olika terminaler. Utan observerbarhet är felsökning att trial-and-error.

**Hur OmniRoute löser det:**

-**Unified Logs Dashboard**— 4 flikar: Request Logs, Proxy Logs, Audit Logs, Console
-**Console Log Viewer**— Viewer i realtid i terminalstil med färgkodade nivåer, automatisk rullning, sökning, filtrering
-**SQLite Proxy-loggar**— Beständiga loggar som överlever serverstarter
-**Translator Playground**— 4 felsökningslägen: Playground (formatöversättning), Chat Tester (tur och retur), Testbänk (batch), Live Monitor (realtid)
-**Request Telemetri**— p50/p95/p99 latens + X-Request-Id-spårning
-**Filbaserad loggning med rotation**— Apploggar roterar efter storlek, lagringsdagar och arkivantal; anropsloggartefakter roterar efter lagringsdagar och filantal
-**System Info Report**— `npm run system-info` genererar `system-info.txt` med din fullständiga miljö (nodversion, OmniRoute-version, OS, CLI-verktyg, Docker/PM2-status). Bifoga den när du rapporterar problem för omedelbar triage.</details>

<detaljer>
<summary><b>🏗️ 11. "Det är komplicerat att distribuera och underhålla gatewayen"</b></summary>

Att installera, konfigurera och underhålla en AI-proxy i olika miljöer (lokalt, VPS, Docker, moln) är arbetskrävande. Problem som hårdkodade sökvägar, "EACCES" på kataloger, portkonflikter och plattformsoberoende konstruktioner ger friktion.

**Hur OmniRoute löser det:**

-**npm global installation**— `npm install -g omniroute && omniroute` – klar
-**Docker Multi-Platform**— AMD64 + ARM64 inbyggt (Apple Silicon, AWS Graviton, Raspberry Pi)
-**Docker Compose Profiles**— 'base' (inga CLI-verktyg) och 'cli' (med Claude Code, Codex, OpenClaw)
-**Electron Desktop App**— Inbyggd app för Windows/macOS/Linux med systemfältet, autostart, offlineläge
-**Split-Port Mode**— API och Dashboard på separata portar för avancerade scenarier (omvänd proxy, containernätverk)
-**Cloud Sync**— Konfigurera synkronisering mellan enheter via Cloudflare Workers
-**DB-säkerhetskopior**— Automatisk säkerhetskopiering, återställning, export och import av alla inställningar, med `DISABLE_SQLITE_AUTO_BACKUP` för externt hanterade säkerhetskopior</details>

<detaljer>
<summary><b>🌍 12. "Gränssnittet är endast engelska och mitt team talar inte engelska"</b></summary>

Lag i icke-engelsktalande länder, särskilt i Latinamerika, Asien och Europa, kämpar med enbart engelska gränssnitt. Språkbarriärer minskar användningen och ökar konfigurationsfelen.

**Hur OmniRoute löser det:**

-**Dashboard i18n — 30 språk**— Alla 500+ nycklar översatta, inklusive arabiska, bulgariska, danska, tyska, spanska, finska, franska, hebreiska, hindi, ungerska, indonesiska, italienska, japanska, koreanska, malaysiska, holländska, norska, polska, portugisiska (PT/BR), rumänska, ryska, thailändska, ukrainska, ukrainska, kinesiska, engelska, ukrainska, vietnamesiska, ukrainska, svenska, ukrainska
-**RTL-stöd**— Höger-till-vänster-stöd för arabiska och hebreiska
-**Multi-Language READMEs**— 30 fullständiga dokumentationsöversättningar
-**Språkväljare**— Globikon i rubriken för växling i realtid</details>

<detaljer>
<summary><b>🔄 13. "Jag behöver mer än chatt — jag behöver inbäddningar, bilder, ljud"</b></summary>

AI är inte bara att slutföra chatt. Utvecklare måste generera bilder, transkribera ljud, skapa inbäddningar för RAG, ranka om dokument och moderera innehåll. Varje API har olika slutpunkt och format.

**Hur OmniRoute löser det:**

-**Inbäddningar**— `/v1/inbäddningar` med 6 leverantörer och 9+ modeller
-**Bildgenerering**— `/v1/images/generations` med 10 leverantörer och 20+ modeller (OpenAI, xAI, Together, Fireworks, Nebius, Hyperbolic, NanoBanana, Antigravity, SD WebUI, ComfyUI)
-**Text-to-Video**— `/v1/videos/generations` — ComfyUI (AnimateDiff, SVD) och SD WebUI
-**Text-to-Music**— `/v1/music/generations` — ComfyUI (Stable Audio Open, MusicGen)
-**Audio Transcription**— `/v1/audio/transcriptions` — Whisper + Nvidia NIM, HuggingFace, Qwen3
-**Text-to-Speech**— `/v1/audio/speech` — ElevenLabs, Nvidia NIM, HuggingFace, Coqui, Tortoise, Qwen3,**Inworld**,**Cartesia**,**PlayHT**, + befintliga leverantörer
-**Moderations**— `/v1/moderations` — Innehållssäkerhetskontroller
-**Omrankning**— `/v1/rerank` — Omrankning av dokumentrelevans
-**Responses API**— Fullständigt `/v1/responses`-stöd för Codex</details>

<detaljer>
<summary><b>🧪 14. "Jag har inget sätt att testa och jämföra kvalitet mellan olika modeller"</b></summary>

Utvecklare vill veta vilken modell som är bäst för deras användningsfall - kod, översättning, resonemang - men det går långsamt att jämföra manuellt. Det finns inga integrerade utvärderingsverktyg.

**Hur OmniRoute löser det:**

-**LLM Evaluations**— Golden set-testning med 10 förinstallerade fall som täcker hälsningar, matematik, geografi, kodgenerering, JSON-efterlevnad, översättning, markdown, säkerhetsvägran
-**4 matchningsstrategier**— "exakt", "innehåller", "regex", "anpassad" (JS-funktion)
-**Translator Playground Test Bench**— Batchtestning med flera ingångar och förväntade utgångar, jämförelse mellan olika leverantörer
-**Chatttestare**— Fullständig tur och retur med visuell responsåtergivning
-**Live Monitor**— Realtidsström av alla förfrågningar som flödar genom proxyn</details>

<detaljer>
<summary><b>📈 15. "Jag behöver skala utan att förlora prestanda"</b></summary>

När förfrågningsvolymen ökar, utan att cachelagra genererar samma frågor dubbla kostnader. Utan idempotens, dubbletter begär avfallshantering. Prisgränser per leverantör måste respekteras.

**Hur OmniRoute löser det:**

-**Semantisk cache**— Tvåskiktscache (signatur + semantisk) minskar kostnaden och fördröjningen
-**Request Idempotency**— 5s dedupliceringsfönster för identiska förfrågningar
-**Rate Limit Detection**— RPM per leverantör, min gap och max samtidig spårning
-**Redigerbara hastighetsgränser**— Konfigurerbara standardinställningar i Inställningar → Motståndskraft med uthållighet
-**API Key Validation Cache**— 3-lagers cache för produktionsprestanda
-**Hälsoinstrumentpanel med telemetri**— p50/p95/p99 latens, cachestatistik, drifttid</details>

<detaljer>
<summary><b>🤖 16. "Jag vill kontrollera modellbeteende globalt"</b></summary>

Utvecklare som vill ha alla svar på ett specifikt språk, med en specifik ton, eller som vill begränsa resonemangstokens. Att konfigurera detta i varje verktyg/förfrågan är opraktiskt.

**Hur OmniRoute löser det:**

-**System Prompt Injection**— Global prompt tillämpas på alla förfrågningar
-**Thinking Budget Validation**— Reasoning token allocation control per request (passthrough, auto, custom, adaptive)
-**9 routingstrategier**— Globala strategier som avgör hur förfrågningar distribueras
-**Wildcard Router**— `provider/*`-mönster dirigerar dynamiskt till vilken leverantör som helst
-**Kombo Aktivera/Inaktivera Växla**— Växla kombinationer direkt från instrumentpanelen
-**Visa leverantör**— Aktivera/inaktivera alla anslutningar för en leverantör med ett klick
-**Blockerade leverantörer**— Exkludera specifika leverantörer från `/v1/models`-listan</details>

<detaljer>
<summary><b>🧰 17. "Jag behöver MCP-verktyg som förstklassiga produktegenskaper"</b></summary>

Många AI-gateways exponerar MCP endast som en dold implementeringsdetalj. Team behöver ett synligt, hanterbart driftlager.

**Hur OmniRoute löser det:**

- MCP visas på navigeringspanelen och fliken för slutpunktsprotokoll
- Dedikerad MCP-hanteringssida med process, verktyg, omfattningar och revision
- Inbyggd snabbstart för `omniroute --mcp` och klientintroduktion</details>

<detaljer>
<summary><b>🧠 18. "Jag behöver A2A-orkestrering med sökvägar för synkronisering och streaming"</b></summary>

Agentarbetsflöden kräver både direkta svar och långvarig streamad exekvering med livscykelkontroll.

**Hur OmniRoute löser det:**

- A2A JSON-RPC-slutpunkt ('POST /a2a') med 'meddelande/sänd' och 'meddelande/ström'
- SSE-strömning med terminaltillståndspridning
- Task lifecycle API:er för "tasks/get" och "tasks/cancel".</details>

<detaljer>
<summary><b>🛰️ 19. "Jag behöver riktig MCP-processhälsa, inte gissad status"</b></summary>

Operativa team måste veta om MCP faktiskt lever, inte bara om ett API är tillgängligt.

**Hur OmniRoute löser det:**

- Runtime heartbeat-fil med PID, tidsstämplar, transport, verktygsräkning och scope-läge
- MCP status API som kombinerar hjärtslag + senaste aktivitet
- UI-statuskort för process/upptid/hjärtslagsnyhet</details>

<detaljer>
<summary><b>📋 20. "Jag behöver granskningsbar MCP-verktygsexekvering"</b></summary>

När verktyg muterar konfiguration eller utlöser operationsåtgärder behöver team rättsmedicinsk spårbarhet.

**Hur OmniRoute löser det:**

- SQLite-stödd revisionsloggning för MCP-verktygsanrop
- Filtrerar efter verktyg, framgång/misslyckande, API-nyckel och paginering
- Dashboard revisionstabell + statistikslutpunkter för automatisering</details>

<detaljer>
<summary><b>🔐 21. "Jag behöver scoped MCP-behörigheter per integration"</b></summary>

Olika klienter bör ha minst privilegierad åtkomst till verktygskategorier.

**Hur OmniRoute löser det:**

- 10 granulära MCP-scopes för kontrollerad verktygsåtkomst
- Tillämpning av omfattning och synlighet i MCP-hanteringsgränssnitt
- Säker standardställning för operativa verktyg</details>

<detaljer>
<summary><b>⚙️ 22. "Jag behöver operativa kontroller utan att omdistribuera"</b></summary>

Team behöver snabba körtidsförändringar under incidenter eller kostnadshändelser.

**Hur OmniRoute löser det:**

- Växla kombinationsaktivering direkt från MCP-instrumentpanelen
- Tillämpa motståndskraftsprofiler från fördefinierade policypaket
- Återställ strömbrytarens tillstånd från samma manöverpanel</details>

<detaljer>
<summary><b>🔄 23. "Jag behöver synlighet och annullering av A2A-uppgiftens livscykel"</b></summary>

Utan livscykelsynlighet blir uppgiftsincidenter svåra att triage.

**Hur OmniRoute löser det:**

- Uppgiftslista/filtrering efter stat/färdighet med sidnumrering
- Drill down på uppgiftens metadata, händelser och artefakter
- Slutpunkt för annullering av uppgifter och gränssnittsåtgärd med bekräftelse</details>

<detaljer>
<summary><b>🌊 24. "Jag behöver aktiv strömningsstatistik för A2A-laddning"</b></summary>

Strömmande arbetsflöden kräver operativ insikt i samtidighet och direktanslutningar.

**Hur OmniRoute löser det:**

- Aktiva strömräknare integrerade i A2A-status
- Senaste uppgiftens tidsstämpel och antal per stat
- A2A instrumentpanelskort för operationsövervakning i realtid</details>

<detaljer>
<summary><b>🪪 25. "Jag behöver standardagentupptäckt för klienter"</b></summary>

Externa klienter och orkestratorer behöver maskinläsbar metadata för onboarding.

**Hur OmniRoute löser det:**

- Agentkort exponerat på `/.well-known/agent.json`
- Förmåga och färdigheter som visas i ledningsgränssnittet
- A2A status API inkluderar upptäcktsmetadata för automatisering</details>

<detaljer>
<summary><b>🧭 26. "Jag behöver protokollupptäckbarhet i produktens UX"</b></summary>

Om användare inte kan upptäcka protokollytor, sjunker kvaliteten på adoption och support.

**Hur OmniRoute löser det:**

- Konsoliderad sida**Endpoints**med flikar för proxy-, MCP-, A2A- och API-slutpunkter
- Inline-tjänststatus växlar (Online/Offline) för MCP och A2A
- Länkar från översikt till dedikerade hanteringsflikar</details>

<detaljer>
<summary><b>🧪 27. "Jag behöver end-to-end protokollvalidering med riktiga klienter"</b></summary>

Mock-tester räcker inte för att validera protokollkompatibilitet före release.

**Hur OmniRoute löser det:**

- E2E-svit som startar appen och använder riktig MCP SDK-klienttransport
- A2A-klient testar för upptäckt, skicka, streama, hämta och avbryta flöden
- Korskontrollera påståenden mot MCP-revision och A2A-uppgifter API:er</details>

<detaljer>
<summary><b>📡 28. "I need unified observability across all interfaces"</b></summary>

Splitting observability by protocol creates blind spots and longer MTTR.

**Hur OmniRoute löser det:**

- Unified dashboards/logs/analytics in one product
- Health + audit + request telemetry across OpenAI, MCP, and A2A layers
- Operational APIs for status and automation</details>

<detaljer>
<summary><b>💼 29. "Jag behöver en körtid för proxy + verktyg + agentorkestrering"</b></summary>

Att köra många separata tjänster ökar driftskostnaderna och fellägen.

**Hur OmniRoute löser det:**

- OpenAI-kompatibel proxy, MCP-server och A2A-server i en stack
- Delad autentisering, resiliens, datalagring och observerbarhet
- Konsekvent policymodell över alla interaktionsytor</details>

<detaljer>
<summary><b>🚀 30. "Jag behöver skicka agentiska arbetsflöden utan limkodsprawl"</b></summary>

Lag tappar hastighet när de sammanfogar flera ad-hoc-tjänster och skript.

**Hur OmniRoute löser det:**

- Enhetlig slutpunktsstrategi för kunder och agenter
- Inbyggda gränssnitt för protokollhantering och rökvalideringsvägar
- Produktionsfärdiga grunder (säkerhet, loggning, resiliens, backup)</details>

### Example Playbooks (Integrated Use Cases)

**Playbook A: Maximera betald prenumeration + billig backup**```txt
Combo: "maximize-claude"
  1. cc/claude-opus-4-6
  2. glm/glm-4.7
  3. if/kimi-k2-thinking

Monthly cost: $20 + small backup spend
Outcome: higher quality, near-zero interruption

Playbook B: Noll-kostnad kodningsstack```txt Combo: "free-forever"

1. gc/gemini-3-flash
2. if/kimi-k2-thinking
3. qw/qwen3-coder-plus

Monthly cost: $0 Outcome: stable free coding workflow

**Playbook C: 24/7 alltid-på reservkedja**```txt
Combo: "always-on"
  1. cc/claude-opus-4-6
  2. cx/gpt-5.2-codex
  3. glm/glm-4.7
  4. minimax/MiniMax-M2.1
  5. if/kimi-k2-thinking

Outcome: deep fallback depth for deadline-critical workloads

Playbook D: Agent ops med MCP + A2A```txt

1. Start MCP transport (omniroute --mcp) for tool-driven operations
2. Run A2A tasks via message/send and message/stream
3. Observe via /dashboard/endpoint (MCP and A2A tabs)
4. Toggle services via inline status controls

---

## 🆓 Start Free — Zero Configuration Cost

> Ställ in AI-kodning på några minuter till**$0/månad**. Anslut dessa gratiskonton och använd den inbyggda**Free Stack**-kombinationen.

| Steg | Åtgärd | Leverantörer olåsta |
| ---- | ---------------------------------------------------------- | -------------------------------------------------------------------------- |
| 1 | Anslut**Kiro**(AWS Builder ID OAuth) | Claude Sonnet 4.5, Haiku 4.5 —**obegränsad**|
| 2 | Anslut**Qoder**(Google OAuth) | kimi-k2-tänkande, qwen3-coder-plus, deepseek-r1... —**obegränsat**|
| 3 | Anslut**Qwen**(enhetskod) | qwen3-coder-plus, qwen3-coder-flash... —**obegränsat**|
| 4 | Anslut**Gemini CLI**(Google OAuth) | gemini-3-flash, gemini-2.5-pro —**180K/månad gratis**|
| 5 | `/dashboard/combos` →**Gratis stack ($0)**mall | Round-robin alla gratis leverantörer automatiskt |

**Peka valfri IDE/CLI till:**`http://localhost:20128/v1` · API-nyckel: `any-string` · Klar.

>**Valfri extra täckning (också gratis):**Groq API-nyckel (30 rpm gratis), NVIDIA NIM (40 rpm gratis, 70+ modeller), Cerebras (1M tok/dag), LongCat API-nyckel (50M tokens/dag!), Cloudflare Workers AI (10K Neurons/day, 50+ modeller).## Snabbstart

### 1) Install and run

```bash
npm install -g omniroute
omniroute

**pnpm-användare:**Kör pnpm approve-builds -g efter installationen för att aktivera inbyggda byggskript som krävs av bättre-sqlite3 och @swc/core:

pnpm installera -g omniroute
pnpm approve-builds -g # Välj alla paket → godkänn
omniroute

Dashboard öppnas på http://localhost:20128 och API-bas-URL är http://localhost:20128/v1.

Kommando	Beskrivning
omniroute	Startserver (PORT=20128, API och instrumentpanel på samma port)
omniroute --port 3000	Ställ in kanonisk/API-port till 3000
omniroute --mcp	Starta MCP-server (stdio-transport)
omniroute --no-open	Öppna inte webbläsaren automatiskt
omniroute --hjälp	Visa hjälp

Valfritt läge med delad port:```bash PORT=20128 DASHBOARD_PORT=20129 omniroute

API: http://localhost:20128/v1

Dashboard: http://localhost:20129

### Long-Running Streaming Timeouts

För de flesta distributioner behöver du bara:

| Variabel | Standard | Syfte |
| ------------------------ | ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------ |
| `REQUEST_TIMEOUT_MS` | `600000` | Delad baslinje för uppströmshämtning, dolda Undici-timeouter, TLS-fingeravtrycksbegäranden och API-bryggbegäran/proxy-timeout |
| `STREAM_IDLE_TIMEOUT_MS` | ärver `REQUEST_TIMEOUT_MS` | Maximalt gap mellan strömmande delar innan OmniRoute avbryter SSE-strömmen |

Bakåtkompatibilitet bevaras: befintliga `FETCH_TIMEOUT_MS`, `API_BRIDGE_PROXY_TIMEOUT_MS` och andra tidsgränser per lager fungerar fortfarande och åsidosätter den delade baslinjen.

Avancerade åsidosättningar är tillgängliga om du behöver bättre kontroll:| Variabel | Standard | Syfte |
| ------------------------------------------ | ------------------------------------------ | ---------------------------------------------------------------------------- |
| `FETCH_TIMEOUT_MS` | ärver `REQUEST_TIMEOUT_MS` | Total uppströms begäran timeout som används av huvudhämtningsavbrytsignalen |
| `FETCH_HEADERS_TIMEOUT_MS` | ärver `FETCH_TIMEOUT_MS` | Undici tidsgräns för att ta emot uppströms svarsrubriker |
| `FETCH_BODY_TIMEOUT_MS` | ärver `FETCH_TIMEOUT_MS` | Undici tidsgräns mellan uppströms kroppsdelar (`0` inaktiverar den) |
| `FETCH_CONNECT_TIMEOUT_MS` | `30 000` | Undici TCP anslutning timeout |
| `FETCH_KEEPALIVE_TIMEOUT_MS` | `4000` | Undici idle keep-alive socket timeout |
| `TLS_CLIENT_TIMEOUT_MS` | ärver `FETCH_TIMEOUT_MS` | Timeout för TLS-fingeravtrycksbegäranden gjorda via `wreq-js` |
| `API_BRIDGE_PROXY_TIMEOUT_MS` | ärver `REQUEST_TIMEOUT_MS` eller `30000` | Timeout för `/v1` proxy-vidarebefordran från API-port till instrumentpanelsport |
| `API_BRIDGE_SERVER_REQUEST_TIMEOUT_MS` | `max(API_BRIDGE_PROXY_TIMEOUT_MS, 300000)` | Timeout för inkommande begäran på API-bryggservern |
| `API_BRIDGE_SERVER_HEADERS_TIMEOUT_MS` | `60 000` | Timeout för inkommande rubrik på API-bryggservern |
| `API_BRIDGE_SERVER_KEEPALIVE_TIMEOUT_MS` | `5000` | Keep-alive timeout på API-bryggservern |
| `API_BRIDGE_SERVER_SOCKET_TIMEOUT_MS` | `0` | Socket inaktivitet timeout på API-bryggservern (`0` inaktiverar den) |

Om du kör OmniRoute bakom Nginx, Caddy, Cloudflare eller annan omvänd proxy, se till att proxyn
timeouts är också högre än dina OmniRoute-strömnings-/hämtningstider.### 2) Connect providers and create your API key

1. Öppna Dashboard → `Providers` och anslut minst en leverantör (OAuth- eller API-nyckel).
2. Öppna Dashboard → `Endpoints` och skapa en API-nyckel.
3. (Valfritt) Öppna Dashboard → `Combos` och ställ in din reservkedja.### 3) Point your coding tool to OmniRoute

```txt
Base URL: http://localhost:20128/v1
API Key:  [copy from Endpoint page]
Model:    if/kimi-k2-thinking (or any provider/model prefix)

Fungerar med Claude Code, Codex CLI, Gemini CLI, Cursor, Cline, OpenClaw, OpenCode och OpenAI-kompatibla SDK:er.### 4) Enable and validate protocols (v2.0)

MCP (för verktygsdrivna operationer):```bash omniroute --mcp

Anslut sedan din MCP-klient över "stdio" och testverktyg som:

- `omniroute_get_health`
- `omniroute_list_combos`

**A2A (för agent-till-agent-arbetsflöden):**```bash
curl http://localhost:20128/.well-known/agent.json

curl -X POST http://localhost:20128/a2a \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":"quickstart","method":"message/send","params":{"skill":"quota-management","messages":[{"role":"user","content":"Give me a short quota summary."}]}}'

5) Validate everything end-to-end (recommended)

npm run test:protocols:e2e

Denna svit validerar riktiga MCP- och A2A-klientflöden mot en app som körs.### Alternative: run from source

cp .env.example .env
npm install
PORT=20128 DASHBOARD_PORT=20129 NEXT_PUBLIC_BASE_URL=http://localhost:20129 npm run dev

Ogiltigt Linux (`xbps-src`-mall)

För Void Linux-användare kan du bygga ett inbyggt paket med xbps-src. Spara detta block som srcpkgs/omniroute/template:```bash

Template file for 'omniroute'

pkgname=omniroute version=3.4.1 revision=1 hostmakedepends="nodejs python3 make" depends="openssl" short_desc="Universal AI gateway with smart routing for multiple LLM providers" maintainer="zenobit zenobit@disroot.org" license="MIT" homepage="https://github.com/diegosouzapw/OmniRoute" distfiles="https://github.com/diegosouzapw/OmniRoute/archive/refs/tags/v${version}.tar.gz" checksum=009400afee90a9f32599d8fe734145cfd84098140b7287990183dde45ae2245b system_accounts="_omniroute" omniroute_homedir="/var/lib/omniroute" export NODE_ENV=production export npm_config_engine_strict=false export npm_config_loglevel=error export npm_config_fund=false export npm_config_audit=false

do_build() { # Determine target CPU arch for node-gyp local _gyp_arch case "$XBPS_TARGET_MACHINE" in aarch64*) _gyp_arch=arm64 ;; armv7*|armv6*) _gyp_arch=arm ;; i686*) _gyp_arch=ia32 ;; *) _gyp_arch=x64 ;; esac

# 1) Install all deps – skip scripts (no network in do_build, native modules
#    compiled separately below; better-sqlite3 is serverExternalPackage so
#    Next.js does not execute it during next build)
NODE_ENV=development npm ci --ignore-scripts

# 2) Build the Next.js standalone bundle
npm run build

# 3) Copy static assets into standalone
cp -r .next/static .next/standalone/.next/static
[ -d public ] && cp -r public .next/standalone/public || true

# 4) Compile better-sqlite3 native binding for the target architecture.
#    Use node-gyp directly so CC/CXX from xbps-src cross-toolchain are used
#    without npm altering them.
local _node_gyp=/usr/lib/node_modules/npm/node_modules/node-gyp/bin/node-gyp.js
(cd node_modules/better-sqlite3 && node "$_node_gyp" rebuild --arch="$_gyp_arch")

# 5) Place the compiled binding into the standalone bundle
local _bs3_release=.next/standalone/node_modules/better-sqlite3/build/Release
mkdir -p "$_bs3_release"
cp node_modules/better-sqlite3/build/Release/better_sqlite3.node "$_bs3_release/"

# 6) Remove arch-specific sharp bundles – upstream sets images.unoptimized=true
#    so sharp is not used at runtime; x64 .so files would break aarch64 strip
rm -rf .next/standalone/node_modules/@img

# 7) Copy pino runtime deps omitted by Next.js static analysis:
#    pino-abstract-transport – required by pino's worker thread
#    split2 – dep of pino-abstract-transport
#    process-warning – dep of pino itself
for _mod in pino-abstract-transport split2 process-warning; do
	cp -r "node_modules/$_mod" .next/standalone/node_modules/
done

}

do_check() { npm run test:unit }

do_install() { vmkdir usr/lib/omniroute/.next

vcopy .next/standalone/. usr/lib/omniroute/.next/standalone

# Prevent removal of empty Next.js app router dirs by the post-install hook
for _d in \
	.next/standalone/.next/server/app/dashboard \
	.next/standalone/.next/server/app/dashboard/settings \
	.next/standalone/.next/server/app/dashboard/providers; do
	touch "${DESTDIR}/usr/lib/omniroute/${_d}/.keep"
done

cat > "${WRKDIR}/omniroute" <<'EOF'

#!/bin/sh export PORT="${PORT:-20128}" export DATA_DIR="${DATA_DIR:-${XDG_DATA_HOME:-${HOME}/.local/share}/omniroute}" export LOG_TO_FILE="${LOG_TO_FILE:-false}" mkdir -p "${DATA_DIR}" exec node /usr/lib/omniroute/.next/standalone/server.js "$@" EOF vbin "${WRKDIR}/omniroute" }

post_install() { vlicense LICENSE }

</details>

---

## 🐳 Docker

OmniRoute är tillgänglig som en offentlig Docker-bild på [Docker Hub](https://hub.docker.com/r/diegosouzapw/omniroute).

**Snabbkörning:**```bash
docker run -d \
  --name omniroute \
  --restart unless-stopped \
  --stop-timeout 40 \
  -p 20128:20128 \
  -v omniroute-data:/app/data \
  diegosouzapw/omniroute:latest

Med miljöfil:```bash

Copy and edit .env first

cp .env.example .env

docker run -d
--name omniroute
--restart unless-stopped
--stop-timeout 40
--env-file .env
-p 20128:20128
-v omniroute-data:/app/data
diegosouzapw/omniroute:latest

**Använda Docker Compose:**```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

Dashboard-stöd för Docker-distributioner inkluderar nu enCloudflare Quick Tunnelmed ett klick på Dashboard → Endpoints. Den första aktiveringen laddar ner cloudflared endast när det behövs, startar en tillfällig tunnel till din nuvarande /v1-slutpunkt och visar den genererade https://*.trycloudflare.com/v1-URL:n direkt under din vanliga offentliga URL.

Anmärkningar:

• Quick Tunnel-URL:er är tillfälliga och ändras efter varje omstart.
• Snabbtunnlar återställs inte automatiskt efter omstart av OmniRoute eller container. Återaktivera dem från instrumentpanelen vid behov.
• Hanterad installation stöder för närvarande Linux, macOS och Windows på x64 / arm64.
• Managed Quick Tunnels standard till HTTP/2-transport för att undvika bullriga QUIC UDP-buffertvarningar i begränsade containermiljöer. Ställ in CLOUDFLARED_PROTOCOL=quic eller auto om du vill ha en annan transport.
• Docker-bilder buntar systemets CA-rötter och skickar dem till hanterade cloudflared, vilket undviker TLS-förtroendefel när tunneln startar inuti behållaren.
• SQLite körs i WAL-läge. dockerstop bör tillåtas avslutas så att OmniRoute kan kontrollera de senaste ändringarna tillbaka till storage.sqlite.
• De medföljande Compose-filerna har redan satt en frist på 40-talet. Om du kör bilden direkt, håll --stop-timeout 40 (eller liknande) så att manuella stopp inte avbryter avstängningsrensningen.
• Ställ in CLOUDFLARED_BIN=/absolute/path/to/cloudflared om du vill att OmniRoute ska använda en befintlig binär istället för att ladda ner en.

Använda Docker Compose med Caddy (HTTPS Auto-TLS):

OmniRoute kan exponeras säkert med Caddys automatiska SSL-provisionering. Se till att din domäns DNS A-post pekar på din servers IP.```yaml services: omniroute: image: diegosouzapw/omniroute:latest container_name: omniroute restart: unless-stopped volumes: - omniroute-data:/app/data environment: - PORT=20128 - NEXT_PUBLIC_BASE_URL=https://your-domain.com

caddy: image: caddy:latest container_name: caddy restart: unless-stopped ports: - "80:80" - "443:443" command: caddy reverse-proxy --from https://your-domain.com --to http://omniroute:20128

volumes: omniroute-data:

| Bild | Tagga | Storlek | Beskrivning |
| ------------------------ | -------- | ------ | ---------------------- |
| `diegosouzapw/omniroute` | `senaste` | ~250MB | Senaste stabila utgåvan |
| `diegosouzapw/omniroute` | `1.0.3` | ~250MB | Aktuell version |---

## 🖥️ Desktop App — Offline & Always-On

> 🆕**NYTT!**OmniRoute är nu tillgängligt som ett**inbyggt skrivbordsprogram**för Windows, macOS och Linux.

Kör OmniRoute som en fristående skrivbordsapp — ingen terminal, ingen webbläsare, inget internet krävs för lokala modeller. Den elektronbaserade appen innehåller:

- 🖥️**Native Window**— Dedikerat appfönster med systemfältsintegration
- 🔄**Autostart**— Starta OmniRoute vid systeminloggning
- 🔔**Native Notifications**— Få varningar om kvotutmattning eller leverantörsproblem
- ⚡**One-Click Install**— NSIS (Windows), DMG (macOS), AppImage (Linux)
- 🌐**Offlineläge**— Fungerar helt offline med medföljande server### Snabbstart

```bash
# Development mode
npm run electron:dev

# Build for your platform
npm run electron:build         # Current platform
npm run electron:build:win     # Windows (.exe)
npm run electron:build:mac     # macOS (.dmg) — x64 & arm64
npm run electron:build:linux   # Linux (.AppImage)

System Tray

När den är minimerad, finns OmniRoute i systemfältet med snabba åtgärder:

• Öppna instrumentpanelen
• Byt serverport
• Avsluta applikationen

📖 Fullständig dokumentation: electron/README.md---

💰 Pricing at a Glance

Nivå	Leverantör	Kostnad	Kvotåterställning	Bäst för
💳 PRENUMERATION	Claude Code (Pro)	20 USD/månad	5h + veckovis	Har redan prenumererat
	Codex (Plus/Pro)	20-200 USD/månad	5h + veckovis	OpenAI-användare
	Gemini CLI	GRATIS	180K/månad + 1K/dag	Alla!
	GitHub Copilot	$10-19/månad	Månatlig	GitHub-användare
🔑 API-NYCKEL	NVIDIA NIM	GRATIS(dev forever)	~40 RPM	70+ öppna modeller
	Cerebras	GRATIS(1M tok/dag)	60K TPM / 30 RPM	Världens snabbaste
	Groq	GRATIS(30 RPM)	14,4K RPD	Ultrasnabba Lama/Gemma
	DeepSeek V3.2	0,27 USD/1,10 USD per 1M	Inga	Bästa pris/kvalitetsresonemang
	xAI Grok-4 Fast	$0,20/$0,50 per 1M🆕	Inga	Snabbast + verktygsanrop, ultralågt
	xAI Grok-4 (standard)	0,20 USD/1,50 USD per 1M 🆕	Inga	Resonerande flaggskepp från xAI
	Mistral	Gratis provperiod + betald	Begränsat pris	Europeisk AI
	OpenRouter	Betala per användning	Inga	100+ modeller aggr.
💰 BILLIGT	GLM-5 (via Z.AI) 🆕	$0,5/1M	Dagligen 10:00	128K-utgång, senaste flaggskeppet
	GLM-4.7	$0,6/1M	Dagligen 10:00	Budget backup
	MiniMax M2.5 🆕	$0,3/1M ingång	5-timmars rullande	Resonemang + agentuppgifter
	MiniMax M2.1	$0,2/1M	5-timmars rullande	Billigaste alternativet
	Kimi K2.5 (Moonshot API) 🆕	Betala per användning	Inga	Direkt åtkomst till Moonshot API
	Kimi K2	9 USD/mån lägenhet	10 miljoner tokens/månad	Förutsägbar kostnad
🆓 GRATIS	Qoder	$0	Obegränsad	5 modeller obegränsat
	Qwen	$0	Obegränsad	4 modeller obegränsat
	Kiro	$0	Obegränsad	Claude Sonnet/Haiku (AWS Builder)
	LongCat Flash-Lite 🆕	$0(50 miljoner tok/dag 🔥)	1 RPS	Största gratiskvoten på jorden
	Pollinationer AI 🆕	$0(ingen nyckel behövs)	1 req/15s	GPT-5, Claude, DeepSeek, Llama 4
	Cloudflare Workers AI 🆕	$0(10 000 neuroner/dag)	~150 resp/dag	50+ modeller, global edge
	Scaleway AI 🆕	$0(1 miljoner tokens totalt)	Begränsat pris	EU/GDPR, Qwen3 235B, Lama 70B	> 🆕**Nya modeller tillagda (mars 2026):**Grok-4 Fast-familjen till $0,20/$0,50/M (benchmarkerad till 1143ms — 30 % snabbare än Gemini 2.5 Flash), GLM-5 via Z.AI med 128K-utgång, MiniMax M2.5-resonemang, DeepSeek2.5-resonemang, KimSeek2.5 updates. direkt API.

💡 $0 Combo Stack — Den kompletta gratis installationen:```

🆓 Ultimate Free Stack 2026 — 11 Providers, $0 Forever

Kiro (kr/) → Claude Sonnet/Haiku UNLIMITED Qoder (if/) → kimi-k2-thinking, qwen3-coder-plus, deepseek-r1 UNLIMITED LongCat Lite (lc/) → LongCat-Flash-Lite — 50M tokens/day 🔥 Pollinations (pol/) → GPT-5, Claude, DeepSeek, Llama 4 — no key needed Qwen (qw/) → qwen3-coder-plus, qwen3-coder-flash, qwen3-coder-next UNLIMITED Gemini (gemini/) → Gemini 2.5 Flash — 1,500 req/day free API key Cloudflare AI (cf/) → Llama 70B, Gemma 3, Mistral — 10K Neurons/day Scaleway (scw/) → Qwen3 235B, Llama 70B — 1M free tokens (EU) Groq (groq/) → Llama/Gemma ultra-fast — 14.4K req/day NVIDIA NIM (nvidia/) → 70+ open models — 40 RPM forever Cerebras (cerebras/) → Llama/Qwen world-fastest — 1M tok/day

**Noll kostnad. Slutar aldrig koda.**Konfigurera detta som en OmniRoute-kombination och alla fallbacks sker automatiskt – ingen manuell växling någonsin.---

---

## 🆓 Free Models — What You Actually Get

> Alla modeller nedan är**100 % gratis utan kreditkort krävs**. OmniRoute dirigerar automatiskt mellan dem när en kvot tar slut — kombinera dem alla för en okrossbar 0 $-kombination.### 🔵 CLAUDE MODELS (via Kiro — AWS Builder ID)

| Modell | Prefix | Begränsa | Prisgräns |
| ------------------ | ------ | ------------- | ---------------------- |
| `claude-sonnet-4.5` | `kr/` |**Obegränsat**| Inget rapporterat dagligt tak |
| `claude-haiku-4.5` | `kr/` |**Obegränsat**| Inget rapporterat dagligt tak |
| `claude-opus-4.6` | `kr/` |**Obegränsat**| Senaste Opus via Kiro |### 🟢 QODER MODELS (Free PAT via qodercli)

| Modell | Prefix | Begränsa | Prisgräns |
| ------------------ | ------ | ------------- | --------------- |
| `kimi-k2-tänkande` | `om/` |**Obegränsat**| Inget rapporterat tak |
| `qwen3-coder-plus` | `om/` |**Obegränsat**| Inget rapporterat tak |
| `deepseek-r1` | `om/` |**Obegränsat**| Inget rapporterat tak |
| `minimax-m2.1` | `om/` |**Obegränsat**| Inget rapporterat tak |
| `kimi-k2` | `om/` |**Obegränsat**| Inget rapporterat tak |

> Rekommenderad anslutningsmetod:**Personal Access Token + `qodercli`**. Webbläsarens OAuth är
> experimentell och inaktiverad som standard om inte `QODER_OAUTH_*` miljövariabler är konfigurerade.### 🟡 QWEN MODELS (Device Code Auth)

| Modell | Prefix | Begränsa | Prisgräns |
| ------------------ | ------ | ------------- | ------------------ |
| `qwen3-coder-plus` | `qw/` |**Obegränsat**| Inget rapporterat tak |
| `qwen3-coder-flash` | `qw/` |**Obegränsat**| Inget rapporterat tak |
| `qwen3-coder-next` | `qw/` |**Obegränsat**| Inget rapporterat tak |
| `vision-modell` | `qw/` |**Obegränsat**| Multimodal (bilder) |### 🟣 GEMINI CLI (Google OAuth)

| Modell | Prefix | Begränsa | Prisgräns |
| ------------------------ | ------ | -------------------------- | ------------- |
| `gemini-3-flash-preview` | `gc/` |**180K tok/månad**+ 1K/dag | Månatlig återställning |
| `gemini-2.5-pro` | `gc/` | 180K/månad (delad pool) | Hög kvalitet |### ⚫ NVIDIA NIM (Free API Key — build.nvidia.com)

| Nivå | Daglig gräns | Prisgräns | Anteckningar |
| ---------- | ------------ | ----------- | -------------------------------------------------------------- |
| Gratis (Dev) | Ingen token cap |**~40 RPM**| 70+ modeller; övergång till rena räntegränser i mitten av 2025 |

Populära gratismodeller: `moonshotai/kimi-k2.5` (Kimi K2.5), `z-ai/glm4.7` (GLM 4.7), `deepseek-ai/deepseek-v3.2` (DeepSeek V3.2), `nvidia/llama-3.3-70b-seek-instruct`/`deepseek-seek-/`### ⚪ CEREBRAS (Free API Key — inference.cerebras.ai)

| Nivå | Daglig gräns | Prisgräns | Anteckningar |
| ---- | ------------------ | ---------------- | -------------------------------------------------- |
| Gratis |**1M tokens/dag**| 60K TPM / 30 RPM | Världens snabbaste LLM slutledning; återställs dagligen |

Tillgängligt gratis: `llama-3.3-70b`, `llama-3.1-8b`, `deepseek-r1-destill-llama-70b`### 🔴 GROQ (Free API Key — console.groq.com)

| Nivå | Daglig gräns | Prisgräns | Anteckningar |
| ---- | ------------- | ---------------- | ------------------------------------------ |
| Gratis |**14,4K RPD**| 30 RPM per modell | Inget kreditkort; 429 på gräns, inte debiterad |

Tillgängligt gratis: `llama-3.3-70b-versatile`, `gemma2-9b-it`, `mixtral-8x7b`, `whisper-large-v3`### 🔴 LONGCAT AI (Free API Key — longcat.chat) 🆕

| Modell | Prefix | Daglig gratiskvot | Anteckningar |
| ------------------------------ | ------ | ------------------ | ---------------------------- |
| `LongCat-Flash-Lite` | `lc/` |**50 miljoner tokens**💥 | Största gratiskvoten någonsin |
| `LongCat-Flash-Chat` | `lc/` | 500 000 tokens | Multi-turn chat |
| `LongCat-Flash-Thinking` | `lc/` | 500 000 tokens | Resonemang / CoT |
| `LongCat-Flash-Thinking-2601` | `lc/` | 500 000 tokens | Jan 2026 version |
| `LongCat-Flash-Omni-2603` | `lc/` | 500 000 tokens | Multimodal |

> 100 % gratis medan den är i offentlig beta. Registrera dig på [longcat.chat](https://longcat.chat) med e-post eller telefon. Återställs dagligen 00:00 UTC.### 🟢 POLLINATIONS AI (No API Key Required) 🆕

| Modell | Prefix | Prisgräns | Provider bakom |
| ---------- | ------ | ---------- | ------------------ |
| `openai` | `pol/` | 1 req/15s | GPT-5 |
| `claude` | `pol/` | 1 req/15s | Antropisk Claude |
| "tvillingarna" | `pol/` | 1 req/15s | Google Tvillingarna |
| `deepseek` | `pol/` | 1 req/15s | DeepSeek V3 |
| `llama` | `pol/` | 1 req/15s | Meta Llama 4 Scout |
| `mistral` | `pol/` | 1 req/15s | Mistral AI |

> ✨**Noll friktion:**Ingen registrering, ingen API-nyckel. Lägg till pollineringsleverantören med ett tomt nyckelfält så fungerar det direkt.### 🟠 CLOUDFLARE WORKERS AI (Free API Key — cloudflare.com) 🆕

| Nivå | Dagliga neuroner | Likvärdig användning | Anteckningar |
| ---- | ------------- | ----------------------------------------------- | ---------------------------- |
| Gratis |**10 000**| ~150 LLM resp / 500-tals ljud / 15K inbäddningar | Global edge, 50+ modeller |

Populära gratismodeller: `@cf/meta/llama-3.3-70b-instruct`, `@cf/google/gemma-3-12b-it`, `@cf/openai/whisper-large-v3-turbo` (gratis ljud!), `@cf/qwen/qwen2.5-coder-15b-instruct`

> Kräver API-token + konto-ID från [dash.cloudflare.com](https://dash.cloudflare.com). Lagra konto-ID i leverantörsinställningar.### 🟣 SCALEWAY AI (1M Free Tokens — scaleway.com) 🆕

| Nivå | Gratis kvot | Plats | Anteckningar |
| ---- | ------------- | ------------ | ------------------------------------------ |
| Gratis |**1M tokens**| 🇫🇷 Paris, EU | Inget kreditkort behövs inom gränserna |

Tillgängligt gratis: `qwen3-235b-a22b-instruct-2507` (Qwen3 235B!), `llama-3.1-70b-instruct`, `mistral-small-3.2-24b-instruct-2506`, `deepseek-v3-0324`

> EU/GDPR-kompatibel. Hämta API-nyckel på [console.scaleway.com](https://console.scaleway.com).

>**💡 Den ultimata gratisstacken (11 leverantörer, $0 för alltid):**
>
> ```
> Kiro (kr/) → Claude Sonnet/Haiku UNLIMITED
> Qoder (om/) → kimi-k2-tänkande, qwen3-coder-plus, deepseek-r1 UNLIMITED
> LongCat Lite (lc/) → LongCat-Flash-Lite — 50 miljoner tokens/dag 🔥
> Pollinationer (pol/) → GPT-5, Claude, DeepSeek, Llama 4 — ingen nyckel behövs
> Qwen (qw/) → qwen3-kodarmodeller OBEGRÄNSAT
> Gemini (gemini/) → Gemini 2.5 Flash — 1 500 req/dag gratis
> Cloudflare AI (jfr/) → 50+ modeller — 10K neuroner/dag
> Scaleway (scw/) → Qwen3 235B, Llama 70B — 1M gratis tokens (EU)
> Groq (groq/) → Lama/Gemma — 14,4K req/dag ultrasnabb
> NVIDIA NIM (nvidia/) → 70+ öppna modeller — 40 RPM för alltid
> Cerebras (cerebras/) → Lama/Qwen världens snabbaste — 1M tok/dag
> ```## 🎙️ Free Transcription Combo

> Transkribera valfritt ljud/video för**$0**— Deepgram leads med $200 gratis, AssemblyAI $50 reserv, Groq Whisper som obegränsad nödbackup.

| Leverantör | Gratis krediter | Bästa modellen | Prisgräns |
| ------------------ | ---------------------------- | -------------------------------------------- | ---------------------------- |
|**Deepgram**|**$200 gratis**(registrering) | `nova-3` — bästa noggrannhet, 30+ språk | Ingen RPM-gräns på gratis krediter |
| 🔵**AssemblyAI**|**$50 gratis**(registrering) | "universal-3-pro" — kapitel, sentiment, PII | Ingen RPM-gräns på gratis krediter |
| 🔴**Groq**|**Fri för alltid**| `whisper-large-v3` — OpenAI Whisper | 30 RPM (hastighetsbegränsad) |

**Föreslagen kombination i `/dashboard/combos`:**```
Name: free-transcription
Strategy: Priority
Nodes:
  [1] deepgram/nova-3          → uses $200 free first
  [2] assemblyai/universal-3-pro → fallback when Deepgram credits run out
  [3] groq/whisper-large-v3    → free forever, emergency fallback

Sedan i /dashboard/media → flikenTranskription: ladda upp valfri ljud- eller videofil → välj din kombinationsslutpunkt → hämta transkription i format som stöds.## 💡 Key Features

OmniRoute v2.0 är byggd som en operativ plattform, inte bara en reläproxy.### 🆕 New — ClawRouter-Inspired Improvements (Mar 2026)

Funktion	Vad det gör
⚡Grok-4 Fast Family	xAI-modeller för $0,20/$0,50/M — benchmarkerade 1143ms (30 % snabbare än Gemini 2,5 Flash)
🧠GLM-5 via Z.AI	128K utdatakontext, $0,5/1M — senaste flaggskeppet från GLM-familjen
🔮MiniMax M2.5	Resonemang + agentuppgifter för $0,30/1M — betydande uppgradering från M2.1
🎯verktyg Calling Flag per modell	Per modell 'toolCalling: true/false' i registret — AutoCombo hoppar över modeller som inte har verktygskapacitet
🌍Flerspråkig avsiktsdetektering	PT/ZH/ES/AR-nyckelord i AutoCombo-poängsättning — bättre modellval för icke-engelsk innehåll
📊Benchmarkdrivna fallbacks	Verklig p95 latens från liveförfrågningar feeds combo scoring — AutoCombo lär sig av faktiska data
🔁Begär deduplicering	Innehållshashbaserat dedup-fönster – säker för flera agenter, förhindrar dubbletter av avgifter
🔌Strategi för pluggbar router	Utökningsbart RouterStrategy-gränssnitt — lägg till anpassad routinglogik som plugins	### 🚀 Previous v2.0.9+ — Playground, CLI Fingerprints & ACP

Funktion	Vad det gör
🎮Modell lekplats	Dashboard-sida för att testa alla modeller direkt — leverantör/modell/slutpunktsväljare, Monaco Editor, streaming, avbryt, timing
🔏CLI Fingerprint Matching	Beställning av rubrik/kropp per leverantör för att matcha inbyggda CLI-signaturer – växla per leverantör i Inställningar > Säkerhet.Din proxy-IP bevaras
🤝ACP Support (Agent Client Protocol)	CLI-agentupptäckt (Codex, Claude, Goose, Gemini CLI, OpenClaw + 9 till), process spawner, /api/acp/agents slutpunkt
🤖ACP Agents Dashboard	Debug › Agentsida — rutnät med 14 agenter med installationsstatus, version, anpassad agentform för alla CLI-verktyg.OpenCode-användare får en "Ladda ner opencode.json"-knapp som automatiskt genererar en färdig att använda konfiguration med alla tillgängliga modeller.
🔧Anpassad modell apiFormat Routing	Anpassade modeller med apiFormat: "responses" dirigeras nu korrekt till Responses API-översättaren
🏢Codex Workspace Isolation	Flera Codex-arbetsytor per e-post — OAuth separerar anslutningar korrekt efter arbetsyte-ID
🔄Automatisk uppdatering av elektroner	Skrivbordsapp söker efter uppdateringar + automatisk installation vid omstart	### 🤖 Agent & Protocol Operations (v2.0)

Funktion	Vad det gör
🔧MCP-server (25 verktyg)	IDE/agent-verktyg via 3 transporter: stdio, SSE (/api/mcp/sse), Streamable HTTP (/api/mcp/stream). 18 kärnor + 3 minne + 4 färdighetsverktyg
🤝A2A-server (JSON-RPC + SSE)	Agent-till-agent-uppgiftskörning med synkroniserings- och streamingflöden
🧭Konsoliderade slutpunkterssida	Hanteringssida med flikar med flikarna Endpoint Proxy, MCP, A2A och API Endpoints
🎚️Service aktivera/inaktivera växlar	ON/OFF-omkopplare för MCP och A2A med inställningsbeständighet (standard: OFF)
🛰️MCP Runtime Heartbeat	Verklig processstatus (pid, drifttid, hjärtslagsålder, transport, omfångsläge)
📋MCP Audit Trail	Filtrerbara granskningsloggar med framgång/misslyckande och nyckeltillskrivning
🔐MCP Scope Enforcement	10 granulära scope-behörigheter för kontrollerad verktygsåtkomst
📡A2A Task Lifecycle Management	Lista/filtrera uppgifter, inspektera händelser/artefakter, avbryt pågående uppgifter
📋Agent Card Discovery	/.well-known/agent.json för automatisk upptäckt av klient
🧪Protokoll E2E testsele	Verkliga MCP SDK + A2A-klientflöden i test:protocols:e2e
⚙️Driftskontroller	Switch combo, applicera elasticitetsprofiler, återställ brytare från en kontrollyta	### 🧠 Routing & Intelligence

Funktion	Vad det gör
🎯Smart 4-lagers reserv	Automatisk rutt: Prenumeration → API-nyckel → Billigt → Gratis
📊Kvotspårning i realtid	Live token count + återställ nedräkning per leverantör
🔄Formatöversättning	OpenAI ↔ Claude ↔ Gemini ↔ Svar med schemasäkra konverteringar
👥Multi-Account Support	Flera konton per leverantör med intelligent urval
🔄Auto Token Refresh	OAuth-tokens uppdateras automatiskt med försök igen
🎨Anpassade kombinationer	9 balanseringsstrategier + reservkedjekontroll
🌐Wildcard-router	provider/* dynamisk routing
🧠Tänker på budgetkontroller	Gränser för passthrough, auto, anpassade och adaptiva resonemang
🔀Modellalias	Inbyggd + anpassad modellaliasing och migreringssäkerhet
⚡Bakgrundsförsämring	Rikta lågprioriterade bakgrundsuppgifter till billigare modeller
🧪Task-Aware Smart Routing	Välj modell automatiskt efter innehållstyp (kodning/vision/analys/sammanfattning)
🔄A2A Agent Workflows	Deterministisk FSM-orkestrator för statistiska agentavrättningar i flera steg
🔀Adaptiv routing	Dynamisk strategiöverstyrning baserad på tokenvolym och promptkomplexitet
🎲Provider Mångfald	Shannon entropi poäng balanserar auto-combo trafikdistribution
💬System Prompt Injection	Globala beteendekontroller tillämpas konsekvent
📄Responses API-kompatibilitet	Fullständigt /v1/responses-stöd för Codex och avancerade agentarbetsflöden	### 🎵 Multi-Modal APIs

Funktion	Vad det gör
🖼️Bildgenerering	/v1/images/generations med moln och lokala backends
📐Inbäddningar	/v1/embeddings för sök- och RAG-pipelines
🎤Ljudtranskription	/v1/audio/transcriptions — 7 leverantörer (Deepgram Nova 3, AssemblyAI, Groq Whisper, HuggingFace, ElevenLabs, OpenAI, Azure), automatisk språkdetektering, MP4/MP3/WAV-stöd
🔊Text-till-tal	/v1/audio/speech — 10 leverantörer (ElevenLabs, OpenAI, Deepgram, Cartesia, PlayHT, HuggingFace, Nvidia NIM, Inworld, Coqui, Tortoise) med korrekta felmeddelanden
🎬Videogenerering	/v1/videos/generations (ComfyUI + SD WebUI-arbetsflöden)
🎵Music Generation	/v1/music/generations (ComfyUI-arbetsflöden)
🛡️Moderationer	/v1/moderations säkerhetskontroller
🔀Omrankning	/v1/rerank för relevanspoäng
🔍Webbsökning🆕	/v1/search — 5 leverantörer (Serper, Brave, Perplexity, Exa, Tavily), 6 500+ gratis/månad, auto-failover, cache	### 🛡️ Resilience, Security & Governance

Funktion	Vad det gör
🔌Cremsbrytare	Per modell trip/återhämtning med tröskelkontroller
🎯Endpoint-Aware Models	Anpassade modeller deklarerar stödda slutpunkter + API-format
🛡️Anti-ånflock	Mutex + semaforskydd vid återförsök/hastighetshändelser
🧠Semantisk + Signaturcache	Kostnads-/latensminskning med två cachelager
⚡Begär idempotens	Dubblett skyddsfönster
🔒TLS Fingerprint Spoofing	Webbläsarliknande TLS-fingeravtryck —minskar botdetektering och kontoflaggning
🔏CLI Fingerprint Matching	Matchar inbyggda CLI-begäransignaturer —minskar förbudsrisken samtidigt som proxy-IP bevaras
🌐IP-filtrering	Kontroll av tillåtelse/blockeringslista för exponerade distributioner
📊Redigerbara hastighetsgränser	Konfigurerbara globala/leverantörsnivågränser med beständighet
📉Graciös nedbrytning	Reserver med flerskiktskapacitet som skyddar kärn-gatewayoperationer
📜Config Audit Trail	Diff-baserad ändringsspårning förhindrar driftdrift med enkla rollbacks
⏳Provider Health Sync	Proaktiv övervakning av tokens utgång som utlöser varningar före auktoriseringsfel
🚪Auto-inaktivera förbjudna konton	Funktionsbrytare tätar permanent blockerade tokenkonton automatiskt
🔑API Key Management + Scoping	Säker nyckelutgivning/rotation och modell/leverantörskontroller
👁️Omfattad API-nyckel avslöja🆕	Opt-in återställning av API-nycklar via ALLOW_API_KEY_REVEAL
🛡️Skyddade /modeller	Valfri autentisering och leverantörsdöljning för modellkatalog	### 📊 Observability & Analytics

Funktion	Vad det gör
📝Begäran + proxyloggning	Fullständig begäran/svar och proxyloggning
📉Strömmade detaljerade loggar🆕	Rekonstruerar SSE-nyttolastströmmar rent in i användargränssnittet
📋Unified Logs Dashboard	Begäran, proxy, revision och konsolvyer på en sida
🔍Begär telemetri	p50/p95/p99 latens och spårning av begäran
🏥Hälsoinstrumentpanel	Drifttid, brytartillstånd, lockouter, cachestatistik
💰Kostnadsspårning	Budgetkontroller och prissättning per modell
📈Analytiska visualiseringar	Modell-/leverantörsanvändningsinsikter och trendvyer
🧪Utvärderingsram	Golden set-testning med konfigurerbara matchstrategier
📡Live Diagnostics🆕	Semantisk cache-bypass för exakt combo live-testning	### ☁️ Deployment & Platform

Funktion	Vad det gör
🌐Distribuera var som helst	Localhost, VPS, Docker, Molnmiljöer
🚇Cloudflare Tunnel🆕	Snabbtunnelintegrering med ett klick från instrumentpanelen
🔑API-nyckelmodellfiltrering	Native /v1/models-svar filtreras via tilldelade bärarkontextroller
⚡Smart Cache Bypass	Konfigurerbar TTL-heuristik och tvingade återhämtningskontroller
🔄Säkerhetskopiering/återställning	Export/import och katastrofåterställningsflöden
🧙Onboarding Wizard	Första körningen guidad installation
🔧CLI Tools Dashboard	Inställning med ett klick för populära kodningsverktyg
🎮Modell lekplats	Testa valfri leverantör/modell/slutpunkt från instrumentpanelen
🔏CLI Fingerprint Toggle	Fingeravtrycksmatchning per leverantör i Inställningar > Säkerhet
🌐i18n (30 språk)	Fullständig instrumentpanel + stöd för dokumentspråk med RTL-täckning
🧹Rensa alla modeller	Rensa modelllistan med ett klick i leverantörsinformation
👁️Sidofältskontroller🆕	Dölj komponenter och integrationer från Utseendeinställningar
📋Utgåvamallar	Standardiserade GitHub-mallar för buggar och funktioner
📂Anpassad datakatalog	DATA_DIR åsidosättande för lagringsplats	### Feature Deep Dive

Smart fallback with practical cost control

Combo: "my-coding-stack"
  1. cc/claude-opus-4-6
  2. nvidia/llama-3.3-70b
  3. glm/glm-4.7
  4. if/kimi-k2-thinking

När kvot, ränta eller hälsa misslyckas, flyttar OmniRoute automatiskt till nästa kandidat utan manuell växling.#### Protocol management that is visible and operable

• MCP + A2A kan upptäckas i användargränssnitt och dokument (inte dolda)
• Protokollstatus-API:er exponerar live operationsdata (/api/mcp/*, /api/a2a/*)
• Dashboards inkluderar åtgärder för dag-2 operationer (kombinationsväxlingar, återställning av brytare, avbokning av uppgifter)#### Translator + validation workflow

Översättarområdet inkluderar:

-Lekplats: begär omvandlingskontroller -Chatttestare: fullständig begäran/svar tur och retur -Testbänk: flera fall i en körning -Live Monitor: trafikvy i realtid

Plus protokollvalidering med riktiga klienter via npm run test:protocols:e2e.

📖MCP Server README— Verktygsreferens, IDE-konfigurationer och klientexempel

📖A2A Server README— Färdigheter, JSON-RPC-metoder, streaming och uppgiftslivscykel## 🧪 Evaluations (Evals)

OmniRoute inkluderar ett inbyggt utvärderingsramverk för att testa LLM-svarskvalitet mot en gyllene uppsättning. Få åtkomst till den viaAnalytics → Evalsi instrumentpanelen.### Built-in Golden Set

Det förinstallerade "OmniRoute Golden Set" innehåller testfall för:

• Hälsningar, matematik, geografi, kodgenerering
• Överensstämmelse med JSON-format, översättning, generering av markdown
• Säkerhetsvägran (skadligt innehåll), räkning, boolesk logik### Evaluation Strategies

Strategi	Beskrivning	Exempel
exakt	Utdata måste matcha exakt	"4"
innehåller	Utdata måste innehålla delsträng (skiftlägeskänslig)	"Paris"
regex	Utdata måste matcha regexmönster	"1.*2.*3"
anpassad	Anpassad JS-funktion returnerar true/false	(output) => output.length > 10	---

📖 Setup Guide

Protocol Setup (MCP + A2A)

🧩 MCP Setup (Model Context Protocol)

Starta MCP-transport i stdio-läge:```bash omniroute --mcp

Rekommenderat valideringsflöde:

1. Anslut din MCP-klient via stdio.
2. Kör `omniroute_get_health`.
3. Kör `omniroute_list_combos`.
4. Öppna `/dashboard/mcp` för att bekräfta hjärtslag, aktivitet och granskning.

Användbara API:er för automatisering:

- `GET /api/mcp/status`
- `GET /api/mcp/tools`
- `GET /api/mcp/audit`
- `GET /api/mcp/audit/stats`</details>

<detaljer>
<summary><b>🤝 A2A-inställning (Agent2Agent)</b></summary>

Upptäck agenten:```bash
curl http://localhost:20128/.well-known/agent.json

Skicka en uppgift:```bash curl -X POST http://localhost:20128/a2a
-H 'content-type: application/json'
-d '{"jsonrpc":"2.0","id":"setup-a2a","method":"message/send","params":{"skill":"quota-management","messages":[{"role":"user","content":"Summarize quota status."}]}}'

Hantera livscykel:

- `GET /api/a2a/status`
- `GET /api/a2a/tasks`
- `GET /api/a2a/tasks/:id`
- `POST /api/a2a/tasks/:id/avbryt`

Operativt användargränssnitt:

- `/dashboard/a2a` för observerbarhet för uppgift/tillstånd/ström och rökåtgärder</details>

<detaljer>
<summary><b>🧪 End-to-end-protokollvalidering</b></summary>

Validera båda protokollen med riktiga klienter:```bash
npm run test:protocols:e2e

Detta verifierar:

• MCP SDK-klientanslut/lista/samtal
• A2A upptäckt/skicka/strömma/få/avbryt
• Korskontrollera data i MCP-revision och A2A-uppgiftshanterings-API:er

💳 Prenumerationsleverantörer

### Claude Code (Pro/Max)

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

**Proffstips:**Använd Opus för komplexa uppgifter, Sonnet för snabbhet. OmniRoute spårar kvot per modell!### OpenAI Codex (Plus/Pro)

Dashboard → Providers → Connect Codex
→ OAuth login (port 1455)
→ 5-hour + weekly reset

Models:
  cx/gpt-5.2-codex
  cx/gpt-5.1-codex-max

Codex Account Limit Management (5h + Weekly)

Varje Codex-konto har nu policyväxlingar i Dashboard -> Providers:

• 5h (PÅ/AV): tillämpa policyn för 5-timmars fönstertröskel.
• "Veckovis" (PÅ/AV): tillämpa policyn för tröskelvärden för veckofönster.
• Tröskelbeteende: när ett aktiverat fönster når >=90 % användning hoppas kontot över.
• Rotationsbeteende: OmniRoute leder automatiskt till nästa kvalificerade Codex-konto.
• Återställbeteende: när leverantörens "resetAt"-tiden går, blir kontot automatiskt kvalificerat igen.

Scenarier:

• 5h ON + Weekly ON: kontot hoppas över när endera fönstret når tröskeln.
• 5h OFF + Weekly ON: endast veckovis användning kan blockera kontot.
• 5h ON + Weekly OFF: endast 5-timmars användning kan blockera kontot.
• resetAt godkänd: kontot återgår till rotation automatiskt (ingen manuell återaktivering).### Gemini CLI (FREE 180K/month!)

Dashboard → Providers → Connect Gemini CLI
→ Google OAuth
→ 180K completions/month + 1K/day

Models:
  gc/gemini-3-flash-preview
  gc/gemini-2.5-pro

**Bäst värde:**Enorma gratis nivå! Använd detta före betalda nivåer.### GitHub Copilot

Dashboard → Providers → Connect GitHub
→ OAuth via GitHub
→ Monthly reset (1st of month)

Models:
  gh/gpt-5
  gh/claude-4.5-sonnet
  gh/gemini-3.1-pro-preview

🔑 API-nyckelleverantörer

### NVIDIA NIM (FREE developer access — 70+ models)

1. Registrera dig: build.nvidia.com
2. Få gratis API-nyckel (1000 slutsatspoäng ingår)
3. Dashboard → Lägg till leverantör → NVIDIA NIM:
   • API-nyckel: nvapi-din-nyckel

Modeller:"nvidia/llama-3.3-70b-instruct", "nvidia/mistral-7b-instruct" och 50+ till

**Proffstips:**OpenAI-kompatibelt API — fungerar sömlöst med OmniRoutes formatöversättning!### DeepSeek

1. Registrera dig: platform.deepseek.com
2. Hämta API-nyckel
3. Dashboard → Lägg till leverantör → DeepSeek

Modeller:deepseek/deepseek-chat, deepseek/deepseek-coder### Groq (Free Tier Available!)

1. Registrera dig: console.groq.com
2. Skaffa API-nyckel (gratis nivå ingår)
3. Dashboard → Lägg till leverantör → Groq

Modeller:groq/llama-3.3-70b, groq/mixtral-8x7b

**Proffstips:**Ultrasnabb slutledning — bäst för realtidskodning!### OpenRouter (100+ Models)

1. Registrera dig: openrouter.ai
2. Hämta API-nyckel
3. Dashboard → Lägg till leverantör → OpenRouter

**Modeller:**Få tillgång till 100+ modeller från alla större leverantörer genom en enda API-nyckel.

Beteende på instrumentpanelen:OpenRouter-modeller hanteras frånTillgängliga modeller. Manuell tillägg, import och automatisk synkronisering uppdaterar alla samma lista.

💰 Billiga leverantörer (backup)

### GLM-4.7 (Daily reset, $0.6/1M)

1. Registrera dig: Zhipu AI
2. Hämta API-nyckel från Coding Plan
3. Instrumentpanel → Lägg till API-nyckel:
   • Leverantör: glm
   • API-nyckel: din nyckel

Använd:glm/glm-4.7

**Proffstips:**Coding Plan erbjuder 3× kvot till 1/7 kostnad! Återställ dagligen 10:00.### MiniMax M2.1 (5h reset, $0.20/1M)

1. Registrera dig: MiniMax
2. Hämta API-nyckel
3. Instrumentpanel → Lägg till API-nyckel

Använd:minimax/MiniMax-M2.1

**Proffstips:**Billigaste alternativet för långa sammanhang (1M tokens)!### Kimi K2 ($9/month flat)

1. Prenumerera: Moonshot AI
2. Hämta API-nyckel
3. Instrumentpanel → Lägg till API-nyckel

Använd:kimi/kimi-latest

**Proffstips:**Fast $9/månad för 10 miljoner tokens = $0,90/1 miljon effektiv kostnad!

🆓 GRATIS leverantörer (nödbackup)

### Qoder (5 FREE models via OAuth)

Dashboard → Connect Qoder
→ Qoder OAuth login
→ Unlimited usage

Models:
  if/kimi-k2-thinking
  if/qwen3-coder-plus
  if/glm-4.7
  if/minimax-m2
  if/deepseek-r1

Qwen (4 FREE models via Device Code)

Dashboard → Connect Qwen
→ Device code authorization
→ Unlimited usage

Models:
  qw/qwen3-coder-plus
  qw/qwen3-coder-flash

Kiro (Claude FREE)

Dashboard → Connect Kiro
→ AWS Builder ID or Google/GitHub
→ Unlimited usage

Models:
  kr/claude-sonnet-4.5
  kr/claude-haiku-4.5

🎨 Skapa kombinationer

### Example 1: Maximize Subscription → Cheap Backup

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

Example 2: Free-Only (Zero Cost)

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-integration

### 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

Använd sidanCLI Toolsi instrumentpanelen för konfiguration med ett klick, eller redigera ~/.claude/settings.json manuellt.### Codex CLI

export OPENAI_BASE_URL="http://localhost:20128"
export OPENAI_API_KEY="your-omniroute-api-key"

codex "your prompt"

OpenClaw

Alternativ 1 — Instrumentpanel (rekommenderas):``` Dashboard → CLI Tools → OpenClaw → Select Model → Apply

**Alternativ 2 — Manuell:**Redigera `~/.openclaw/openclaw.json`:```json
{
  "models": {
    "providers": {
      "omniroute": {
        "baseUrl": "http://127.0.0.1:20128/v1",
        "apiKey": "sk_omniroute",
        "api": "openai-completions"
      }
    }
  }
}

**Obs!**OpenClaw fungerar endast med lokala OmniRoute. Använd 127.0.0.1 istället för localhost för att undvika problem med IPv6-upplösning.### Cline / Continue / RooCode

Settings → API Configuration:
  Provider: OpenAI Compatible
  Base URL: http://localhost:20128/v1
  API Key: [from OmniRoute dashboard]
  Model: if/kimi-k2-thinking

OpenCode

**Steg 1:**Lägg till OmniRoute som en anpassad leverantör:```bash opencode /connect

Select "Other" → Enter ID: "omniroute" → Enter your OmniRoute API key

**Steg 2:**Skapa/redigera `opencode.json` i din projektrot:```json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "omniroute": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "OmniRoute",
      "options": {
        "baseURL": "http://localhost:20128/v1"
      },
      "models": {
        "cc/claude-sonnet-4-20250514": { "name": "Claude Sonnet 4" },
        "gg/gemini-2.5-pro": { "name": "Gemini 2.5 Pro" },
        "if/kimi-k2-thinking": { "name": "Kimi K2 (Free)" }
      }
    }
  }
}

**Steg 3:**Välj modell i OpenCode:```bash /models

Select any OmniRoute model from the list

>**Tips:**Lägg till valfri modell som är tillgänglig i din OmniRoute `/v1/models` slutpunkt till avsnittet `modeller`. Använd formatet `provider/model-id` från din OmniRoute-instrumentpanel.</details>

---

## Felsökning

<detaljer>
<summary><b>Klicka för att expandera felsökningsguiden</b></summary>

**"Språkmodellen gav inga meddelanden"**

- Leverantörskvoten är slut → Kontrollera instrumentpanelens kvotföljare
- Lösning: Använd kombinationsalternativ eller byt till billigare nivå

**Taxebegränsning**

- Prenumerationskvot ute → Fallback till GLM/MiniMax
- Lägg till kombination: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`

**OAuth-token har löpt ut**

- Automatisk uppdatering av OmniRoute
- Om problemen kvarstår: Dashboard → Leverantör → Återanslut

**Höga kostnader**

- Kontrollera användningsstatistik i Dashboard → Kostnader
- Byt primär modell till GLM/MiniMax
- Använd gratis nivå (Gemini CLI, Qoder) för icke-kritiska uppgifter

**Dashboard/API-portar är fel**

- `PORT` är den kanoniska basporten (och API-porten som standard)
- `API_PORT` åsidosätter endast OpenAI-kompatibel API-lyssnare
- `DASHBOARD_PORT` åsidosätter endast instrumentpanelen/Next.js-lyssnaren
- Ställ in `NEXT_PUBLIC_BASE_URL` till din instrumentpanel/offentliga webbadress (för OAuth-återuppringningar)

**Molnsynkroniseringsfel**

- Verifiera att `BASE_URL` pekar på din körinstans
- Verifiera "CLOUD_URL" pekar till din förväntade molnslutpunkt
- Håll `NEXT_PUBLIC_*`-värdena i linje med värden på serversidan

**Första inloggningen fungerar inte**

- Kontrollera `INITIAL_PASSWORD` i `.env`
- Om det inte är inställt är reservlösenordet "123456".

**Inga förfrågningsloggar**

- Begäran artefakter skrivs till `DATA_DIR/call_logs/` som en JSON-fil per begäran
- Aktivera pipelinefångst från Dashboard → Loggar → Begär loggar om du behöver detaljerade nyttolaster per steg
- Ställ in `APP_LOG_TO_FILE=true` om du också vill ha applikationskonsolloggar i `logs/application/app.log`
- Justera "APP_LOG_MAX_FILE_SIZE", "APP_LOG_RETENTION_DAYS", "APP_LOG_MAX_FILES" och "CALL_LOG_MAX_ENTRIES" efter behov

**Anslutningstest visar "Invalid" för OpenAI-kompatibla leverantörer**

- Många leverantörer exponerar inte en `/models` slutpunkt
- OmniRoute v1.0.6+ inkluderar reservvalidering via chattslutföranden
- Se till att baswebbadressen innehåller suffixet `/v1`### 🔐 OAuth on a Remote Server

<a name="oauth-on-a-remote-server"></a>
<a name="oauth-em-servider-remoto"></a>

>**⚠️ Viktigt för användare som kör OmniRoute på en VPS, Docker eller vilken fjärrserver som helst**#### Why does Antigravity / Gemini CLI OAuth fail on remote servers?

**Antigravity**och**Gemini CLI**-leverantörerna använder**Google OAuth 2.0**. Google kräver att "redirect_uri" i OAuth-flödet exakt matchar en av de förregistrerade URI:erna i appens Google Cloud Console.

OAuth-uppgifterna som är paketerade i OmniRoute är registrerade**endast för "localhost"**. När du använder OmniRoute på en fjärrserver (t.ex. `https://omniroute.myserver.com`), avvisar Google autentiseringen med:```
Error 400: redirect_uri_mismatch

Solution: Configure your own OAuth credentials

Du måste skapa ettOAuth 2.0 Client IDi Google Cloud Console med din servers URI.#### Step-by-step

1. Öppna Google Cloud Console

Gå till: https://console.cloud.google.com/apis/credentials

2. Skapa ett nytt OAuth 2.0-klient-ID

• Klicka på**"+ Skapa inloggningsuppgifter"→"OAuth-klient-ID"**
• Applikationstyp:"Webbapplikation"
• Namn: allt du gillar (t.ex. "OmniRoute Remote")

3. Lägg till auktoriserade omdirigerings-URI:er

I fältet**"Auktoriserade omdirigerings-URI:er"**lägger du till:``` https://your-server.com/callback

> Ersätt `din-server.com` med din servers domän eller IP (inkludera porten om det behövs, t.ex. `http://45.33.32.156:20128/callback`).

**4. Spara och kopiera inloggningsuppgifterna**

När du har skapat kommer Google att visa**klient-ID**och**klienthemlighet**.

**5. Ställ in miljövariabler**

I din `.env` (eller Docker-miljövariabler):```bash
# For Antigravity:
ANTIGRAVITY_OAUTH_CLIENT_ID=your-client-id.apps.googleusercontent.com
ANTIGRAVITY_OAUTH_CLIENT_SECRET=GOCSPX-your-secret

# For Gemini CLI:
GEMINI_OAUTH_CLIENT_ID=your-client-id.apps.googleusercontent.com
GEMINI_OAUTH_CLIENT_SECRET=GOCSPX-your-secret
GEMINI_CLI_OAUTH_CLIENT_SECRET=GOCSPX-your-secret

6. Starta om OmniRoute```bash

npm:

npm run dev

Docker:

docker restart omniroute

**7. Försök ansluta igen**

Dashboard → Leverantörer → Antigravity (eller Gemini CLI) → OAuth

Google kommer nu att omdirigera korrekt till `https://din-server.com/callback`.---

#### Temporary workaround (without custom credentials)

Om du inte vill ställa in dina egna autentiseringsuppgifter just nu kan du fortfarande använda det**manuella URL-flödet**:

1. OmniRoute öppnar Googles auktoriserings-URL
2. Efter auktorisering försöker Google omdirigera till `localhost` (som misslyckas på fjärrservern)
3.**Kopiera hela webbadressen**från webbläsarens adressfält (även om sidan inte laddas)
4. Klistra in den URL:en i fältet som visas i OmniRoute-anslutningsmodalen
5. Klicka på**"Anslut"**

> Detta fungerar eftersom auktoriseringskoden i URL:en är giltig oavsett om omdirigeringssidan har laddats.---

<detaljer>
<summary><b>🇧🇷 Versão em Português</b></summary>#### Por que o OAuth do Antigravity / Gemini CLI falha em servidores remotos?

Os provedores**Antigravity**och**Gemini CLI**usam**Google OAuth 2.0**för autenticação. O Google exige que a `redirect_uri` usada no fluxo OAuth seja**exatamente**uma das URIs pré-cadastradas no Google Cloud Console do aplicativo.

Som credenciais OAuth embutidas no OmniRoute estão cadastradas**apenas para `localhost`**. Quando você acessa o OmniRoute em um servidor remoto (ex: `https://omniroute.meuservidor.com`), o Google rejeita a autenticação com:```
Error 400: redirect_uri_mismatch

Solução: Configure suas próprias credenciais OAuth

Você precisa criar umOAuth 2.0 Client IDno Google Cloud Console com a URI do seu service.#### Passo a passo

1. Åtkomst till Google Cloud Console

Abra: https://console.cloud.google.com/apis/credentials

2. Crie um novo OAuth 2.0 Client ID

• Klicka på dem**"+ Skapa inloggningsuppgifter"→"OAuth-klient-ID"**
• Typo de aplicativo:"Webbapplikation"
• Namn: escolha qualquer nome (ex: OmniRoute Remote)

3. Adicione som auktoriserade omdirigerings-URI

Ingen campo**"Auktoriserade omdirigerings-URIs"**, adicione:``` https://seu-servidor.com/callback

> Substitua `seu-servidor.com` pelo domínio eller IP do seu servidor (inklusive en porta se necessário, ex: `http://45.33.32.156:20128/callback`).

**4. Spara e kopia som credenciais**

Após criar, o Google mostrará o**Client ID**e o**Client Secret**.

**5. Konfigurera som variáveis de ambiente**

No seu `.env` (ou nas variáveis de ambiente do 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 o OmniRoute```bash

Se usando npm:

npm run dev

Se usando Docker:

docker restart omniroute

**7. Tente conectar novamente**

Dashboard → Leverantörer → Antigravity (ou Gemini CLI) → OAuth

Agora o Google redirecionará corretamente para `https://seu-servidor.com/callback` och autenticação funcionará.---

#### Workaround temporário (sem configurar credenciais próprias)

Se não quiser criar credenciais próprias agora, ainda é possível usar o fluxo**manual de URL**:

1. O OmniRoute abrirá en URL de autorização till Google
2. Após você autorizar, o Google tentará redirecionar para `localhost` (que falha no servidor remoto)
3.**Kopiera en URL komplett**da barra de endereço do seu webbläsare (mesmo que a página não carregue)
4. Cole essa URL no campo que aparece no modal de conexão do OmniRoute
5. Klicka på dem**"Anslut"**

> Este workaround funciona porque o código de autorização na URL é válido independente do redirect ter carregado ou não.</details>

---

</details>

## 🛠️ Tech Stack

<detaljer>
<summary><b>Klicka för att expandera teknisk stackinformation</b></summary>

-**Runtime**: Node.js 18–22 LTS (⚠️ Node.js 24+ stöds**inte**— inbyggda binära filer för "better-sqlite3" är inkompatibla)
-**Språk**: TypeScript 5.9 —**100 % TypeScript**över `src/` och `open-sse/` (noll `alla` i kärnmoduler sedan v2.0)
-**Framework**: Next.js 16 + React 19 + Tailwind CSS 4
-**Databas**: LowDB (JSON) + SQLite (domäntillstånd + proxyloggar + MCP-granskning + routingbeslut)
-**Schema**: Zod (MCP-verktyg I/O-validering, API-kontrakt)
-**Protokoll**: MCP (stdio/HTTP) + A2A v0.3 (JSON-RPC 2.0 + SSE)
-**Streaming**: Serversända händelser (SSE)
-**Auth**: OAuth 2.0 (PKCE) + JWT + API-nycklar + MCP Scoped Authorization
-**Test**: Node.js testlöpare + Vitest (900+ tester inklusive enhet, integration, E2E)
-**CI/CD**: GitHub-åtgärder (automatisk npm-publicering + Docker Hub vid release)
-**Webbplats**: [omniroute.online](https://omniroute.online)
-**Paket**: [npmjs.com/package/omniroute](https://www.npmjs.com/package/omniroute)
-**Docker**: [hub.docker.com/r/diegosouzapw/omniroute](https://hub.docker.com/r/diegosouzapw/omniroute)
-**Resiliens**: Strömbrytare, exponentiell backoff, anti-dundrande flock, TLS-spoofing, auto-combo självläkning</details>

---

## Dokumentation

| Dokument | Beskrivning |
| ------------------------------------------------------ | ---------------------------------------------------------- |
| [Användarguide](docs/USER_GUIDE.md) | Leverantörer, kombinationer, CLI-integration, distribution |
| [API-referens](docs/API_REFERENCE.md) | Alla slutpunkter med exempel |
| [MCP-server](open-sse/mcp-server/README.md) | 16 MCP-verktyg, IDE-konfigurationer, Python/TS/Go-klienter |
| [A2A-server](src/lib/a2a/README.md) | JSON-RPC 2.0-protokoll, färdigheter, streaming, uppgiftshantering |
| [Auto-Combo Engine](docs/auto-combo.md) | 6-faktor poäng, lägespaket, självläkande |
| [Felsökning](docs/TROUBLESHOOTING.md) | Vanliga problem och lösningar |
| [Arkitektur](docs/ARCHITECTURE.md) | Systemarkitektur och interna delar |
| [Bidrar](CONTRIBUTING.md) | Utvecklingsupplägg och riktlinjer |
| [OpenAPI Spec](docs/openapi.yaml) | OpenAPI 3.0-specifikation |
| [Säkerhetspolicy](SECURITY.md) | Sårbarhetsrapportering och säkerhetsrutiner |
| [VM-distribution](docs/VM_DEPLOYMENT_GUIDE.md) | Komplett guide: VM + nginx + Cloudflare-installation |
| [Feature Gallery](docs/FEATURES.md) | Visuell visning av instrumentpanelen med skärmdumpar |
| [Releasechecklista](docs/RELEASE_CHECKLIST.md) | Steg för validering av pre-release |---

## 🗺️ Roadmap

OmniRoute har**210+ funktioner planerade**över flera utvecklingsfaser. Här är nyckelområdena:

| Kategori | Planerade funktioner | Höjdpunkter |
| ------------------------------ | ---------------- | ------------------------------------------------------------------------------------------------------ |
| 🧠**Routing & intelligens**| 25+ | Routing med lägsta latens, taggbaserad routing, kvotförhandskontroll, val av P2C-konto |
| 🔒**Säkerhet och efterlevnad**| 20+ | SSRF-härdning, cloaking av autentiseringsuppgifter, hastighetsgräns per endpoint, hanteringsnyckelomfattning |
| 📊**Observerbarhet**| 15+ | OpenTelemetry-integration, kvotövervakning i realtid, kostnadsspårning per modell |
| 🔄**Providerintegrationer**| 20+ | Dynamiskt modellregister, nedkylning av leverantörer, Codex för flera konton, Copilot-kvotanalys |
| ⚡**Prestanda**| 15+ | Dubbla cachelager, promptcache, svarscache, streaming keepalive, batch API |
| 🌐**Ekosystem**| 10+ | WebSocket API, config hot-reload, distribuerad config store, kommersiellt läge |### 🔜 Coming Soon

- 🔗**OpenCode Integration**— Inbyggt leverantörsstöd för OpenCode AI-kodnings-IDE
- 🔗**TRAE Integration**— Fullständigt stöd för TRAE AI-utvecklingsramverket
- 📦**Batch API**— Asynkron batchbearbetning för bulkförfrågningar
- 🎯**Taggbaserad routing**— Ruttbegäranden baserade på anpassade taggar och metadata
- 💰**Lägsta kostnadsstrategi**— Välj automatiskt den billigaste tillgängliga leverantören

> 📝 Fullständiga funktionsspecifikationer tillgängliga i [`docs/new-features/`](docs/new-features/) (217 detaljerade specifikationer)---

## 👥 Contributors

[![Contributors](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=100&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)

### How to Contribute

1. Dela förvaret
2. Skapa din funktionsgren (`git checkout -b feature/amazing-feature`)
3. Bekräfta dina ändringar (`git commit -m 'Lägg till fantastisk funktion'`)
4. Tryck till grenen (`git push origin feature/amazing-feature`)
5. Öppna en Pull Request

Se [CONTRIBUTING.md](CONTRIBUTING.md) för detaljerade riktlinjer.### Releasing a New Version

```bash
# Create a release — npm publish happens automatically
gh release create v2.0.0 --title "v2.0.0" --generate-notes

---

📊 Star History

Stargazers over time

🙏 Acknowledgments

Särskilt tack till**9routeravdecolua**— originalprojektet som inspirerade denna gaffel. OmniRoute bygger på den otroliga grunden med ytterligare funktioner, multimodala API:er och en fullständig TypeScript-omskrivning.

Särskilt tack till**CLIProxyAPI**— den ursprungliga Go-implementeringen som inspirerade denna JavaScript-port.---

Licens

MIT-licens - se LICENS för detaljer.---

_{Built with ❤️ for developers who code 24/7
omniroute.online}