Skip to content

Latest commit

 

History

History
1238 lines (887 loc) · 49.1 KB

File metadata and controls

1238 lines (887 loc) · 49.1 KB
OmniRoute Dashboard

🚀 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
OpenClaw

⭐ 205K
NanoBot
NanoBot

⭐ 20.9K
PicoClaw
PicoClaw

⭐ 14.6K
ZeroClaw
ZeroClaw

⭐ 9.9K
IronClaw
IronClaw

⭐ 2.1K
OpenCode
OpenCode

⭐ 106K
Codex CLI
Codex CLI

⭐ 60.8K
Claude Code
Claude Code

⭐ 67.3K
Gemini CLI
Gemini CLI

⭐ 94.7K
Kilo Code
Kilo Code

⭐ 15.5K

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


npm version Docker Hub License Website WhatsApp

🌐 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

💰 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:

  • OpenAIClaudeGeminiOpenAI-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
  • Rollnormaliseringdevelopersystem för icke-OpenAI; systemuser för GLM/ERNIE-modeller
  • Think tag extrahering<think> block → reasoning_content för tänkande modeller
  • Structured outputjson_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:


🧪 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 intebetter-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 Providers
Kombos Combos
Analytics Analytics
Hälsa Health
Översättare Translator
Inställningar Settings
CLI-verktyg CLI Tools
Användningsloggar Usage
Slutpunkt Endpoint

🗺️ 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 OMNI_TOKEN_147 (217 detaljerade specifikationer)


📧 Support

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


👥 Bidragsgivare

Contributors

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

Star History Chart

🙏 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.tsLOCALES 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.


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