# README (Oʻzbekcha) 🌐 **Languages:** 🇺🇸 [English](../../../README.md) · 🇪🇹 [am](../am/README.md) · 🇸🇦 [ar](../ar/README.md) · 🇦🇿 [az](../az/README.md) · 🇧🇬 [bg](../bg/README.md) · 🇧🇩 [bn](../bn/README.md) · 🇧🇦 [bs](../bs/README.md) · 🇨🇿 [cs](../cs/README.md) · 🇩🇰 [da](../da/README.md) · 🇩🇪 [de](../de/README.md) · 🇬🇷 [el](../el/README.md) · 🇪🇸 [es](../es/README.md) · 🇪🇪 [et](../et/README.md) · 🇮🇷 [fa](../fa/README.md) · 🇫🇮 [fi](../fi/README.md) · 🇫🇷 [fr](../fr/README.md) · 🇮🇪 [ga](../ga/README.md) · 🇮🇳 [gu](../gu/README.md) · 🇳🇬 [ha](../ha/README.md) · 🇮🇱 [he](../he/README.md) · 🇮🇳 [hi](../hi/README.md) · 🇭🇷 [hr](../hr/README.md) · 🇭🇺 [hu](../hu/README.md) · 🇦🇲 [hy](../hy/README.md) · 🇮🇩 [id](../id/README.md) · 🇳🇬 [ig](../ig/README.md) · 🇮🇹 [it](../it/README.md) · 🇯🇵 [ja](../ja/README.md) · 🇬🇪 [ka](../ka/README.md) · 🇰🇭 [km](../km/README.md) · 🇮🇳 [kn](../kn/README.md) · 🇰🇷 [ko](../ko/README.md) · 🇱🇹 [lt](../lt/README.md) · 🇱🇻 [lv](../lv/README.md) · 🇮🇳 [ml](../ml/README.md) · 🇮🇳 [mr](../mr/README.md) · 🇲🇾 [ms](../ms/README.md) · 🇲🇹 [mt](../mt/README.md) · 🇲🇲 [my](../my/README.md) · 🇳🇵 [ne](../ne/README.md) · 🇳🇱 [nl](../nl/README.md) · 🇳🇴 [no](../no/README.md) · 🇮🇳 [or](../or/README.md) · 🇮🇳 [pa](../pa/README.md) · 🇵🇭 [phi](../phi/README.md) · 🇵🇱 [pl](../pl/README.md) · 🇵🇹 [pt](../pt/README.md) · 🇧🇷 [pt-BR](../pt-BR/README.md) · 🇷🇴 [ro](../ro/README.md) · 🇷🇺 [ru](../ru/README.md) · 🇱🇰 [si](../si/README.md) · 🇸🇰 [sk](../sk/README.md) · 🇸🇮 [sl](../sl/README.md) · 🇷🇸 [sr](../sr/README.md) · 🇸🇪 [sv](../sv/README.md) · 🇰🇪 [sw](../sw/README.md) · 🇮🇳 [ta](../ta/README.md) · 🇮🇳 [te](../te/README.md) · 🇹🇭 [th](../th/README.md) · 🇹🇷 [tr](../tr/README.md) · 🇺🇦 [uk-UA](../uk-UA/README.md) · 🇵🇰 [ur](../ur/README.md) · 🇻🇳 [vi](../vi/README.md) · 🇳🇬 [yo](../yo/README.md) · 🇨🇳 [zh-CN](../zh-CN/README.md) · 🇹🇼 [zh-TW](../zh-TW/README.md) ---

# 🚀 OmniRoute — Bepul AI shlyuzi

OmniRoute — Kod yozishni hech qachon to‘xtatmang. Har bir AI vositasi → 375 ta provayder — 150+ tasi bepul — bitta endpoint orqali. Claude Code, Codex, Cursor, Cline, Copilot va Antigravity vositalarini avtomatik zaxira yo‘naltirishi bilan BEPUL Claude / GPT / Gemini’ga ulang. RTK + Caveman birgalikdagi siqish tokenlarni 15–95% (~89% o‘rtacha) tejaydi — hech qachon limitga yetmang. 375 ta AI provayderi · 150+ ta bepul tarif · oyiga ~1.62 mlrd bepul token · 20 ta yo‘naltirish strategiyasi · boshlash uchun $0.

## 💰 Uchinchi tomon bepul tariflarida oyiga ~1,62 mlrd token

> **Oʻz provayder hisoblaringizni olib keling.** Bu OmniRoute tomonidan beriladigan token granti emas, balki alohida huquqqa ega uchinchi tomon bepul tariflarining umumiy taxminiy yigʻindisidir. Roʻyxatdan oʻting, kerak boʻlsa hisob maʼlumotlarini oling va foydalana oladigan provayderlaringizni ulang; har bir provayder oʻz limitlari, mavjudligi va shartlarini oʻzi boshqaradi. > > Bepul tariflarni qoʻlda ustma-ust qoʻshish azob — oʻnlab SDK, oʻnlab rate limit va qoʻlingizda aslida qancha borligi haqida hech qanday tasavvur yoʻq. OmniRoute **467 ta bepul tarif yozuvini 34 ta takrorlanuvchi pool kaliti boʻyicha** kataloglaydi va tokenlar sarlavhasini **oylik ijobiy byudjeti eʼlon qilingan 17 ta pool hamda Groq’ning beshta per-model limiti** asosida hisoblab chiqadi, umumiy pool boʻyicha dublikatlar olib tashlanadi. Faqat mintaqaviy shaxsni tasdiqlashdan keyin ochiladigan kvotalar (hozircha: ModelScope) alohida koʻrsatiladi — mintaqaviy shaxsni tasdiqlash ortida +~6M — va hech qachon asosiy raqamga qoʻshilmaydi. Natija boshqaruv panelida koʻrinib turadi (`/dashboard/free-tiers`).

OmniRoute bepul tarif byudjeti kartasi: bitta endpoint ortida kataloglangan 467 ta bepul tarif yozuvini qamrab oluvchi 34 ta hujjatlashtirilgan takrorlanuvchi pool kalitidan oyiga barqaror ~1,62 mlrd bepul token, roʻyxatdan oʻtish kreditlari bilan birinchi oyda ~2,22 mlrd gacha. Halol, pool boʻyicha dublikatlar olib tashlangan matematika — har bir umumiy pool bir marta hisoblanadi, jumladan oylik ijobiy token byudjeti eʼlon qilingan 17 ta takrorlanuvchi pool hamda Groq’ning beshta per-model limiti; 12 ta provayder shartlar-xavf katalogida “avoid” deb belgilangan, qaror sizniki. Byudjet chizigʻi Mistral 1B, Nara 210M, LLM7 150M, xKiro 150M, Groq 30M (beshta per-model limit) va kichikroq poollarni, shuningdek birinchi oy roʻyxatdan oʻtish kreditlarini va doimiy bepul, token limiti yoʻq provayderlarni alohida koʻrsatadi, shuning uchun ular asosiy raqamni hech qachon shishirmaydi. /dashboard/free-tiers da jonli ishlatilgan/qolgan koʻrsatiladi.

> Jonli `/dashboard/free-tiers` sahifasining animatsiyalangan xulosasi. Toʻliq metodologiya (pool dublikatlarini olib tashlash, kredit darajalari, provayder shartlari): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**. > > _{Bu raqamlar har ikki haftada jonli katalogga qarshi qayta auditedan oʻtkaziladi va **ikki tomonga ham oʻzgaradi** — provayder bepul tarifni tugatsa, raqam tushadi; yangisi qoʻshilsa, u koʻtariladi. Biz katalog aslida hisoblagan narsani eʼlon qilamiz, hech qachon yaxlitlab oshirilgan eng yaxshi holatni emas.}

⭐ Agar OMNIROUTE pul tejashga va ishingizni osonlashtirishga yordam bergan boʻlsa, repoga star bering.

