## 💰 Uchinchi tomon bepul tariflari orqali oyiga ~1.62 mlrd token
> **Oʻz provayder hisoblaringizdan foydalaning.** Bu OmniRoute tomonidan beriladigan tokenlar emas, balki alohida talablariga javob beriladigan uchinchi tomon bepul tariflarining taxminiy yigʻindisidir. Roʻyxatdan oʻting, zarur joylarda hisob maʼlumotlarini oling va foydalanishingiz mumkin boʻlgan provayderlarni ulang; har bir provayder oʻz limitlari, mavjudligi va shartlarini mustaqil boshqaradi.
>
> Bepul tariflarni qoʻlda birlashtirish juda qiyin — oʻnlab SDKlar, oʻnlab tezlik cheklovlari va aslida qancha resursingiz borligi haqida hech qanday tasavvur yoʻq. OmniRoute **35 ta takrorlanuvchi pul kaliti boʻyicha 485 ta bepul tarif yozuvini** kataloglaydi va tokenlar haqidagi asosiy koʻrsatkichni **eʼlon qilingan musbat oylik budjetga ega 17 ta pul hamda har bir model uchun beshta Groq limiti** asosida hisoblaydi, bunda umumiy pullar takroran hisoblanmaydi. Faqat mintaqaviy shaxsni tasdiqlashdan keyin ochiladigan kvotalar (hozirda: ModelScope) alohida, mintaqaviy shaxsni tasdiqlash ortida +~6 mln sifatida koʻrsatiladi va hech qachon asosiy koʻrsatkichga qoʻshilmaydi. Natija boshqaruv panelida (`/dashboard/free-tiers`) doim koʻrinib turadi.
> Jonli `/dashboard/free-tiers` sahifasining animatsion qisqacha koʻrinishi. Toʻliq metodologiya (pullarni 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 oʻzgaradi** — provayder bepul tarifni bekor qilsa, raqam kamayadi; yangisi qoʻshilsa, u oshadi. Biz eng yaxshi holatni yuqoriga yaxlitlab emas, balki katalog amalda hisoblagan natijani eʼlon qilamiz.
⭐ Agar OMNIROUTE pulni tejashingizga va ishingizni osonlashtirishga yordam bergan boʻlsa, repozitoriyga yulduzcha bering.
[](https://github.com/diegosouzapw/OmniRoute)
[](https://www.star-history.com/diegosouzapw/omniroute)
[](https://olud.ai/project/diegosouzapw-omniroute.html)
### 💬 Hamjamiyatga qoʻshiling
**👋 Loyihani yurituvchini kuzating — yangi provayderlar, relizlar va maslahatlar haqida birinchilardan boʻlib xabardor boʻling:**
[](https://www.linkedin.com/in/diegosouzapw/)
[](https://github.com/diegosouzapw)
[](https://discord.gg/U47eFqAXCn)
[](https://t.me/omnirouteOficial)
[](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4)
[](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4)
[](https://omniroute.online)
**Savollar, provayderlar boʻyicha maslahatlar, rivojlanish rejasi 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 kengayishda davom etmoqda
## 🆓 Oʻrnating, provayderni ulang, soʻng bitta endpoint orqali yoʻnaltiring
```bash
# Provayderni ulagandan 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":"Salom!"}]}'
```
`auto` uchun mos marshrut kerak. Yangi oʻrnatmada kalitsiz mos nishonlar boʻlmasligi mumkin, kalitsiz provayder esa uchinchi tomon mijozlarini rad etishi mumkin. `tos: avoid` bilan belgilangan provayderlar, jumladan OpenCode Free va 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?
## 🤝 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.
## 🎯 Kombolar — Yetakchi imkoniyat
> **Kombo** — OmniRoute **avtomatik ravishda** marshrutlaydigan modellar zanjiri. Kvota tugasa, provayder ishlamay qolsa yoki xarajatlar keskin oshsa, kombo keyingi mos va sog‘lom modelga o‘tishi mumkin. 🛡️
### ⚡ Nol konfiguratsiya — shunchaki `auto`dan foydalaning
Kombo yaratish shart emas. Modelingizni `auto`ga (yoki uning variantlaridan biriga) sozlang va OmniRoute ulangan provayderlaringizdan real vaqt rejimida baholanadigan virtual kombo yaratadi:
Model ID
Nimani optimallashtiradi
auto
🎯 Muvozanatli standart tanlov (LKGP — oxirgi yaxshi provayderingizdan foydalanishda davom etadi)
auto/coding
🧑💻 Kod yaratishda sifatni birinchi o‘ringa qo‘yuvchi vaznlar
auto/fast
⚡ Avval eng past kechikish
auto/cheap
💰 Avval har bir token uchun eng arzon variant
auto/offline
🔋 Avval eng katta kvota / tezlik cheklovi zaxirasi
auto/smart
🔭 Sifat birinchi o‘rinda + yaxshiroq modellarni topish uchun 10% tadqiq qilish
auto/lkgp
📌 Oxirgi ma’lum yaxshi provayderga aniq bog‘lanish
auto/chaos
🧪 Modellar paneliga parallel tarqatish (har bir provayderdan bittadan, standart bo‘yicha 5 ta), bitta javob qaytaradi; nosozlik kiritish emas, balki har bir panel modeli uchun bittadan yuqori oqim chaqiruvi
##
### 🔀 Yoki o‘zingiznikini yarating — 19 ta marshrutlash strategiyasi
Barcha **19 ta** strategiya — har bir kombo bosqichida aralashtirib moslashtiring:
#
Strategiya
Nima qiladi
1
priority
Birinchi nishonga ustuvorlik berilgan tartibli ro‘yxat — keyingisiga o‘tishdan oldin har birini to‘liq ishlatadi 🥇
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
Nishonlarni tartib bo‘yicha navbatma-navbat aylanib chiqadi
5
p2c
Ikki tanlov kuchiga asoslangan tasodifiy yukni muvozanatlash
6
least-used
Joriy yuki eng past bo‘lgan nishonni tanlaydi
7
random
Bir xil ehtimolli 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
reset-window
Kvota oynasi eng tez tiklanadigan nishonni afzal ko‘radi
12
reset-aware
Kvota tiklanish vaqtiga qarab tartiblaydi — avval qisqa oynalar 📊
13
context-relay
Uzoq suhbatlarda kontekstni nishonlar o‘rtasida uzatadi 🧠
14
context-optimized
Joriy kontekst hajmiga eng mos variantni tanlaydi
15
cache-optimized
Har bir qayta ishlatiladigan prompt prefiksini bir xil hisobga bog‘laydi — prompt keshi mos tushishlarini maksimal darajaga oshiradi 🎯
16
lkgp
Oxirgi ma’lum yaxshi yo‘l — oxirgi muvaffaqiyatli provayderga bog‘lanadi, so‘ng qoidalarga muvofiq zaxira variantga o‘tadi
17
auto
Har bir ulanish bo‘yicha 16 omilli jonli baholash 🤖
18
fusion
Modellar paneliga parallel tarqatadi + hakam bitta javobni umumlashtiradi 🧬
19
pipeline
Bosqichlarni zanjirlaydi — har bir nishonning chiqishi keyingisiga uzatiladi 🔗
Auto-Combo mexanizmi har bir nomzodni **16 ta omil** (sog‘lomlik, kvota, xarajat, kechikish, vazifaga moslik, sifat, sessiya mavjudligi…) bo‘yicha baholaydi — [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md) fayliga qarang.
##
### 🧱 Bardoshlilik ichki imkoniyat sifatida taqdim etilgan (3 ta mustaqil qatlam)
📖 [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 xususiyat 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
**🇧🇷 PIX** — darhol, komissiyasiz (Braziliya)
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.50** versiyalaridagi soʻnggi muhim yangiliklar. Toʻliq tarix [`CHANGELOG.md`](CHANGELOG.md) faylida.
- **🎛️ OmniConductor** — agentlar guruhingizga kiruvchi A2A delegatsiyasi, Agent Card ichidagi Conductor ko‘nikmalari va Faro push-to-talk ovozli chatiga ega boshqaruv paneli. → [A2A serveri](docs/frameworks/A2A-SERVER.md)
- **🛂 Moslashuvchan qabul va ortiqcha yuklanishdan himoya** — katta hajmdagi chat soʻrovlari 503 xatosini qaytarish oʻrniga navbatga qoʻyiladi, har bir ulanish uchun atomar RPM sirgʻaluvchi ijaralari bilan. → [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 joylashtiriladi), barcha katalog manbalarida barqaror. → [API maʼlumotnomasi](docs/reference/API_REFERENCE.md)
- **🗜️ Siqishni mustahkamlash** — sukut boʻyicha yoqilgan kengaytirish himoyasi, DE / FR / JA + xitoy tili (wényán) uchun Caveman paketlari, Gradle va .NET uchun RTK filtrlari. → [Siqish](docs/compression/COMPRESSION_ENGINES.md)
- **💸 Haqqoniy qatʼiy tarif xarajati** — obuna / kodlash rejasi provayderlari xarajatlar tahlilida **$0** sifatida koʻrsatiladi; budjet, kvota va marshrutlash esa hisoblashda davom etadi. → [API maʼlumotnomasi](docs/reference/API_REFERENCE.md)
- **⚖️ Quota-Share marshrutlash** — umumiy hisob kvotasini birlashtirilgan kalitlar oʻrtasida adolatli taqsimlaydi va resurslarni tejovchi tarzda boʻsh ulushlarni boshqalarga vaqtincha beradi. → [Barqarorlik qoʻllanmasi](docs/architecture/RESILIENCE_GUIDE.md)
- **🤖 CLI/agentni bitta buyruq bilan sozlash** — roʻyxatdan oʻtkazilgan 13 ta `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 tanlash va har bir kontekst uchun sevimlilar bilan 10 ta maqsadni qoʻllab-quvvatlaydi. → [CLI integratsiyalari](docs/guides/CLI-INTEGRATIONS.md)
- **🛰️ Masofaviy rejim** — qamrovi cheklangan tokenlar (`connect` / `contexts` / `tokens`) hamda VPS oʻrnatmalari uchun `antigravity` OAuth yordamchisi orqali masofaviy OmniRoute’ni boshqaring. → [Masofaviy rejim](docs/guides/REMOTE-MODE.md)
- **🧭 Aqlliroq avtomatik marshrutlash** — `auto/:` kombinatsiyalari, **Fusion** (modellar paneli + hakam), vazifani hisobga oluvchi marshrutlash, har bir soʻrov uchun model / rejim / USD-budjet sozlamalarini bekor qilish. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🗜️ Ulanadigan siqish** — 12 ta birlashtiriladigan mexanizm + Compression Studios: LLMLingua-2, ikki bosqichli Ultra, omniglyph, har bir qadam uchun aniqlik filtri, GCF v3.2, sudrab tartiblash muharriri. → [Siqish](docs/compression/COMPRESSION_ENGINES.md)
- **🕵️ Shaffof MITM deshifrlash (TPROXY)** — proksi muhit oʻzgaruvchilarini eʼtiborsiz qoldiradigan CLI’larni har bir SNI uchun alohida CA va ishonchli sertifikatlar ombori oʻrnatuvchisi yordamida tutib olish. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md)
- **💸 Barcha joyda xarajat telemetriyasi** — har bir endpoint’da `X-OmniRoute-*` xarajat/foydalanish sarlavhalari, cache-HIT tejash 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 + turlashtirilgan eskirish, har bir soʻrov uchun `x-omniroute-no-memory`. → [Xotira](docs/frameworks/MEMORY.md)
- **🛡️ Xavfsizlik** — har bir LLM marshrutida prompt-inyeksiya himoyasi (red-team toʻplami), ixtiyoriy hisob maʼlumotlarini niqoblash himoyasi (sizib chiqqan API kalitlari/sirlarini har ikki yoʻnalishda tahrirlaydi), bepul DuckDuckGo soʻnggi chora sifatidagi veb-qidiruvi va boshqaruv paneli uchun ixtiyoriy OIDC kirish darvozasi (parol orqali kirish doim mavjud boʻlib qoladi). → [Himoya mexanizmlari](docs/security/GUARDRAILS.md)
- **🖼️ Yangi endpoint’lar** — `/v1/ocr` (Mistral OCR) va `/v1/audio/translations` (Whisper uslubida) media imkoniyatlarini toʻldiradi. → [API maʼlumotnomasi](docs/reference/API_REFERENCE.md)
- **🎨 Tasvir / video / audio yaratish** — 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 ekspluatatsiya** — teskari proksi `basePath`, brauzer tilini avtomatik aniqlash, har bir kalit uchun qurilma kuzatuvi, root huquqisiz MITM ishonchi, zh-TW mahalliylashtirish. → [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), toʻlaqonli Ollama kartasi, Claude Opus 5 va Sonnet 5, Kimi bilan rasmiy hamkorlik (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… va yangilangan **372 provayderli katalog**. → [Provayderlar](docs/reference/PROVIDER_REFERENCE.md)
- **📡 Marshrutlash shaffofligi** — har bir javobda unga xizmat koʻrsatgan strategiya/provayder/kechikishni koʻrsatuvchi `X-OmniRoute-Decision` sarlavhasi mavjud; yangi `cache-optimized` kombinatsiya strategiyasi + Auto-Combo `cacheAffinity` omili takroriy soʻrovlarni keshlangan prefiks saqlanayotgan ulanishga qayta yoʻnaltiradi; faqat oʻqish uchun moʻljallangan `/v1/auto-combo/{channel}/candidates` endpoint’i `auto/*` kanalining joriy nomzodlar toʻplamini ochib beradi. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **⚡ Mahalliy unumdorlik va infratuzilma** — bir bosishda mahalliy Redis, Cloudflare Workers / Deno Deploy rele joylashtiruvchilari, nazorat ostidagi ichki xizmatlar sifatida Bifrost va Mux. → [Ichki xizmatlar](docs/frameworks/EMBEDDED-SERVICES.md)
- **🧩 Toʻplamga yana quyidagilar kiradi** — plagin freymvorki + marketpleys, Omni/Agent/GitHub koʻnikmalar freymvorklari, Obsidian ombori integratsiyasi (22 ta MCP vositasi), OpenAI bilan mos Batch va Files API’lari, semantik javob keshi, reyting jadvallari bilan geymifikatsiya, ACP agentlarini aniqlash (15 ta ichki agent), BigQuery’ga rejalashtirilgan jurnal eksporti, `auto/chaos` parallel koʻp modelli tarqatish, Telegram bot koʻprigi, ilova ichidagi versiya menejeri va LMArena-ELO bepul provayderlar reytinglari. → [Hujjatlar](docs/README.md)
## 🤖 Mos CLI’lar va kodlash agentlari
> Bitta konfiguratsiya — `http://localhost:20128/v1` — va **har qanday** AI IDE yoki CLI bepul hamda arzon modellarda ishlaydi.
＋ quyidagilar bilan ham ishlaydi · Agent Deck · Kiro · Command Code · Antigravity · Windsurf · AMP · OpenAI bilan mos keluvchi har qanday vosita
📖 Barcha 36 ta vosita (26 ta CLI Code + 10 ta CLI Agent) uchun alohida sozlash → [`docs/reference/CLI-TOOLS.md`](docs/reference/CLI-TOOLS.md) · 🧩 OpenCode plagini → [`@omniroute/opencode-provider`](https://www.npmjs.com/package/@omniroute/opencode-provider)
**Qoʻllab-quvvatlanadigan istalgan CLI’ni OmniRoute orqali bitta buyruq bilan ishga tushiring** — hech qanday konfiguratsiya fayli yozilmaydi,
hisob maʼlumotlari har bir jarayonga alohida kiritiladi, Qwen/Gemini esa vaqtinchalik izolyatsiyalangan uy katalogidan foydalanadi:
```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
```
Har bir buyruq faol masofaviy kontekstni (`omniroute connect `) hisobga oladi, `--dry-run`
esa bajarishdan oldin aniq muhit oʻzgaruvchilari/argumentlarni koʻrsatadi va `--api-key-env NAME` maxfiy maʼlumotlarni
qobiq tarixiga yozilishidan saqlaydi. → [CLI integratsiyalari](docs/guides/CLI-INTEGRATIONS.md)
## 🌐 372 ta AI provayderi — 154 tasi katalogda bepul deb belgilangan
> Kanonik chat, media, qidiruv, mahalliy, bulutli agent va tizim toʻplamlari boʻylab **372 ta roʻyxatdan oʻtgan provayder**, jumladan, **154 tasida `hasFree: true` aniqlash metamaʼlumotlari mavjud**. Chat modellari reyestri **237 ta provayder / 3,009 ta alohida provayder-model juftligi / 1,443 ta xom model ID**ni qamrab oladi; alohida bepul byudjet katalogida **har bir model uchun 485 ta qator**, **35 ta takrorlanuvchi pul** va **53 ta takrorlanuvchi/kalitsiz doimiy bepul provayder** mavjud. Bular ataylab turli maxrajlar asosida hisoblanadi; taʼriflar va pullar boʻyicha takrorlar olib tashlangan hisob-kitoblar [Provayderlar maʼlumotnomasi](docs/reference/PROVIDER_REFERENCE.md) va [Bepul tariflar](docs/reference/FREE_TIERS.md) sahifalarida keltirilgan.
### 🏢 Barcha yirik laboratoriyalar — yagona endpoint orqali
OpenAI
Anthropic
Gemini
xAI Grok
DeepSeek
Mistral
Qwen
Meta Llama
Groq
NVIDIA
MiniMax
Cohere
Perplexity
HuggingFace
Together
Fireworks
Cloudflare
Baidu
…va yana 330+ tasi — har bir belgi boshqaruv panelining provayderlar katalogidan jonli tarzda yuklanadi. 📖 [Provayderlar maʼlumotnomasi](docs/reference/PROVIDER_REFERENCE.md)
### 🆓 Abadiy bepul — $0, karta talab qilinmaydi
OpenCode Zen DeepSeek V4, Nemotron 3 Token cheklovi yoʻq
Kilo Code Avtomatik yoʻnaltiruvchi, Tencent Hy3 Doimo bepul
Requesty GPT-OSS 120B, Nemotron Doimo bepul
SiliconFlow DeepSeek V3.2 / R1 Bepul tarif
Z.AI GLM GLM-4.7 / 4.5-Flash Doimo bepul
Baidu ERNIE ERNIE 4.0 Doimo bepul
Qoder AI Qwen3-Max, Kimi-K2 CHEKSIZ BEPUL
Pollinations GPT, Llama, Claude Kalit talab qilinmaydi
Cloudflare AI 50+ model Kuniga 10 ming neyron
NVIDIA NIM GLM, MiniMax ~40 RPM bepul
Cerebras GLM 4.7, GPT-OSS Bir martalik $5 kredit; karta talab qilinadi
OpenRouter :free modellari +$10 → yuqoriroq RPM
📖 Mashina oʻqiy oladigan toʻliq 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
### 🧩 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.
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.
> Serverdan tashqari, OmniRoute — **80+ buyruqqa** ega **toʻliq buyruq qatori boshqaruv paneli**, shuningdek, AI agenti uni **mustaqil ravishda** boshqara olishi uchun ochiq agent protokollaridir.
### ⌨️ Haqiqiy CLI (faqat `start` emas)
```bash
omniroute # shlyuz + boshqaruv panelini ishga tushirish (20128-port)
omniroute chat # interaktiv TUI chat mijozi (slash: /model /combo /skill /memory)
omniroute setup # dastlabki ishga tushirish uchun yoʻnaltirilgan sozlash ustasi
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 **ayni bir CLI** orqali boshqaring. Qoʻllanish doirasi 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 → doirasi cheklangan token, kontekst sifatida saqlanadi
omniroute models list # ← MASOFAVIY serverga qarshi ishlaydi
omniroute configure codex # ← masofaviy modelni tanlaydi, mahalliy Codex profilini yozadi
omniroute tokens create --name ci --scope read # boshqa qurilmalar uchun doirasi torroq tokenlar yaratadi
omniroute contexts use default # ← mahalliy serverga qaytadi
```
Tokenlar doirasi `read` / `write` / `admin` bilan cheklanadi; jarayonlarni ishga tushiruvchi yoʻnalishlar faqat loopback orqali ishlaydi.
📖 [Masofaviy rejim](docs/guides/REMOTE-MODE.md)
### 🤝 Agentni ulang — va u OmniRoute’ni oʻzi boshqaradi
OmniRoute’ni **MCP**, **A2A**, **REST API**, **webhooklar** yoki **masofaviy CLI** orqali taqdim eting — har qanday qobiliyatli agent (yoki oʻz kodingiz) butun shlyuzni: marshrutlash, provayderlar, kombinatsiyalar, kesh, siqish va xotirani avtonom ravishda boshqarish imkoniyatiga ega boʻladi. Quyidagi HTTP endpointlari `http://localhost:20128` manzilida xizmat koʻrsatadi.
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 doira (majburiy nazorat ixtiyoriy), toʻliq audit jurnali
📡 MCP (SSE)
/api/mcp/sse
Oqimli MCP transporti
🤝 A2A
/.well-known/agent.json
Agentdan agentga, 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’ga yuboring
🛰️ Masofaviy CLI
omniroute connect
Masofaviy nusxani doirasi cheklangan kirish tokenlari bilan boshqaring
```bash
# Claude Code’ga MCP orqali toʻliq OmniRoute vositalar 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 ravishda
### 📖 Qanday ishlaydi — konveyer, arxitektura va tejash hisobi
Standart ketma-ket kombinatsiya `RTK → Caveman` tartibida ishlaydi. Ikkalasi ham ayni vosita/kontekst yuklamasiga taʼsir qilganda, tejash ko‘paytma asosida 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 tuzilmali maʼlumotlar saqlash mexanizmi tomonidan **har doim himoyalanadi**.
> **Oz token kifoya qilsa, nega koʻp token ishlatish kerak?** Har bir soʻrov OmniRoute siqish konveyeridan **shaffof tarzda** oʻtadi — mijoz tomonida hech qanday oʻzgartirish kerak emas. Endi bu tartib bilan ishlaydigan va har bir marshrutlash kombinatsiyasida erkin aralashtirib qoʻllanadigan **12 ta birlashtiriladigan mexanizmdan iborat stek** — u [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 mexanizmli stek
Mexanizmlar konveyer tartibida ishlaydi; har birini mustaqil ravishda yoqib-oʻchirish va har bir kombinatsiya uchun sozlash mumkin:
#
Mexanizm
Nima qiladi
1
Session-Dedup
Muloqot bosqichlarida takrorlangan kontentni olib tashlaydi (kontent asosida manzillanadi, bosqichlararo)
2
CCR
Katta bloklarni olish markerlari ortida arxivlaydi va talab boʻyicha yuklaydi
3
Lite
Boʻsh joylar va rasm URL manzillarini qisqartiradi (kechikishi past asosiy rejim)
4
RTK
Vosita natijalarini aqlli filtrlash, takrorlarni olib tashlash va qisqartirish (buyruqlarni hisobga oladi)
5
Responses Tool Output
Shell/patch/search/build natijalari uchun avvalo yoʻqotishsiz JSON siqish va chegaralangan diagnostik siqish (Responses API)
6
Headroom
Ichki taqdim etilgan GCF kodeki orqali JSON massivlarini yoʻqotishsiz jadval shaklida ixchamlaydi (~30%)
7
Relevance
Oxirgi foydalanuvchi soʻroviga nisbatan gaplarni ajratib baholaydi
8
Caveman
Qoidalarga asoslangan matn siqish (natijada ~65–75%)
9
Aggressive
Eski muloqot bosqichlarini umumlashtirish va bosqichma-bosqich eskirtirish
10
LLMLingua-2
MobileBERT ONNX orqali ML asosidagi semantik saralash — kod uchun xavfsiz, asinxron
11
Ultra
Ixtiyoriy kichik model (SLM) bosqichi bilan evristik token saralash
12
OmniGlyph
Bevosita Anthropic ulanishida oʻlchangan Claude Fable 5 uchun kontekstni rasm sifatida kodlashning tajribaviy usuli; GPT 5.6 transformerlari provayder tasdiqlari olinmaguncha xavfsiz tarzda yopiq qoladi. Toʻrtta siqish profili (standart agressiv, muvozanatli, kodlash uchun xavfsiz, oʻzgarishsiz uzatish) (eng agressiv; alohida yoqiladi)
Kod bloklari, URL manzillar va tuzilmali maʼlumotlar **har doim baytma-bayt aynan saqlanadi**. **Bir bosishda tanlanadigan andozalar** mexanizmlarni birlashtiradi:
Rejim
Tejash
Eng mos holat
🪶 Lite
~15%
Doim yoqilgan xavfsiz standart rejim
🪨 Standard (Caveman)
~30%
Kundalik kodlash
⚡ Aggressive
~50%
Vositalar koʻp ishlatiladigan uzoq seanslar
🔥 Ultra
~75%
Maksimal tejash
🧰 RTK
60–90%
Shell/test/build/git natijalari
🔗 Ketma-ket (RTK → Caveman)
78–95%
Aralash promptlar + vosita jurnallari
**Haqiqiy misol — Standard rejimi:**
> **Oldin (69 token):** _"React komponentingiz qayta render qilinishining sababi, ehtimol, har bir render siklida yangi obyekt havolasini yaratayotganingizdir. 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 renderda yangi obyekt havolasi. Inline obyekt prop = yangi havola = qayta render. useMemo bilan oʻrang."_
>
> **Xuddi shu javob. Tokenlar 72% kam. Aniqlik yoʻqotilmagan.** ✅
**PT-BR misoli — [Troglodita](https://github.com/leninejunior/troglodita) rejimi:**
> **Oldin (42 token):** _"Muammo shundaki, komponent har bir renderlash siklida yangi obyekt havolasi yaratilgani sababli qayta renderlanmoqda. Men useMemo’dan foydalanishni tavsiya qilaman."_
>
> **Keyin (12 token):** _"Qayta render: har siklda yangi havola (inline obyekt qayta yaratiladi). `useMemo` ishlating."_
>
> **Bir xil javob. ~70% kamroq token. Texnik aniqlik saqlangan.** ✅
### 🎚️ Mexanizmlardan tashqari — chiqish uslublari, moslashuvchan regulyator va har bir soʻrov uchun boshqaruv
Yuqoridagi 12 ta mexanizm **kiruvchi** maʼlumotni qisqartiradi. Yana uchta qatlam javob **qanday**, **qachon** shakllanishini va **nima chiqishini** belgilaydi:
- **🪄 Chiqish uslublari** _(chiqish oʻqi boʻyicha boshqaruv)_ — javob shaklini belgilovchi deterministik, kesh uchun xavfsiz koʻrsatmalarni qoʻshadi; ularni birlashtirish mumkin va har biri `lite` / `full` / `ultra` intensivligiga ega. Uslub qoʻshish — registrga bir qator kiritish:
- **Ixcham bayon** — ortiqcha iboralar / artikllar / ikkilanishlarni olib tashlaydi; texnik mazmunni aniq saqlaydi.
- **Kamroq kod** — “dangasa katta dasturchi” YAGNI yondashuvi: ishlaydigan eng kichik oʻzgarish, soʻralmagan karkassiz.
- **Ponytail (dangasa katta dasturchi)** — YAGNI zinapoyasi boʻylab koʻtariladi, tub sababni tuzatadi va ishlaydigan eng kichik farqni yaratadi.
- **Menda ADHD bor (avval amal)** — avval keyingi amal, raqamlangan qadamlar, bitta aniq keyingi qadam, kirish soʻzisiz.
- **Ixcham CJK (文言)** — klassik xitoycha oʻta ixcham uslub (`zh` lokaligagina ruxsat beriladi).
- **🎯 Moslashuvchan kontekst budjeti** _(regulyator)_ — yagona yoqish/oʻchirish token chegarasi oʻrniga, modelning kontekst oynasiga **sigʻdirish** uchun faqat zarur darajagacha eng arzon va eng kam yoʻqotishli mexanizmlarni bosqichma-bosqich ishga tushiradi. Siyosat: `reserve-output` (standart, modelni hisobga oladi) · `percentage` · `absolute`. Rejim: `floor` (sigʻishni kafolatlaydi) · `replace-autotrigger` (sizning aniq tanlovingiz ustun keladi) · `off` (eski chegara).
- **🎛️ Siqish qayerda belgilanadi** _(ustuvorlik, yuqoridan → pastga)_ — har bir soʻrovdagi `x-omniroute-compression` sarlavhasi › marshrutlash kombinatsiyasi istisnosi › faol nomlangan profil › moslashuvchan / avtomatik ishga tushirish › paneldagi standart sozlama › oʻchirilgan. Qoʻllangan reja javobdagi `X-OmniRoute-Compression: ; source=` sarlavhasida qaytariladi.
Token chegarasi boʻyicha avtomatik ishga tushiring, moslashuvchan regulyatorni yoqing, nomlangan profilni mahkamlang, har bir soʻrov uchun bir martalik sozlama belgilang yoki har bir marshrutlash kombinatsiyasiga konveyer tayinlang — ish yukiga mos kelganini tanlang. Ixtiyoriy, oflayn **baholash vositasi** (`npm run eval:compression`) oʻzgarishni joriy etishdan oldin belgilangan korpusda aniqlik va tejash nisbatini 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-bogʻliqlik ogohlantirishlarini koʻryapsizmi? [Ular zararsiz](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated).
> **npm 11 yoki undan keyingi versiyadan foydalanyapsizmi?** Ruxsat berilmagan boʻlsa, npm paketlarning hayot sikli skriptlarini bloklashi mumkin. OmniRoute’ning `postinstall` skripti (`node scripts/build/postinstall.mjs`) uning mahalliy bajarilish muhiti fayllarini tayyorlash uchun zarur. Global oʻrnatish vaqtida npm ogohlantirishida koʻrsatilgan paketlarga ruxsat bering. OmniRoute 3.8.51 xabar qilgan 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 kelgusi global oʻrnatishlarda qayta ishlatish uchun uni bir marta sozlang, soʻng 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 skriptlari bajarilishiga imkon beradi.
> **Gemini Web yoki veb-cookie ishlatuvchi boshqa provayderdan foydalanyapsizmi?** npm paketi
> Playwright’ni oʻz ichiga oladi, ammo uning Chromium binar faylini emas. Birinchi veb-provayder soʻrovini yuborishdan oldin
> [Playwright Chromium sozlamasi](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 hisobingiz orqali mos provayderni ulang**
Boshqaruv paneli → **Provayderlar** → amaldagi shartlari va kvotasi foydalanish holatingizga mos provayderni tanlang → uning API kalitini kiriting yoki hisobni ulash jarayonini yakunlang. Bepul tariflar roʻyxatdan oʻtish, tasdiqlash yoki toʻlov usulini talab qilishi mumkin. [Bepul tariflar qoʻllanmasini](docs/getting-started/FREE-TIERS-GUIDE.md) koʻrib chiqing; kalitsiz foydalanish kafolatlanmaydi va `tos: avoid` bilan belgilangan provayderlar standart holatda `auto` tarkibiga kiritilmaydi.
**3) Dasturlash vositangizni yoʻnaltiring**
```txt
Asosiy URL: http://localhost:20128/v1
API kaliti: [Boshqaruv paneli → Yakuniy nuqtalar boʻlimidan nusxalang]
Model: auto (mos ulanishlar orasida marshrutlaydi — 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. 🎉 Hammasi tayyor — kod yozishni boshlang, OmniRoute esa siz uchun avtomatik marshrutlaydi va nosozlik yuz bersa zaxira variantga oʻtadi.
Agar mijozingiz maxsus sarlavhalarni yubora olmasa, OmniRoute tokenlashtirilgan moslik taxalluslarini ham taqdim etadi:
```txt
OpenAI katalogi: http://localhost:20128/vscode/YOUR_KEY/
OpenAI modellari: http://localhost:20128/vscode/YOUR_KEY/models
OpenAI chati: http://localhost:20128/vscode/YOUR_KEY/chat/completions
OpenAI javoblari: http://localhost:20128/vscode/YOUR_KEY/responses
Ollama chati: http://localhost:20128/vscode/YOUR_KEY/api/chat
Ollama teglari: http://localhost:20128/vscode/YOUR_KEY/api/tags
```
Bulardan faqat `Authorization: Bearer ...` sarlavhasini biriktira olmaydigan mijozlar uchun foydalaning. Sarlavha orqali autentifikatsiya afzal usul 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.
Kuzatiladigan 5,100 dan ortiq test faylidagi 39,000 dan ortiq statik test deklaratsiyasi uchun test qamrovi strategiyasi
# ⭐ Eng faol hissa qoʻshuvchilar
> OmniRoute ishtiyoqli ochiq manbali dasturiy taʼminot hamjamiyati tomonidan shakllantiriladi. Bu insonlar loyihaning sifati, barqarorligi va qamroviga bevosita taʼsir koʻrsatadigan ulkan hissa qoʻshgan. **Rahmat.**
### Birlashtirilgan pull requestlar boʻyicha tashqi hissa qoʻshuvchilar
Maʼlumotlar amaldagi release/v3.8.50 tarmogʻining dafb4ae808 uchida, 2026-08-24 05:26:03 UTC vaqtigacha boʻlgan birlashtirishlarni hisobga olgan holda qayd etilgan. Sahifalangan GitHub GraphQL roʻyxati 5,911 ta birlashtirilgan PRni oʻz ichiga oladi: 2,707 tasi repozitoriy egasi, 179 tasi Dependabot va 3,025 ta tashqi PR 535 nafar alohida hissa qoʻshuvchi tomonidan yaratilgan. “Oʻzgartirilgan qatorlar” GitHubʼdagi qoʻshilgan va oʻchirilgan qatorlar yigʻindisi boʻlib, yaratilgan fayllar, lockfilelar, kataloglar, tarjimalar va hujjatlarni ham oʻz ichiga oladi; bu muallif yozgan LOC emas, balki oʻzgarishlar hajmidir. Chegaradagi teng natijalar saqlab qolingan.
### GitHub tomonidan muallifga biriktirilgan commitlar
Bob.Hou 🏅 GitHub hisobiga yozilgan 51 ta commit · 10-oʻrin teng
Xiangzhe 🏅 GitHub hisobiga yozilgan 51 ta commit · 10-oʻrin teng
2026-08-24 06:14:31 UTC da qayta tekshirildi: release/v3.8.50 standart tarmogʻi uchun repozitoriyning Contributors API’si tomonidan berilgan GitHub hisobiga yozilgan commitlar. API 525 ta identifikatorni qaytardi (415 ta foydalanuvchi, 2 ta bot, 108 ta anonim); bu jadvalga loyiha qoʻllab-quvvatlovchisi, botlar va anonim identifikatorlar kiritilmagan hamda teng natijalar saqlab qolingan. Bu yuqoridagi birlashtirilgan PR reytingidan ham, quyidagi Git metamaʼlumotlariga asoslangan 639 kishilik roʻyxatdan ham farq qiladi.
> 🙏 Bu hissa qoʻshuvchilarning funksiyalari, xato tuzatishlari va infratuzilma yaxshilanishlari OmniRoute’ni ishonchli va funksiyalarga boy qiladigan jihatlarning **asosiy qismi**dir. Har bir pull request, har bir test holati va har bir i18n tarjima fayli muhim. Ochiq kodli 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 etishiga yordam beradi.
longtao 💛 Avvalgi bir martalik qoʻllab-quvvatlovchi
… va maxfiy qolishni afzal koʻrgan boshqalar 💛Ommaviy GitHub Sponsors maʼlumotlari 2026-08-24 sanasida qayta tekshirildi. Yuqoridagi faol yorliqlar GitHub'ning activeOnly holati asosida belgilanadi; avval oshkor qilingan ommaviy bir martalik qoʻllab-quvvatlovchilarga minnatdorchilik bildirishda davom etiladi, xususiy homiylar esa anonimligicha qoladi.💖 Homiy boʻling → — har bir dollar OmniRoute'ning bepul va mustaqil boʻlib qolishiga yordam beradi.
## 👥 600+ hissa qoʻshuvchi
[](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
2026-08-24 sanasida muzlatilgan ac02c5b42f bazasida audit qilindi va amaldagi release/v3.8.50 uchidagi dafb4ae808 holatida qayta tekshirildi: 639 ta normallashtirilgan inson Git identifikatori — ulardan 407 tasi commit muallifi sifatida (jumladan, loyiha kuzatuvchisi), 232 tasi esa faqat aniq Co-authored-by treylerlarida koʻrsatilgan. Hisob GitHub noreply identifikatorlarini normallashtiradi, 26 ta bot/agent/xizmat/toʻldiruvchi identifikatorni chiqarib tashlaydi va oddiy elektron pochta manzillarini faqat koʻrsatiladigan nomlari mos kelgani uchun birlashtirmaydi.
### Qanday hissa qoʻshish mumkin
1. Repozitoriyni fork qiling
2. **Faol** `release/vX.Y.Z` uchidan (`main`dan emas) branch yarating — [Branch yaratish va reliz modeli](docs/ops/BRANCHING_MODEL.md) bilan tanishing
3. Funksional branch'ingizni yarating (`git checkout -b feat/amazing-feature`)
4. Oʻzgarishlaringizni commit qiling (`git commit -m 'feat: add amazing feature'`)
5. Branch'ga push qiling (`git push origin feat/amazing-feature`)
6. **base = oʻsha `release/vX.Y.Z` branch** etib 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 ulkan loyihalar erishgan yutuqlarga tayanadi. U **[9router](https://github.com/decolua/9router)** loyihasining forki va Go tilidagi **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** loyihasining TypeScript porti sifatida boshlangan — shundan soʻng quyidagi har bir quyi tizim undan avval yaratilgan ochiq kodli loyihadan ilhomlangan. Ularning har biri OmniRoute’ning muayyan bir qismini shakllantirdi. Bu ularning barchasiga bildirgan minnatdorchiligimizdir. 🙏
> ⭐ yulduzlar soni GitHub REST API orqali 2026-yil 24-avgustda tekshirilgan — ushbu loyihalarga yulduz bering. Koʻrsatkichlar muayyan sanadagi aniq holatni aks ettiradi va tabiiy ravishda oʻzgarib boradi.
### 🧬 Kelib chiqish va shlyuz
Ochiq narxlash maʼlumotlar toʻplami xarajatlarni kuzatish sinxronizatsiyamizni taʼminlaydigan va provayderlarni meʼyorlashtirish modeli marshrutlashimizni shakllantirgan AI shlyuzi.
Brauzer seansi, javoblarni freymlash, foydalanish va veb-qidiruv adapterlarini oʻz ichiga olgan, ichki nusxa sifatida kiritilgan ChatGPT Web → Codex Responses koʻprigiga moslashtirilgan MIT manba kodi.
Claude Code bilan mos transformatsiyaning standart sozlamalari va hisob-kitob sarlavhasi xatti-harakati OmniRoute’ning konfiguratsiya orqali boshqariladigan koʻprigiga umumlashtirilgan.
Uning Grok model xaritalari, soxta TypeError Statsig generatori, soʻrov va qurilmaning standart sozlamalari hamda NDJSON javob protsessori OmniRoute’ning Grok Web ijrochisiga sezilarli darajada moslashtirilgan.
grok2api-merged ortidagi asosiy bilvosita kod manbai; uning model, sarlavha, foydali yuk, Statsig va protsessor implementatsiyalari Grok Web shajarasida saqlab qolingan.
TQZHR va grok2api-merged orqali oʻtgan Grok foydali yuki va qurilmaning standart sozlamalari, Statsig generatori hamda result.response protsessori uchun asosiy MIT manbasi.
grok2api-merged tomonidan uning proksi-pul qatlami uchun eʼtirof etilgan bilvosita manba; OmniRoute ushbu kelib chiqish eslatmasini saqlaydi, biroq oʻzining chegaralangan Grok Web ijrochisida proksi-pul porti mavjudligini daʼvo qilmaydi.
Dastlabki Grok Web implementatsiyasi uning HTTP/brauzer yuqori oqim dizayniga tayangan; uning toʻgʻridan-toʻgʻri HTTP yoʻli GrokProxy’dan kelib chiqqani sababli, mustaqil kod porti daʼvo qilinmaydi.
Virusdek tarqalgan «koʻp token ishlatish nega, oz token ishni bitirsa» loyihasi — uning gʻor odami uslubidagi falsafasi standart siqish rejimimiz hamda 30 dan ortiq toʻldiruvchi iboralarni olib tashlash/kondensatsiya qoidalarimiz asosini tashkil etadi.
Buyruq chiqishini yuqori unumdorlikda siqish — RTK mexanizmimiz, JSON filtrlash DSL’i, xom chiqishni tiklash va ketma-ket RTK → Caveman konveyerimiz uchun ilhom manbai boʻldi.
Promptlarni siqish tadqiqoti (LLMLingua / LLMLingua-2) — asinxron, kod uchun xavfsiz va xatoda asl holatga qaytuvchi llmlingua mexanizmimiz uchun ilhom manbai boʻldi.
PT-BR token siqilishi — pt-BR til paketimizni quvvatlaydi: Braziliya portugal tili grammatikasiga moslangan pleonazmlarni qisqartirish va toʻldiruvchi iboralarni olib tashlash.
Virusdek tarqalgan «dangasa yetakchi dasturchi» YAGNI-koder koʻnikmasi — less-code chiqish uslubimiz uchun ilhom manbai boʻldi: eng kichik ishlaydigan oʻzgarishga yoʻnaltirish orqali _yaratiladigan_ kodni qisqartiradi (Caveman’ning ixcham nasriga chiqish oʻqi boʻyicha qardosh uslub).
Uning ixcham grafik formati va umumiy profil dizayni OmniRoute’ning jadval asosidagi ixchamlashtirishi hamda Headroom kodek formatini shakllantirishga yordam berdi.
Bash chiqishini ixchamlashtirish + MCP profillari — siqishni oʻz vaqtida bekor qilish intizomimiz va MCP vositalari manifestini qisqartirish uchun ilhom manbai boʻldi.
Kontentni hisobga oluvchi, har bir fayl turiga mos va xatolar sababli bekor qilishni qoʻllovchi chiqish siqilishi — tur boʻyicha taqsimlashimiz va minimal yutuq boʻlmasa oʻtkazib yuborishimiz toʻgʻriligini tasdiqladi.
Rust’dagi ustunli JSON + kontent manziliga asoslangan olish + xabarlararo deduplikatsiya — headroom/ccr/session-dedup mexanizmlari dizaynimiz hamda kesh uchun barqaror «siqilgan shakl joylashuvga bogʻliq emas» invariantining toʻgʻriligini tasdiqladi.
TypeScript Compiler API vositalar toʻplami — satr, shablon va muntazam ifoda literallarini saqlab qoluvchi parser asosidagi izohlarni olib tashlashimiz uchun ilhom manbai boʻldi.
Kodlash yordamchisi ↔ LLM trafiki uchun MITM tutib olish/tahlil qilish imkoniyati 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 sanitizatsiya qilish — ochiq protokol standartlariga asoslangan mustaqil, noldan yaratilgan implementatsiyalar bilan almashtirildi. Xostni toʻgʻridan-toʻgʻri oʻtkazishning ikki interfeysi (passthrough.ts va _internal/bypass.cjs) mustaqil tasniflangan OmniRoute ichki implementatsiyalari boʻlib qolmoqda; ular ushbu almashtirish doirasida qayta yozilmagan.
Har bir jarayon uchun shaffof proksi marshrutizatsiyasi — nosozliklarga chidamli MITM yakunlash jarayonimiz, soketlarning harakatsizlik taym-autlari, /proc orqali jarayonni aniqlash va TPROXY trafikni tutib olish imkoniyatiga ilhom berdi.
Standart holatda xavfsiz boʻlgan kutubxonalarning saralangan roʻyxati; u xavfsizlik boʻyicha tanlovlarimizga yoʻl-yoʻriq koʻrsatadi (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).
Soʻrovlarni takrorlanishdan tozalash, favqulodda holatda nol xarajatli zaxira variantiga oʻtish, ulanadigan Auto-Combo strategiyalari va koʻp tilli maqsad tasnifiga ilhom berdi.
Uning hisobga bogʻliq modelni qayta xaritalash, bajariluvchi fayl yoʻlini tekshirish va tarif yorligʻi xatti-harakati OmniRouteʼning Antigravity ijro muhitini shakllantirishga yordam berdi.
Grok Build kvota interfeysini aniqladi; shundan soʻng OmniRoute amaldagi uzatish formatini mustaqil ravishda tekshirdi va tuzatdi.
## 📄 Litsenziya
MIT litsenziyasi — batafsil maʼlumot uchun [LICENSE](LICENSE) fayliga qarang.
---
**[⬆ Yuqoriga qaytish](#-omniroute)** · Ochiq kodli sunʼiy intellekt hamjamiyati uchun ❤️ bilan yaratildi.
OmniRoute v3.8.52 · Node ≥22.22.2 · MIT litsenziyasi · omniroute.online
> Jonli `/dashboard/free-tiers` sahifasining animatsion qisqacha koʻrinishi. Toʻliq metodologiya (pullarni 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 oʻzgaradi** — provayder bepul tarifni bekor qilsa, raqam kamayadi; yangisi qoʻshilsa, u oshadi. Biz eng yaxshi holatni yuqoriga yaxlitlab emas, balki katalog amalda hisoblagan natijani eʼlon qilamiz.
```bash
# Provayderni ulagandan 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":"Salom!"}]}'
```
`auto` uchun mos marshrut kerak. Yangi oʻrnatmada kalitsiz mos nishonlar boʻlmasligi mumkin, kalitsiz provayder esa uchinchi tomon mijozlarini rad etishi mumkin. `tos: avoid` bilan belgilangan provayderlar, jumladan OpenCode Free va 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/)
> **Kombo** — OmniRoute **avtomatik ravishda** marshrutlaydigan modellar zanjiri. Kvota tugasa, provayder ishlamay qolsa yoki xarajatlar keskin oshsa, kombo keyingi mos va sog‘lom modelga o‘tishi mumkin. 🛡️
### ⚡ Nol konfiguratsiya — shunchaki `auto`dan foydalaning
Kombo yaratish shart emas. Modelingizni `auto`ga (yoki uning variantlaridan biriga) sozlang va OmniRoute ulangan provayderlaringizdan real vaqt rejimida baholanadigan virtual kombo yaratadi:
📖 [Auto-Combo mexanizmi](docs/routing/AUTO-COMBO.md) · [Barqarorlik bo‘yicha qo‘llanma](docs/architecture/RESILIENCE_GUIDE.md)
📊 To‘liq metodologiya va har bir xususiyat bo‘yicha 9router, OpenRouter, CLIProxyAPI hamda LiteLLM bilan batafsil taqqoslash → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)
Kalit (tasodifiy): `5d865059-bc44-483a-962d-43ceb80126eb`
Pix’dan nusxalash va joylash:
```
00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD
```
📖 [Avtorizatsiya](docs/architecture/AUTHZ_GUIDE.md) · [Himoya cheklovlari](docs/security/GUARDRAILS.md) · [Muvofiqlik](docs/security/COMPLIANCE.md)
Standart ketma-ket kombinatsiya `RTK → Caveman` tartibida ishlaydi. Ikkalasi ham ayni vosita/kontekst yuklamasiga taʼsir qilganda, tejash ko‘paytma asosida 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 tuzilmali maʼlumotlar saqlash mexanizmi tomonidan **har doim himoyalanadi**.
> **Oz token kifoya qilsa, nega koʻp token ishlatish kerak?** Har bir soʻrov OmniRoute siqish konveyeridan **shaffof tarzda** oʻtadi — mijoz tomonida hech qanday oʻzgartirish kerak emas. Endi bu tartib bilan ishlaydigan va har bir marshrutlash kombinatsiyasida erkin aralashtirib qoʻllanadigan **12 ta birlashtiriladigan mexanizmdan iborat stek** — u [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 mexanizmli stek
Mexanizmlar konveyer tartibida ishlaydi; har birini mustaqil ravishda yoqib-oʻchirish va har bir kombinatsiya uchun sozlash mumkin:
