<div align="center">
   
  
  # 🚀 ओम्निरूट - निःशुल्क एआई गेटवे

🌐 **[English](#-omniroute--the-free-ai-gateway)** | \***\*ओएमएनआई_टोकन_159\*\***

### कोडिंग कभी बंद न करें। स्वचालित फ़ॉलबैक के साथ **मुफ़्त और कम लागत वाले AI मॉडल** के लिए स्मार्ट रूटिंग।

_आपका सार्वभौमिक एपीआई प्रॉक्सी - एक समापन बिंदु, 36+ प्रदाता, शून्य डाउनटाइम।_

**चैट समापन • एंबेडिंग • छवि निर्माण • ऑडियो • पुनर्रैंकिंग • 100% टाइपस्क्रिप्ट**

---

### 🤖 आपके पसंदीदा कोडिंग एजेंटों के लिए निःशुल्क एआई प्रदाता

_OmniRoute के माध्यम से किसी भी AI-संचालित IDE या CLI टूल को कनेक्ट करें - असीमित कोडिंग के लिए निःशुल्क API गेटवे।_

<sub>📡 सभी एजेंट <code>http://localhost:20128/v1</code> या <code>http://cloud.omniroute.online/v1</code> के माध्यम से जुड़ते हैं - एक कॉन्फ़िगरेशन, असीमित मॉडल और कोटा</sub>

---

[![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)

---

## 🤔ओम्नीरूट क्यों?

**पैसा बर्बाद करना और सीमा पार करना बंद करें:**

- <img src="https://img.shields.io/badge/✗-e74c3c?style=flat-square" height="16"/> सदस्यता कोटा हर महीने अप्रयुक्त रूप से समाप्त हो जाता है
- <img src="https://img.shields.io/badge/✗-e74c3c?style=flat-square" height="16"/> दर सीमा आपको कोडिंग के बीच में रोक देती है
- <img src="https://img.shields.io/badge/✗-e74c3c?style=flat-square" height="16"/> महँगे API ($20-50/माह प्रति प्रदाता)
- <img src="https://img.shields.io/badge/✗-e74c3c?style=flat-square" height="16"/> प्रदाताओं के बीच मैन्युअल स्विचिंग

**OmniRoute इसका समाधान करता है:**

- ✅ **सब्सक्रिप्शन अधिकतम करें** - कोटा ट्रैक करें, रीसेट से पहले हर बिट का उपयोग करें
- ✅ **ऑटो फ़ॉलबैक** - सदस्यता → एपीआई कुंजी → सस्ता → निःशुल्क, शून्य डाउनटाइम
- ✅ **मल्टी-अकाउंट** - प्रति प्रदाता खातों के बीच राउंड-रॉबिन
- ✅ **यूनिवर्सल** - क्लाउड कोड, कोडेक्स, जेमिनी सीएलआई, कर्सर, क्लाइन, ओपनक्लॉ, किसी भी सीएलआई टूल के साथ काम करता है

---

## 🔄 यह कैसे काम करता है

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

<details>
<summary><b>💸 1. "I pay for an expensive subscription but still get interrupted by limits"</b></summary>

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

</details>

<details>
<summary><b>🔌 2. "I need to use multiple providers but each has a different API"</b></summary>

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 `<think>` 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

</details>

<details>
<summary><b>🌐 3. "My AI provider blocks my region/country"</b></summary>

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

</details>

<details>
<summary><b>🆓 4. "I want to use AI for coding but I have no money"</b></summary>

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

</details>

<details>
<summary><b>🔒 5. "I need to protect my AI gateway from unauthorized access"</b></summary>

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

</details>

<details>
<summary><b>🛑 6. "My provider went down and I lost my coding flow"</b></summary>

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

</details>

<details>
<summary><b>🔧 7. "Configuring each AI tool is tedious and repetitive"</b></summary>

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

</details>

<details>
<summary><b>🔑 8. "Managing OAuth tokens from multiple providers is hell"</b></summary>

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

</details>

<details>
<summary><b>📊 9. "I don't know how much I'm spending or where"</b></summary>

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

</details>

<details>
<summary><b>🐛 10. "I can't diagnose errors and problems in AI calls"</b></summary>

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

</details>

<details>
<summary><b>🏗️ 11. "Deploying and maintaining the gateway is complex"</b></summary>

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

</details>

<details>
<summary><b>🌍 12. "The interface is English-only and my team doesn't speak English"</b></summary>

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

</details>

<details>
<summary><b>🔄 13. "I need more than chat — I need embeddings, images, audio"</b></summary>

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

</details>

<details>
<summary><b>🧪 14. "I have no way to test and compare quality across models"</b></summary>

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

</details>

<details>
<summary><b>📈 15. "I need to scale without losing performance"</b></summary>

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

</details>

<details>
<summary><b>🤖 16. "I want to control model behavior globally"</b></summary>

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

</details>

## ⚡ त्वरित शुरुआत

**1. विश्व स्तर पर स्थापित करें:**

🎉 डैशबोर्ड `http://localhost:20128` पर खुलता है

| आदेश                    | विवरण                                     |
| ----------------------- | ----------------------------------------- |
| `omniroute`             | सर्वर प्रारंभ करें (डिफ़ॉल्ट पोर्ट 20128) |
| `omniroute --port 3000` | कस्टम पोर्ट का उपयोग करें                 |
| `omniroute --no-open`   | ब्राउज़र को स्वतः न खोलें                 |
| `omniroute --help`      | सहायता दिखाएँ                             |

**2. एक मुफ़्त प्रदाता से जुड़ें:**

डैशबोर्ड → प्रदाता → कनेक्ट **क्लाउड कोड** या **एंटीग्रेविटी** → OAuth लॉगिन → हो गया!

**3. अपने सीएलआई टूल में उपयोग करें:**

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

**बस!** मुफ़्त AI मॉडल के साथ कोडिंग शुरू करें।

**वैकल्पिक - स्रोत से चलाएँ:**

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

---

## 🐳 डॉकर

ओमनीरूट [Docker Hub](https://hub.docker.com/r/diegosouzapw/omniroute) पर सार्वजनिक डॉकर छवि के रूप में उपलब्ध है।

**त्वरित दौड़:**

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

**पर्यावरण फ़ाइल के साथ:**

**डॉकर कंपोज़ का उपयोग करना:**

| छवि                      | टैग      | आकार     | विवरण               |
| ------------------------ | -------- | -------- | ------------------- |
| `diegosouzapw/omniroute` | `latest` | ~250एमबी | नवीनतम स्थिर रिलीज़ |
| `diegosouzapw/omniroute` | `1.0.3`  | ~250एमबी | वर्तमान संस्करण     |

---

---

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

---

## 💰 मूल्य निर्धारण एक नज़र में

| टियर              | प्रदाता             | लागत                      | कोटा रीसेट           | के लिए सर्वश्रेष्ठ       |
| ----------------- | ------------------- | ------------------------- | -------------------- | ------------------------ |
| **💳 सदस्यता**    | क्लाउड कोड (प्रो)   | $20/माह                   | 5 घंटे + साप्ताहिक   | पहले ही सदस्यता ले ली है |
|                   | कोडेक्स (प्लस/प्रो) | $20-200/महीना             | 5 घंटे + साप्ताहिक   | OpenAI उपयोगकर्ता        |
|                   | जेमिनी सीएलआई       | **मुफ़्त**                | 180K/माह + 1K/दिन    | सब लोग!                  |
|                   | गिटहब कोपायलट       | $10-19/माह                | मासिक                | GitHub उपयोगकर्ता        |
| **🔑एपीआई कुंजी** | एनवीडिया एनआईएम     | **मुफ़्त** (1000 क्रेडिट) | एक बार               | निःशुल्क स्तरीय परीक्षण  |
|                   | डीपसीक              | भुगतान-प्रति-उपयोग        | कोई नहीं             | सर्वोत्तम मूल्य/गुणवत्ता |
|                   | ग्रोक               | फ्री टियर + पेड           | दर सीमित             | अल्ट्रा-फास्ट अनुमान     |
|                   | एक्सएआई (ग्रोक)     | भुगतान-प्रति-उपयोग        | कोई नहीं             | ग्रोक मॉडल               |
|                   | मिस्ट्रल            | फ्री टियर + पेड           | दर सीमित             | यूरोपीय एआई              |
|                   | ओपनराउटर            | भुगतान-प्रति-उपयोग        | कोई नहीं             | 100+ मॉडल                |
| **💰सस्ता**       | जीएलएम-4.7          | $0.6/1 मिलियन             | प्रतिदिन सुबह 10 बजे | बजट बैकअप                |
|                   | मिनीमैक्स एम2.1     | $0.2/1 मिलियन             | 5 घंटे की रोलिंग     | सबसे सस्ता विकल्प        |
|                   | किमी K2             | $9/महीना फ्लैट            | 10एम टोकन/माह        | अनुमानित लागत            |
| **🆓 मुफ़्त**     | आईफ्लो              | $0                        | असीमित               | 8 मॉडल निःशुल्क          |
|                   | क्वेन               | $0                        | असीमित               | 3 मॉडल मुफ़्त            |
|                   | किरो                | $0                        | असीमित               | क्लाउड मुक्त             |

**💡 प्रो टिप:** जेमिनी सीएलआई (180 हजार निःशुल्क/माह) + आईफ्लो (असीमित निःशुल्क) कॉम्बो = $0 लागत से शुरू करें!

---

## 💡 मुख्य विशेषताएं

### 🧠 कोर रूटिंग और इंटेलिजेंस

| फ़ीचर                             | यह क्या करता है                                                                      |
| --------------------------------- | ------------------------------------------------------------------------------------ |
| 🎯 **स्मार्ट 4-टियर फ़ॉलबैक**     | ऑटो-रूट: सदस्यता → एपीआई कुंजी → सस्ता → मुफ़्त                                      |
| 📊 **वास्तविक समय कोटा ट्रैकिंग** | लाइव टोकन गिनती + प्रति प्रदाता रीसेट उलटी गिनती                                     |
| 🔄 **प्रारूप अनुवाद**             | OpenAI ↔ क्लाउड ↔ जेमिनी ↔ कर्सर ↔ किरो सीमलेस + रिस्पॉन्स सैनिटाइजेशन               |
| 👥 **मल्टी-अकाउंट सपोर्ट**        | बुद्धिमान चयन के साथ प्रति प्रदाता एकाधिक खाते                                       |
| 🔄 **ऑटो टोकन रिफ्रेश**           | OAuth टोकन पुनः प्रयास के साथ स्वचालित रूप से ताज़ा हो जाते हैं                      |
| 🎨 **कस्टम कॉम्बो**               | 6 रणनीतियाँ: पहले भरें, राउंड-रॉबिन, पी2सी, यादृच्छिक, कम से कम उपयोग, लागत-अनुकूलित |
| 🧩 **कस्टम मॉडल**                 | किसी भी प्रदाता से कोई भी मॉडल आईडी जोड़ें                                           |
| 🌐 **वाइल्डकार्ड राउटर**          | `provider/*` पैटर्न को गतिशील रूप से किसी भी प्रदाता तक रूट करें                     |
| 🧠 **सोच बजट**                    | तर्क मॉडल के लिए पासथ्रू, ऑटो, कस्टम और अनुकूली मोड                                  |
| 💬 **सिस्टम प्रॉम्प्ट इंजेक्शन**  | ग्लोबल सिस्टम प्रॉम्प्ट सभी अनुरोधों पर लागू किया गया                                |
| 📄 **प्रतिक्रियाएं एपीआई**        | कोडेक्स के लिए पूर्ण ओपनएआई रिस्पॉन्स एपीआई (`/v1/responses`) समर्थन                 |

### 🎵 मल्टी-मॉडल एपीआई

| फ़ीचर                        | यह क्या करता है                                   |
| ---------------------------- | ------------------------------------------------- |
| 🖼️ **छवि निर्माण**           | `/v1/images/generations` - 4 प्रदाता, 9+ मॉडल     |
| 📐 **एंबेडिंग**              | `/v1/embeddings` — 6 प्रदाता, 9+ मॉडल             |
| 🎤 **ऑडियो ट्रांस्क्रिप्शन** | `/v1/audio/transcriptions` - कानाफूसी-संगत        |
| 🔊 **टेक्स्ट-टू-स्पीच**      | `/v1/audio/speech` - बहु-प्रदाता ऑडियो संश्लेषण   |
| 🛡️ **संयम**                  | `/v1/moderations` — सामग्री सुरक्षा जांच          |
| 🔀 **पुनर्रैंकिंग**          | `/v1/rerank` — दस्तावेज़ प्रासंगिकता पुनर्रैंकिंग |

### 🛡️ लचीलापन और सुरक्षा

| फ़ीचर                                 | यह क्या करता है                                                              |
| ------------------------------------- | ---------------------------------------------------------------------------- |
| 🔌 **सर्किट ब्रेकर**                  | कॉन्फ़िगर करने योग्य थ्रेशोल्ड के साथ प्रति-प्रदाता स्वतः खोलें/बंद करें     |
| 🛡️ **एंटी-थंडरिंग झुंड**              | एपीआई कुंजी प्रदाताओं के लिए म्यूटेक्स + सेमाफोर दर-सीमा                     |
| 🧠 **सिमेंटिक कैश**                   | दो-स्तरीय कैश (हस्ताक्षर + सिमेंटिक) लागत और विलंबता को कम करता है           |
| ⚡ **निष्क्रियता का अनुरोध**          | डुप्लिकेट अनुरोधों के लिए 5s डिडअप विंडो                                     |
| 🔒 **टीएलएस फ़िंगरप्रिंट स्पूफ़िंग**  | Wreq-js के माध्यम से टीएलएस-आधारित बॉट डिटेक्शन को बायपास करें               |
| 🌐 **आईपी फ़िल्टरिंग**                | एपीआई अभिगम नियंत्रण के लिए अनुमति सूची/अवरुद्ध सूची                         |
| 📊 **संपादन योग्य दर सीमाएँ**         | सिस्टम स्तर पर कॉन्फ़िगर करने योग्य आरपीएम, न्यूनतम अंतर और अधिकतम समवर्ती   |
| 🛡 **एपीआई एंडपॉइंट सुरक्षा**         | `/models` समापन बिंदु के लिए ऑथेंटिक गेटिंग + प्रदाता अवरोधन                 |
| 🔒 **प्रॉक्सी दृश्यता**               | रंग-कोडित बैज: 🟢 वैश्विक, 🟡 प्रदाता, 🔵 आईपी डिस्प्ले के साथ प्रति-कनेक्शन |
| 🌐 **3-स्तरीय प्रॉक्सी कॉन्फ़िगरेशन** | वैश्विक, प्रति-प्रदाता, या प्रति-कनेक्शन स्तर पर प्रॉक्सी कॉन्फ़िगर करें     |

### 📊 अवलोकनशीलता और विश्लेषण

| फ़ीचर                           | यह क्या करता है                                                                |
| ------------------------------- | ------------------------------------------------------------------------------ |
| 📝 **लॉगिंग का अनुरोध**         | पूर्ण अनुरोध/प्रतिक्रिया लॉग के साथ डिबग मोड                                   |
| 💾 **SQLite प्रॉक्सी लॉग्स**    | लगातार प्रॉक्सी लॉग सर्वर पुनरारंभ होने से बचे रहते हैं                        |
| 📊 **एनालिटिक्स डैशबोर्ड**      | रिचार्ज-संचालित: स्टेट कार्ड, मॉडल उपयोग चार्ट, प्रदाता तालिका                 |
| 📈 **प्रगति ट्रैकिंग**          | स्ट्रीमिंग के लिए ऑप्ट-इन एसएसई प्रगति कार्यक्रम                               |
| 🧪 **एलएलएम मूल्यांकन**         | 4 मैच रणनीतियों के साथ गोल्डन सेट परीक्षण                                      |
| 🔍 **टेलीमेट्री के लिए अनुरोध** | p50/p95/p99 विलंबता एकत्रीकरण + एक्स-अनुरोध-आईडी ट्रेसिंग                      |
| 📋 **लॉग्स डैशबोर्ड**           | एकीकृत 4-टैब पृष्ठ: अनुरोध लॉग, प्रॉक्सी लॉग, ऑडिट लॉग, कंसोल                  |
| 🖥️ **कंसोल लॉग व्यूअर**         | लेवल फ़िल्टर, खोज, ऑटो-स्क्रॉल के साथ रीयल-टाइम टर्मिनल-शैली व्यूअर            |
| 📑 **फ़ाइल-आधारित लॉगिंग**      | कंसोल इंटरसेप्टर रोटेशन के साथ सभी आउटपुट को JSON लॉग फ़ाइल में कैप्चर करता है |
| 🏥 **स्वास्थ्य डैशबोर्ड**       | सिस्टम अपटाइम, सर्किट ब्रेकर स्थिति, लॉकआउट, कैश आँकड़े                        |
| 💰 **लागत ट्रैकिंग**            | बजट प्रबंधन + प्रति-मॉडल मूल्य निर्धारण विन्यास                                |

### ☁️ परिनियोजन और सिंक

| फ़ीचर                        | यह क्या करता है                                                              |
| ---------------------------- | ---------------------------------------------------------------------------- | ----------------------------- |
| 💾 **क्लाउड सिंक**           | क्लाउडफ्लेयर वर्कर्स के माध्यम से सभी डिवाइसों में कॉन्फिगरेशन सिंक करें     |
| 🌐 **कहीं भी तैनात करें**    | लोकलहोस्ट, वीपीएस, डॉकर, क्लाउडफ्लेयर वर्कर्स                                |
| 🔑 **एपीआई कुंजी प्रबंधन**   | प्रति प्रदाता एपीआई कुंजियाँ उत्पन्न करें, घुमाएँ और स्कोप करें              |
| 🧙 **ऑनबोर्डिंग विज़ार्ड**   | पहली बार उपयोगकर्ताओं के लिए 4-चरणीय निर्देशित सेटअप                         |
| 🔧 **सीएलआई टूल्स डैशबोर्ड** | क्लाउड, कोडेक्स, क्लाइन, ओपनक्लॉ, किलो, एंटीग्रेविटी                         | को एक-क्लिक से कॉन्फ़िगर करें |
| 🔄 **डीबी बैकअप**            | सभी सेटिंग्स के लिए स्वचालित बैकअप, पुनर्स्थापना, निर्यात और आयात            |
| 🌐 **अंतर्राष्ट्रीयकरण**     | नेक्स्ट-इंटल के साथ पूर्ण i18n - अंग्रेजी + पुर्तगाली (ब्राजील) समर्थन       |
| 🌍 **भाषा चयनकर्ता**         | रीयल-टाइम भाषा स्विचिंग के लिए हेडर में ग्लोब आइकन (🇺🇸/🇧🇷)                   |
| 📂 **कस्टम डेटा निर्देशिका** | `DATA_DIR` env var डिफ़ॉल्ट `~/.omniroute` संग्रहण पथ को ओवरराइड करने के लिए |

<summary><b>📖 सुविधा विवरण</b></summary>

### 🎯 स्मार्ट 4-टियर फ़ॉलबैक

स्वचालित फ़ॉलबैक के साथ कॉम्बो बनाएं:

### 📊 रीयल-टाइम कोटा ट्रैकिंग

- प्रति प्रदाता टोकन खपत
- उलटी गिनती रीसेट करें (5 घंटे, दैनिक, साप्ताहिक)
- भुगतान किए गए स्तरों के लिए लागत अनुमान
- मासिक खर्च रिपोर्ट

### 🔄 प्रारूप अनुवाद

प्रारूपों के बीच निर्बाध अनुवाद:

- **ओपनएआई** ↔ **क्लाउड** ↔ **मिथुन** ↔ **ओपनएआई प्रतिक्रियाएं**
- आपका सीएलआई उपकरण ओपनएआई प्रारूप भेजता है → ओमनीरूट अनुवाद करता है → प्रदाता मूल प्रारूप प्राप्त करता है
- कस्टम ओपनएआई एंडपॉइंट्स का समर्थन करने वाले किसी भी टूल के साथ काम करता है
- **प्रतिक्रिया स्वच्छता** - सख्त ओपनएआई एसडीके संगतता के लिए गैर-मानक फ़ील्ड को हटा देता है
- **भूमिका सामान्यीकरण** - `developer` → गैर-OpenAI के लिए `system`; `system` → GLM/ERNIE मॉडल के लिए `user`
- **टैग निष्कर्षण के बारे में सोचें** - `<think>` ब्लॉक → सोच मॉडल के लिए `reasoning_content`
- **संरचित आउटपुट** — `json_schema` → मिथुन राशि का `responseMimeType`/`responseSchema`

### 👥 मल्टी-अकाउंट सपोर्ट

- प्रति प्रदाता एकाधिक खाते जोड़ें
- ऑटो राउंड-रॉबिन या प्राथमिकता-आधारित रूटिंग
- कोटा पूरा होने पर अगले खाते में फ़ॉलबैक

### 🔄 ऑटो टोकन रिफ्रेश

- OAuth टोकन समाप्ति से पहले स्वचालित रूप से ताज़ा हो जाते हैं
- किसी मैन्युअल पुन: प्रमाणीकरण की आवश्यकता नहीं है
- सभी प्रदाताओं के बीच निर्बाध अनुभव

### 🎨 कस्टम कॉम्बो

- असीमित मॉडल संयोजन बनाएं
- 6 रणनीतियाँ: पहले भरें, राउंड-रॉबिन, दो-विकल्पों की शक्ति, यादृच्छिक, कम से कम उपयोग, लागत-अनुकूलित
- क्लाउड सिंक के साथ सभी डिवाइसों पर कॉम्बो साझा करें

### 🏥 स्वास्थ्य डैशबोर्ड

- सिस्टम स्थिति (अपटाइम, संस्करण, मेमोरी उपयोग)
- प्रति प्रदाता सर्किट ब्रेकर की स्थिति (बंद/खुला/आधा खुला)
- दर सीमा स्थिति और सक्रिय तालाबंदी
- हस्ताक्षर कैश आँकड़े
- विलंबता टेलीमेट्री (p50/p95/p99) + शीघ्र कैश
- एक क्लिक से स्वास्थ्य स्थिति रीसेट करें

### 🔧 अनुवादक खेल का मैदान

ओमनीरूट में डिबगिंग, परीक्षण और एपीआई अनुवादों की निगरानी के लिए **4 मोड** के साथ एक शक्तिशाली अंतर्निहित अनुवादक खेल का मैदान शामिल है:

| मोड                | विवरण                                                                                                                                                                                                                                             |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **💻खेल का मैदान** | प्रत्यक्ष प्रारूप अनुवाद - किसी भी एपीआई अनुरोध निकाय को पेस्ट करें और तुरंत देखें कि ओम्नीरूट प्रदाता प्रारूपों (ओपनएआई ↔ क्लाउड ↔ जेमिनी ↔ रिस्पॉन्स एपीआई) के बीच इसका अनुवाद कैसे करता है। उदाहरण टेम्प्लेट और प्रारूप ऑटो-डिटेक्शन शामिल है। |
| **💬 चैट परीक्षक** | ओम्निरूट के माध्यम से वास्तविक चैट अनुरोध भेजें और पूरी राउंड-ट्रिप देखें: आपका इनपुट, अनुवादित अनुरोध, प्रदाता प्रतिक्रिया, और अनुवादित प्रतिक्रिया वापस। कॉम्बो रूटिंग को मान्य करने के लिए अमूल्य।                                             |
| **🧪 टेस्ट बेंच**  | बैच परीक्षण मोड - विभिन्न इनपुट और अपेक्षित आउटपुट के साथ कई परीक्षण मामलों को परिभाषित करें, उन सभी को एक साथ चलाएं, और प्रदाताओं और मॉडलों के परिणामों की तुलना करें।                                                                           |
| **📱लाइव मॉनिटर**  | वास्तविक समय अनुरोध की निगरानी - आने वाले अनुरोधों को ओम्नीरूट के माध्यम से प्रवाहित होते हुए देखें, प्रारूप अनुवाद को लाइव होते हुए देखें, और समस्याओं की तुरंत पहचान करें।                                                                      |

**पहुँच:** डैशबोर्ड → अनुवादक (साइडबार)

### 💾 क्लाउड सिंक

- सभी डिवाइसों में सिंक प्रदाता, कॉम्बो और सेटिंग्स
- स्वचालित पृष्ठभूमि सिंक
- सुरक्षित एन्क्रिप्टेड भंडारण

---

## 🎯 उपयोग के मामले

### केस 1: "मेरे पास क्लाउड प्रो सदस्यता है"

**समस्या:** भारी कोडिंग के दौरान कोटा अप्रयुक्त, दर सीमा समाप्त हो जाता है

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

### केस 2: "मुझे शून्य लागत चाहिए"

**समस्या:** सदस्यताएं वहन नहीं कर सकते, विश्वसनीय एआई कोडिंग की आवश्यकता है

### केस 3: "मुझे 24/7 कोडिंग चाहिए, कोई रुकावट नहीं"

**समस्या:** समय सीमा, डाउनटाइम बर्दाश्त नहीं कर सकते

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

### केस 4: "मुझे ओपनक्लॉ में मुफ़्त एआई चाहिए"

**समस्या:** मैसेजिंग ऐप्स में AI सहायक की आवश्यकता है, पूरी तरह से निःशुल्क

```
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...
```

---

## 📖 सेटअप गाइड

<summary><b>💳 सदस्यता प्रदाता</b></summary>

### क्लाउड कोड (प्रो/मैक्स)

**प्रो टिप:** जटिल कार्यों के लिए ओपस और गति के लिए सॉनेट का उपयोग करें। ओमनीरूट प्रति मॉडल कोटा ट्रैक करता है!

### ओपनएआई कोडेक्स (प्लस/प्रो)

### जेमिनी सीएलआई (मुफ़्त 180K/माह!)

**सर्वोत्तम मूल्य:** विशाल निःशुल्क स्तर! सशुल्क स्तरों से पहले इसका उपयोग करें।

### गिटहब कोपायलट

<details>
<summary><b>🔑 API कुंजी प्रदाता</b></summary>

### एनवीडिया एनआईएम (मुफ़्त 1000 क्रेडिट!)

1. साइन अप करें: [build.nvidia.com](https://build.nvidia.com)
2. निःशुल्क एपीआई कुंजी प्राप्त करें (1000 अनुमान क्रेडिट शामिल)
3. डैशबोर्ड → प्रदाता जोड़ें → एनवीडिया एनआईएम:
   - एपीआई कुंजी: `nvapi-your-key`

**मॉडल:** `nvidia/llama-3.3-70b-instruct`, `nvidia/mistral-7b-instruct`, और 50+ अधिक

**प्रो टिप:** ओपनएआई-संगत एपीआई - ओमनीरूट के प्रारूप अनुवाद के साथ सहजता से काम करता है!

### डीपसीक

1. साइन अप करें: [platform.deepseek.com](https://platform.deepseek.com)
2. एपीआई कुंजी प्राप्त करें
3. डैशबोर्ड → प्रदाता जोड़ें → डीपसीक

**मॉडल:** `deepseek/deepseek-chat`, `deepseek/deepseek-coder`

### ग्रोक (निःशुल्क टियर उपलब्ध!)

1. साइन अप करें: [console.groq.com](https://console.groq.com)
2. एपीआई कुंजी प्राप्त करें (फ्री टियर शामिल)
3. डैशबोर्ड → प्रदाता जोड़ें → ग्रोक

**मॉडल:** `groq/llama-3.3-70b`, `groq/mixtral-8x7b`

**प्रो टिप:** अल्ट्रा-फास्ट अनुमान - वास्तविक समय कोडिंग के लिए सर्वोत्तम!

### ओपनराउटर (100+ मॉडल)

1. साइन अप करें: [openrouter.ai](https://openrouter.ai)
2. एपीआई कुंजी प्राप्त करें
3. डैशबोर्ड → प्रदाता जोड़ें → ओपनराउटर

**मॉडल:** एक ही एपीआई कुंजी के माध्यम से सभी प्रमुख प्रदाताओं से 100+ मॉडल तक पहुंचें।

<summary><b>💰 सस्ते प्रदाता (बैकअप)</b></summary>

### GLM-4.7 (दैनिक रीसेट, $0.6/1 मिलियन)

1. साइन अप करें: [Zhipu AI](https://open.bigmodel.cn/)
2. कोडिंग योजना से एपीआई कुंजी प्राप्त करें
3. डैशबोर्ड → एपीआई कुंजी जोड़ें:
   - प्रदाता: `glm`
   - एपीआई कुंजी: `your-key`

**उपयोग करें:** `glm/glm-4.7`

**प्रो टिप:** कोडिंग प्लान 1/7 लागत पर 3× कोटा प्रदान करता है! प्रतिदिन सुबह 10:00 बजे रीसेट करें।

### मिनीमैक्स एम2.1 (5 घंटे रीसेट, $0.20/1 मिलियन)

1. साइन अप करें: [MiniMax](https://www.minimax.io/)
2. एपीआई कुंजी प्राप्त करें
3. डैशबोर्ड → एपीआई कुंजी जोड़ें

**उपयोग:** `minimax/MiniMax-M2.1`

**प्रो टिप:** लंबे संदर्भ के लिए सबसे सस्ता विकल्प (1M टोकन)!

### किमी K2 ($9/माह फ्लैट)

1. सदस्यता लें: [Moonshot AI](https://platform.moonshot.ai/)
2. एपीआई कुंजी प्राप्त करें
3. डैशबोर्ड → एपीआई कुंजी जोड़ें

**उपयोग करें:** `kimi/kimi-latest`

**प्रो टिप:** 10एम टोकन के लिए निश्चित $9/माह = $0.90/1एम प्रभावी लागत!

<summary><b>🆓 मुफ़्त प्रदाता (आपातकालीन बैकअप)</b></summary>

### आईफ्लो (8 मुफ़्त मॉडल)

### क्वेन (3 मुफ़्त मॉडल)

### किरो (क्लाउड फ्री)

<summary><b>🎨 कॉम्बो बनाएं</b></summary>

### उदाहरण 1: सदस्यता अधिकतम करें → सस्ता बैकअप

### उदाहरण 2: केवल निःशुल्क (शून्य लागत)

```
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!
```

<summary><b>🔧 CLI एकीकरण</b></summary>

### कर्सर आईडीई

### क्लाउड कोड

एक-क्लिक कॉन्फ़िगरेशन के लिए डैशबोर्ड में **CLI टूल्स** पृष्ठ का उपयोग करें, या `~/.claude/settings.json` को मैन्युअल रूप से संपादित करें।

### कोडेक्स सीएलआई

### ओपनक्लॉ

**विकल्प 1 - डैशबोर्ड (अनुशंसित):**

**विकल्प 2 - मैनुअल:** संपादित करें `~/.openclaw/openclaw.json`:

> **ध्यान दें:** ओपनक्लाव केवल स्थानीय ओमनीरूट के साथ काम करता है। IPv6 रिज़ॉल्यूशन समस्याओं से बचने के लिए `localhost` के बजाय `127.0.0.1` का उपयोग करें।

### क्लाइन / जारी रखें / रूकोड

---

## 📊 उपलब्ध मॉडल

<details>
<summary><b>सभी उपलब्ध मॉडल देखें</b></summary>

**क्लाउड कोड (`cc/`)** - प्रो/मैक्स:

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

**कोडेक्स (`cx/`)** - प्लस/प्रो:

-
- `cx/gpt-5.1-codex-max`

**मिथुन सीएलआई (`gc/`)** - मुफ़्त:

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

**गिटहब कोपायलट (`gh/`)**:

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

**एनवीडिया एनआईएम (`nvidia/`)** - मुफ़्त क्रेडिट:

- `nvidia/llama-3.3-70b-instruct`
- `nvidia/mistral-7b-instruct`
- [build.nvidia.com](https://build.nvidia.com) पर 50+ अधिक मॉडल

**जीएलएम (`glm/`)** - $0.6/1M:

- `glm/glm-4.7`

**मिनीमैक्स (`minimax/`)** - $0.2/1M:

- `minimax/MiniMax-M2.1`

**iFlow (`if/`)** - मुफ़्त:

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

**क्वेन (`qw/`)** - मुफ़्त:

- `qw/qwen3-coder-plus`
- `qw/qwen3-coder-flash`

**किरो (`kr/`)** - मुफ़्त:

- `kr/claude-sonnet-4.5`
- `kr/claude-haiku-4.5`

**ओपनराउटर (`or/`)** - 100+ मॉडल:

- `or/anthropic/claude-4-sonnet`
- `or/google/gemini-2.5-pro`
- [openrouter.ai/models](https://openrouter.ai/models) से कोई भी मॉडल

---

## 🧪 मूल्यांकन (Evaluations)

ओमनीरूट में गोल्डन सेट के मुकाबले एलएलएम प्रतिक्रिया गुणवत्ता का परीक्षण करने के लिए एक अंतर्निहित मूल्यांकन ढांचा शामिल है। डैशबोर्ड में **एनालिटिक्स → इवेल्स** के माध्यम से इसे एक्सेस करें।

### बिल्ट-इन गोल्डन सेट

प्री-लोडेड "ओम्नीरूट गोल्डन सेट" में 10 परीक्षण मामले शामिल हैं:

- नमस्ते, गणित, भूगोल, कोड जनरेशन
- JSON प्रारूप अनुपालन, अनुवाद, मार्कडाउन
- सुरक्षा इनकार (हानिकारक सामग्री), गिनती, बूलियन तर्क

### मूल्यांकन रणनीतियाँ

| रणनीति     | विवरण                                             | उदाहरण                           |
| ---------- | ------------------------------------------------- | -------------------------------- |
| `exact`    | आउटपुट बिल्कुल मेल खाना चाहिए                     | `"4"`                            |
| `contains` | आउटपुट में सबस्ट्रिंग (केस-असंवेदनशील) होना चाहिए | `"Paris"`                        |
| `regex`    | आउटपुट रेगेक्स पैटर्न से मेल खाना चाहिए           | `"1.*2.*3"`                      |
| `custom`   | कस्टम जेएस फ़ंक्शन सही/गलत लौटाता है              | `(output) => output.length > 10` |

---

## 🐛 समस्या निवारण

<summary><b>समस्या निवारण मार्गदर्शिका का विस्तार करने के लिए क्लिक करें</b></summary>

**"भाषा मॉडल ने संदेश प्रदान नहीं किया"**

- प्रदाता कोटा समाप्त → डैशबोर्ड कोटा ट्रैकर की जाँच करें
- समाधान: कॉम्बो फ़ॉलबैक का उपयोग करें या सस्ते स्तर पर स्विच करें

**दर सीमित करना**

- सदस्यता कोटा ख़त्म → GLM/MiniMax पर फ़ॉलबैक
- कॉम्बो जोड़ें: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`

**OAuth टोकन समाप्त हो गया**

- ओम्निरूट द्वारा स्वतः ताज़ा
- यदि समस्या बनी रहती है: डैशबोर्ड → प्रदाता → पुनः कनेक्ट करें

**उच्च लागत**

- डैशबोर्ड → लागत में उपयोग के आँकड़े जाँचें
- प्राथमिक मॉडल को जीएलएम/मिनीमैक्स पर स्विच करें
- गैर-महत्वपूर्ण कार्यों के लिए फ्री टियर (मिथुन सीएलआई, आईफ्लो) का उपयोग करें

**डैशबोर्ड गलत पोर्ट पर खुलता है**

- `PORT=20128` और `NEXT_PUBLIC_BASE_URL=http://localhost:20128` सेट करें

**क्लाउड सिंक त्रुटियाँ**

- अपने चल रहे उदाहरण के लिए `BASE_URL` अंक सत्यापित करें
- अपने अपेक्षित क्लाउड एंडपॉइंट पर `CLOUD_URL` पॉइंट सत्यापित करें
- `NEXT_PUBLIC_*` मानों को सर्वर-साइड मानों के साथ संरेखित रखें

**पहला लॉगिन काम नहीं कर रहा**

- `.env` में `INITIAL_PASSWORD` को जांचें
- यदि सेट नहीं है, तो फ़ॉलबैक पासवर्ड `123456` है

**कोई अनुरोध लॉग नहीं**

- `.env` में `ENABLE_REQUEST_LOGS=true` सेट करें

**कनेक्शन परीक्षण OpenAI-संगत प्रदाताओं के लिए "अमान्य" दिखाता है**

- कई प्रदाता `/models` समापन बिंदु को उजागर नहीं करते हैं
- ओमनीरूट v1.0.6+ में चैट पूर्णता के माध्यम से फ़ॉलबैक सत्यापन शामिल है
- सुनिश्चित करें कि आधार URL में `/v1` प्रत्यय शामिल हो

---

## 🛠️ टेक स्टैक

- **रनटाइम**: Node.js 18–22 LTS (⚠️ Node.js 24+ **समर्थित नहीं** है - `better-sqlite3` मूल बायनेरिज़ असंगत हैं)
- **भाषा**: टाइपस्क्रिप्ट 5.9 - **100% टाइपस्क्रिप्ट** `src/` और `open-sse/` (v1.0.6) में
- **फ्रेमवर्क**: नेक्स्ट.जेएस 16 + रिएक्ट 19 + टेलविंड सीएसएस 4
- **डेटाबेस**: लोडीबी (JSON) + SQLite (डोमेन स्थिति + प्रॉक्सी लॉग)
- **स्ट्रीमिंग**: सर्वर-भेजे गए इवेंट (एसएसई)
- **प्रामाणिक**: OAuth 2.0 (PKCE) + JWT + API कुंजियाँ
- **परीक्षण**: Node.js परीक्षण धावक (368+ इकाई परीक्षण)
- **सीआई/सीडी**: गिटहब क्रियाएँ (ऑटो एनपीएम प्रकाशन + रिलीज पर डॉकर हब)
- **वेबसाइट**: [omniroute.online](https://omniroute.online)
- **पैकेज**: [npmjs.com/package/omniroute](https://www.npmjs.com/package/omniroute)
- **डॉकर**: [hub.docker.com/r/diegosouzapw/omniroute](https://hub.docker.com/r/diegosouzapw/omniroute)
- **लचीलापन**: सर्किट ब्रेकर, एक्सपोनेंशियल बैकऑफ़, एंटी-थंडरिंग झुंड, टीएलएस स्पूफिंग

---

## 📖 दस्तावेज़ीकरण

| दस्तावेज़                                    | विवरण                                       |
| -------------------------------------------- | ------------------------------------------- |
| [User Guide](docs/USER_GUIDE.md)             | प्रदाता, कॉम्बो, सीएलआई एकीकरण, तैनाती      |
| [API Reference](docs/API_REFERENCE.md)       | उदाहरण सहित सभी समापन बिंदु                 |
| [Troubleshooting](docs/TROUBLESHOOTING.md)   | सामान्य समस्याएँ एवं समाधान                 |
| [Architecture](docs/ARCHITECTURE.md)         | सिस्टम आर्किटेक्चर और आंतरिक                |
| [Contributing](CONTRIBUTING.md)              | विकास सेटअप और दिशानिर्देश                  |
| [OpenAPI Spec](docs/openapi.yaml)            | ओपनएपीआई 3.0 विशिष्टता                      |
| [Security Policy](SECURITY.md)               | भेद्यता रिपोर्टिंग और सुरक्षा प्रथाएं       |
| [VM Deployment](docs/VM_DEPLOYMENT_GUIDE.md) | संपूर्ण गाइड: VM + nginx + Cloudflare सेटअप |
| [Features Gallery](docs/FEATURES.md)         | स्क्रीनशॉट के साथ विजुअल डैशबोर्ड टूर       |

### 📸 डैशबोर्ड पूर्वावलोकन

<summary><b>डैशबोर्ड स्क्रीनशॉट देखने के लिए क्लिक करें</b></summary>

| पेज               | स्क्रीनशॉट                                        |
| ----------------- | ------------------------------------------------- |
| **प्रदाता**       | ![Providers](docs/screenshots/01-providers.png)   |
| **कॉम्बोस**       | ![Combos](docs/screenshots/02-combos.png)         |
| **एनालिटिक्स**    | ![Analytics](docs/screenshots/03-analytics.png)   |
| **स्वास्थ्य**     | ![Health](docs/screenshots/04-health.png)         |
| **अनुवादक**       | ![Translator](docs/screenshots/05-translator.png) |
| **सेटिंग्स**      | ![Settings](docs/screenshots/06-settings.png)     |
| **सीएलआई उपकरण**  | ![CLI Tools](docs/screenshots/07-cli-tools.png)   |
| **उपयोग लॉग**     | ![Usage](docs/screenshots/08-usage.png)           |
| **समाप्ति बिंदु** | ![Endpoint](docs/screenshots/09-endpoint.png)     |

---

## 🗺️ रोडमैप

ओम्निरूट ने कई विकास चरणों में **210+ सुविधाओं की योजना बनाई है**। यहां प्रमुख क्षेत्र हैं:

| श्रेणी                      | नियोजित विशेषताएं | हाइलाइट्स                                                                                   |
| --------------------------- | ----------------- | ------------------------------------------------------------------------------------------- |
| 🧠 **रूटिंग और इंटेलिजेंस** | 25+               | न्यूनतम-विलंबता रूटिंग, टैग-आधारित रूटिंग, कोटा प्रीफ़्लाइट, पी2सी खाता चयन                 |
| 🔒 **सुरक्षा एवं अनुपालन**  | 20+               | एसएसआरएफ हार्डनिंग, क्रेडेंशियल क्लोकिंग, प्रति समापन बिंदु दर-सीमा, प्रबंधन कुंजी स्कोपिंग |
| 📊 **अवलोकनशीलता**          | 15+               | ओपन टेलीमेट्री एकीकरण, वास्तविक समय कोटा निगरानी, ​​प्रति मॉडल लागत ट्रैकिंग                |
| 🔄 **प्रदाता एकीकरण**       | 20+               | डायनेमिक मॉडल रजिस्ट्री, प्रदाता कूलडाउन, मल्टी-अकाउंट कोडेक्स, कोपायलट कोटा पार्सिंग       |
| ⚡ **प्रदर्शन**             | 15+               | दोहरी कैश परत, शीघ्र कैश, प्रतिक्रिया कैश, स्ट्रीमिंग कीपलाइव, बैच एपीआई                    |
| 🌐 **पारिस्थितिकी तंत्र**   | 10+               | वेबसॉकेट एपीआई, कॉन्फिग हॉट-रीलोड, वितरित कॉन्फिग स्टोर, वाणिज्यिक मोड                      |

### 🔜 जल्द आ रहा है

- 🔗 **ओपनकोड इंटीग्रेशन** - ओपनकोड एआई कोडिंग आईडीई के लिए मूल प्रदाता समर्थन
- 🔗 **TRAE एकीकरण** - TRAE AI विकास ढांचे के लिए पूर्ण समर्थन
- 📦 **बैच एपीआई** - थोक अनुरोधों के लिए अतुल्यकालिक बैच प्रोसेसिंग
- 🎯 **टैग-आधारित रूटिंग** - कस्टम टैग और मेटाडेटा के आधार पर रूट अनुरोध
- 💰 **न्यूनतम-लागत रणनीति** — स्वचालित रूप से सबसे सस्ते उपलब्ध प्रदाता का चयन करें

> 📝 पूर्ण फीचर विशिष्टताएं [link](docs/new-features/) में उपलब्ध हैं (217 विस्तृत विवरण)

---

## 📧समर्थन

> 💬 **हमारे समुदाय में शामिल हों!** [WhatsApp Group](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) - सहायता प्राप्त करें, सुझाव साझा करें और अपडेट रहें।

- **वेबसाइट**: [omniroute.online](https://omniroute.online)
- **गिटहब**: [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute)
- **मुद्दे**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues)
- **व्हाट्सएप**: [Community Group](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t)
- **मूल परियोजना**: [9router by decolua](https://github.com/decolua/9router)

---

## 👥 योगदानकर्ता

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

### योगदान कैसे करें

1. रिपॉजिटरी को फोर्क करें
2. अपनी फीचर शाखा बनाएं (`git checkout -b feature/amazing-feature`)
3. अपने परिवर्तन प्रतिबद्ध करें (`git commit -m 'Add amazing feature'`)
4. शाखा में पुश करें (`git push origin feature/amazing-feature`)
5. एक पुल अनुरोध खोलें

विस्तृत दिशानिर्देशों के लिए [CONTRIBUTING.md](CONTRIBUTING.md) देखें।

### एक नया संस्करण जारी करना

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

---

## 📊 सितारा इतिहास

<a href="https://star-history.com/#diegosouzapw/OmniRoute&Date">
  
    
    
    
  
</a>

---

## 🙏 आभार

**[decolua](https://github.com/decolua)** द्वारा **[decolua](https://github.com/decolua)** को विशेष धन्यवाद - मूल परियोजना जिसने इस फोर्क को प्रेरित किया। ओमनीरूट अतिरिक्त सुविधाओं, मल्टी-मोडल एपीआई और पूर्ण टाइपस्क्रिप्ट पुनर्लेखन के साथ उस अविश्वसनीय नींव पर आधारित है।

**[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** को विशेष धन्यवाद - मूल गो कार्यान्वयन जिसने इस जावास्क्रिप्ट पोर्ट को प्रेरित किया।

---

## 📄 लाइसेंस

एमआईटी लाइसेंस - विवरण के लिए [LICENSE](LICENSE) देखें।

---

---

## 🇧🇷 ओमनीरूट - गेटवे डी आईए ग्रैटुइटो

<a name="-omniroute--gateway-de-ia-gratuito"></a>

### नूनका पारे डे कोडर। रोटेमेंटो इंटेलिजेंट पैरा **मॉडलोस डी आईए ग्रैटुइटोस और डे बैक्सो कस्टम** कॉम फ़ॉलबैक ऑटोमेटिको।

_एसईयू प्रॉक्सी यूनिवर्सल डी एपीआई - उम एंडपॉइंट, 36+ प्रोडोर्स, शून्य डाउनटाइम।_

### 🌐 इंटरनेशनलिज़ाकाओ (i18n)

ओम्नीरूट का डैशबोर्ड **मल्टीप्लोस इडियोमास** का समर्थन करता है। उन्हें वास्तविक वितरण:

| मुहावरा                 | कोडिगो  | स्थिति      |
| ----------------------- | ------- | ----------- |
| 🇺🇸 अंग्रेजी             | `en`    | ✅ कंप्लीटो |
| 🇧🇷 पोर्टुगुएस (ब्राजील) | `pt-BR` | ✅ कंप्लीटो |

**मुहावरे के बारे में जानकारी:** मुहावरे के चयन पर क्लिक करें (🇺🇸 EN) डैशबोर्ड पर कोई हेडर नहीं → वाक्यांश के चयन के बारे में क्लिक करें।

**एक नया मुहावरा जोड़ने के लिए:**

1. `src/i18n/messages/{codigo}.json` को `en.json` पर आधारित करें
2. `src/i18n/config.ts` → `LOCALES` और `LANGUAGES` कोड का उपयोग
3. सेवा प्रदाता की सेवा

### ⚡ इनिसियो रैपिडो

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

### 🐳 डॉकर

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

### 🔑 फंक्सोनियलिडेड्स प्रिंसिपैस

- **36+ आईए** - क्लाउड, जीपीटी, जेमिनी, लामा, क्वेन, डीपसीक, और अन्य
- **रोटीमेंटो इंटेलिजेंट** — फ़ॉलबैक ऑटोमेटिको एंटर प्रोवोर्स
- **प्रारूप अनुवाद** — OpenAI ↔ क्लाउड ↔ जेमिनी ऑटोमैटिक
- **मल्टी-कॉन्टा** - चयनित इंटेलिजेंट के लिए मल्टीप्लास कॉन्टास
- **कैश सिमेंटिको** - कस्टम और लेटेंसी रेडुज़
- **OAuth automático** — टोकन स्वचालित रूप से नवीनीकृत होते हैं
- **व्यक्तिगत संयोजन** — 6 रोटेमेंटो एस्ट्रैटेजीस
- **डैशबोर्ड संपूर्ण** - मॉनिटर, लॉग, विश्लेषण, कॉन्फ़िगरेशन
- **सीएलआई उपकरण** - क्लाउड कोड, कोडेक्स, कर्सर, क्लाइन को एक क्लिक पर कॉन्फ़िगर करें
- **100% टाइपस्क्रिप्ट** — कोडिगो लिम्पो और टिपडो

### 📖 दस्तावेज़ीकरण

| डॉक्यूमेंटो                                     | विवरण                                         |
| ----------------------------------------------- | --------------------------------------------- |
| [Guia do Usuário](docs/USER_GUIDE.md)           | प्रोवेडोर्स, कॉम्बो, सीएलआई, तैनाती           |
| [Referência da API](docs/API_REFERENCE.md)      | सभी ओएस एंडपॉइंट उदाहरण उदाहरण                |
| [Solução de Problemas](docs/TROUBLESHOOTING.md) | समस्याएं और समाधान                            |
| [Arquitetura](docs/ARCHITECTURE.md)             | आर्किटेक्चर और इंटर्नोस डो सिस्तेमा           |
| [Contribuição](CONTRIBUTING.md)                 | सेटअप डे डेसेनवोल्विमेंटो ई दिशानिर्देश       |
| [Deploy em VM](docs/VM_DEPLOYMENT_GUIDE.md)     | संपूर्ण मार्गदर्शिका: VM + nginx + Cloudflare |

### 📧 सपोर्ट

> 💬 **एक अधिसूचना के लिए प्रवेश!** [Grupo WhatsApp](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) — दो सप्ताह, पूर्ण विवरण और पूर्ण विवरण।

- **वेबसाइट**: [omniroute.online](https://omniroute.online)
- **गिटहब**: [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute)
- **मुद्दे**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues)

---

<sub>24/7 कोड करने वाले डेवलपर्स के लिए ❤️ के साथ निर्मित</sub>

<sub><a href="https://omniroute.online">omniroute.online</a></sub>