[![Stars](https://img.shields.io/github/stars/diegosouzapw/OmniRoute?style=social)](https://github.com/diegosouzapw/OmniRoute)

[![Star History Rank](https://api.star-history.com/badge?repo=diegosouzapw/OmniRoute&theme=dark)](https://www.star-history.com/diegosouzapw/omniroute) [![olud.ai](https://olud.ai/badge.php?tool=diegosouzapw-omniroute)](https://olud.ai/project/diegosouzapw-omniroute.html) ### 💬 Jamoaga qoʻshiling **👋 Maintainerni kuzatib boring — yangi provayderlar, relizlar va maslahatlarni birinchilardan bilib oling:** [![Follow Diego on LinkedIn](https://img.shields.io/badge/Follow_Diego_on-LinkedIn-0A66C2?style=for-the-badge&logo=linkedin&logoColor=white)](https://www.linkedin.com/in/diegosouzapw/) [![Follow @diegosouzapw on GitHub](https://img.shields.io/github/followers/diegosouzapw?style=for-the-badge&logo=github&logoColor=white&label=Follow%20on%20GitHub&color=181717)](https://github.com/diegosouzapw) [![Discord](https://img.shields.io/badge/Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/U47eFqAXCn) [![Telegram](https://img.shields.io/badge/Telegram-26A5E4?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/omnirouteOficial) [![WhatsApp Global](https://img.shields.io/badge/WhatsApp_Global-25D366?style=for-the-badge&logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) [![WhatsApp Brasil](https://img.shields.io/badge/WhatsApp_Brasil-25D366?style=for-the-badge&logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) [![Website](https://img.shields.io/badge/Website-omniroute.online-blue?logo=google-chrome&logoColor=white)](https://omniroute.online) **Savollar, provayder maslahatlari, roadmap va yordam → [Discord](https://discord.gg/U47eFqAXCn) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 Global](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) / [🇧🇷 Brasil](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) / [Portal](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK)**
## 📈 Gateway oʻsishda davom etmoqda

| | v3.8.50 | **v3.8.51** | `v3.8.53+` | | ----------------------------------------- | :------------------------: | :---------: | :--------------------: | | 🌐 Provayderlar | 352 | **358** | 375 | | 🧠 Noyob chat model IDlari | 1320 | **1374** | 1475 | | 🖼️ Modallik koʻprigi | 🆕 koʻrish + audio + video | ✓ | ✓ | | 📡 Radar bepul katalogi | 🆕 ixtiyoriy | ✓ | ✓ | | ⚖️ Kvotani hisobga oluvchi rejalashtirish | 🆕 Kvota-ulashish | ✓ | ✓ | | 📊 Kvota telemetriyasi | 🆕 jonli | ✓ | ✓ | | 🧰 Boshsiz rejim | — | — | 🆕 `serve --headless` | | 🛤️ LTS rels infratuzilmasi | — | — | 🆕 chiqarish kanallari | | 🔎 Modelni aniqlash API | — | — | 🆕 `/v1/models/query` | **→ [Yoʻl xaritasi](ROADMAP.md) — `v3.9.0 LTS` sari rels boʻylab**

## 🧩 Mavjud [![npm versiyasi](https://img.shields.io/npm/v/omniroute?color=cb3837&logo=npm)](https://www.npmjs.com/package/omniroute) ![NPM oylik yuklab olishlari](https://img.shields.io/npm/dm/omniroute?label=npm/month&color=cb3837&logo=npm) [![Docker Hub](https://img.shields.io/docker/v/diegosouzapw/omniroute?label=Docker%20Hub&logo=docker&color=2496ED)](https://hub.docker.com/r/diegosouzapw/omniroute) [![Litsenziya: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](LICENSE) ![Docker yuklab olishlari](https://img.shields.io/docker/pulls/diegosouzapw/omniroute?label=docker%20pulls&logo=docker&color=2496ED) ![Electron yuklab olishlari](https://img.shields.io/github/downloads/diegosouzapw/omniroute/total?style=flat&label=electron%20downloads&logo=electron&color=47848F)

🚀 Boshlash	🚀 Tezkor boshlash	📦 Oʻrnatish	🆓 Provayderni ulash
💡 Oʻrganish	💥 Vaʼda	🤔 Nega OmniRoute	🏆 Nima bilan ajralib turadi
⚙️ Imkoniyatlar	🎯 Kombinatsiyalar	🌐 Provayderlar	🔌 CLI & MCP
	🗜️ Siqish	🖥️ Qayerda ishlaydi	🔒 Maxfiy
👀 Koʻrish	🎬 Amalda	✨ Yangiliklar	🤖 Mos CLI vositalari
💚 Qoʻllab-quvvatlash	💚 Qoʻllab-quvvatlash / Xayriya	💬 Hamjamiyat	💖 Homiylar
📦 Loyiha	🛠️ Texnologiyalar toʻplami	📖 Hujjatlar	👥 Hissa qoʻshuvchilar

🌐 67 tilda

## 🆓 Oʻrnating, provayderni ulang, soʻng bitta endpoint orqali yoʻnaltiring

Uch qadam: OmniRoute’ni oʻrnating va ishga tushiring, oʻz hisobingiz yoki API kalitingiz bilan mos provayderni ulang, soʻng OmniRoute API kaliti va auto modeli yordamida vositangizni localhost:20128/v1 manziliga yoʻnaltiring. Yoʻnaltirish mavjud mos ulanishlar va provayder cheklovlariga bogʻliq.

```bash # Provayderni ulaganingizdan soʻng OmniRoute kalitingizni Dashboard → Endpoints bo‘limidan nusxalang: curl http://localhost:20128/v1/chat/completions \ -H "Authorization: Bearer YOUR_OMNIROUTE_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}' ``` _{`auto` mos yoʻnalishni talab qiladi. Yangi oʻrnatishda kalitsiz mos nishonlar boʻlmasligi mumkin, kalitsiz provayder esa uchinchi tomon mijozlarini rad etishi mumkin. `tos: avoid` bilan belgilangan provayderlar, jumladan Kiro, standart holatda avtomatik yoʻnaltirishdan chiqarib tashlanadi; hisobni ulash bu sozlamani bekor qilmaydi. Provayder tanlashdan oldin [Bepul tariflar qoʻllanmasi](docs/getting-started/FREE-TIERS-GUIDE.md) bilan tanishing.} _{📦 **Python, Node.js, PHP va cURL** uchun nusxalab qoʻyish mumkin boʻlgan tezkor boshlash skriptlari → [`examples/quickstart/`](examples/quickstart/)}

# 💥 Va’da

# 🤔 Nega OmniRoute?

OmniRoute soʻrov oqimi: IDE yoki CLI’ingiz (Claude Code, Cursor, Cline…) yagona mahalliy endpoint’ga (http://localhost:20128/v1) murojaat qiladi; OmniRoute Smart Router (RTK + Caveman siqishi, 20 ta yoʻnaltirish strategiyasi, avtomatik oʻchirgichlar, TLS yashirinligi, MCP, A2A, himoya mexanizmlari) mos va sogʻlom nishon mavjud ekan, provayderlarning 4 ta darajasi boʻylab zaxira yoʻnalishga oʻta oladi — 1-daraja: Obuna, 2-daraja: API kaliti, 3-daraja: Arzon va 4-daraja: Bepul.

## 🤝 Ochiq manbali doʻstlarimiz tomonidan qoʻllab-quvvatlanadi

> **Ochiq manbali doʻst sifatida qoʻshilishni xohlaysizmi?** Bular ochiq manbani qoʻllab-quvvatlaydigan va OmniRoute-ni harakatda ushlab turishga yordam beradigan kompaniyalar — va biz ularning bizga bergan har bir tokeni qayerga ketishini ochiq aytamiz. Bogʻlaning: [diegosouza.pw@outlook.com](mailto:diegosouza.pw@outlook.com)

Kimi
_{Moonshot AI} Ushbu loyihani qoʻllab-quvvatlagani uchun bizning taʼsischi Ochiq manbali doʻstimiz Kimi (Moonshot AI)ga rahmat! Kimi ochiq ogʻirlikdagi K2 va K3 model oilalari ortidagi AI laboratoriyasidir — Kimi K3 1M-token kontekst oynasini, mahalliy koʻrish va chegara darajasidagi kodlashni yopiq modellar narxining bir qismida taqdim etadi va Claude Code, Codex va OmniRoute xizmat koʻrsatadigan har bir kodlash vositasi bilan qutidan tashqarida ishlaydi.

Kimi qoʻllab-quvvatlashi nimani quvvatlaydi: Kimi API kreditlari OmniRoute-ning AI tomonidan tasdiqlangan chiqarish quvurini quvvatlaydi — har bir tortish soʻrovini joʻnatishdan oldin koʻrib chiqadigan Kimi K3 tomonidan quvvatlanadigan birlashishni tasdiqlash bosqichi — shuningdek, kundalik xususiyatlarni ishlab chiqish. Birinchi darajali Kimi qoʻllab-quvvatlashi ikkala yoʻnalishda ham mavjud: toʻgʻridan-toʻgʻri Kimi API (kimi-k3) va Kimi Code kodlash rejasi (OAuth va API kaliti). OmniRoute, shuningdek, Kimi qoʻllab-quvvatlash dasturidagi birinchi Braziliya ochiq manbali loyihasidir. 15% qoʻshimcha kreditlar bilan Kimi API kalitini oling →

Arzonroq xulosa
_{cheaperinference.com} Ushbu loyihani qoʻllab-quvvatlagani uchun OmniRoute Ochiq manbali doʻsti Cheaper Inferencega rahmat! Cheaper Inference — bu 42 ta chegara modelini — Claude, GPT-5.x, Gemini, Kimi K3, GLM, DeepSeek, Grok va MiniMax — bitta OpenAI-mos keluvchi nuqta orqasida qayta sotadigan, har bir soʻrovni eng arzon mos keluvchi provayderga yoʻnaltiradigan, model ishlab chiqaruvchining roʻyxat narxidan yuqori narxda hech qachon haq olmaydigan narx boʻyicha tartiblangan shlyuzdir.

OmniRoute-da birinchi darajali qoʻllab-quvvatlash: Chat Completions, mahalliy /v1/responses nuqtasi, koʻrish, asbob chaqiruvi va 3 ta tasvir modeli (grok-imagine, nano-banana-pro, nano-banana-2, cheaperinference/<model> sifatida erishish mumkin). API kalitini oling →

_{aff=omniroute bilan belgilangan havolalar hamkorlik havolalaridir. Ular sizga qoʻshimcha xarajatlarsiz loyihani moliyalashtiradi.}

_{🎟️ Hamkorlar aksiyasi — biz homiylik qilmaydigan provayderlardan bepul roʻyxatdan oʻtish kuponlari (ochish uchun bosing)}

_{Ushbu boʻlim faqat yoʻnaltirish/kupon kodlari uchun. Homiylik qilingan hamkorliklar yuqoridagi 🤝 Ochiq manbali doʻstlarimiz tomonidan qoʻllab-quvvatlanadi boʻlimida joylashgan. OmniRoute bu yerda koʻrsatilgan provayderlar bilan homiylik yoki hamkorlik qilmaydi — bular har kim foydalana oladigan ochiq kuponlardir.}

_AgentRouter
_{agentrouter.org} _{AgentRouter — hamkorlik roʻyxatdan oʻtish · roʻyxatdan oʻtishda $100 bepul kreditlar (bepul server, yuqori kechikishni kuting — sinov uchun eng yaxshi, ishlab chiqarish uchun emas). OmniRoute-da v3.8.50 dan beri birinchi darajali qoʻllab-quvvatlash: Chat Completions, Anthropic-mos keluvchi sim format va OpenAI-mos keluvchi yoʻl. Mavjud modellar orasida claude-opus-4-8, claude-opus-5, gpt-5.6-sol va boshqalar mavjud. Sizning $100 ni oling →}

_{⚠️ Hamkorlik havolasi — OmniRoute ushbu provayder bilan homiylik yoki hamkorlik qilmaydi.}

_{OmniRoute foydalanuvchilariga foyda keltiradigan saxiy bepul roʻyxatdan oʻtish kuponiga ega boshqa provayderni bilasizmi? Muammoni oching va biz uni shu yerga qoʻshamiz.}

## 🎯 Combos — Yetakchi imkoniyat

20 ta combo marshrutlash strategiyasidan 18 tasi uchun animatsiyali misollar — har bir strategiya uchun bittadan katak: priority, fill-first, weighted, round-robin, p2c, least-used, random, strict-random, cost-optimized, headroom, reset-window, reset-aware, context-relay, context-optimized, lkgp, auto, fusion, pipeline. cache-optimized va quota-weighted animatsiya qilinmagan; quyidagi jadvalda barcha 20 tasi tavsiflangan.

> **Combo** — bu OmniRoute **avtomatik ravishda** marshrutlaydigan modellar zanjiri. Kvota tugasa, provayder ishlamay qolsa yoki xarajatlar keskin oshsa, combo keyingi mos va sogʻlom modelga oʻtishi mumkin. 🛡️ ### ⚡ Sozlamasiz — shunchaki `auto`dan foydalaning Combo yaratish shart emas. Modelingizni `auto`ga (yoki uning variantlaridan biriga) oʻrnating, shunda OmniRoute ulangan provayderlaringizdan real vaqt rejimida baholanadigan virtual combo yaratadi:

Model ID	Nimani optimallashtiradi
`auto`	🎯 Muvozanatli standart tanlov (LKGP — oxirgi yaxshi provayderingizga bogʻlanib qoladi)
`auto/coding`	🧑💻 Kod yaratish uchun sifatni ustuvor qiluvchi vaznlar
`auto/fast`	⚡ Avval eng past kechikish
`auto/cheap`	💰 Avval har bir token uchun eng arzon variant
`auto/subscription`	🎟️ Faqat siz allaqachon haq toʻlayotgan obuna kvotasi — yopiq tarzda xatolik beradi, hech qachon pulli zaxira variantiga oʻtmaydi (qoʻllanma)
`auto/thrifty`	🪜 Avval tarif rejasi kvotasi, keyin eng arzon pulli variantlarga bittadan pogʻona orqali oʻtadi — tarif rejasi tiklangach, unga qaytadi (qoʻllanma)
`auto/offline`	🔋 Avval kvotasi / tezlik cheklovi zaxirasi eng katta variant
`auto/smart`	🔭 Avval sifat + yaxshiroq modellarni topish uchun 10% tajriba
`auto/lkgp`	📌 Oxirgi maʼlum yaxshi provayderga aniq bogʻlanish
`auto/chaos`	🧪 Modellar paneliga parallel tarqatish (har bir provayderdan bittadan, standart holatda 5 ta), bitta javobni qaytaradi; bu xatolik kiritish emas, balki har bir panel modeli uchun yuqori oqimga bittadan chaqiruvdir

## ### 🔀 Yoki oʻzingiznikini yarating — 20 ta marshrutlash strategiyasi Barcha **20** ta strategiya — har bir combo bosqichida aralashtirib qoʻllang:

#	Strategiya	Nima qiladi
1	`priority`	Birinchi nishon ustuvorligidagi tartiblangan roʻyxat — keyingisiga oʻtishdan oldin har birini sarflab tugatadi 🥇
2	`fill-first`	Keyingisiga oʻtishdan oldin har bir nishon kvotasidan toʻliq foydalanadi
3	`weighted`	Har bir nishon vazniga asoslangan vaznli tasodifiy tanlov
4	`round-robin`	Nishonlar boʻylab tartib bilan aylanadi
5	`p2c`	Ikki variantdan birini tanlashga asoslangan tasodifiy yuk muvozanatlash
6	`least-used`	Joriy yuki eng kam boʻlgan nishonni tanlaydi
7	`random`	Bir tekis tasodifiy tanlov (takrorlar olib tashlanadi)
8	`strict-random`	Takrorlarni olib tashlamasdan tasodifiy tanlaydi 🎲
9	`cost-optimized`	Jonli katalog narxlari asosida har bir soʻrov uchun $ xarajatini minimallashtiradi 💸
10	`headroom`	Eng koʻp qolgan kvotaga ega nishonni tanlaydi
11	`quota-weighted`	Kvotasi tugagan hisoblarni oʻtkazib yuboradi, soʻng qolgan kvota ÷ bajarilayotgan yuk nisbatiga mutanosib ravishda tanlaydi — mavjud suhbatlar bogʻlangan holda qoladi ⚖️
12	`reset-window`	Kvota oynasi eng tez tiklanadigan nishonni afzal koʻradi
13	`reset-aware`	Kvota tiklanish vaqtiga qarab saralaydi — avval qisqa oynalar 📊
14	`context-relay`	Uzoq suhbatlarda kontekstni nishonlar oʻrtasida uzatadi 🧠
15	`context-optimized`	Joriy kontekst hajmiga eng mos variantni tanlaydi
16	`cache-optimized`	Har bir qayta foydalaniladigan soʻrov prefiksini bir xil hisobga bogʻlaydi — soʻrov keshi mos tushishlarini maksimal darajaga oshiradi 🎯
17	`lkgp`	Oxirgi maʼlum yaxshi yoʻl — oxirgi muvaffaqiyatli provayderga bogʻlaydi, soʻng zaxira qoidalarga oʻtadi
18	`auto`	Har bir ulanish boʻyicha 16 omilli jonli baholash 🤖
19	`fusion`	Modellar paneliga tarqatadi + hakam bitta javobni sintez qiladi 🧬
20	`pipeline`	Bosqichlarni zanjirlaydi — har bir nishonning chiqishi keyingisiga uzatiladi 🔗

_{Auto-Combo mexanizmi har bir nomzodni **16 ta omil** (holat, kvota, xarajat, kechikish, vazifaga moslik, sifat, sessiya mavjudligi…) bo‘yicha baholaydi — [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md) hujjatiga qarang.} ## ### 🧱 Barqarorlik ichki tarzda ta’minlangan (3 ta mustaqil qatlam)

OmniRoute barqarorligi — 3 ta mustaqil o‘zini tiklash qatlami, har bir nosozlik uchun mos qatlam. 1-qatlam — provayderning avtomatik uzgichi (butun provayder): faqat 408/5xx holatlarida ishga tushadi, chegaralar OAuth uchun 8× / API-key uchun 12× / mahalliy ulanish uchun 2×; 60s/30s/15s dan keyin HALF-OPEN sinoviga o‘tadi, kechiktirilgan tiklanish; OPEN holatida kombinatsiya so‘rovni keyingi provayderga yo‘naltiradi. 2-qatlam — ulanishning sovish davri (bitta kalit/hisob): asosiy muddat OAuth uchun 5s / API-key uchun 3s, so‘rovlarning birdan yopirilishidan himoyalovchi eksponensial ×2 kechiktirish, 429 holatida Retry-After hisobga olinadi, muvaffaqiyat barcha xato holatlarini tozalaydi; sovish davridagi bitta kalit o‘tkazib yuboriladi, boshqa kalitlar esa xizmat ko‘rsatishda davom etadi. 3-qatlam — modelni bloklash (bitta model): har bir modelga oid 429, mahalliy 404 yoki rejimni rad etish holatlari faqat shu modelni bloklaydi — hech qachon butun ulanishni emas. Yakuniy holatlar (taqiqlangan, muddati tugagan, kreditlari sarflangan) sovish davrlari emas, balki operator aralashuvini talab qiladigan holatlardir.

_{📖 [Auto-Combo mexanizmi](docs/routing/AUTO-COMBO.md) · [Barqarorlik bo‘yicha qo‘llanma](docs/architecture/RESILIENCE_GUIDE.md)}

## 🏆 OmniRoute’ning o‘ziga xos jihatlari

_{📊 To‘liq metodologiya va har bir funksiya bo‘yicha 9router, OpenRouter, CLIProxyAPI hamda LiteLLM bilan batafsil taqqoslash → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)}
## 💚 OmniRoute’ni qo‘llab-quvvatlang OmniRoute MIT litsenziyasiga ega va ochiq tarzda yuritiladi. Agar u vaqtingiz yoki pulingizni tejasa, uning mustaqilligini saqlab qolishga quyidagicha yordam berishingiz mumkin — o‘zingizga mos usulni tanlang. Homiylik hech qachon marshrutlash ustuvorligiga ta’sir qilmaydi; u reytingni emas, ko‘rinuvchanlikni oshiradi.

⭐ Repoga yulduz qo‘ying	Bepul — ko‘rinuvchanlikka chindan ham yordam beradi	OmniRoute’ga yulduz qo‘ying
🐙 GitHub Sponsors	Bir martalik yoki oylik · platforma to‘lovi yo‘q	github.com/sponsors/diegosouzapw
☕ Ko-fi	Tezkor bir martalik xayriya, homiy ro‘yxatdan o‘tishi shart emas	ko-fi.com/diegosouzapw
🧋 Buy Me a Coffee	Kichik, norasmiy minnatdorchilik	buymeacoffee.com/diegosouzapw
🖐 Liberapay	Takroriy · notijorat · ochiq kodli	liberapay.com/diegosouzapw
🇧🇷 PIX (Braziliya)	Darhol, komissiyasiz	kalit va QR quyida
₿ Kriptovalyuta	BTC · ETH · USDT-TRC20 · USDC-Solana	manzillar quyida

**🇧🇷 PIX** — darhol, komissiyasiz (Braziliya) OmniRoute PIX QR kodi

Kalit (tasodifiy): `5d865059-bc44-483a-962d-43ceb80126eb` Pix’dan nusxalash va joylash: ``` 00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD ```

₿ Kriptovalyuta — BTC · ETH · USDT-TRC20 · USDC-Solana (kengaytirish uchun bosing)

₿ BTC	Bitcoin (SegWit)	`bc1qh00smz004sy85wyl28v77tenkt3ckl6eaep7fd`
Ξ ETH	Ethereum (ERC20)	`0x64Cf6B68A6Ff34288e89172950a2d00102337a84`
₮ USDT	Tron (TRC20)	`TKAF41JpuQrHbKTnsQa9svJE2T192Hvsc2`
$ USDC	Solana	`2emNNZzVVWQc3FQ2wk9M6qXUQmW8AKdjjL174fXR28Tu`

_{⚠️ Har bir tangani faqat ko‘rsatilgan tarmoq orqali yuboring — noto‘g‘ri tarmoqdan yuborish mablag‘larning yo‘qolishiga olib kelishi mumkin.}

🐛 Xato topdingizmi yoki fikr-mulohazangiz bormi? [Muhokama](https://github.com/diegosouzapw/OmniRoute/discussions) oching.

Dasturchilar uchun eslatmalar: Dasturchilarga qulaylik yaratish maqsadida loyiha npm install/postinstall jarayonida mahalliy .env faylini yaratishi mumkin. Bu fayl .gitignore orqali ataylab e’tiborsiz qoldiriladi (.gitignore fayliga qarang) va hech qachon commit qilinmasligi kerak — agar u tasodifan commit qilinsa, oshkor bo‘lgan barcha maxfiy ma’lumotlarni almashtiring va faylni tarixdan olib tashlang. Mahalliy muhit fayllari va maxfiy ma’lumotlarni boshqarish bo‘yicha ko‘rsatmalar uchun docs/DEVELOPER-ENVIRONMENT.md fayliga qarang.

## 📡 OmniRoute Radar Asosiy bepul tarif ko‘rsatkichi yuqoridagi hujjatlashtirilgan, umumiy havzalar bo‘yicha takrorlari olib tashlangan katalog asosida **oyiga ~1.62B token** bo‘lib qoladi. Provayderlarning vaqtinchalik ro‘yxatdan o‘tish kreditlari birinchi oy uchun bu miqdorni alohida ravishda **~2.22B** gacha oshirishi mumkin. Radar — OmniRoute relizlari oralig‘ida bepul modellarning mavjudligi haqida yangiroq ma’lumot olishni istaganlar uchun ixtiyoriy, imzolangan katalog ustqurmasidir; hamjamiyat katalogi va mavjud barcha bepul funksiyalar bepul bo‘lib qoladi. Qo‘llab-quvvatlovchilar jonli katalog va provayderlarning qo‘shimcha imkoniyatlaridan foydalanishlari mumkin. Uning alohida, o‘zgaruvchan yuqori chegarasi provayderlar mavjudligiga qarab **ko‘pi bilan oyiga taxminan 3B token**ni tashkil etadi. Bu yuqori chegara kafolat emas: provayderlar istalgan vaqtda kvotalar, muvofiqlik talablari, modellar yoki hududlarni o‘zgartirishi mumkin. Radar ixtiyoriy ravishda yoqiladi va faqat GET so‘rovlaridan foydalanadi. OmniRoute mijozi promptlar, trafik, provayder konfiguratsiyasi, foydalanish telemetriyasi yoki e’lonlarni mahalliy rad etish holatini yuklamaydi. Muvofiqlik talablari va joriy katalog haqida **[radar.omniroute.online/planos](https://radar.omniroute.online/planos)** manzilida bilib oling.

## ✨ Yangi nimalar

> **v3.8.20 → v3.8.53** versiyalaridagi soʻnggi muhim yangiliklar. Toʻliq tarix [`CHANGELOG.md`](CHANGELOG.md) faylida. - **⚖️ `quota-weighted` marshrutlash** — 20-kombo strategiyasi tugagan hisoblarni oʻtkazib yuboradi, soʻng qolganlari orasidan qolgan kvota ÷ jarayondagi yuklamaga mutanosib ravishda tanlaydi va mavjud suhbatlarni bogʻlangan holda saqlaydi. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🧰 Headless rejimi** — `omniroute serve --headless` (yoki `OMNIROUTE_HEADLESS=1`) faqat `/v1/*` proksi dvigatelini ishga tushiradi, boshqaruv paneli va faqat panelga tegishli quyi tizimlar oʻchirilgan holda. → [Headless Mode](docs/guides/HEADLESS.md) - **🔎 Modellarni aniqlash** — `/v1/models` imkoniyat, kontekst, tur va matn boʻyicha filtrlaydi, `POST /v1/models/query` esa har bir kalit uchun bir xil koʻrinishga ega qisqa deterministik roʻyxatni qaytaradi. → [API Reference](docs/reference/API_REFERENCE.md) - **🔑 Har bir kalit uchun marshrutlash nazorati** — API kalitini `forcedModel` orqali bitta model yoki komboga bogʻlang, hamda kalitning modellari va kombolari atomar tarzda qoʻshing yoki olib tashlang (`/api/keys/{id}/access`). → [API Reference](docs/reference/API_REFERENCE.md) · [OpenAPI](docs/openapi.yaml) - **🛡️ Yanada nozik PII nazorati** — turlar boʻyicha tanlash, 20 tagacha tekshirilgan maxsus maskalash shablonlari va har bir tur uchun aniqlash hisoblagichlari; maskalashning oʻzi ixtiyoriy boʻlib qoladi. → [Guardrails](docs/security/GUARDRAILS.md) - **🌍 67 til** — boshqaruv paneli, hujjat nusxalari va CLI, `npm run i18n:add-locale` esa bitta buyruq bilan tilni hamma joyga qoʻshadi. → [i18n Guide](docs/guides/I18N.md) - **🎛️ OmniConductor** — agentlar toʻplamingizga kiruvchi A2A delegatsiyasi, Agent Card'dagi Conductor koʻnikmalari va Faro push-to-talk ovozli suhbatiga ega boshqaruv paneli. → [A2A Server](docs/frameworks/A2A-SERVER.md) - **🛂 Moslashuvchan qabul va ortiqcha yuklanishdan himoya** — ogʻir chat soʻrovlari 503 qaytarish oʻrniga navbatga qoʻyiladi, har bir ulanish uchun atomar RPM aylanma lizinglari bilan. → [Resilience Guide](docs/architecture/RESILIENCE_GUIDE.md) - **🗂️ Kanonik `/v1/models` tartiblash** — har bir provayder uchun bitta uzluksiz, provayder boʻyicha guruhlangan blok (kombolari birinchi oʻrinda), har bir katalog manbasida barqaror. → [API Reference](docs/reference/API_REFERENCE.md) - **🗜️ Siqishni mustahkamlash** — standart yoqilgan shishib ketishdan himoya, DE / FR / JA + xitoy tili (wényán) uchun Caveman toʻplamlari, Gradle & .NET uchun RTK filtrlari. → [Compression](docs/compression/COMPRESSION_ENGINES.md) - **💸 Halol tekis tarif narxi** — obuna / kodlash-rejasi provayderlari xarajat tahlilida **$0** koʻrsatadi; byudjet, kvota va marshrutlash esa hisoblashda davom etadi. → [API Reference](docs/reference/API_REFERENCE.md) - **⚖️ Quota-Share marshrutlash** — umumiy hisobning kvotasini jamlangan kalitlar oʻrtasida adolatli taqsimlang, boʻsh boʻlaklar qarzga beriladigan ishni tejovchi rejimda. → [Resilience Guide](docs/architecture/RESILIENCE_GUIDE.md) - **🤖 Bir buyruqli CLI/agent sozlash** — 15 ta roʻyxatga olingan `setup-*` buyruqlari; `omniroute run` 7 ta CLI'ni ishga tushiradi (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); `omniroute configure` 11 ta nishonni qoʻllab-quvvatlaydi, interaktiv provayder+model tanlagichi va har bir kontekst uchun sevimlilar bilan. → [CLI Integrations](docs/guides/CLI-INTEGRATIONS.md) - **🛰️ Masofaviy rejim** — masofaviy OmniRoute'ni qamrovli tokenlar (`connect` / `contexts` / `tokens`) bilan boshqaring + VPS oʻrnatishlari uchun `antigravity` OAuth yordamchisi. → [Remote Mode](docs/guides/REMOTE-MODE.md) - **🧭 Aqlliroq avtomatik marshrutlash** — `auto/:` kombolari, **Fusion** (model paneli + hakam), vazifani hisobga oluvchi marshrutlash, har bir soʻrov uchun model / rejim / USD-byudjet bekor qilishlari. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🗜️ Ulanishi mumkin siqish** — 12 ta kompozitsiyalanuvchi dvigatel + Compression Studios: LLMLingua-2, ikki bosqichli Ultra, omniglyph, har bir qadam uchun sodiqlik darvozasi, GCF v3.2, sudrab tartiblash muharriri. → [Compression](docs/compression/COMPRESSION_ENGINES.md) - **🕵️ Shaffof MITM shifrini ochish (TPROXY)** — proksi muhit oʻzgaruvchilarini e'tiborsiz qoldiradigan CLI'larni ushlang, har bir SNI uchun CA + ishonch omborini oʻrnatuvchi bilan. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md) - **💸 Har joyda xarajat telemetriyasi** — har bir endpointda `X-OmniRoute-*` xarajat/foydalanish sarlavhalari, cache-HIT tejash sarlavhasi, har bir kalit uchun USD sarf kvotalari. → [API Reference](docs/reference/API_REFERENCE.md) - **🧠 Oʻzingiz boshqaradigan xotira** — standart oʻchirilgan, ixtiyoriy int8 vektor kvantlash + tiplashtirilgan soʻnish, har bir soʻrov uchun `x-omniroute-no-memory`. → [Memory](docs/frameworks/MEMORY.md) - **🛡️ Xavfsizlik** — har bir LLM marshrutida prompt-in'ektsiya himoyasi (red-team toʻplami), ixtiyoriy maxfiy ma'lumotlarni maskalash himoyasi (ikki yoʻnalishda ham oqib ketgan API kalitlari/sirlarini yashiradi), bepul DuckDuckGo oxirgi chora veb-qidiruvi va boshqaruv paneli uchun ixtiyoriy OIDC kirish darvozasi (parol bilan kirish doim mavjud boʻlib qoladi). → [Guardrails](docs/security/GUARDRAILS.md) - **🖼️ Yangi endpointlar** — `/v1/ocr` (Mistral OCR) va `/v1/audio/translations` (Whisper uslubidagi) media yuzasini toʻldiradi. → [API Reference](docs/reference/API_REFERENCE.md) - **🎨 Rasm / video / audio generatsiyasi** — media uchun bitta API: xAI Grok Imagine & Novita AI video, ComfyUI, Magnific, Adobe Firefly, Segmind va ElevenLabs kabi nutq provayderlari. → [API Reference](docs/reference/API_REFERENCE.md) - **🌍 Joylashtirish va operatsiyalar** — teskari proksi `basePath`, brauzer tilini avtomatik aniqlash, har bir kalit uchun qurilma kuzatuvi, rootsiz MITM ishonchi, zh-TW lokalizatsiyasi. → [Environment](docs/reference/ENVIRONMENT.md) - **🤝 Koʻproq provayderlar va agentlar** — bulutli agentlar (Codex Cloud, Cursor, Devin, Jules), brauzer + OAuth kirishiga ega Grok Build (xAI), Ollama birinchi darajali kartasi, Claude Opus 5 & Sonnet 5, Kimi rasmiy hamkorligi (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… va yangilangan **375 provayderlik katalog**. → [Providers](docs/reference/PROVIDER_REFERENCE.md) - **📡 Marshrutlash shaffofligi** — har bir javob uni taqdim etgan strategiya/provayder/kechikishni nomlovchi `X-OmniRoute-Decision` sarlavhasini olib yuradi, yangi `cache-optimized` kombo strategiyasi + Auto-Combo `cacheAffinity` omili takroriy soʻrovlarni keshlangan prefiksni saqlovchi ulanishga qaytaradi, faqat oʻqish uchun `/v1/auto-combo/{channel}/candidates` endpointi esa `auto/*` kanalining jonli nomzodlar toʻplamini ochib beradi. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **⚡ Lokal unumdorlik va infratuzilma** — bir klikda lokal Redis, Cloudflare Workers / Deno Deploy relay joylashtiruvchilari, Bifrost va Mux nazorat qilinadigan ichki xizmatlar sifatida. → [Ichki xizmatlar](docs/frameworks/EMBEDDED-SERVICES.md) - **🧩 To'plamda yana bor** — plagin freymvorki + marketpleys, Omni/Agent/GitHub ko'nikmalar freymvorklari, Obsidian vault integratsiyasi (22 ta MCP vositasi), OpenAI-mos Batch va Files API'lari, semantik javob keshi, reyting jadvallari bilan geymifikatsiya, ACP agentlarini aniqlash (15 ta o'rnatilgan agent), BigQuery'ga rejalashtirilgan log eksporti, `auto/chaos` parallel ko'p modelli fan-out, Telegram bot ko'prigi, ilova ichidagi versiya menejeri va LMArena-ELO bepul provayderlar reytingi. → [Hujjatlar](docs/README.md)

## 🤖 Mos CLI va kodlash agentlari > Bitta konfiguratsiya — `http://localhost:20128/v1` — va **har qanday** AI IDE yoki CLI bepul hamda arzon modellarda ishlaydi.

_{Claude Code}	_{Codex CLI}	_Cline	_{Kilo Code}	_{Zoo Code}	_Continue
_Aider	_ForgeCode	_jcode	_{DeepSeek TUI}	_CodeWhale	_OpenCode
_{Factory Droid}	_{Copilot CLI}	_{Cursor CLI}	_Smelt	_Pi	_{Grok Build}
_{Hermes Agent}	_OpenClaw	_Goose	_{Open Interpreter}	_{Warp AI}	_deyin.ai

＋ quyidagilar bilan ham ishlaydi · Agent Deck · Kiro · Command Code · Antigravity · Windsurf · AMP · OpenAI bilan mos keluvchi har qanday vosita

_{📖 Barcha 37 ta vosita uchun alohida sozlash (27 ta CLI Code + 10 ta CLI Agent) → [`docs/reference/CLI-TOOLS.md`](docs/reference/CLI-TOOLS.md) · 🧩 OpenCode plagini → [`@omniroute/opencode-provider`](https://www.npmjs.com/package/@omniroute/opencode-provider)}

**OmniRoute orqali qoʻllab-quvvatlanadigan istalgan CLI’ni bitta buyruq bilan ishga tushiring** — konfiguratsiya fayllari yozilmaydi, hisob maʼlumotlari har bir jarayonga alohida kiritiladi, Qwen/Gemini esa vaqtinchalik izolyatsiyalangan uy katalogini oladi: ```bash omniroute run claude --model openai/gpt-5.4 # Claude Code omniroute run codex --model glm/glm-5.2 # OpenAI Codex CLI omniroute run aider --model glm/glm-5.2 -- --message "reply OK" omniroute run goose --model glm/glm-5.2 omniroute run opencode --model glm/glm-5.2 -- run "reply OK" omniroute run qwen --model glm/glm-5.2 -- -p "reply OK" omniroute run gemini --model glm/glm-5.2 -- --skip-trust -p "reply OK" # Yoki provayder+modelni interaktiv tarzda tanlang va vositaning oʻz konfiguratsiyasini yozing: omniroute configure codex # shuningdek: claude opencode qwen aider goose gemini cline continue kilo 5dive ``` Har bir buyruq faol masofaviy kontekstni (`omniroute connect `) hisobga oladi, `--dry-run` ishga tushirmasdan aniq muhit/oʻzgaruvchilarni oldindan koʻrsatadi, `--api-key-env NAME` esa sirlarni shell tarixingizdan tashqarida saqlaydi. → [CLI integratsiyalari](docs/guides/CLI-INTEGRATIONS.md)

## 🌐 375 ta AI provayder — 153 tasi katalogda bepul deb belgilangan

> Kanonik chat, media, qidiruv, lokal, cloud-agent va tizim toʻplamlari boʻylab **375 ta roʻyxatdan oʻtgan provayder**, jumladan **153 tasi `hasFree: true` discovery metamaʼlumotiga ega**. Chat model reyestri **239 ta provayder / 3 059 ta noyob provayder-model juftligi / 1 475 ta xom model ID**ni qamrab oladi; alohida bepul-budjet katalogida **467 ta har bir model uchun qator**, **34 ta takrorlanuvchi pul** va **51 ta takrorlanuvchi/keyless abadiy bepul provayder** mavjud. Bular dizayn boʻyicha turli maxrajlardir; taʼriflar va pul-dedup hisob-kitoblari [Provayder maʼlumotnomasi](docs/reference/PROVIDER_REFERENCE.md) va [Bepul tariflar](docs/reference/FREE_TIERS.md) hujjatlarida keltirilgan.

### 🏢 Har bir yirik laboratoriya — bitta endpoint orqali

_OpenAI	_Anthropic	_Gemini	_{xAI Grok}	_DeepSeek	_Mistral
_Qwen	_{Meta Llama}	_Groq	_NVIDIA	_MiniMax	_Cohere
_Perplexity	_HuggingFace	_Together	_Fireworks	_Cloudflare	_Baidu

_{…va yana 350+ — har bir ikonka boshqaruv panelining provayderlar katalogidan real vaqtda olinadi. 📖 [Provayder maʼlumotnomasi](docs/reference/PROVIDER_REFERENCE.md)}
### 🆓 Abadiy bepul — $0, karta talab qilinmaydi

OpenCode Zen _{DeepSeek V4, Nemotron 3 Token chegarasi yoʻq}	Kilo Code _{Auto-router, Tencent Hy3 Abadiy bepul}	Requesty _{GPT-OSS 120B, Nemotron Abadiy bepul}	SiliconFlow _{DeepSeek V3.2 / R1 Bepul tarif}	Z.AI GLM _{GLM-4.7 / 4.5-Flash Abadiy bepul}	Baidu ERNIE _{ERNIE 4.0 Abadiy bepul}
Qoder AI _{Qwen3-Max, Kimi-K2 Cheksiz BEPUL}	Pollinations _{GPT, Llama, Claude Kalit talab qilinmaydi}	Cloudflare AI _{50+ model kuniga 10K neyron}	NVIDIA NIM _{GLM, MiniMax bepul ~40 RPM}	Cerebras _{GLM 4.7, GPT-OSS Bir martalik $5 kredit; karta talab qilinadi}	OpenRouter _{:free modellar +$10 → yuqoriroq RPM}

📖 Toʻliq mashinada oʻqiladigan katalog → [`docs/reference/PROVIDER_REFERENCE.md`](docs/reference/PROVIDER_REFERENCE.md)

## 🖥️ OmniRoute qayerda ishlaydi — istalgan joyda

> Oʻsha ilova, sizning qurilmangiz, sizning qoidalaringiz. Global npm oʻrnatilishidan tortib Termux orqali **telefoningizgacha**.

Platforma	Oʻrnatish	Asosiy afzalliklar
📦 npm (global)	`npm install -g omniroute`	Bitta buyruq, istalgan OS
🐳 Docker	`docker run … diegosouzapw/omniroute`	Koʻp arxitekturali: AMD64 + ARM64
🖥️ Ish stoli (Electron)	`npm run electron:build`	Mahalliy oyna + tizim treyi — Windows / macOS / Linux
🎩 Menyu paneli (OmniRouteTray)	`brew install --cask zoispag/tap/omniroute-tray`	Serverni nazorat qiladi va avtomatik yangilaydi — macOS
💪 ARM	mahalliy `arm64`	Raspberry Pi, ARM serverlari, Apple Silicon
📱 Android (Termux)	`pkg install nodejs && npx -y omniroute`	Telefoningizda 24/7 ishlaydi, root talab qilinmaydi
📲 PWA	“Bosh ekranga qoʻshish”	Toʻliq ekranli, oflayn ishlaydi, brauzerdan oʻrnatiladi
🧩 OpenCode plagini	`@omniroute/opencode-provider`	OpenCode bilan mahalliy integratsiya
🤖 VS Code Copilot Chat	OmniCopilot kengaytmasini oʻrnating	Barcha OmniRoute modellari mahalliy Copilot Chat tanlagichida — barqaror va Insiders versiyalarida
🛠️ Manba kodidan	`npm install && npm run dev`	Oʻzgartiring, hissa qoʻshing

_{📖 [Docker qoʻllanmasi](docs/guides/DOCKER_GUIDE.md) · [Ish stoli](electron/README.md) · [Menyu paneli treyi](https://github.com/zoispag/omniroute-tray) · [Termux](docs/guides/TERMUX_GUIDE.md) · [PWA](docs/guides/PWA_GUIDE.md) · [OpenCode](docs/frameworks/OPENCODE.md)}

### 🧩 Yangi: OmniRoute VS Code’ning mahalliy Copilot Chat ichida

> Yangi yon panel ham, yangi chat interfeysi ham yoʻq — OmniRoute taqdim etadigan har bir model bevosita > **siz allaqachon foydalanadigan Copilot Chat model tanlagichida** paydo boʻladi. VS Code 1.122 versiyasidan boshlab provayder modellari > GitHub hisobiga kirish yoki Copilot obunasisiz ishlaydi — agent rejimi, vositalarni chaqirish va tasvirlarni tahlil qilish > bepul. **[OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)** kengaytmasini oʻrnating, uni OmniRoute serveringizga yoʻnaltiring (standart manzil: `localhost:20128`), soʻng Copilot Chat → model tanlagichi → **Modellarni boshqarish…** → **OmniRoute** boʻlimini oching.

Doʻkon	Havola	Quyidagilar bilan ishlaydi
🧩 VS Code Marketplace	Oʻrnatish →	VS Code — barqaror va Insiders versiyalari
🔓 Open VSX Registry	Oʻrnatish →	Cursor, Windsurf, VSCodium, Theia, code-server, Gitpod, Antigravity, Kiro…

Muharrir ichida: **Kengaytmalar** koʻrinishini oching, **“OmniRoute”** deb qidiring va **Oʻrnatish** tugmasini bosing — ikkala doʻkonda ham bir xil ishlaydi. Manba kodi, muammolar va nashr qilish yoʻriqnomasi [diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot) sahifasida joylashgan. _{📖 [VS Code Copilot Chat qoʻllanmasi](docs/guides/VSCODE-COPILOT.md) — sozlash, tanlagich nimalarni koʻrsatishi, panelni ichki varaqda ochish, muammolarni bartaraf etish}

### 🎩 Yangi: OmniRouteTray — menyu panelida yashovchi shlyuzingiz

> `omniroute serve` doimo ishlab turganda eng yaxshi natija beradi. **[OmniRouteTray](https://github.com/zoispag/omniroute-tray)** > uni macOS uchun bir marta sozlanadigan va keyin eʼtibor talab qilmaydigan menyu paneli ilovasiga aylantiradi: u serverni ishga tushiradi, qayta yuklashlardan > keyin ham ishlashini taʼminlaydi, joyida yangilaydi va amaldagi token byudjetingizni bir marta bosish orqali koʻrsatadi — **ochiq > terminal oynasi ham, nazorat qilib turilishi kerak boʻlgan `npm install -g omniroute` ham yoʻq.** [Tauri v2](https://v2.tauri.app/) bilan yaratilgan (hajmi yaxlitlash xatosidek kichik Rust yadrosi), u oʻzining imzolangan Node 24 ish muhitini oʻz ichiga oladi va ilovaga tegishli OmniRoute oʻrnatilishini boshqaradi, shu sababli u global `node`/`bun` bilan hech qachon toʻqnashmaydi. U **mavjud `~/.omniroute/` konfiguratsiyangiz va maʼlumotlar bazangizdan birgalikda foydalanadi** — yaʼni bu siz allaqachon ishga tushirayotgan oʻsha OmniRoute, faqat shlyapa kiygan. 🎩

Nima qiladi	Qanday
🟢 Serverni nazorat qiladi	`omniroute serve` jarayonini ishga tushiradi, yangi nusxa yaratish oʻrniga allaqachon ishlayotgan nusxani qabul qiladi
📊 Joriy foydalanishni bir qarashda koʻrsatadi	Provayder kvotasi panellari, qayta tiklanishgacha qolgan vaqt koʻrsatiladigan Claude seans/haftalik cheklovlari, 30 kunlik xarajatlar taqsimoti
🔄 Joyida avtomatik yangilanadi	Bosqichma-bosqich oʻrnatish, atomar almashtirish, xatolik yuz bersa ortga qaytarish — doimo eng yangi relizda
🚀 Tizimga kirganda ishga tushadi	Tizimga kirganda ixtiyoriy ishga tushirish; faqat treyda, dock belgisisiz
🩺 Diagnostika va jurnallar	Bir marta bosish orqali diagnostika va server jurnallariga kirish

```sh brew install --cask zoispag/tap/omniroute-tray ``` _{Yuklab olishni afzal ko‘rasizmi? Eng so‘nggi .dmg faylini
Relizlar sahifasidan oling. Manba kodi, muammolar va yig‘ish
hujjatlari zoispag/omniroute-tray sahifasida joylashgan.

💛 @zoispag tomonidan yaratilgan hamjamiyat loyihasi — bu rasmiy OmniRoute relizi emas.}

## 🔒 Maxfiy va Local-First

_{📖 [Avtorizatsiya](docs/architecture/AUTHZ_GUIDE.md) · [Himoya cheklovlari](docs/security/GUARDRAILS.md) · [Muvofiqlik](docs/security/COMPLIANCE.md)}

## 🔌 Toʻliq CLI + A2A va MCP

> Serverdan tashqari, OmniRoute **80 dan ortiq buyruqqa ega toʻliq buyruq qatori boshqaruv markazi** hamda AI agentiga uni **mustaqil ravishda** boshqarish imkonini beruvchi ochiq agent protokollaridir. ### ⌨️ Haqiqiy CLI (shunchaki `start` emas) ```bash omniroute # shlyuz + boshqaruv panelini ishga tushirish (20128-port) omniroute chat # interaktiv TUI chat mijozi (qisqa buyruqlar: /model /combo /skill /memory) omniroute setup # birinchi ishga tushirish uchun bosqichma-bosqich yordamchi omniroute doctor # provayderlar, portlar va mahalliy bogʻliqliklarni diagnostika qilish ``` ### 🛰️ Masofaviy rejim — CLI'ni shu yerda, OmniRoute'ni VPS'da ishga tushiring OmniRoute serverdami? Uni noutbukingizdan **xuddi shu CLI** yordamida boshqaring. Qamrovi cheklangan kirish tokeni bilan bir marta tizimga kiring; shundan soʻng har bir buyruq masofaviy serverga yoʻnaltiriladi. ```bash omniroute connect 192.168.0.15 # parol → qamrovi cheklangan token, kontekst sifatida saqlanadi omniroute models # ← MASOFAVIY serverda bajariladi omniroute configure codex # ← masofaviy modelni tanlaydi, mahalliy Codex profilini yozadi omniroute tokens create --name ci --scope read # boshqa qurilmalar uchun qamrovi torroq tokenlar yaratadi omniroute contexts use default # ← mahalliy serverga qaytadi ``` Tokenlar `read` / `write` / `admin` qamrovlariga ega; jarayonlarni ishga tushiruvchi marshrutlar faqat loopback uchun ochiq qoladi. _{📖 [Masofaviy rejim](docs/guides/REMOTE-MODE.md)}

OmniRoute CLI'ni namoyish qiluvchi animatsiyali terminal — omniroute providers list, omniroute combo list va omniroute health — 89 ta yuqori darajadagi buyruqlar boʻylab almashinadi: providers · oauth · keys · combo · nodes · models · cache · compression · cost · usage · quota · health · resilience · telemetry · logs · audit · mcp · a2a · cloud · memory · skills · eval · tunnel · backup · sync · webhooks · policy · pricing · translator · simulate …

### 🤝 Agentni ulang — va u OmniRoute'ni mustaqil boshqaradi OmniRoute'ni **MCP**, **A2A**, **REST API**, **webhooklar** yoki **masofaviy CLI** orqali taqdim eting — imkoniyatli har qanday agent (yoki oʻz kodingiz) butun shlyuzni: marshrutlash, provayderlar, kombinatsiyalar, kesh, siqish va xotirani avtonom tarzda boshqarish imkoniga ega boʻladi. Quyidagi HTTP endpointlar `http://localhost:20128` manzilida taqdim etiladi.

Interfeys	Endpoint / buyruq	Foydalanish maqsadi
🧰 MCP (stdio)	`omniroute --mcp`	Claude Desktop, Cursor yoki istalgan MCP mijoziga ulang
🌊 MCP (HTTP)	`/api/mcp/stream`	Masofaviy MCP — 110 ta vosita, 33 ta qamrov (majburiy nazorat ixtiyoriy), toʻliq audit jurnali
📡 MCP (SSE)	`/api/mcp/sse`	Oqimli MCP transporti
🤝 A2A	`/.well-known/agent.json`	Agentlararo aloqa, JSON-RPC 2.0 + SSE, 6 ta koʻnikma
🌐 REST API	`/v1/*`	OpenAI bilan mos — chat, embeddinglar, tasvirlar, audio, OCR
🔔 Webhooklar	`/api/webhooks`	Soʻrov / kvota hodisalarini Slack, Discord, Telegram yoki istalgan URL manziliga yuboring
🛰️ Masofaviy CLI	`omniroute connect`	Masofaviy nusxani qamrovi cheklangan kirish tokenlari bilan boshqaring

```bash # Claude Code'ga MCP orqali OmniRoute vositalarining toʻliq toʻplamini taqdim eting: claude mcp add-server omniroute --type http --url http://localhost:20128/api/mcp/stream ``` _{📖 [MCP serveri](docs/frameworks/MCP-SERVER.md) · [A2A serveri](docs/frameworks/A2A-SERVER.md) · [Agent protokollari](docs/frameworks/AGENT_PROTOCOLS_GUIDE.md)}

## 🗜️ 15–95% tokenni tejang — avtomatik

### 📖 Bu qanday ishlaydi — pipeline, arxitektura va tejash matematikasi

OmniRoute compression pipeline: an illustrative 10,000-token client request passes through 12 composable engines — Session-Dedup, CCR, Lite, RTK, Responses Tool Output, Headroom, Relevance, Caveman, Aggressive, LLMLingua-2, Ultra and OmniGlyph — and can reach the provider at about 1,080 tokens in the documented stacked example. Structured content is protected by preservation guards and per-step fidelity gates; explicit lossy or experimental modes may transform eligible content.

Standart stacked kombinatsiya `RTK → Caveman` ni ishga tushiradi. Ikkalasi ham bir xil tool/context payload ustida ishlasa, tejamkorlik kumulyativ boʻladi: ```txt combined = 1 − (1 − RTK) × (1 − Caveman_input) average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2% range = 78.4 – 94.6% ``` Kod bloklari, URLʼlar, JSON va tuzilgan maʼlumotlar saqlash (preservation) dvigateli tomonidan **doim himoyalanadi**. > **Oz token yetib turgan ishga koʻp token nega kerak?** Har bir soʻrov OmniRoute'ning siqish pipeline'idan **shaffof** oʻtadi — mijoz tomonda hech qanday oʻzgartirish kerak emas. Endi bu tartib bilan ishlaydigan va har bir routing kombinatsiyasi uchun aralashtirib sozlanadigan **12 ta biriktiriladigan dvigatel toʻplami** — [RTK](https://github.com/rtk-ai/rtk), [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ 90K+), [LLMLingua-2](https://github.com/microsoft/LLMLingua) va [Troglodita](https://github.com/leninejunior/troglodita) (PT-BR) gʻoyalariga asoslangan. ### 🧱 12 dvigatelli toʻplam Dvigatellar pipeline tartibida ishlaydi; har biri alohida yoqiladi va sozlanadi, kombinatsiya boʻyicha:

#	Dvigatel	Nima qiladi
1	Session-Dedup	Navbatlar boʻylab takrorlangan kontentni olib tashlaydi (content-addressed, navbatlararo)
2	CCR	Katta bloklarni retrieve marker'lari ortida arxivlaydi, talab boʻyicha olinadi
3	Lite	Boʻsh joylar + rasm URLʼlarini qisqartirish (kechikishi past asosiy daraja)
4	RTK	Tool natijalarini aqlli filtrlash, dedup va qisqartirish (buyruqni hisobga olgan holda)
5	Responses Tool Output	Avval lossless JSON, soʻngra shell/patch/search/build chiqishlari uchun chegaralangan diagnostik siqish (Responses API)
6	Headroom	JSON massivlarini lossless jadval koʻrinishida zichlash (~30%), vendored GCF codec orqali
7	Relevance	Oxirgi foydalanuvchi soʻroviga nisbatan ekstraktiv gap baholash
8	Caveman	Qoidalarga asoslangan matn siqish (chiqishda ~65–75%)
9	Aggressive	Xulosalash + eski navbatlarni bosqichma-bosqich qarish (aging)
10	LLMLingua-2	MobileBERT ONNX orqali ML semantik pruning — kod uchun xavfsiz, asinxron
11	Ultra	Evristik token pruning, ixtiyoriy kichik model (SLM) darajasi bilan
12	OmniGlyph	Toʻgʻridan-toʻgʻri Anthropic wire'da oʻlchangan Claude Fable 5 uchun eksperimental context-as-image kodlash; GPT 5.6 transformer'lari provayder tushumlari (receipts) kutilmaguncha fail-closed holatda qoladi. Toʻrtta siqish profili (aggressive standart, balanced, coding-safe, passthrough) (eng agressiv; opt-in)

Kod bloklari, URLʼlar va tuzilgan maʼlumotlar **doim bayt-bayt saqlanadi**. **Bir bosishdagi preset'lar** dvigatellarni birlashtiradi:

Rejim	Tejamkorlik	Nima uchun mos
🪶 Lite	~15%	Doim yoqilgan xavfsiz standart
🪨 Standard (Caveman)	~30%	Kundalik kodlash
⚡ Aggressive	~50%	Toolʼlar koʻp ishlatiladigan uzoq sessiyalar
🔥 Ultra	~75%	Maksimal tejamkorlik
🧰 RTK	60–90%	Shell/test/build/git chiqishi
🔗 Stacked (RTK → Caveman)	78–95%	Aralash promptʼlar + tool loglari

**Haqiqiy misol — Standard rejimi:** > **Oldin (69 token):** _"The reason your React component is re-rendering is likely because you're creating a new object reference on each render cycle. When you pass an inline object as a prop, React's shallow comparison sees it as a different object every time, which triggers a re-render. I would recommend using useMemo to memoize the object."_ > > **Keyin (19 token):** _"New object ref each render. Inline object prop = new ref = re-render. Wrap in useMemo."_ > > **Xuddi shu javob. 72% kam token. Aniqlikda hech qanday yoʻqotish yoʻq.** ✅ **PT-BR misoli — [Troglodita](https://github.com/leninejunior/troglodita) rejimi:** > **Oldin (42 token):** _"Muammo shundaki, komponent qayta render qilinmoqda, chunki har bir render siklida yangi obyekt referensi yaratilmoqda. Men `useMemo` ishlatishni tavsiya qilardim."_ > > **Keyin (12 token):** _"Qayta render: har sikl yangi ref (inline obyekt qayta yaratiladi). `useMemo` ishlatish."_ > > **Bir xil javob. ~70% kam token. Texnik aniqlik buzilmagan.** ✅
### 🎚️ Dvigatellardan tashqari — chiqish uslublari, adaptiv sozlama va har bir so'rov bo'yicha boshqaruv Yuqoridagi 12 ta dvigatel **kirish** hajmini kichraytiradi. Yana uchta qatlam **qanday**, **qachon** va **nima chiqishini** shakllantiradi: - **🪄 Chiqish uslublari** _(chiqish o'qiga ta'sir)_ — deterministik, kesh uchun xavfsiz javob shakllantirish ko'rsatmalarini kiritadi; birgalikda ishlatilishi mumkin, har biri `lite` / `full` / `ultra` intensivlikda. Uslub qo'shish — registrga bitta satr qo'shish: - **Qisqa matn** — to'ldiruvchi so'zlar / artikllar / ikkilanishlarni olib tashlash; texnik mazmunni aniq saqlash. - **Kamroq kod** — "dangasa katta dasturchi" YAGNI: eng kichik ishlaydigan o'zgarish, so'ralmagan karkassiz. - **Ponytail (dangasa katta dasturchi)** — YAGNI zinapoyasidan ko'tarilish, asosiy sababni tuzatish, eng kichik ishlaydigan diff. - **Menda ADHD (avval harakat)** — keyingi harakat birinchi o'rinda, qadamlar raqamlangan, bitta aniq keyingi qadam, kirish so'zisiz. - **Qisqa CJK (文言)** — klassik xitoy uslubidagi o'ta qisqa uslub (faqat `zh` lokali uchun). - **🎯 Adaptiv kontekst budjeti** _(sozlama)_ — bitta yoqilgan/o'chirilgan token chegarasi o'rniga, eng arzon va eng kam yo'qotadigan dvigatellarni faqat **modelning kontekst oynasiga sig'ish** uchun zarur bo'lgan darajada kuchaytirish. Siyosat: `reserve-output` (standart, modelga mos) · `percentage` · `absolute`. Rejim: `floor` (sig'ishni kafolatlash) · `replace-autotrigger` (sizning aniq tanlovingiz ustun) · `off` (eski chegara). - **🎛️ Siqish qayerda hal qilinadi** _(ustunlik, yuqoridan pastga)_ — har bir so'rovdagi `x-omniroute-compression` sarlavhasi › routing-kombo ustidan yozish › faol nomlangan profil › adaptiv / avtomatik ishga tushirish › panel standarti › o'chirilgan. Qo'llanilgan reja `X-OmniRoute-Compression: ; source=` javob sarlavhasida qaytariladi. Token chegarasi bo'yicha avtomatik ishga tushirish, adaptiv sozlamani yoqish, nomlangan profilni belgilash, bir martalik so'rov uchun sozlash yoki har bir routing kombo uchun pipeline tayinlash — ish yukingizga mos keladiganini tanlang. O'zgarishni ilgari surishdan oldin ixtiyoriy oflayn **baholash to'plami** (`npm run eval:compression`) qat'iy korpusda aniqlik va tejamni baholaydi. 📖 [`COMPRESSION_GUIDE.md`](docs/compression/COMPRESSION_GUIDE.md) · [`RTK_COMPRESSION.md`](docs/compression/RTK_COMPRESSION.md) · [`COMPRESSION_ENGINES.md`](docs/compression/COMPRESSION_ENGINES.md)

# ⚡ Tez boshlash

**1) O'rnatish va ishga tushirish** ```bash npm install -g omniroute omniroute ``` > 💡 `npm warn ERESOLVE` yoki peer-dep ogohlantirishlarini ko'ryapsizmi? [Ular zararsiz](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated). > **npm 11 yoki undan keyingisini ishlatyapsizmi?** npm paketning lifecycle skriptlarini ruxsat berilmaguncha bloklashi mumkin. OmniRoute'ning `postinstall` (`node scripts/build/postinstall.mjs`) skripti uning native runtime fayllarini tayyorlash uchun zarur. Global o'rnatishda npm ogohlantirishida ko'rsatilgan paketlarga ruxsat bering. OmniRoute 3.8.53 xabar bergan paketlar to'plami uchun: > > ```bash > npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute > ``` > > Bu ruxsat ro'yxatini keyingi global o'rnatishlarda qayta ishlatish uchun uni bir marta sozlang, keyin odatdagidek o'rnating: > > ```bash > npm config set allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild --location=user > npm install -g omniroute > ``` > > Bog'liqliklar ro'yxati relizlar orasida o'zgarishi mumkin; agar npm boshqa ro'yxatni ko'rsatsa, o'sha ogohlantirishdagi paket nomlaridan foydalaning. Paketga ruxsat berish uning o'rnatish skriptlarini ishga tushirishga imkon beradi. > **Gemini Web yoki boshqa web-cookie provayderidan foydalanasizmi?** npm paketi > Playwright'ni o'z ichiga oladi, lekin uning Chromium binariysini emas. Birinchi > web-provayder so'rovini yuborishdan oldin > [Playwright Chromium sozlamasi](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium) > eslatmasini ko'ring. Dashboard `http://localhost:20128` manzilida · API `http://localhost:20128/v1` manzilida. **2) O'z hisobingizdan foydalanib mos provayderni ulang** Dashboard → **Providers** → joriy shartlari va kvotasi ishlatish holatingizga mos keladigan provayderni tanlang → uning API kalitini qo'shing yoki hisob oqimini yakunlang. Bepul tariflar ro'yxatdan o'tish, tasdiqlash yoki to'lov usulini talab qilishi mumkin. [Bepul tariflar qo'llanmasi](docs/getting-started/FREE-TIERS-GUIDE.md)ni ko'rib chiqing; kalitsiz mavjudlik kafolatlanmaydi va `tos: avoid` deb belgilangan provayderlar standart holatda `auto` dan chiqarib tashlanadi. **3) Kodlash vositasini yo'naltiring** ```txt Base URL: http://localhost:20128/v1 API Key: [copy from Dashboard → Endpoints] Model: auto (routes among eligible connections — or choose provider/model) ``` **4) Ishlayotganini tekshiring** ```bash curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY" ``` Ulangan modellaringiz ro'yxatda ko'rinishi kerak. 🎉 Bo'ldi — kodlashni boshlang, OmniRoute esa siz uchun avtomatik marshrutlaydi va zaxira variantga o'tadi. Agar mijoziingiz maxsus sarlavhalar yubora olmasa, OmniRoute tokenlashtirilgan moslik aliaslarini ham taqdim etadi: ```txt OpenAI catalog: http://localhost:20128/vscode/YOUR_KEY/ OpenAI models: http://localhost:20128/vscode/YOUR_KEY/models OpenAI chat: http://localhost:20128/vscode/YOUR_KEY/chat/completions OpenAI responses: http://localhost:20128/vscode/YOUR_KEY/responses Ollama chat: http://localhost:20128/vscode/YOUR_KEY/api/chat Ollama tags: http://localhost:20128/vscode/YOUR_KEY/api/tags ``` Bulardan faqat `Authorization: Bearer ...` qo'sha olmaydigan mijozlar uchun foydalaning. Sarlavha orqali autentifikatsiya afzal rejim bo'lib qoladi.
## 📦 Qoʻshimcha oʻrnatish usullari — Docker, manba kodi, pnpm, Arch **🐳 Docker** ```bash docker run -d --name omniroute --restart unless-stopped --stop-timeout 40 \ -p 127.0.0.1:20128:20128 -v omniroute-data:/app/data diegosouzapw/omniroute:latest ``` `:latest` eng yuqori **eʼlon qilingan** barqaror SemVer versiyasiga mos keladi. U git `main` tarmogʻini kuzatmaydi. GitOps uchun `:X.Y.Z` versiyasini aniq belgilang. [Docker reliz kanallari](docs/guides/DOCKER_GUIDE.md#release-channels)ga qarang. Tasvirda **`OMNIROUTE_MEMORY_MB=1024`** qatʼiy belgilangan. Bu boshqaruv paneli va yengil chat uchun yetarli. **Kodlash agentlari** (Claude Code, Codex, Grok va boshqalardan `POST /v1/responses`) ancha katta V8 uyumini talab qiladi, aks holda bir-biriga ustma-ust tushgan ikkita uzun kontekstda, taxminan 12 GiB darajasida jarayon `FATAL ERROR` bilan yakunlanadi. Konteyner hajmini uyumdan kattaroq qilib belgilang (mahalliy buferlar V8 tashqarisida joylashadi): | Ish yuklamasi | Uyum (`-e OMNIROUTE_MEMORY_MB`) | Konteyner (`--memory`) | | ---------------------------------------- | ------------------------------- | ---------------------- | | Boshqaruv paneli / yengil chat | `1024` (tasvir standarti) | ≥2 g | | Bitta kodlash agenti | `8192` | ≥10 g | | Bir vaqtdagi ikkita uzun `/v1/responses` | `10240`–`12288` | ≥12–16 g | ```bash docker run -d --name omniroute --restart unless-stopped --stop-timeout 40 \ -e OMNIROUTE_MEMORY_MB=8192 --memory=10g \ -p 127.0.0.1:20128:20128 -v omniroute-data:/app/data diegosouzapw/omniroute:latest ``` Toʻliq jadval: [Docker qoʻllanmasi — bajarilish vaqtidagi RAM](docs/guides/DOCKER_GUIDE.md#runtime-ram-for-coding-agents). > **Relizoldi Docker kanali:** `diegosouzapw/omniroute:next` va > `diegosouzapw/omniroute:next-web` joriy standart `release/v*` > tarmogʻini kuzatadi. Bu oʻzgaruvchan teglar faqat hali chiqarilmagan tuzatishlarni sinash uchun moʻljallangan va > **ishlab chiqarish muhiti uchun qoʻllab-quvvatlanmaydi**. > [Docker reliz kanallari](docs/guides/DOCKER_GUIDE.md#release-channels)ga qarang. **🥟 Bun** Standart `bun install` va global oʻrnatish (`bun install -g omniroute`) Bun bajarilish muhitini aniqlash orqali qoʻllab-quvvatlanadi: - **Ichki `bun:sqlite`**: OmniRoute Bun muhitida ishlaganda uning ichki `bun:sqlite` drayveridan foydalanadi, Node.js muhitida esa `better-sqlite3` yoki `sql.js`ga qaytadi. - **Ishlab chiqishda Webpack toʻplagichini avtomatik tanlash**: Ishlab chiqish rejimi (`bun run dev`) Bunʼni avtomatik aniqlaydi va mahalliy V8 bogʻlamalaridagi nomuvofiqliklarning oldini olish uchun Turbopackʼni oʻchirib, Webpackʼdan foydalanadi. Ishlab chiqarish tuzilmalari (`bun run build`) xuddi Nodeʼdagi kabi `OMNIROUTE_USE_TURBOPACK`ga aniq amal qiladi: standart holatda Turbopack, Webpack bilan tuzish uchun `OMNIROUTE_USE_TURBOPACK=0` (`Dockerfile.bun` uni `--build-arg` sifatida taqdim etadi). - **Maxsus Bun Dockerfile**: Mahalliy Bun ishlab chiqarish muhitlari uchun koʻp bosqichli `Dockerfile.bun` (`docker build -f Dockerfile.bun -t omniroute:bun .`). ```bash # Bun bilan o‘rnating va ishga tushiring bun install bun run dev ``` **🛠️ Manba kodidan** ```bash cp .env.example .env && npm install PORT=20128 npm run dev ``` **📦 pnpm** ```bash pnpm add -g omniroute@latest --allow-build=better-sqlite3 --allow-build=@swc/core && omniroute ``` **🐧 Arch Linux (AUR)** ```bash yay -S omniroute-bin && systemctl --user enable --now omniroute.service ``` **🔧 Nix (Flake)** ```bash # Nix flake’laridan foydalanish nix develop npm run dev # Yoki devbox’dan foydalanish devbox run npm run dev ``` 📖 [Docker qoʻllanmasi](docs/guides/DOCKER_GUIDE.md) — Compose profillari, Caddy HTTPS, Cloudflare tunnellari. **🦭 Podman** ```bash # 1. Bog‘lab ulanadigan ma’lumotlar katalogini tayyorlang mkdir -p data # 2. Faqat Linux + mahalliy rootless Podman uchun (hech qachon masofaviy Podman Machine mijozi uchun emas): podman unshare chown 1000:1000 ./data # 3. Bajarilish muhiti ko‘rsatmasini sozlang, mahalliy Compose tasvirini tuzing va ishga tushiring echo "CONTAINER_HOST=podman" >> .env podman compose --profile base up -d --build ``` macOS yoki Windowsʼda Podman masofaviy Podman Machineʼdan foydalanadi: `podman unshare`ni oʻtkazib yuboring va [topologiyaga xos maʼlumotlar katalogi boʻyicha koʻrsatmalar](contrib/podman/README.md#data-directory-permissions-by-topology)ga amal qiling. 📖 [Podman qoʻllanmasi](contrib/podman/README.md) — Compose tuzilmalari, Podman Machine va Linux/systemd Quadlet sozlamalari. **⚡ Tezroq / ixchamroq oʻrnatish (mahalliy tuzishni oʻtkazib yuborish)** Mahalliy SQLite mexanizmi (`better-sqlite3`) **ixtiyoriy** bogʻliqlikdir, shuning uchun global oʻrnatish hech qachon manba kodidan kompilyatsiya qilishni kutib qolmaydi: platformangiz/Nodeʼingizga mos kelsa, oldindan tuzilgan ikkilik fayldan foydalanadi, aks holda shaffof tarzda sof JS mexanizmiga (Node 22+ da `node:sqlite`, aks holda toʻplamga kiritilgan `sql.js` WASM) qaytadi — tuzish vositalari talab qilinmaydi. Oʻrnatishdan keyingi mahalliy tayyorlashni butunlay oʻtkazib yuborish uchun (CI, grafik interfeyssiz yoki sekin qurilmalar): ```bash OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute # CI=1 ham uni o‘tkazib yuboradi ``` Eng tez oʻrnatish uchun **pnpm**dan foydalaning (kontentga asoslangan ombor + qattiq havolalar — yuqoriga qarang). Boshqaruv panelisiz, grafik interfeyssiz bajarilish muhiti uchun Dockerʼning `base` profilidan (yuqorida) yoki [Termux qoʻllanmasi](docs/guides/TERMUX_GUIDE.md)dan foydalaning. CLI va veb-boshqaruv paneliga bir portdagi bitta jarayon xizmat koʻrsatadi, shu sababli hozircha faqat CLI uchun alohida paket mavjud emas.

# 🎬 OmniRoute amalda

## 📹 Video qoʻllanmalar

_{2026-10-18 holatidagi panel · Xom katalog: YT 1.352 | TT 334 | IG 290 · Yangilik darajasi (kun): YT 5 | TT 48 | IG 49}

🎬 #1 — Instagram
_{nick_saraev — 3,042,474 marta koʻrilgan}

🎬 #2 — Instagram
_{nnapier7 — 1,454,535 marta koʻrilgan}

🎬 #3 — YouTube
_{Amidia AI & Tech — 794,974 marta koʻrilgan}

🎬 #4 — Instagram
_{theopenstack — 692,419 marta koʻrilgan}

🎬 #5 — TikTok
_{migue.baena — 685,788 marta koʻrilgan}

**Toʻliq reyting (takrorlari olib tashlangan kanonik URL manzillar, `v > 0`, eng katta qamrov):** | #1 | #2 | #3 | #4 | #5 | | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | | [nick_saraev — Instagram](https://www.instagram.com/reel/Da8ZthUPK98/) — **3,042,474** | [nnapier7 — Instagram](https://www.instagram.com/reel/Dbp7wv_CIO0/) — **1,454,535** | [Amidia AI & Tech — YouTube](https://www.youtube.com/watch?v=NJ0TQ-pyMDY) — **794,974** | [theopenstack — Instagram](https://www.instagram.com/reel/DaSs65mMrHk/) — **692,419** | [migue.baena — TikTok](https://www.tiktok.com/@migue.baena/video/7670919268216622358) — **685,788** | | #6 | #7 | #8 | #9 | #10 | | ------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | | [milesreevesai — TikTok](https://www.tiktok.com/@milesreevesai/video/7667980059189366019) — **620,400** | [nikothetech — TikTok](https://www.tiktok.com/@nikothetech/video/7671890769665477918) — **610,803** | [Vaibhav Sisinty — YouTube](https://www.youtube.com/watch?v=QucgvbO5gsM) — **509,281** | [buildwithai.club — Instagram](https://www.instagram.com/reel/DbIt9AjK7-U/) — **347,652** | [nivedan.ai — Instagram](https://www.instagram.com/reel/DbIrCksJiqq/) — **331,973** | 2026-10-18 holatidagi kanonik koʻrsatkichlar: **1.976 ta noyob video** · **20.220.289 ta maʼlum koʻrish** (`v > 0`) · **tarmoqlar boʻyicha 1.210 ta kanal/profil**. Xom panel 1.976 ta qatorni oʻz ichiga oladi (YouTube 1.352 = 740 ta uzun video + 612 ta Shorts · TikTok 334 · Instagram 290); kanonik URL boʻyicha normallashtirishdan soʻng hech qanday takror qolmadi, bunda har bir video uchun eng katta koʻrishlar soni saqlanadi. YouTube maʼlumotlarini yigʻish 2026-10-13 sanasida muzlatilgan (14 dan 18/10 gacha API kvotasi tugagan), TikTok/Instagram uchun esa 2026-09-02 sanasidan beri muzlatilgan (maʼlumot yigʻish kreditlari yoʻq); 76 ta videoda hali koʻrishlar soni mavjud emas. > 🎬 **OmniRoute haqida video tayyorladingizmi?** Havola bilan [muammo](https://github.com/diegosouzapw/OmniRoute/issues/new) yoki [muhokama](https://github.com/diegosouzapw/OmniRoute/discussions) oching — biz uni shu yerda namoyish qilamiz.

# 📧 Hamjamiyat va yordam > Hammasi bir joyda — loyiha kuzatuvchisiga obuna boʻling, hamjamiyat bilan suhbatlashing yoki muammo oching. | Kanal | Qayerda / qanday | | ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------- | | 💼 **LinkedIn** — loyiha boshqaruvchisini kuzating | [linkedin.com/in/diegosouzapw](https://www.linkedin.com/in/diegosouzapw/) | | 🐙 **GitHub** — relizlar va maslahatlar uchun kuzating | [@diegosouzapw](https://github.com/diegosouzapw) | | 💬 **Discord** | [discord.gg/U47eFqAXCn](https://discord.gg/U47eFqAXCn) | | ✈️ **Telegram** | [t.me/omnirouteOficial](https://t.me/omnirouteOficial) | | 🟢 **WhatsApp — 🌍 Global** | [guruhga qoʻshiling](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) | | 🟢 **WhatsApp — 🇧🇷 Braziliya** | [guruhga qoʻshiling](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) | | 🌍 **Veb-sayt** | [omniroute.online](https://omniroute.online) | | 🌍 **🌍StHub OmniRoute hamjamiyati (bepul)** | [StHub portali](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK) | | 📦 **Manba kodi** | [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute) | | 🐛 **Xato haqida xabar berish** | [muammo oching](https://github.com/diegosouzapw/OmniRoute/issues) — `npm run system-info` chiqishini ilova qiling | | 🤝 **Hissa qoʻshish** | [CONTRIBUTING.md](CONTRIBUTING.md) · [Tarmoqlanish va reliz modeli](docs/ops/BRANCHING_MODEL.md) · `good first issue`ni tanlang | | 💚 **Loyihani qoʻllab-quvvatlash** | [Qoʻllab-quvvatlash usullari ↑](#-support-omniroute) · [GitHub Sponsors](https://github.com/sponsors/diegosouzapw) |

---

## 🛠️ Texnologiyalar toʻplami

Qatlam	Texnologiya
Ish muhiti	Node.js 22.x / 24.x LTS — `>=22.22.2 <23 \|\| >=24.0.0 <27`
Til	TypeScript 6.0 — `src/` va `open-sse/` boʻylab 100% TypeScript (v2.0 dan buyon yadroda `any` yoʻq)
Freymvork	Next.js 16 + React 19 + Tailwind CSS 4
Maʼlumotlar bazasi	better-sqlite3 (SQLite, WAL jurnalizatsiyasi) + LowDB (JSON legacy) — 147 ta domen moduli, 209 ta migratsiya
Xotira	SQLite FTS5 toʻliq matnli qidiruv + int8-kvantlangan vektor embeddinglar, tiplashtirilgan decay
Sxemalar	Zod 4 — MCP asboblarining I/O validatsiyasi + API kontraktlari
Protokollar	MCP (stdio / HTTP / SSE) + A2A v0.3 (JSON-RPC 2.0 + SSE)
Oqim (streaming)	Server-Sent Events (SSE) + WebSocket koʻprigi (`/v1/ws`)
Siqish	12 dvigatelli quvur liniyasi — RTK, Caveman, LLMLingua-2 (MobileBERT ONNX), GCF, OmniGlyph
Autentifikatsiya va xavfsizlik	OAuth 2.0 (PKCE) + JWT + API kalitlari + MCP doiralangan autentifikatsiya · saqlashda AES-256-GCM · DOMPurify
Yashirinlik (stealth)	wreq-js — JA3 / JA4 TLS barmoq izini taqlid qilish, 3 darajali proksi
Barqarorlik	Circuit breaker, eksponensial backoff, anti-thundering-herd, avtomatik komboning oʻzini oʻzi tiklash
Jurnal yozish	pino — soʻrov kontekstiga ega tuzilgan JSON jurnallar
Testlash	Node.js test runner + Vitest — 7,800+ kuzatiladigan test fayli boʻylab 56,000+ statik test deklaratsiyasi (unit, integratsiya, E2E, xavfsizlik, ekotizim)
Platformalar	Desktop (Electron) · Android (Termux) · PWA (har qanday brauzer)
CI/CD	GitHub Actions — reliz chiqqanda avtomatik npm publish + Docker Hub
Havolalar	Veb-sayt · npm · Docker Hub

## 📖 Hujjatlar

### 📘 Boshlash

Hujjat	Tavsif
Foydalanuvchi qoʻllanmasi	Provayderlar, kombolar, CLI integratsiyasi, joylashtirish
Sozlash qoʻllanmasi	Toʻliq oʻrnatish usullari, CLI vositalari konfiguratsiyalari, protokol sozlash, taym-autlarni sozlash
CLI vositalari qoʻllanmasi	Claude Code, Codex, Cursor, Cline, OpenClaw, Kilo, Copilot uchun vosita boʻyicha sozlash
Masofaviy rejim	Noutbuk CLI orqali cheklangan kirish tokenlari yordamida masofaviy OmniRoute (VPS) ni boshqaring
Claude Code konfiguratsiyasi	Claude Code'ni OmniRoute (lokal/masofaviy) ga `launch` + har bir model uchun profillar bilan yoʻnaltiring
Tezkor boshlash	3 bosqichli oʻrnatish → ulanish → sozlash

### 🔧 Operatsiyalar va joylashtirish

Hujjat	Tavsif
Docker qoʻllanmasi	Docker, Compose profillari, Caddy HTTPS, tunnellar, image teglari
Podman qoʻllanmasi	Quadlet systemd integratsiyasi, podman-compose, SELinux
VM joylashtirish	Toʻliq qoʻllanma: VM + nginx + Cloudflare sozlash
Fly.io joylashtirish	Doimiy saqlash bilan Fly.io ga joylashtirish
Termux qoʻllanmasi	Android'da Termux orqali OmniRoute'ni ishga tushiring
PWA qoʻllanmasi	Progressive Web App oʻrnatish, keshlash, arxitektura
Oʻchirish qoʻllanmasi	Barcha oʻrnatish usullari uchun toza olib tashlash
Muhit konfiguratsiyasi	Toʻliq `.env` oʻzgaruvchilari va havolalar

### 🧠 Xususiyatlar va arxitektura

Hujjat	Tavsif
Arxitektura	Tizim arxitekturasi, maʼlumotlar oqimi va ichki tuzilma
Siqish qoʻllanmasi	7 variantli quvur liniyasi: off / lite / standard / aggressive / ultra / RTK / stacked
RTK siqish	Buyruq chiqishini siqish, filtrlar, ishonch, tekshirish, xom chiqishni tiklash
Siqish dvigatellari	Caveman, RTK, stacked quvurlari, dashboard/API/MCP interfeyslari
Siqish qoidalari formati	Caveman va RTK filtrlari uchun JSON qoida toʻplami sxemalari
Siqish til paketlari	Tilni aniqlash va Caveman qoida toʻplamini yozish
Chidamlilik qoʻllanmasi	Circuit breaker'lar, sovutish davrlari, navbat, momaqaldiroq podasi effektiga qarshi, TLS spoofing
Avto-Combo dvigateli	16 omilli baholash, rejim paketlari, oʻz-oʻzini tiklash
Proksi qoʻllanmasi	3 darajali proksi tizimi, 1proxy bozori, reyestr CRUD
Bepul tariflar	Birlashtirilgan katalog: 34 ta hujjatlashtirilgan takrorlanuvchi pul / 467 ta kataloglangan bepul tarif yozuvlari
Xususiyatlar galereyasi	Skrinshotlar bilan vizual dashboard turi
Kod bazasi hujjatlari	Boshlovchilar uchun qulay kod bazasi boʻylab yurish

### 🤖 Protokollar va API'lar

Hujjat	Tavsif
API maʼlumotnomasi	Barcha endpointlar misollar bilan
OpenAPI spetsifikatsiyasi	OpenAPI 3.0 spetsifikatsiyasi
MCP serveri	110 ta MCP vositasi, IDE konfiguratsiyalari, Python/TS/Go mijozlari
MCP serveri qoʻllanmasi	MCP oʻrnatish, transportlar va vositalar maʼlumotnomasi
A2A serveri	JSON-RPC 2.0 protokoli, koʻnikmalar, streaming, vazifalarni boshqarish
A2A serveri qoʻllanmasi	A2A agent kartasi, vazifalar, koʻnikmalar va streaming

### 📋 Loyiha va sifat

Hujjat	Tavsif
Hissa qoʻshish	Ishlab chiqish muhitini sozlash va qoʻllanmalar
Tarmoqlash va reliz modeli	PRlar qayerga yoʻnaltiriladi (`release/*`), `main` va teglar nimani anglatadi
Oʻzgarishlar jurnali	Har bir versiya boʻyicha toʻliq reliz tarixi
Xavfsizlik siyosati	Zaifliklar haqida xabar berish va xavfsizlik amaliyotlari
i18n qoʻllanmasi	67 tilni qoʻllab-quvvatlash, tarjima jarayoni, RTL
Reliz nazorat roʻyxati	Relizdan oldingi tekshiruv bosqichlari
Qamrov rejasi	7,800+ kuzatilayotgan test fayllari boʻyicha 56,000+ statik test deklaratsiyasi uchun test qamrovi strategiyasi

# ⭐ Eng faol hissa qoʻshuvchilar > OmniRoute gʻayratli ochiq kodli hamjamiyat tomonidan shakllantiriladi. Ushbu insonlar loyihaning sifati, barqarorligi va qamroviga bevosita taʼsir koʻrsatadigan ajoyib hissa qoʻshdilar. **Rahmat.** ### Birlashtirilgan pull requestlar boʻyicha tashqi hissa qoʻshuvchilar

Oʻrin	Hissa qoʻshuvchi	Birlashtirilgan PRlar	~Oʻzgartirilgan satrlar
1	maxmad64bis	371	25,326,561
2	HouMinXi	269	13,456,272
3	backryun	210	270,562
4	oyi77	190	411,243
5	pacocartones	174	78,276
6	JxnLexn	151	3,562,936
6	KooshaPari	151	5,972,314
8	rdself	145	80,663
9	RaviTharuma	123	500,065
10	herjarsa	88	230,872
11	hartmark	84	2,849,554
12	jonlwheat2-gif	67	68,548
13	artickc	62	43,502
14	chirag127	52	6,661
15	xz-dev	50	245,976
16	xiaoyaner0201	47	33,626
17	woodsonl	46	809,391
18	rqzbeh	44	147,896
19	QuangBlue	43	13,112
20	MumuTW	40	26,093

_{Roʻyxat 2026-10-18 15:09:09 UTC holatiga koʻra, jonli release/v3.8.52 oxiri 656f01cb43 bilan olingan. Sahifalangan GitHub GraphQL roʻyxati 9,191 birlashtirilgan PRni oʻz ichiga oladi: 3,834 tasi repozitoriy egasi tomonidan, 229 tasi Dependabot tomonidan, 6 tasi boshqa botlar/ilovalar tomonidan va 835 ta alohida hissa qoʻshuvchidan 5,122 ta tashqi PR. “Oʻzgartirilgan satrlar” — bu GitHub qoʻshishlari + oʻchirishlari boʻlib, generatsiya qilingan fayllar, lockfilelar, kataloglar, tarjimalar va hujjatlarni oʻz ichiga oladi; bu oʻzgarishlar hajmi, mualliflik LOC emas. 49 ta PR GitHub farqlari 500,000 satrdan yuqori ekanini koʻrsatadi (masalan, #13399, bitta provayder qoʻshilishi, 2,347 ta oʻzgargan faylni sanaydi), bu yuqoridagi bir nechta jamlanmalarni oshirib yuboradi. Teng natijalar birgalikda reytingga ega.} ### GitHubga bogʻlangan commitlar

Dizzle _{🥇 GitHub hisoblagan 367 ta kommit}	Bob.Hou _{🥈 GitHub hisoblagan 269 ta kommit}	Paijo _{🥉 GitHub hisoblagan 229 ta kommit}	backryun _{🏅 GitHub hisoblagan 202 ta kommit}	Paco Cartones _{🏅 GitHub hisoblagan 174 ta kommit}	Ravi Tharuma _{🏅 GitHub hisoblagan 126 ta kommit}
Markus Hartung _{🏅 GitHub hisoblagan 114 ta kommit}	Randi _{🏅 GitHub hisoblagan 108 ta kommit}	Jan Leon _{🏅 GitHub hisoblagan 87 ta kommit}	Chris _{🏅 GitHub hisoblagan 70 ta kommit}	Koosha Paridehpour _{🏅 GitHub hisoblagan 68 ta kommit}

_{2026-10-18 14:44:45 UTC da qayta tekshirildi: standart release/v3.8.52 tarmogʻi uchun repozitoriyning Contributors API’si xabar qilgan GitHub hisoblagan kommitlar. API 849 ta identifikatorni qaytardi (429 ta foydalanuvchi, 2 ta bot, 418 ta anonim); bu jadval loyiha boshqaruvchisi, botlar va anonim identifikatorlarni istisno qiladi hamda teng natijalarni saqlab qoladi. U yuqoridagi birlashtirilgan PR reytingidan ham, quyidagi Git metamaʼlumotlari roʻyxatidan ham farq qiladi.} > 🙏 Ushbu hissa qoʻshuvchilarning funksiyalari, xatolarni tuzatishlari va infratuzilmani yaxshilashlari OmniRoute’ni ishonchli va funksiyalarga boy qiladigan jihatlarning **asosiy qismidir**. Har bir pull request, har bir test holati va har bir i18n tarjima fayli muhim. Ochiq manbali dasturiy taʼminot ular kabi insonlar tomonidan yaratiladi.

---
## 💖 Homiylar

OmniRoute loyihasini o‘z mablag‘lari hisobidan moliyalashtirayotgan insonlarga chin yurakdan minnatdorchilik bildiramiz — har bir hissa loyihaning bepul, mustaqil va rivojlanishda davom etishini ta’minlaydi.

Andrew _{💛 Faol oylik homiy}	Vlad I _{💛 Faol oylik homiy}	小妍儿 _{💛 Faol oylik homiy}	Guilherme Costa _{💛 Faol bir martalik homiy}	Henrique Iurkiv _{💛 Faol bir martalik homiy}	Somesh Ghaturle _{💛 Faol bir martalik homiy}
Kolonie AI _{💛 Avvalgi bir martalik qo‘llab-quvvatlovchi}	Prof. Igor Morais _{💛 Avvalgi bir martalik qo‘llab-quvvatlovchi}	Pixma _{💛 Avvalgi bir martalik qo‘llab-quvvatlovchi}	Paco Cartones _{💛 Avvalgi bir martalik qo‘llab-quvvatlovchi}	longtao _{💛 Avvalgi bir martalik qo‘llab-quvvatlovchi}

_{… va maxfiy qolishni afzal ko‘rgan boshqalar 💛} _{Ommaviy GitHub Sponsors ma’lumotlari 2026-10-18 kuni GitHub Sponsors GraphQL API orqali qayta tekshirildi: jami 14 ta homiylikdan 11 tasi ommaviy (6 tasi faol, 5 tasi avvalgi). Yuqoridagi faol belgilar GitHub’ning isActive holati asosida belgilanadi; avvalgi ommaviy bir martalik qo‘llab-quvvatlovchilarga minnatdorchilik bildirishda davom etiladi, maxfiy homiylar esa anonimligicha qoladi. Ko-fi, Buy Me a Coffee, Liberapay, PIX va kriptovalyutadagi xayriyalar ommaviy homiylik qaydiga ega bo‘lmagani sababli ro‘yxatga kiritilmagan.} 💖 Homiy bo‘ling → — har bir dollar OmniRoute’ning bepul va mustaqil bo‘lib qolishiga yordam beradi.

## 👥 900+ hissa qoʻshuvchilar

[![Hissa qoʻshuvchilar](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=993&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors) _{2026-10-18 sanasida amaldagi release/v3.8.52 tarmogʻining eng soʻnggi ad160ab2d1 holati (6 826 ta kommit) asosida audit qilindi: 993 ta normallashtirilgan insoniy Git identifikatori — ulardan 707 tasi kommit muallifi sifatida (jumladan, loyiha kuzatuvchisi) va 286 tasi faqat aniq Co-authored-by treylerlarida uchraydi. Hisoblashda .mailmap qoʻllanadi, e-pochta manzillari registrga bogʻliq boʻlmagan holda solishtiriladi, raqamli va oddiy GitHub noreply manzillari faqat bir xil foydalanuvchi nomini kodlagandagina birlashtiriladi, 26 ta bot/agent/xizmat/toʻldiruvchi identifikatori chiqarib tashlanadi va oddiy e-pochta manzillari faqat koʻrsatiladigan nomlari mos kelgani uchun birlashtirilmaydi. 2026-08-24 sanasidagi auditda 639 ta natija eʼlon qilingan; ushbu usul oʻsha auditning ac02c5b42f bazasida qayta qoʻllanganda 619 ta natija beradi, demak, oʻsish yumshoqroq usuldan emas, yangi hissa qoʻshuvchilardan kelib chiqqan.} ### Qanday hissa qoʻshish mumkin 1. Repozitoriyni fork qiling 2. **Faol** `release/vX.Y.Z` tarmogʻining eng soʻnggi holatidan tarmoq yarating (`main` dan emas) — [Tarmoqlanish va reliz modeli](docs/ops/BRANCHING_MODEL.md) bilan tanishing 3. Funksiyangiz uchun tarmoq yarating (`git checkout -b feat/amazing-feature`) 4. Oʻzgarishlaringizni kommit qiling (`git commit -m 'feat: add amazing feature'`) 5. Tarmoqqa yuboring (`git push origin feat/amazing-feature`) 6. **base = oʻsha `release/vX.Y.Z` tarmogʻi** qilib Pull Request oching Batafsil koʻrsatmalar uchun [CONTRIBUTING.md](CONTRIBUTING.md) fayliga qarang. ### Yangi versiyani chiqarish ```bash # Reliz yarating — npm publish avtomatik ravishda bajariladi VERSION=x.y.z gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes ```

## 📊 Yulduzlar

## 🌍 StarMapper

## 🙏 Minnatdorchilik

OmniRoute gigantlar yelkasida qad rostlagan. U **[9router](https://github.com/decolua/9router)** forki va Go loyihasi **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** ning TypeScript porti sifatida boshlangan — shundan soʻng quyidagi har bir quyi tizim bu yoʻlni avval bosib oʻtgan ochiq manbali loyihadan ilhomlangan. Ularning har biri OmniRoute’ning muayyan bir qismini shakllantirdi. Bu — ularning barchasiga bildirgan tashakkurimiz. 🙏 > ⭐ yulduzlar soni 2026-yil 18-oktyabrda GitHub REST API orqali tekshirilgan — bu loyihalarga yulduz qoʻyib qoʻying. Koʻrsatkichlar muayyan sanadagi aniq holatni aks ettiradi va tabiiy ravishda oʻzgaradi. ### 🧬 Kelib chiqish & shlyuz

Loyiha	⭐	U OmniRoute’ga qanday ilhom berdi
9router	31,004	Ushbu fork asoslangan asl loyiha — bu yerda multimodal API’lar bilan kengaytirilib, TypeScript’da toʻliq qayta yozilgan.
CLIProxyAPI	55,591	Ushbu JavaScript / TypeScript portiga ilhom bergan Go implementatsiyasi.
LiteLLM	61,482	Ommaviy narxlar maʼlumotlar toʻplami xarajatlarni kuzatish sinxronizatsiyamizni taʼminlaydigan va provayderlarni normallashtirish modeli marshrutlashimizga asos boʻlgan AI shlyuzi.
codex-chatgpt-web	14,526	ChatGPT Web → Codex Responses ichki koʻprigiga moslashtirilgan MIT manba kodi, jumladan brauzer sessiyasi, javoblarni freymlash, foydalanish va veb-qidiruv adapterlari.
free-claude-code	61,430	Oqimni tiklash, fikrlashsiz taxalluslar, zaxira veb-qidiruv, sirgʻaluvchi oyna cheklovlari, jurnallardagi maxfiy maʼlumotlarni yashirish va mustahkamlangan ishga tushirish jarayonlariga koʻchirilgan andozalar.
composer-api	346	Mahalliy Cursor ijrochisiga moslashtirilgan Cursor Composer vosita tanlash, chiqishni cheklash va vositani tasdiqlash andozalari.
codex-multi-auth	553	Codex OAuth qayta autentifikatsiyasiga koʻchirilgan yangidan kirish va yangilash tokenini almashtirish andozalari.
opencode-anthropic-auth	558	Claude Code bilan mos transformatsiya standartlari va billing sarlavhasi xatti-harakati OmniRoute’ning konfiguratsiya orqali boshqariladigan koʻprigida umumlashtirilgan.
grok2api-merged	2	Uning Grok model xaritalashlari, soxta TypeError Statsig generatori, soʻrov va qurilma standartlari hamda NDJSON javob protsessori OmniRoute’ning Grok Web ijrochisiga sezilarli darajada moslashtirilgan.
TQZHR/grok2api	706	grok2api-merged ortidagi asosiy bilvosita kod manbasi; uning model, sarlavha, foydali yuk, Statsig va protsessor implementatsiyalari Grok Web kelib chiqish zanjirida saqlangan.
chenyme/grok2api	7,819	Grok foydali yuki va qurilma standartlari, Statsig generatori hamda TQZHR va grok2api-merged orqali oʻtgan `result.response` protsessori uchun asos boʻlgan MIT manba kodi.
grok2api-pro	27	Proksi-pul qatlami uchun grok2api-merged tomonidan eʼtirof etilgan bilvosita manba; OmniRoute ushbu kelib chiqish qaydini saqlaydi, ammo oʻzining chegaralangan Grok Web ijrochisida proksi-pul porti mavjudligini daʼvo qilmaydi.
GrokProxy	51	Uning cookie orqali autentifikatsiya qilinadigan Grok proksisi va `result.response.token` oqim uzatish andozasi OmniRoute’ning Grok Web transportiga asos boʻldi.
GrokBridge	5	Grok Web’ning dastlabki implementatsiyasi uning HTTP/brauzer yuqori oqim dizaynidan foydalangan; uning toʻgʻridan-toʻgʻri HTTP yoʻli GrokProxy’dan kelib chiqqani sababli mustaqil kod porti borligi daʼvo qilinmaydi.

### 🗜️ Kontekst & tokenlarni siqish — dvigatellar

Loyiha	⭐	U OmniRoute uchun qanday ilhom berdi
Caveman	113,396	Virusdek tarqalgan “nega ko‘p token ishlatish, oz token ishni bajaradi” loyihasi — uning g‘or odami nutqi falsafasi standart siqish rejimimiz va 30 dan ortiq ortiqcha so‘zlarni olib tashlash/ixchamlashtirish qoidalarimiz asosini tashkil etadi.
RTK – Rust Token Killer	83,835	Buyruq chiqishini yuqori unumdorlik bilan siqish — RTK dvigatelimiz, JSON filtrlash DSL’i, xom chiqishni tiklash va ketma-ket RTK → Caveman konveyerimiz uchun ilhom berdi.
headroom	75,741	Qaytariladigan kontekst siqilishi (SmartCrusher) — `headroom` dvigatelimiz va `ccr` olish-marker andozamiz uchun ilhom berdi.
LLMLingua	6,757	Promptlarni siqish bo‘yicha tadqiqot (LLMLingua / LLMLingua-2) — asinxron, kod uchun xavfsiz va xatoda ochiq qoluvchi `llmlingua` dvigatelimiz uchun ilhom berdi.
llmlingua-2-js	32	LLMLingua dvigatelimiz uchun worker-thread backendi sifatida ishlatiladigan JS/ONNX porti (MobileBERT / XLM-RoBERTa).
Troglodita	50	PT-BR tokenlarini siqish — pt-BR til paketimizni quvvatlaydi: Braziliya portugal tili grammatikasiga moslashtirilgan pleonazmlarni qisqartirish va ortiqcha so‘zlarni olib tashlash.
ponytail	166,731	Virusdek tarqalgan “dangasa katta dasturchi” YAGNI-kodlash ko‘nikmasi — less-code Chiqish uslubimiz uchun ilhom berdi: _yaratiladigan_ kodni qisqartiruvchi, ishlaydigan eng kichik o‘zgarishga yo‘naltirish (Caveman’ning lo‘nda nasriga chiqish o‘qi bo‘yicha qardosh).
i-have-adhd	57,628	Uning avvalo harakatga yo‘naltirilgan, ADHD uchun qulay javob uslubi OmniRoute’ning besh tildagi ixcham chiqish uslubiga moslashtirildi.

### 🧩 Ixcham formatlar, token tadqiqotlari va kodni hisobga oluvchi vositalar

Loyiha	⭐	U OmniRoute uchun qanday ilhom berdi
TOON	25,509	Tokenlarga yo‘naltirilgan obyekt notatsiyasi — uning ustunli, sarlavha-va-qatorlar modeli jadval asosidagi ixchamlashtirish bosqichimizni shakllantirdi.
GCF – Graph Compact Format	59	Uning ixcham grafik formati va umumiy profil dizayni OmniRoute’ning jadval asosidagi ixchamlashtirishi hamda Headroom kodek formatiga ta’sir ko‘rsatdi.
gcf-typescript	4	Headroom umumiy profil kodeki sifatida bevosita loyihaga qo‘shilgan va kengaytirilgan MIT TypeScript implementatsiyasi.
token-optimizer-mcp	551	Brotli/SQLite keshi + har bir sessiya uchun kontekst farqi — `session-dedup` dvigatelimiz uchun ilhom berdi.
token-savior	1,182	Bash chiqishini ixchamlashtirish + MCP profillari — siqishdan voz kechish intizomimiz va MCP vosita manifestini qisqartirishimiz uchun ilhom berdi.
token-saver	154	Kontentni hisobga oluvchi, har bir fayl turi uchun chiqishni siqish hamda xatolarni hisobga olib siqishdan voz kechish — tur bo‘yicha taqsimlashimiz va minimal yutuq bo‘lmasa o‘tkazib yuborishimiz to‘g‘riligini tasdiqladi.
token-optimizer	2,595	“Ko‘rinmas tokenlarni toping” — uning tashqariga ko‘chirish + tiklanadigan identifikator andozasi CCR orqali tashqariga ko‘chirish yondashuvimizga ta’sir ko‘rsatdi.
TokenMizer	33	Sessiya grafigi + navbatlararo qator deduplikatsiyasi andozasi session-dedup dizaynimizga ta’sir ko‘rsatdi.
OmniCompress	3	Rust ustunli-JSON + kontent bo‘yicha manzillangan olish + xabarlararo deduplikatsiya — `headroom`/`ccr`/`session-dedup` dvigatellarimiz dizayni va kesh uchun barqaror “siqilgan shakl joylashuvga bog‘liq emas” invariantini tasdiqladi.
mcp-compressor	133	MCP vosita sxemasi/tavsifini siqish — MCP vosita manifesti kardinalligini kamaytirishimizga ta’sir ko‘rsatdi.
RepoMapper	217	Aider uslubidagi repozitoriy xaritasini reytinglash — repozitoriy xaritasi / olishni reytinglash bo‘yicha izlanishimizga ta’sir ko‘rsatdi.
quiet-shell-mcp	4	MCP orqali deklarativ shell chiqishini qisqartirish — deklarativ bash chiqishini ixchamlashtirishimiz to‘g‘riligini tasdiqladi.
ts-morph	6,205	TypeScript Compiler API vositalar to‘plami — satr, shablon va regex literallarini saqlab qoluvchi parser asosidagi izohlarni olib tashlashimiz uchun ilhom berdi.

### 🧠 Xotira va RAG

Loyiha	⭐	U OmniRouteʼga qanday ilhom berdi
Mem0	67,385	Universal xotira qatlami — uning proksi orqali yozish/oʻqish chegarasi modeli xotira arxitekturamizni shakllantirdi.
Letta (MemGPT)	25,179	Darajali xotiraga ega holatli agentlar — Context Control & Recovery (CCR) darajali modelimiz uchun ilhom manbai boʻldi.
WFGY	1,800	Takrorlanuvchi 16 ta RAG/LLM nosozlik rejimining ProblemMap taksonomiyasi — nosozliklarni bartaraf etish boʻyicha qoʻllanmamizdagi umumiy atamalar majmuasi.

### 🛰️ Trafikni tekshirish, MITM va shaffof proksi

Loyiha	⭐	U OmniRouteʼga qanday ilhom berdi
llm-interceptor	79	Kodlash yordamchisi ↔ LLM trafigining MITM orqali ushlanishi/tahlili Traffic Inspectorʼning dastlabki talablarini shakllantirishga yordam berdi. Avval undan kelib chiqqan toʻrtta modul — SSE birlashtirish, suhbatlarni meʼyorlashtirish, maxfiy maʼlumotlarni niqoblash va sarlavhalarni tozalash — ommaviy protokol standartlariga asoslangan mustaqil clean-room implementatsiyalari bilan almashtirildi. Xostni toʻgʻridan-toʻgʻri oʻtkazuvchi ikkita yuza (`passthrough.ts` va `_internal/bypass.cjs`) alohida tasniflangan OmniRoute ichki implementatsiyalari sifatida qolmoqda; ular ushbu almashtirish doirasida qayta yozilmagan.
ProxyBridge	6,814	Har bir jarayon uchun shaffof proksi marshrutlash — nosozlikka chidamli MITM oʻchirilishi, soketning bekor turish taym-autlari, `/proc` orqali jarayonni aniqlash va TPROXY trafik tutish mexanizmlarimiz uchun ilhom manbai boʻldi.

### 📚 Model maʼlumotlari, kuzatuvchanlik va UI

Loyiha	⭐	U OmniRouteʼga qanday ilhom berdi
models.dev	7,286	AI modellari xususiyatlari, narxlari va imkoniyatlarining ochiq maʼlumotlar bazasi — model katalogimizga bevosita sinxronlanadi.
React Flow / xyflow	38,705	Real vaqt rejimidagi Compression Studio va Combo/Routing Studioʼmizni ishlatuvchi tugunlarga asoslangan grafik kutubxonasi.
LangGraph	43,443	LangGraph Studioʼning ish jarayoni grafigini jonli vizuallashtirishi Studioʼlarimizdagi real vaqt kaskad koʻrinishi uchun ilhom manbai boʻldi.
Langfuse	35,990	Uning kuzatuv → oraliq → generatsiya kuzatuvchanlik modeli Compression Studioʼmizdagi waterfall koʻrinishini shakllantirdi.
Kiali	3,645	Istio xizmatlar toʻri kuzatuvchanligi — Routing/Combo Studioʼdagi circuit-breaker nishonlari va xato qirralari vizuallari uchun ilhom manbai boʻldi.
lobe-icons	2,615	Boshqaruv panelimiz boʻylab provayder ikonalarini aks ettiradigan AI/LLM brend logotiplari.
flag-icons	12,473	README til tanlagichida ishlatiladigan MIT litsenziyali SVG bayroqlarini taqdim etadi.

### 🛡️ Xavfsizlik

Loyiha	⭐	U OmniRouteʼga qanday ilhom berdi
awesome-secure-defaults	722	Xavfsizlik boʻyicha tanlovlarimizga yoʻl koʻrsatuvchi, standart holatda xavfsiz kutubxonalarning saralangan roʻyxati (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).

### 🧭 Qoʻshimcha vositalar

Loyiha	⭐	U OmniRouteʼga qanday ilhom berdi
ClawRouter	6,628	Soʻrovlarni takroriy nusxalardan tozalash, favqulodda nol xarajatli zaxira variant, ulanadigan Auto-Combo strategiyalari va koʻp tilli niyat tasnifi uchun ilhom manbai boʻldi.
Antigravity-Manager	32,333	Uning akkauntni hisobga oluvchi modelni qayta xaritalash, bajariladigan fayl yoʻlini tekshirish va tarif yorligʻi xatti-harakati OmniRouteʼning Antigravity bajarilish muhitini shakllantirishga yordam berdi.
vscode-antigravity-cockpit	4,850	Uning kvotani tiklashgacha qolgan vaqtni ixcham koʻrsatish formati OmniRouteʼdagi provayder limitining tegishli koʻrinishi uchun ilhom manbai boʻldi.
AionUi	33,611	Uning ACP integratsiyalari OmniRouteʼda oʻrnatilgan CLI agentlarini avtomatik aniqlash uchun ilhom manbai boʻldi.
CodexBar	22,616	Grok Build kvota interfeysini aniqladi; soʻng OmniRoute real uzatish formatini mustaqil ravishda tekshirib, tuzatdi.

## 📄 Litsenziya MIT Litsenziyasi — batafsil ma'lumot uchun [LICENSE](LICENSE) ga qarang. ---

**[⬆ Yuqoriga qaytish](#-omniroute)** · Ochiq kodli AI hamjamiyati uchun ❤️ bilan yaratilgan. _{OmniRoute v3.8.53 · Node ≥22.22.2 · MIT Litsenziyasi · omniroute.online}