# 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 **[Diego Souza](https://github.com/diegosouzapw) tomonidan yaratilgan**

OmniRoute — Kod yozishni hech qachon to‘xtatmang. Har bir AI vositasi → bitta endpoint orqali 388 ta provayder — 150+ tasi bepul. Claude Code, Codex, Cursor, Cline, Copilot va Antigravity → bepul Claude / GPT / Gemini xizmatlariga avtomatik qayta yo‘naltirish bilan. RTK + Caveman kombinatsiyalangan siqish usuli tokenlarni 15–95% ga (~89% o‘rtacha) tejaydi — limitlarga hech qachon duch kelmang. 388 ta AI provayderi · 150+ ta bepul tarif · oyiga ~1,62 mlrd bepul token · 20 ta yo‘naltirish strategiyasi · boshlash uchun $0.

## 💰 Uchinchi tomon bepul tariflari bo‘yicha oyiga ~1,62 mlrd token

> **Provayder hisoblaringizdan foydalaning.** Bu alohida mos keluvchi uchinchi tomon bepul tariflari bo‘yicha taxminiy jamlanma bo‘lib, OmniRoute tomonidan beriladigan token granti emas. Ro‘yxatdan o‘ting, kerak bo‘lsa hisob ma’lumotlarini oling va foydalanishingiz mumkin bo‘lgan provayderlarni ulang; har bir provayder o‘z limitlari, mavjudligi va shartlarini belgilaydi. > > Bepul tariflarni qo‘lda jamlash juda noqulay — o‘nlab SDKlar, o‘nlab tezlik cheklovlari va amalda qancha imkoniyatingiz borligini bilmaslik. OmniRoute **34 ta takrorlanuvchi kvota kaliti bo‘yicha 465 ta bepul tarif yozuvini** kataloglaydi va token ko‘rsatkichini **ijobiy e’lon qilingan oylik budjetga ega 17 ta kvota hamda model bo‘yicha beshta Groq limiti** asosida, umumiy kvotani takroran hisoblamagan holda hisoblaydi. Faqat hududiy shaxsni tasdiqlashdan keyin ochiladigan kvotalar (bugungi kunda: ModelScope) alohida ko‘rsatiladi, hududiy shaxsni tasdiqlash ortidagi yana ~6 mln token qo‘shiladi, ammo asosiy ko‘rsatkichga jamlanmaydi. Natija boshqaruv panelida (`/dashboard/free-tiers`) ko‘rinib turadi.

OmniRoute bepul tarif budjeti kartasi: oyiga barqaror ~1,62 mlrd bepul token, ro‘yxatdan o‘tish kreditlari bilan birinchi oyda ~2,22 mlrd gacha; barchasi bitta endpoint ortidagi 34 ta hujjatlashtirilgan takrorlanuvchi kvota kalitini qamrab oluvchi 465 ta kataloglangan bepul tarif yozuvidan iborat. Halol, kvota takrorlanishisiz hisob-kitob — har bir umumiy kvota faqat bir marta hisoblanadi; bunga ijobiy e’lon qilingan oylik token budjetiga ega 17 ta takrorlanuvchi kvota hamda model bo‘yicha beshta Groq limiti kiradi; shartlar xavfi katalogida 12 ta provayderdan foydalanmaslik tavsiya etilgan, shuning uchun qarorni o‘zingiz qabul qilasiz. Budjet paneli Mistral 1 mlrd, Nara 210 mln, LLM7 150 mln, xKiro 150 mln, Groq 30 mln (model bo‘yicha beshta limit) va kichikroq kvotalarni, shuningdek birinchi oy ro‘yxatdan o‘tish kreditlari hamda token limiti bo‘lmagan, doimiy bepul provayderlarni o‘z ichiga oladi; ular asosiy ko‘rsatkichni hech qachon sun’iy ravishda oshirmasligi uchun alohida ko‘rsatiladi. /dashboard/free-tiers sahifasida amaldagi foydalanilgan/qolgan miqdor.

> Jonli `/dashboard/free-tiers` sahifasining animatsiyali xulosasi. To‘liq metodologiya (kvotalarni takroran hisoblamaslik, kredit darajalari, provayder shartlari): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**. > > _{Bu raqamlar har ikki haftada jonli katalog asosida qayta tekshiriladi va **har ikki yo‘nalishda ham o‘zgaradi** — provayder bepul tarifni bekor qilsa, raqam kamayadi; yangisi qo‘shilsa, oshadi. Biz katalog amalda hisoblagan qiymatni e’lon qilamiz, yaxlitlangan eng yaxshi holatni emas.}

OMNIROUTE sizga pul tejash va ishingizni osonlashtirishda yordam bergan bo‘lsa, repoga ⭐ bosing.

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

