## 💰 Üçüncü Tərəflərin Pulsuz Tarifləri üzrə Ayda ~1.62B Token
> **Öz provayder hesablarınızı qoşun.** Bu, OmniRoute tərəfindən verilən token paketi deyil, ayrıca uyğunluq şərtlərinə malik üçüncü tərəf pulsuz tariflərinin təxmini ümumi həcmidir. Qeydiyyatdan keçin, tələb olunan hallarda giriş məlumatlarını əldə edin və istifadə edə bildiyiniz provayderləri qoşun; hər bir provayder öz limitlərini, əlçatanlığını və şərtlərini özü müəyyən edir.
>
> Pulsuz tarifləri əl ilə birləşdirmək əziyyətlidir — onlarla SDK, onlarla sorğu limiti və əslində nə qədər resursunuzun olduğu barədə heç bir təsəvvür yoxdur. OmniRoute **35 təkrarlanan hovuz açarı üzrə 485 pulsuz tarif qeydini** kataloqlaşdırır və token göstəricisini **dərc edilmiş müsbət aylıq büdcəsi olan 17 hovuz və hər model üçün beş Groq limiti** əsasında, ortaq hovuzları təkrarlamadan hesablayır. Yalnız regional şəxsiyyət yoxlamasından sonra açılan kvotalar (hazırda: ModelScope) ayrıca göstərilir — regional şəxsiyyət təsdiqindən sonra +~6M — və heç vaxt əsas göstəriciyə əlavə edilmir. Nəticə idarəetmə panelində (`/dashboard/free-tiers`) daim görünür.
> Canlı `/dashboard/free-tiers` səhifəsinin animasiyalı xülasəsi. Tam metodologiya (hovuzların təkrarsızlaşdırılması, kredit səviyyələri, provayder şərtləri): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**.
>
> Bu rəqəmlər hər iki həftədən bir canlı kataloq əsasında yenidən yoxlanılır və **hər iki istiqamətdə dəyişir** — provayder pulsuz tarifi dayandırdıqda rəqəm azalır, yenisi əlavə olunduqda isə artır. Biz yuvarlaqlaşdırılmış ən yaxşı ssenarini deyil, kataloqun faktiki hesabladığı nəticəni dərc edirik.
⭐ OMNIROUTE pulunuza qənaət etməyə və işinizi asanlaşdırmağa kömək edibsə, repoya ulduz verin.
[](https://github.com/diegosouzapw/OmniRoute)
[](https://www.star-history.com/diegosouzapw/omniroute)
[](https://olud.ai/project/diegosouzapw-omniroute.html)
### 💬 İcmaya qoşulun
**👋 Müşayiətçini izləyin — yeni provayderlər, buraxılışlar və məsləhətlərdən ilk siz xəbərdar olun:**
[](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)
**Suallar, provayder məsləhətləri, yol xəritəsi və dəstək → [Discord](https://discord.gg/U47eFqAXCn) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 Qlobal](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) / [🇧🇷 Braziliya](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)**
## 📈 Şlüz Böyüməyə Davam Edir
## 🆓 Quraşdırın, provayderə qoşulun, sonra trafiki vahid son nöqtə üzərindən yönləndirin
```bash
# Provayderə qoşulduqdan sonra OmniRoute açarınızı İdarəetmə paneli → Son nöqtələr bölməsindən kopyalayın:
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` uyğun bir marşrut tələb edir. Yeni quraşdırmada açarsız uyğun hədəflər olmaya bilər və açarsız provayder üçüncü tərəf müştərilərini rədd edə bilər. OpenCode Free və Kiro daxil olmaqla, `tos: avoid` ilə işarələnmiş provayderlər standart olaraq avtomatik yönləndirmədən kənarlaşdırılır; hesabın qoşulması bu parametri ləğv etmir. Provayder seçməzdən əvvəl [Pulsuz Səviyyələr üzrə Təlimat](docs/getting-started/FREE-TIERS-GUIDE.md) ilə tanış olun.📦 **Python, Node.js, PHP və cURL** üçün kopyalayıb yapışdırmağa hazır sürətli başlanğıc skriptləri → [`examples/quickstart/`](examples/quickstart/)
# 💥 Vədimiz
# 🤔 Niyə OmniRoute?
## 🤝 Açıq Mənbə Dostlarımız tərəfindən dəstəklənir
> **Açıq Mənbə Dostu kimi qoşulmaq istəyirsiniz?** Bunlar açıq mənbəni dəstəkləyən və OmniRoute-un inkişafını davam etdirməsinə kömək edən şirkətlərdir — onların bizə verdiyi hər bir tokenin hara xərcləndiyini də açıq şəkildə bildiririk. Əlaqə saxlayın: [diegosouza.pw@outlook.com](mailto:diegosouza.pw@outlook.com)
Kimi Moonshot AI
Bu layihəni dəstəklədiyinə görə təsisçi Açıq Mənbə Dostumuz Kimi-yə (Moonshot AI) təşəkkür edirik! Kimi açıq çəkili K2 və K3 model ailələrinin arxasında duran süni intellekt laboratoriyasıdır — Kimi K3 1M tokenlik kontekst pəncərəsi, yerli görüntü dəstəyi və qapalı modellərin qiymətinin kiçik bir hissəsi müqabilində qabaqcıl səviyyəli kodlaşdırma təqdim edir, həmçinin Claude Code, Codex və OmniRoute-un xidmət göstərdiyi bütün kodlaşdırma alətləri ilə heç bir əlavə sazlama olmadan işləyir.
Kimi-nin dəstəyi nələri təmin edir: Kimi-nin API kreditləri OmniRoute-un süni intellektlə təsdiqlənən buraxılış konveyerini — hər bir pull request-i yayımlanmadan əvvəl nəzərdən keçirən Kimi K3 tərəfindən dəstəklənən birləşdirmə yoxlaması mərhələsini — və gündəlik funksiya inkişafını təmin edir. Birinci dərəcəli Kimi dəstəyi hər iki kanal üzrə təqdim olunur: birbaşa Kimi API (kimi-k3) və Kimi Code kodlaşdırma planı (OAuth və API açarı). OmniRoute həmçinin Kimi-nin dəstək proqramındakı ilk Braziliya açıq mənbə layihəsidir. 15% əlavə kreditlə Kimi API açarı əldə edin →
Cheaper Inference cheaperinference.com
Bu layihəni dəstəklədiyinə görə OmniRoute-un Açıq Mənbə Dostu Cheaper Inference-ə təşəkkür edirik! Cheaper Inference, 42 qabaqcıl modeli — Claude, GPT-5.x, Gemini, Kimi K3, GLM, DeepSeek, Grok və MiniMax — vahid OpenAI-uyğun son nöqtə vasitəsilə yenidən satan və hər bir sorğunu model istehsalçısının siyahı qiymətindən artıq ödəniş tələb etmədən ən ucuz uyğun provayderə yönləndirən, qiymətə görə sıralanmış şlüzdür.
OmniRoute-da birinci dərəcəli dəstək: Chat Completions, yerli /v1/responses son nöqtəsi, görüntü, alət çağırışı və 3 görüntü modeli (grok-imagine, nano-banana-pro, nano-banana-2, cheaperinference/<model> kimi əlçatandır). API açarı əldə edin →
aff=omniroute ilə işarələnmiş keçidlər tərəfdaş keçidləridir. Onlar sizə heç bir əlavə xərc yaratmadan layihəni maliyyələşdirir. 🎟️ Tərəfdaş Promosiyası — sponsorluq etmədiyimiz provayderlərdən pulsuz qeydiyyat kuponları (genişləndirmək üçün klikləyin)Bu bölmə yalnız yönləndirmə/kupon kodları üçündür. Sponsorlu tərəfdaşlıqlar yuxarıdakı 🤝 Açıq Mənbə Dostlarımız tərəfindən dəstəklənir bölməsində yerləşir. OmniRoute-un burada sadalanan provayderlərlə heç bir sponsorluq və ya tərəfdaşlıq əlaqəsi yoxdur — bunlar hər kəsin istifadə edə biləcəyi açıq kuponlardır.
AgentRouter agentrouter.org
AgentRouter — tərəfdaş qeydiyyatı · qeydiyyat zamanı $100 pulsuz kredit (pulsuz server, daha yüksək gecikmə gözləyin — istehsal üçün deyil, test üçün daha uyğundur). v3.8.50 versiyasından etibarən OmniRoute-da birinci dərəcəli dəstək: Chat Completions, Anthropic-uyğun ötürmə formatı və OpenAI-uyğun yol. Mövcud modellərə claude-opus-4-8, claude-opus-5, gpt-5.6-sol və digərləri daxildir. $100 kreditinizi əldə edin →
⚠️ Tərəfdaş keçidi — OmniRoute-un bu provayderlə heç bir sponsorluq və ya tərəfdaşlıq əlaqəsi yoxdur.
OmniRoute istifadəçilərinə fayda verən səxavətli pulsuz qeydiyyat kuponu təqdim edən başqa provayder tanıyırsınız? Issue açın, biz də onu buraya əlavə edək.
## 🎯 Kombolar — Əsas imkan
> **Kombo** OmniRoute-un **avtomatik** marşrutlaşdırdığı modellər zənciridir. Kvota tükənərsə, provayder nasaz olarsa və ya xərclər kəskin artarsa, kombo növbəti uyğun və işlək modelə keçə bilər. 🛡️
### ⚡ Sıfır konfiqurasiya — sadəcə `auto` istifadə edin
Kombo yaratmağa ehtiyac yoxdur. Modelinizi `auto` (və ya onun bir variantı) olaraq təyin edin və OmniRoute qoşulmuş provayderlərinizdən real vaxtda qiymətləndirilən virtual kombo yaratsın:
Model ID-si
Nə üçün optimallaşdırılır
auto
🎯 Balanslaşdırılmış standart seçim (LKGP — son uğurlu provayderinizə bağlı qalır)
auto/coding
🧑💻 Kod generasiyası üçün keyfiyyətə üstünlük verən çəkilər
auto/fast
⚡ Əvvəlcə ən aşağı gecikmə
auto/cheap
💰 Əvvəlcə token başına ən ucuz seçim
auto/offline
🔋 Əvvəlcə ən çox kvota / sürət limiti ehtiyatı
auto/smart
🔭 Keyfiyyətə üstünlük + daha yaxşı modelləri aşkarlamaq üçün 10% araşdırma
auto/lkgp
📌 Son məlum uğurlu provayderə açıq şəkildə bağlı qalma
auto/chaos
🧪 Modellər panelinə paralel paylama (hər provayderdən bir model, standart olaraq 5), bir cavab qaytarır; nasazlıq inyeksiyası deyil, paneldəki hər model üçün bir yuxarı axın çağırışı edilir
##
### 🔀 Yaxud öz kombonuzu yaradın — 19 marşrutlaşdırma strategiyası
Bütün **19** strategiya — hər kombo addımında qarışdırıb uyğunlaşdırın:
#
Strategiya
Nə edir
1
priority
İlk hədəfə üstünlük verən sıralı siyahı — növbəti hədəfə keçməzdən əvvəl hər birini tükəndirir 🥇
2
fill-first
Növbəti hədəfə keçməzdən əvvəl hər hədəfin kvotasını tam doldurur
3
weighted
Hər hədəfin çəkisinə əsaslanan çəkili təsadüfi seçim
4
round-robin
Hədəflər arasında ardıcıllıqla dövr edir
5
p2c
İki seçim prinsipinə əsaslanan təsadüfi yük balanslaşdırması
6
least-used
Cari yükü ən az olan hədəfi seçir
7
random
Bərabər ehtimallı təsadüfi seçim (təkrarlardan təmizlənmiş)
8
strict-random
Təkrarları aradan qaldırmadan təsadüfi seçim 🎲
9
cost-optimized
Canlı kataloq qiymətləri əsasında hər sorğu üçün $ xərcini minimuma endirir 💸
10
headroom
Ən çox qalan kvotaya malik hədəfi seçir
11
reset-window
Kvota pəncərəsi ən tez sıfırlanan hədəfə üstünlük verir
12
reset-aware
Kvotanın sıfırlanma vaxtına görə sıralayır — əvvəlcə qısa pəncərələr 📊
13
context-relay
Uzun söhbətlər üçün konteksti hədəflər arasında ötürür 🧠
14
context-optimized
Cari kontekst ölçüsünə ən uyğun hədəfi seçir
15
cache-optimized
Hər təkrar istifadə edilə bilən sorğu prefiksini eyni hesaba bağlayır — sorğu keşi uyğunluqlarını maksimuma çatdırır 🎯
16
lkgp
Son Məlum Uğurlu Yol — son uğurlu provayderə bağlanır, sonra qaydalara əsasən ehtiyat seçimə keçir
17
auto
Hər bağlantı üzrə 16 amilli real vaxt qiymətləndirməsi 🤖
18
fusion
Modellər panelinə paralel paylayır + hakim bir cavabı sintez edir 🧬
19
pipeline
Addımları zəncirləyir — hər hədəfin çıxışı növbəti hədəfə ötürülür 🔗
Auto-Combo mühərriki hər namizədi **16 amil** (işlək vəziyyət, kvota, xərc, gecikmə, tapşırığa uyğunluq, keyfiyyət, sessiyanın əlçatanlığı…) üzrə qiymətləndirir — [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md) sənədinə baxın.
##
### 🧱 Dayanıqlılıq daxildən təmin edilir (3 müstəqil qat)
📖 [Avtomatik Kombinasiya Mühərriki](docs/routing/AUTO-COMBO.md) · [Dayanıqlılıq Bələdçisi](docs/architecture/RESILIENCE_GUIDE.md)
## 🏆 OmniRoute-u fərqləndirən nədir
📊 Tam metodologiya və 9router, OpenRouter, CLIProxyAPI və LiteLLM ilə müqayisədə hər xüsusiyyət üzrə ətraflı məlumat → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)
## 💚 OmniRoute-u dəstəkləyin
OmniRoute MIT lisenziyalıdır və açıq şəkildə dəstəklənir. Əgər vaxtınıza və ya pulunuza qənaət edirsə, onun müstəqilliyini qorumağa belə kömək edə bilərsiniz — sizə uyğun olanı seçin. Sponsorluq heç vaxt yönləndirmə prioritetinə təsir etmir; reytinq deyil, görünürlük qazandırır.
**🇧🇷 PIX** — ani, komissiyasız (Braziliya)
Açar (təsadüfi): `5d865059-bc44-483a-962d-43ceb80126eb`
Pix kopyala və yapışdır:
```
00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD
```
₿ Kriptovalyuta — BTC · ETH · USDT-TRC20 · USDC-Solana (genişləndirmək üçün klikləyin)
₿ BTC
Bitcoin (SegWit)
bc1qh00smz004sy85wyl28v77tenkt3ckl6eaep7fd
Ξ ETH
Ethereum (ERC20)
0x64Cf6B68A6Ff34288e89172950a2d00102337a84
₮ USDT
Tron (TRC20)
TKAF41JpuQrHbKTnsQa9svJE2T192Hvsc2
$ USDC
Solana
2emNNZzVVWQc3FQ2wk9M6qXUQmW8AKdjjL174fXR28Tu
⚠️ Hər bir kriptovalyutanı yalnız göstərilən şəbəkə üzərindən göndərin — yanlış şəbəkə üzərindən göndərmək vəsaitin itirilməsinə səbəb ola bilər.
🐛 Xəta tapmısınız və ya rəyiniz var? [Müzakirə](https://github.com/diegosouzapw/OmniRoute/discussions) açın.
Tərtibatçı qeydləri: Layihə tərtibatçıların rahatlığı üçün npm install/postinstall zamanı lokal .env faylı yarada bilər. Bu fayl qəsdən .gitignore vasitəsilə nəzərə alınmır (.gitignore faylına baxın) və heç vaxt repozitoriyaya əlavə edilməməlidir — təsadüfən əlavə edilərsə, ifşa olunmuş bütün məxfi məlumatları yeniləyin və faylı tarixçədən silin. Lokal mühit fayllarının və məxfi məlumatların idarə edilməsinə dair təlimatlar üçün docs/DEVELOPER-ENVIRONMENT.md sənədinə baxın.
## 📡 OmniRoute Radar
Yuxarıda sənədləşdirilmiş, hovuz üzrə dublikatları aradan qaldırılmış kataloqdan əsas pulsuz tarif göstəricisi **ayda ~1.62B token** olaraq qalır. Provayderlərin müvəqqəti qeydiyyat kreditləri ilk ayın həcmini ayrıca **~2.22B**-a qədər artıra bilər. Radar, OmniRoute buraxılışları arasında pulsuz modellərin mövcudluğu barədə daha aktual məlumat almaq istəyənlər üçün nəzərdə tutulmuş, imzalanmış və istifadəsi ixtiyari olan kataloq əlavəsidir; icma kataloqu və mövcud bütün pulsuz funksiyalar pulsuz olaraq qalır.
Dəstəkçilər canlı kataloqa və əlavə provayder imkanlarına çıxış əldə edə bilərlər. Onun ayrıca, dəyişkən yuxarı həddi provayderlərin mövcudluğundan asılı olaraq **ən çoxu təxminən ayda 3B token** təşkil edir. Bu yuxarı həddə zəmanət verilmir: provayderlər kvotaları, uyğunluq tələblərini, modelləri və ya regionları istənilən vaxt dəyişə bilərlər.
Radar-a qoşulmaq ixtiyaridir və o, yalnız GET sorğularından istifadə edir. OmniRoute müştərisi promptları, trafiki, provayder konfiqurasiyasını, istifadə telemetriyasını və ya elanların rədd edilməsi ilə bağlı lokal vəziyyəti göndərmir. Uyğunluq tələbləri və cari kataloq haqqında məlumatı **[radar.omniroute.online/planos](https://radar.omniroute.online/planos)** ünvanından əldə edin.
## ✨ Yeniliklər
> **v3.8.20 → v3.8.50** versiyalarındakı son əsas yeniliklər. Tam tarixçə [`CHANGELOG.md`](CHANGELOG.md) faylındadır.
- **🎛️ OmniConductor** — agentlər parkınıza daxil olan A2A delegasiyası, Agent Card üzərində Conductor bacarıqları və Faro bas-danış səsli söhbəti olan idarə paneli. → [A2A Serveri](docs/frameworks/A2A-SERVER.md)
- **🛂 Adaptiv qəbul və həddindən artıq yüklənmədən qorunma** — yüksək resurs tələb edən söhbət sorğuları 503 xətası qaytarmaq əvəzinə növbəyə alınır və hər bağlantı üçün atomik RPM sürüşən icarələri tətbiq olunur. → [Dayanıqlılıq Təlimatı](docs/architecture/RESILIENCE_GUIDE.md)
- **🗂️ Kanonik `/v1/models` sıralaması** — hər provayder üçün bir bitişik, provayderə görə qruplaşdırılmış blok (kombinasiyalar əvvəlcə sabitlənir), bütün kataloq mənbələrində sabitdir. → [API Arayışı](docs/reference/API_REFERENCE.md)
- **🗜️ Sıxılmanın möhkəmləndirilməsi** — standart olaraq aktiv açılma qoruyucusu, DE / FR / JA + Çin dili (wényán) üçün Caveman paketləri, Gradle və .NET üçün RTK filtrləri. → [Sıxılma](docs/compression/COMPRESSION_ENGINES.md)
- **💸 Dürüst sabit tarif xərci** — abunəlik / kodlaşdırma planı provayderləri xərc analitikasında **$0** kimi göstərilir; büdcə, kvota və marşrutlaşdırma isə təxmin etməyə davam edir. → [API Arayışı](docs/reference/API_REFERENCE.md)
- **⚖️ Quota-Share marşrutlaşdırması** — ortaq hesabın kvotasını hovuzdakı açarlar arasında ədalətli bölür və boş payların istifadəyə verilməsi sayəsində iş tutumunu qoruyur. → [Dayanıqlılıq Təlimatı](docs/architecture/RESILIENCE_GUIDE.md)
- **🤖 Bir əmrlə CLI/agent quraşdırması** — 13 qeydiyyatdan keçmiş `setup-*` əmri; `omniroute run` 7 CLI-ni (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI) işə salır; `omniroute configure` interaktiv provayder+model seçicisi və hər kontekst üçün sevimlilərlə 10 hədəfi dəstəkləyir. → [CLI İnteqrasiyaları](docs/guides/CLI-INTEGRATIONS.md)
- **🛰️ Uzaq rejim** — əhatə dairəsi məhdud tokenlər (`connect` / `contexts` / `tokens`) və VPS quraşdırmaları üçün `antigravity` OAuth köməkçisi ilə uzaqdakı OmniRoute-u idarə edin. → [Uzaq Rejim](docs/guides/REMOTE-MODE.md)
- **🧭 Daha ağıllı avtomatik marşrutlaşdırma** — `auto/:` kombinasiyaları, **Fusion** (model paneli + hakim), tapşırıqdan xəbərdar marşrutlaşdırma, hər sorğu üçün model / rejim / USD büdcəsi əvəzləmələri. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🗜️ Qoşula bilən sıxılma** — 12 birləşdirilə bilən mühərrik + Compression Studios: LLMLingua-2, iki səviyyəli Ultra, omniglyph, hər addım üzrə dəqiqlik keçidi, GCF v3.2, sürükləyərək yenidən sıralama redaktoru. → [Sıxılma](docs/compression/COMPRESSION_ENGINES.md)
- **🕵️ Şəffaf MITM deşifrələməsi (TPROXY)** — proksi mühit dəyişənlərinə məhəl qoymayan CLI-ləri hər SNI üçün CA və etibar deposu quraşdırıcısı ilə ələ keçirin. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md)
- **💸 Hər yerdə xərc telemetriyası** — hər son nöqtədə `X-OmniRoute-*` xərc/istifadə başlıqları, keş-HIT qənaət başlığı, hər açar üzrə USD xərcləmə kvotaları. → [API Arayışı](docs/reference/API_REFERENCE.md)
- **🧠 İdarə etdiyiniz yaddaş** — standart olaraq deaktivdir, seçim əsasında int8 vektor kvantlaşdırması + tipləşdirilmiş zəifləmə, hər sorğu üçün `x-omniroute-no-memory`. → [Yaddaş](docs/frameworks/MEMORY.md)
- **🛡️ Təhlükəsizlik** — hər LLM marşrutunda prompt inyeksiyası qoruyucusu (red-team test dəsti), seçim əsasında etimadnamə maskalama qoruyucusu (hər iki istiqamətdə sızan API açarlarını/sirlərini redaktə edir), pulsuz DuckDuckGo son çarə veb axtarışı və idarə paneli üçün istəyə bağlı OIDC giriş keçidi (parolla giriş həmişə əlçatan qalır). → [Qoruyucu Mexanizmlər](docs/security/GUARDRAILS.md)
- **🖼️ Yeni son nöqtələr** — `/v1/ocr` (Mistral OCR) və `/v1/audio/translations` (Whisper üslubunda) media imkanlarını tamamlayır. → [API Arayışı](docs/reference/API_REFERENCE.md)
- **🎨 Şəkil / video / audio generasiyası** — media üçün vahid API: xAI Grok Imagine və Novita AI video, ComfyUI, Magnific, Adobe Firefly, Segmind və ElevenLabs kimi nitq provayderləri. → [API Arayışı](docs/reference/API_REFERENCE.md)
- **🌍 Yerləşdirmə və əməliyyatlar** — əks proksi `basePath`, brauzer dilinin avtomatik aşkarlanması, hər açar üzrə cihaz izlənməsi, root-suz MITM etibarı, zh-TW lokallaşdırması. → [Mühit](docs/reference/ENVIRONMENT.md)
- **🤝 Daha çox provayder və agent** — bulud agentləri (Codex Cloud, Cursor, Devin, Jules), brauzer + OAuth girişi ilə Grok Build (xAI), birinci dərəcəli Ollama kartı, Claude Opus 5 və Sonnet 5, Kimi rəsmi tərəfdaşlığı (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… və yenilənmiş **372 provayderlik kataloq**. → [Provayderlər](docs/reference/PROVIDER_REFERENCE.md)
- **📡 Marşrutlaşdırma şəffaflığı** — hər cavab ona xidmət göstərən strategiyanı/provayderi/gecikməni bildirən `X-OmniRoute-Decision` başlığı daşıyır; yeni `cache-optimized` kombinasiya strategiyası + Auto-Combo `cacheAffinity` amili təkrar sorğuları keşlənmiş prefiksi saxlayan bağlantıya geri yönəldir; yalnız oxuna bilən `/v1/auto-combo/{channel}/candidates` son nöqtəsi isə `auto/*` kanalının canlı namizəd hovuzunu təqdim edir. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **⚡ Lokal performans və infrastruktur** — bir kliklə lokal Redis, Cloudflare Workers / Deno Deploy rele yerləşdiriciləri, nəzarət olunan daxili xidmətlər kimi Bifrost və Mux. → [Daxili Xidmətlər](docs/frameworks/EMBEDDED-SERVICES.md)
- **🧩 Paketə həmçinin daxildir** — plagin çərçivəsi + marketpleys, Omni/Agent/GitHub bacarıq çərçivələri, Obsidian vault inteqrasiyası (22 MCP aləti), OpenAI-uyğun Batch və Files API-ləri, semantik cavab keşi, lider cədvəlləri ilə oyunlaşdırma, ACP agent aşkarlanması (15 daxili agent), BigQuery-yə planlaşdırılmış jurnal ixracı, `auto/chaos` paralel çoxmodelli şaxələnməsi, Telegram bot körpüsü, tətbiqdaxili versiya meneceri və LMArena-ELO pulsuz provayder reytinqləri. → [Sənədlər](docs/README.md)
## 🤖 Uyğun CLI-lər və Kodlaşdırma Agentləri
> Bir konfiqurasiya — `http://localhost:20128/v1` — və **hər bir** süni intellekt IDE-si və ya CLI pulsuz və aşağı qiymətli modellərdə işləyir.
📖 Bütün 36 alət üçün ayrıca quraşdırma (26 CLI Code + 10 CLI Agent) → [`docs/reference/CLI-TOOLS.md`](docs/reference/CLI-TOOLS.md) · 🧩 OpenCode plagini → [`@omniroute/opencode-provider`](https://www.npmjs.com/package/@omniroute/opencode-provider)
**Dəstəklənən istənilən CLI-ni OmniRoute vasitəsilə bir əmrlə başladın** — heç bir konfiqurasiya faylı yazılmır,
giriş məlumatları hər proses üçün ayrıca ötürülür, Qwen/Gemini isə birdəfəlik, təcrid olunmuş ev qovluğu əldə edir:
```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"
# Yaxud provayderi və modeli interaktiv şəkildə seçin və alətin öz konfiqurasiyasını yazın:
omniroute configure codex # həmçinin: claude opencode qwen aider goose gemini cline continue kilo
```
Hər bir əmr aktiv uzaq konteksti (`omniroute connect `) nəzərə alır, `--dry-run`
icra etmədən dəqiq mühit dəyişənlərini/arqumentləri əvvəlcədən göstərir, `--api-key-env NAME` isə məxfi məlumatların
əmr tarixçənizə düşməsinin qarşısını alır. → [CLI inteqrasiyaları](docs/guides/CLI-INTEGRATIONS.md)
## 🌐 372 AI Provayderi — 154-ü Kataloqda Pulsuz Olaraq İşarələnib
> Kanonik çat, media, axtarış, lokal, bulud agenti və sistem kolleksiyaları üzrə **372 qeydiyyatdan keçmiş provayder**, o cümlədən **`hasFree: true` aşkarlama metadatasına malik 154 provayder**. Çat modelləri reyestri **237 provayderi / 3,009 fərqli provayder-model cütünü / 1,443 xam model ID-sini** əhatə edir; ayrıca pulsuz büdcə kataloqunda isə **modellər üzrə 485 sətir**, **35 təkrarlanan hovuz** və **53 təkrarlanan/açarsız, həmişəlik pulsuz provayder** var. Bunlar məqsədli şəkildə fərqli məxrəclərdir; təriflər və hovuzlar üzrə dublikatları çıxarılmış hesablamalar [Provayder Arayışı](docs/reference/PROVIDER_REFERENCE.md) və [Pulsuz Tariflər](docs/reference/FREE_TIERS.md) bölmələrində təqdim olunur.
### 🏢 Bütün əsas laboratoriyalar — vahid son nöqtə vasitəsilə
OpenAI
Anthropic
Gemini
xAI Grok
DeepSeek
Mistral
Qwen
Meta Llama
Groq
NVIDIA
MiniMax
Cohere
Perplexity
HuggingFace
Together
Fireworks
Cloudflare
Baidu
…və daha 330+ provayder — hər bir ikon birbaşa idarəetmə panelinin provayder kataloqundan yüklənir. 📖 [Provayder Arayışı](docs/reference/PROVIDER_REFERENCE.md)
### 🆓 Həmişəlik Pulsuz — $0, kart tələb olunmur
OpenCode Zen DeepSeek V4, Nemotron 3 Token limiti yoxdur
Kilo Code Avtomatik marşrutlaşdırıcı, Tencent Hy3 Həmişə pulsuz
Requesty GPT-OSS 120B, Nemotron Həmişə pulsuz
SiliconFlow DeepSeek V3.2 / R1 Pulsuz tarif
Z.AI GLM GLM-4.7 / 4.5-Flash Həmişə pulsuz
Baidu ERNIE ERNIE 4.0 Həmişə pulsuz
Qoder AI Qwen3-Max, Kimi-K2 Limitsiz və PULSUZ
Pollinations GPT, Llama, Claude Açar tələb olunmur
Cloudflare AI 50-dən çox model Gündə 10K neyron
NVIDIA NIM GLM, MiniMax ~40 RPM pulsuz
Cerebras GLM 4.7, GPT-OSS Birdəfəlik $5 kredit; kart tələb olunur
OpenRouter :free modellər +$10 → daha yüksək RPM
📖 Tam maşınla oxuna bilən kataloq → [`docs/reference/PROVIDER_REFERENCE.md`](docs/reference/PROVIDER_REFERENCE.md)
## 🖥️ OmniRoute harada işləyir — hər yerdə
> Eyni tətbiq, sizin cihazınız, sizin qaydalarınız. Qlobal npm quraşdırmasından Termux vasitəsilə **telefonunuza** qədər.
Platforma
Quraşdırma
Üstünlüklər
📦 npm (qlobal)
npm install -g omniroute
Bir əmr, istənilən OS
🐳 Docker
docker run … diegosouzapw/omniroute
Çoxarxitekturalı AMD64 + ARM64
🖥️ Masaüstü (Electron)
npm run electron:build
Doğma pəncərə + sistem paneli — Windows / macOS / Linux
🎩 Menyu paneli (OmniRouteTray)
brew install --cask zoispag/tap/omniroute-tray
Serverə nəzarət edir və onu avtomatik yeniləyir — macOS
💪 ARM
doğma arm64
Raspberry Pi, ARM serverləri, Apple Silicon
📱 Android (Termux)
pkg install nodejs && npx -y omniroute
Telefonunuzda 24/7 işləyir, root tələb etmir
📲 PWA
"Əsas ekrana əlavə et"
Tam ekranlı, oflayn, brauzerdən quraşdırıla bilən
🧩 OpenCode plagini
@omniroute/opencode-provider
Doğma OpenCode inteqrasiyası
🤖 VS Code Copilot Chat
OmniCopilot genişlənməsini quraşdırın
Bütün OmniRoute modelləri doğma Copilot Chat seçim siyahısında — stabil və Insiders
### 🧩 Yeni: VS Code-un doğma Copilot Chat interfeysində OmniRoute
> Yeni yan panel və ya yeni söhbət interfeysi yoxdur — OmniRoute-un təqdim etdiyi hər bir model birbaşa
> **artıq istifadə etdiyiniz Copilot Chat model seçimində** görünür. VS Code 1.122 versiyasından etibarən provayder modelləri
> GitHub hesabına daxil olmadan və ya Copilot abunəliyi olmadan işləyir — agent rejimi, alət çağırışı və görüntü dəstəyi
> pulsuzdur.
**[OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)** genişlənməsini quraşdırın, onu
OmniRoute serverinizə yönəldin (standart olaraq `localhost:20128`), sonra Copilot Chat → model seçimi
→ **Modelləri idarə et…** → **OmniRoute** yolunu açın.
Redaktorun daxilində: **Extensions** görünüşünü açın, **"OmniRoute"** axtarın və **Quraşdır** düyməsinə klikləyin
— hər iki mağazada eyni qaydada işləyir. Mənbə kodu, problem bildirişləri və dərcetmə təlimatı
[diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot) ünvanındadır.
📖 [VS Code Copilot Chat təlimatı](docs/guides/VSCODE-COPILOT.md) — quraşdırma, seçim siyahısında göstərilənlər, ayrıca tabda idarəetmə paneli, problemlərin aradan qaldırılması
### 🎩 Yeni: OmniRouteTray — menyu panelində yaşayan şlüzünüz
> `omniroute serve` daim işlədikdə özünü ən yaxşı şəkildə göstərir. **[OmniRouteTray](https://github.com/zoispag/omniroute-tray)**
> bunu macOS üçün bir dəfə qurub unuda biləcəyiniz menyu paneli tətbiqinə çevirir: serveri başladır, yenidən
> yükləmələrdən sonra işlək saxlayır, yerində yeniləyir və cari token büdcənizi bir klik məsafəsində göstərir — **açıq
> terminal pəncərəsi saxlamağa və `npm install -g omniroute` quraşdırmasına daim nəzarət etməyə ehtiyac yoxdur.**
[Tauri v2](https://v2.tauri.app/) ilə hazırlanıb (yuvarlaqlaşdırma xətası qədər kiçik Rust nüvəsi), öz
imzalanmış Node 24 icra mühiti ilə təqdim olunur və tətbiqə məxsus OmniRoute quraşdırmasını idarə edir, buna görə də
qlobal `node`/`bun` ilə heç vaxt ziddiyyət yaratmır. O, **mövcud `~/.omniroute/` konfiqurasiyanızı və verilənlər bazanızı paylaşır** — yəni bu,
artıq işlətdiyiniz həmin OmniRoute-dur, sadəcə papaq taxıb. 🎩
Nə edir
Necə edir
🟢 Serverə nəzarət edir
omniroute serve prosesini başladır, dublikat yaratmaq əvəzinə artıq işləyən instansiyanı mənimsəyir
📊 Cari istifadəni bir baxışda göstərir
Provayder kvota panelləri, sıfırlanma geri sayımı ilə Claude sessiya/həftəlik limitləri, 30 günlük xərc bölgüsü
🔄 Yerində avtomatik yeniləyir
Mərhələli quraşdırma, atomar əvəzləmə, xəta zamanı geri qaytarma — həmişə ən yeni buraxılışda
🚀 Daxil olarkən başladır
Daxil olarkən istəyə bağlı başlatma; yalnız sistem panelindədir, dock nişanı yoxdur
🩺 Diaqnostika və jurnallar
Bir kliklə diaqnostika və server jurnallarına giriş
```sh
brew install --cask zoispag/tap/omniroute-tray
```
Endirməyə üstünlük verirsiniz? Ən son .dmg faylını
Buraxılışlar bölməsindən əldə edin. Mənbə kodu, problemlər və yığma
sənədləri zoispag/omniroute-tray ünvanındadır.
💛 @zoispag tərəfindən yaradılmış icma layihəsidir — rəsmi OmniRoute buraxılışı deyil.
> Serverdən əlavə, OmniRoute **80-dən çox əmri** olan **tam komanda sətri idarəetmə panelidir** və açıq agent protokolları sayəsində süni intellekt agenti onu **müstəqil şəkildə** idarə edə bilər.
### ⌨️ Əsl CLI (yalnız `start` deyil)
```bash
omniroute # şlüzü + idarəetmə panelini işə salır (port 20128)
omniroute chat # interaktiv TUI söhbət klienti (əmrlər: /model /combo /skill /memory)
omniroute setup # ilk işəsalma üçün addım-addım köməkçi
omniroute doctor # provayderləri, portları və yerli asılılıqları diaqnostika edir
```
### 🛰️ Uzaqdan rejim — CLI-ni burada, OmniRoute-u VPS-də işlədin
OmniRoute serverdədir? Onu noutbukunuzdan **eyni CLI** ilə idarə edin. Əhatə dairəsi məhdud giriş tokeni ilə bir dəfə daxil olun;
bundan sonra hər əmr uzaq serverə yönələcək.
```bash
omniroute connect 192.168.0.15 # parol → əhatə dairəsi məhdud token, kontekst kimi saxlanılır
omniroute models list # ← UZAQ serverdə icra olunur
omniroute configure codex # ← uzaq modeli seçir, lokal Codex profili yazır
omniroute tokens create --name ci --scope read # digər maşınlar üçün daha məhdud tokenlər yaradır
omniroute contexts use default # ← yenidən lokal serverə keçir
```
Tokenlərin əhatə dairəsi `read` / `write` / `admin` olur; proses yaradan marşrutlar yalnız loopback üçün əlçatan qalır.
📖 [Uzaqdan rejim](docs/guides/REMOTE-MODE.md)
### 🤝 Agent qoşun — OmniRoute-u özü idarə etsin
OmniRoute-u **MCP**, **A2A**, **REST API**, **webhook-lar** və ya **uzaqdan CLI** vasitəsilə əlçatan edin — imkanlı istənilən agent (və ya öz kodunuz) bütün şlüzü avtonom şəkildə idarə edə biləcək: marşrutlaşdırma, provayderlər, kombinasiyalar, keş, sıxılma, yaddaş. Aşağıdakı HTTP son nöqtələri `http://localhost:20128` ünvanı altında təqdim olunur.
İnterfeys
Son nöqtə / əmr
İstifadə məqsədi
🧰 MCP (stdio)
omniroute --mcp
Claude Desktop, Cursor və istənilən MCP klientinə qoşulma
🌊 MCP (HTTP)
/api/mcp/stream
Uzaqdan MCP — 110 alət, 33 əhatə dairəsi (məcburi tətbiq seçim əsasında), tam audit jurnalı
OpenAI ilə uyğun — söhbət, yerləşdirmələr, şəkillər, audio, OCR
🔔 Webhook-lar
/api/webhooks
Sorğu / kvota hadisələrini Slack, Discord, Telegram və ya istənilən URL-ə göndərmə
🛰️ Uzaqdan CLI
omniroute connect
Uzaq instansı əhatə dairəsi məhdud giriş tokenləri ilə idarə etmə
```bash
# Claude Code-a MCP üzərindən tam OmniRoute alətlər dəstini verin:
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 protokolları](docs/frameworks/AGENT_PROTOCOLS_GUIDE.md)
## 🗜️ Tokenlara 15–95% qənaət edin — Avtomatik olaraq
### 📖 Necə işləyir — konveyer, arxitektura və qənaət hesablaması
Defolt ardıcıl kombinasiya `RTK → Caveman` istifadə edir. Hər ikisi eyni alət/kontekst yükünə tətbiq edildikdə qənaət mürəkkəb şəkildə artır:
```txt
combined = 1 − (1 − RTK) × (1 − Caveman_input)
average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range = 78.4 – 94.6%
```
Kod blokları, URL-lər, JSON və strukturlaşdırılmış verilənlər qoruma mühərriki tərəfindən **həmişə qorunur**.
> **Az token kifayət edərkən niyə çox token istifadə edəsiniz?** Hər sorğu OmniRoute-un sıxlaşdırma konveyerindən **şəffaf şəkildə** keçir — müştəri tərəfində heç bir dəyişiklik tələb olunmur. Bu, artıq ardıcıllıqla işləyən və hər marşrutlaşdırma kombinasiyası üçün qarışdırılıb uyğunlaşdırıla bilən **12 birləşdirilə bilən mühərrikdən ibarət yığındır** — [RTK](https://github.com/rtk-ai/rtk), [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ 90K+), [LLMLingua-2](https://github.com/microsoft/LLMLingua) və [Troglodita](https://github.com/leninejunior/troglodita) (PT-BR) layihələrinin ideyaları əsasında qurulub.
### 🧱 12 mühərrikdən ibarət yığın
Mühərriklər konveyer ardıcıllığı ilə işləyir; hər biri ayrıca aktivləşdirilə və hər kombinasiya üçün konfiqurasiya edilə bilər:
#
Mühərrik
Nə edir
1
Session-Dedup
Dialoqun gedişləri boyunca təkrarlanan məzmunu silir (məzmun üzrə ünvanlanan, gedişlərarası)
2
CCR
Böyük blokları tələb əsasında əldə edilən çağırış markerlərinin arxasında arxivləşdirir
3
Lite
Boşluqları və şəkil URL-lərini ixtisar edir (az gecikməli baza rejimi)
4
RTK
Alət nəticələrini ağıllı şəkildə filtrləyir, təkrarları silir və ixtisar edir (əmrləri nəzərə alır)
5
Responses Tool Output
Shell/patch/axtarış/qurma çıxışları üçün əvvəlcə itkisiz JSON + məhdud diaqnostik sıxlaşdırma (Responses API)
6
Headroom
Daxilə daxil edilmiş GCF kodeki vasitəsilə JSON massivlərinin itkisiz cədvəlvari yığcamlaşdırılması (~30%)
7
Relevance
Son istifadəçi sorğusuna əsasən cümlələrin çıxarış yönümlü qiymətləndirilməsi
8
Caveman
Qaydalara əsaslanan mətn sıxlaşdırması (çıxışda ~65–75%)
9
Aggressive
Köhnə gedişlərin xülasələşdirilməsi və mərhələli köhnəldilməsi
10
LLMLingua-2
MobileBERT ONNX vasitəsilə ML əsaslı semantik budama — kod üçün təhlükəsiz, asinxron
11
Ultra
İxtiyari kiçik model (SLM) səviyyəsi ilə evristik token budaması
12
OmniGlyph
Birbaşa Anthropic bağlantısında ölçülmüş Claude Fable 5 üçün eksperimental kontekst-şəkil kodlaşdırması; provayder təsdiqləri əldə edilənədək GPT 5.6 transformerləri təhlükəsizlik məqsədilə bağlı qalır. Dörd sıxlaşdırma profili (defolt aqressiv, balanslaşdırılmış, kodlaşdırma üçün təhlükəsiz, dəyişikliksiz ötürmə) (ən aqressiv; ayrıca aktivləşdirilir)
Kod blokları, URL-lər və strukturlaşdırılmış verilənlər bayt səviyyəsində **həmişə qorunur**. **Bir kliklə seçilən hazır konfiqurasiyalar** mühərrikləri birləşdirir:
Rejim
Qənaət
Ən uyğun istifadə sahəsi
🪶 Lite
~15%
Həmişə aktiv, təhlükəsiz defolt
🪨 Standard (Caveman)
~30%
Gündəlik kodlaşdırma
⚡ Aggressive
~50%
Alətlərdən çox istifadə edilən uzun sessiyalar
🔥 Ultra
~75%
Maksimum qənaət
🧰 RTK
60–90%
Shell/test/qurma/git çıxışları
🔗 Stacked (RTK → Caveman)
78–95%
Qarışıq sorğular + alət jurnalları
**Real nümunə — Standard rejimi:**
> **Əvvəl (69 token):** _"React komponentinizin yenidən render edilməsinin səbəbi, çox güman ki, hər render dövründə yeni obyekt istinadı yaratmağınızdır. Prop kimi sətirdaxili obyekt ötürdükdə, React-in səthi müqayisəsi onu hər dəfə fərqli obyekt kimi görür və bu da yenidən render edilməni işə salır. Obyekti yadda saxlamaq üçün useMemo istifadə etməyi tövsiyə edərdim."_
>
> **Sonra (19 token):** _"Hər renderdə yeni obyekt istinadı. Sətirdaxili obyekt prop-u = yeni istinad = yenidən render. useMemo ilə əhatə edin."_
>
> **Eyni cavab. 72% daha az token. Dəqiqlik itkisi yoxdur.** ✅
**PT-BR nümunəsi — [Troglodita](https://github.com/leninejunior/troglodita) rejimi:**
> **Əvvəl (42 token):** _"Problem ondadır ki, hər render dövründə yeni obyekt istinadı yaradıldığı üçün komponent yenidən render olunur. `useMemo` istifadə etməyi tövsiyə edərdim."_
>
> **Sonra (12 token):** _"Yenidən render: hər dövrdə yeni istinad (inline obyekt yenidən yaradılır). `useMemo` istifadə edin."_
>
> **Eyni cavab. ~70% daha az token. Texniki dəqiqlik qorunub.** ✅
### 🎚️ Mühərriklərdən əlavə — çıxış üslubları, adaptiv tənzimləyici və hər sorğu üzrə idarəetmə
Yuxarıdakı 12 mühərrik daxil olanları kiçildir. Daha üç qat isə cavabın **necə**, **nə zaman** və hansı formada **çıxdığını** müəyyənləşdirir:
- **🪄 Çıxış üslubları** _(çıxış oxu üzrə yönləndirmə)_ — deterministik, keş üçün təhlükəsiz cavab formalaşdırma təlimatları əlavə edir; üslublar birləşdirilə bilər və hər biri `lite` / `full` / `ultra` intensivliyində işləyir. Üslub əlavə etmək reyestrə bir sətirlik qeyd daxil etmək qədər sadədir:
- **Yığcam mətn** — dolğu sözlərini / artiklları / qeyri-müəyyən ifadələri çıxarır; texniki məzmunu dəqiq saxlayır.
- **Daha az kod** — "tənbəl təcrübəli proqramçı" YAGNI yanaşması: işləyən ən kiçik dəyişiklik, tələb olunmamış əlavə struktur yoxdur.
- **Ponytail (tənbəl təcrübəli proqramçı)** — YAGNI pillələri ilə irəliləyir, əsas səbəbi aradan qaldırır, işləyən ən kiçik fərqi yaradır.
- **Məndə ADHD var (əvvəlcə əməl)** — növbəti əməl öndədir, addımlar nömrələnir, bir konkret növbəti addım verilir, giriş yoxdur.
- **Yığcam CJK (文言)** — klassik Çin dilində son dərəcə yığcam üslub (lokal üzrə yalnız `zh` üçün aktivdir).
- **🎯 Adaptiv kontekst büdcəsi** _(tənzimləyici)_ — vahid aktiv/deaktiv token həddi əvəzinə modelin kontekst pəncərəsinə **sığmaq üçün** ən ucuz və ən az itkili mühərrikləri yalnız lazım olan səviyyəyədək işə salır. Siyasət: `reserve-output` (standart, modeli nəzərə alır) · `percentage` · `absolute`. Rejim: `floor` (sığmanı təmin edir) · `replace-autotrigger` (açıq seçiminiz üstün olur) · `off` (köhnə hədd).
- **🎛️ Sıxışdırmanın müəyyən edildiyi yer** _(üstünlük sırası, yüksək → aşağı)_ — hər sorğu üzrə `x-omniroute-compression` başlığı › marşrutlaşdırma kombinasiyasının üstə yazması › aktiv adlandırılmış profil › adaptiv / avtomatik işəsalma › panelin standart ayarı › deaktiv. Tətbiq edilmiş plan cavabdakı `X-OmniRoute-Compression: ; source=` başlığında əks olunur.
Token həddinə əsasən avtomatik işəsalmanı qurun, adaptiv tənzimləyicini aktivləşdirin, adlandırılmış profili sabitləyin, sorğu üçün birdəfəlik parametr təyin edin və ya hər marşrutlaşdırma kombinasiyasına emal zənciri təyin edin — iş yükünə uyğun olanı seçin. Könüllü oflayn **qiymətləndirmə aləti** (`npm run eval:compression`) dəyişikliyi istifadəyə verməzdən əvvəl sabitlənmiş korpus üzərində uyğunluğu və qənaəti qiymətləndirir.
📖 [`COMPRESSION_GUIDE.md`](docs/compression/COMPRESSION_GUIDE.md) · [`RTK_COMPRESSION.md`](docs/compression/RTK_COMPRESSION.md) · [`COMPRESSION_ENGINES.md`](docs/compression/COMPRESSION_ENGINES.md)
# ⚡ Sürətli başlanğıc
**1) Quraşdırın və işə salın**
```bash
npm install -g omniroute
omniroute
```
> 💡 `npm warn ERESOLVE` və ya peer-asılılıq xəbərdarlıqları görürsünüz? [Onlar zərərsizdir](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated).
> **npm 11 və ya daha yeni versiyadan istifadə edirsiniz?** İcazə verilmədiyi halda npm paketlərin həyat dövrü skriptlərini bloklaya bilər. OmniRoute-un `postinstall` skripti (`node scripts/build/postinstall.mjs`) onun yerli icra mühiti fayllarını hazırlamaq üçün tələb olunur. Qlobal quraşdırma zamanı npm xəbərdarlığında göstərilən paketlərə icazə verin. OmniRoute 3.8.51 tərəfindən bildirilən paket dəsti üçün:
>
> ```bash
> npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute
> ```
>
> Bu icazə siyahısını gələcək qlobal quraşdırmalarda yenidən istifadə etmək üçün onu bir dəfə konfiqurasiya edin, sonra adi qaydada quraşdırın:
>
> ```bash
> npm config set allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild --location=user
> npm install -g omniroute
> ```
>
> Asılılıqların siyahısı buraxılışlar arasında dəyişə bilər; npm fərqli siyahı göstərərsə, həmin xəbərdarlıqdakı paket adlarından istifadə edin. Paketə icazə vermək onun quraşdırma skriptlərinin icrasına imkan yaradır.
> **Gemini Web və ya veb kukilərindən istifadə edən başqa provayder işlədirsiniz?** npm paketinə
> Playwright daxildir, lakin onun Chromium binar faylı daxil deyil. İlk veb-provayder sorğusunu göndərməzdən əvvəl
> [Playwright Chromium quraşdırması](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium)
> qeydini oxuyun.
İdarəetmə paneli: `http://localhost:20128` · API: `http://localhost:20128/v1`.
**2) Öz hesabınızdan istifadə edərək uyğun provayderə qoşulun**
İdarəetmə paneli → **Provayderlər** → cari şərtləri və kvotası istifadə ssenarinizə uyğun olan provayderi seçin → onun API açarını əlavə edin və ya hesab prosedurunu tamamlayın. Pulsuz səviyyələr qeydiyyat, təsdiq və ya ödəniş üsulu tələb edə bilər. [Pulsuz səviyyələr üzrə təlimat](docs/getting-started/FREE-TIERS-GUIDE.md) ilə tanış olun; açarsız əlçatanlığa zəmanət verilmir və `tos: avoid` ilə işarələnmiş provayderlər standart olaraq `auto` seçimindən çıxarılır.
**3) Kodlaşdırma alətinizi yönləndirin**
```txt
Baza URL-i: http://localhost:20128/v1
API açarı: [İdarəetmə paneli → Son nöqtələr bölməsindən kopyalayın]
Model: auto (uyğun bağlantılar arasında marşrutlaşdırır — yaxud provayder/model seçin)
```
**4) İşlədiyini yoxlayın**
```bash
curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY"
```
Qoşulmuş modellərinizin siyahısını görməlisiniz. 🎉 Budur — kodlaşdırmağa başlayın, OmniRoute sizin üçün avtomatik marşrutlaşdıracaq və ehtiyat varianta keçəcək.
Klientiniz xüsusi başlıqlar göndərə bilmirsə, OmniRoute tokenləşdirilmiş uyğunluq ləqəblərini də təqdim edir:
```txt
OpenAI kataloqu: http://localhost:20128/vscode/YOUR_KEY/
OpenAI modelləri: http://localhost:20128/vscode/YOUR_KEY/models
OpenAI söhbəti: http://localhost:20128/vscode/YOUR_KEY/chat/completions
OpenAI cavabları: http://localhost:20128/vscode/YOUR_KEY/responses
Ollama söhbəti: http://localhost:20128/vscode/YOUR_KEY/api/chat
Ollama teqləri: http://localhost:20128/vscode/YOUR_KEY/api/tags
```
Bunlardan yalnız `Authorization: Bearer ...` əlavə edə bilməyən klientlər üçün istifadə edin. Başlıqla autentifikasiya üstün tutulan üsul olaraq qalır.
## 📦 Daha çox quraşdırma üsulu — Docker, mənbə kodu, 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` ən yüksək **dərc edilmiş** stabil SemVer versiyasını izləyir. O, git `main` budağını izləmir. GitOps üçün `:X.Y.Z` versiyasını sabitləyin. [Docker buraxılış kanalları](docs/guides/DOCKER_GUIDE.md#release-channels) bölməsinə baxın. İmic **`OMNIROUTE_MEMORY_MB=1024`** dəyərini sabitləyir. Bu, idarəetmə paneli və yüngül söhbət üçün kifayətdir. **Kodlaşdırma agentləri** (Claude Code, Codex, Grok və s.-dən `POST /v1/responses`) daha böyük V8 yığını tələb edir, əks halda üst-üstə düşən iki uzun kontekst zamanı proses təxminən 12 GiB səviyyəsində `FATAL ERROR` ilə dayanır. Konteyner ölçüsünü yığından böyük təyin edin (yerli buferlər V8-dən kənarda yerləşir):
| İş yükü | Yığın (`-e OMNIROUTE_MEMORY_MB`) | Konteyner (`--memory`) |
| -------------------------------- | -------------------------------- | ---------------------- |
| İdarəetmə paneli / yüngül söhbət | `1024` (imicin standart dəyəri) | ≥2 g |
| Bir kodlaşdırma agenti | `8192` | ≥10 g |
| İki paralel 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
```
Tam cədvəl: [Docker təlimatı — icra zamanı RAM](docs/guides/DOCKER_GUIDE.md#runtime-ram-for-coding-agents).
> **İlkin buraxılış Docker kanalı:** `diegosouzapw/omniroute:next` və
> `diegosouzapw/omniroute:next-web` cari standart `release/v*`
> budağını izləyir. Bu dəyişən teqlər yalnız buraxılmamış düzəlişləri sınaqdan keçirmək üçün nəzərdə tutulub və
> **istehsal mühitində dəstəklənmir**. Baxın:
> [Docker buraxılış kanalları](docs/guides/DOCKER_GUIDE.md#release-channels).
**🥟 Bun**
Standart `bun install` və qlobal quraşdırma (`bun install -g omniroute`) Bun icra mühitinin aşkarlanması vasitəsilə dəstəklənir:
- **Daxili `bun:sqlite`**: OmniRoute Bun altında işləyərkən onun daxili `bun:sqlite` drayverindən istifadə edir, Node.js mühitində isə `better-sqlite3` və ya `sql.js` variantına keçir.
- **İnkişaf mühitində avtomatik Webpack paketləyicisi seçimi**: İnkişaf rejimi (`bun run dev`) Bun-u avtomatik aşkarlayır və yerli V8 bağlamalarının uyğunsuzluqlarının qarşısını almaq üçün Turbopack-i söndürərək Webpack-dən istifadə edir. İstehsal yığımları (`bun run build`) `OMNIROUTE_USE_TURBOPACK` dəyişəninə Node-da olduğu kimi dəqiq əməl edir: standart olaraq Turbopack, Webpack ilə yığmaq üçün isə `OMNIROUTE_USE_TURBOPACK=0` (`Dockerfile.bun` bunu `--build-arg` kimi təqdim edir).
- **Xüsusi Bun Dockerfile faylı**: Yerli Bun istehsal yerləşdirmələri üçün çoxmərhələli `Dockerfile.bun` (`docker build -f Dockerfile.bun -t omniroute:bun .`).
```bash
# Bun ilə quraşdırın və işə salın
bun install
bun run dev
```
**🛠️ Mənbə kodundan**
```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 flakes istifadə etməklə
nix develop
npm run dev
# Və ya devbox istifadə etməklə
devbox run npm run dev
```
📖 [Docker təlimatı](docs/guides/DOCKER_GUIDE.md) — Compose profilləri, Caddy HTTPS, Cloudflare tunelləri.
**🦭 Podman**
```bash
# 1. Bağlama ilə qoşulan məlumat qovluğunu hazırlayın
mkdir -p data
# 2. Yalnız Linux + yerli rootless Podman üçün (heç vaxt uzaq Podman Machine klientində deyil):
podman unshare chown 1000:1000 ./data
# 3. İcra mühiti göstərişini təyin edin, yerli Compose imicini yığın və başladın
echo "CONTAINER_HOST=podman" >> .env
podman compose --profile base up -d --build
```
macOS və ya Windows-da Podman uzaq Podman Machine istifadə edir: `podman unshare` addımını ötürün və
[topologiyaya uyğun məlumat qovluğu təlimatlarına](contrib/podman/README.md#data-directory-permissions-by-topology) əməl edin.
📖 [Podman təlimatı](contrib/podman/README.md) — Compose yığımları, Podman Machine və
Linux/systemd Quadlet quraşdırması.
**⚡ Daha sürətli / daha yüngül quraşdırma (yerli yığımı ötürün)**
Yerli SQLite mühərriki (`better-sqlite3`) **ixtiyari** asılılıqdır, buna görə də qlobal
quraşdırma heç vaxt mənbə kodundan kompilyasiyanı gözləyərək bloklanmır: platformanıza/Node-a uyğun olduqda
əvvəlcədən yığılmış binar fayldan istifadə edir, əks halda şəffaf şəkildə saf JS mühərrikinə
(Node 22+ mühitində `node:sqlite`, əks halda paketə daxil edilmiş `sql.js` WASM) keçir — yığım alətləri tələb olunmur.
Quraşdırmadan sonrakı yerli ilkin hazırlığı tamamilə ötürmək üçün (CI, başsız və ya yavaş maşınlar):
```bash
OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute # CI=1 də bunu ötürür
```
Ən sürətli quraşdırma üçün **pnpm**-ə üstünlük verin (məzmun ünvanlı saxlanc + sərt keçidlər — yuxarıya baxın).
İdarəetmə panelsiz, başsız icra mühiti üçün Docker `base` profilindən (yuxarıda) və ya
[Termux təlimatından](docs/guides/TERMUX_GUIDE.md) istifadə edin. CLI və veb idarəetmə paneli eyni proses tərəfindən
bir portda təqdim olunur, buna görə hazırda ayrıca yalnız CLI üçün paket yoxdur.
Dövrə qırıcı, eksponensial gecikmə, kütləvi paralel sorğuların qarşısının alınması, avtomatik kombinasiyalı özünübərpa
Jurnallaşdırma
pino — sorğu konteksti ilə strukturlaşdırılmış JSON jurnalları
Testləşdirmə
Node.js test icraçısı + Vitest — izlənilən 5,100-dən çox test faylında 39,000-dən çox statik test elanı (modul, inteqrasiya, E2E, təhlükəsizlik, ekosistem)
İzlənilən 5,100+ test faylındakı 39,000+ statik test bəyanatı üçün test əhatəsi strategiyası
# ⭐ Ən fəal töhfəçilər
> OmniRoute həvəsli açıq mənbə icması tərəfindən formalaşdırılır. Bu şəxslər layihənin keyfiyyətinə, sabitliyinə və əhatə dairəsinə birbaşa təsir edən müstəsna töhfələr veriblər. **Təşəkkür edirik.**
### Birləşdirilmiş pull request-lərin sayına görə xarici töhfəçilər
2026-08-24 05:26:03 UTC tarixinədək birləşdirmələr daxil olmaqla, aktiv release/v3.8.50 budağının dafb4ae808 son nöqtəsində sabitlənib. Səhifələnmiş GitHub GraphQL siyahıyaalmasına 5,911 birləşdirilmiş PR daxildir: 2,707-si repozitoriya sahibinə, 179-u Dependabot-a, 3,025 xarici PR isə 535 fərqli töhfəçiyə aiddir. “Dəyişdirilmiş sətirlər” GitHub əlavələri + silinmələridir və yaradılmış faylları, kilid fayllarını, kataloqları, tərcümələri və sənədləri əhatə edir; bu, dəyişiklik həcmini göstərir, müəllif tərəfindən yazılmış LOC deyil. Son həddəki bərabər nəticələr saxlanılıb.
### GitHub tərəfindən aid edilən commit-lər
Bob.Hou 🏅 GitHub-a aid edilən 51 kommit · 10-cu yer şərikli
Xiangzhe 🏅 GitHub-a aid edilən 51 kommit · 10-cu yer şərikli
2026-08-24 06:14:31 UTC tarixində yenidən yoxlanılıb: release/v3.8.50 standart budağı üçün repozitoriyanın Contributors API-si tərəfindən bildirilən, GitHub-a aid edilən kommitlər. API 525 identiklik qaytardı (415 istifadəçi, 2 bot, 108 anonim); bu cədvələ baxıcı, botlar və anonim identikliklər daxil edilməyib, eyni nəticəli yerlər isə saxlanılıb. Bu, həm yuxarıdakı birləşdirilmiş PR reytinqindən, həm də aşağıdakı 639 nəfərlik Git metadatası siyahıyaalmasından fərqlənir.
> 🙏 Bu töhfəçilərin əlavə etdiyi funksiyalar, xəta düzəlişləri və infrastruktur təkmilləşdirmələri OmniRoute-u etibarlı və funksiyalarla zəngin edən amillərin **əsas hissəsidir**. Hər bir pull request, hər bir test nümunəsi və hər bir i18n tərcümə faylı önəmlidir. Açıq mənbə məhz onlar kimi insanlar tərəfindən qurulur.
---
## 💖 Sponsorlar
OmniRoute-u öz vəsaitləri hesabına maliyyələşdirən insanlara ürəkdən təşəkkür edirik — hər bir töhfə layihənin pulsuz, müstəqil və davamlı inkişaf etməsinə kömək edir.
… və anonim qalmağa üstünlük verən digərləri 💛İctimai GitHub sponsorları 2026-08-24 tarixində yenidən yoxlanılıb. GitHub-un activeOnly statusu yuxarıdakı aktiv etiketləri müəyyən edir; əvvəllər açıqlanmış ictimai birdəfəlik dəstəkçilərə təşəkkür edilməyə davam olunur, məxfi sponsorlar isə anonim qalır.💖 Sponsor olun → — hər bir dollar OmniRoute-un pulsuz və müstəqil qalmasına kömək edir.
## 👥 600-dən çox töhfəçi
[](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
2026-08-24 tarixində dondurulmuş ac02c5b42f bazasında audit aparılıb və canlı release/v3.8.50 budağının dafb4ae808 ucunda yenidən yoxlanılıb: 639 normallaşdırılmış insan Git identifikatoru — 407-si kommit müəllifi (texniki xidmətçi daxil olmaqla), 232-si isə yalnız açıq şəkildə göstərilmiş Co-authored-by treylerlərində yer alır. Siyahıyaalma GitHub noreply istifadəçi adlarını normallaşdırır, 26 bot/agent/xidmət/yer tutucu identifikatorunu istisna edir və adi e-poçt ünvanlarını yalnız göstərilən adları uyğun gəldiyinə görə birləşdirmir.
### Necə töhfə verməli
1. Repozitoriyanın fork-unu yaradın
2. **Aktiv** `release/vX.Y.Z` ucundan (`main` budağından deyil) yeni budaq yaradın — [Budaqlanma və buraxılış modelinə](docs/ops/BRANCHING_MODEL.md) baxın
3. Funksional imkan budağınızı yaradın (`git checkout -b feat/amazing-feature`)
4. Dəyişikliklərinizi kommit edin (`git commit -m 'feat: add amazing feature'`)
5. Budağa göndərin (`git push origin feat/amazing-feature`)
6. **base = həmin `release/vX.Y.Z` budağı** olmaqla Pull Request açın
Ətraflı təlimatlar üçün [CONTRIBUTING.md](CONTRIBUTING.md) sənədinə baxın.
### Yeni versiyanın buraxılması
```bash
# Buraxılış yaradın — npm publish avtomatik olaraq baş verir
VERSION=x.y.z
gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes
```
## 📊 Ulduzlar
## 🌍 StarMapper
## 🙏 Təşəkkürlər
OmniRoute nəhənglərin çiyinləri üzərində dayanır. O, **[9router](https://github.com/decolua/9router)** layihəsinin bir fork-u və Go layihəsi olan **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)**-nin TypeScript portu kimi başladı — bundan sonra isə aşağıdakı hər bir alt sistem bu sahədə ilk addımı atmış açıq mənbəli layihədən ilhamlandı. Onların hər biri OmniRoute-un konkret bir hissəsini formalaşdırdı. Bu, onların hamısına təşəkkürümüzdür. 🙏
> ⭐ ulduz sayları 24 avqust 2026-cı ildə GitHub-ın REST API-si vasitəsilə yoxlanılıb — gedin, bu layihələrə ulduz verin. Saylar müəyyən tarixə aid dəqiq ani görüntüdür və təbii olaraq dəyişəcək.
### 🧬 Mənşə və şlüz
Açıq qiymət məlumat dəsti xərclərin izlənməsi üzrə sinxronizasiyamızı təmin edən və provayderlərin normallaşdırılması modeli marşrutlaşdırmamıza istiqamət verən süni intellekt şlüzüdür.
Brauzer sessiyası, cavab çərçivələnməsi, istifadə və veb axtarış adapterləri daxil olmaqla, paketə daxil edilmiş ChatGPT Web → Codex Responses körpüsünə uyğunlaşdırılmış MIT mənbə kodudur.
Axın bərpasına, düşünmə olmadan işləyən aliaslara, ehtiyat veb axtarışına, sürüşən pəncərə məhdudiyyətlərinə, jurnal məlumatlarının maskalanmasına və gücləndirilmiş işəsalma axınlarına köçürülmüş nümunələrdir.
Onun Grok model uyğunluqları, saxta TypeError yaradan Statsig generatoru, sorğu və cihaz standartları, eləcə də NDJSON cavab prosessoru əhəmiyyətli dərəcədə OmniRoute-un Grok Web icraçısına uyğunlaşdırılıb.
TQZHR və grok2api-merged vasitəsilə ötürülən Grok faydalı yük və cihaz standartları, Statsig generatoru və result.response prosessoru üçün əsas MIT mənbəyidir.
grok2api-merged tərəfindən proksi hovuzu qatı üçün istinad edilən dolayı mənbədir; OmniRoute bu mənşə bildirişini qoruyur, lakin məhdud Grok Web icraçısında proksi hovuzu portunun mövcudluğunu iddia etmir.
Onun kuki vasitəsilə autentifikasiya olunan Grok proksisi və result.response.token axın nümunəsi OmniRoute-un Grok Web nəqliyyat qatına istiqamət verib.
İlkin Grok Web tətbiqində onun HTTP/brauzer əsaslı yuxarı axın dizaynına istinad edilib; birbaşa HTTP yolu GrokProxy-dən törədiyi üçün müstəqil kod portunun mövcudluğu iddia edilmir.
Viral olan «az token iş görürsə, niyə çox token istifadə edək» layihəsi — onun mağara adamı üslubundakı fəlsəfəsi standart sıxışdırma rejimimizi və 30-dan çox doldurucu ifadələrin silinməsi/yığcamlaşdırma qaydasını təmin edir.
Yüksək performanslı əmr çıxışı sıxışdırması — RTK mühərrikimizə, JSON filtr DSL-inə, xam çıxışın bərpasına və ardıcıl RTK → Caveman emal xəttinə ilham verdi.
Prompt sıxışdırması araşdırması (LLMLingua / LLMLingua-2) — asinxron, kod üçün təhlükəsiz və xəta zamanı ilkin nəticəni qaytaran llmlingua mühərrikimizə ilham verdi.
PT-BR token sıxışdırması — pt-BR dil paketimizi təmin edir: Braziliya portuqalcasının qrammatikasına uyğunlaşdırılmış pleonazm azaldılması və doldurucu ifadələrin silinməsi.
Viral olan «tənbəl böyük proqramçı» YAGNI kodlayıcı bacarığı — daha-az-kod Çıxış Üslubumuza ilham verdi: _yaradılan_ kodu azaldan, işlək olan ən kiçik dəyişikliyə yönləndirmə (Caveman-in yığcam nəsrinin çıxış oxundakı qarşılığı).
Məzmunu nəzərə alan, hər fayl növü üzrə və xətaları nəzərə alaraq imtina edən çıxış sıxışdırması — növə görə yönləndirməmizi və minimal qazanc olmadıqda ötürmə yanaşmamızı təsdiqlədi.
16 təkrarlanan RAG/LLM nasazlıq rejimini əhatə edən ProblemMap taksonomiyası — nasazlıqların aradan qaldırılması üzrə bələdçimizdə istifadə olunan ortaq terminologiya.
Kodlaşdırma köməkçisi ↔ LLM trafikinin MITM vasitəsilə ələ keçirilməsi/təhlili ilkin Traffic Inspector tələblərini formalaşdırdı. Əvvəllər törəmə olan dörd modul — SSE birləşdirməsi, söhbətin normallaşdırılması, məxfi məlumatların maskalanması və başlıqların təmizlənməsi — açıq protokol standartlarına əsaslanan müstəqil, sıfırdan hazırlanmış tətbiqlərlə əvəz edilib. Host trafikinin birbaşa ötürülməsi üçün iki səth (passthrough.ts və _internal/bypass.cjs) müstəqil şəkildə təsnif edilmiş OmniRoute-daxili tətbiqlər olaraq qalır; onlar həmin əvəzləmə çərçivəsində yenidən yazılmayıb.
Hər proses üzrə şəffaf proksi marşrutlaşdırması — qəza zamanı təhlükəsiz MITM söndürülməsinə, soketlərin boşdayanma taymautlarına, /proc proses aidiyyətinin müəyyənləşdirilməsinə və TPROXY vasitəsilə trafikin tutulmasına ilham verdi.
### 📚 Model məlumatları, müşahidə oluna bilmə və UI
Təhlükəsizlik seçimlərimizə istiqamət verən, standart olaraq təhlükəsiz kitabxanaların seçilmiş siyahısı (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).
Sorğuların dublikatlarının aradan qaldırılmasına, fövqəladə sıfır xərcli ehtiyat keçidinə, qoşula bilən Auto-Combo strategiyalarına və çoxdilli niyyət təsnifatına ilham verdi.
Onun hesabı nəzərə alan model xəritələndirməsi, icra edilə bilən fayl yolunun doğrulanması və plan etiketi davranışı OmniRoute-un Antigravity icra mühitini formalaşdırdı.
Grok Build kvota səthini müəyyənləşdirdi; daha sonra OmniRoute canlı ötürmə formatını müstəqil şəkildə yoxlayıb düzəltdi.
## 📄 Lisenziya
MIT Lisenziyası — ətraflı məlumat üçün [LICENSE](LICENSE) faylına baxın.
---
**[⬆ Yuxarı qayıt](#-omniroute)** · Açıq mənbəli süni intellekt icması üçün ❤️ ilə hazırlanıb.
OmniRoute v3.8.52 · Node ≥22.22.2 · MIT Lisenziyası · omniroute.online
> Canlı `/dashboard/free-tiers` səhifəsinin animasiyalı xülasəsi. Tam metodologiya (hovuzların təkrarsızlaşdırılması, kredit səviyyələri, provayder şərtləri): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**.
>
> Bu rəqəmlər hər iki həftədən bir canlı kataloq əsasında yenidən yoxlanılır və **hər iki istiqamətdə dəyişir** — provayder pulsuz tarifi dayandırdıqda rəqəm azalır, yenisi əlavə olunduqda isə artır. Biz yuvarlaqlaşdırılmış ən yaxşı ssenarini deyil, kataloqun faktiki hesabladığı nəticəni dərc edirik.
```bash
# Provayderə qoşulduqdan sonra OmniRoute açarınızı İdarəetmə paneli → Son nöqtələr bölməsindən kopyalayın:
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` uyğun bir marşrut tələb edir. Yeni quraşdırmada açarsız uyğun hədəflər olmaya bilər və açarsız provayder üçüncü tərəf müştərilərini rədd edə bilər. OpenCode Free və Kiro daxil olmaqla, `tos: avoid` ilə işarələnmiş provayderlər standart olaraq avtomatik yönləndirmədən kənarlaşdırılır; hesabın qoşulması bu parametri ləğv etmir. Provayder seçməzdən əvvəl [Pulsuz Səviyyələr üzrə Təlimat](docs/getting-started/FREE-TIERS-GUIDE.md) ilə tanış olun.
📦 **Python, Node.js, PHP və cURL** üçün kopyalayıb yapışdırmağa hazır sürətli başlanğıc skriptləri → [`examples/quickstart/`](examples/quickstart/)
> **Kombo** OmniRoute-un **avtomatik** marşrutlaşdırdığı modellər zənciridir. Kvota tükənərsə, provayder nasaz olarsa və ya xərclər kəskin artarsa, kombo növbəti uyğun və işlək modelə keçə bilər. 🛡️
### ⚡ Sıfır konfiqurasiya — sadəcə `auto` istifadə edin
Kombo yaratmağa ehtiyac yoxdur. Modelinizi `auto` (və ya onun bir variantı) olaraq təyin edin və OmniRoute qoşulmuş provayderlərinizdən real vaxtda qiymətləndirilən virtual kombo yaratsın:
📖 [Avtomatik Kombinasiya Mühərriki](docs/routing/AUTO-COMBO.md) · [Dayanıqlılıq Bələdçisi](docs/architecture/RESILIENCE_GUIDE.md)
📊 Tam metodologiya və 9router, OpenRouter, CLIProxyAPI və LiteLLM ilə müqayisədə hər xüsusiyyət üzrə ətraflı məlumat → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)
Açar (təsadüfi): `5d865059-bc44-483a-962d-43ceb80126eb`
Pix kopyala və yapışdır:
```
00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD
```
📖 [Avtorizasiya](docs/architecture/AUTHZ_GUIDE.md) · [Qoruyucu məhdudiyyətlər](docs/security/GUARDRAILS.md) · [Uyğunluq](docs/security/COMPLIANCE.md)
Defolt ardıcıl kombinasiya `RTK → Caveman` istifadə edir. Hər ikisi eyni alət/kontekst yükünə tətbiq edildikdə qənaət mürəkkəb şəkildə artır:
```txt
combined = 1 − (1 − RTK) × (1 − Caveman_input)
average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range = 78.4 – 94.6%
```
Kod blokları, URL-lər, JSON və strukturlaşdırılmış verilənlər qoruma mühərriki tərəfindən **həmişə qorunur**.
> **Az token kifayət edərkən niyə çox token istifadə edəsiniz?** Hər sorğu OmniRoute-un sıxlaşdırma konveyerindən **şəffaf şəkildə** keçir — müştəri tərəfində heç bir dəyişiklik tələb olunmur. Bu, artıq ardıcıllıqla işləyən və hər marşrutlaşdırma kombinasiyası üçün qarışdırılıb uyğunlaşdırıla bilən **12 birləşdirilə bilən mühərrikdən ibarət yığındır** — [RTK](https://github.com/rtk-ai/rtk), [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ 90K+), [LLMLingua-2](https://github.com/microsoft/LLMLingua) və [Troglodita](https://github.com/leninejunior/troglodita) (PT-BR) layihələrinin ideyaları əsasında qurulub.
### 🧱 12 mühərrikdən ibarət yığın
Mühərriklər konveyer ardıcıllığı ilə işləyir; hər biri ayrıca aktivləşdirilə və hər kombinasiya üçün konfiqurasiya edilə bilər:
