OmniRoute Dashboard # ๐Ÿš€ OmniRoute โ€” Gerbang AI Percuma ### Jangan sekali-kali berhenti mengekod. Penghalaan pintar ke **model AI PERCUMA & kos rendah** dengan sandaran automatik. _Proksi API universal anda โ€” satu titik akhir, 36+ pembekal, masa henti sifar._ **Penyelesaian Sembang โ€ข Pembenaman โ€ข Penjanaan Imej โ€ข Audio โ€ข Kedudukan Semula โ€ข 100% TypeScript** --- ### ๐Ÿค– Pembekal AI percuma untuk ejen pengekodan kegemaran anda _Sambungkan mana-mana alat IDE atau CLI berkuasa AI melalui OmniRoute โ€” get laluan API percuma untuk pengekodan tanpa had._
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
๐Ÿ“ก Semua ejen menyambung melalui http://localhost:20128/v1 atau http://cloud.omniroute.online/v1 atau model http://cloud.omniroute.online/v1 โ€”i_24_TOKEN dan satu โ€”i_konfigurasi kuota --- [![npm version](https://img.shields.io/npm/v/omniroute?color=cb3837&logo=npm)](https://www.npmjs.com/package/omniroute) [![Docker Hub](https://img.shields.io/docker/v/diegosouzapw/omniroute?label=Docker%20Hub&logo=docker&color=2496ED)](https://hub.docker.com/r/diegosouzapw/omniroute) [![License](https://img.shields.io/github/license/diegosouzapw/OmniRoute)](https://github.com/diegosouzapw/OmniRoute/blob/main/LICENSE) [![Website](https://img.shields.io/badge/Website-omniroute.online-blue?logo=google-chrome&logoColor=white)](https://omniroute.online) [![WhatsApp](https://img.shields.io/badge/WhatsApp-Community-25D366?logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) [๐ŸŒ Website](https://omniroute.online) โ€ข [๐Ÿš€ Quick Start](#-quick-start) โ€ข [๐Ÿ’ก Features](#-key-features) โ€ข [๐Ÿ“– Docs](#-documentation) โ€ข [๐Ÿ’ฐ Pricing](#-pricing-at-a-glance) โ€ข [๐Ÿ’ฌ WhatsApp](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) ๐ŸŒ **Available in:** ๐Ÿ‡บ๐Ÿ‡ธ [English](README.md) | ๐Ÿ‡ง๐Ÿ‡ท [Portuguรชs (Brasil)](README.pt-BR.md) | ๐Ÿ‡ช๐Ÿ‡ธ [Espaรฑol](README.es.md) | ๐Ÿ‡ซ๐Ÿ‡ท [Franรงais](README.fr.md) | ๐Ÿ‡ฎ๐Ÿ‡น [Italiano](README.it.md) | ๐Ÿ‡ท๐Ÿ‡บ [ะ ัƒััะบะธะน](README.ru.md) | ๐Ÿ‡จ๐Ÿ‡ณ [ไธญๆ–‡ (็ฎ€ไฝ“)](README.zh-CN.md) | ๐Ÿ‡ฉ๐Ÿ‡ช [Deutsch](README.de.md) | ๐Ÿ‡ฎ๐Ÿ‡ณ [เคนเคฟเคจเฅเคฆเฅ€](README.in.md) | ๐Ÿ‡น๐Ÿ‡ญ [เน„เธ—เธข](README.th.md) | ๐Ÿ‡บ๐Ÿ‡ฆ [ะฃะบั€ะฐั—ะฝััŒะบะฐ](README.uk-UA.md) | ๐Ÿ‡ธ๐Ÿ‡ฆ [ุงู„ุนุฑุจูŠุฉ](README.ar.md) | ๐Ÿ‡ฏ๐Ÿ‡ต [ๆ—ฅๆœฌ่ชž](README.ja.md) | ๐Ÿ‡ป๐Ÿ‡ณ [Tiแบฟng Viแป‡t](README.vi.md) | ๐Ÿ‡ง๐Ÿ‡ฌ [ะ‘ัŠะปะณะฐั€ัะบะธ](README.bg.md) | ๐Ÿ‡ฉ๐Ÿ‡ฐ [Dansk](README.da.md) | ๐Ÿ‡ซ๐Ÿ‡ฎ [Suomi](README.fi.md) | ๐Ÿ‡ฎ๐Ÿ‡ฑ [ืขื‘ืจื™ืช](README.he.md) | ๐Ÿ‡ญ๐Ÿ‡บ [Magyar](README.hu.md) | ๐Ÿ‡ฎ๐Ÿ‡ฉ [Bahasa Indonesia](README.id.md) | ๐Ÿ‡ฐ๐Ÿ‡ท [ํ•œ๊ตญ์–ด](README.ko.md) | ๐Ÿ‡ฒ๐Ÿ‡พ [Bahasa Melayu](README.ms.md) | ๐Ÿ‡ณ๐Ÿ‡ฑ [Nederlands](README.nl.md) | ๐Ÿ‡ณ๐Ÿ‡ด [Norsk](README.no.md) | ๐Ÿ‡ต๐Ÿ‡น [Portuguรชs (Portugal)](README.pt.md) | ๐Ÿ‡ท๐Ÿ‡ด [Romรขnฤƒ](README.ro.md) | ๐Ÿ‡ต๐Ÿ‡ฑ [Polski](README.pl.md) | ๐Ÿ‡ธ๐Ÿ‡ฐ [Slovenฤina](README.sk.md) | ๐Ÿ‡ธ๐Ÿ‡ช [Svenska](README.sv.md) | ๐Ÿ‡ต๐Ÿ‡ญ [Filipino](README.phi.md)
--- ## ๐Ÿค” Mengapa OmniRoute? **Berhenti membazir wang dan mencapai had:** - Kuota langganan tamat tempoh tidak digunakan setiap bulan - Had kadar menghalang anda pertengahan pengekodan - API Mahal ($20-50/bulan bagi setiap pembekal) - Pertukaran manual antara pembekal **OmniRoute menyelesaikan ini:** - โœ… **Maksimumkan langganan** - Jejaki kuota, gunakan setiap bit sebelum ditetapkan semula - โœ… **Auto sandaran** - Langganan โ†’ Kunci API โ†’ Murah โ†’ Percuma, masa henti sifar - โœ… **Berbilang akaun** - Round-robin antara akaun bagi setiap pembekal - โœ… **Universal** - Berfungsi dengan Kod Claude, Codex, Gemini CLI, Kursor, Cline, OpenClaw, sebarang alat CLI --- ## ๐Ÿ”„ Cara Ia Berfungsi ``` โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ Your CLI โ”‚ (Claude Code, Codex, Gemini CLI, OpenClaw, Cursor, Cline...) โ”‚ Tool โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚ http://localhost:20128/v1 โ†“ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ OmniRoute (Smart Router) โ”‚ โ”‚ โ€ข Format translation (OpenAI โ†” Claude) โ”‚ โ”‚ โ€ข Quota tracking + Embeddings + Images โ”‚ โ”‚ โ€ข Auto token refresh โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚ โ”œโ”€โ†’ [Tier 1: SUBSCRIPTION] Claude Code, Codex, Gemini CLI โ”‚ โ†“ quota exhausted โ”œโ”€โ†’ [Tier 2: API KEY] DeepSeek, Groq, xAI, Mistral, NVIDIA NIM, etc. โ”‚ โ†“ budget limit โ”œโ”€โ†’ [Tier 3: CHEAP] GLM ($0.6/1M), MiniMax ($0.2/1M) โ”‚ โ†“ budget limit โ””โ”€โ†’ [Tier 4: FREE] iFlow, Qwen, Kiro (unlimited) Result: Never stop coding, minimal cost ``` --- ## ๐ŸŽฏ What OmniRoute Solves โ€” 16 Real Pain Points > **Every developer using AI tools faces these problems daily.** OmniRoute was built to solve them all โ€” from cost overruns to regional blocks, from broken OAuth flows to zero observability.
๐Ÿ’ธ 1. "I pay for an expensive subscription but still get interrupted by limits" Developers pay $20โ€“200/month for Claude Pro, Codex Pro, or GitHub Copilot. Even paying, quota has a ceiling โ€” 5h of usage, weekly limits, or per-minute rate limits. Mid-coding session, the provider stops responding and the developer loses flow and productivity. **How OmniRoute solves it:** - **Smart 4-Tier Fallback** โ€” If subscription quota runs out, automatically redirects to API Key โ†’ Cheap โ†’ Free with zero manual intervention - **Real-Time Quota Tracking** โ€” Shows token consumption in real-time with reset countdown (5h, daily, weekly) - **Multi-Account Support** โ€” Multiple accounts per provider with auto round-robin โ€” when one runs out, switches to the next - **Custom Combos** โ€” Customizable fallback chains with 6 balancing strategies (fill-first, round-robin, P2C, random, least-used, cost-optimized) - **Codex Business Quotas** โ€” Business/Team workspace quota monitoring directly in the dashboard
๐Ÿ”Œ 2. "I need to use multiple providers but each has a different API" OpenAI uses one format, Claude (Anthropic) uses another, Gemini yet another. If a dev wants to test models from different providers or fallback between them, they need to reconfigure SDKs, change endpoints, deal with incompatible formats. Custom providers (FriendLI, NIM) have non-standard model endpoints. **How OmniRoute solves it:** - **Unified Endpoint** โ€” A single `http://localhost:20128/v1` serves as proxy for all 36+ providers - **Format Translation** โ€” Automatic and transparent: OpenAI โ†” Claude โ†” Gemini โ†” Responses API - **Response Sanitization** โ€” Strips non-standard fields (`x_groq`, `usage_breakdown`, `service_tier`) that break OpenAI SDK v1.83+ - **Role Normalization** โ€” Converts `developer` โ†’ `system` for non-OpenAI providers; `system` โ†’ `user` for GLM/ERNIE - **Think Tag Extraction** โ€” Extracts `` blocks from models like DeepSeek R1 into standardized `reasoning_content` - **Structured Output for Gemini** โ€” `json_schema` โ†’ `responseMimeType`/`responseSchema` automatic conversion - **`stream` defaults to `false`** โ€” Aligns with OpenAI spec, avoiding unexpected SSE in Python/Rust/Go SDKs
๐ŸŒ 3. "My AI provider blocks my region/country" Providers like OpenAI/Codex block access from certain geographic regions. Users get errors like `unsupported_country_region_territory` during OAuth and API connections. This is especially frustrating for developers from developing countries. **How OmniRoute solves it:** - **3-Level Proxy Config** โ€” Configurable proxy at 3 levels: global (all traffic), per-provider (one provider only), and per-connection/key - **Color-Coded Proxy Badges** โ€” Visual indicators: ๐ŸŸข global proxy, ๐ŸŸก provider proxy, ๐Ÿ”ต connection proxy, always showing the IP - **OAuth Token Exchange Through Proxy** โ€” OAuth flow also goes through the proxy, solving `unsupported_country_region_territory` - **Connection Tests via Proxy** โ€” Connection tests use the configured proxy (no more direct bypass) - **SOCKS5 Support** โ€” Full SOCKS5 proxy support for outbound routing - **TLS Fingerprint Spoofing** โ€” Browser-like TLS fingerprint via `wreq-js` to bypass bot detection
๐Ÿ†“ 4. "I want to use AI for coding but I have no money" Not everyone can pay $20โ€“200/month for AI subscriptions. Students, devs from emerging countries, hobbyists, and freelancers need access to quality models at zero cost. **How OmniRoute solves it:** - **Free Tier Providers Built-in** โ€” Native support for 100% free providers: iFlow (8 unlimited models), Qwen (3 unlimited models), Kiro (Claude for free), Gemini CLI (180K/month free) - **Free-Only Combos** โ€” Chain `gc/gemini-3-flash โ†’ if/kimi-k2-thinking โ†’ qw/qwen3-coder-plus` = $0/month with zero downtime - **NVIDIA NIM Free Credits** โ€” 1000 free credits integrated - **Cost Optimized Strategy** โ€” Routing strategy that automatically chooses the cheapest available provider
๐Ÿ”’ 5. "I need to protect my AI gateway from unauthorized access" When exposing an AI gateway to the network (LAN, VPS, Docker), anyone with the address can consume the developer's tokens/quota. Without protection, APIs are vulnerable to misuse, prompt injection, and abuse. **How OmniRoute solves it:** - **API Key Management** โ€” Generation, rotation, and scoping per provider with a dedicated `/dashboard/api-manager` page - **Model-Level Permissions** โ€” Restrict API keys to specific models (`openai/*`, wildcard patterns), with Allow All/Restrict toggle - **API Endpoint Protection** โ€” Require a key for `/v1/models` and block specific providers from the listing - **Auth Guard + CSRF Protection** โ€” All dashboard routes protected with `withAuth` middleware + CSRF tokens - **Rate Limiter** โ€” Per-IP rate limiting with configurable windows - **IP Filtering** โ€” Allowlist/blocklist for access control - **Prompt Injection Guard** โ€” Sanitization against malicious prompt patterns - **AES-256-GCM Encryption** โ€” Credentials encrypted at rest
๐Ÿ›‘ 6. "My provider went down and I lost my coding flow" AI providers can become unstable, return 5xx errors, or hit temporary rate limits. If a dev depends on a single provider, they're interrupted. Without circuit breakers, repeated retries can crash the application. **How OmniRoute solves it:** - **Circuit Breaker per-provider** โ€” Auto-open/close with configurable thresholds and cooldown (Closed/Open/Half-Open) - **Exponential Backoff** โ€” Progressive retry delays - **Anti-Thundering Herd** โ€” Mutex + semaphore protection against concurrent retry storms - **Combo Fallback Chains** โ€” If the primary provider fails, automatically falls through the chain with no intervention - **Combo Circuit Breaker** โ€” Auto-disables failing providers within a combo chain - **Health Dashboard** โ€” Uptime monitoring, circuit breaker states, lockouts, cache stats, p50/p95/p99 latency
๐Ÿ”ง 7. "Configuring each AI tool is tedious and repetitive" Developers use Cursor, Claude Code, Codex CLI, OpenClaw, Gemini CLI, Kilo Code... Each tool needs a different config (API endpoint, key, model). Reconfiguring when switching providers or models is a waste of time. **How OmniRoute solves it:** - **CLI Tools Dashboard** โ€” Dedicated page with one-click setup for Claude Code, Codex CLI, OpenClaw, Kilo Code, Antigravity, Cline - **GitHub Copilot Config Generator** โ€” Generates `chatLanguageModels.json` for VS Code with bulk model selection - **Onboarding Wizard** โ€” Guided 4-step setup for first-time users - **One endpoint, all models** โ€” Configure `http://localhost:20128/v1` once, access 36+ providers
๐Ÿ”‘ 8. "Managing OAuth tokens from multiple providers is hell" Claude Code, Codex, Gemini CLI, Copilot โ€” all use OAuth 2.0 with expiring tokens. Developers need to re-authenticate constantly, deal with `client_secret is missing`, `redirect_uri_mismatch`, and failures on remote servers. OAuth on LAN/VPS is particularly problematic. **How OmniRoute solves it:** - **Auto Token Refresh** โ€” OAuth tokens refresh in background before expiration - **OAuth 2.0 (PKCE) Built-in** โ€” Automatic flow for Claude Code, Codex, Gemini CLI, Copilot, Kiro, Qwen, iFlow - **Multi-Account OAuth** โ€” Multiple accounts per provider via JWT/ID token extraction - **OAuth LAN/Remote Fix** โ€” Private IP detection for `redirect_uri` + manual URL mode for remote servers - **OAuth Behind Nginx** โ€” Uses `window.location.origin` for reverse proxy compatibility - **Remote OAuth Guide** โ€” Step-by-step guide for Google Cloud credentials on VPS/Docker
๐Ÿ“Š 9. "I don't know how much I'm spending or where" Developers use multiple paid providers but have no unified view of spending. Each provider has its own billing dashboard, but there's no consolidated view. Unexpected costs can pile up. **How OmniRoute solves it:** - **Cost Analytics Dashboard** โ€” Per-token cost tracking and budget management per provider - **Budget Limits per Tier** โ€” Spending ceiling per tier that triggers automatic fallback - **Per-Model Pricing Configuration** โ€” Configurable prices per model - **Usage Statistics Per API Key** โ€” Request count and last-used timestamp per key - **Analytics Dashboard** โ€” Stat cards, model usage chart, provider table with success rates and latency
๐Ÿ› 10. "I can't diagnose errors and problems in AI calls" When a call fails, the dev doesn't know if it was a rate limit, expired token, wrong format, or provider error. Fragmented logs across different terminals. Without observability, debugging is trial-and-error. **How OmniRoute solves it:** - **Unified Logs Dashboard** โ€” 4 tabs: Request Logs, Proxy Logs, Audit Logs, Console - **Console Log Viewer** โ€” Real-time terminal-style viewer with color-coded levels, auto-scroll, search, filter - **SQLite Proxy Logs** โ€” Persistent logs that survive server restarts - **Translator Playground** โ€” 4 debugging modes: Playground (format translation), Chat Tester (round-trip), Test Bench (batch), Live Monitor (real-time) - **Request Telemetry** โ€” p50/p95/p99 latency + X-Request-Id tracing - **File-Based Logging with Rotation** โ€” Console interceptor captures everything to JSON log with size-based rotation
๐Ÿ—๏ธ 11. "Deploying and maintaining the gateway is complex" Installing, configuring, and maintaining an AI proxy across different environments (local, VPS, Docker, cloud) is labor-intensive. Problems like hardcoded paths, `EACCES` on directories, port conflicts, and cross-platform builds add friction. **How OmniRoute solves it:** - **npm global install** โ€” `npm install -g omniroute && omniroute` โ€” done - **Docker Multi-Platform** โ€” AMD64 + ARM64 native (Apple Silicon, AWS Graviton, Raspberry Pi) - **Docker Compose Profiles** โ€” `base` (no CLI tools) and `cli` (with Claude Code, Codex, OpenClaw) - **Electron Desktop App** โ€” Native app for Windows/macOS/Linux with system tray, auto-start, offline mode - **Split-Port Mode** โ€” API and Dashboard on separate ports for advanced scenarios (reverse proxy, container networking) - **Cloud Sync** โ€” Config synchronization across devices via Cloudflare Workers - **DB Backups** โ€” Automatic backup, restore, export and import of all settings
๐ŸŒ 12. "The interface is English-only and my team doesn't speak English" Teams in non-English-speaking countries, especially in Latin America, Asia, and Europe, struggle with English-only interfaces. Language barriers reduce adoption and increase configuration errors. **How OmniRoute solves it:** - **Dashboard i18n โ€” 30 Languages** โ€” All 500+ keys translated including Arabic, Bulgarian, Danish, German, Spanish, Finnish, French, Hebrew, Hindi, Hungarian, Indonesian, Italian, Japanese, Korean, Malay, Dutch, Norwegian, Polish, Portuguese (PT/BR), Romanian, Russian, Slovak, Swedish, Thai, Ukrainian, Vietnamese, Chinese, Filipino, English - **RTL Support** โ€” Right-to-left support for Arabic and Hebrew - **Multi-Language READMEs** โ€” 30 complete documentation translations - **Language Selector** โ€” Globe icon in header for real-time switching
๐Ÿ”„ 13. "I need more than chat โ€” I need embeddings, images, audio" AI isn't just chat completion. Devs need to generate images, transcribe audio, create embeddings for RAG, rerank documents, and moderate content. Each API has a different endpoint and format. **How OmniRoute solves it:** - **Embeddings** โ€” `/v1/embeddings` with 6 providers and 9+ models - **Image Generation** โ€” `/v1/images/generations` with 4 providers and 9+ models - **Audio Transcription** โ€” `/v1/audio/transcriptions` โ€” Whisper-compatible - **Text-to-Speech** โ€” `/v1/audio/speech` โ€” Multi-provider audio synthesis - **Moderations** โ€” `/v1/moderations` โ€” Content safety checks - **Reranking** โ€” `/v1/rerank` โ€” Document relevance reranking - **Responses API** โ€” Full `/v1/responses` support for Codex
๐Ÿงช 14. "I have no way to test and compare quality across models" Developers want to know which model is best for their use case โ€” code, translation, reasoning โ€” but comparing manually is slow. No integrated eval tools exist. **How OmniRoute solves it:** - **LLM Evaluations** โ€” Golden set testing with 10 pre-loaded cases covering greetings, math, geography, code generation, JSON compliance, translation, markdown, safety refusal - **4 Match Strategies** โ€” `exact`, `contains`, `regex`, `custom` (JS function) - **Translator Playground Test Bench** โ€” Batch testing with multiple inputs and expected outputs, cross-provider comparison - **Chat Tester** โ€” Full round-trip with visual response rendering - **Live Monitor** โ€” Real-time stream of all requests flowing through the proxy
๐Ÿ“ˆ 15. "I need to scale without losing performance" As request volume grows, without caching the same questions generate duplicate costs. Without idempotency, duplicate requests waste processing. Per-provider rate limits must be respected. **How OmniRoute solves it:** - **Semantic Cache** โ€” Two-tier cache (signature + semantic) reduces cost and latency - **Request Idempotency** โ€” 5s deduplication window for identical requests - **Rate Limit Detection** โ€” Per-provider RPM, min gap, and max concurrent tracking - **Editable Rate Limits** โ€” Configurable defaults in Settings โ†’ Resilience with persistence - **API Key Validation Cache** โ€” 3-tier cache for production performance - **Health Dashboard with Telemetry** โ€” p50/p95/p99 latency, cache stats, uptime
๐Ÿค– 16. "I want to control model behavior globally" Developers who want all responses in a specific language, with a specific tone, or want to limit reasoning tokens. Configuring this in every tool/request is impractical. **How OmniRoute solves it:** - **System Prompt Injection** โ€” Global prompt applied to all requests - **Thinking Budget Validation** โ€” Reasoning token allocation control per request (passthrough, auto, custom, adaptive) - **6 Routing Strategies** โ€” Global strategies that determine how requests are distributed - **Wildcard Router** โ€” `provider/*` patterns route dynamically to any provider - **Combo Enable/Disable Toggle** โ€” Toggle combos directly from the dashboard - **Provider Toggle** โ€” Enable/disable all connections for a provider with one click - **Blocked Providers** โ€” Exclude specific providers from `/v1/models` listing
## โšก Mula Pantas **1. Pasang secara global:** ```bash npm install -g omniroute omniroute ``` ๐ŸŽ‰ Papan pemuka dibuka pada `http://localhost:20128` | Perintah | Penerangan | | ----------------------- | ---------------------------------- | | `omniroute` | Mulakan pelayan (port lalai 20128) | | `omniroute --port 3000` | Gunakan port tersuai | | `omniroute --no-open` | Jangan auto buka penyemak imbas | | `omniroute --help` | Tunjukkan bantuan | **2. Sambungkan pembekal PERCUMA:** Papan pemuka โ†’ Pembekal โ†’ Sambung **Kod Claude** atau **Antigraviti** โ†’ Log masuk OAuth โ†’ Selesai! **3. Gunakan dalam alat CLI anda:** ``` Claude Code/Codex/Gemini CLI/OpenClaw/Cursor/Cline Settings: Endpoint: http://localhost:20128/v1 API Key: [copy from dashboard] Model: if/kimi-k2-thinking ``` **Itu sahaja!** Mulakan pengekodan dengan model AI PERCUMA. **Alternatif โ€” dijalankan dari sumber:** ```bash cp .env.example .env npm install PORT=20128 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run dev ``` --- ## ๐Ÿณ Docker OmniRoute tersedia sebagai imej Docker awam pada [Docker Hub](https://hub.docker.com/r/diegosouzapw/omniroute). **Larian pantas:** ```bash docker run -d \ --name omniroute \ --restart unless-stopped \ -p 20128:20128 \ -v omniroute-data:/app/data \ diegosouzapw/omniroute:latest ``` **Dengan fail persekitaran:** ```bash # Copy and edit .env first cp .env.example .env docker run -d \ --name omniroute \ --restart unless-stopped \ --env-file .env \ -p 20128:20128 \ -v omniroute-data:/app/data \ diegosouzapw/omniroute:latest ``` **Menggunakan 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 ``` | Imej | Tag | Saiz | Penerangan | | ------------------------ | -------- | ------ | ----------------------- | | `diegosouzapw/omniroute` | `latest` | ~250MB | Keluaran stabil terkini | | `diegosouzapw/omniroute` | `1.0.3` | ~250MB | Versi semasa | --- --- ## ๐Ÿ–ฅ๏ธ Desktop App โ€” Offline & Always-On > ๐Ÿ†• **NEW!** OmniRoute is now available as a **native desktop application** for Windows, macOS, and Linux. - ๐Ÿ–ฅ๏ธ **Native Window** โ€” Dedicated app window with system tray integration - ๐Ÿ”„ **Auto-Start** โ€” Launch OmniRoute on system login - ๐Ÿ”” **Native Notifications** โ€” Get alerts for quota exhaustion or provider issues - โšก **One-Click Install** โ€” NSIS (Windows), DMG (macOS), AppImage (Linux) - ๐ŸŒ **Offline Mode** โ€” Works fully offline with bundled server ```bash npm run electron:dev # Development mode npm run electron:build # Current platform npm run electron:build:win # Windows (.exe) npm run electron:build:mac # macOS (.dmg) npm run electron:build:linux # Linux (.AppImage) ``` ๐Ÿ“– Full documentation: [`electron/README.md`](electron/README.md) --- ## ๐Ÿ’ฐ Sekilas Pandang Harga | Peringkat | Pembekal | Kos | Set Semula Kuota | Terbaik Untuk | | ---------------- | ---------------- | ---------------------------- | ------------------ | ----------------------- | | **๐Ÿ’ณ LANGGANAN** | Kod Claude (Pro) | $20/bln | 5j + mingguan | Sudah melanggan | | | Codex (Plus/Pro) | $20-200/bln | 5j + mingguan | Pengguna OpenAI | | | Gemini CLI | **PERCUMA** | 180K/bln + 1K/hari | Semua orang! | | | GitHub Copilot | $10-19/bln | Bulanan | Pengguna GitHub | | **๐Ÿ”‘ KUNCI API** | NVIDIA NIM | **PERCUMA** (1000 kredit) | Satu kali | Ujian peringkat percuma | | | DeepSeek | Bayar setiap penggunaan | Tiada | Harga/kualiti terbaik | | | Groq | Peringkat percuma + berbayar | Kadar terhad | Inferens sangat pantas | | | xAI (Grok) | Bayar setiap penggunaan | Tiada | Model Grok | | | Mistral | Peringkat percuma + berbayar | Kadar terhad | AI Eropah | | | OpenRouter | Bayar setiap penggunaan | Tiada | 100+ model | | **๐Ÿ’ฐ MURAH** | GLM-4.7 | $0.6/1J | Setiap hari 10AM | Sandaran belanjawan | | | MiniMax M2.1 | $0.2/1J | 5 jam bergolek | Pilihan termurah | | | Kimi K2 | $9/bln flat | 10 juta token/bln | Kos yang boleh diramal | | **๐Ÿ†“ PERCUMA** | iFlow | $0 | tanpa had | 8 model percuma | | | Qwen | $0 | tanpa had | 3 model percuma | | | Kiro | $0 | tanpa had | Claude percuma | **๐Ÿ’ก Petua Pro:** Mulakan dengan Gemini CLI (180K percuma/bulan) + iFlow (percuma tanpa had) kombo = $0 kos! --- ## ๐Ÿ’ก Ciri Utama ### ๐Ÿง  Penghalaan Teras & Kepintaran | Ciri | Apa yang Dilakukan | | ---------------------------------- | --------------------------------------------------------------------------------------------- | | ๐ŸŽฏ **Smart 4-Tier Fallback** | Laluan automatik: Langganan โ†’ Kunci API โ†’ Murah โ†’ Percuma | | ๐Ÿ“Š **Penjejakan Kuota Masa Nyata** | Kiraan token langsung + tetapan semula kira detik setiap pembekal | | ๐Ÿ”„ **Terjemahan Format** | OpenAI โ†” Claude โ†” Gemini โ†” Kursor โ†” Kiro lancar + pembersihan tindak balas | | ๐Ÿ‘ฅ **Sokongan Berbilang Akaun** | Berbilang akaun bagi setiap pembekal dengan pemilihan pintar | | ๐Ÿ”„ **Muat Semula Token Auto** | Token OAuth dimuat semula secara automatik dengan cuba semula | | ๐ŸŽจ **Kombo Tersuai** | 6 strategi: isikan dahulu, round-robin, p2c, rawak, paling kurang digunakan, dioptimumkan kos | | ๐Ÿงฉ **Model Tersuai** | Tambahkan sebarang ID model pada mana-mana pembekal | | ๐ŸŒ **Penghala Wildcard** | Halakan corak `provider/*` kepada mana-mana pembekal secara dinamik | | ๐Ÿง  **Anggaran Berfikir** | Mod laluan, auto, tersuai dan adaptif untuk model penaakulan | | ๐Ÿ’ฌ **System Prompt Suntikan** | Gesaan sistem global digunakan merentas semua permintaan | | ๐Ÿ“„ **API Respons** | Sokongan OpenAI Responses API (`/v1/responses`) penuh untuk Codex | ### ๐ŸŽต API Berbilang Modal | Ciri | Apa yang Dilakukan | | ------------------------ | ------------------------------------------------------ | | ๐Ÿ–ผ๏ธ **Penjanaan Imej** | `/v1/images/generations` โ€” 4 pembekal, 9+ model | | ๐Ÿ“ **Pembenaman** | `/v1/embeddings` โ€” 6 pembekal, 9+ model | | ๐ŸŽค **Transkripsi Audio** | `/v1/audio/transcriptions` โ€” Serasi dengan bisikan | | ๐Ÿ”Š **Teks-ke-Ucapan** | `/v1/audio/speech` โ€” Sintesis audio berbilang pembekal | | ๐Ÿ›ก๏ธ **Kesederhanaan** | `/v1/moderations` โ€” Pemeriksaan keselamatan kandungan | | ๐Ÿ”€ **Penyusunan semula** | `/v1/rerank` โ€” Penarafan semula perkaitan dokumen | ### ๐Ÿ›ก๏ธ Ketahanan & Keselamatan | Ciri | Apa yang Dilakukan | | ----------------------------------- | ----------------------------------------------------------------------------------- | | ๐Ÿ”Œ **Pemutus Litar** | Auto buka/tutup setiap pembekal dengan ambang boleh dikonfigurasikan | | ๐Ÿ›ก๏ธ **Kawanan Anti Guruh** | Had kadar Mutex + semaphore untuk pembekal kunci API | | ๐Ÿง  **Cache Semantik** | Cache dua peringkat (tandatangan + semantik) mengurangkan kos & kependaman | | โšก **Minta Idepotency** | Tetingkap pendua 5s untuk permintaan pendua | | ๐Ÿ”’ **TLS Fingerprint Spoofing** | Pintas pengesanan bot berasaskan TLS melalui wreq-js | | ๐ŸŒ **Penapisan IP** | Senarai kebenaran/senarai sekat untuk kawalan akses API | | ๐Ÿ“Š **Had Kadar Boleh Diedit** | RPM boleh dikonfigurasikan, jurang min dan serentak maksimum pada tahap sistem | | ๐Ÿ›ก **Perlindungan Titik Akhir API** | Gating pengesahan + penyekatan penyedia untuk titik akhir `/models` | | ๐Ÿ”’ **Keterlihatan Proksi** | Lencana berkod warna: ๐ŸŸข global, ๐ŸŸก pembekal, ๐Ÿ”ต setiap sambungan dengan paparan IP | | ๐ŸŒ **Konfigurasi Proksi 3 Tahap** | Konfigurasikan proksi pada peringkat global, setiap pembekal atau setiap sambungan | ### ๐Ÿ“Š Kebolehlihatan & Analitis | Ciri | Apa yang Dilakukan | | --------------------------------- | ------------------------------------------------------------------------------ | | ๐Ÿ“ **Minta Pembalakan** | Mod nyahpepijat dengan log permintaan/tindak balas penuh | | ๐Ÿ’พ **Log Proksi SQLite** | Log proksi berterusan bertahan dimulakan semula pelayan | | ๐Ÿ“Š **Papan Pemuka Analitik** | Dikuasakan semula: kad statistik, carta penggunaan model, jadual pembekal | | ๐Ÿ“ˆ **Penjejakan Kemajuan** | Ikut serta acara kemajuan SSE untuk penstriman | | ๐Ÿงช **Penilaian LLM** | Ujian set emas dengan 4 strategi perlawanan | | ๐Ÿ” **Minta Telemetri** | p50/p95/p99 pengagregatan kependaman + pengesanan X-Request-Id | | ๐Ÿ“‹ **Papan Pemuka Log** | Halaman 4 tab bersatu: Log Permintaan, Log Proksi, Log Audit, Konsol | | ๐Ÿ–ฅ๏ธ **Pemapar Log Konsol** | Pemapar gaya terminal masa nyata dengan penapis tahap, carian, tatal automatik | | ๐Ÿ“‘ **Pengelogan Berasaskan Fail** | Pemintas konsol menangkap semua output ke fail log JSON dengan putaran | | ๐Ÿฅ **Papan Pemuka Kesihatan** | Masa beroperasi sistem, keadaan pemutus litar, sekatan keluar, statistik cache | | ๐Ÿ’ฐ **Penjejakan Kos** | Pengurusan belanjawan + konfigurasi harga setiap model | ### โ˜๏ธ Penyerahan & Penyegerakan | Ciri | Apa yang Dilakukan | | ----------------------------- | ----------------------------------------------------------------------- | | ๐Ÿ’พ **Penyegerakan Awan** | Segerakkan konfigurasi merentas peranti melalui Cloudflare Workers | | ๐ŸŒ **Kerahkan Di Mana-mana** | Localhost, VPS, Docker, Pekerja Cloudflare | | ๐Ÿ”‘ **Pengurusan Kunci API** | Jana, putar dan skop kunci API bagi setiap pembekal | | ๐Ÿง™ **Onboarding Wizard** | Persediaan berpandu 4 langkah untuk pengguna kali pertama | | ๐Ÿ”ง **Papan Pemuka Alat CLI** | Konfigurasi satu klik Claude, Codex, Cline, OpenClaw, Kilo, Antigravity | | ๐Ÿ”„ **Sandaran DB** | Sandaran automatik, pulihkan, eksport & import untuk semua tetapan | | ๐ŸŒ **Pengantarabangsaan** | i18n penuh dengan next-intl โ€” sokongan Inggeris + Portugis (Brazil) | | ๐ŸŒ **Pemilih Bahasa** | Ikon glob dalam pengepala untuk penukaran bahasa masa nyata (๐Ÿ‡บ๐Ÿ‡ธ/๐Ÿ‡ง๐Ÿ‡ท) | | ๐Ÿ“‚ **Direktori Data Tersuai** | `DATA_DIR` env var untuk mengatasi laluan storan lalai `~/.omniroute` |
๐Ÿ“– Butiran Ciri ### ๐ŸŽฏ Kemunduran 4 Peringkat Pintar Cipta gabungan dengan sandaran automatik: ``` 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 ``` ### ๐Ÿ“Š Penjejakan Kuota Masa Nyata - Penggunaan token setiap pembekal - Tetapkan semula kira detik (5 jam, harian, mingguan) - Anggaran kos untuk peringkat berbayar - Laporan perbelanjaan bulanan ### ๐Ÿ”„ Terjemahan Format Terjemahan lancar antara format: - **OpenAI** โ†” **Claude** โ†” **Gemini** โ†” **Respons OpenAI** - Alat CLI anda menghantar format OpenAI โ†’ OmniRoute menterjemah โ†’ Pembekal menerima format asli - Berfungsi dengan mana-mana alat yang menyokong titik akhir OpenAI tersuai - **Pembersihan tindak balas** โ€” Menghapuskan medan bukan standard untuk keserasian OpenAI SDK yang ketat - **Penormalan peranan** โ€” `developer` โ†’ `system` untuk bukan OpenAI; `system` โ†’ `user` untuk model GLM/ERNIE - **Pengekstrakan teg Think** โ€” `` blok โ†’ `reasoning_content` untuk model pemikiran - **Output berstruktur** โ€” `json_schema` โ†’ Gemini's `responseMimeType`/`responseSchema` ### ๐Ÿ‘ฅ Sokongan Berbilang Akaun - Tambah berbilang akaun bagi setiap pembekal - Auto round-robin atau penghalaan berasaskan keutamaan - Berundur ke akaun seterusnya apabila seseorang mencapai kuota ### ๐Ÿ”„ Muat Semula Token Auto - Token OAuth dimuat semula secara automatik sebelum tamat tempoh - Tiada pengesahan semula manual diperlukan - Pengalaman lancar merentas semua pembekal ### ๐ŸŽจ Kombo Tersuai - Buat kombinasi model tanpa had - 6 strategi: isikan dahulu, round-robin, kuasa dua pilihan, rawak, paling kurang digunakan, dioptimumkan kos - Kongsi gabungan merentas peranti dengan Cloud Sync ### ๐Ÿฅ Papan Pemuka Kesihatan - Status sistem (masa hidup, versi, penggunaan memori) - Keadaan pemutus litar bagi setiap pembekal (Tertutup/Terbuka/Separuh Terbuka) - Status had kadar dan sekatan aktif - Statistik cache tandatangan - Telemetri kependaman (p50/p95/p99) + cache segera - Tetapkan semula status kesihatan dengan satu klik ### ๐Ÿ”ง Taman Permainan Penterjemah OmniRoute termasuk Taman Permainan Penterjemah terbina dalam yang berkuasa dengan **4 mod** untuk penyahpepijatan, ujian dan pemantauan terjemahan API: | Mod | Penerangan | | ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **๐Ÿ’ป Taman permainan** | Terjemahan format langsung โ€” tampal mana-mana badan permintaan API dan lihat serta-merta cara OmniRoute menterjemahkannya antara format pembekal (OpenAI โ†” Claude โ†” Gemini โ†” Responses API). Termasuk templat contoh dan pengesanan automatik format. | | **๐Ÿ’ฌ Penguji Sembang** | Hantar permintaan sembang sebenar melalui OmniRoute dan lihat perjalanan pergi balik penuh: input anda, permintaan yang diterjemahkan, respons pembekal dan balasan yang diterjemahkan kembali. Tidak ternilai untuk mengesahkan penghalaan kombo. | | **๐Ÿงช Bangku Ujian** | Mod ujian kelompok โ€” tentukan berbilang kes ujian dengan input dan output yang dijangkakan berbeza, jalankan semuanya sekali gus dan bandingkan hasil merentas pembekal dan model. | | **๐Ÿ“ฑ Pemantau Langsung** | Pemantauan permintaan masa nyata โ€” tonton permintaan masuk semasa ia mengalir melalui OmniRoute, lihat terjemahan format berlaku secara langsung dan kenal pasti isu serta-merta. | **Akses:** Papan Pemuka โ†’ Penterjemah (bar sisi) ### ๐Ÿ’พ Penyegerakan Awan - Penyegerakan penyedia, gabungan dan tetapan merentas peranti - Penyegerakan latar belakang automatik - Storan yang disulitkan selamat
--- ## ๐ŸŽฏ Kes Penggunaan ### Kes 1: "Saya mempunyai langganan Claude Pro" **Masalah:** Kuota tamat tempoh tidak digunakan, had kadar semasa pengekodan berat ``` 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 ``` ### Kes 2: "Saya mahu kos sifar" **Masalah:** Tidak mampu membayar langganan, memerlukan pengekodan AI yang boleh dipercayai ``` 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 ``` ### Kes 3: "Saya memerlukan pengekodan 24/7, tiada gangguan" **Masalah:** Tarikh akhir, tidak mampu membayar masa henti ``` 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 ``` ### Kes 4: "Saya mahukan AI PERCUMA dalam OpenClaw" **Masalah:** Memerlukan pembantu AI dalam apl pemesejan, percuma sepenuhnya ``` 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... ``` --- ## ๐Ÿ“– Panduan Persediaan
๐Ÿ’ณ Pembekal Langganan ### Kod Claude (Pro/Max) ```bash Dashboard โ†’ Providers โ†’ Connect Claude Code โ†’ OAuth login โ†’ Auto token refresh โ†’ 5-hour + weekly quota tracking Models: cc/claude-opus-4-6 cc/claude-sonnet-4-5-20250929 cc/claude-haiku-4-5-20251001 ``` **Petua Pro:** Gunakan Opus untuk tugas yang rumit, Sonnet untuk kelajuan. OmniRoute menjejaki kuota setiap model! ### OpenAI Codex (Plus/Pro) ```bash Dashboard โ†’ Providers โ†’ Connect Codex โ†’ OAuth login (port 1455) โ†’ 5-hour + weekly reset Models: cx/gpt-5.2-codex cx/gpt-5.1-codex-max ``` ### Gemini CLI (PERCUMA 180K/bulan!) ```bash Dashboard โ†’ Providers โ†’ Connect Gemini CLI โ†’ Google OAuth โ†’ 180K completions/month + 1K/day Models: gc/gemini-3-flash-preview gc/gemini-2.5-pro ``` **Nilai Terbaik:** Peringkat percuma yang besar! Gunakan ini sebelum peringkat berbayar. ### Copilot GitHub ```bash Dashboard โ†’ Providers โ†’ Connect GitHub โ†’ OAuth via GitHub โ†’ Monthly reset (1st of month) Models: gh/gpt-5 gh/claude-4.5-sonnet gh/gemini-3-pro ```
๐Ÿ”‘ Pembekal Kunci API ### NVIDIA NIM (PERCUMA 1000 kredit!) 1. Daftar: [build.nvidia.com](https://build.nvidia.com) 2. Dapatkan kunci API percuma (1000 kredit inferens disertakan) 3. Papan Pemuka โ†’ Tambah Pembekal โ†’ NVIDIA NIM: - Kunci API: `nvapi-your-key` **Model:** `nvidia/llama-3.3-70b-instruct`, `nvidia/mistral-7b-instruct` dan 50+ lagi **Petua Pro:** API serasi OpenAI โ€” berfungsi dengan lancar dengan terjemahan format OmniRoute! ### DeepSeek 1. Daftar: [platform.deepseek.com](https://platform.deepseek.com) 2. Dapatkan kunci API 3. Papan Pemuka โ†’ Tambah Pembekal โ†’ DeepSeek **Model:** `deepseek/deepseek-chat`, `deepseek/deepseek-coder` ### Groq (Tier Percuma Tersedia!) 1. Daftar: [console.groq.com](https://console.groq.com) 2. Dapatkan kunci API (termasuk peringkat percuma) 3. Papan Pemuka โ†’ Tambah Pembekal โ†’ Groq **Model:** `groq/llama-3.3-70b`, `groq/mixtral-8x7b` **Petua Pro:** Inferens sangat pantas โ€” terbaik untuk pengekodan masa nyata! ### OpenRouter (100+ Model) 1. Daftar: [openrouter.ai](https://openrouter.ai) 2. Dapatkan kunci API 3. Papan Pemuka โ†’ Tambah Pembekal โ†’ OpenRouter **Model:** Akses 100+ model daripada semua pembekal utama melalui kunci API tunggal.
๐Ÿ’ฐ Penyedia Murah (Sandaran) ### GLM-4.7 (Tetapan semula harian, $0.6/1J) 1. Daftar: [Zhipu AI](https://open.bigmodel.cn/) 2. Dapatkan kunci API daripada Pelan Pengekodan 3. Papan Pemuka โ†’ Tambah Kunci API: - Pembekal: `glm` - Kunci API: `your-key` **Gunakan:** `glm/glm-4.7` **Petua Pro:** Pelan Pengekodan menawarkan kuota 3ร— pada kos 1/7! Tetapkan semula setiap hari 10:00 AM. ### MiniMax M2.1 (tetapan semula 5j, $0.20/1J) 1. Daftar: [MiniMax](https://www.minimax.io/) 2. Dapatkan kunci API 3. Papan Pemuka โ†’ Tambah Kunci API **Gunakan:** `minimax/MiniMax-M2.1` **Petua Pro:** Pilihan termurah untuk konteks panjang (token 1M)! ### Kimi K2 ($9/bulan rata) 1. Langgan: [Moonshot AI](https://platform.moonshot.ai/) 2. Dapatkan kunci API 3. Papan Pemuka โ†’ Tambah Kunci API **Gunakan:** `kimi/kimi-latest` **Petua Pro:** Tetap $9/bulan untuk 10J token = $0.90/1J kos efektif!
๐Ÿ†“ Pembekal PERCUMA (Sandaran Kecemasan) ### iFlow (8 model PERCUMA) ```bash Dashboard โ†’ Connect iFlow โ†’ iFlow OAuth login โ†’ Unlimited usage Models: if/kimi-k2-thinking if/qwen3-coder-plus if/glm-4.7 if/minimax-m2 if/deepseek-r1 ``` ### Qwen (3 model PERCUMA) ```bash Dashboard โ†’ Connect Qwen โ†’ Device code authorization โ†’ Unlimited usage Models: qw/qwen3-coder-plus qw/qwen3-coder-flash ``` ### Kiro (Claude PERCUMA) ```bash Dashboard โ†’ Connect Kiro โ†’ AWS Builder ID or Google/GitHub โ†’ Unlimited usage Models: kr/claude-sonnet-4.5 kr/claude-haiku-4.5 ```
๐ŸŽจ Cipta Kombo ### Contoh 1: Maksimumkan Langganan โ†’ Sandaran Murah ``` 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 ``` ### Contoh 2: Percuma-Sahaja (Kos Sifar) ``` 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 Integrasi ### IDE Kursor ``` Settings โ†’ Models โ†’ Advanced: OpenAI API Base URL: http://localhost:20128/v1 OpenAI API Key: [from OmniRoute dashboard] Model: cc/claude-opus-4-6 ``` ### Kod Claude Gunakan halaman **Alat CLI** dalam papan pemuka untuk konfigurasi satu klik atau edit `~/.claude/settings.json` secara manual. ### Codex CLI ```bash export OPENAI_BASE_URL="http://localhost:20128" export OPENAI_API_KEY="your-omniroute-api-key" codex "your prompt" ``` ### OpenClaw **Pilihan 1 โ€” Papan Pemuka (disyorkan):** ``` Dashboard โ†’ CLI Tools โ†’ OpenClaw โ†’ Select Model โ†’ Apply ``` **Pilihan 2 โ€” Manual:** Edit `~/.openclaw/openclaw.json`: ```json { "models": { "providers": { "omniroute": { "baseUrl": "http://127.0.0.1:20128/v1", "apiKey": "sk_omniroute", "api": "openai-completions" } } } } ``` > **Nota:** OpenClaw hanya berfungsi dengan OmniRoute tempatan. Gunakan `127.0.0.1` dan bukannya `localhost` untuk mengelakkan isu resolusi IPv6. ### Cline / Teruskan / RooCode ``` Settings โ†’ API Configuration: Provider: OpenAI Compatible Base URL: http://localhost:20128/v1 API Key: [from OmniRoute dashboard] Model: if/kimi-k2-thinking ```
--- ## ๐Ÿงช Penilaian (Evals) OmniRoute termasuk rangka kerja penilaian terbina dalam untuk menguji kualiti tindak balas LLM terhadap set emas. Aksesnya melalui **Analytics โ†’ Evals** dalam papan pemuka. ### Set Emas Terbina dalam "Set Emas OmniRoute" pra-muat mengandungi 10 kes ujian yang meliputi: - Salam, matematik, geografi, penjanaan kod - Pematuhan format JSON, terjemahan, penurunan harga - Penolakan keselamatan (kandungan berbahaya), pengiraan, logik boolean ### Strategi Penilaian | Strategi | Penerangan | Contoh | | ---------- | --------------------------------------------------------------------- | -------------------------------- | | `exact` | Output mesti sepadan dengan tepat | `"4"` | | `contains` | Output mesti mengandungi subrentetan (tidak peka huruf besar-besaran) | `"Paris"` | | `regex` | Output mesti sepadan dengan corak regex | `"1.*2.*3"` | | `custom` | Fungsi JS tersuai mengembalikan benar/salah | `(output) => output.length > 10` | --- ## ๐Ÿ› Menyelesaikan masalah
Klik untuk mengembangkan panduan penyelesaian masalah **"Model bahasa tidak memberikan mesej"** - Kuota pembekal habis โ†’ Semak penjejak kuota papan pemuka - Penyelesaian: Gunakan sandaran kombo atau tukar kepada peringkat yang lebih murah **Penghadan kadar** - Kuota langganan habis โ†’ Sandar kepada GLM/MiniMax - Tambah kombo: `cc/claude-opus-4-6 โ†’ glm/glm-4.7 โ†’ if/kimi-k2-thinking` **Token OAuth tamat tempoh** - Dikemas semula secara automatik oleh OmniRoute - Jika isu berterusan: Papan Pemuka โ†’ Pembekal โ†’ Sambung semula **Kos tinggi** - Semak statistik penggunaan dalam Papan Pemuka โ†’ Kos - Tukar model utama kepada GLM/MiniMax - Gunakan peringkat percuma (Gemini CLI, iFlow) untuk tugasan yang tidak kritikal **Papan pemuka dibuka pada port yang salah** - Tetapkan `PORT=20128` dan `NEXT_PUBLIC_BASE_URL=http://localhost:20128` **Ralat penyegerakan awan** - Sahkan `BASE_URL` mata pada contoh larian anda - Sahkan `CLOUD_URL` mata ke titik akhir awan anda yang dijangkakan - Pastikan nilai `NEXT_PUBLIC_*` sejajar dengan nilai sebelah pelayan **Log masuk pertama tidak berfungsi** - Semak `INITIAL_PASSWORD` dalam `.env` - Jika tidak ditetapkan, kata laluan sandaran ialah `123456` **Tiada log permintaan** - Tetapkan `ENABLE_REQUEST_LOGS=true` dalam `.env` **Ujian sambungan menunjukkan "Tidak sah" untuk pembekal yang serasi dengan OpenAI** - Banyak pembekal tidak mendedahkan titik akhir `/models` - OmniRoute v1.0.6+ termasuk pengesahan sandaran melalui pelengkapan sembang - Pastikan URL asas mengandungi akhiran `/v1` ### ๐Ÿ” OAuth em Servidor Remoto (Persediaan OAuth Jauh) > **โš ๏ธ PENTING untuk biasa menggunakan OmniRoute em VPS/Docker/servidor remoto** ### Adakah OAuth melakukan Antigraviti / Gemini CLI tidak menggunakan perkhidmatan anda? Ia membuktikan **Antigraviti** dan **Gemini CLI** menggunakan **Google OAuth 2.0** untuk autenticaรงรฃo. O Google exige que a `redirect_uri` gunakan tiada fluks OAuth seja **exatamente** uma das URIs sebelum kadastrada tiada Google Cloud Console untuk aplicativo. Sebagai credenciais OAuth embutidas no OmniRoute estรฃo cadastradas **apenas untuk `localhost`**. Quando vocรช acessa o OmniRoute em um servidor remoto (cth: `https://omniroute.meuservidor.com`), o Google rejeita a autenticaรงรฃo com: ``` Error 400: redirect_uri_mismatch ``` ### Penyelesaian: Konfigurasikan suas prรณprias credenciais OAuth Vocรช precisa criar um **OAuth 2.0 Client ID** no Google Cloud Console com a URI do seu servidor. #### Passo a passo **1. Akses ke Konsol Awan Google** Abra: [https://console.cloud.google.com/apis/credentials](https://console.cloud.google.com/apis/credentials) **2. Crie um novo ID Pelanggan OAuth 2.0** - Klik em **"+ Cipta Bukti Kelayakan"** โ†’ **"ID klien OAuth"** - Tipo de aplicativo: **"Aplikasi web"** - Nama: escolha qualquer nome (cth: `OmniRoute Remote`) **3. Tambah sebagai URI Ubah Hala Dibenarkan** Tiada **"URI ubah hala yang dibenarkan"**, tambahan: ``` https://seu-servidor.com/callback ``` > Gantikan `seu-servidor.com` pelo domรญnio ou IP do seu servidor (termasuk porta se necessรกrio, cth: `http://45.33.32.156:20128/callback`). **4. Simpan dan salin sebagai kredensia** Apรณs criar, o Google mostrarรก o **ID Pelanggan** e o **Rahsia Pelanggan**. **5. Konfigurasikan sebagai 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** Papan pemuka โ†’ Pembekal โ†’ Antigraviti (ou Gemini CLI) โ†’ OAuth Agora o Google redirectionarรก corretamente untuk `https://seu-servidor.com/callback` dan a autenticaรงรฃo funcionarรก. --- ### Penyelesaian sementara (sem configurar credenciais prรณprias) Jika anda ingin mendapatkan credenciais prรณprias agora, ada kemungkinan penggunaan atau fluks **manual de URL**: 1. OmniRoute abrirรก a URL de authorizaรงรฃo do Google 2. Apรณs vocรช authorizar, o Google tentarรก redirectionar para `localhost` (que falha no servidor remoto) 3. **Salin URL lengkap** pada penyemak imbas barra de endereรงo do seu (mesmo que a pรกgina nรฃo carregue) 4. Cole essa URL no campo que aparece no modal de conexรฃo do OmniRoute 5. Klik em **"Sambung"** > Penyelesaian ini berfungsi sebagai kodigo de autorizaรงรฃo na URL adalah bebas untuk mengubah hala mengikut arahan atau tidak.
--- ## ๐Ÿ› ๏ธ Timbunan Teknologi - **Waktu Jalan**: Node.js 18โ€“22 LTS (โš ๏ธ Node.js 24+ **tidak disokong** โ€” `better-sqlite3` binari asli tidak serasi) - **Bahasa**: TypeScript 5.9 โ€” **100% TypeScript** merentas `src/` dan `open-sse/` (v1.0.6) - **Kerangka**: Next.js 16 + React 19 + Tailwind CSS 4 - **Pangkalan Data**: LowDB (JSON) + SQLite (keadaan domain + log proksi) - **Penstriman**: Acara Dihantar Pelayan (SSE) - **Auth**: OAuth 2.0 (PKCE) + JWT + Kunci API - **Ujian**: Pelari ujian Node.js (368+ ujian unit) - **CI/CD**: GitHub Actions (auto npm publish + Docker Hub pada keluaran) - **Laman web**: [omniroute.online](https://omniroute.online) - **Pakej**: [npmjs.com/package/omniroute](https://www.npmjs.com/package/omniroute) - **Docker**: [hub.docker.com/r/diegosouzapw/omniroute](https://hub.docker.com/r/diegosouzapw/omniroute) - **Ketahanan**: Pemutus litar, mundur eksponen, kumpulan anti gemuruh, penipuan TLS --- ## ๐Ÿ“– Dokumentasi | Dokumen | Penerangan | | -------------------------------------------- | --------------------------------------------------- | | [User Guide](docs/USER_GUIDE.md) | Pembekal, kombo, penyepaduan CLI, penggunaan | | [API Reference](docs/API_REFERENCE.md) | Semua titik akhir dengan contoh | | [Troubleshooting](docs/TROUBLESHOOTING.md) | Masalah dan penyelesaian biasa | | [Architecture](docs/ARCHITECTURE.md) | Seni bina sistem dan dalaman | | [Contributing](CONTRIBUTING.md) | Persediaan pembangunan dan garis panduan | | [OpenAPI Spec](docs/openapi.yaml) | Spesifikasi OpenAPI 3.0 | | [Security Policy](SECURITY.md) | Pelaporan kerentanan dan amalan keselamatan | | [VM Deployment](docs/VM_DEPLOYMENT_GUIDE.md) | Panduan lengkap: Persediaan VM + nginx + Cloudflare | | [Features Gallery](docs/FEATURES.md) | Lawatan papan pemuka visual dengan tangkapan skrin | ### ๐Ÿ“ธ Pratonton Papan Pemuka
Klik untuk melihat tangkapan skrin papan pemuka | Halaman | Tangkapan skrin | | ------------------ | ------------------------------------------------- | | **Pembekal** | ![Providers](docs/screenshots/01-providers.png) | | **Kombo** | ![Combos](docs/screenshots/02-combos.png) | | **Analisis** | ![Analytics](docs/screenshots/03-analytics.png) | | **Kesihatan** | ![Health](docs/screenshots/04-health.png) | | **Penterjemah** | ![Translator](docs/screenshots/05-translator.png) | | **Tetapan** | ![Settings](docs/screenshots/06-settings.png) | | **Alat CLI** | ![CLI Tools](docs/screenshots/07-cli-tools.png) | | **Log Penggunaan** | ![Usage](docs/screenshots/08-usage.png) | | **Titik Akhir** | ![Endpoint](docs/screenshots/09-endpoint.png) |
--- ## ๐Ÿ—บ๏ธ Pelan Hala Tuju OmniRoute mempunyai **210+ ciri yang dirancang** merentas berbilang fasa pembangunan. Berikut adalah bidang utama: | Kategori | Ciri Terancang | Sorotan | | ------------------------------ | -------------- | ---------------------------------------------------------------------------------------------------- | | ๐Ÿง  **Penghalaan & Perisikan** | 25+ | Penghalaan kependaman terendah, penghalaan berasaskan teg, kuota prapenerbangan, pemilihan akaun P2C | | ๐Ÿ”’ **Keselamatan & Pematuhan** | 20+ | Pengerasan SSRF, penyelubungan kelayakan, had kadar setiap titik akhir, skop kunci pengurusan | | ๐Ÿ“Š **Kebolehlihatan** | 15+ | Penyepaduan OpenTelemetry, pemantauan kuota masa nyata, penjejakan kos setiap model | | ๐Ÿ”„ **Integrasi Pembekal** | 20+ | Pendaftaran model dinamik, penyejukan pembekal, Codex berbilang akaun, penghuraian kuota Copilot | | โšก **Prestasi** | 15+ | Lapisan cache dwi, โ€‹โ€‹cache gesaan, cache respons, penstriman keepalive, API kelompok | | ๐ŸŒ **Ekosistem** | 10+ | API WebSocket, konfigurasi hot-reload, kedai konfigurasi teragih, mod komersial | ### ๐Ÿ”œ Akan Datang - ๐Ÿ”— **OpenCode Integration** โ€” Sokongan pembekal asli untuk IDE pengekodan AI OpenCode - ๐Ÿ”— **Pengintegrasian TRAE** โ€” Sokongan penuh untuk rangka kerja pembangunan TRAE AI - ๐Ÿ“ฆ **API Kelompok** โ€” Pemprosesan kelompok tak segerak untuk permintaan pukal - ๐ŸŽฏ **Penghalaan Berasaskan Teg** โ€” Permintaan laluan berdasarkan teg tersuai dan metadata - ๐Ÿ’ฐ **Strategi Kos Terendah** โ€” Pilih pembekal yang tersedia paling murah secara automatik > ๐Ÿ“ Spesifikasi ciri penuh tersedia dalam [link](docs/new-features/) (217 spesifikasi terperinci) --- ## ๐Ÿ“ง Sokongan > ๐Ÿ’ฌ **Sertai komuniti kami!** [WhatsApp Group](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) โ€” Dapatkan bantuan, kongsi petua dan kekal kemas kini. - **Laman web**: [omniroute.online](https://omniroute.online) - **GitHub**: [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute) - **Isu**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) - **WhatsApp**: [Community Group](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) - **Projek Asal**: [9router by decolua](https://github.com/decolua/9router) --- ## ๐Ÿ‘ฅ Penyumbang [![Contributors](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=100&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors) ### Cara Menyumbang 1. Garpu repositori 2. Buat cawangan ciri anda (`git checkout -b feature/amazing-feature`) 3. Serahkan perubahan anda (`git commit -m 'Add amazing feature'`) 4. Tolak ke cawangan (`git push origin feature/amazing-feature`) 5. Buka Permintaan Tarik Lihat [CONTRIBUTING.md](CONTRIBUTING.md) untuk garis panduan terperinci. ### Mengeluarkan Versi Baharu ```bash # Create a release โ€” npm publish happens automatically gh release create v1.0.6 --title "v1.0.6" --generate-notes ``` --- ## ๐Ÿ“Š Sejarah Bintang Star History Chart --- ## ๐Ÿ™ Ucapan terima kasih Terima kasih khas kepada **[9router](https://github.com/decolua/9router)** oleh **[decolua](https://github.com/decolua)** โ€” projek asal yang mengilhamkan garpu ini. OmniRoute membina asas yang luar biasa itu dengan ciri tambahan, API berbilang modal dan penulisan semula TypeScript penuh. Terima kasih khas kepada **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** โ€” pelaksanaan Go asal yang mengilhamkan port JavaScript ini. --- ## ๐Ÿ“„ Lesen Lesen MIT - lihat [LICENSE](LICENSE) untuk butiran. ---
Dibina dengan โค๏ธ untuk pembangun yang kod 24/7
omniroute.online