# 🚀 ओम्निरूट - निःशुल्क एआई गेटवे

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

_आपका सार्वभौमिक एपीआई प्रॉक्सी - एक समापन बिंदु, 67+ प्रदाता, शून्य डाउनटाइम। अब **एमसीपी और ए2ए** एजेंट ऑर्केस्ट्रेशन के साथ।_

**चैट समापन • एंबेडिंग • छवि निर्माण • वीडियो • संगीत • ऑडियो • पुनःरैंकिंग • **वेब खोज** • एमसीपी सर्वर • ए2ए प्रोटोकॉल • 100% टाइपस्क्रिप्ट**

---

**OMNI_टोकन_452**

[![npm version](https://img.shields.io/npm/v/omniroute?color=cb3837&logo=npm)](https://www.npmjs.com/package/omniroute)
[![npm downloads](https://img.shields.io/npm/dm/omniroute?color=cb3837&logo=npm&label=npm%20downloads)](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)
[![Docker Pulls](https://img.shields.io/docker/pulls/diegosouzapw/omniroute?logo=docker&color=2496ED&label=docker%20pulls)](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)

**OMNI_टोकन_453**

🌐 **यहां उपलब्ध:** 🇺🇸 [English](README.md) | 🇧🇷 [Português (Brasil)](docs/i18n/pt-BR/README.md) | 🇪🇸 [Español](docs/i18n/es/README.md) | 🇫🇷 [Français](docs/i18n/fr/README.md) | 🇮🇹[Italiano](docs/i18n/it/README.md) | 🇷🇺 [Русский](docs/i18n/ru/README.md) | 🇨🇳 [中文 (简体)](docs/i18n/zh-CN/README.md) | 🇩🇪 [Deutsch](docs/i18n/de/README.md) | 🇮🇳 [हिन्दी](docs/i18n/in/README.md) | 🇹🇭 [ไทย](docs/i18n/th/README.md) | 🇺🇦 [Українська](docs/i18n/uk-UA/README.md) | 🇸🇦 [العربية](docs/i18n/ar/README.md) | 🇯🇵 [日本語](docs/i18n/ja/README.md) | 🇻🇳 [Tiếng Việt](docs/i18n/vi/README.md) | 🇧🇬 [Български](docs/i18n/bg/README.md) | 🇩🇰 [Dansk](docs/i18n/da/README.md) | 🇫🇮 [Suomi](docs/i18n/fi/README.md) | 🇮🇱 [עברית](docs/i18n/he/README.md) | 🇭🇺 [Magyar](docs/i18n/hu/README.md) | 🇮🇩 [Bahasa Indonesia](docs/i18n/id/README.md) | 🇰🇷 [한국어](docs/i18n/ko/README.md) | 🇲🇾 [Bahasa Melayu](docs/i18n/ms/README.md) | 🇳🇱 [Nederlands](docs/i18n/nl/README.md) | 🇳🇴 [Norsk](docs/i18n/no/README.md) | 🇵🇹 [Português (Portugal)](docs/i18n/pt/README.md) | 🇷🇴 [Română](docs/i18n/ro/README.md) | 🇵🇱 [Polski](docs/i18n/pl/README.md) | 🇸🇰 [Slovenčina](docs/i18n/sk/README.md) | 🇸🇪 [Svenska](docs/i18n/sv/README.md) | 🇵🇭 [Filipino](docs/i18n/phi/README.md) | 🇨🇿 [Čeština](docs/i18n/cs/README.md)

---

## 🆕 v3.0.0 में नया क्या है

> **v2.9.5 से अपग्रेड किया जा रहा है?** — सभी परिवर्तनों के लिए [full CHANGELOG](CHANGELOG.md#300--2026-03-22-release-candidate--not-yet-merged-to-main) देखें।

| क्षेत्र                          | परिवर्तन                                                                                                                                                                             |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| 🔒 **कोडक्यूएल सुरक्षा**         | फिक्स्ड 10+ कोडक्यूएल अलर्ट: बहुपद-रेडोस, असुरक्षित-यादृच्छिकता, शेल-इंजेक्शन उपचार                                                                                                  |
| ✅ **रूट सत्यापन**               | सभी 176 एपीआई रूट अब ज़ॉड स्कीमा + `validateBody()` — CI `check:route-validation:t06` पास के साथ मान्य हैं                                                                           |
| 🐛 **ओम्नीमॉडल टैग लीक**         | आंतरिक `<omniModel>` टैग अब SSE स्ट्रीमिंग प्रतिक्रियाओं में ग्राहकों के लिए लीक नहीं होंगे (#585)                                                                                   |
| 🔑 **पंजीकृत कुंजी एपीआई**       | प्रति-प्रदाता/खाता कोटा प्रवर्तन, निष्क्रियता, SHA-256 भंडारण और वैकल्पिक GitHub समस्या रिपोर्टिंग के साथ `POST /api/v1/registered-keys` के माध्यम से स्वचालित-प्रावधान API कुंजियाँ |
| 👁️ **Scoped API Key Reveal** 🆕  | Opt-in recovery of API keys via `ALLOW_API_KEY_REVEAL`                                                                                                                               |
| 🎨 **प्रदाता चिह्न**             | पीएनजी के साथ `@lobehub/icons` (एसवीजी) के माध्यम से 130+ प्रदाता लोगो → सामान्य फ़ॉलबैक श्रृंखला                                                                                    |
| 🔄 **मॉडल ऑटो-सिंक**             | बिल्ट-इन और कस्टम ओपनएआई-संगत प्रदाताओं के लिए मॉडल सूचियों को सिंक करने के लिए 24 घंटे शेड्यूलर और मैनुअल यूआई टॉगल                                                                 |
| 🌐 **ओपनकोड ज़ेन/गो**            | @kang-heewon से PR #530 के माध्यम से दो नए प्रदाता: निःशुल्क स्तर + `OpencodeExecutor` के माध्यम से सदस्यता स्तर                                                                     |
| 🐛 **मिथुन सीएलआई ओऑथ**          | डॉकर में `GEMINI_OAUTH_CLIENT_SECRET` गायब होने पर कार्रवाई योग्य त्रुटि (गूढ़ Google त्रुटि थी)                                                                                     |
| 🐛 **ओपनकोड कॉन्फिग**            | `saveOpenCodeConfig()` अब TOML को `XDG_CONFIG_HOME` पर सही ढंग से लिखता है                                                                                                           |
| 🐛 **पिन किया गया मॉडल ओवरराइड** | `body.model` संदर्भ-कैश सुरक्षा पर `pinnedModel` पर सही ढंग से सेट है                                                                                                                |
| 🐛 **कोडेक्स/क्लाउड लूप**        | `tool_result` ब्लॉक अब अनंत लूप को रोकने के लिए टेक्स्ट में परिवर्तित हो गए हैं                                                                                                      |
| 🐛 **लॉगिन रीडायरेक्ट**          | पासवर्ड सेटअप छोड़ने के बाद लॉगिन रुकता नहीं है                                                                                                                                      |
| 🐛 **विंडोज़ पथ**                | MSYS2/Git-बैश पथ (`/c/...`) स्वचालित रूप से `C:\...` पर सामान्यीकृत हो गए                                                                                                            |

---

## 🖼️ मुख्य डैशबोर्ड

**OMNI_टोकन_454**
**OMNI_टोकन_447**
**OMNI_टोकन_455**

---

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

**OMNI_टोकन_456**

<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)           |
| **अंतबिंदु**     | ![Endpoints](docs/screenshots/09-endpoint.png)    |

**OMNI_टोकन_461**

---

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

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

  <table>
    <tr>
      <td align="center" width="110">
        <a href="https://github.com/openclaw/openclaw">
          <img src="./public/providers/openclaw.png" alt="OpenClaw" width="48"/><br/>
          <b>OpenClaw</b>
        </a><br/>
        <sub>⭐ 205K</sub>
      </td>
      <td align="center" width="110">
        <a href="https://github.com/HKUDS/nanobot">
          <img src="./public/providers/nanobot.png" alt="NanoBot" width="48"/><br/>
          <b>NanoBot</b>
        </a><br/>
        <sub>⭐ 20.9K</sub>
      </td>
      <td align="center" width="110">
        <a href="https://github.com/sipeed/picoclaw">
          <img src="./public/providers/picoclaw.jpg" alt="PicoClaw" width="48"/><br/>
          <b>PicoClaw</b>
        </a><br/>
        <sub>⭐ 14.6K</sub>
      </td>
      <td align="center" width="110">
        <a href="https://github.com/zeroclaw-labs/zeroclaw">
          <img src="./public/providers/zeroclaw.png" alt="ZeroClaw" width="48"/><br/>
          <b>ZeroClaw</b>
        </a><br/>
        <sub>⭐ 9.9K</sub>
      </td>
      <td align="center" width="110">
        <a href="https://github.com/nearai/ironclaw">
          <img src="./public/providers/ironclaw.png" alt="IronClaw" width="48"/><br/>
          <b>IronClaw</b>
        </a><br/>
        <sub>⭐ 2.1K</sub>
      </td>
    </tr>
    <tr>
      <td align="center" width="110">
        <a href="https://github.com/anomalyco/opencode">
          <img src="./public/providers/opencode.svg" alt="OpenCode" width="48"/><br/>
          <b>OpenCode</b>
        </a><br/>
        <sub>⭐ 106K</sub>
      </td>
      <td align="center" width="110">
        <a href="https://github.com/openai/codex">
          <img src="./public/providers/codex.png" alt="Codex CLI" width="48"/><br/>
          <b>Codex CLI</b>
        </a><br/>
        <sub>⭐ 60.8K</sub>
      </td>
      <td align="center" width="110">
        <a href="https://github.com/anthropics/claude-code">
          <img src="./public/providers/claude.png" alt="Claude Code" width="48"/><br/>
          <b>Claude Code</b>
        </a><br/>
        <sub>⭐ 67.3K</sub>
      </td>
      <td align="center" width="110">
        <a href="https://github.com/google-gemini/gemini-cli">
          <img src="./public/providers/gemini-cli.png" alt="Gemini CLI" width="48"/><br/>
          <b>Gemini CLI</b>
        </a><br/>
        <sub>⭐ 94.7K</sub>
      </td>
      <td align="center" width="110">
        <a href="https://github.com/Kilo-Org/kilocode">
          <img src="./public/providers/kilocode.png" alt="Kilo Code" width="48"/><br/>
          <b>Kilo Code</b>
        </a><br/>
        <sub>⭐ 15.5K</sub>
      </td>
    </tr>
  </table>

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

---

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

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

- <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 इसका समाधान करता है:**

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

---

## 📧समर्थन

> 💬 **हमारे समुदाय में शामिल हों!** [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)
- **योगदान**: [CONTRIBUTING.md](CONTRIBUTING.md) देखें, एक पीआर खोलें, या एक `good first issue` चुनें
- **मूल परियोजना**: [9router by decolua](https://github.com/decolua/9router)

### 🐛 बग की रिपोर्ट करना?

कोई समस्या खोलते समय, कृपया सिस्टम-जानकारी कमांड चलाएँ और जेनरेट की गई फ़ाइल संलग्न करें:

```bash
npm run system-info
```

यह आपके Node.js संस्करण, ओमनीरूट संस्करण, OS विवरण, स्थापित CLI उपकरण (iflow, जेमिनी, क्लाउड, कोडेक्स, एंटीग्रेविटी, ड्रॉइड, आदि), Docker/PM2 स्थिति और सिस्टम पैकेज के साथ एक `system-info.txt` उत्पन्न करता है - वह सब कुछ जो हमें आपकी समस्या को शीघ्रता से पुन: उत्पन्न करने के लिए चाहिए। फ़ाइल को सीधे अपने GitHub मुद्दे से संलग्न करें।

---

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

**OMNI_टोकन_1**

---

## 🎯 ओमनीरूट क्या समाधान करता है - 30 वास्तविक समस्या बिंदु और उपयोग के मामले

> **एआई टूल का उपयोग करने वाला प्रत्येक डेवलपर प्रतिदिन इन समस्याओं का सामना करता है।** ओम्नीरूट को उन सभी को हल करने के लिए बनाया गया था - लागत वृद्धि से लेकर क्षेत्रीय ब्लॉक तक, टूटे हुए ओएथ प्रवाह से लेकर प्रोटोकॉल संचालन और एंटरप्राइज़ अवलोकन तक।

**OMNI_टोकन_468**

<summary><b>💸 1. "मैं एक महंगी सदस्यता के लिए भुगतान करता हूं लेकिन फिर भी सीमा से बाधित होता हूं"</b></summary>

डेवलपर्स क्लाउड प्रो, कोडेक्स प्रो, या गिटहब कोपायलट के लिए $20-200/माह का भुगतान करते हैं। यहां तक ​​कि भुगतान करने पर भी, कोटा की एक सीमा होती है - 5 घंटे का उपयोग, साप्ताहिक सीमा, या प्रति मिनट की दर सीमा। मध्य-कोडिंग सत्र में, प्रदाता प्रत्युत्तर देना बंद कर देता है और डेवलपर प्रवाह और उत्पादकता खो देता है।

**ओम्नीरूट इसे कैसे हल करता है:**

- **स्मार्ट 4-टियर फ़ॉलबैक** - यदि सदस्यता कोटा समाप्त हो जाता है, तो स्वचालित रूप से एपीआई कुंजी पर रीडायरेक्ट हो जाता है → सस्ता → शून्य मैन्युअल हस्तक्षेप के साथ मुफ़्त
- **वास्तविक समय कोटा ट्रैकिंग** - रीसेट उलटी गिनती के साथ वास्तविक समय में टोकन खपत दिखाता है (5 घंटे, दैनिक, साप्ताहिक)
- **मल्टी-अकाउंट सपोर्ट** - ऑटो राउंड-रॉबिन के साथ प्रति प्रदाता एकाधिक खाते - जब एक खत्म हो जाता है, तो अगले पर स्विच हो जाता है
- **कस्टम कॉम्बो** - 6 संतुलन रणनीतियों (भरण-प्रथम, राउंड-रॉबिन, पी2सी, यादृच्छिक, कम से कम उपयोग, लागत-अनुकूलित) के साथ अनुकूलन योग्य फ़ॉलबैक चेन
- **कोडेक्स बिजनेस कोटा** - बिजनेस/टीम कार्यक्षेत्र कोटा की निगरानी सीधे डैशबोर्ड में

**OMNI_टोकन_473**

**OMNI_टोकन_474**

<summary><b>🔌 2. "मुझे कई प्रदाताओं का उपयोग करने की आवश्यकता है लेकिन प्रत्येक के पास एक अलग API है"</b></summary>

ओपनएआई एक प्रारूप का उपयोग करता है, क्लाउड (एंथ्रोपिक) दूसरे का उपयोग करता है, जेमिनी एक और का उपयोग करता है। यदि कोई डेवलपर विभिन्न प्रदाताओं के मॉडल का परीक्षण करना चाहता है या उनके बीच फ़ॉलबैक करना चाहता है, तो उन्हें एसडीके को फिर से कॉन्फ़िगर करना होगा, एंडपॉइंट बदलना होगा, असंगत प्रारूपों से निपटना होगा। कस्टम प्रदाताओं (फ्रेंडएलआई, एनआईएम) के पास गैर-मानक मॉडल एंडपॉइंट हैं।

**ओम्नीरूट इसे कैसे हल करता है:**

- **एकीकृत समापन बिंदु** - एक एकल `http://localhost:20128/v1` सभी 67+ प्रदाताओं के लिए प्रॉक्सी के रूप में कार्य करता है
- **प्रारूप अनुवाद** - स्वचालित और पारदर्शी: ओपनएआई ↔ क्लाउड ↔ जेमिनी ↔ प्रतिक्रिया एपीआई
- **प्रतिक्रिया स्वच्छता** - गैर-मानक फ़ील्ड (`x_groq`, `usage_breakdown`, `service_tier`) को स्ट्रिप्स करता है जो OpenAI SDK v1.83+ को तोड़ता है
- **भूमिका सामान्यीकरण** - गैर-ओपनएआई प्रदाताओं के लिए `developer` → `system` परिवर्तित करता है; `system` → GLM/ERNIE के लिए `user`
- **टैग एक्सट्रैक्शन के बारे में सोचें** - डीपसीक आर1 जैसे मॉडलों से `<think>` ब्लॉक को मानकीकृत `reasoning_content` में निकालता है
- **मिथुन राशि वालों के लिए संरचित आउटपुट** — `json_schema` → `responseMimeType`/`responseSchema` स्वचालित रूपांतरण
- **`stream` डिफ़ॉल्ट रूप से `false`** पर जाता है - OpenAI विनिर्देश के साथ संरेखित होता है, Python/Rust/Go SDKs में अप्रत्याशित SSE से बचता है

**OMNI_टोकन_479**

**OMNI_टोकन_480**

<summary><b>🌐 3. "मेरा AI प्रदाता मेरे क्षेत्र/देश को ब्लॉक कर देता है"</b></summary>

OpenAI/Codex जैसे प्रदाता कुछ भौगोलिक क्षेत्रों से पहुंच को रोकते हैं। उपयोगकर्ताओं को OAuth और API कनेक्शन के दौरान `unsupported_country_region_territory` जैसी त्रुटियां मिलती हैं। यह विकासशील देशों के डेवलपर्स के लिए विशेष रूप से निराशाजनक है।

**ओम्नीरूट इसे कैसे हल करता है:**

- **3-स्तरीय प्रॉक्सी कॉन्फ़िगरेशन** - 3 स्तरों पर कॉन्फ़िगर करने योग्य प्रॉक्सी: वैश्विक (सभी ट्रैफ़िक), प्रति-प्रदाता (केवल एक प्रदाता), और प्रति-कनेक्शन/कुंजी
- **रंग-कोडित प्रॉक्सी बैज** - दृश्य संकेतक: 🟢 वैश्विक प्रॉक्सी, 🟡 प्रदाता प्रॉक्सी, 🔵 कनेक्शन प्रॉक्सी, हमेशा आईपी दिखाता है
- **प्रॉक्सी के माध्यम से OAuth टोकन एक्सचेंज** - OAuth प्रवाह भी प्रॉक्सी के माध्यम से चलता है, `unsupported_country_region_territory` को हल करता है
- **प्रॉक्सी के माध्यम से कनेक्शन परीक्षण** - कनेक्शन परीक्षण कॉन्फ़िगर प्रॉक्सी का उपयोग करते हैं (अब कोई प्रत्यक्ष बाईपास नहीं)
- **SOCKS5 समर्थन** - आउटबाउंड रूटिंग के लिए पूर्ण SOCKS5 प्रॉक्सी समर्थन
- **टीएलएस फिंगरप्रिंट स्पूफिंग** - बॉट डिटेक्शन को बायपास करने के लिए `wreq-js` के माध्यम से ब्राउज़र जैसा टीएलएस फिंगरप्रिंट
- **🔏 सीएलआई फ़िंगरप्रिंट मिलान** - मूल सीएलआई बाइनरी हस्ताक्षरों से मिलान करने के लिए हेडर और बॉडी फ़ील्ड को पुन: व्यवस्थित करता है, जिससे खाता फ़्लैगिंग जोखिम काफी कम हो जाता है। प्रॉक्सी आईपी संरक्षित है - आपको एक साथ स्टील्थ **और** आईपी मास्किंग दोनों मिलते हैं

**OMNI_टोकन_485**

**OMNI_टोकन_486**

<summary><b>🆓 4. "मैं कोडिंग के लिए AI का उपयोग करना चाहता हूं लेकिन मेरे पास पैसे नहीं हैं"</b></summary>

हर कोई AI सदस्यता के लिए $20-200/माह का भुगतान नहीं कर सकता। छात्रों, उभरते देशों के डेवलपर्स, शौकीनों और फ्रीलांसरों को शून्य लागत पर गुणवत्ता वाले मॉडल तक पहुंच की आवश्यकता है।

**ओम्नीरूट इसे कैसे हल करता है:**

- **फ्री टियर प्रोवाइडर बिल्ट-इन** - 100% फ्री प्रदाताओं के लिए मूल समर्थन: iFlow (OAuth के माध्यम से 5 असीमित मॉडल: किमी-के2-थिंकिंग, क्वेन3-कोडर-प्लस, डीपसीक-आर1, मिनिमैक्स-एम2, किमी-के2), क्वेन (4 असीमित मॉडल: क्वेन3-कोडर-प्लस, क्वेन3-कोडर-फ्लैश, क्वेन3-कोडर-नेक्स्ट, विज़न-मॉडल), किरो (क्लाउड + एडब्ल्यूएस बिल्डर आईडी मुफ़्त), जेमिनी सीएलआई (180K टोकन/माह मुफ़्त)
- **ओलामा क्लाउड** - निःशुल्क "लाइट उपयोग" स्तर के साथ `api.ollama.com` पर क्लाउड-होस्टेड ओलामा मॉडल; `ollamacloud/<model>` उपसर्ग का उपयोग करें
- **केवल-निःशुल्क कॉम्बो** — चेन `gc/gemini-3-flash → if/kimi-k2-thinking → qw/qwen3-coder-plus` = $0/माह, शून्य डाउनटाइम के साथ
- **एनवीडिया एनआईएम फ्री एक्सेस** - ~40 आरपीएम डेव-बिल्ड.एनवीडिया.कॉम पर 70+ मॉडलों तक हमेशा के लिए मुफ्त एक्सेस (क्रेडिट से शुद्ध दर सीमा तक संक्रमण)
- **लागत अनुकूलित रणनीति** - रूटिंग रणनीति जो स्वचालित रूप से सबसे सस्ते उपलब्ध प्रदाता को चुनती है

**OMNI_टोकन_491**

<details>
<summary><b>🔒 5. "मुझे अपने AI गेटवे को अनधिकृत पहुंच से बचाने की आवश्यकता है"</b></summary>

नेटवर्क (LAN, VPS, Docker) में AI गेटवे को उजागर करते समय, पते वाला कोई भी व्यक्ति डेवलपर के टोकन/कोटा का उपभोग कर सकता है। सुरक्षा के बिना, एपीआई दुरुपयोग, त्वरित इंजेक्शन और दुरुपयोग के प्रति संवेदनशील हैं।

**ओम्नीरूट इसे कैसे हल करता है:**

- **एपीआई कुंजी प्रबंधन** - एक समर्पित `/dashboard/api-manager` पेज के साथ प्रति प्रदाता जनरेशन, रोटेशन और स्कोपिंग
- **मॉडल-स्तरीय अनुमतियाँ** - एपीआई कुंजियों को विशिष्ट मॉडलों तक सीमित करें (`openai/*`, वाइल्डकार्ड पैटर्न), सभी को अनुमति दें/प्रतिबंधित टॉगल के साथ
- **एपीआई एंडपॉइंट सुरक्षा** - `/v1/models` के लिए एक कुंजी की आवश्यकता है और विशिष्ट प्रदाताओं को लिस्टिंग से ब्लॉक करें
- **ऑथ गार्ड + सीएसआरएफ सुरक्षा** - सभी डैशबोर्ड रूट `withAuth` मिडलवेयर + सीएसआरएफ टोकन से सुरक्षित हैं
- **रेट लिमिटर** - कॉन्फ़िगर करने योग्य विंडो के साथ प्रति-आईपी दर सीमित करना
- **आईपी फ़िल्टरिंग** - अभिगम नियंत्रण के लिए अनुमति सूची/अवरुद्ध सूची
- **प्रॉम्प्ट इंजेक्शन गार्ड** - दुर्भावनापूर्ण प्रॉम्प्ट पैटर्न के विरुद्ध स्वच्छता
- **एईएस-256-जीसीएम एन्क्रिप्शन** - क्रेडेंशियल आराम से एन्क्रिप्ट किए गए

**OMNI_टोकन_497**

<details>
<summary><b>🛑 6. "मेरा प्रदाता बंद हो गया और मैंने अपना कोडिंग प्रवाह खो दिया"</b></summary>

एआई प्रदाता अस्थिर हो सकते हैं, 5xx त्रुटियाँ लौटा सकते हैं, या अस्थायी दर सीमा तक पहुँच सकते हैं। यदि कोई डेवलपर किसी एकल प्रदाता पर निर्भर करता है, तो वे बाधित हो जाते हैं। सर्किट ब्रेकर के बिना, बार-बार पुनः प्रयास करने से एप्लिकेशन क्रैश हो सकता है।

**ओम्नीरूट इसे कैसे हल करता है:**

- **प्रति-मॉडल सर्किट ब्रेकर** - कॉन्फ़िगर करने योग्य थ्रेसहोल्ड और कूलडाउन (बंद/खुला/आधा-खुला) के साथ ऑटो-खुला/बंद, कैस्केडिंग ब्लॉक से बचने के लिए प्रति-मॉडल स्कोप्ड
- **एक्सपोनेंशियल बैकऑफ़** - प्रगतिशील पुनः प्रयास में देरी
- **एंटी-थंडरिंग हर्ड** - म्यूटेक्स + समवर्ती रिट्री तूफानों के खिलाफ सेमाफोर सुरक्षा
- **कॉम्बो फ़ॉलबैक चेन** - यदि प्राथमिक प्रदाता विफल हो जाता है, तो बिना किसी हस्तक्षेप के स्वचालित रूप से चेन से गिर जाता है
- **कॉम्बो सर्किट ब्रेकर** - कॉम्बो श्रृंखला के भीतर विफल प्रदाताओं को स्वचालित रूप से अक्षम करता है
- **स्वास्थ्य डैशबोर्ड** - अपटाइम मॉनिटरिंग, सर्किट ब्रेकर स्थिति, लॉकआउट, कैश आँकड़े, p50/p95/p99 विलंबता

**OMNI_टोकन_503**

**OMNI_टोकन_504**

<summary><b>🔧 7. "प्रत्येक AI उपकरण को कॉन्फ़िगर करना कठिन और दोहराव वाला है"</b></summary>

डेवलपर्स कर्सर, क्लाउड कोड, कोडेक्स सीएलआई, ओपनक्लाव, जेमिनी सीएलआई, किलो कोड का उपयोग करते हैं... प्रत्येक टूल को एक अलग कॉन्फ़िगरेशन (एपीआई एंडपॉइंट, कुंजी, मॉडल) की आवश्यकता होती है। प्रदाताओं या मॉडलों को स्विच करते समय पुन: कॉन्फ़िगर करना समय की बर्बादी है।

**ओम्नीरूट इसे कैसे हल करता है:**

- **सीएलआई टूल्स डैशबोर्ड** - क्लाउड कोड, कोडेक्स सीएलआई, ओपनक्लाव, किलो कोड, एंटीग्रेविटी, क्लाइन के लिए एक-क्लिक सेटअप वाला समर्पित पेज
- **GitHub Copilot कॉन्फिग जेनरेटर** — बल्क मॉडल चयन के साथ VS कोड के लिए `chatLanguageModels.json` जेनरेट करता है
- **ऑनबोर्डिंग विज़ार्ड** - पहली बार उपयोगकर्ताओं के लिए निर्देशित 4-चरणीय सेटअप
- **एक समापन बिंदु, सभी मॉडल** - `http://localhost:20128/v1` को एक बार कॉन्फ़िगर करें, 67+ प्रदाताओं तक पहुंचें

</details>

<details>
<summary><b>🔑 8. "एकाधिक प्रदाताओं से OAuth टोकन प्रबंधित करना नरक है"</b></summary>

क्लाउड कोड, कोडेक्स, जेमिनी सीएलआई, कोपायलट - सभी समाप्त होने वाले टोकन के साथ OAuth 2.0 का उपयोग करते हैं। डेवलपर्स को लगातार पुन: प्रमाणित करने, `client_secret is missing`, `redirect_uri_mismatch` और दूरस्थ सर्वर पर विफलताओं से निपटने की आवश्यकता होती है। LAN/VPS पर OAuth विशेष रूप से समस्याग्रस्त है।

**ओम्नीरूट इसे कैसे हल करता है:**

- **ऑटो टोकन रिफ्रेश** - OAuth टोकन समाप्ति से पहले पृष्ठभूमि में रिफ्रेश होते हैं
- **OAuth 2.0 (PKCE) बिल्ट-इन** - क्लाउड कोड, कोडेक्स, जेमिनी सीएलआई, कोपायलट, किरो, क्वेन, आईफ्लो के लिए स्वचालित प्रवाह
- **मल्टी-अकाउंट OAuth** - JWT/ID टोकन निष्कर्षण के माध्यम से प्रति प्रदाता एकाधिक खाते
- **OAuth LAN/रिमोट फिक्स** - `redirect_uri` के लिए निजी आईपी डिटेक्शन + रिमोट सर्वर के लिए मैनुअल यूआरएल मोड
- **Nginx के पीछे OAuth** - रिवर्स प्रॉक्सी संगतता के लिए `window.location.origin` का उपयोग करता है
- **दूरस्थ OAuth मार्गदर्शिका** — VPS/Docker पर Google क्लाउड क्रेडेंशियल के लिए चरण-दर-चरण मार्गदर्शिका

</details>

<details>
<summary><b>📊 9. "मुझे नहीं पता कि मैं कितना और कहां खर्च कर रहा हूं"</b></summary>

डेवलपर्स कई भुगतान प्रदाताओं का उपयोग करते हैं लेकिन खर्च के बारे में कोई एकीकृत दृष्टिकोण नहीं रखते हैं। प्रत्येक प्रदाता का अपना बिलिंग डैशबोर्ड होता है, लेकिन कोई समेकित दृश्य नहीं होता है। अप्रत्याशित लागतें बढ़ सकती हैं।

**ओम्नीरूट इसे कैसे हल करता है:**

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

</details>

<details>
<summary><b>🐛 10. "मैं AI कॉल में त्रुटियों और समस्याओं का निदान नहीं कर सकता"</b></summary>

जब कोई कॉल विफल हो जाती है, तो देव को पता नहीं चलता कि यह दर सीमा, समाप्त टोकन, गलत प्रारूप या प्रदाता त्रुटि थी। विभिन्न टर्मिनलों पर खंडित लॉग। अवलोकन के बिना, डिबगिंग परीक्षण-और-त्रुटि है।

**ओम्नीरूट इसे कैसे हल करता है:**

- **एकीकृत लॉग डैशबोर्ड** - 4 टैब: अनुरोध लॉग, प्रॉक्सी लॉग, ऑडिट लॉग, कंसोल
- **कंसोल लॉग व्यूअर** - रंग-कोडित स्तरों, ऑटो-स्क्रॉल, खोज, फ़िल्टर के साथ वास्तविक समय टर्मिनल-शैली व्यूअर
- **SQLite प्रॉक्सी लॉग** - लगातार लॉग जो सर्वर पुनरारंभ होने से बचे रहते हैं
- **अनुवादक खेल का मैदान** - 4 डिबगिंग मोड: खेल का मैदान (प्रारूप अनुवाद), चैट टेस्टर (राउंड-ट्रिप), टेस्ट बेंच (बैच), लाइव मॉनिटर (वास्तविक समय)
- **अनुरोध टेलीमेट्री** - p50/p95/p99 विलंबता + X-अनुरोध-आईडी ट्रेसिंग
- **रोटेशन के साथ फ़ाइल-आधारित लॉगिंग** - कंसोल इंटरसेप्टर आकार-आधारित रोटेशन के साथ JSON लॉग में सब कुछ कैप्चर करता है
- **सिस्टम जानकारी रिपोर्ट** - `npm run system-info` आपके पूर्ण वातावरण (नोड संस्करण, ओमनीरूट संस्करण, ओएस, सीएलआई उपकरण, डॉकर/पीएम2 स्थिति) के साथ `system-info.txt` उत्पन्न करता है। त्वरित ट्राइएज के लिए समस्याओं की रिपोर्ट करते समय इसे संलग्न करें।

</details>

<details>
<summary><b>🏗️ 11. "गेटवे की तैनाती और रखरखाव जटिल है"</b></summary>

विभिन्न वातावरणों (स्थानीय, वीपीएस, डॉकर, क्लाउड) में एआई प्रॉक्सी को स्थापित करना, कॉन्फ़िगर करना और बनाए रखना श्रम-गहन है। हार्डकोडेड पथ, निर्देशिकाओं पर `EACCES`, पोर्ट विरोध और क्रॉस-प्लेटफ़ॉर्म बिल्ड जैसी समस्याएं घर्षण बढ़ाती हैं।

**ओम्नीरूट इसे कैसे हल करता है:**

- **एनपीएम ग्लोबल इंस्टाल** — `npm install -g omniroute && omniroute` — हो गया
- **डॉकर मल्टी-प्लेटफ़ॉर्म** - AMD64 + ARM64 नेटिव (Apple सिलिकॉन, AWS ग्रेविटॉन, रास्पबेरी पाई)
- **डॉकर कंपोज प्रोफाइल** - `base` (कोई CLI उपकरण नहीं) और `cli` (क्लाउड कोड, कोडेक्स, ओपनक्लॉ के साथ)
- **इलेक्ट्रॉन डेस्कटॉप ऐप** - सिस्टम ट्रे, ऑटो-स्टार्ट, ऑफ़लाइन मोड के साथ विंडोज/मैकओएस/लिनक्स के लिए मूल ऐप
- **स्प्लिट-पोर्ट मोड** - उन्नत परिदृश्यों के लिए अलग-अलग पोर्ट पर एपीआई और डैशबोर्ड (रिवर्स प्रॉक्सी, कंटेनर नेटवर्किंग)
- **क्लाउड सिंक** - क्लाउडफ्लेयर वर्कर्स के माध्यम से सभी डिवाइसों में कॉन्फिग सिंक्रोनाइजेशन
- **डीबी बैकअप** - सभी सेटिंग्स का स्वचालित बैकअप, पुनर्स्थापना, निर्यात और आयात

**OMNI_टोकन_533**

**OMNI_टोकन_534**

<summary><b>🌍 12. "इंटरफ़ेस केवल अंग्रेजी है और मेरी टीम अंग्रेजी नहीं बोलती"</b></summary>

गैर-अंग्रेजी भाषी देशों, विशेष रूप से लैटिन अमेरिका, एशिया और यूरोप में टीमें, केवल अंग्रेजी इंटरफेस के साथ संघर्ष करती हैं। भाषा बाधाएँ अपनाने को कम करती हैं और कॉन्फ़िगरेशन त्रुटियों को बढ़ाती हैं।

**ओम्नीरूट इसे कैसे हल करता है:**

- **डैशबोर्ड i18n - 30 भाषाएँ** - अरबी, बल्गेरियाई, डेनिश, जर्मन, स्पेनिश, फिनिश, फ्रेंच, हिब्रू, हिंदी, हंगेरियन, इंडोनेशियाई, इतालवी, जापानी, कोरियाई, मलय, डच, नॉर्वेजियन, पोलिश, पुर्तगाली (पीटी/बीआर), रोमानियाई, रूसी, स्लोवाक, स्वीडिश, थाई, यूक्रेनी, वियतनामी, चीनी, फिलिपिनो, अंग्रेजी सहित सभी 500+ कुंजियाँ अनुवादित
- **आरटीएल समर्थन** - अरबी और हिब्रू के लिए दाएं से बाएं समर्थन
- **बहु-भाषा रीडमी** - 30 पूर्ण दस्तावेज़ीकरण अनुवाद
- **भाषा चयनकर्ता** - वास्तविक समय स्विचिंग के लिए हेडर में ग्लोब आइकन

**OMNI_टोकन_539**

<details>
<summary><b>🔄 13. "मुझे चैट से अधिक की आवश्यकता है - मुझे एम्बेडिंग, चित्र, ऑडियो की आवश्यकता है"</b></summary>

एआई का मतलब सिर्फ चैट पूरा करना नहीं है। देवों को छवियां उत्पन्न करने, ऑडियो ट्रांसक्राइब करने, आरएजी के लिए एम्बेडिंग बनाने, दस्तावेज़ों को फिर से रैंक करने और सामग्री को मॉडरेट करने की आवश्यकता होती है। प्रत्येक एपीआई का एक अलग समापन बिंदु और प्रारूप होता है।

**ओम्नीरूट इसे कैसे हल करता है:**

- **एंबेडिंग** - `/v1/embeddings` 6 प्रदाताओं और 9+ मॉडल के साथ
- **इमेज जेनरेशन** - `/v1/images/generations` 10 प्रदाताओं और 20+ मॉडलों के साथ (ओपनएआई, एक्सएआई, टुगेदर, फायरवर्क्स, नेबियस, हाइपरबोलिक, नैनोबनाना, एंटीग्रेविटी, एसडी वेबयूआई, कॉम्फीयूआई)
- **टेक्स्ट-टू-वीडियो** — `/v1/videos/generations` — कॉम्फ़ीयूआई (एनिमेटडिफ़, एसवीडी) और एसडी वेबयूआई
- **टेक्स्ट-टू-म्यूजिक** — `/v1/music/generations` — कॉम्फीयूआई (स्थिर ऑडियो ओपन, म्यूजिकजेन)
- **ऑडियो ट्रांस्क्रिप्शन** — `/v1/audio/transcriptions` — व्हिस्पर + एनवीडिया एनआईएम, हगिंगफेस, क्वेन3
- **टेक्स्ट-टू-स्पीच** — `/v1/audio/speech` — इलेवनलैब्स, एनवीडिया एनआईएम, हगिंगफेस, कोक्वी, टोरटोइज़, क्वेन3, **इनवर्ल्ड**, **कार्टेसिया**, **प्लेएचटी**, + मौजूदा प्रदाता
- **संयम** — `/v1/moderations` — सामग्री सुरक्षा जांच
- **पुनर्रैंकिंग** — `/v1/rerank` — दस्तावेज़ प्रासंगिकता पुन:रैंकिंग
- **प्रतिक्रिया एपीआई** - कोडेक्स के लिए पूर्ण `/v1/responses` समर्थन

**OMNI_टोकन_545**

**OMNI_टोकन_546**

<summary><b>🧪 14. "मेरे पास सभी मॉडलों की गुणवत्ता का परीक्षण और तुलना करने का कोई तरीका नहीं है"</b></summary>

डेवलपर्स जानना चाहते हैं कि उनके उपयोग के मामले में कौन सा मॉडल सबसे अच्छा है - कोड, अनुवाद, तर्क - लेकिन मैन्युअल रूप से तुलना करना धीमा है। कोई एकीकृत eval उपकरण मौजूद नहीं है।

**ओम्नीरूट इसे कैसे हल करता है:**

- **एलएलएम मूल्यांकन** - अभिवादन, गणित, भूगोल, कोड जनरेशन, JSON अनुपालन, अनुवाद, मार्कडाउन, सुरक्षा इनकार को कवर करने वाले 10 प्री-लोडेड मामलों के साथ गोल्डन सेट परीक्षण
- **4 मैच रणनीतियाँ** — `exact`, `contains`, `regex`, `custom` (JS फ़ंक्शन)
- **अनुवादक खेल का मैदान परीक्षण बेंच** - एकाधिक इनपुट और अपेक्षित आउटपुट, क्रॉस-प्रदाता तुलना के साथ बैच परीक्षण
- **चैट परीक्षक** - दृश्य प्रतिक्रिया प्रतिपादन के साथ पूर्ण राउंड-ट्रिप
- **लाइव मॉनिटर** - प्रॉक्सी के माध्यम से बहने वाले सभी अनुरोधों की वास्तविक समय स्ट्रीम

**OMNI_टोकन_551**

**OMNI_टोकन_552**

<summary><b>📈 15. "मुझे प्रदर्शन खोए बिना स्केल करने की आवश्यकता है"</b></summary>

जैसे-जैसे अनुरोध की मात्रा बढ़ती है, कैशिंग के बिना वही प्रश्न डुप्लिकेट लागत उत्पन्न करते हैं। निष्क्रियता के बिना, डुप्लिकेट अपशिष्ट प्रसंस्करण का अनुरोध करता है। प्रति-प्रदाता दर सीमा का सम्मान किया जाना चाहिए।

**ओम्नीरूट इसे कैसे हल करता है:**

- **सिमेंटिक कैश** - दो-स्तरीय कैश (हस्ताक्षर + सिमेंटिक) लागत और विलंबता को कम करता है
- **अनुरोध Idempotency** - समान अनुरोधों के लिए 5s डिडुप्लीकेशन विंडो
- **दर सीमा का पता लगाना** - प्रति-प्रदाता आरपीएम, न्यूनतम अंतर, और अधिकतम समवर्ती ट्रैकिंग
- **संपादन योग्य दर सीमाएँ** — सेटिंग्स में कॉन्फ़िगर करने योग्य डिफ़ॉल्ट → दृढ़ता के साथ लचीलापन
- **एपीआई कुंजी सत्यापन कैश** - उत्पादन प्रदर्शन के लिए 3-स्तरीय कैश
- **टेलीमेट्री के साथ स्वास्थ्य डैशबोर्ड** — p50/p95/p99 विलंबता, कैश आँकड़े, अपटाइम

</details>

**OMNI_टोकन_558**

<summary><b>🤖 16. "मैं विश्व स्तर पर मॉडल व्यवहार को नियंत्रित करना चाहता हूं"</b></summary>

ऐसे डेवलपर जो सभी प्रतिक्रियाएं एक विशिष्ट भाषा में, एक विशिष्ट लहजे में चाहते हैं, या तर्क टोकन को सीमित करना चाहते हैं। प्रत्येक टूल/अनुरोध में इसे कॉन्फ़िगर करना अव्यावहारिक है।

**ओम्नीरूट इसे कैसे हल करता है:**

- **सिस्टम प्रॉम्प्ट इंजेक्शन** — ग्लोबल प्रॉम्प्ट सभी अनुरोधों पर लागू होता है
- **सोच बजट सत्यापन** - प्रति अनुरोध तर्क टोकन आवंटन नियंत्रण (पासथ्रू, ऑटो, कस्टम, अनुकूली)
- **6 रूटिंग रणनीतियाँ** - वैश्विक रणनीतियाँ जो यह निर्धारित करती हैं कि अनुरोध कैसे वितरित किए जाते हैं
- **वाइल्डकार्ड राउटर** — `provider/*` पैटर्न किसी भी प्रदाता को गतिशील रूप से रूट करता है
- **कॉम्बो सक्षम/अक्षम टॉगल** — कॉम्बो को सीधे डैशबोर्ड से टॉगल करें
- **प्रदाता टॉगल** — एक क्लिक से प्रदाता के लिए सभी कनेक्शन सक्षम/अक्षम करें
- **अवरुद्ध प्रदाता** - `/v1/models` सूची से विशिष्ट प्रदाताओं को बाहर करें

**OMNI_टोकन_563**

**OMNI_टोकन_564**

<summary><b>🧰 17. "मुझे प्रथम श्रेणी उत्पाद क्षमताओं के रूप में MCP टूल की आवश्यकता है"</b></summary>

कई एआई गेटवे एमसीपी को केवल एक छिपे हुए कार्यान्वयन विवरण के रूप में उजागर करते हैं। टीमों को एक दृश्यमान, प्रबंधनीय संचालन परत की आवश्यकता होती है।

**ओम्नीरूट इसे कैसे हल करता है:**

- एमसीपी डैशबोर्ड नेविगेशन और एंडपॉइंट प्रोटोकॉल टैब में दिखाई देता है
- प्रक्रिया, उपकरण, कार्यक्षेत्र और ऑडिट के साथ समर्पित एमसीपी प्रबंधन पृष्ठ
- `omniroute --mcp` और क्लाइंट ऑनबोर्डिंग के लिए बिल्ट-इन क्विक-स्टार्ट

</details>

<details>
<summary><b>🧠 18. "मुझे सिंक + स्ट्रीम कार्य पथों के साथ A2A ऑर्केस्ट्रेशन की आवश्यकता है"</b></summary>

एजेंट वर्कफ़्लो को जीवनचक्र नियंत्रण के साथ सीधे उत्तर और लंबे समय तक चलने वाले स्ट्रीम निष्पादन दोनों की आवश्यकता होती है।

**ओम्नीरूट इसे कैसे हल करता है:**

- A2A JSON-RPC एंडपॉइंट (`POST /a2a`) `message/send` और `message/stream` के साथ
- टर्मिनल राज्य प्रसार के साथ एसएसई स्ट्रीमिंग
- `tasks/get` और `tasks/cancel` के लिए कार्य जीवनचक्र API

**OMNI_टोकन_575**

**OMNI_टोकन_576**

<summary><b>🛰️ 19. "मुझे वास्तविक MCP प्रक्रिया स्वास्थ्य की आवश्यकता है, अनुमानित स्थिति की नहीं"</b></summary>

परिचालन टीमों को यह जानने की जरूरत है कि क्या एमसीपी वास्तव में जीवित है, न कि केवल एपीआई पहुंच योग्य है या नहीं।

**ओम्नीरूट इसे कैसे हल करता है:**

- पीआईडी, टाइमस्टैम्प, ट्रांसपोर्ट, टूल काउंट और स्कोप मोड के साथ रनटाइम हार्टबीट फ़ाइल
- एमसीपी स्थिति एपीआई दिल की धड़कन + हाल की गतिविधि का संयोजन
- प्रक्रिया/अपटाइम/दिल की धड़कन ताजगी के लिए यूआई स्टेटस कार्ड

**OMNI_टोकन_581**

**OMNI_टोकन_582**

<summary><b>📋 20. "मुझे ऑडिटेबल MCP टूल निष्पादन की आवश्यकता है"</b></summary>

जब उपकरण कॉन्फ़िगरेशन को बदलते हैं या ऑप्स क्रियाओं को ट्रिगर करते हैं, तो टीमों को फोरेंसिक ट्रैसेबिलिटी की आवश्यकता होती है।

**ओम्नीरूट इसे कैसे हल करता है:**

- MCP टूल कॉल के लिए SQLite समर्थित ऑडिट लॉगिंग
- टूल, सफलता/असफलता, एपीआई कुंजी और पेजिनेशन द्वारा फ़िल्टर
- डैशबोर्ड ऑडिट टेबल + स्वचालन के लिए आँकड़े समापन बिंदु

**OMNI_टोकन_587**

**OMNI_टोकन_588**

<summary><b>🔐 21. "मुझे प्रति एकीकरण के लिए स्कोप्ड MCP अनुमतियों की आवश्यकता है"</b></summary>

विभिन्न ग्राहकों को टूल श्रेणियों तक कम से कम विशेषाधिकार प्राप्त होना चाहिए।

**ओम्नीरूट इसे कैसे हल करता है:**

- नियंत्रित टूल एक्सेस के लिए 9 दानेदार एमसीपी स्कोप
- एमसीपी प्रबंधन यूआई में दायरा प्रवर्तन और दृश्यता
- परिचालन टूलींग के लिए सुरक्षित डिफ़ॉल्ट मुद्रा

**OMNI_टोकन_593**

**OMNI_टोकन_594**

<summary><b>⚙️ 22. "मुझे पुनः तैनाती के बिना परिचालन नियंत्रण की आवश्यकता है"</b></summary>

घटनाओं या लागत आयोजनों के दौरान टीमों को त्वरित रनटाइम परिवर्तन की आवश्यकता होती है।

**ओम्नीरूट इसे कैसे हल करता है:**

- कॉम्बो सक्रियण को सीधे एमसीपी डैशबोर्ड से स्विच करें
- पूर्व-निर्धारित पॉलिसी पैक से लचीलापन प्रोफ़ाइल लागू करें
- उसी ऑपरेशन पैनल से सर्किट ब्रेकर स्थिति को रीसेट करें

</details>

<details>
<summary><b>🔄 23. "मुझे लाइव A2A कार्य जीवनचक्र दृश्यता और रद्दीकरण की आवश्यकता है"</b></summary>

जीवनचक्र दृश्यता के बिना, कार्य घटनाओं का परीक्षण करना कठिन हो जाता है।

**ओम्नीरूट इसे कैसे हल करता है:**

- पेजिनेशन के साथ राज्य/कौशल द्वारा कार्य सूचीकरण/फ़िल्टरिंग
- कार्य मेटाडेटा, घटनाओं और कलाकृतियों पर ड्रिल-डाउन
- पुष्टि के साथ कार्य रद्दीकरण समापन बिंदु और यूआई कार्रवाई

**OMNI_टोकन_605**

**OMNI_टोकन_606**

<summary><b>🌊 24. "मुझे A2A लोड के लिए सक्रिय स्ट्रीम मेट्रिक्स की आवश्यकता है"</b></summary>

स्ट्रीमिंग वर्कफ़्लो के लिए समवर्ती और लाइव कनेक्शन में परिचालन अंतर्दृष्टि की आवश्यकता होती है।

**ओम्नीरूट इसे कैसे हल करता है:**

- सक्रिय स्ट्रीम काउंटर A2A स्थिति में एकीकृत
- अंतिम कार्य टाइमस्टैम्प और प्रति-राज्य गणना
- वास्तविक समय ऑप्स निगरानी के लिए A2A डैशबोर्ड कार्ड

**OMNI_टोकन_611**

**OMNI_टोकन_612**

<summary><b>🪪 25. "मुझे ग्राहकों के लिए मानक एजेंट खोज की आवश्यकता है"</b></summary>

बाहरी ग्राहकों और ऑर्केस्ट्रेटर्स को ऑनबोर्डिंग के लिए मशीन-पठनीय मेटाडेटा की आवश्यकता होती है।

**ओम्नीरूट इसे कैसे हल करता है:**

- एजेंट कार्ड `/.well-known/agent.json` पर प्रदर्शित किया गया
- प्रबंधन यूआई में दिखाई गई क्षमताएं और कौशल
- A2A स्थिति API में स्वचालन के लिए खोज मेटाडेटा शामिल है

**OMNI_टोकन_617**

**OMNI_टोकन_618**

<summary><b>🧭 26. "मुझे उत्पाद UX में प्रोटोकॉल खोज योग्यता की आवश्यकता है"</b></summary>

यदि उपयोगकर्ता प्रोटोकॉल सतहों की खोज नहीं कर पाते हैं, तो अपनाने और समर्थन की गुणवत्ता में गिरावट आती है।

**ओम्नीरूट इसे कैसे हल करता है:**

- प्रॉक्सी, एमसीपी, ए2ए और एपीआई एंडपॉइंट के लिए टैब के साथ समेकित **एंडपॉइंट** पेज
- एमसीपी और ए2ए के लिए इनलाइन सेवा स्थिति टॉगल (ऑनलाइन/ऑफ़लाइन)।
- सिंहावलोकन से लेकर समर्पित प्रबंधन टैब तक के लिंक

**OMNI_टोकन_623**

**OMNI_टोकन_624**

<summary><b>🧪 27. "मुझे वास्तविक ग्राहकों के साथ एंड-टू-एंड प्रोटोकॉल सत्यापन की आवश्यकता है"</b></summary>

रिलीज़ से पहले प्रोटोकॉल संगतता को सत्यापित करने के लिए मॉक परीक्षण पर्याप्त नहीं हैं।

**ओम्नीरूट इसे कैसे हल करता है:**

- E2E सुइट जो ऐप को बूट करता है और वास्तविक MCP SDK क्लाइंट ट्रांसपोर्ट का उपयोग करता है
- A2A क्लाइंट खोज, भेजने, स्ट्रीम करने, प्राप्त करने और प्रवाह को रद्द करने के लिए परीक्षण करता है
- एमसीपी ऑडिट और ए2ए कार्य एपीआई के खिलाफ दावों की क्रॉस-चेक करें

**OMNI_टोकन_629**

**OMNI_टोकन_630**

<summary><b>📡 28. "मुझे सभी इंटरफेस में एकीकृत अवलोकन की आवश्यकता है"</b></summary>

प्रोटोकॉल द्वारा अवलोकनशीलता को विभाजित करने से ब्लाइंड स्पॉट और लंबा एमटीटीआर बनता है।

**ओम्नीरूट इसे कैसे हल करता है:**

- एक उत्पाद में एकीकृत डैशबोर्ड/लॉग/एनालिटिक्स
- स्वास्थ्य + ऑडिट + ओपनएआई, एमसीपी और ए2ए परतों में टेलीमेट्री अनुरोध
- स्थिति और स्वचालन के लिए परिचालन एपीआई

**OMNI_टोकन_635**

**OMNI_टोकन_636**

<summary><b>💼 29. "मुझे प्रॉक्सी + टूल्स + एजेंट ऑर्केस्ट्रेशन के लिए एक रनटाइम की आवश्यकता है"</b></summary>

कई अलग-अलग सेवाएँ चलाने से परिचालन लागत और विफलता मोड बढ़ जाते हैं।

**ओम्नीरूट इसे कैसे हल करता है:**

- OpenAI-संगत प्रॉक्सी, MCP सर्वर और A2A सर्वर एक स्टैक में
- साझा प्रमाणीकरण, लचीलापन, डेटा भंडारण और अवलोकन क्षमता
- सभी संपर्क सतहों पर सुसंगत नीति मॉडल

**OMNI_टोकन_641**

**OMNI_टोकन_642**

<summary><b>🚀 30. "मुझे ग्लू-कोड फैलाव के बिना एजेंटिक वर्कफ़्लो भेजने की आवश्यकता है"</b></summary>

कई तदर्थ सेवाओं और स्क्रिप्ट्स को सिलाई करते समय टीमों की गति कम हो जाती है।

**ओम्नीरूट इसे कैसे हल करता है:**

- ग्राहकों और एजेंटों के लिए एकीकृत समापन बिंदु रणनीति
- अंतर्निहित प्रोटोकॉल प्रबंधन यूआई और धूम्रपान सत्यापन पथ
- उत्पादन के लिए तैयार नींव (सुरक्षा, लॉगिंग, लचीलापन, बैकअप)

**OMNI_टोकन_647**

### उदाहरण प्लेबुक (एकीकृत उपयोग के मामले)

**प्लेबुक ए: सशुल्क सदस्यता + सस्ता बैकअप अधिकतम करें**

```txt
Combo: "maximize-claude"
  1. cc/claude-opus-4-6
  2. glm/glm-4.7
  3. if/kimi-k2-thinking

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

**प्लेबुक बी: शून्य-लागत कोडिंग स्टैक**

```txt
Combo: "free-forever"
  1. gc/gemini-3-flash
  2. if/kimi-k2-thinking
  3. qw/qwen3-coder-plus

Monthly cost: $0
Outcome: stable free coding workflow
```

**प्लेबुक सी: 24/7 हमेशा चालू फ़ॉलबैक श्रृंखला**

```txt
Combo: "always-on"
  1. cc/claude-opus-4-6
  2. cx/gpt-5.2-codex
  3. glm/glm-4.7
  4. minimax/MiniMax-M2.1
  5. if/kimi-k2-thinking

Outcome: deep fallback depth for deadline-critical workloads
```

**प्लेबुक डी: एजेंट एमसीपी + ए2ए के साथ काम करता है**

**OMNI_टोकन_5**

---

## 🆓 निःशुल्क प्रारंभ करें - शून्य कॉन्फ़िगरेशन लागत

> **$0/माह** पर मिनटों में AI कोडिंग सेटअप करें। इन मुफ़्त खातों को कनेक्ट करें और अंतर्निहित **फ़्री स्टैक** कॉम्बो का उपयोग करें।

| कदम | कार्रवाई                                               | प्रदाता अनलॉक                                              |
| --- | ------------------------------------------------------ | ---------------------------------------------------------- |
| 1   | कनेक्ट **किरो** (AWS बिल्डर आईडी OAuth)                | क्लाउड सॉनेट 4.5, हाइकु 4.5 - **असीमित**                   |
| 2   | कनेक्ट करें **iFlow** (Google OAuth)                   | किमी-के2-सोच, क्वेन3-कोडर-प्लस, डीपसीक-आर1... — **असीमित** |
| 3   | कनेक्ट **क्वेन** (डिवाइस कोड)                          | qwen3-कोडर-प्लस, qwen3-कोडर-फ़्लैश... — **असीमित**         |
| 4   | कनेक्ट **मिथुन सीएलआई** (Google OAuth)                 | जेमिनी-3-फ़्लैश, जेमिनी-2.5-प्रो — **180K/महीना मुफ़्त**   |
| 5   | `/dashboard/combos` → **निःशुल्क स्टैक ($0)** टेम्पलेट | सभी मुफ़्त प्रदाताओं को स्वचालित रूप से राउंड-रॉबिन करें   |

**किसी भी आईडीई/सीएलआई को यहां इंगित करें:** `http://localhost:20128/v1` · एपीआई कुंजी: `any-string` · हो गया।

> **वैकल्पिक अतिरिक्त कवरेज (निःशुल्क भी):** ग्रोक एपीआई कुंजी (30 आरपीएम मुफ्त), एनवीडिया एनआईएम (40 आरपीएम मुफ्त, 70+ मॉडल), सेरेब्रास (1एम टोकन/दिन), लॉन्गकैट एपीआई कुंजी (50एम टोकन/दिन!), क्लाउडफ्लेयर वर्कर्स एआई (10के न्यूरॉन्स/दिन, 50+ मॉडल)।

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

### 1) इंस्टॉल करें और चलाएं

**OMNI_टोकन_6**

> **pnpm उपयोगकर्ता:** `better-sqlite3` और `@swc/core` के लिए आवश्यक मूल बिल्ड स्क्रिप्ट को सक्षम करने के लिए इंस्टॉल के बाद `pnpm approve-builds -g` चलाएँ:
>
> ```bash
> pnpm install -g omniroute
> pnpm approve-builds -g   # Select all packages → approve
> omniroute
> ```

डैशबोर्ड `http://localhost:20128` पर खुलता है और API बेस URL `http://localhost:20128/v1` है।

| आदेश                    | विवरण                                                             |
| ----------------------- | ----------------------------------------------------------------- | ----------- |
| `omniroute`             | सर्वर प्रारंभ करें (`PORT=20128`, API और डैशबोर्ड एक ही पोर्ट पर) |
| `omniroute --port 3000` | कैनोनिकल/एपीआई पोर्ट को 3000                                      | पर सेट करें |
| `omniroute --mcp`       | MCP सर्वर (stdio ट्रांसपोर्ट) प्रारंभ करें                        |
| `omniroute --no-open`   | ब्राउज़र को स्वतः न खोलें                                         |
| `omniroute --help`      | सहायता दिखाएँ                                                     |

वैकल्पिक स्प्लिट-पोर्ट मोड:

**OMNI_टोकन_8**

### 2) प्रदाताओं को कनेक्ट करें और अपनी एपीआई कुंजी बनाएं

1. डैशबोर्ड खोलें → `Providers` और कम से कम एक प्रदाता (OAuth या API कुंजी) कनेक्ट करें।
2. डैशबोर्ड खोलें → `Endpoints` और एक एपीआई कुंजी बनाएं।
3. (वैकल्पिक) डैशबोर्ड खोलें → `Combos` और अपनी फ़ॉलबैक श्रृंखला सेट करें।

### 3) अपने कोडिंग टूल को ओम्निरूट की ओर इंगित करें

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

क्लाउड कोड, कोडेक्स सीएलआई, जेमिनी सीएलआई, कर्सर, क्लाइन, ओपनक्लाव, ओपनकोड और ओपनएआई-संगत एसडीके के साथ काम करता है।

### 4) प्रोटोकॉल सक्षम और मान्य करें (v2.0)

**एमसीपी (टूल-संचालित संचालन के लिए):**

```bash
omniroute --mcp
```

फिर अपने MCP क्लाइंट को `stdio` पर कनेक्ट करें और टूल का परीक्षण करें जैसे:

- `omniroute_get_health`
- `omniroute_list_combos`

**A2A (एजेंट-टू-एजेंट वर्कफ़्लो के लिए):**

**OMNI_टोकन_11**

**OMNI_टोकन_12**

### 5) हर चीज़ को शुरू से अंत तक सत्यापित करें (अनुशंसित)

**OMNI_टोकन_13**

यह सुइट चल रहे ऐप के विरुद्ध वास्तविक MCP और A2A क्लाइंट प्रवाह को मान्य करता है।

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

**OMNI_टोकन_14**

---

## 🐳 डॉकर

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

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

**OMNI_टोकन_15**

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

**OMNI_टोकन_16**

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

**OMNI_टोकन_17**

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

---

## 🖥️ डेस्कटॉप ऐप - ऑफ़लाइन और हमेशा चालू

> 🆕 **नया!** ओमनीरूट अब विंडोज, मैकओएस और लिनक्स के लिए **नेटिव डेस्कटॉप एप्लिकेशन** के रूप में उपलब्ध है।

ओम्नीरूट को एक स्टैंडअलोन डेस्कटॉप ऐप के रूप में चलाएं - स्थानीय मॉडलों के लिए कोई टर्मिनल, कोई ब्राउज़र, कोई इंटरनेट आवश्यक नहीं है। इलेक्ट्रॉन-आधारित ऐप में शामिल हैं:

- 🖥️ **नेटिव विंडो** - सिस्टम ट्रे एकीकरण के साथ समर्पित ऐप विंडो
- 🔄 **ऑटो-स्टार्ट** — सिस्टम लॉगिन पर ओमनीरूट लॉन्च करें
- 🔔 **मूल सूचनाएं** - कोटा समाप्त होने या प्रदाता समस्याओं के लिए अलर्ट प्राप्त करें
- ⚡ **वन-क्लिक इंस्टॉल** - एनएसआईएस (विंडोज़), डीएमजी (मैकओएस), ऐपइमेज (लिनक्स)
- 🌐 **ऑफ़लाइन मोड** — बंडल सर्वर के साथ पूरी तरह ऑफ़लाइन काम करता है

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

**OMNI_टोकन_18**

### सिस्टम ट्रे

न्यूनतम होने पर, ओमनीरूट त्वरित क्रियाओं के साथ आपके सिस्टम ट्रे में रहता है:

- डैशबोर्ड खोलें
- सर्वर पोर्ट बदलें
- आवेदन छोड़ें

📖 पूर्ण दस्तावेज: [**OMNI_TOKEN_153**](electron/README.md)

---

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

| टियर              | प्रदाता                      | लागत                              | कोटा रीसेट             | के लिए सर्वश्रेष्ठ                     |
| ----------------- | ---------------------------- | --------------------------------- | ---------------------- | -------------------------------------- |
| **💳 सदस्यता**    | क्लाउड कोड (प्रो)            | $20/माह                           | 5 घंटे + साप्ताहिक     | पहले ही सदस्यता ले ली है               |
|                   | कोडेक्स (प्लस/प्रो)          | $20-200/महीना                     | 5 घंटे + साप्ताहिक     | OpenAI उपयोगकर्ता                      |
|                   | जेमिनी सीएलआई                | **मुफ़्त**                        | 180K/माह + 1K/दिन      | सब लोग!                                |
|                   | गिटहब कोपायलट                | $10-19/माह                        | मासिक                  | GitHub उपयोगकर्ता                      |
| **🔑एपीआई कुंजी** | एनवीडिया एनआईएम              | **मुफ़्त** (हमेशा के लिए देव)     | ~40 आरपीएम             | 70+ खुले मॉडल                          |
|                   | सेरेब्रस                     | **मुफ़्त** (1 मिलियन टोकन/दिन)    | 60K टीपीएम / 30 आरपीएम | दुनिया का सबसे तेज़                    |
|                   | ग्रोक                        | **मुफ़्त** (30 आरपीएम)            | 14.4K आरपीडी           | अल्ट्रा-फास्ट लामा/जेम्मा              |
|                   | डीपसीक V3.2                  | $0.27/$1.10 प्रति 1 मिलियन        | कोई नहीं               | सर्वोत्तम मूल्य/गुणवत्ता तर्क          |
|                   | xAI ग्रोक-4 फास्ट            | **$0.20/$0.50 प्रति 1 मिलियन** 🆕 | कोई नहीं               | सबसे तेज़ + टूल कॉलिंग, अल्ट्रालो      |
|                   | xAI ग्रोक-4 (मानक)           | $0.20/$1.50 प्रति 1 मिलियन 🆕     | कोई नहीं               | xAI से रीज़निंग फ्लैगशिप               |
|                   | मिस्ट्रल                     | नि:शुल्क परीक्षण + सशुल्क         | दर सीमित               | यूरोपीय एआई                            |
|                   | ओपनराउटर                     | भुगतान-प्रति-उपयोग                | कोई नहीं               | 100+ मॉडल कुल मिलाकर।                  |
| **💰सस्ता**       | GLM-5 (Z.AI के माध्यम से) 🆕 | $0.5/1 मिलियन                     | प्रतिदिन सुबह 10 बजे   | 128K आउटपुट, नवीनतम फ्लैगशिप           |
|                   | जीएलएम-4.7                   | $0.6/1 मिलियन                     | प्रतिदिन सुबह 10 बजे   | बजट बैकअप                              |
|                   | मिनीमैक्स एम2.5 🆕           | $0.3/1M इनपुट                     | 5 घंटे की रोलिंग       | तर्क + एजेंटिक कार्य                   |
|                   | मिनीमैक्स एम2.1              | $0.2/1 मिलियन                     | 5 घंटे की रोलिंग       | सबसे सस्ता विकल्प                      |
|                   | किमी K2.5 (मूनशॉट एपीआई) 🆕  | भुगतान-प्रति-उपयोग                | कोई नहीं               | डायरेक्ट मूनशॉट एपीआई एक्सेस           |
|                   | किमी K2                      | $9/महीना फ्लैट                    | 10एम टोकन/माह          | अनुमानित लागत                          |
| **🆓 मुफ़्त**     | आईफ्लो                       | **$0**                            | असीमित                 | 5 मॉडल असीमित                          |
|                   | क्वेन                        | **$0**                            | असीमित                 | 4 मॉडल असीमित                          |
|                   | किरो                         | **$0**                            | असीमित                 | क्लाउड सॉनेट/हाइकू (एडब्ल्यूएस बिल्डर) |
|                   | लॉन्गकैट फ्लैश-लाइट 🆕       | **$0** (50 मिलियन टोकन/दिन 🔥)    | 1 आरपीएस               | पृथ्वी पर सबसे बड़ा मुफ़्त कोटा        |
|                   | परागण एआई 🆕                 | **$0** (कोई कुंजी आवश्यक नहीं)    | 1 अनुरोध/15s           | जीपीटी-5, क्लाउड, डीपसीक, लामा 4       |
|                   | क्लाउडफ्लेयर वर्कर्स एआई 🆕  | **$0** (10K न्यूरॉन्स/दिन)        | ~150 सम्मान/दिन        | 50+ मॉडल, वैश्विक बढ़त                 |
|                   | स्केलवे एआई 🆕               | **$0** (कुल 1 मिलियन टोकन)        | दर सीमित               | ईयू/जीडीपीआर, क्वेन3 235बी, लामा 70बी  |

> 🆕 **नए मॉडल जोड़े गए (मार्च 2026):** $0.20/$0.50/M पर ग्रोक-4 फास्ट परिवार (1143ms पर बेंचमार्क - जेमिनी 2.5 फ्लैश से 30% तेज), 128K आउटपुट के साथ Z.AI के माध्यम से GLM-5, मिनीमैक्स M2.5 रीजनिंग, डीपसीक V3.2 अद्यतन मूल्य निर्धारण, मूनशॉट डायरेक्ट एपीआई के माध्यम से किमी K2.5।

**💡 $0 कॉम्बो स्टैक - पूर्ण निःशुल्क सेटअप:**

**OMNI_टोकन_19**

**शून्य लागत. कोडिंग कभी बंद नहीं होती।** इसे एक ओमनीरूट कॉम्बो के रूप में कॉन्फ़िगर करें और सभी फ़ॉलबैक स्वचालित रूप से होते हैं - कोई मैन्युअल स्विचिंग नहीं।

---

---

## 🆓 निःशुल्क मॉडल - आपको वास्तव में क्या मिलता है

> नीचे दिए गए सभी मॉडल **शून्य क्रेडिट कार्ड की आवश्यकता के साथ 100% निःशुल्क** हैं। जब एक कोटा समाप्त हो जाता है तो ओमनीरूट उनके बीच ऑटो-रूट करता है - उन सभी को एक अटूट $0 कॉम्बो के लिए संयोजित करें।

### 🔵 क्लाउड मॉडल (किरो के माध्यम से - एडब्ल्यूएस बिल्डर आईडी)

| मॉडल                | उपसर्ग | सीमा       | दर सीमा                           |
| ------------------- | ------ | ---------- | --------------------------------- |
| `claude-sonnet-4.5` | `kr/`  | **असीमित** | कोई रिपोर्ट नहीं की गई दैनिक सीमा |
| `claude-haiku-4.5`  | `kr/`  | **असीमित** | कोई रिपोर्ट नहीं की गई दैनिक सीमा |
| `claude-opus-4.6`   | `kr/`  | **असीमित** | किरो के माध्यम से नवीनतम रचना     |

### 🟢 IFLOW मॉडल (निःशुल्क OAuth - कोई क्रेडिट कार्ड नहीं)

| मॉडल               | उपसर्ग | सीमा       | दर सीमा                     |
| ------------------ | ------ | ---------- | --------------------------- |
| `kimi-k2-thinking` | `if/`  | **असीमित** | कोई रिपोर्ट की गई सीमा नहीं |
| `qwen3-coder-plus` | `if/`  | **असीमित** | कोई रिपोर्ट की गई सीमा नहीं |
| `deepseek-r1`      | `if/`  | **असीमित** | कोई रिपोर्ट की गई सीमा नहीं |
| `minimax-m2.1`     | `if/`  | **असीमित** | कोई रिपोर्ट की गई सीमा नहीं |
| `kimi-k2`          | `if/`  | **असीमित** | कोई रिपोर्ट की गई सीमा नहीं |

### 🟡 क्वेन मॉडल (डिवाइस कोड प्रामाणिक)

| मॉडल                | उपसर्ग | सीमा       | दर सीमा                     |
| ------------------- | ------ | ---------- | --------------------------- |
| `qwen3-coder-plus`  | `qw/`  | **असीमित** | कोई रिपोर्ट की गई सीमा नहीं |
| `qwen3-coder-flash` | `qw/`  | **असीमित** | कोई रिपोर्ट की गई सीमा नहीं |
| `qwen3-coder-next`  | `qw/`  | **असीमित** | कोई रिपोर्ट की गई सीमा नहीं |
| `vision-model`      | `qw/`  | **असीमित** | मल्टीमॉडल (चित्र)           |

### 🟣 जेमिनी सीएलआई (Google OAuth)

| मॉडल                     | उपसर्ग | सीमा                       | दर सीमा       |
| ------------------------ | ------ | -------------------------- | ------------- |
| `gemini-3-flash-preview` | `gc/`  | **180K टोकन/माह** + 1K/दिन | मासिक रीसेट   |
| **OMNI_टोकन_180**        | `gc/`  | 180K/माह (साझा पूल)        | उच्च गुणवत्ता |

### ⚫ एनवीडिया एनआईएम (मुफ्त एपीआई कुंजी - build.nvidia.com)

| Tier         | दैनिक सीमा         | दर सीमा        | नोट्स                                                 |
| ------------ | ------------------ | -------------- | ----------------------------------------------------- |
| मुफ़्त (देव) | कोई टोकन सीमा नहीं | **~40 आरपीएम** | 70+ मॉडल; 2025 के मध्य में शुद्ध दर सीमा में परिवर्तन |

लोकप्रिय निःशुल्क मॉडल: `moonshotai/kimi-k2.5` (किमी K2.5), `z-ai/glm4.7` (GLM 4.7), `deepseek-ai/deepseek-v3.2` (डीपसीक V3.2), `nvidia/llama-3.3-70b-instruct`, `deepseek/deepseek-r1`

### ⚪ सेरेब्रस (मुफ्त एपीआई कुंजी - inference.cerebras.ai)

| टियर   | दैनिक सीमा            | दर सीमा                | नोट्स                                                     |
| ------ | --------------------- | ---------------------- | --------------------------------------------------------- |
| मुफ़्त | **1 मिलियन टोकन/दिन** | 60K टीपीएम / 30 आरपीएम | दुनिया का सबसे तेज़ एलएलएम अनुमान; प्रतिदिन रीसेट होता है |

मुफ़्त उपलब्ध: `llama-3.3-70b`, `llama-3.1-8b`, `deepseek-r1-distill-llama-70b`

### 🔴 GROQ (निःशुल्क एपीआई कुंजी - console.groq.com)

| टियर   | दैनिक सीमा       | दर सीमा              | नोट्स                                           |
| ------ | ---------------- | -------------------- | ----------------------------------------------- |
| मुफ़्त | **14.4K आरपीडी** | प्रति मॉडल 30 आरपीएम | कोई क्रेडिट कार्ड नहीं; 429 सीमा पर, शुल्क नहीं |

निःशुल्क उपलब्ध: `llama-3.3-70b-versatile`, `gemma2-9b-it`, `mixtral-8x7b`, `whisper-large-v3`

### 🔴 लॉन्गकैट एआई (फ्री एपीआई कुंजी - longcat.chat) 🆕

| मॉडल                          | उपसर्ग | दैनिक निःशुल्क कोटा | नोट्स                          |
| ----------------------------- | ------ | ------------------- | ------------------------------ |
| `LongCat-Flash-Lite`          | `lc/`  | **50M टोकन** 💥     | अब तक का सबसे बड़ा मुफ़्त कोटा |
| `LongCat-Flash-Chat`          | `lc/`  | 500K टोकन           | मल्टी-टर्न चैट                 |
| `LongCat-Flash-Thinking`      | `lc/`  | 500K टोकन           | तर्क/सीओटी                     |
| `LongCat-Flash-Thinking-2601` | `lc/`  | 500K टोकन           | जनवरी 2026 संस्करण             |
| `LongCat-Flash-Omni-2603`     | `lc/`  | 500K टोकन           | मल्टीमॉडल                      |

> सार्वजनिक बीटा में रहते हुए 100% निःशुल्क। ईमेल या फोन से [longcat.chat](https://longcat.chat) पर साइन अप करें। प्रतिदिन 00:00 UTC पर रीसेट होता है।

### 🟢 परागण एआई (कोई एपीआई कुंजी आवश्यक नहीं) 🆕

| मॉडल       | उपसर्ग | दर सीमा      | पीछे प्रदाता       |
| ---------- | ------ | ------------ | ------------------ |
| `openai`   | `pol/` | 1 अनुरोध/15s | जीपीटी-5           |
| `claude`   | `pol/` | 1 अनुरोध/15s | एंथ्रोपिक क्लाउड   |
| `gemini`   | `pol/` | 1 अनुरोध/15s | गूगल जेमिनी        |
| `deepseek` | `pol/` | 1 अनुरोध/15s | डीपसीक वी3         |
| `llama`    | `pol/` | 1 अनुरोध/15s | मेटा लामा 4 स्काउट |
| `mistral`  | `pol/` | 1 अनुरोध/15s | मिस्ट्रल एआई       |

> ✨ **शून्य घर्षण:** कोई साइनअप नहीं, कोई एपीआई कुंजी नहीं। खाली कुंजी फ़ील्ड के साथ परागण प्रदाता जोड़ें और यह तुरंत काम करता है।

### 🟠 क्लाउडफ्लेयर वर्कर्स एआई (फ्री एपीआई कुंजी - क्लाउडफ्लेयर.कॉम) 🆕

| टियर   | दैनिक न्यूरॉन्स | समतुल्य उपयोग                               | नोट्स                  |
| ------ | --------------- | ------------------------------------------- | ---------------------- |
| मुफ़्त | **10,000**      | ~150 एलएलएम सम्मान / 500s ऑडियो / 15K एंबेड | वैश्विक बढ़त, 50+ मॉडल |

लोकप्रिय निःशुल्क मॉडल: `@cf/meta/llama-3.3-70b-instruct`, `@cf/google/gemma-3-12b-it`, `@cf/openai/whisper-large-v3-turbo` (मुफ़्त ऑडियो!), `@cf/qwen/qwen2.5-coder-15b-instruct`

> [dash.cloudflare.com](https://dash.cloudflare.com) से एपीआई टोकन + खाता आईडी की आवश्यकता है। प्रदाता सेटिंग्स में खाता आईडी संग्रहीत करें।

### 🟣 स्केलवे एआई (1एम निःशुल्क टोकन - स्केलवे.कॉम) 🆕

| टियर   | मुफ़्त कोटा | स्थान        | नोट्स                                            |
| ------ | ----------- | ------------ | ------------------------------------------------ |
| मुफ़्त | **1M टोकन** | 🇫🇷पेरिस, ईयू | सीमा के भीतर किसी क्रेडिट कार्ड की आवश्यकता नहीं |

मुफ़्त उपलब्ध: `qwen3-235b-a22b-instruct-2507` (Qwen3 235B!), `llama-3.1-70b-instruct`, `mistral-small-3.2-24b-instruct-2506`, `deepseek-v3-0324`

> ईयू/जीडीपीआर के अनुरूप। [console.scaleway.com](https://console.scaleway.com) पर API कुंजी प्राप्त करें।

> **💡 परम निःशुल्क स्टैक (11 प्रदाता, $0 हमेशा के लिए):**
>
> ```
> Kiro (kr/)             → Claude Sonnet/Haiku UNLIMITED
> iFlow (if/)            → kimi-k2-thinking, qwen3-coder-plus, deepseek-r1 UNLIMITED
> LongCat Lite (lc/)     → LongCat-Flash-Lite — 50M tokens/day 🔥
> Pollinations (pol/)    → GPT-5, Claude, DeepSeek, Llama 4 — no key needed
> Qwen (qw/)             → qwen3-coder models UNLIMITED
> Gemini (gemini/)       → Gemini 2.5 Flash — 1,500 req/day free
> Cloudflare AI (cf/)    → 50+ models — 10K Neurons/day
> Scaleway (scw/)        → Qwen3 235B, Llama 70B — 1M free tokens (EU)
> Groq (groq/)           → Llama/Gemma — 14.4K req/day ultra-fast
> NVIDIA NIM (nvidia/)   → 70+ open models — 40 RPM forever
> Cerebras (cerebras/)   → Llama/Qwen world-fastest — 1M tok/day
> ```

## 🎙️ निःशुल्क ट्रांसक्रिप्शन कॉम्बो

> **$0** के लिए किसी भी ऑडियो/वीडियो को ट्रांसक्राइब करें - डीपग्राम $200 मुफ़्त, असेंबलीएआई $50 फ़ॉलबैक, ग्रोक व्हिस्पर असीमित आपातकालीन बैकअप के साथ अग्रणी है।

| प्रदाता           | मुफ़्त क्रेडिट             | सर्वश्रेष्ठ मॉडल                          | दर सीमा                                  |
| ----------------- | -------------------------- | ----------------------------------------- | ---------------------------------------- |
| 🟢 **दीपग्राम**   | **$200 निःशुल्क** (साइनअप) | `nova-3` — सर्वोत्तम सटीकता, 30+ भाषाएँ   | निःशुल्क क्रेडिट पर कोई आरपीएम सीमा नहीं |
| 🔵 **असेंबलीएआई** | **$50 निःशुल्क** (साइनअप)  | `universal-3-pro` — अध्याय, भावना, पीआईआई | निःशुल्क क्रेडिट पर कोई आरपीएम सीमा नहीं |
| 🔴 **ग्रोक**      | **हमेशा के लिए मुफ़्त**    | `whisper-large-v3` — OpenAI व्हिस्पर      | 30 आरपीएम (दर सीमित)                     |

**`/dashboard/combos` में सुझाया गया कॉम्बो:**

**OMNI_टोकन_21**

फिर `/dashboard/media` → **ट्रांसक्रिप्शन** टैब में: कोई भी ऑडियो या वीडियो फ़ाइल अपलोड करें → अपना कॉम्बो एंडपॉइंट चुनें → समर्थित प्रारूपों में ट्रांसक्रिप्शन प्राप्त करें।

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

ओमनीरूट v2.0 को केवल एक रिले प्रॉक्सी नहीं, बल्कि एक ऑपरेशनल प्लेटफॉर्म के रूप में बनाया गया है।

### 🆕 नया - क्लॉराउटर-प्रेरित सुधार (मार्च 2026)

| फ़ीचर                               | यह क्या करता है                                                                                          |
| ----------------------------------- | -------------------------------------------------------------------------------------------------------- |
| ⚡ **ग्रोक-4 फास्ट फ़ैमिली**        | $0.20/$0.50/M पर xAI मॉडल - बेंचमार्क 1143ms (जेमिनी 2.5 फ्लैश से 30% तेज)                               |
| 🧠 **Z.AI के माध्यम से GLM-5**      | 128K आउटपुट संदर्भ, $0.5/1M - GLM परिवार का नवीनतम फ्लैगशिप                                              |
| 🔮 **मिनीमैक्स एम2.5**              | $0.30/1 मिलियन पर रीज़निंग + एजेंटिक कार्य - एम2.1 से महत्वपूर्ण उन्नयन                                  |
| 🎯 **टूलकॉलिंग फ़्लैग प्रति मॉडल**  | रजिस्ट्री में प्रति-मॉडल `toolCalling: true/false` - ऑटोकॉम्बो गैर-उपकरण-सक्षम मॉडल को छोड़ देता है      |
| 🌍 **बहुभाषी आशय का पता लगाना**     | ऑटोकॉम्बो स्कोरिंग में पीटी/जेडएच/ईएस/एआर कीवर्ड - गैर-अंग्रेजी सामग्री के लिए बेहतर मॉडल चयन            |
| 📊 **बेंचमार्क-प्रेरित फ़ॉलबैक**    | लाइव अनुरोधों से वास्तविक p95 विलंबता कॉम्बो स्कोरिंग फ़ीड करती है - ऑटोकॉम्बो वास्तविक डेटा से सीखता है |
| 🔁 **डुप्लीकेशन का अनुरोध**         | कंटेंट-हैश आधारित डिडअप विंडो - मल्टी-एजेंट सुरक्षित, डुप्लिकेट शुल्क को रोकता है                        |
| 🔌 **प्लग करने योग्य राउटर रणनीति** | एक्स्टेंसिबल `RouterStrategy` इंटरफ़ेस — प्लगइन्स के रूप में कस्टम रूटिंग लॉजिक जोड़ें                   |

### 🚀 पिछला v2.0.9+ - खेल का मैदान, सीएलआई फ़िंगरप्रिंट और एसीपी

| फ़ीचर                                         | यह क्या करता है                                                                                                                                                                                                                                                            |
| --------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 🎮 **मॉडल खेल का मैदान**                      | किसी भी मॉडल का सीधे परीक्षण करने के लिए डैशबोर्ड पेज - प्रदाता/मॉडल/एंडपॉइंट चयनकर्ता, मोनाको संपादक, स्ट्रीमिंग, निरस्त, समय                                                                                                                                             |
| 🔏 **सीएलआई फ़िंगरप्रिंट मिलान**              | मूल सीएलआई हस्ताक्षरों से मिलान करने के लिए प्रति-प्रदाता हेडर/बॉडी ऑर्डरिंग - सेटिंग्स> सुरक्षा में प्रति प्रदाता टॉगल करें। **आपका प्रॉक्सी आईपी संरक्षित है**                                                                                                           |
| 🤝 **एसीपी सपोर्ट (एजेंट क्लाइंट प्रोटोकॉल)** | सीएलआई एजेंट खोज (कोडेक्स, क्लाउड, गूज़, जेमिनी सीएलआई, ओपनक्लॉ + 9 अधिक), प्रोसेस स्पॉनर, `/api/acp/agents` एंडपॉइंट                                                                                                                                                      |
| 🤖 **एसीपी एजेंट्स डैशबोर्ड**                 | डीबग › एजेंट पेज - किसी भी सीएलआई टूल के लिए इंस्टॉल स्थिति, संस्करण, कस्टम एजेंट फॉर्म के साथ 14 एजेंटों का ग्रिड। **ओपनकोड** उपयोगकर्ताओं को एक "डाउनलोड ओपनकोड.जेसन" बटन मिलता है जो सभी उपलब्ध मॉडलों के साथ उपयोग के लिए तैयार कॉन्फ़िगरेशन को स्वतः उत्पन्न करता है। |
| 🔧 **कस्टम मॉडल `apiFormat` रूटिंग**          | `apiFormat: "responses"` वाले कस्टम मॉडल अब रिस्पॉन्स एपीआई अनुवादक पर सही ढंग से रूट करते हैं                                                                                                                                                                             |
| 🏢 **कोडेक्स कार्यक्षेत्र अलगाव**             | प्रति ईमेल एकाधिक कोडेक्स कार्यस्थान - OAuth कार्यस्थान आईडी द्वारा कनेक्शन को सही ढंग से अलग करता है                                                                                                                                                                      |
| 🔄 **इलेक्ट्रॉन ऑटो-अपडेट**                   | डेस्कटॉप ऐप अपडेट की जांच करता है + रीस्टार्ट होने पर ऑटो-इंस्टॉल                                                                                                                                                                                                          |

### 🤖 एजेंट और प्रोटोकॉल संचालन (v2.0)

| फ़ीचर                              | यह क्या करता है                                                                                                        |
| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------- | -------------------- |
| 🔧 **एमसीपी सर्वर (16 उपकरण)**     | 3 ट्रांसपोर्ट के माध्यम से आईडीई/एजेंट उपकरण: stdio, SSE (`/api/mcp/sse`), स्ट्रीम करने योग्य HTTP (`/api/mcp/stream`) |
| 🤝 **A2A सर्वर (JSON-RPC + SSE)**  | सिंक और स्ट्रीमिंग प्रवाह के साथ एजेंट-टू-एजेंट कार्य निष्पादन                                                         |
| 🧭 **समेकित समापन बिंदु पृष्ठ**    | एंडपॉइंट प्रॉक्सी, एमसीपी, ए2ए और एपीआई एंडपॉइंट टैब के साथ टैब्ड प्रबंधन पृष्ठ                                        |
| 🎚️ **सेवा सक्षम/अक्षम टॉगल**       | सेटिंग्स दृढ़ता के साथ एमसीपी और ए2ए के लिए चालू/बंद स्विच (डिफ़ॉल्ट: बंद)                                             |
| 🛰️ **एमसीपी रनटाइम हार्टबीट**      | वास्तविक प्रक्रिया स्थिति (पीआईडी, अपटाइम, दिल की धड़कन की उम्र, परिवहन, स्कोप मोड)                                    |
| 📋 **एमसीपी ऑडिट ट्रेल**           | सफलता/असफलता और मुख्य एट्रिब्यूशन के साथ फ़िल्टर करने योग्य ऑडिट लॉग                                                   |
| 🔐 **एमसीपी स्कोप प्रवर्तन**       | नियंत्रित टूल एक्सेस के लिए 9 ग्रैन्युलर स्कोप अनुमतियाँ                                                               |
| 📡 **A2A कार्य जीवनचक्र प्रबंधन**  | कार्यों को सूचीबद्ध करें/फ़िल्टर करें, घटनाओं/कलाकृतियों का निरीक्षण करें, चल रहे कार्यों को रद्द करें                 |
| 📋 **एजेंट कार्ड डिस्कवरी**        | क्लाइंट ऑटो-डिस्कवरी के लिए `/.well-known/agent.json`                                                                  |
| 🧪 **प्रोटोकॉल E2E टेस्ट हार्नेस** | वास्तविक MCP SDK + A2A क्लाइंट `test:protocols:e2e`                                                                    | में प्रवाहित होता है |
| ⚙️ **परिचालन नियंत्रण**            | कॉम्बो स्विच करें, लचीलापन प्रोफ़ाइल लागू करें, एक नियंत्रण सतह से ब्रेकर रीसेट करें                                   |

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

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

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

| फ़ीचर                        | यह क्या करता है                                                                                                                                                        |
| ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 🖼️ **छवि निर्माण**           | `/v1/images/generations` क्लाउड और स्थानीय बैकएंड के साथ                                                                                                               |
| 📐 **एंबेडिंग**              | खोज और RAG पाइपलाइनों के लिए `/v1/embeddings`                                                                                                                          |
| 🎤 **ऑडियो ट्रांस्क्रिप्शन** | `/v1/audio/transcriptions` - 7 प्रदाता (डीपग्राम नोवा 3, असेंबलीएआई, ग्रोक व्हिस्पर, हगिंगफेस, इलेवनलैब्स, ओपनएआई, एज़्योर), ऑटो-लैंग्वेज डिटेक्शन, MP4/MP3/WAV सपोर्ट |
| 🔊 **टेक्स्ट-टू-स्पीच**      | `/v1/audio/speech` - सही त्रुटि संदेशों के साथ 10 प्रदाता (इलेवनलैब्स, ओपनएआई, डीपग्राम, कार्टेसिया, प्लेएचटी, हगिंगफेस, एनवीडिया एनआईएम, इनवर्ल्ड, कोक्वी, टोरटोइज़)  |
| 🎬 **वीडियो जेनरेशन**        | `/v1/videos/generations` (ComfyUI + SD WebUI वर्कफ़्लो)                                                                                                                |
| 🎵 **संगीत पीढ़ी**           | `/v1/music/generations` (ComfyUI वर्कफ़्लोज़)                                                                                                                          |
| 🛡️ **संयम**                  | `/v1/moderations` सुरक्षा जांच                                                                                                                                         |
| 🔀 **पुनर्रैंकिंग**          | प्रासंगिकता स्कोरिंग के लिए `/v1/rerank`                                                                                                                               |
| 🔍 **वेब खोज** 🆕            | `/v1/search` - 5 प्रदाता (सर्पर, ब्रेव, पर्प्लेक्सिटी, एक्सा, टैविली), 6,500+ मुफ़्त/माह, ऑटो-फ़ेलओवर, कैश                                                             |

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

| फ़ीचर                                 | यह क्या करता है                                                                                                    |
| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| 🔌 **सर्किट तोड़ने वाले**             | प्रति-मॉडल यात्रा/सीमा नियंत्रण के साथ पुनर्प्राप्ति                                                               |
| 🎯 **एंडपॉइंट-अवेयर मॉडल**            | कस्टम मॉडल समर्थित एंडपॉइंट + एपीआई प्रारूप की घोषणा करते हैं                                                      |
| 🛡️ **एंटी-थंडरिंग झुंड**              | पुनः प्रयास/दर घटनाओं पर म्यूटेक्स + सेमाफोर सुरक्षा                                                               |
| 🧠 **सिमेंटिक + सिग्नेचर कैश**        | दो कैश परतों के साथ लागत/विलंबता में कमी                                                                           |
| ⚡ **निष्क्रियता का अनुरोध**          | डुप्लिकेट सुरक्षा विंडो                                                                                            |
| 🔒 **टीएलएस फ़िंगरप्रिंट स्पूफ़िंग**  | ब्राउज़र जैसा टीएलएस फ़िंगरप्रिंट - **बॉट डिटेक्शन और अकाउंट फ़्लैगिंग को कम करता है**                             |
| 🔏 **सीएलआई फ़िंगरप्रिंट मिलान**      | मूल सीएलआई अनुरोध हस्ताक्षरों से मेल खाता है - **प्रॉक्सी आईपी को संरक्षित करते हुए प्रतिबंध जोखिम को कम करता है** |
| 🌐 **आईपी फ़िल्टरिंग**                | उजागर तैनाती के लिए अनुमति सूची/अवरुद्ध सूची नियंत्रण                                                              |
| 📊 **संपादन योग्य दर सीमाएँ**         | दृढ़ता के साथ कॉन्फ़िगर करने योग्य वैश्विक/प्रदाता-स्तर की सीमाएं                                                  |
| 🔑 **एपीआई कुंजी प्रबंधन + स्कोपिंग** | सुरक्षित कुंजी जारी करना/रोटेशन और मॉडल/प्रदाता नियंत्रण                                                           |
| 🛡️ **संरक्षित `/models`**             | मॉडल कैटलॉग के लिए वैकल्पिक प्रमाणीकरण गेटिंग और प्रदाता छिपाना                                                    |

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

| फ़ीचर                            | यह क्या करता है                                         |
| -------------------------------- | ------------------------------------------------------- |
| 📝 **अनुरोध + प्रॉक्सी लॉगिंग**  | पूर्ण अनुरोध/प्रतिक्रिया और प्रॉक्सी लॉगिंग             |
| 📉 **Streamed Detailed Logs** 🆕 | Reconstructs SSE payload streams cleanly into the UI    |
| 📋 **एकीकृत लॉग डैशबोर्ड**       | एक पृष्ठ में अनुरोध, प्रॉक्सी, ऑडिट और कंसोल दृश्य      |
| 🔍 **टेलीमेट्री के लिए अनुरोध**  | p50/p95/p99 विलंबता और अनुरोध अनुरेखण                   |
| 🏥 **स्वास्थ्य डैशबोर्ड**        | अपटाइम, ब्रेकर स्थिति, लॉकआउट, कैश आँकड़े               |
| 💰 **लागत ट्रैकिंग**             | बजट नियंत्रण और प्रति-मॉडल मूल्य निर्धारण दृश्यता       |
| 📈 **एनालिटिक्स विज़ुअलाइज़ेशन** | मॉडल/प्रदाता उपयोग अंतर्दृष्टि और रुझान दृश्य           |
| 🧪 **मूल्यांकन ढाँचा**           | विन्यास योग्य मिलान रणनीतियों के साथ गोल्डन सेट परीक्षण |

### ☁️ परिनियोजन एवं प्लेटफार्म

| फ़ीचर                           | यह क्या करता है                                           |
| ------------------------------- | --------------------------------------------------------- | ------------------------------------ |
| 🌐 **कहीं भी तैनात करें**       | लोकलहोस्ट, वीपीएस, डॉकर, क्लाउड वातावरण                   |
| 💾 **क्लाउड सिंक**              | क्लाउड वर्कर के माध्यम से कॉन्फ़िगरेशन सिंक               |
| 🔄 **बैकअप/पुनर्स्थापना**       | निर्यात/आयात और आपदा पुनर्प्राप्ति प्रवाह                 |
| 🧙 **ऑनबोर्डिंग विज़ार्ड**      | फर्स्ट-रन गाइडेड सेटअप                                    |
| 🔧 **सीएलआई टूल्स डैशबोर्ड**    | लोकप्रिय कोडिंग टूल के लिए एक-क्लिक सेटअप                 |
| 🎮 **मॉडल खेल का मैदान**        | डैशबोर्ड से किसी भी प्रदाता/मॉडल/एंडपॉइंट का परीक्षण करें |
| 🔏 **सीएलआई फ़िंगरप्रिंट टॉगल** | सेटिंग्स > सुरक्षा                                        | में प्रति प्रदाता फ़िंगरप्रिंट मिलान |
| 🌐 **i18n (30 भाषाएँ)**         | पूर्ण डैशबोर्ड + आरटीएल कवरेज के साथ डॉक्स भाषा समर्थन    |
| 🧹 **सभी मॉडल साफ़ करें**       | प्रदाता विवरण में एक-क्लिक मॉडल सूची समाशोधन              |
| 👁️ **Sidebar Controls** 🆕      | Hide components and integrations from Appearance Settings |
| 📋 **मुद्दा टेम्पलेट**          | बग और सुविधाओं के लिए मानकीकृत GitHub टेम्पलेट            |
| 📂 **कस्टम डेटा निर्देशिका**    | भंडारण स्थान के लिए `DATA_DIR` ओवरराइड                    |

### फ़ीचर डीप डाइव

#### व्यावहारिक लागत नियंत्रण के साथ स्मार्ट फ़ॉलबैक

**OMNI_टोकन_22**

जब कोटा, दर, या स्वास्थ्य विफल हो जाता है, तो ओमनीरूट मैन्युअल स्विचिंग के बिना स्वचालित रूप से अगले उम्मीदवार के पास चला जाता है।

#### प्रोटोकॉल प्रबंधन जो दृश्यमान और संचालन योग्य है

- MCP + A2A UI और डॉक्स में खोजने योग्य हैं (छिपा हुआ नहीं)
- प्रोटोकॉल स्थिति एपीआई लाइव परिचालन डेटा को उजागर करते हैं (`/api/mcp/*`, `/api/a2a/*`)
- डैशबोर्ड में दिन-2 ऑप्स के लिए क्रियाएं शामिल हैं (कॉम्बो टॉगल, ब्रेकर रीसेट, कार्य रद्दीकरण)

#### अनुवादक + सत्यापन वर्कफ़्लो

अनुवादक क्षेत्र में शामिल हैं:

- **खेल का मैदान**: परिवर्तन जांच का अनुरोध करें
- **चैट परीक्षक**: पूर्ण अनुरोध/प्रतिक्रिया राउंड-ट्रिप
- **टेस्ट बेंच**: एक बार में कई मामले
- **लाइव मॉनिटर**: वास्तविक समय यातायात दृश्य

`npm run test:protocols:e2e` के माध्यम से वास्तविक ग्राहकों के साथ प्लस प्रोटोकॉल सत्यापन।

> 📖 **[MCP Server README](open-sse/mcp-server/README.md)** - टूल संदर्भ, आईडीई कॉन्फ़िगरेशन और क्लाइंट उदाहरण
>
> 📖 **[A2A Server README](src/lib/a2a/README.md)** — कौशल, JSON-RPC विधियाँ, स्ट्रीमिंग, और कार्य जीवनचक्र

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

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

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

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

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

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

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

---

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

### प्रोटोकॉल सेटअप (एमसीपी + ए2ए)

**OMNI_टोकन_648**

<summary><b>🧩 MCP सेटअप (मॉडल संदर्भ प्रोटोकॉल)</b></summary>

stdio मोड में MCP ट्रांसपोर्ट प्रारंभ करें:

**OMNI_टोकन_23**

अनुशंसित सत्यापन प्रवाह:

1. अपने MCP क्लाइंट को stdio से कनेक्ट करें।
2. `omniroute_get_health` चलाएँ।
3. `omniroute_list_combos` चलाएँ।
4. दिल की धड़कन, गतिविधि और ऑडिट की पुष्टि के लिए `/dashboard/mcp` खोलें।

स्वचालन के लिए उपयोगी एपीआई:

- `GET /api/mcp/status`
- `GET /api/mcp/tools`
- `GET /api/mcp/audit`
- `GET /api/mcp/audit/stats`

**OMNI_टोकन_653**

**OMNI_टोकन_654**

<summary><b>🤝 A2A सेटअप (Agent2Agent)</b></summary>

एजेंट का पता लगाएं:

**OMNI_टोकन_24**

एक कार्य भेजें:

**OMNI_टोकन_25**

जीवनचक्र प्रबंधित करें:

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

परिचालन यूआई:

- `/dashboard/a2a` कार्य/राज्य/स्ट्रीम अवलोकन और धूम्रपान क्रियाओं के लिए

**OMNI_टोकन_659**

**OMNI_टोकन_660**

<summary><b>🧪 एंड-टू-एंड प्रोटोकॉल सत्यापन</b></summary>

वास्तविक ग्राहकों के साथ दोनों प्रोटोकॉल मान्य करें:

**OMNI_टोकन_26**

यह सत्यापित करता है:

- एमसीपी एसडीके क्लाइंट कनेक्ट/लिस्ट/कॉल
- A2A खोज/भेजें/स्ट्रीम/प्राप्त करें/रद्द करें
- एमसीपी ऑडिट और ए2ए कार्य प्रबंधन एपीआई में डेटा को क्रॉस-चेक करें

**OMNI_टोकन_665**

**OMNI_टोकन_666**

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

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

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

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

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

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

#### कोडेक्स खाता सीमा प्रबंधन (5 घंटे + साप्ताहिक)

प्रत्येक कोडेक्स खाते में अब `Dashboard -> Providers` में नीति टॉगल हैं:

- `5h` (चालू/बंद): 5-घंटे की विंडो सीमा नीति लागू करें।
- `Weekly` (चालू/बंद): साप्ताहिक विंडो सीमा नीति लागू करें।
- थ्रेसहोल्ड व्यवहार: जब एक सक्षम विंडो >=90% उपयोग तक पहुंच जाती है, तो वह खाता छोड़ दिया जाता है।
- रोटेशन व्यवहार: ओमनीरूट स्वचालित रूप से अगले पात्र कोडेक्स खाते पर रूट करता है।
- व्यवहार रीसेट करें: जब प्रदाता `resetAt` समय बीत जाता है, तो खाता स्वचालित रूप से फिर से पात्र हो जाता है।

परिदृश्य:

- `5h ON` + `Weekly ON`: जब कोई भी विंडो सीमा तक पहुंचती है तो खाता छोड़ दिया जाता है।
- `5h OFF` + `Weekly ON`: केवल साप्ताहिक उपयोग ही खाते को ब्लॉक कर सकता है।
- `5h ON` + `Weekly OFF`: केवल 5 घंटे का उपयोग ही खाते को ब्लॉक कर सकता है।
- `resetAt` उत्तीर्ण: खाता स्वचालित रूप से रोटेशन में पुनः प्रवेश करता है (कोई मैन्युअल पुनः सक्षम नहीं)।

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

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

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

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

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

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

**OMNI_टोकन_671**

**OMNI_टोकन_672**

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

### एनवीडिया एनआईएम (मुफ़्त डेवलपर पहुंच - 70+ मॉडल)

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+ मॉडल तक पहुंचें।

**OMNI_टोकन_677**

**OMNI_टोकन_678**

<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एम प्रभावी लागत!

**OMNI_टोकन_683**

**OMNI_टोकन_684**

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

### iFlow (OAuth के माध्यम से 5 निःशुल्क मॉडल)

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

### क्वेन (डिवाइस कोड के माध्यम से 4 मुफ़्त मॉडल)

```bash
Dashboard → Connect Qwen
→ Device code authorization
→ Unlimited usage

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

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

**OMNI_टोकन_33**

**OMNI_टोकन_689**

**OMNI_टोकन_690**

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

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

**OMNI_टोकन_34**

### उदाहरण 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!
```

**OMNI_टोकन_695**

**OMNI_टोकन_696**

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

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

```
Settings → Models → Advanced:
  OpenAI API Base URL: http://localhost:20128/v1
  OpenAI API Key: [from OmniRoute dashboard]
  Model: cc/claude-opus-4-6
```

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

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

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

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

codex "your prompt"
```

### ओपनक्लॉ

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

**OMNI_टोकन_38**

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

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

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

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

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

### ओपनकोड

**चरण 1:** एक कस्टम प्रदाता के रूप में ओमनीरूट जोड़ें:

```bash
opencode
/connect
# Select "Other" → Enter ID: "omniroute" → Enter your OmniRoute API key
```

**चरण 2:** अपने प्रोजेक्ट रूट में `opencode.json` बनाएं/संपादित करें:

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

**चरण 3:** ओपनकोड में मॉडल का चयन करें:

```bash
/models
# Select any OmniRoute model from the list
```

> **टिप:** अपने ओमनीरूट `/v1/models` एंडपॉइंट में उपलब्ध किसी भी मॉडल को `models` अनुभाग में जोड़ें। अपने ओमनीरूट डैशबोर्ड से `provider/model-id` प्रारूप का उपयोग करें।

</details>

---

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

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

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

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

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

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

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

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

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

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

**डैशबोर्ड/एपीआई पोर्ट गलत हैं**

- `PORT` कैनोनिकल बेस पोर्ट है (और डिफ़ॉल्ट रूप से एपीआई पोर्ट)
- `API_PORT` केवल OpenAI-संगत API श्रोता को ओवरराइड करता है
- `DASHBOARD_PORT` केवल डैशबोर्ड/नेक्स्ट.जेएस श्रोता को ओवरराइड करता है
- अपने डैशबोर्ड/सार्वजनिक URL पर `NEXT_PUBLIC_BASE_URL` सेट करें (OAuth कॉलबैक के लिए)

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

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

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

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

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

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

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

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

### 🔐 रिमोट सर्वर पर OAuth

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

> **⚠️ वीपीएस, डॉकर या किसी रिमोट सर्वर पर ओमनीरूट चलाने वाले उपयोगकर्ताओं के लिए महत्वपूर्ण**

#### एंटीग्रेविटी/जेमिनी सीएलआई ओएथ दूरस्थ सर्वर पर विफल क्यों होता है?

**एंटीग्रेविटी** और **जेमिनी सीएलआई** प्रदाता **Google OAuth 2.0** का उपयोग करते हैं। ऐप के Google क्लाउड कंसोल में पूर्व-पंजीकृत यूआरआई में से एक से सटीक मिलान करने के लिए Google को OAuth प्रवाह में `redirect_uri` की आवश्यकता होती है।

ओमनीरूट में बंडल किए गए OAuth क्रेडेंशियल **केवल `localhost` के लिए** पंजीकृत हैं। जब आप किसी दूरस्थ सर्वर (जैसे `https://omniroute.myserver.com`) पर ओमनीरूट तक पहुंचते हैं, तो Google प्रमाणीकरण को अस्वीकार कर देता है:

```
Error 400: redirect_uri_mismatch
```

#### समाधान: अपने स्वयं के OAuth क्रेडेंशियल कॉन्फ़िगर करें

आपको अपने सर्वर के यूआरआई के साथ Google क्लाउड कंसोल में एक **OAuth 2.0 क्लाइंट आईडी** बनाना होगा।

#### कदम दर कदम

**1. Google क्लाउड कंसोल खोलें**

यहां जाएं: [https://console.cloud.google.com/apis/credentials](https://console.cloud.google.com/apis/credentials)

**2. एक नया OAuth 2.0 क्लाइंट आईडी बनाएं**

- **"+ क्रेडेंशियल बनाएं"** → **"OAuth क्लाइंट आईडी"** पर क्लिक करें
- एप्लिकेशन प्रकार: **"वेब एप्लिकेशन"**
- नाम: कुछ भी जो आपको पसंद हो (जैसे `OmniRoute Remote`)

**3. अधिकृत रीडायरेक्ट यूआरआई जोड़ें**

**"अधिकृत रीडायरेक्ट यूआरआई"** फ़ील्ड में, जोड़ें:

```
https://your-server.com/callback
```

> `your-server.com` को अपने सर्वर के डोमेन या IP से बदलें (यदि आवश्यक हो तो पोर्ट शामिल करें, उदाहरण के लिए `http://45.33.32.156:20128/callback`)।

**4. क्रेडेंशियल सहेजें और कॉपी करें**

बनाने के बाद, Google **क्लाइंट आईडी** और **क्लाइंट सीक्रेट** दिखाएगा।

**5. पर्यावरण चर सेट करें**

आपके `.env` (या डॉकर पर्यावरण चर) में:

```bash
# For Antigravity:
ANTIGRAVITY_OAUTH_CLIENT_ID=your-client-id.apps.googleusercontent.com
ANTIGRAVITY_OAUTH_CLIENT_SECRET=GOCSPX-your-secret

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

**6. ओम्निरूट को पुनरारंभ करें**

```bash
# npm:
npm run dev

# Docker:
docker restart omniroute
```

**7. पुनः कनेक्ट करने का प्रयास करें**

डैशबोर्ड → प्रदाता → एंटीग्रेविटी (या जेमिनी सीएलआई) → OAuth

Google अब सही ढंग से `https://your-server.com/callback` पर रीडायरेक्ट करेगा।

---

#### अस्थायी समाधान (कस्टम क्रेडेंशियल के बिना)

यदि आप अभी अपना स्वयं का क्रेडेंशियल सेट नहीं करना चाहते हैं, तो आप अभी भी **मैन्युअल यूआरएल प्रवाह** का उपयोग कर सकते हैं:

1. ओमनीरूट Google प्राधिकरण URL खोलता है
2. अधिकृत करने के बाद, Google `localhost` पर रीडायरेक्ट करने का प्रयास करता है (जो रिमोट सर्वर पर विफल हो जाता है)
3. **अपने ब्राउज़र के एड्रेस बार से पूरा यूआरएल कॉपी करें** (भले ही पेज लोड न हो)
4. उस यूआरएल को ओमनीरूट कनेक्शन मोडल में दिखाए गए फ़ील्ड में पेस्ट करें
5. **"कनेक्ट"** पर क्लिक करें

> यह काम करता है क्योंकि यूआरएल में प्राधिकरण कोड इस बात पर ध्यान दिए बिना मान्य है कि रीडायरेक्ट पेज लोड किया गया है या नहीं।

---

**OMNI_टोकन_711**

<summary><b>🇧🇷 पुर्तगाली भाषा में वर्सो</b></summary>

#### क्या आप एंटीग्रेविटी/जेमिनी सीएलआई के लिए जिम्मेदार हैं?

प्रमाणित करने के लिए **एंटीग्रेविटी** और **मिथुन सीएलआई** का उपयोग करें **Google OAuth 2.0** का उपयोग करें। Google को यह देखना है कि `redirect_uri` का उपयोग बिना किसी प्रवाह के OAuth सेजा **exatamente** के माध्यम से किया गया है और आपको Google क्लाउड कंसोल के लिए आवेदन करने से पहले URIs की आवश्यकता है।

जैसा कि OAuth का प्रमाण है, कोई ओम्निरूट कैडस्ट्राड नहीं है ** `localhost`** के लिए एपेनास। एक सर्विडोर रिमोट (उदा: `https://omniroute.meuservidor.com`) पर ओम्नीरूट का उपयोग कैसे करें, या Google एक प्रमाणीकरण वापस लेता है:

```
Error 400: redirect_uri_mismatch
```

#### समाधान: OAuth को कॉन्फ़िगर करें

आपका सटीक विवरण **OAuth 2.0 क्लाइंट आईडी** आपके सर्वर पर यूआरआई के साथ Google क्लाउड कंसोल नहीं है।

#### पासो ए पासो

**1. Google क्लाउड कंसोल तक पहुंच**

अब्राहम: [https://console.cloud.google.com/apis/credentials](https://console.cloud.google.com/apis/credentials)

**2. नया OAuth 2.0 क्लाइंट आईडी देखें**

- उन्हें क्लिक करें **"+ क्रेडेंशियल बनाएं"** → **"OAuth क्लाइंट आईडी"**
- आवेदन टिप: **"वेब एप्लिकेशन"**
- नोम: एस्कोल्हा क्वेल्कर नोम (उदा: `OmniRoute Remote`)

**3. अधिकृत रीडायरेक्ट यूआरआई के रूप में एडिकियोन**

कोई शिकायत नहीं **"अधिकृत रीडायरेक्ट यूआरआई"**, आदि:

```
https://seu-servidor.com/callback
```

> स्थानापन्न `seu-servidor.com` अपने आईपी को अपने सर्वर पर रखें (इसमें एक आवश्यक पोर्ट भी शामिल है, उदाहरण के लिए: `http://45.33.32.156:20128/callback`)।

**4. साख के रूप में सहेजें और कॉपी करें**

एपोस क्रियर, Google द्वारा **क्लाइंट आईडी** और **क्लाइंट सीक्रेट**।

**5. परिवेश परिवर्तन** के रूप में कॉन्फ़िगर करें

कोई `.env` नहीं (आप डॉकर के परिवेश को कैसे बदल सकते हैं):

**OMNI_टोकन_50**

**6. ओम्निरूट का नवीनीकरण**

```bash
# Se usando npm:
npm run dev

# Se usando Docker:
docker restart omniroute
```

**7. नए सिरे से संपर्क करें**

डैशबोर्ड → प्रदाता → एंटीग्रेविटी (या जेमिनी सीएलआई) → OAuth

`https://seu-servidor.com/callback` के लिए Google पुनः निर्देशित और एक प्रमाणीकरण कार्य।

---

#### वर्कअराउंड टेम्पोरैरियो (सेम कॉन्फिगरेशन क्रेडेंशियल प्रोप्रियास)

यदि आप पहले से ही उचित क्रेडेंशियल प्राप्त नहीं करना चाहते हैं, तो आपके लिए फ्लक्सो का उपयोग करना संभव है **यूआरएल का मैनुअल**:

1. Google पर स्वचालित URL का उपयोग करके ओम्निरूट का उपयोग करें
2. ऑटो रिज़र्व के लिए एपोस, या `localhost` के लिए Google रीडायरेक्ट (यदि कोई सर्वर रिमोट नहीं है)
3. **एक यूआरएल को पूरा कॉपी करें** अपने ब्राउजर से दोबारा डाउनलोड करें (मुझे लगता है कि एक पेज अभी भी उपलब्ध है)
4. ओम्निरूट से जुड़ने के लिए कोई भी यूआरएल नहीं है
5. उन्हें क्लिक करें **"कनेक्ट"**

> यह समाधान यूआरएल को स्वचालित रूप से डाउनलोड करने के लिए काम कर रहा है और आपके द्वारा किए गए रीडायरेक्ट को स्वतंत्र रूप से वैध बनाता है।

**OMNI_टोकन_716**

---

</details>

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

**OMNI_टोकन_718**

<summary><b>तकनीकी स्टैक विवरण का विस्तार करने के लिए क्लिक करें</b></summary>

- **रनटाइम**: Node.js 18–22 LTS (⚠️ Node.js 24+ **समर्थित नहीं** है - `better-sqlite3` मूल बायनेरिज़ असंगत हैं)
- **भाषा**: टाइपस्क्रिप्ट 5.9 - **100% टाइपस्क्रिप्ट** `src/` और `open-sse/` में (v2.0 के बाद से कोर मॉड्यूल में शून्य `any`)
- **फ्रेमवर्क**: नेक्स्ट.जेएस 16 + रिएक्ट 19 + टेलविंड सीएसएस 4
- **डेटाबेस**: LowDB (JSON) + SQLite (डोमेन स्थिति + प्रॉक्सी लॉग + MCP ऑडिट + रूटिंग निर्णय)
- **स्कीमा**: ज़ॉड (एमसीपी टूल I/O सत्यापन, एपीआई अनुबंध)
- **प्रोटोकॉल**: MCP (stdio/HTTP) + A2A v0.3 (JSON-RPC 2.0 + SSE)
- **स्ट्रीमिंग**: सर्वर-भेजे गए इवेंट (एसएसई)
- **प्रामाणिक**: OAuth 2.0 (PKCE) + JWT + API कुंजियाँ + MCP स्कोप्ड प्राधिकरण
- **परीक्षण**: Node.js टेस्ट रनर + विटेस्ट (यूनिट, एकीकरण, E2E सहित 900+ परीक्षण)
- **सीआई/सीडी**: गिटहब क्रियाएँ (ऑटो एनपीएम प्रकाशन + रिलीज पर डॉकर हब)
- **वेबसाइट**: [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)
- **लचीलापन**: सर्किट ब्रेकर, एक्सपोनेंशियल बैकऑफ़, एंटी-थंडरिंग झुंड, टीएलएस स्पूफिंग, ऑटो-कॉम्बो सेल्फ-हीलिंग

**OMNI_टोकन_723**

---

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

| दस्तावेज़                                      | विवरण                                                      |
| ---------------------------------------------- | ---------------------------------------------------------- |
| [User Guide](docs/USER_GUIDE.md)               | प्रदाता, कॉम्बो, सीएलआई एकीकरण, तैनाती                     |
| [API Reference](docs/API_REFERENCE.md)         | उदाहरण सहित सभी समापन बिंदु                                |
| [MCP Server](open-sse/mcp-server/README.md)    | 16 एमसीपी उपकरण, आईडीई कॉन्फ़िगरेशन, पायथन/टीएस/गो क्लाइंट |
| [A2A Server](src/lib/a2a/README.md)            | JSON-RPC 2.0 प्रोटोकॉल, कौशल, स्ट्रीमिंग, कार्य प्रबंधन    |
| [Auto-Combo Engine](docs/auto-combo.md)        | 6-कारक स्कोरिंग, मोड पैक, स्व-उपचार                        |
| [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)           | स्क्रीनशॉट के साथ विजुअल डैशबोर्ड टूर                      |
| [Release Checklist](docs/RELEASE_CHECKLIST.md) | प्री-रिलीज़ सत्यापन चरण                                    |

---

## 🗺️ रोडमैप

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

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

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

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

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

---

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

[![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 v2.0.0 --title "v2.0.0" --generate-notes
```

---

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

## समय के साथ तारागण

## [![Stargazers over time](https://starchart.cc/diegosouzapw/OmniRoute.svg?variant=adaptive)](https://starchart.cc/diegosouzapw/OmniRoute)

## 🙏 आभार

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

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

---

## 📄 लाइसेंस

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

---

<div align="center">
  <sub>24/7 कोड करने वाले डेवलपर्स के लिए ❤️ के साथ निर्मित</sub>
  <br/>
  <sub><a href="https://omniroute.online">omniroute.online</a></sub>
__OMNI_टोकन_732__
<!-- समुदाय प्रश्नोत्तरी के लिए GitHub चर्चाएँ सक्षम -->
