OmniRoute/README.sv.md

🚀 OmniRoute — Den kostnadsfria AI-gatewayen

🌐 English | Português (BR)

Sluta aldrig koda. Smart routing till GRATIS & lågkostnads ​​AI-modeller med automatisk reserv.

Din universella API-proxy — en slutpunkt, 36+ leverantörer, noll driftstopp.

Slutförda chatt • Inbäddningar • Bildgenerering • Ljud • Omrankning • 100 % TypeScript

---

🤖 Gratis AI-leverantör för dina favoritkodningsagenter

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	Kilo Code ⭐ 15.5K

_{📡 Alla agenter ansluter via http://localhost:20128/v1 eller http://cloud.omniroute.online/v1, —limited one config_245__ kvot}

---

🌐 Website • 🚀 Quick Start • 💡 Features • 📖 Docs • 💰 Pricing • 💬 WhatsApp

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

---

🤔 Varför OmniRoute?

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

• Prenumerationskvoten löper ut oanvänd varje månad
• Hastighetsgrä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

---

🔄 Hur det fungerar

┌─────────────┐
│  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

---

⚡ Snabbstart

1. Installera globalt:

npm install -g omniroute
omniroute

🎉 Instrumentpanelen öppnar kl. http://localhost:20128

Kommando	Beskrivning
omniroute	Startserver (standardport 20128)
omniroute --port 3000	Använd anpassad port
omniroute --no-open	Öppna inte webbläsaren automatiskt
omniroute --help	Visa hjälp

2. Anslut en GRATIS leverantör:

Dashboard → Leverantörer → Anslut Claude Code eller Antigravity → OAuth-inloggning → Klar!

3. Använd i ditt CLI-verktyg:

Claude Code/Codex/Gemini CLI/OpenClaw/Cursor/Cline Settings:
  Endpoint: http://localhost:20128/v1
  API Key: [copy from dashboard]
  Model: if/kimi-k2-thinking

Det var allt! Börja koda med GRATIS AI-modeller.

Alternativ – kör från källan:

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

---

🐳 Hamnarbetare

OmniRoute är tillgänglig som en offentlig Docker-bild på Docker Hub.

Snabbkörning:

docker run -d \
  --name omniroute \
  --restart unless-stopped \
  -p 20128:20128 \
  -v omniroute-data:/app/data \
  diegosouzapw/omniroute:latest

Med miljöfil:

# 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

Använda Docker Compose:

# 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

Bild	Tagga	Storlek	Beskrivning
diegosouzapw/omniroute	latest	~250MB	Senaste stabila utgåvan
diegosouzapw/omniroute	1.0.3	~250MB	Aktuell version

---

---

🖥️ 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

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

---

💰 Prissättning i en överblick

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 USD/månad	Månatlig	GitHub-användare
🔑 API-NYCKEL	NVIDIA NIM	GRATIS (1000 poäng)	Engång	Gratis nivåtestning
	DeepSeek	Betala per användning	Inga	Bästa pris/kvalitet
	Groq	Gratis nivå + betald	Begränsat pris	Ultrasnabb slutledning
	xAI (Grok)	Betala per användning	Inga	Grok modeller
	Mistral	Gratis nivå + betald	Begränsat pris	Europeisk AI
	OpenRouter	Betala per användning	Inga	100+ modeller
💰 BILLIGT	GLM-4.7	$0,6/1M	Dagligen 10:00	Budget backup
	MiniMax M2.1	$0,2/1M	5-timmars rullande	Billigaste alternativet
	Kimi K2	9 USD/mån lägenhet	10 miljoner tokens/månad	Förutsägbar kostnad
🆓 GRATIS	iFlow	$0	Obegränsad	8 modeller gratis
	Qwen	$0	Obegränsad	3 modeller gratis
	Kiro	$0	Obegränsad	Claude gratis

💡 Proffstips: Börja med Gemini CLI (180K gratis/månad) + iFlow (obegränsat gratis) combo = $0 kostnad!

---

🎯 Användningsfall

Fall 1: "Jag har Claude Pro-abonnemang"

Problem: Kvoten går ut oanvänd, hastighetsgränser under tung kodning

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

Fall 2: "Jag vill ha noll kostnad"

Problem: Har inte råd med prenumerationer, behöver pålitlig AI-kodning

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

Fall 3: "Jag behöver kodning dygnet runt, inga avbrott"

Problem: Deadlines, har inte råd med driftstopp

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

Fall 4: "Jag vill ha GRATIS AI i OpenClaw"

Problem: Behöver AI-assistent i meddelandeappar, helt 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...

---

💡 Nyckelfunktioner

🧠 Core 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 ↔ Markör ↔ Kiro sömlös + sanering av svar
👥 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	6 strategier: fill-first, round-robin, p2c, slumpmässig, minst använda, kostnadsoptimerad
🧩 Anpassade modeller	Lägg till valfritt modell-ID till valfri leverantör
🌐 Wildcard-router	Dirigera provider/*-mönster till valfri leverantör dynamiskt
🧠 Tänkande budget	Genomgång, auto, anpassade och adaptiva lägen för resonerande modeller
💬 System Prompt Injection	Global systemprompt tillämpas på alla förfrågningar
📄 Responses API	Fullständigt stöd för OpenAI Responses API (/v1/responses) för Codex

🎵 Multimodala API:er

Funktion	Vad det gör
🖼️ Bildgenerering	/v1/images/generations — 4 leverantörer, 9+ modeller
📐 Inbäddningar	/v1/embeddings — 6 leverantörer, 9+ modeller
🎤 Ljudtranskription	/v1/audio/transcriptions — Whisper-kompatibel
🔊 Text-till-tal	/v1/audio/speech — Ljudsyntes med flera leverantörer
🛡️ Moderationer	/v1/moderations — Innehållssäkerhetskontroller
🔀 Omrankning	/v1/rerank — Omrankning av dokumentrelevans

🛡️ Motståndskraft och säkerhet

Funktion	Vad det gör
🔌 Circuit Breaker	Autoöppna/stäng per leverantör med konfigurerbara trösklar
🛡️ Anti-ånflock	Mutex + semaforhastighetsgräns för API-nyckelleverantörer
🧠 Semantisk cache	Tvåskiktscache (signatur + semantisk) minskar kostnaden och fördröjningen
⚡ Begär idempotens	5s dedup-fönster för dubblettförfrågningar
🔒 TLS Fingerprint Spoofing	Förbi TLS-baserad botdetektering via wreq-js
🌐 IP-filtrering	Tillåtelselista/blockeringslista för API-åtkomstkontroll
📊 Redigerbara hastighetsgränser	Konfigurerbart RPM, min gap och max samtidiga på systemnivå
🛡 API Endpoint Protection	Auth gating + leverantörsblockering för /models slutpunkt
🔒 Proxysynlighet	Färgkodade märken: 🟢 global, 🟡 leverantör, 🔵 per anslutning med IP-display
🌐 Proxykonfiguration med 3 nivåer	Konfigurera proxyservrar på global nivå, per leverantör eller per anslutningsnivå

📊 Observerbarhet och analys

Funktion	Vad det gör
📝 Begär loggning	Felsökningsläge med fullständiga förfrågnings-/svarsloggar
💾 SQLite proxyloggar	Beständiga proxyloggar överlever serverstarter
📊 Analytics Dashboard	Recharts-driven: statistikkort, modellanvändningsdiagram, leverantörstabell
📈 Förloppsspårning	Opt-in SSE-förloppshändelser för streaming
🧪 LLM-utvärderingar	Golden set testning med 4 matchstrategier
🔍 Begär telemetri	p50/p95/p99 latensaggregation + X-Request-Id-spårning
📋 Dashboard för loggar	Enad sida med 4 flikar: Begäranloggar, Proxyloggar, Granskningsloggar, Konsol
🖥️ Konsolloggvisare	Realtidsvisare i terminalstil med nivåfilter, sökning, automatisk rullning
📑 Filbaserad loggning	Console Interceptor fångar all utdata till JSON-loggfilen med rotation
🏥 Hälsoinstrumentpanel	Systemupptid, strömbrytartillstånd, låsningar, cachestatistik
💰 Kostnadsspårning	Budgethantering + prissättning per modell

☁️ Implementering och synkronisering

Funktion	Vad det gör
💾 Cloud Sync	Synkronisera konfiguration mellan enheter via Cloudflare Workers
🌐 Distribuera var som helst	Localhost, VPS, Docker, Cloudflare Workers
🔑 API-nyckelhantering	Generera, rotera och omfång API-nycklar per leverantör
🧙 Onboarding Wizard	4-stegs guidad installation för förstagångsanvändare
🔧 CLI Tools Dashboard	Konfigurera med ett klick Claude, Codex, Cline, OpenClaw, Kilo, Antigravity
🔄 DB-säkerhetskopior	Automatisk säkerhetskopiering, återställning, export och import för alla inställningar
🌐 Internationalisering	Fullständig i18n med nästa-intl — stöd för engelska + portugisiska (Brasilien)
🌍 Språkväljare	Globikon i rubriken för språkväxling i realtid (🇺🇸/🇧🇷)
📂 Anpassad datakatalog	DATA_DIR env var för att åsidosätta standard ~/.omniroute lagringssökväg

📖 Funktionsdetaljer

🎯 Smart 4-lagers reserv

Skapa kombinationer med automatisk reserv:

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

📊 Kvotspårning i realtid

• Tokenförbrukning per leverantör
• Återställ nedräkningen (5 timmar, dagligen, veckovis)
• Kostnadsuppskattning för betalda nivåer
• Månatliga utgiftsrapporter

🔄 Formatöversättning

Sömlös översättning mellan format:

• OpenAI ↔ Claude ↔ Gemini ↔ OpenAI-svar
• Ditt CLI-verktyg skickar OpenAI-format → OmniRoute översätter → Leverantör tar emot inbyggt format
• Fungerar med alla verktyg som stöder anpassade OpenAI-slutpunkter
• Responssanering — Tar bort icke-standardiserade fält för strikt OpenAI SDK-kompatibilitet
• Rollnormalisering — developer → system för icke-OpenAI; system → user för GLM/ERNIE-modeller
• Think tag extrahering — <think> block → reasoning_content för tänkande modeller
• Structured output — json_schema → Gemini's responseMimeType/responseSchema

👥 Support för flera konton

• Lägg till flera konton per leverantör
• Auto round-robin eller prioritetsbaserad routing
• Fallback till nästa konto när man når kvoten

🔄 Auto Token Refresh

• OAuth-tokens uppdateras automatiskt innan utgången
• Ingen manuell återautentisering behövs
• Sömlös upplevelse hos alla leverantörer

🎨 Anpassade kombinationer

• Skapa obegränsade modellkombinationer
• 6 strategier: fyll-först, round-robin, kraft-av-två-val, slumpmässig, minst använda, kostnadsoptimerad
• Dela kombinationer mellan enheter med Cloud Sync

🏥 Health Dashboard

• Systemstatus (upptid, version, minnesanvändning)
• Strömbrytarstatus per leverantör (stängd/öppen/halvöppen)
• Prisgränsstatus och aktiva låsningar
• Signaturcachestatistik
• Latens-telemetri (p50/p95/p99) + promptcache
• Återställ hälsostatus med ett klick

🔧 Översättarlekplats

OmniRoute inkluderar en kraftfull inbyggd översättarlekplats med 4 lägen för felsökning, testning och övervakning av API-översättningar:

Läge	Beskrivning
💻 Lekplats	Direkt formatöversättning — klistra in valfri API-begäran och se direkt hur OmniRoute översätter den mellan leverantörsformat (OpenAI ↔ Claude ↔ Gemini ↔ Responses API). Inkluderar exempelmallar och automatisk identifiering av format.
💬 Chattestare	Skicka riktiga chattförfrågningar genom OmniRoute och se hela tur och retur: din input, den översatta begäran, leverantörens svar och det översatta svaret tillbaka. Ovärderligt för att validera combo routing.
🧪 Testbänk	Batchtestläge — definiera flera testfall med olika ingångar och förväntade utgångar, kör dem alla på en gång och jämför resultat mellan leverantörer och modeller.
📱 Live Monitor	Bevakning av förfrågningar i realtid — titta på inkommande förfrågningar när de flödar genom OmniRoute, se formatöversättningar som sker live och identifiera problem direkt.

Åtkomst: Instrumentpanel → Översättare (sidofält)

💾 Cloud Sync

• Synkronisera leverantörer, kombinationer och inställningar mellan enheter
• Automatisk bakgrundssynkronisering
• Säker krypterad lagring

---

📖 Installationsguide

💳 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

Gemini CLI (GRATIS 180K/månad!)

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

🔑 API-nyckelleverantörer

NVIDIA NIM (GRATIS 1000 krediter!)

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-your-key

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 (gratis nivå tillgänglig!)

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+ modeller)

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.

💰 Billiga leverantörer (backup)

GLM-4.7 (Daglig återställning, $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: your-key

Använd: glm/glm-4.7

Proffstips: Coding Plan erbjuder 3× kvot till 1/7 kostnad! Återställ dagligen 10:00.

MiniMax M2.1 (5 timmars återställning, $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/månad platt)

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)

iFlow (8 GRATIS modeller)

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 modeller)

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

Exempel 1: Maximera prenumeration → Billig 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

Exempel 2: Endast gratis (noll kostnad)

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

Markör 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 sidan CLI Tools i 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:

{
  "models": {
    "providers": {
      "omniroute": {
        "baseUrl": "http://127.0.0.1:20128/v1",
        "apiKey": "sk_omniroute",
        "api": "openai-completions"
      }
    }
  }
}

Obs! OpenClaw fungerar endast med lokal OmniRoute. Använd 127.0.0.1 istället för localhost för att undvika problem med IPv6-upplösning.

Cline / Fortsätt / RooCode

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

---

📊 Tillgängliga modeller

Visa alla tillgängliga modeller

Claude Code (cc/) - Pro/Max:

• cc/claude-opus-4-6
• cc/claude-sonnet-4-5-20250929
• cc/claude-haiku-4-5-20251001

Codex (cx/) - Plus/Pro:

• cx/gpt-5.2-codex
• cx/gpt-5.1-codex-max

Gemini CLI (gc/) - GRATIS:

• gc/gemini-3-flash-preview
• gc/gemini-2.5-pro

GitHub Copilot (gh/):

• gh/gpt-5
• gh/claude-4.5-sonnet

NVIDIA NIM (nvidia/) - GRATIS krediter:

• nvidia/llama-3.3-70b-instruct
• nvidia/mistral-7b-instruct
• 50+ modeller till på build.nvidia.com

GLM (glm/) - $0,6/1M:

• glm/glm-4.7

MiniMax (minimax/) - $0,2/1M:

• minimax/MiniMax-M2.1

iFlow (if/) - GRATIS:

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

Qwen (qw/) - GRATIS:

• qw/qwen3-coder-plus
• qw/qwen3-coder-flash

Kiro (kr/) - GRATIS:

• kr/claude-sonnet-4.5
• kr/claude-haiku-4.5

OpenRouter (or/) - 100+ modeller:

• or/anthropic/claude-4-sonnet
• or/google/gemini-2.5-pro
• Alla modeller från openrouter.ai/models

---

🧪 Utvärderingar (Evals)

OmniRoute inkluderar ett inbyggt utvärderingsramverk för att testa LLM-svarskvalitet mot en gyllene uppsättning. Få åtkomst till det via Analytics → Evals i instrumentpanelen.

Inbyggt gyllene set

Det förinstallerade "OmniRoute Golden Set" innehåller 10 testfall som täcker:

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

Utvärderingsstrategier

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

---

🔐 OAuth em Servidor Remoto (Remote OAuth Setup)

⚠️ VIKTIGT för användning av OmniRoute med VPS/Docker/serverfjärrkontroll

Hur kan du göra Antigravity / Tvilling CLI på fjärrkontroller?

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

Lösning: Konfigurera självständigt OAuth

Você precisa criar um OAuth 2.0 Client ID no 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 ou IP do seu servidor (inclua a 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):

# 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

# 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 e a autenticação funcionará.

---

Lösning temporário (som 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 webbadress 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å "Anslut"

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

---

🐛 Felsökning

Klicka för att expandera felsökningsguide

"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, iFlow) för icke-kritiska uppgifter

Dashboard öppnas på fel port

• Set PORT=20128 och NEXT_PUBLIC_BASE_URL=http://localhost:20128

Molnsynkroniseringsfel

• Verifiera att BASE_URL pekar på din löpinstans
• Verifiera CLOUD_URL poäng till din förväntade molnslutpunkt
• Håll NEXT_PUBLIC_* värden 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

• Ställ in ENABLE_REQUEST_LOGS=true i .env

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

---

🛠️ Tech Stack

• Körtid: Node.js 18–22 LTS (⚠️ Node.js 24+ stöds inte — better-sqlite3 inbyggda binärer är inkompatibla)
• Språk: TypeScript 5.9 — 100 % TypeScript över src/ och open-sse/ (v1.0.6)
• Framework: Next.js 16 + React 19 + Tailwind CSS 4
• Databas: LowDB (JSON) + SQLite (domäntillstånd + proxyloggar)
• Streaming: Serversända händelser (SSE)
• Auth: OAuth 2.0 (PKCE) + JWT + API-nycklar
• Test: Node.js testlöpare (368+ enhetstester)
• CI/CD: GitHub-åtgärder (automatisk npm-publicering + Docker Hub vid release)
• Webbplats: omniroute.online
• Paket: npmjs.com/package/omniroute
• Docker: hub.docker.com/r/diegosouzapw/omniroute
• Resiliens: Strömbrytare, exponentiell backoff, anti-dundrande flock, TLS-spoofing

---

📖 Dokumentation

Dokument	Beskrivning
User Guide	Leverantörer, kombinationer, CLI-integration, distribution
API Reference	Alla slutpunkter med exempel
Troubleshooting	Vanliga problem och lösningar
Architecture	Systemarkitektur och interna delar
Contributing	Utvecklingsupplägg och riktlinjer
OpenAPI Spec	OpenAPI 3.0-specifikation
Security Policy	Sårbarhetsrapportering och säkerhetsrutiner
VM Deployment	Komplett guide: VM + nginx + Cloudflare-installation
Features Gallery	Visuell visning av instrumentpanelen med skärmdumpar

📸 Förhandsgranskning av instrumentpanelen

Klicka för att se skärmdumpar på instrumentpanelen

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

---

🗺️ Färdkarta

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

Kategori	Planerade funktioner	Höjdpunkter
🧠 Routing & intelligens	25+	Routning 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

🔜 Kommer snart

• 🔗 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 link (217 detaljerade specifikationer)

---

📧 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
• Frågor: github.com/diegosouzapw/OmniRoute/issues
• WhatsApp: Community Group
• Originalprojekt: 9router by decolua

---

👥 Bidragsgivare

Hur man bidrar

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

Se CONTRIBUTING.md för detaljerade riktlinjer.

Släpper en ny version

# Create a release — npm publish happens automatically
gh release create v1.0.6 --title "v1.0.6" --generate-notes

---

📊 Stjärnhistorik

---

🙏 Tack

Speciellt tack till 9router av decolua — 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 LICENSE för detaljer.

---

---

🇧🇷 OmniRoute — Gateway de IA Gratuito

Nunca pare de codar. Roteamento inteligente para modeller de IA GRATUITOS e de baixo custo com reservautomatisk.

Seu proxy universal de API — um endpoint, 36+ tester, noll driftstopp.

🌐 Internacionalização (i18n)

O instrumentpanelen gör OmniRoute stöder múltiplos idiomas. Attualmente disponível em:

Idiom	Código	Status
🇺🇸 engelska	en	✅ Komplett
🇧🇷 Português (Brasilien)	pt-BR	✅ Komplett

Para trocar o idioma: Clique no selector de idioma (🇺🇸 EN) no header do dashboard → selecione o idioma desejado.

För att lägga till ett nytt uttryck:

1. Crie src/i18n/messages/{codigo}.json baseado em en.json
2. Adicione o código em src/i18n/config.ts → LOCALES och LANGUAGES
3. Reinicie o servidor

⚡ Início Rápido

# Instalar via npm
npx omniroute@latest

# Ou rodar do código-fonte
cp .env.example .env
npm install
PORT=20128 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run dev

🐳 Hamnarbetare

docker run -d --name omniroute -p 20128:20128 diegosouzapw/omniroute:latest

🔑 Funcionalidades Principais

• 36+ provedores de IA — Claude, GPT, Gemini, Llama, Qwen, DeepSeek, e mais
• Roteamento inteligente — Fallback automático entre provedores
• Tradução de formato — OpenAI ↔ Claude ↔ Gemini automaticamente
• Multi-conta — Múltiplas contas por provedor com seleção inteligente
• Cache semântico — Reduz custos e latência
• OAuth automático — Tokens renovam automaticamente
• Combos personalizados — 6 estratégias de roteamento
• Dashboard komplett — Övervakning, loggar, analyser, konfigurationer
• CLI-verktyg — Konfigurera Claude Code, Codex, Cursor, Cline com um clique
• 100 % TypeScript — Código limpo e tipado

📖 Dokumentation

Dokument	Beskrivning
Guia do Usuário	Provedores, combos, CLI, distribuera
Referência da API	Todos os endpoints com exemplos
Solução de Problemas	Problemas comuns e soluções
Arquitetura	Arquitetura e internos do sistema
Contribuição	Inställning av desenvolvimento och riktlinjer
Deploy em VM	Komplettera med: VM + nginx + Cloudflare

📧 Stöd

💬 Entre para a comunidade! Grupo WhatsApp — Tire dúvidas, compartilhe dicas e fique atualizado.

• Webbplats: omniroute.online
• GitHub: github.com/diegosouzapw/OmniRoute
• Frågor: github.com/diegosouzapw/OmniRoute/issues

---

_{Byggd med ❤️ för utvecklare som kodar 24/7
omniroute.online}