[![Yulduzlar tarixi reytingi](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) ### 💬 Hamjamiyatga qo‘shiling **👋 Loyiha yurituvchisiga obuna bo‘ling — yangi provayderlar, relizlar va maslahatlarni birinchi bo‘lib oling:** [![Diegoni LinkedIn’da kuzatish](https://img.shields.io/badge/Follow_Diego_on-LinkedIn-0A66C2?style=for-the-badge&logo=linkedin&logoColor=white)](https://www.linkedin.com/in/diegosouzapw/) [![GitHub’da @diegosouzapw’ni kuzatish](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) [![Veb-sayt](https://img.shields.io/badge/Website-omniroute.online-blue?logo=google-chrome&logoColor=white)](https://omniroute.online) **Savollar, provayderlar bo‘yicha maslahatlar, yo‘l xaritasi 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)**
## 📈 Shlyuz rivojlanishda davom etmoqda

| | v3.8.50 | **v3.8.51** | `v3.8.54+` | | ----------------------------------------- | :------------------------: | :---------: | :----------------------: | | 🌐 Provayderlar | 352 | **358** | 388 | | 🧠 Noyob chat modeli identifikatorlari | 1320 | **1374** | 1491 | | 🖼️ Modalitet ko‘prigi | 🆕 ko‘rish + audio + video | ✓ | ✓ | | 📡 Radar bepul katalogi | 🆕 ixtiyoriy | ✓ | ✓ | | ⚖️ Kvotani hisobga oluvchi rejalashtirish | 🆕 Quota-Share | ✓ | ✓ | | 📊 Kvota telemetriyasi | 🆕 jonli | ✓ | ✓ | | 🧰 Boshqaruvsiz rejim | — | — | 🆕 `serve --headless` | | 🛤️ LTS rail infratuzilmasi | — | — | 🆕 chiqarilish kanallari | | 🔎 Modelni aniqlash API'si | — | — | 🆕 `/v1/models/query` | **→ [Yo‘l xaritasi](ROADMAP.md) — `v3.9.0 LTS` tomon rail bo‘ylab harakatlaning**

## 🧩 Mavjud [![npm version](https://img.shields.io/npm/v/omniroute?color=cb3837&logo=npm)](https://www.npmjs.com/package/omniroute) ![NPM Monthly](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) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](LICENSE) ![Docker Pulls](https://img.shields.io/docker/pulls/diegosouzapw/omniroute?label=docker%20pulls&logo=docker&color=2496ED) ![Electron Downloads](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	🏆 Uni ajratib turadigan jihatlar
⚙️ Imkoniyatlar	🎯 Kombolar	🌐 Provayderlar	🔌 CLI va MCP
	🗜️ Siqish	🖥️ Qayerda ishlaydi	🔒 Maxfiy
👀 Koʻring	🎬 Amalda	✨ Yangiliklar	🤖 Mos keluvchi CLI'lar
💚 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 vositangizni OmniRoute API kaliti va model auto yordamida localhost:20128/v1 manziliga yoʻnaltiring. Yoʻnaltirish mavjud mos ulanishlar va provayder cheklovlariga bogʻliq.

```bash # Provayderni ulagandan soʻng OmniRoute kalitingizni Boshqaruv paneli → Endpointlar 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ʻrnatilgan tizimda kalitsiz mos maqsadlar boʻlmasligi mumkin va kalitsiz provayder uchinchi tomon mijozlarini rad etishi mumkin. `tos: avoid` bilan belgilangan provayderlar, jumladan Kiro, sukut boʻyicha 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-joylash mumkin boʻlgan tezkor ishga tushirish skriptlari → [`examples/quickstart/`](examples/quickstart/)}

# 💥 Vaʼda

# 🤔 Nega OmniRoute?

OmniRoute soʻrovi oqimi: IDE yoki CLIʼngiz (Claude Code, Cursor, Cline…) bitta lokal endpointʼga (http://localhost:20128/v1) murojaat qiladi; OmniRoute Smart Router (RTK + Caveman siqishi, 20 ta yoʻnaltirish strategiyasi, circuit breakerlar, TLS stealth, MCP, A2A, guardrails) mos va sogʻlom maqsad mavjud ekan, 4 ta provayder pogʻonasi boʻylab zaxira yoʻnaltirishi mumkin — 1-pogʻona Obuna, 2-pogʻona API kaliti, 3-pogʻona Arzon va 4-pogʻona 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’ni ajratib turadigan jihatlar

_{📊 9router, OpenRouter, CLIProxyAPI va LiteLLM bilan to‘liq metodologiya va har bir imkoniyat tafsilotlari → [`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.

## ✨ Yangiliklar

> **v3.8.20 → v3.8.54** versiyalari orasidagi so‘nggi muhim yangiliklar. To‘liq tarix [`CHANGELOG.md`](CHANGELOG.md) faylida. - **⚖️ `quota-weighted` yo‘naltirish** — 20-kombinatsiyali strategiya kvotasi tugagan hisoblarni chetlab o‘tadi, so‘ng qolganlari orasidan qolgan kvota ÷ jarayondagi yuklama nisbatiga muvofiq tanlaydi va mavjud suhbatlarni biriktirilgan holda saqlaydi. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🧰 Headless rejim** — `omniroute serve --headless` (yoki `OMNIROUTE_HEADLESS=1`) faqat `/v1/*` proksi dvigatelini ishga tushiradi, dashboard va faqat dashboardga tegishli quyi tizimlarni o‘chiradi. → [Headless rejim](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‘rinuvchanlik qoidalari asosida qisqa, deterministik modellar ro‘yxatini qaytaradi. → [API ma’lumotnomasi](docs/reference/API_REFERENCE.md) - **🔑 Kalit bo‘yicha yo‘naltirish boshqaruvi** — API kalitini `forcedModel` orqali bitta model yoki kombinatsiyaga biriktiring va kalit modellar hamda kombinatsiyalarini atomar tarzda qo‘shing yoki olib tashlang (`/api/keys/{id}/access`). → [API ma’lumotnomasi](docs/reference/API_REFERENCE.md) · [OpenAPI](docs/openapi.yaml) - **🛡️ Aniqroq PII boshqaruvi** — har bir tur bo‘yicha tanlash, tasdiqlangan 20 tagacha maxsus niqoblash andozalari va tur bo‘yicha aniqlash hisoblagichlari; niqoblashning o‘zi esa ixtiyoriyligicha qoladi. → [Himoya qoidalari](docs/security/GUARDRAILS.md) - **🌍 67 ta til** — dashboard, hujjatlar nusxalari va CLI uchun; `npm run i18n:add-locale` esa bitta buyruq orqali tilni barcha joyga qo‘shadi. → [i18n qo‘llanmasi](docs/guides/I18N.md) - **🎛️ OmniConductor** — agentlar flotiga kiruvchi A2A delegatsiyasi, Agent Card’dagi Conductor ko‘nikmalari va Faro push-to-talk ovozli chatiga ega dashboard paneli. → [A2A serveri](docs/frameworks/A2A-SERVER.md) - **🛂 Moslashuvchan qabul qilish va ortiqcha yuklamadan himoyalanish** — og‘ir chat so‘rovlari 503 xatosi bilan rad etilish o‘rniga navbatga qo‘yiladi, har bir ulanish uchun RPM bo‘yicha atomar sirpanuvchi ijaralar qo‘llanadi. → [Barqarorlik qo‘llanmasi](docs/architecture/RESILIENCE_GUIDE.md) - **🗂️ Kanonik `/v1/models` tartibi** — har bir provayder uchun provayder bo‘yicha guruhlangan bitta uzluksiz blok (kombinatsiyalar avval) barcha katalog manbalarida barqaror saqlanadi. → [API ma’lumotnomasi](docs/reference/API_REFERENCE.md) - **🗜️ Siqishni kuchaytirish** — sukut bo‘yicha yoqilgan kengayishdan himoya, DE / FR / JA + xitoy tili (wényán) uchun Caveman paketlari, Gradle va .NET uchun RTK filtrlari. → [Siqish](docs/compression/COMPRESSION_ENGINES.md) - **💸 Rostgo‘y bir tekis tarif narxi** — obuna / kodlash-reja provayderlari xarajatlar tahlilida **$0** sifatida ko‘rsatiladi; budjet, kvota va yo‘naltirish hisob-kitobni davom ettiradi. → [API ma’lumotnomasi](docs/reference/API_REFERENCE.md) - **⚖️ Quota-Share yo‘naltirishi** — umumiy hisob kvotasini jamlangan kalitlar o‘rtasida adolatli taqsimlaydi; ishlamayotgan qismlar boshqa foydalanishlarga beriladi. → [Barqarorlik qo‘llanmasi](docs/architecture/RESILIENCE_GUIDE.md) - **🤖 Bir buyruqli CLI/agent sozlamasi** — 15 ta ro‘yxatdan o‘tgan `setup-*` buyrug‘i; `omniroute run` 7 ta CLI’ni ishga tushiradi (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); `omniroute configure` interaktiv provayder+model tanlagichi va har bir kontekst uchun sevimlilar bilan 11 ta nishonni qo‘llab-quvvatlaydi. → [CLI integratsiyalari](docs/guides/CLI-INTEGRATIONS.md) - **🛰️ Masofaviy rejim** — cheklangan doiradagi tokenlar (`connect` / `contexts` / `tokens`) yordamida masofaviy OmniRoute’ni boshqaring; VPS o‘rnatishlari uchun `antigravity` OAuth yordamchisi mavjud. → [Masofaviy rejim](docs/guides/REMOTE-MODE.md) - **🧭 Aqlliroq avtomatik yo‘naltirish** — `auto/:` kombinatsiyalari, **Fusion** (modellar paneli + hakam), vazifaga mos yo‘naltirish, har bir so‘rov uchun model / rejim / USD-budjetni qayta belgilash. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🗜️ Ulanadigan siqish** — 12 ta kombinatsiyalanadigan dvigatel va Compression Studios: LLMLingua-2, ikki darajali Ultra, omniglyph, har bir qadam uchun aniqlik darvozasi, GCF v3.2, sudrab qayta tartiblash muharriri. → [Siqish](docs/compression/COMPRESSION_ENGINES.md) - **🕵️ Shaffof MITM deshifrlash (TPROXY)** — proksi muhit o‘zgaruvchilarini e’tiborsiz qoldiradigan CLI’larni ushlash, har bir SNI uchun CA va ishonch do‘koni o‘rnatuvchisi bilan. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md) - **💸 Har joyda xarajat telemetriyasi** — har bir endpoint’da `X-OmniRoute-*` xarajat/foydalanish sarlavhalari, kesh-HIT tejalishi sarlavhasi, har bir kalit uchun USD xarajat kvotalari. → [API ma’lumotnomasi](docs/reference/API_REFERENCE.md) - **🧠 Siz boshqaradigan xotira** — sukut bo‘yicha o‘chirilgan, ixtiyoriy int8 vektor kvantlash + tiplashtirilgan so‘nish, har bir so‘rov uchun `x-omniroute-no-memory`. → [Xotira](docs/frameworks/MEMORY.md) - **🛡️ Xavfsizlik** — har bir LLM yo‘nalishida prompt-inyeksiya himoyasi (red-team to‘plami), ixtiyoriy credential-masking himoya qoidasi (sizib chiqqan API kalitlari/maxfiy ma’lumotlarni har ikki yo‘nalishda redaktalaydi), bepul DuckDuckGo so‘nggi chora sifatidagi veb-qidiruvi va dashboard uchun ixtiyoriy OIDC kirish darvozasi (parol orqali kirish har doim mavjud bo‘lib qoladi). → [Himoya qoidalari](docs/security/GUARDRAILS.md) - **🖼️ Yangi endpointlar** — `/v1/ocr` (Mistral OCR) va `/v1/audio/translations` (Whisper uslubidagi) media imkoniyatlarini to‘ldiradi. → [API ma’lumotnomasi](docs/reference/API_REFERENCE.md) - **🎨 Rasm / video / audio generatsiyasi** — media uchun yagona API: xAI Grok Imagine va Novita AI video, ComfyUI, Magnific, Adobe Firefly, Segmind hamda ElevenLabs kabi nutq provayderlari. → [API ma’lumotnomasi](docs/reference/API_REFERENCE.md) - **🌍 Joylashtirish va operatsiyalar** — reverse-proxy `basePath`, brauzer tilini avtomatik aniqlash, kalit bo‘yicha qurilma kuzatuvi, root’siz MITM ishonchi, zh-TW lokalizatsiyasi. → [Muhit](docs/reference/ENVIRONMENT.md) - **🤝 Ko‘proq provayderlar va agentlar** — bulut agentlari (Codex Cloud, Cursor, Devin, Jules), brauzer + OAuth orqali kirishga ega Grok Build (xAI), birinchi darajali Ollama kartasi, Claude Opus 5 va Sonnet 5, Kimi bilan rasmiy hamkorlik (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… hamda yangilangan **388 provayderli katalog**. → [Provayderlar](docs/reference/PROVIDER_REFERENCE.md) - **📡 Yo‘naltirish shaffofligi** — har bir javobda unga xizmat ko‘rsatgan strategiya/provayder/kechikish nomlarini ko‘rsatuvchi `X-OmniRoute-Decision` sarlavhasi mavjud; yangi `cache-optimized` kombinatsiya strategiyasi va Auto-Combo `cacheAffinity` omili takroriy so‘rovlarni keshlangan prefiksni saqlayotgan ulanishga qayta yo‘naltiradi; faqat o‘qish uchun mo‘ljallangan `/v1/auto-combo/{channel}/candidates` endpointi esa `auto/*` kanalining joriy nomzodlar havzasini ochib beradi. → [Auto-Combo](docs/routing/AUTO-COMBO.md). - **⚡ Lokal unumdorlik va infratuzilma** — bir marta bosish bilan lokal Redis, Cloudflare Workers / Deno Deploy relay deployerlari, nazorat qilinadigan Bifrost va Mux o‘rnatilgan xizmatlar sifatida. → [O‘rnatilgan xizmatlar](docs/frameworks/EMBEDDED-SERVICES.md) - **🧩 To‘plamda yana** — plaginlar freymvorki va marketplace, Omni/Agent/GitHub ko‘nikmalar freymvorklari, Obsidian vault integratsiyasi (22 ta MCP vositasi), OpenAI bilan mos Batch va Files API’lari, semantik javob keshi, yetakchilar jadvali bilan geymifikatsiya, ACP agentlarini aniqlash (o‘rnatilgan 15 ta agent), BigQuery’ga rejalashtirilgan log eksporti, `auto/chaos` parallel ko‘p modellli fan-out, Telegram bot ko‘prigi, ilova ichidagi versiyalar menejeri va LMArena-ELO bepul provayderlar reytingi. → [Hujjatlar](docs/README.md)

## 🤖 Mos keluvchi CLI va Kod yozuvchi Agentlar > Bitta konfiguratsiya — `http://localhost:20128/v1` — va **har qanday** AI IDE yoki CLI bepul va arzon modellar bilan 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

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

_{📖 Har bir 39 ta vosita uchun alohida sozlash (28 ta CLI Code'lar + 11 ta CLI Agentlar) → [`docs/reference/CLI-TOOLS.md`](docs/reference/CLI-TOOLS.md) · 🧩 OpenCode plagin → [`@omniroute/opencode-provider`](https://www.npmjs.com/package/@omniroute/opencode-provider)}

**OmniRoute orqali istalgan qo‘llab-quvvatlanadigan CLI ni bitta buyruq bilan ishga tushiring** — hech qanday konfiguratsion fayllar yozilmaydi, har bir jarayon uchun maxfiy ma’lumotlar kiritiladi, Qwen/Gemini uchun vaqtinchalik izolyatsiyalangan home: ```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 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 hisobga oladi (`omniroute connect `), `--dry-run` aniq muhit/argumentlarni bajarilmasdan oldindan ko‘rsatadi, va `--api-key-env NAME` maxfiy ma’lumotlarni shell tarixidan tashqarida saqlaydi. → [CLI Integratsiyalari](docs/guides/CLI-INTEGRATIONS.md)

## 🌐 388 ta AI provayderi — katalogda belgilangan 153 ta bepul

> **388 ta roʻyxatdan oʻtgan provayder** kanonik chat, media, qidiruv, lokal, bulut agenti va tizim toʻplamlari boʻylab mavjud, ulardan **153 tasi `hasFree: true` aniqlash metamaʼlumotlariga ega**. Chat modellari reyestri **239 ta provayder / 3,059 ta noyob provayder-model juftligi / 1,475 ta xom model ID**ni qamrab oladi; alohida bepul byudjet katalogida esa **har bir model uchun 471 ta qator**, **34 ta takrorlanuvchi havza** va **52 ta takrorlanuvchi/kalitsiz, abadiy bepul provayder** mavjud. Bular ataylab turli maxrajlardir; taʼriflar va havzalar dublikatlari olib tashlangan hisob-kitoblar [Provayder maʼlumotnomasi](docs/reference/PROVIDER_REFERENCE.md) hamda [Bepul tariflar](docs/reference/FREE_TIERS.md)da keltirilgan.

### 🏢 Barcha yirik laboratoriyalar — 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 dan ortiq provayder — har bir ikonka boshqaruv panelining provayderlar katalogidan jonli tarzda yuklanadi. 📖 [Provayder maʼlumotnomasi](docs/reference/PROVIDER_REFERENCE.md)}
### 🆓 Abadiy bepul — $0, karta kerak emas

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

📖 Mashina oʻqiy oladigan toʻliq katalog → [`docs/reference/PROVIDER_REFERENCE.md`](docs/reference/PROVIDER_REFERENCE.md)

## 🖥️ Qayerda OmniRoute ishlaydi — Har qanday joyda

> Xuddi shu dastur, sizning mashinangiz, sizning qoidalaringiz. Global npm o'rnatishdan **telefoningiz** Termux orqali.

Platforma	O'rnatish	Tavsif
📦 npm (global)	`npm o‘rnatish -g omniroute`	Bitta buyruq, har qanday OS
⚡ Bun (global)	`bun add -g omniroute`	Xuddi shu registr tarball, tezroq o‘rnatish
🐳 Docker	`docker run … diegosouzapw/omniroute`	Multi-arch AMD64 + ARM64
🖥️ Desktop (Electron)	`npm run electron:build`	Mahalliy + tizim tepsisi — Windows / macOS / Linux
🎩 Menyu-bar (OmniRouteTray)	`brew o‘rnatish --cask zoispag/tap/omniroute-tray`	& serverni avtomatik yangilashini nazorat qiladi — macOS
💪 ARM	mahalliy `arm64`	Raspberry Pi, ARM serverlari, Apple Silicon
📱 Android (Termux)	`pkg install nodejs && npx -y omniroute`	Telefoningizda ishlaydi , 24/7, root
📲 PWA	"Bosh ekranga qo‘shish"	To‘liq ekran, oflayn, brauzerdan o‘rnatilishi mumkin
🧩 OpenCode plagin	`@omniroute/opencode-provider`	Native OpenCode integratsiyasi
🤖 VS Code Copilot Chat	o‘rnatish OmniCopilot kengaytmasi	Mahalliy Copilot har bir OmniRoute modeli Chat tanlagich — barqaror & Insiderlar
🛠️ Manbadan	`npm install && npm run dev`	Hack on it, hissa

_{📖 [Docker qo‘llanma](docs/guides/DOCKER_GUIDE.md) · [Ish stoli](electron/README.md) · [Menyu-bar laganda](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 ichidagi VS Code Copilot Chat

> Yangi yon panel yo'q, yangi chat UI yo'q — har bir OmniRoute xizmat modeli to'g'ridan-to'g'ri ekranda ko'rinadi **Siz allaqachon foydalanayotgan Copilot Chat modeli tanlagichi** . VS Code 1.122 dan beri provayder modellari GitHub tizimiga kirish yoki Copilot obunasisiz ishlaydi — agent rejimi, asboblarni chaqirish va ko‘rish, bepul. **[OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)** kengaytmasini o'rnating, uni OmniRoute serveringizga yo'naltiring (birlamchi `localhost:20128` ga), keyin Copilot Chat → model tanlash → oching. **Modellarni boshqarish…** → **OmniRoute** .

Do'kon	Havola	Mos keladi
🧩 VS Code Marketplace	O'rnatish →	VS Code — barqaror & Insiders
🔓 VSX Open Registry	O'rnatish →	Cursor, Windsurf, VSCodium, Theia, code-server, Antigravity, Kiro

Muharrir ichidan: **Kengaytmalar** ko'rishni oching, "OmniRoute" ni qidiring, **O'rnatish** tugmasini bosing — ikkala do'konda ham xuddi shunday ishlaydi. Manba, muammolar va nashriyot kitobi [diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot) da jonli. _{📖 [VS Code Copilot Chat qo‘llanmasi](docs/guides/VSCODE-COPILOT.md) — sozlash, tanlovchi nimani ko‘rsatadi, paneldagi panel, muammolarni bartaraf etish}

### 🎩 Yangi: OmniRouteTray — menyu satrida yashovchi sizning shlyuzingiz

> `omniroute serve` doimo yoqilgan bo'lsa, eng baxtlidir. **[OmniRouteTray](https://github.com/zoispag/omniroute-tray)** uni macOS uchun sozlash va unutish menyusi ilovasiga aylantiradi: u serverni ishga tushiradi, uni qayta yuklashda saqlab turadi, uni yangilaydi va jonli token byudjetingizni bir marta bosish masofasiga joylashtiradi — **hech qanday terminal oynasi ochiq qolmagan, bolaga qarash uchun `npm install -g omniroute` yo'q.** [Tauri v2](https://v2.tauri.app/) (yaxlitlash xatosi oʻlchamidagi Rust yadrosi) bilan yaratilgan u oʻzining imzolangan 24-tugun ish vaqtini joʻnatadi va ilovaga tegishli OmniRoute oʻrnatishni boshqaradi, shuning uchun u hech qachon global `node`/`bun` bilan kurashmaydi. Bu **mavjud `~/.omniroute/` konfiguratsiyasi va ma'lumotlar bazasini baham ko'radi** — demak, siz allaqachon shlyapa bilan OmniRoute. 🎩

nima qiladi	Qanday qilib
🟢 Serverni nazorat qiladi	Spawns `omniroute service` , uni takrorlash o‘rniga allaqachon ishlayotgan misolni qabul qiladi
📊 Bir qarashda jonli foydalanish	Provayder kvotalari, Claude session/weekly chegaralari qayta o‘rnatish bilan ortga hisoblash, 30 kunlik xarajatlar taqsimoti
🔄 Avtomatik yangilanishlar joyida	Bosqichli o‘rnatish, atom almashinuvi, muvaffaqiyatsizlikka uchraganda orqaga qaytish — har doim eng yangi versiyada
🚀 Tizimga kirishda boshlash	Tizimga kirishda ixtiyoriy ishga tushirish; faqat laganda uchun, dock belgisi yo'q
🩺 Doktor & jurnallari	Bir marta bosish orqali diagnostika va server jurnaliga kirish

```sh brew install --cask zoispag/tap/omniroute-tray ``` _{Yuklab olishni afzal ko'rasizmi? Oxirgi .dmg ni oling
chiqaradi. Manba, muammolar va qurilish
docs zoispag/omniroute-tray yashaydi.

💛 Jamiyat loyihasi @zoispag - rasmiy OmniRoute nashri 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)}

## 🗜️ Tokenlarni 15–95% tejang — avtomatik tarzda

### 📖 Bu qanday ishlaydi — pipeline, arxitektura va tejamkorlik hisobi

OmniRoute compression pipeline: 10 000 tokenli mijoz so‘rovi 12 ta birlashtiriladigan dvigatel — Session-Dedup, CCR, Lite, RTK, Responses Tool Output, Headroom, Relevance, Caveman, Aggressive, LLMLingua-2, Ultra va OmniGlyph — orqali o‘tadi va hujjatlashtirilgan ketma-ket misolda provayderga taxminan 1 080 token bilan yetib borishi mumkin. Strukturali kontent saqlash himoyalari va har bir bosqichdagi aniqlik nazoratlari bilan himoyalanadi; aniq yo‘qotishli yoki eksperimental rejimlar mos kontentni o‘zgartirishi mumkin.

Standart ketma-ket kombinatsiya `RTK → Caveman` ni ishga tushiradi. Ikkalasi bir xil vosita/kontekst foydali yukida ishlaganda, tejamkorlik jamlanadi: ```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 manzillar, JSON va strukturali ma’lumotlar **har doim** saqlash mexanizmi tomonidan himoyalanadi. > **Kam token bilan ish bitganda, nega ko‘p token ishlatish kerak?** Har bir so‘rov OmniRoute’ning siqish pipeline’idan **shaffof tarzda** o‘tadi — mijozni o‘zgartirish shart emas. Endi bu tartib bilan ishlaydigan va har bir routing kombinatsiyasi uchun turlicha aralashtirilishi va moslashtirilishi mumkin bo‘lgan **12 ta birlashtiriladigan dvigateldan iborat stack** — [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 stack Dvigatellar pipeline tartibida ishlaydi; har biri alohida yoqilishi/o‘chirilishi va har bir kombinatsiya uchun sozlanishi mumkin:

#	Dvigatel	Vazifasi
1	Session-Dedup	Burilishlar bo‘ylab takrorlangan kontentni olib tashlaydi (kontent manziliga asoslangan, burilishlararo)
2	CCR	Katta bloklarni olish markerlari ortida arxivlaydi, zarur bo‘lganda olib keladi
3	Lite	Bo‘sh joylar va rasm URL manzillarini qisqartiradi (kechikishi past bazaviy rejim)
4	RTK	Vosita natijalarini aqlli filtrlash, dublikatlarni olib tashlash va qisqartirish (buyruqlarni anglaydi)
5	Responses Tool Output	Shell/patch/search/build natijalari uchun yo‘qotishsiz yondashuvga ustuvorlik berilgan JSON va chegaralangan diagnostik siqish (Responses API)
6	Headroom	Vendorga kiritilgan GCF kodeki orqali JSON massivlarini yo‘qotishsiz jadval ko‘rinishida ixchamlashtirish (~30%)
7	Relevance	Oxirgi foydalanuvchi so‘roviga nisbatan gaplarni ajratib oluvchi baholash
8	Caveman	Qoidalarga asoslangan nasriy siqish (chiqishda ~65–75%)
9	Aggressive	Eski burilishlarni umumlashtirish va bosqichma-bosqich eskirtirish
10	LLMLingua-2	MobileBERT ONNX orqali ML semantik qisqartirish — kod uchun xavfsiz, asinxron
11	Ultra	Ixtiyoriy kichik model (SLM) darajasiga ega evristik token qisqartirish
12	OmniGlyph	Anthropic’ning to‘g‘ridan-to‘g‘ri wire’ida o‘lchangan Claude Fable 5 uchun kontekstni tasvir sifatida kodlashning eksperimental usuli; GPT 5.6 transformer’lari provayder kvitansiyalari kutilayotgani sababli xatolik yuz berganda yopiq qoladi. To‘rtta siqish profili (agressiv — standart, muvozanatli, kodlash uchun xavfsiz, passthrough) (eng agressiv; ixtiyoriy)

Kod bloklari, URL manzillar va strukturali ma’lumotlar **har doim** baytma-bayt saqlanadi. **Bir marta bosiladigan presetlar** dvigatellarni birlashtiradi:

Rejim	Tejamkorlik	Eng mos
🪶 Lite	~15%	Har doim yoqilgan xavfsiz standart rejim
🪨 Standard (Caveman)	~30%	Kundalik dasturlash
⚡ Aggressive	~50%	Vositalar ko‘p ishlatiladigan uzun seanslar
🔥 Ultra	~75%	Maksimal tejamkorlik
🧰 RTK	60–90%	Shell/test/build/git natijalari
🔗 Stacked (RTK → Caveman)	78–95%	Aralash promptlar va vosita jurnallari

**Haqiqiy misol — Standard rejimi:** > **Oldin (69 token):** _"React komponentingiz qayta render bo‘layotganining ehtimoliy sababi — har bir render siklida yangi obyekt havolasini yaratayotganingiz. Inline obyektni prop sifatida uzatganingizda, React’ning yuzaki taqqoslashi uni har safar boshqa obyekt deb ko‘radi va bu qayta renderni ishga tushiradi. Obyektni memoizatsiya qilish uchun useMemo dan foydalanishni tavsiya qilaman."_ > > **Keyin (19 token):** _"Har bir renderda yangi obyekt havolasi. Inline obyekt prop = yangi havola = qayta render. useMemo bilan o‘rang."_ > > **Bir xil javob. 72% kamroq token. Aniqlik yo‘qolmaydi.** ✅ **PT-BR misoli — [Troglodita](https://github.com/leninejunior/troglodita) rejimi:** > **Avval (42 token):** _"Muammo shundaki, komponent qayta render qilinyapti, chunki har bir render siklida obyektning yangi referensi yaratilmoqda. `useMemo` dan foydalanishni tavsiya qilaman."_ > > **Keyin (12 token):** _"Qayta render: har bir siklda yangi ref (inline obyekt qayta yaratiladi). `useMemo` dan foydalaning."_ > > **Bir xil javob. ~70% kamroq token. Texnik aniqlik saqlanib qoldi.** ✅
### 🎚️ Dvigatellardan tashqari — chiqish uslublari, moslashuvchan sozlagich va har bir soʻrov uchun boshqaruv Yuqoridagi 12 ta dvigatel **kiritiladigan** maʼlumotni qisqartiradi. Yana uchta qatlam **qanday**, **qachon** va nimalar **chiqishini** belgilaydi: - **🪄 Chiqish uslublari** _(chiqish oʻqini boshqarish)_ — javob shaklini deterministik va keshga xavfsiz tarzda oʻzgartiruvchi koʻrsatmalarni qoʻshadi; ularni birlashtirish mumkin, har biri `lite` / `full` / `ultra` intensivlik darajasida ishlaydi. Uslub qoʻshish uchun registrga bir qator kiritish kifoya: - **Ixcham nasr** — toʻldiruvchi soʻzlar / artikllar / noaniq iboralarni olib tashlash; texnik mazmunni aniq saqlash. - **Kamroq kod** — YAGNI tamoyiliga amal qiluvchi “dangasa senior dasturchi”: ishlaydigan eng kichik oʻzgarish, soʻralmagan qoʻshimcha tayanch kodlarsiz. - **Dumli soch (dangasa senior dasturchi)** — YAGNI zinapoyasidan yuqorilash, asosiy sababni tuzatish, ishlaydigan eng kichik diff. - **Menda ADHD bor (harakat birinchi oʻrinda)** — keyingi harakatdan boshlash, qadamlarni raqamlash, bitta aniq keyingi qadam, kirish soʻzlarisiz. - **Ixcham CJK (文言)** — klassik xitoy tilidagi oʻta ixcham uslub (`zh` lokaliga bogʻlangan). - **🎯 Moslashuvchan kontekst budjeti** _(sozlagich)_ — yoqilgan/oʻchirilgan bitta token chegarasi oʻrniga, model kontekst oynasiga **sigʻishi** uchun eng arzon va eng kam yoʻqotishli dvigatellarni faqat kerak boʻlgan darajagacha bosqichma-bosqich ishga tushiradi. Siyosat: `reserve-output` (standart, modelga mos) · `percentage` · `absolute`. Rejim: `floor` (sigʻishni kafolatlash) · `replace-autotrigger` (aniq tanlovingiz ustun) · `off` (eski chegara). - **🎛️ Siqish qayerda belgilanadi** _(ustuvorlik, yuqoridan pastga)_ — har bir soʻrovdagi `x-omniroute-compression` sarlavhasi › routing-combo override › faol nomlangan profil › adaptive / auto-trigger › panel standarti › off. Qoʻllangan reja `X-OmniRoute-Compression: ; source=` javob sarlavhasida qaytariladi. Token chegarasi boʻyicha avtomatik ishga tushiring, moslashuvchan sozlagichni yoqing, nomlangan profilni biriktiring, har bir soʻrov uchun bir martalik sozlamani belgilang yoki har bir routing kombinatsiyasi uchun pipeline tayinlang — ish yuklamangizga mos keladigan usulni tanlang. Ixtiyoriy oflayn **baholash harnessi** (`npm run eval:compression`) oʻzgarishni joriy qilishdan oldin biriktirilgan korpusda aniqlik va tejamkorlikni 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)

# ⚡ Tezkor boshlash

**1) Oʻrnating va ishga tushiring** ```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 keyingi versiyadan foydalanyapsizmi?** npm paket 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 nomlari keltirilgan paketlarga ruxsat bering. OmniRoute 3.8.54 xabar bergan paketlar toʻplami uchun: > > ```bash > npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute > ``` > > Ushbu ruxsatlar roʻyxatidan kelajakdagi global oʻrnatishlarda qayta foydalanish 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 versiyalar orasida oʻzgarishi mumkin; agar npm boshqa roʻyxat haqida xabar bersa, oʻsha ogohlantirishdagi paket nomlaridan foydalaning. Paketga ruxsat berish uning oʻrnatish skriptlarini ishga tushirishga imkon beradi. > **Gemini Web yoki boshqa web-cookie provayderidan foydalanyapsizmi?** npm paketi Playwrightʼni oʻz ichiga oladi, ammo uning Chromium binar faylini emas. Birinchi web-provayder soʻrovini yuborishdan oldin [Playwright Chromiumʼni sozlash](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium) haqidagi eslatmani koʻring. Boshqaruv paneli: `http://localhost:20128` · API: `http://localhost:20128/v1`. **2) Oʻz hisobingizdan foydalanib, mos provayderni ulang** Boshqaruv paneli → **Provayderlar** → joriy shartlari va kvotasi foydalanish holatingizga mos keladigan provayderni tanlang → uning API kalitini qoʻshing yoki hisob jarayonini 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 foydalanish kafolatlanmaydi va `tos: avoid` bilan belgilangan provayderlar sukut boʻyicha `auto` dan chiqarib tashlanadi. **3) Kod yozish vositangizni yoʻnaltiring** ```txt Asosiy URL: http://localhost:20128/v1 API kaliti: [Boshqaruv paneli → Endpointlar bo‘limidan nusxalang] Model: auto (mos ulanishlar orasida yoʻnaltiradi — yoki provayder/modelni tanlang) ``` **4) Ishlayotganini tekshiring** ```bash curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY" ``` Ulangan modellaringiz roʻyxatini koʻrishingiz kerak. 🎉 Boʻldi — kod yozishni boshlang, OmniRoute esa siz uchun avtomatik yoʻnaltiradi va zaxira variantga oʻtkazadi. Agar mijozingiz maxsus sarlavhalarni yubora olmasa, OmniRoute tokenlashtirilgan moslik aliaslarini ham taqdim etadi: ```txt OpenAI katalogi: http://localhost:20128/vscode/YOUR_KEY/ OpenAI modellari: http://localhost:20128/vscode/YOUR_KEY/models OpenAI chat: http://localhost:20128/vscode/YOUR_KEY/chat/completions OpenAI javoblari: http://localhost:20128/vscode/YOUR_KEY/responses Ollama chat: http://localhost:20128/vscode/YOUR_KEY/api/chat Ollama teglar: http://localhost:20128/vscode/YOUR_KEY/api/tags ``` Ulardan faqat `Authorization: Bearer ...` ni biriktira olmaydigan mijozlar uchun foydalaning. Sarlavha orqali autentifikatsiya qilish afzal qilingan 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 steki

Qatlam	Texnologiya
Runtime	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 beri core’da nolta `any`)
Freymvork	Next.js 16 + React 19 + Tailwind CSS 4
Ma’lumotlar bazasi	better-sqlite3 (SQLite, WAL jurnallash) + LowDB (JSON merosiy) — 147 ta domen moduli, 233 ta migratsiya
Xotira	SQLite FTS5 to‘liq matnli qidiruvi + int8-kvantlangan vektor embeddinglari, tiplashtirilgan so‘nish
Sxemalar	Zod 4 — MCP vositalari I/O validatsiyasi + API kontraktlari
Protokollar	MCP (stdio / HTTP / SSE) + A2A v0.3 (JSON-RPC 2.0 + SSE)
Oqimlash	Server tomonidan yuboriladigan hodisalar (SSE) + WebSocket ko‘prigi (`/v1/ws`)
Siqish	12 dvigatelli pipeline — RTK, Caveman, LLMLingua-2 (MobileBERT ONNX), GCF, OmniGlyph
Autentifikatsiya va xavfsizlik	OAuth 2.0 (PKCE) + JWT + API kalitlari + MCP qamrovi belgilangan autentifikatsiya · AES-256-GCM saqlangan ma’lumotlar uchun · DOMPurify
Yashirinlik	wreq-js — JA3 / JA4 TLS fingerprint taqlidi, 3 darajali proksi
Barqarorlik	O‘chirgich (circuit breaker), eksponensial kechikish, anti-thundering-herd, auto-combo orqali o‘z-o‘zini tiklash
Jurnallash	pino — so‘rov konteksti bilan tuzilmali JSON jurnallari
Testlash	Node.js test runner + Vitest — 8 400 dan ortiq kuzatiladigan test fayllari bo‘ylab 60 000 dan ortiq statik test deklaratsiyalari (unit, integratsion, E2E, xavfsizlik, ekotizim)
Platformalar	Desktop (Electron) · Android (Termux) · PWA (istalgan brauzer)
CI/CD	GitHub Actions — reliz paytida npm’ga avtomatik nashr qilish + Docker Hub
Havolalar	Veb-sayt · npm · Docker Hub

## 📖 Hujjatlar

### 📘 Ishni boshlash

Hujjat	Tavsif
Foydalanuvchi qoʻllanmasi	Providerlar, kombinatsiyalar, CLI integratsiyasi, deploy qilish
Sozlash qoʻllanmasi	Oʻrnatish usullarining toʻliq tavsifi, CLI vositalari konfiguratsiyasi, protokolni sozlash, timeoutni moslash
CLI vositalari qoʻllanmasi	Claude Code, Codex, Cursor, Cline, OpenClaw, Kilo, Copilot uchun har bir vosita boʻyicha sozlash
Masofaviy rejim	Cheklangan kirish tokenlari orqali noutbukdagi CLI yordamida masofaviy OmniRoute (VPS) ni boshqarish
Claude Code konfiguratsiyasi	Claude Codeʼni `launch` va har bir model uchun profillar yordamida OmniRouteʼga (mahalliy/masofaviy) ulash
Tezkor boshlash	3 bosqichda oʻrnatish → ulanish → sozlash

### 🔧 Operatsiyalar va deploy qilish

Hujjat	Tavsif
Docker qoʻllanmasi	Dockerʼni ishga tushirish, Compose profillari, Caddy HTTPS, tunnellar, image teglari
Podman qoʻllanmasi	Quadlet systemd integratsiyasi, podman-compose, SELinux
VMʼga deploy qilish	Toʻliq qoʻllanma: VM + nginx + Cloudflareʼni sozlash
Fly.ioʼga deploy qilish	Doimiy xotira bilan Fly.ioʼga deploy qilish
Termux qoʻllanmasi	OmniRouteʼni Androidʼda Termux orqali ishga tushirish
PWA qoʻllanmasi	Progressiv veb-ilovani oʻrnatish, keshlash, arxitektura
Oʻchirish qoʻllanmasi	Barcha oʻrnatish usullari uchun toza oʻchirish
Muhit konfiguratsiyasi	`.env` oʻzgaruvchilari va havolalarining toʻliq tavsifi

### 🧠 Imkoniyatlar va arxitektura

Hujjat	Tavsif
Arxitektura	Tizim arxitekturasi, maʼlumotlar oqimi va ichki mexanizmlar
Siqish qoʻllanmasi	7 variantli pipeline: off / lite / standard / aggressive / ultra / RTK / stacked
RTK siqishi	Buyruq chiqishini siqish, filtrlar, ishonch, tekshirish, xom chiqishni tiklash
Siqish mexanizmlari	Caveman, RTK, stacked pipelineʼlar, dashboard/API/MCP interfeyslari
Siqish qoidalari formati	Caveman va RTK filtrlari uchun JSON qoidalar toʻplami sxemalari
Siqish tillari toʻplamlari	Tillarni aniqlash va Caveman qoidalar toʻplamini yaratish
Barqarorlik qoʻllanmasi	Oʻchirgichlar, kutish davrlari, navbat, anti-thundering herd, TLS spoofing
Auto-Combo mexanizmi	16 omilli baholash, rejim toʻplamlari, oʻzini oʻzi tiklash
Proxy qoʻllanmasi	3 darajali proxy tizimi, 1proxy marketplace, registr CRUD amallari
Bepul tariflar	Birlashtirilgan katalog: hujjatlashtirilgan 34 ta takroriy pool / kataloglashtirilgan 465 ta bepul tarif yozuvi
Imkoniyatlar galereyasi	Skrinshotlar bilan vizual dashboard boʻylab sayohat
Kod bazasi hujjatlari	Yangi boshlovchilar uchun kod bazasi boʻylab qoʻllanma

### 🤖 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ʼni oʻrnatish, transportlar va vositalar maʼlumotnomasi
A2A serveri	JSON-RPC 2.0 protokoli, koʻnikmalar, oqimli uzatish, vazifalarni boshqarish
A2A serveri qoʻllanmasi	A2A agent kartasi, vazifalar, koʻnikmalar va oqimli uzatish

### 📋 Loyiha va sifat

Hujjat	Tavsif
Hissa qoʻshish	Ishlab chiqish muhiti sozlamalari va yoʻriqnomalar
Tarmoqlash va relizlar modeli	PRlar qayerga yoʻnaltirilishi (`release/*`), `main` va teglar nimani anglatishi
Oʻzgarishlar jurnali	Har bir versiya boʻyicha toʻliq relizlar 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	8,400 dan ortiq kuzatiladigan test fayllaridagi 60,000 dan ortiq statik test deklaratsiyalari uchun test qamrovi strategiyasi

# ⭐ Eng faol hissa qoʻshuvchilar > OmniRoute ishtiyoqli ochiq kodli hamjamiyat tomonidan shakllantirilmoqda. Bu shaxslar loyihaning sifati, barqarorligi va qamroviga bevosita taʼsir koʻrsatadigan ajoyib hissalarni qoʻshdilar. **Rahmat.** ### Birlashtirilgan pull requestlar boʻyicha tashqi hissa qoʻshuvchilar

Oʻrin	Hissa qoʻshuvchi	Birlashtirilgan PRlar	~Oʻzgartirilgan qatorlar
1	maxmad64bis	418	25,367,739
2	HouMinXi	295	13,557,796
3	pacocartones	222	81,551
4	backryun	210	270,562
5	JxnLexn	198	3,570,623
6	oyi77	190	411,243
7	KooshaPari	151	5,972,314
8	rdself	145	80,663
9	RaviTharuma	123	500,065
10	herjarsa	88	230,872
11	hartmark	85	2,849,623
12	jonlwheat2-gif	68	69,097
13	artickc	62	43,502
14	xiaoyaner0201	59	126,220
15	chirag127	52	6,661
16	xz-dev	50	245,976
17	woodsonl	48	811,771
18	rqzbeh	46	151,229
19	MumuTW	43	28,166
19	QuangBlue	43	13,112

_{Roʻyxat 2026-11-03 03:01:19 UTC va release/v3.8.53 dagi joriy 05bc048d6c holat bilan tuzildi. Sahifalangan GitHub GraphQL roʻyxati 9,947 ta birlashtirilgan PRni oʻz ichiga oladi: 4,130 tasi repozitoriy egasi tomonidan, 240 tasi Dependabot tomonidan, 6 tasi boshqa botlar/ilovalar tomonidan va 883 nafar turli hissa qoʻshuvchidan 5,571 ta tashqi PR. “Oʻzgartirilgan qatorlar” GitHub qoʻshishlari + oʻchirishlari boʻlib, generatsiya qilingan fayllar, lockfilelar, kataloglar, tarjimalar va hujjatlarni ham oʻz ichiga oladi; bu mualliflik qilingan LOC emas, balki oʻzgarishlar hajmidir. 53 ta PR GitHub difflarida 500,000 qatordan ortiq oʻzgarish borligini bildiradi (masalan, bitta provayder qoʻshilgan #13399 PRida 2,347 ta oʻzgartirilgan fayl koʻrsatilgan), bu yuqoridagi ayrim jami qiymatlarni oshirib yuboradi. Bir xil natijaga ega ishtirokchilar birgalikda reytinglanadi.} ### GitHubga tegishli commitlar

Dizzle _{🥇 GitHub tomonidan qayd etilgan 418 ta kommit}	Bob.Hou _{🥈 GitHub tomonidan qayd etilgan 294 ta kommit}	Paijo _{🥉 GitHub tomonidan qayd etilgan 229 ta kommit}	Paco Cartones _{🏅 GitHub tomonidan qayd etilgan 222 ta kommit}	backryun _{🏅 GitHub tomonidan qayd etilgan 202 ta kommit}	Jan Leon _{🏅 GitHub tomonidan qayd etilgan 134 ta kommit}
Ravi Tharuma _{🏅 GitHub tomonidan qayd etilgan 126 ta kommit}	Markus Hartung _{🏅 GitHub tomonidan qayd etilgan 115 ta kommit}	Randi _{🏅 GitHub tomonidan qayd etilgan 108 ta kommit}	Chris _{🏅 GitHub tomonidan qayd etilgan 70 ta kommit}	WebPerson _{🏅 GitHub tomonidan qayd etilgan 68 ta kommit}	Koosha Paridehpour _{🏅 GitHub tomonidan qayd etilgan 68 ta kommit}

_{2026-11-03 02:09:16 UTC da qayta tekshirildi: GitHub tomonidan qayd etilgan kommitlar repozitoriyning Contributors API interfeysi orqali release/v3.8.53 standart tarmog‘i uchun taqdim etildi. API 903 ta identifikatorni qaytardi (429 ta foydalanuvchi, 2 ta bot, 472 ta anonim); ushbu jadvalda texnik xizmat ko‘rsatuvchi, botlar va anonim identifikatorlar chiqarib tashlangan hamda tanlovdagi teng natijalar saqlab qolingan. U yuqoridagi birlashtirilgan PR reytingidan ham, quyidagi Git metama’lumotlari ro‘yxatidan ham alohidadir.} > 🙏 Ushbu hissa qo‘shuvchilarning funksiyalari, xatolarni tuzatishlari va infratuzilmadagi yaxshilanishlari OmniRoute’ni ishonchli va imkoniyatlarga boy qiladigan **asosiy qism**dir. 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.

## 👥 1,000+ hissa qoʻshuvchilar

[![Contributors](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=1074&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors) _{2026-11-02 kuni faol release/v3.8.53 versiyasining 1c7135e0fb commitida (7,972 ta commit) tekshirildi: 1,074 ta normallashtirilgan inson Git identifikatori — 759 tasi commit muallifi sifatida (shu jumladan, loyihani qoʻllab-quvvatlovchi) va 315 tasi faqat aniq Co-authored-by treylerlarida koʻrinadi. Ushbu roʻyxatga olishda .mailmap qoʻllanadi, elektron pochta manzillari katta-kichik harflardan qatʼi nazar taqqoslanadi, raqamli va oddiy GitHub noreply manzillari faqat ular bir xil handleʼni ifodalaganda birlashtiriladi, 29 ta bot/agent/xizmat/placeholder identifikatori chiqarib tashlanadi va oddiy elektron pochta manzillari faqat ko‘rsatilgan nomlari mos kelgani uchun birlashtirilmaydi. 2026-08-24 kungi tekshiruvda 639 ta ko‘rsatilgan; ushbu usulni o‘sha tekshiruvning bazaviy ac02c5b42f commitida qayta qo‘llash 619 ta natija berdi, shuning uchun o‘sish usulning yumshatilgani emas, balki yangi hissa qo‘shuvchilar hisobiga yuz bergan.} ### Qanday hissa qoʻshish mumkin 1. Repozitoriyani fork qiling 2. **Faol** `release/vX.Y.Z` versiyasining soʻnggi commitidan (`main`dan emas) branch yarating — [Branch yaratish va reliz modeli](docs/ops/BRANCHING_MODEL.md) ga qarang 3. Funksiyangiz uchun branch yarating (`git checkout -b feat/amazing-feature`) 4. Oʻzgarishlaringizni commit qiling (`git commit -m 'feat: add amazing feature'`) 5. Branchga yuboring (`git push origin feat/amazing-feature`) 6. **base = shu `release/vX.Y.Z` branchi** bilan Pull Request oching Batafsil koʻrsatmalar uchun [CONTRIBUTING.md](CONTRIBUTING.md) ga 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 buyuk loyihalar yelkasida qurilgan. U **[9router](https://github.com/decolua/9router)** loyihasining fork’i va Go tilida yozilgan **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** loyihasining TypeScript porti sifatida boshlangan — shundan so‘ng quyida keltirilgan har bir quyi tizimga undan avval yo‘l ochgan ochiq kodli loyiha ilhom berdi. Ularning har biri OmniRoute’ning muayyan qismini shakllantirdi. Bu — barchasiga bildirayotgan minnatdorchiligimiz. 🙏 > ⭐ yulduzlar soni GitHub REST API orqali 2026-yil 3-noyabrda tekshirildi — bu loyihalarga yulduzcha qo‘yib qo‘ying. Ko‘rsatilgan sonlar aniq sana bo‘yicha olingan holat bo‘lib, tabiiy ravishda o‘zgarib turadi. ### 🧬 Kelib chiqish va shlyuz

Loyiha	⭐	OmniRoute’ga qanday ilhom berdi
9router	31,861	Ushbu fork asos qilib qurilgan original loyiha — bu yerda multimodal API’lar va to‘liq TypeScript qayta yozuvi bilan kengaytirilgan.
CLIProxyAPI	57,329	Ushbu JavaScript / TypeScript portiga ilhom bergan Go tilidagi implementatsiya.
LiteLLM	62,580	Ommaviy narxlash ma’lumotlar to‘plami xarajatlarni kuzatish sinxronizatsiyamizni ta’minlaydigan va provayderlarni normallashtirish modeli marshrutlashimizga asos bo‘lgan AI shlyuzi.
codex-chatgpt-web	15,435	Vendored ChatGPT Web → Codex Responses ko‘prigiga moslashtirilgan MIT manbasi, jumladan brauzer sessiyasi, javoblarni ramkalash, foydalanish va veb-qidiruv adapterlari.
free-claude-code	65,966	Oqimni tiklash, fikrlashsiz taxalluslar, zaxira veb-qidiruvi, sirpanma oyna limitlari, loglarni tahrirlash va mustahkamlangan ishga tushirish oqimlariga ko‘chirilgan andozalar.
composer-api	347	Cursor Composer vosita tanlovi, chiqish cheklovlari va vositani tasdiqlash andozalari native Cursor executor’iga moslashtirildi.
codex-multi-auth	561	Yangi kirish va refresh-token rotatsiyasi andozalari Codex OAuth’ni qayta autentifikatsiya qilishga ko‘chirildi.
opencode-anthropic-auth	562	Claude Code bilan mos transformatsiya standartlari va billing-header xatti-harakati OmniRoute’ning konfiguratsiyaga asoslangan ko‘prigiga umumlashtirildi.
grok2api-merged	2	Uning Grok model mapping’lari, soxta-TypeError Statsig generatori, so‘rov va qurilma standartlari hamda NDJSON javob protsessori OmniRoute’ning Grok Web executor’iga sezilarli darajada moslashtirildi.
TQZHR/grok2api	707	grok2api-merged ortidagi asosiy tranzitiv kod manbasi; uning model, header, payload, Statsig va protsessor implementatsiyalari Grok Web kelib chiqishida saqlab qolingan.
chenyme/grok2api	7,874	TQZHR va grok2api-merged orqali davom etgan Grok payload va qurilma standartlari, Statsig generatori hamda `result.response` protsessorining asosidagi MIT manbasi.
grok2api-pro	27	Proxy-pool qatlamining manbasi sifatida grok2api-merged tomonidan ko‘rsatilgan tranzitiv manba; OmniRoute ushbu kelib chiqish haqidagi eslatmani saqlab qoladi, biroq chegaralangan Grok Web executor’ida proxy-pool portini da’vo qilmaydi.
GrokProxy	52	Uning cookie orqali autentifikatsiyalangan Grok proxy’si va `result.response.token` oqim andozasi OmniRoute’ning Grok Web transportiga asos bo‘ldi.
GrokBridge	5	Uning original Grok Web implementatsiyasi HTTP/brauzer upstream dizaynini o‘rganishda foydalanildi; uning bevosita HTTP yo‘li GrokProxy’dan kelib chiqqani sababli mustaqil kod porti da’vo qilinmaydi.

### 🗜️ Kontekst va tokenlarni siqish — mexanizmlar

Loyiha	⭐	OmniRoute’ni qanday ilhomlantirdi
Caveman	116,957	Virusli “why use many token when few token do trick” loyihasi — uning g‘orodamcha so‘zlash falsafasi standart siqish rejimimiz va 30 dan ortiq to‘ldiruvchi/kondensatsiya qoidalarimiz asosini tashkil etadi.
RTK – Rust Token Killer	85,350	Buyruq chiqishlarini yuqori unumdorlikda siqish — RTK dvigatelimiz, JSON filtri DSL’i, xom chiqishni tiklash va RTK → Caveman zanjirli pipeline’imizga ilhom berdi.
headroom	78,672	Qaytariladigan kontekst siqishi (SmartCrusher) — `headroom` dvigatelimiz va `ccr` qayta olish markeri andozasiga ilhom berdi.
LLMLingua	6,797	Prompt siqish bo‘yicha tadqiqotlar (LLMLingua / LLMLingua-2) — asinxron, kodga xavfsiz, xatoda ochiq ishlaydigan `llmlingua` dvigatelimizga ilhom berdi.
llmlingua-2-js	33	LLMLingua dvigatelimiz uchun worker-thread backend sifatida ishlatiladigan JS/ONNX porti (MobileBERT / XLM-RoBERTa).
Troglodita	50	PT-BR tokenlarini siqish — pt-BR til paketimizni quvvatlaydi: Braziliya portugal tili grammatikasiga moslashtirilgan pleonazmni kamaytirish va to‘ldiruvchilarni olib tashlash.
ponytail	182,929	Virusli “dangasa katta dasturchi” YAGNI-koder ko‘nikmasi — less-code Output Style’imizga ilhom berdi: Caveman’ning qisqa bayonotiga chiqish o‘qi bo‘yicha tengdosh bo‘lgan, _yaratilgan_ kodni kamaytiradigan eng kichik ishlaydigan o‘zgarishni yo‘naltirish.
i-have-adhd	59,838	Uning avval 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	⭐	OmniRoute’ni qanday ilhomlantirdi
TOON	25,602	Token-Oriented Object Notation — uning ustunli, sarlavha va qatorlardan iborat modeli jadvalni ixchamlashtirish bosqichimiz shakllanishiga ta’sir ko‘rsatdi.
GCF – Graph Compact Format	61	Uning ixcham grafik formati va umumiy profil dizayni OmniRoute’ning jadvalni ixchamlashtirish hamda Headroom kodek formatini ishlab chiqishga asos bo‘ldi.
gcf-typescript	4	Headroom umumiy profil kodeki sifatida bevosita vendorga qo‘shilgan va kengaytirilgan MIT TypeScript implementatsiyasi.
token-optimizer-mcp	566	Brotli/SQLite keshi va har bir sessiya uchun kontekst deltasi — `session-dedup` dvigatelimizga ilhom berdi.
token-savior	1,203	Bash chiqishini ixchamlashtirish va MCP profillari — siqishdan voz kechish intizomimiz hamda MCP vositalari manifestini qisqartirishga ilhom berdi.
token-saver	162	Kontentni hisobga oluvchi, har bir fayl turi uchun xatodan xabardor chiqish siqishi — har bir tur bo‘yicha yo‘naltirishimiz va minimal yutuqda o‘tkazib yuborish mexanizmimizni tasdiqladi.
token-optimizer	2,853	“Arvoh tokenlarni toping” — uning tashqariga chiqarish va tiklanadigan handle andozasi CCR’ni tashqariga chiqarish haqidagi yondashuvimizga asos bo‘ldi.
TokenMizer	34	Sessiya grafigi va burilishlararo qatorlarni deduplikatsiya qilish loyihasi session-dedup dizaynimizga asos bo‘ldi.
OmniCompress	3	Rust ustunli JSON’i, kontent manziliga asoslangan qayta olish va xabarlararo deduplikatsiya — `headroom`/`ccr`/`session-dedup` dvigatellari dizaynimizni hamda keshga barqaror “siqilgan shakl pozitsiyaga bog‘liq emas” invariantini tasdiqladi.
mcp-compressor	140	MCP vositalari sxemasi va tavsiflarini siqish — MCP vositalari manifestidagi elementlar sonini kamaytirish yondashuvimizga asos bo‘ldi.
RepoMapper	218	Aider uslubidagi repo-map reytingi — repo-map va qayta olish reytingini o‘rganishimizga asos bo‘ldi.
quiet-shell-mcp	4	MCP orqali deklarativ shell chiqishini kamaytirish — deklarativ bash chiqishini ixchamlashtirishimizni tasdiqladi.
ts-morph	6,222	TypeScript Compiler API vositalar to‘plami — string, template va regex literallarini saqlagan holda parser asosida izohlarni olib tashlashimizga ilhom berdi.

### 🧠 Xotira va RAG

Loyiha	⭐	OmniRouteʼni qanday ilhomlantirdi
Mem0	68,294	Universal xotira qatlami — uning proksi-yozish/oʻqish-chegarasi modeli xotira arxitekturamizni shakllantirdi.
Letta (MemGPT)	25,321	Darajalangan xotiraga ega holatli agentlar — Context Control & Recovery (CCR) darajali modelimizga ilhom berdi.
WFGY	1,804	Takrorlanuvchi 16 ta RAG/LLM nosozlik rejimidan iborat ProblemMap taksonomiyasi — nosozliklarni bartaraf etish qoʻllanmamizdagi umumiy lugʻat.

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

Loyiha	⭐	OmniRouteʼni qanday ilhomlantirdi
llm-interceptor	81	Kodlash yordamchisi ↔ LLM trafigini MITM orqali tutib qolish/tahlil qilish Traffic Inspectorʼning dastlabki talablarini shakllantirdi. Avval hosil qilingan toʻrtta modul — SSE birlashtirish, suhbatni normallashtirish, maxfiy maʼlumotlarni niqoblash va sarlavhalarni sanitarizatsiya qilish — ommaviy protokol standartlariga asoslangan, mustaqil va clean-room usulidagi yangi realizatsiyalar bilan almashtirildi. Xost orqali oʻtkazishning ikkita yuzasi (`passthrough.ts` va `_internal/bypass.cjs`) OmniRouteʼning ichki realizatsiyalari boʻlib, mustaqil ravishda tasniflangan; ular ushbu almashtirish doirasida qayta yozilmagan.
ProxyBridge	6,978	Har bir jarayon uchun shaffof proksi yoʻnaltirish — ishdan chiqishga chidamli MITM yakunlash, soketlarning idle-timeoutlari, `/proc` orqali jarayonni aniqlash va TPROXY orqali tutib olish imkoniyatlarimizga ilhom berdi.

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

Loyiha	⭐	OmniRouteʼni qanday ilhomlantirdi
models.dev	7,486	AI modellari spetsifikatsiyalari, narxlari va imkoniyatlarining ochiq maʼlumotlar bazasi — model katalogimizga mahalliy tarzda sinxronlanadi.
React Flow / xyflow	38,874	Real vaqt rejimidagi Compression Studio va Combo/Routing Studioʼlarimizni quvvatlovchi tugunlarga asoslangan grafik kutubxonasi.
LangGraph	44,349	LangGraph Studioʼning ish jarayoni grafigini jonli vizuallashtirishi Studioʼlarimizdagi real vaqt rejimidagi kaskad koʻrinishiga ilhom berdi.
Langfuse	36,907	Uning trace → span → generation kuzatuvchanlik modeli Compression Studioʼdagi waterfall koʻrinishimizni shakllantirdi.
Kiali	3,647	Istio servis-mesh kuzatuvchanligi — Routing/Combo Studioʼdagi circuit-breaker nishonchalari va xato qirralari vizuallarimizga ilhom berdi.
lobe-icons	2,666	Boshqaruv panelimiz boʻylab provayder ikonalarini aks ettiruvchi AI/LLM brend logotiplari.
flag-icons	12,499	README til tanlagichida ishlatiladigan MIT litsenziyasidagi SVG bayroqlarni taqdim etadi.

### 🛡️ Xavfsizlik

Loyiha	⭐	OmniRouteʼni qanday ilhomlantirdi
awesome-secure-defaults	723	Xavfsiz standartlar asosida ishlaydigan kutubxonalarning saralangan roʻyxati xavfsizlik tanlovlarimizga yoʻl-yoʻriq beradi (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).

### 🧭 Qoʻshimcha vositalar

Loyiha	⭐	OmniRouteʼni qanday ilhomlantirdi
ClawRouter	6,649	Soʻrovlarni deduplikatsiya qilish, favqulodda nol xarajatli qayta zaxiralash, plagin sifatida ulanadigan Auto-Combo strategiyalari va koʻp tilli maqsadni tasniflashga ilhom berdi.
Antigravity-Manager	32,785	Uning hisobga mos modelni qayta xaritalashi, bajariladigan fayl yoʻlini tekshirishi va tarif yorligʻi xatti-harakati OmniRouteʼning Antigravity runtimeʼiga asos boʻldi.
vscode-antigravity-cockpit	4,852	Uning ixcham kvota tiklanishigacha boʻlgan ortga sanash formati OmniRouteʼdagi tegishli provayder cheklovi koʻrinishiga ilhom berdi.
AionUi	33,996	Uning ACP integratsiyalari OmniRouteʼning oʻrnatilgan CLI agentlarini avtomatik aniqlashiga ilhom berdi.
CodexBar	22,955	Grok Build kvota yuzasini aniqladi; keyin OmniRoute jonli wire formatni mustaqil ravishda tekshirdi va tuzatdi.

## 📄 Litsenziya MIT litsenziyasi — batafsil ma’lumot uchun [LICENSE](LICENSE) fayliga qarang. ---

**[⬆ Yuqoriga qaytish](#-omniroute)** · Ochiq kodli AI hamjamiyati uchun ❤️ bilan yaratildi. _{Diego Souza tomonidan yaratildi · OmniRoute v3.8.54 · Node ≥22.22.2 · MIT litsenziyasi · omniroute.online}