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

# 🚀 OmniRoute — Pulsuz Süni İntellekt Şlüzü

OmniRoute — Kod yazmağı heç vaxt dayandırmayın. Hər bir süni intellekt aləti → 375 provayder — 150+ pulsuz — vahid son nöqtə vasitəsilə. Claude Code, Codex, Cursor, Cline, Copilot və Antigravity-ni avtomatik ehtiyat keçidlə PULSUZ Claude / GPT / Gemini-yə qoşun. RTK + Caveman çoxqatlı sıxılması tokenlərə 15–95% (~orta hesabla 89%) qənaət edir — limitlərə heç vaxt çatmayın. 375 süni intellekt provayderi · 150+ pulsuz tarif · ayda ~1.62 mlrd pulsuz token · 20 marşrutlaşdırma strategiyası · başlamaq üçün $0.

## 💰 Ayda ~1.62B Token — Üçüncü Tərəf Pulsuz Səviyyələri Üzrə

> **Öz provayder hesablarınızı gətirin.** Bu, OmniRoute-dan bir token qrantı deyil, ayrı-ayrılıqda uyğun olunan üçüncü tərəf pulsuz səviyyələri üzrə təxmini ümumi göstəricidir. Qeydiyyatdan keçin, tələb olunan yerlərdə giriş məlumatlarını əldə edin və istifadə edə biləcəyiniz provayderləri qoşun; hər provayder öz limitlərinə, mövcudluğuna və şərtlərinə nəzarət edir. > > Pulsuz səviyyələri əllə toplamaq əziyyətlidir — onlarla SDK, onlarla rate limit və əslində nə qədər imkanınız olduğu barədə heç bir fikir yoxdur. OmniRoute **34 təkrarlanan hovuz açarı üzrə 467 pulsuz səviyyə qeydini** kataloqlaşdırır və başlıq token rəqəmini **dərc edilmiş müsbət aylıq büdcəsi olan 17 hovuz, üstəgəl beş model-üzrə Groq limitindən** hesablayır, paylaşılan hovuza görə dublikatlar aradan qaldırılır. Yalnız regional kimlik yoxlamasından sonra açılan kvotalar (bu gün: ModelScope) ayrıca göstərilir, +~6M regional kimlik təsdiqinin arxasında qalır və heç vaxt başlıq rəqəminə əlavə edilmir. Nəticə idarə panelində (`/dashboard/free-tiers`) görünür.

OmniRoute pulsuz səviyyə büdcə kartı: sabit şəkildə ayda ~1.62B pulsuz token, qeydiyyat kreditləri ilə ilk ayda ~2.22B-ə qədər, bir endpoint-in arxasında 467 kataloqlaşdırılmış pulsuz səviyyə qeydini əhatə edən 34 sənədləşdirilmiş təkrarlanan hovuz açarından. Dürüst, hovuz üzrə dublikatları aradan qaldırılmış hesab — hər paylaşılan hovuz bir dəfə sayılır, o cümlədən dərc edilmiş müsbət aylıq token büdcəsi olan 17 təkrarlanan hovuz və beş model-üzrə Groq limiti; 12 provayder şərtlər-risk kataloqunda 'avoid' kimi işarələnib ki, qərarı siz verəsiniz. Büdcə zolağına Mistral 1B, Nara 210M, LLM7 150M, xKiro 150M, Groq 30M (beş model-üzrə limit) və daha kiçik hovuzlar, həmçinin ilk ayın qeydiyyat kreditləri və başlıq rəqəmini heç vaxt şişirtməmələri üçün ayrıca göstərilən daimi pulsuz, token limitsiz provayderlər daxildir. Canlı istifadə olunan/qalan göstəricilər /dashboard/free-tiers ünvanında.

> Canlı `/dashboard/free-tiers` səhifəsinin animasiyalı xülasəsi. Tam metodologiya (hovuz dublikatlarının aradan qaldı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 iki həftədən bir canlı kataloqla yenidən yoxlanılır və **hər iki istiqamətdə hərəkət edir** — bir provayder pulsuz səviyyəni dayandırır, rəqəm düşür; yeni biri əlavə olunur, rəqəm yüksəlir. Biz kataloqun həqiqətən hesabladığını dərc edirik, heç vaxt yuxarı yuvarlaqlaşdırılmış ən yaxşı ssenarini yox.}

⭐ OMNIROUTE pula qənaət etməyinizə və işinizi asanlaşdırmağa kömək etdisə, repoya ulduz verin.

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

[![Star History Reytinqi](https://api.star-history.com/badge?repo=diegosouzapw/OmniRoute&theme=dark)](https://www.star-history.com/diegosouzapw/omniroute) [![olud.ai](https://olud.ai/badge.php?tool=diegosouzapw-omniroute)](https://olud.ai/project/diegosouzapw-omniroute.html) ### 💬 İcmaya qoşulun **👋 Maintainer-i izləyin — yeni provayderlər, buraxılışlar və məsləhətlər haqqında ilk öyrənin:** [![Diego-nu LinkedIn-də izləyin](https://img.shields.io/badge/Follow_Diego_on-LinkedIn-0A66C2?style=for-the-badge&logo=linkedin&logoColor=white)](https://www.linkedin.com/in/diegosouzapw/) [![GitHub-da @diegosouzapw-u izləyin](https://img.shields.io/github/followers/diegosouzapw?style=for-the-badge&logo=github&logoColor=white&label=Follow%20on%20GitHub&color=181717)](https://github.com/diegosouzapw) [![Discord](https://img.shields.io/badge/Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/U47eFqAXCn) [![Telegram](https://img.shields.io/badge/Telegram-26A5E4?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/omnirouteOficial) [![WhatsApp Qlobal](https://img.shields.io/badge/WhatsApp_Global-25D366?style=for-the-badge&logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) [![WhatsApp Braziliya](https://img.shields.io/badge/WhatsApp_Brasil-25D366?style=for-the-badge&logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) [![Veb-sayt](https://img.shields.io/badge/Website-omniroute.online-blue?logo=google-chrome&logoColor=white)](https://omniroute.online) **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

| | v3.8.50 | **v3.8.51** | `v3.8.53+` | | ------------------------------ | :----------------------: | :---------: | :--------------------: | | 🌐 Provayderlər | 352 | **358** | 375 | | 🧠 Unikal söhbət model ID-ləri | 1320 | **1374** | 1475 | | 🖼️ Modallıq Körpüsü | 🆕 görmə + audio + video | ✓ | ✓ | | 📡 Radar pulsuz kataloqu | 🆕 istəyə bağlı | ✓ | ✓ | | ⚖️ Kvota-həsas planlaşdırma | 🆕 Quota-Share | ✓ | ✓ | | 📊 Kvota telemetriyası | 🆕 canlı | ✓ | ✓ | | 🧰 Başsız rejim | — | — | 🆕 `serve --headless` | | 🛤️ LTS rels infrastrukturu | — | — | 🆕 buraxılış kanalları | | 🔎 Model kəşfiyyatı API-si | — | — | 🆕 `/v1/models/query` | **→ [Yol xəritəsi](ROADMAP.md) — `v3.9.0 LTS`-ə doğru relsdə hərəkət**

## 🧩 Mövcuddur [![npm versiyası](https://img.shields.io/npm/v/omniroute?color=cb3837&logo=npm)](https://www.npmjs.com/package/omniroute) ![Aylıq NPM](https://img.shields.io/npm/dm/omniroute?label=npm/month&color=cb3837&logo=npm) [![Docker Hub](https://img.shields.io/docker/v/diegosouzapw/omniroute?label=Docker%20Hub&logo=docker&color=2496ED)](https://hub.docker.com/r/diegosouzapw/omniroute) [![Lisenziya: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](LICENSE) ![Docker endirmələri](https://img.shields.io/docker/pulls/diegosouzapw/omniroute?label=docker%20pulls&logo=docker&color=2496ED) ![Electron endirmələri](https://img.shields.io/github/downloads/diegosouzapw/omniroute/total?style=flat&label=electron%20downloads&logo=electron&color=47848F)

🚀 Başlayın	🚀 Sürətli başlanğıc	📦 Quraşdırın	🆓 Provayderə qoşulun
💡 Öyrənin	💥 Vəd	🤔 Niyə OmniRoute	🏆 Fərqləndirici cəhətlər
⚙️ Xüsusiyyətlər	🎯 Kombinasiyalar	🌐 Provayderlər	🔌 CLI və MCP
	🗜️ Sıxılma	🖥️ Harada işləyir	🔒 Məxfi
👀 Baxın	🎬 İş başında	✨ Yeniliklər	🤖 Uyğun CLI-lər
💚 Dəstək	💚 Dəstək / İanə	💬 İcma	💖 Sponsorlar
📦 Layihə	🛠️ Texnologiya steki	📖 Sənədlər	👥 Töhfə verənlər

🌐 67 dildə

## 🆓 Quraşdırın, provayder bağlayın, sonra bir endpoint üzərindən yönləndirin

Üç addım: OmniRoute-u quraşdırıb başladın, öz hesabınız və ya API açarınızla uyğun provayder bağlayın, sonra OmniRoute API açarı və auto modeli ilə alətinizi localhost:20128/v1 ünvanına yönləndirin. Yönləndirmə mövcud uyğun bağlantılardan və provayder limitlərindən asılıdır.

```bash # Provayderi bağladıqdan sonra OmniRoute açarınızı Dashboard → Endpoints 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 marşrut tələb edir. Təzə quraşdırmada uyğun açarsız 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. Kiro daxil olmaqla, `tos: avoid` ilə işarələnmiş provayderlər defolt olaraq avtomatik yönləndirmədən kənarlaşdırılır; hesab bağlamaq bu parametri ləğv etmir. Provayder seçməzdən əvvəl [Pulsuz Tariflər Bələdçisi](docs/getting-started/FREE-TIERS-GUIDE.md) ilə tanış olun.} _{📦 **Python, Node.js, PHP və cURL** üçün kopyala-yapışdır sürətli başlanğıc skriptləri → [`examples/quickstart/`](examples/quickstart/)}

# 💥 Vədimiz

# 🤔 Niyə OmniRoute?

OmniRoute sorğu axını: IDE və ya CLI-niz (Claude Code, Cursor, Cline…) bir lokal endpoint-ə (http://localhost:20128/v1) müraciət edir; OmniRoute Smart Router (RTK + Caveman sıxılması, 20 yönləndirmə strategiyası, circuit breaker-lər, TLS stealth, MCP, A2A, guardrail-lər) uyğun sağlam hədəf qaldıqca 4 provayder səviyyəsi üzrə fallback edə bilər — Səviyyə 1 Abunəlik, Səviyyə 2 API Açarı, Səviyyə 3 Ucuz və Səviyyə 4 Pulsuz.

## 🤝 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 — Flaqman

20 kombo marşrutlaşdırma strategiyasından 18-i üçün animasiyalı nümunələr — hər strategiya üçün bir xana: priority, fill-first, weighted, round-robin, p2c, least-used, random, strict-random, cost-optimized, headroom, reset-window, reset-aware, context-relay, context-optimized, lkgp, auto, fusion, pipeline. cache-optimized və quota-weighted animasiyalı deyil; aşağıdakı cədvəldə bütün 20 strategiya təsvir olunur.

> **Kombo** OmniRoute-un **avtomatik** marşrutlaşdırdığı modellər zənciridir. Kvota tükənərsə, provayderdə nasazlıq yaranarsa 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 canlı qiymətləndirilən virtual kombo yaratsın:

Model ID-si	Nəyi optimallaşdırır
`auto`	🎯 Balanslaşdırılmış standart seçim (LKGP — son işlək provayderinizə bağlı qalır)
`auto/coding`	🧑💻 Kod generasiyası üçün keyfiyyəti önə çəkən çəkilər
`auto/fast`	⚡ Əvvəlcə ən aşağı gecikmə
`auto/cheap`	💰 Əvvəlcə token başına ən ucuz seçim
`auto/subscription`	🎟️ Yalnız artıq ödəniş etdiyiniz abunəlik kvotası — uyğun seçim olmadıqda dayandırılır, heç vaxt ödənişli ehtiyat varianta keçmir (bələdçi)
`auto/thrifty`	🪜 Əvvəlcə plan kvotası, sonra pillə-pillə ən ucuz ödənişli seçimlərə keçid — plan sıfırlandıqdan sonra yenidən plana qayıdır (bələdçi)
`auto/offline`	🔋 Əvvəlcə ən çox kvota / sürət limiti ehtiyatı
`auto/smart`	🔭 Keyfiyyət prioriteti + daha yaxşı modelləri aşkarlamaq üçün 10% araşdırma
`auto/lkgp`	📌 Son məlum işlək provayderə açıq şəkildə bağlı qalma
`auto/chaos`	🧪 Model panelinə paralel paylama (hər provayderdən bir model, standart olaraq 5), bir cavab qaytarır; nasazlıq inyeksiyası deyil, hər panel modeli üçün bir yuxarı axın çağırışıdır

## ### 🔀 Və ya öz kombonuzu qurun — 20 marşrutlaşdırma strategiyası Bütün **20** 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 prioritetli sıralanmış 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 istifadə edir
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çimdən ən yaxşısına əsaslanan təsadüfi yük balanslaşdırması
6	`least-used`	Hazırkı yükü ən aşağı olan hədəfi seçir
7	`random`	Bərabər ehtimallı təsadüfi seçim (dublikatlar silinir)
8	`strict-random`	Təkrarları silmədən təsadüfi seçim 🎲
9	`cost-optimized`	Canlı kataloq qiymətlərinə əsasən hər sorğu üzrə $ xərcini minimuma endirir 💸
10	`headroom`	Ən çox qalan kvotası olan hədəfi seçir
11	`quota-weighted`	Kvotası tükənmiş hesabları ötürür, sonra qalan kvota ÷ icradakı yük nisbətinə uyğun seçim edir — mövcud söhbətlər eyni hədəfə bağlı qalır ⚖️
12	`reset-window`	Kvota pəncərəsi ən tez sıfırlanacaq hədəfə üstünlük verir
13	`reset-aware`	Kvotanın sıfırlanma vaxtına görə sıralayır — əvvəlcə qısa pəncərələr 📊
14	`context-relay`	Uzun söhbətlər üçün konteksti hədəflər arasında ötürür 🧠
15	`context-optimized`	Cari kontekst ölçüsünə ən uyğun hədəfi seçir
16	`cache-optimized`	Hər təkrar istifadə edilə bilən prompt prefiksini eyni hesaba bağlayır — prompt keşinə düşmə hallarını maksimuma çatdırır 🎯
17	`lkgp`	Son Məlum İşlək Yol — son uğurlu provayderə bağlayır, sonra ehtiyat qaydalara keçir
18	`auto`	Hər bağlantı üzrə 16 amilli canlı qiymətləndirmə 🤖
19	`fusion`	Model panelinə paralel paylayır + qiymətləndirici vahid cavab sintez edir 🧬
20	`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 bir namizədi **16 amil** (sağlamlıq, kvota, xərc, gecikmə, tapşırığa uyğunluq, keyfiyyət, sessiyanın əlçatanlığı…) üzrə qiymətləndirir — baxın: [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md).} ## ### 🧱 Dayanıqlılıq daxildən təmin edilir (3 müstəqil səviyyə)

OmniRoute dayanıqlılığı — 3 müstəqil özünübərpa səviyyəsi, hər nasazlıq üçün uyğun səviyyə. Səviyyə 1 — provayder dövrə açarı (bütün provayder): yalnız 408/5xx hallarında işə düşür, hədlər OAuth üçün 8× / API açarı üçün 12× / lokal üçün 2×, 60s/30s/15s sonra HALF-OPEN sınaq vəziyyətinə keçir, tənbəl bərpa; OPEN vəziyyətində kombinasiya sorğunu növbəti provayderə yönləndirir. Səviyyə 2 — bağlantının gözləmə müddəti (bir açar/hesab): baza müddəti OAuth üçün 5s / API açarı üçün 3s, eksponensial ×2 geriçəkilmə və eyni vaxtda kütləvi təkrar cəhdlərin qarşısını alan qoruma, 429 zamanı Retry-After nəzərə alınır, uğurlu nəticə bütün xəta vəziyyətlərini təmizləyir; bir açar gözləmə rejimində olarkən ötürülür, digər açarlar isə xidmət göstərməyə davam edir. Səviyyə 3 — modelin bloklanması (bir model): model üzrə 429, lokal 404 və ya rejim qadağaları yalnız həmin modeli bloklayır — heç vaxt bütün bağlantını deyil. Son vəziyyətlər (qadağan edilib, müddəti bitib, kreditlər tükənib) gözləmə mexanizmi üçün deyil, operator üçündür.

_{📖 [Auto-Combo Mühərriki](docs/routing/AUTO-COMBO.md) · [Dayanıqlılıq Təlimatı](docs/architecture/RESILIENCE_GUIDE.md)}

## 🏆 OmniRoute-u fərqləndirən nədir

OmniRoute-u fərqləndirən cəhətlər — 13 imkan üzrə 9router, OpenRouter, CLIProxyAPI və LiteLLM ilə müqayisədə müəyyən tarixə aid funksiyalar icmalı. OmniRoute: 375 provayder, daxili 150+ pulsuz səviyyə, 20 marşrutlaşdırma strategiyası, 12 mühərrikli token sıxışdırması, 110 aləti olan daxili MCP serveri, A2A agent protokolu, davamlı yaddaş, qoruyucu məhdudiyyətlər, bulud agentləri, TLS barmaq izi gizliliyi, Desktop/Termux/PWA və 67 beynəlmiləlləşdirilmiş interfeys lokalizasiyası. OmniRoute MIT lisenziyalıdır və şəxsi serverdə yerləşdirilə bilər. Rəqiblərin imkanları və göstəriciləri dəyişə bilər; keçiddəki metodologiyaya baxın.

_{📊 Tam metodologiya və 9router, OpenRouter, CLIProxyAPI və LiteLLM ilə müqayisədə hər funksiya ü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.

⭐ Repozitoriyaya ulduz verin	Pulsuzdur — görünürlüyə həqiqətən kömək edir	OmniRoute-a ulduz verin
🐙 GitHub Sponsors	Birdəfəlik və ya aylıq · platforma komissiyası yoxdur	github.com/sponsors/diegosouzapw
☕ Ko-fi	Sürətli birdəfəlik bəxşiş, ianəçi üçün qeydiyyat tələb olunmur	ko-fi.com/diegosouzapw
🧋 Buy Me a Coffee	Kiçik, qeyri-rəsmi jest	buymeacoffee.com/diegosouzapw
🖐 Liberapay	Dövri · qeyri-kommersiya · açıq mənbə	liberapay.com/diegosouzapw
🇧🇷 PIX (Braziliya)	Ani, komissiyasız	açar və QR aşağıdadır
₿ Kriptovalyuta	BTC · ETH · USDT-TRC20 · USDC-Solana	ünvanlar aşağıdadır

**🇧🇷 PIX** — ani, komissiyasız (Braziliya) OmniRoute PIX QR kodu

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.53** arasındakı son yeniliklər. Tam tarixçə [`CHANGELOG.md`](CHANGELOG.md) faylındadır. - **⚖️ `quota-weighted` marşrutlaşdırma** — 20-ci kombo strategiyası tükənmiş hesabları atlayır, sonra mövcud söhbətləri sabit saxlayaraq qalanlar arasında qalan kvota ÷ aktiv yük nisbətində seçim edir. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🧰 Headless rejimi** — `omniroute serve --headless` (və ya `OMNIROUTE_HEADLESS=1`) yalnız `/v1/*` proksi mühərrikini işə salır, idarəetmə paneli və yalnız-panelə aid alt sistemlər söndürülmüş olur. → [Headless rejimi](docs/guides/HEADLESS.md) - **🔎 Model aşkarlanması** — `/v1/models` qabiliyyət, kontekst, növ və mətn üzrə filtrləyir, `POST /v1/models/query` isə eyni açar-başına görünürlüklə qısa deterministik seçim siyahısı qaytarır. → [API arayışı](docs/reference/API_REFERENCE.md) - **🔑 Açar-başına marşrutlaşdırma nəzarəti** — `forcedModel` ilə API açarını bir modelə və ya komboya sabitləyin, açarın modellərini və kombolarını atomik şəkildə əlavə edin və ya silin (`/api/keys/{id}/access`). → [API arayışı](docs/reference/API_REFERENCE.md) · [OpenAPI](docs/openapi.yaml) - **🛡️ Daha incə PII nəzarətləri** — növ-başına seçim, 20-ə qədər təsdiqlənmiş xüsusi maskalama nümunələri və növ-başına aşkarlama sayğacları; maskalamanın özü istəyə bağlı qalır. → [Mühafizələr](docs/security/GUARDRAILS.md) - **🌍 67 dil** — idarəetmə paneli, sənəd güzgüləri və CLI, `npm run i18n:add-locale` ilə bir əmrlə dili hər yerdə əlavə etmək mümkündür. → [i18n bələdçisi](docs/guides/I18N.md) - **🎛️ OmniConductor** — agent donanmanıza daxilolan A2A delegasiyası, Agent Card-da Conductor bacarıqları və Faro push-to-talk səsli söhbətli idarəetmə paneli. → [A2A Server](docs/frameworks/A2A-SERVER.md) - **🛂 Adaptiv qəbul və həddindən artıq yük qorunması** — ağır söhbət sorğuları 503 qaytarmaq əvəzinə növbəyə alınır, hər bağlantı üçün atomik RPM fırlanan icazələri ilə. → [Davamlılıq bələdçisi](docs/architecture/RESILIENCE_GUIDE.md) - **🗂️ Kanonik `/v1/models` sıralaması** — hər provayder üçün bir ardıcıl provayder-qruplu blok (kombolar əvvəlcə sabitlənmiş), hər kataloq mənbəyində sabit. → [API arayışı](docs/reference/API_REFERENCE.md) - **🗜️ Sıxılma möhkəmləndirilməsi** — susmaya görə aktiv inflasiya mühafizəsi, DE / FR / JA + Çin (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 tarifli xərc** — abunəlik / kodlaşdırma-planı provayderləri xərc analitikasında **$0** göstərir; büdcə, kvota və marşrutlaşdırma qiymətləndirməyə davam edir. → [API arayışı](docs/reference/API_REFERENCE.md) - **⚖️ Quota-Share marşrutlaşdırması** — paylaşılan hesabın kvotasını birləşdirilmiş açarlar arasında ədalətli bölür, iş-qoruyucu olduğundan boş paylar borc verilir. → [Davamlılıq bələdçisi](docs/architecture/RESILIENCE_GUIDE.md) - **🤖 Bir əmrlə CLI/agent qurulumu** — 15 qeydiyyatlı `setup-*` əmri; `omniroute run` 7 CLI işə salır (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); `omniroute configure` interaktiv provayder+model seçicisi və kontekst-başına favoritlər ilə 11 hədəfi dəstəkləyir. → [CLI inteqrasiyaları](docs/guides/CLI-INTEGRATIONS.md) - **🛰️ Uzaq rejim** — məhdudlaşdırılmış tokenlərlə (`connect` / `contexts` / `tokens`) uzaq OmniRoute-u idarə edin + VPS quraşdırmaları üçün `antigravity` OAuth köməkçisi. → [Uzaq rejim](docs/guides/REMOTE-MODE.md) - **🧭 Daha ağıllı avtomatik marşrutlaşdırma** — `auto/:` komboları, **Fusion** (model paneli + hakim), tapşırıq-həssas marşrutlaşdırma, sorğu-başına model / rejim / USD-büdcə ləğvlə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, addım-başına dəqiqlik qapısı, GCF v3.2, sürüklə-yenidənsırala redaktoru. → [Sıxılma](docs/compression/COMPRESSION_ENGINES.md) - **🕵️ Şəffaf MITM deşifrəsi (TPROXY)** — proksi mühit dəyişənlərini məhəl qoymayan CLI-ləri tutun, SNI-başına CA + etibar-mağazası quraşdırıcısı ilə. → [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ı, cache-HIT qənaət başlığı, açar-başına USD xərc kvotaları. → [API arayışı](docs/reference/API_REFERENCE.md) - **🧠 Sizin nəzarətinizdə yaddaş** — susmaya görə söndürülmüş, istəyə bağlı int8 vektor kvantlaması + tipli azalma, sorğu-başına `x-omniroute-no-memory`. → [Yaddaş](docs/frameworks/MEMORY.md) - **🛡️ Təhlükəsizlik** — hər LLM marşrutunda prompt-injection mühafizəsi (red-team dəsti), istəyə bağlı etimadnamə-maskalama mühafizəsi (sızmış API açarlarını/sirləri hər iki istiqamətdə gizlədir), pulsuz DuckDuckGo son çarə veb axtarışı və idarəetmə paneli üçün seçimli OIDC giriş qapısı (parol girişi həmişə əlçatan qalır). → [Mühafizələr](docs/security/GUARDRAILS.md) - **🖼️ Yeni son nöqtələr** — `/v1/ocr` (Mistral OCR) və `/v1/audio/translations` (Whisper tərzi) media səthini tamamlayır. → [API arayışı](docs/reference/API_REFERENCE.md) - **🎨 Şəkil / video / audio generasiyası** — media üçün bir API: xAI Grok Imagine və Novita AI video, ComfyUI, Magnific, Adobe Firefly, Segmind və ElevenLabs kimi səs provayderləri. → [API arayışı](docs/reference/API_REFERENCE.md) - **🌍 Yerləşdirmə və əməliyyatlar** — tərs-proksi `basePath`, brauzer dilinin avtomatik aşkarlanması, açar-başına cihaz izləməsi, rootsuz 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), Ollama birinci sinif 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ş **375 provayderlik kataloq**. → [Provayderlər](docs/reference/PROVIDER_REFERENCE.md) - **📡 Marşrutlaşdırma şəffaflığı** — hər cavab ona xidmət edən strategiyanı/provayderi/gecikməni göstərən `X-OmniRoute-Decision` başlığı daşıyır, yeni `cache-optimized` kombo strategiyası + Auto-Combo `cacheAffinity` faktoru təkrar sorğuları keşlənmiş prefiksi saxlayan bağlantıya geri yönləndirir və yalnız-oxunan `/v1/auto-combo/{channel}/candidates` son nöqtəsi `auto/*` kanalının canlı namizəd hovuzunu açır. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **⚡ Yerli performans və infrastruktur** — bir kliklə yerli Redis, Cloudflare Workers / Deno Deploy relay yerləşdiriciləri, nəzarət olunan daxili xidmətlər kimi Bifrost və Mux. → [Daxili Xidmətlər](docs/frameworks/EMBEDDED-SERVICES.md) - **🧩 Həmçinin daxildir** — plagin framework-u + marketplace, Omni/Agent/GitHub bacarıq framework-ları, Obsidian vault inteqrasiyası (22 MCP aləti), OpenAI ilə uyğun Batch və Files API-ləri, semantik cavab keşi, liderlik tabloları ilə oyunlaşdırma, ACP agent kəşfi (15 daxili agent), BigQuery-yə planlaşdırılmış log ixracı, `auto/chaos` paralel çoxmodelli fan-out, 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ə **bütün** süni intellekt IDE-ləri və ya CLI-ləri pulsuz və aşağı qiymətli modellərlə işləyir.

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

＋ həmçinin bunlarla işləyir · Agent Deck · Kiro · Command Code · Antigravity · Windsurf · AMP · istənilən OpenAI-uyğun alət

_{📖 Bütün 37 alət üçün hər alət üzrə quraşdırma (27 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 5dive ``` Hər bir əmr aktiv uzaq kontekstdən (`omniroute connect `) istifadə edir, `--dry-run` icra etmədən dəqiq mühit dəyişənlərinə/arqumentlərə önbaxış göstərir, `--api-key-env NAME` isə məxfi məlumatları əmr qabığınızın tarixçəsindən kənarda saxlayır. → [CLI inteqrasiyaları](docs/guides/CLI-INTEGRATIONS.md)

## 🌐 375 AI Provayderi — 153-ü Kataloqda Pulsuz İşarələnmiş

> Kanonik çat, media, axtarış, lokal, bulud-agent və sistem kolleksiyaları üzrə **375 qeydiyyatdan keçmiş provayder**, o cümlədən **`hasFree: true` kəşf metadatası daşıyan 153 provayder**. Çat modeli reyestri **239 provayderi / 3 059 fərqli provayder-model cütünü / 1 475 xam model ID-sini** əhatə edir; ayrıca pulsuz-büdcə kataloqunda **467 model-başına sətir**, **34 təkrarlanan hovuz** və **51 təkrarlanan/açarsız həmişəpulsuz provayder** var. Bunlar qəsdən fərqli məxrəclərdir; təriflər və hovuzlara görə təkrarlanma aradan qaldırılmış hesablamalar [Provayder İstinadı](docs/reference/PROVIDER_REFERENCE.md) və [Pulsuz Səviyyələr](docs/reference/FREE_TIERS.md) sənədlərində yerləşir.

### 🏢 Bütün aparıcı laboratoriyalar — bir endpoint vasitəsilə

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

_{…və daha 350+ — hər ikon panelin provayder kataloqundan canlı şəkildə yüklənir. 📖 [Provayder İstinadı](docs/reference/PROVIDER_REFERENCE.md)}
### 🆓 Həmişə Pulsuz — $0, kart tələb olunmur

OpenCode Zen _{DeepSeek V4, Nemotron 3 Token limiti yoxdur}	Kilo Code _{Auto-router, Tencent Hy3 Həmişə pulsuz}	Requesty _{GPT-OSS 120B, Nemotron Həmişə pulsuz}	SiliconFlow _{DeepSeek V3.2 / R1 Pulsuz səviyyə}	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 PULSUZ}	Pollinations _{GPT, Llama, Claude Açar tələb olunmur}	Cloudflare AI _{50+ model 10K neyron/gün}	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şın tərəfindən 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
🛠️ Mənbə kodundan	`npm install && npm run dev`	Dəyişdirin, töhfə verin

_{📖 [Docker təlimatı](docs/guides/DOCKER_GUIDE.md) · [Masaüstü](electron/README.md) · [Menyu paneli](https://github.com/zoispag/omniroute-tray) · [Termux](docs/guides/TERMUX_GUIDE.md) · [PWA](docs/guides/PWA_GUIDE.md) · [OpenCode](docs/frameworks/OPENCODE.md)}

### 🧩 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.

Mağaza	Keçid	Uyğunluq
🧩 VS Code Marketplace	Quraşdır →	VS Code — stabil və Insiders
🔓 Open VSX Registry	Quraşdır →	Cursor, Windsurf, VSCodium, Theia, code-server, Gitpod, Antigravity, Kiro…

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.}

## 🔒 Məxfi və lokal-əsaslı

_{📖 [Avtorizasiya](docs/architecture/AUTHZ_GUIDE.md) · [Qoruyucu məhdudiyyətlər](docs/security/GUARDRAILS.md) · [Uyğunluq](docs/security/COMPLIANCE.md)}

## 🔌 Tam CLI + A2A və MCP

> Serverdən əlavə, OmniRoute **80-dən çox əmri** olan **tam komanda sətri idarəetmə mərkəzidir** və açıq agent protokolları sayəsində süni intellekt agenti onu **müstəqil şəkildə** idarə edə bilər. ### ⌨️ Həqiqi CLI (sadəcə `start` deyil) ```bash omniroute # şlüzü və idarəetmə panelini işə salır (port 20128) omniroute chat # interaktiv TUI çat klienti (slash əmrləri: /model /combo /skill /memory) omniroute setup # ilk işəsalma üçün addım-addım quraşdırma köməkçisi omniroute doctor # provayderləri, portları və yerli asılılıqları diaqnostika edir ``` ### 🛰️ Uzaqdan rejim — CLI-ni burada, OmniRoute-u isə VPS-də işə salın OmniRoute serverdədir? Onu noutbukunuzdan **eyni CLI** ilə idarə edin. Əhatə dairəsi məhdudlaşdırılmış giriş tokeni ilə bir dəfə daxil olun; bundan sonra hər bir əmr uzaq serverə yönəldiləcək. ```bash omniroute connect 192.168.0.15 # parol → əhatə dairəli token, kontekst kimi saxlanılır omniroute models # ← UZAQ serverdə icra olunur omniroute configure codex # ← uzaq model seçir, yerli Codex profili yaradı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 yerli serverə keçir ``` Tokenlərin əhatə dairəsi `read` / `write` / `admin` olaraq məhdudlaşdırılır; proses başladan marşrutlar yalnız loopback üçün əlçatan qalır. _{📖 [Uzaqdan rejim](docs/guides/REMOTE-MODE.md)}

OmniRoute CLI-ni nümayiş etdirən animasiyalı terminal — omniroute providers list, omniroute combo list və omniroute health — 89 əmrdən ibarət yuxarı səviyyəli imkanlar arasında növbələşir: providers · oauth · keys · combo · nodes · models · cache · compression · cost · usage · quota · health · resilience · telemetry · logs · audit · mcp · a2a · cloud · memory · skills · eval · tunnel · backup · sync · webhooks · policy · pricing · translator · simulate …

### 🤝 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 — istənilən uyğun 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ışdırma və yaddaş. Aşağıdakı HTTP son nöqtələri `http://localhost:20128` ünvanı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şulmaq
🌊 MCP (HTTP)	`/api/mcp/stream`	Uzaqdan MCP — 110 alət, 33 əhatə dairəsi (məcburi tətbiq istəyə bağlıdır), tam audit izi
📡 MCP (SSE)	`/api/mcp/sse`	Axınlı MCP nəqli
🤝 A2A	`/.well-known/agent.json`	Agentlərarası əlaqə, JSON-RPC 2.0 + SSE, 6 bacarıq
🌐 REST API	`/v1/*`	OpenAI ilə uyğun — çat, embedding-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ək
🛰️ Uzaqdan CLI	`omniroute connect`	Uzaq instansiyanı əhatə dairəli giriş tokenləri ilə idarə etmək

```bash # Claude Code-a MCP vasitəsilə 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)}

## 🗜️ Tokenlərə 15–95% qənaət — Avtomatik olaraq

### 📖 Necə işləyir — pipeline, arxitektura və qənaət riyaziyyatı

OmniRoute sıxılma pipeline-ı: nümunəvi 10.000 tokenlik müştəri sorğusu 12 kombinə oluna bilən mühərrikdən — Session-Dedup, CCR, Lite, RTK, Responses Tool Output, Headroom, Relevance, Caveman, Aggressive, LLMLingua-2, Ultra və OmniGlyph — keçir və sənədləşdirilmiş yığılmış nümunədə provayderə təxminən 1.080 tokenlə çata bilər. Strukturlaşdırılmış məzmun qoruma mühafizəçiləri və hər addımda dəqiqlik qapıları ilə qorunur; açıq şəkildə itkili və ya eksperimental rejimlər uyğun məzmunu transformasiya edə bilər.

Standart yığılmış kombinasiya `RTK → Caveman` işlədir. Hər ikisi eyni alət/kontekst yükünə təsir etdikdə, qənaətlər qatlaşı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ış məlumatlar qoruma mühərriki tərəfindən **həmişə qorunur**. > **Az token işinizi görəndə nəyə çox token xərcləyəsiniz?** Hər sorğu OmniRoute-un sıxılma pipeline-ından **şəffaf şəkildə** keçir — müştəri tərəfində heç bir dəyişiklik yoxdur. İndi bu, ardıcıllıqla işləyən və marşrut kombinasiyasına görə qarışdırılıb uyğunlaşdırılan **12 kombinə oluna bilən mühərrikin yığınıdı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) ideyaları üzərində qurulub. ### 🧱 12 mühərrikli yığın Mühərriklər pipeline ardıcıllığında işləyir; hər biri müstəqil şəkildə açılıb-bağlana və hər kombinasiya üçün konfiqurasiya edilə bilər:

#	Mühərrik	Nə edir
1	Session-Dedup	Turlar arasında təkrarlanan məzmunu atır (məzmun-ünvanlı, turlararası)
2	CCR	Böyük blokları əldəetmə markerlərinin arxasında arxivləşdirir, tələb olunduqda gətirilir
3	Lite	Boşluq + şəkil-URL qısaltması (gecikməyə yüngül baza səviyyəsi)
4	RTK	Ağıllı alət-nəticə filtrasiyası, deduplikasiya və kəsmə (əmr-dərkli)
5	Responses Tool Output	Shell/patch/search/build çıxışları üçün itkisiz-öncəlikli JSON + məhdudlaşdırılmış diaqnostik sıxılma (Responses API)
6	Headroom	Daxili (vendored) GCF kodeki vasitəsilə JSON massivlərinin itkisiz cədvəl yığcamlaşdırması (~30%)
7	Relevance	Son istifadəçi sorğusuna qarşı ekstraktiv cümlə qiymətləndirməsi
8	Caveman	Qayda əsaslı nəsr sıxılması (çıxışda ~65–75%)
9	Aggressive	Xülasələşdirmə + köhnə turların tədrici köhnəldilməsi
10	LLMLingua-2	MobileBERT ONNX vasitəsilə ML semantik budama — kod üçün təhlükəsiz, asinxron
11	Ultra	İstəyə bağlı kiçik model (SLM) səviyyəsi ilə evristik token budaması
12	OmniGlyph	Birbaşa Anthropic xəttində ölçülmüş Claude Fable 5 üçün eksperimental kontekst-şəkil-kimi kodlaşdırma; GPT 5.6 transformerləri provayder təsdiqləri gözlənilənədək fail-closed qalır. Dörd sıxılma profili (standart aqressiv, balanslaşdırılmış, kod üçün təhlükəsiz, keçid) (ən aqressiv; istəyə bağlı)

Kod blokları, URL-lər və strukturlaşdırılmış məlumatlar **həmişə** bayt-dəqiq **qorunur**. **Bir kliklik hazır rejimlər** mühərrikləri birləşdirir:

Rejim	Qənaət	Ən uyğundur
🪶 Lite	~15%	Həmişə aktiv təhlükəsiz standart
🪨 Standard (Caveman)	~30%	Gündəlik kodlaşdırma
⚡ Aggressive	~50%	Uzun, alət-yüklü sessiyalar
🔥 Ultra	~75%	Maksimum qənaət
🧰 RTK	60–90%	Shell/test/build/git çıxışı
🔗 Stacked (RTK → Caveman)	78–95%	Qarışıq promptlar + alət jurnalları

**Real nümunə — Standart rejim:** > **Əvvəl (69 token):** _"React komponentinizin yenidən render olunmasının səbəbi, yəqin ki, hər render dövründə yeni obyekt referansı yaratmağınızdır. Prop kimi inline obyekt ötürdükdə, React-in dayaz müqayisəsi onu hər dəfə fərqli obyekt kimi görür və bu, yenidən renderi işə salır. Obyekti memoizasiya etmək üçün useMemo istifadə etməyi tövsiyə edərdim."_ > > **Sonra (19 token):** _"Hər renderdə yeni obyekt ref-i. Inline obyekt propu = yeni ref = yenidən render. useMemo ilə bük."_ > > **Eyni cavab. 72% daha az token. Sıfır dəqiqlik itkisi.** ✅ **PT-BR nümunəsi — [Troglodita](https://github.com/leninejunior/troglodita) rejimi:** > **Əvvəl (42 token):** _"Problem ondadır ki, komponent hər render tsiklində yeni obyekt istinadı yaradıldığı üçün yenidən render olunur. useMemo istifadə etməyi tövsiyə edərdim."_ > > **Sonra (12 token):** _"Yenidən render: hər tsikldə yeni ref (inline obyekt yenidən yaradılır). `useMemo` istifadə edin."_ > > **Eyni cavab. ~70% daha az token. Texniki dəqiqlik toxunulmayıb.** ✅
### 🎚️ Mühərriklərdən kənarda — çıxış üslubları, adaptiv tənzimləyici və sorğu başına idarəetmə Yuxarıdakı 12 mühərrik **daxil** olanı kiçildir. Daha üç qat cavabın **necə**, **nə vaxt** və nəyin **xaricə** çıxdığını formalaşdırır: - **🪄 Çıxış Üslubları** _(çıxış oxu idarəetməsi)_ — deterministik, keş-təhlükəsiz cavab-formalaşdıran təlimatlar daxil edir; birləşdirilə bilər, hər biri `lite` / `full` / `ultra` intensivliyi ilə. Üslub əlavə etmək bir sətirlik reyestr yazısıdır: - **Qısa nəsr** — doldurucu sözləri / artiklları / yayınma ifadələrini atır; texniki mahiyyəti dəqiq saxlayır. - **Daha az kod** — "tənbəl senior developer" YAGNI: ən kiçik işlək dəyişiklik, istənməyən skelet kodu yoxdur. - **Ponytail (tənbəl senior developer)** — YAGNI pilləkani ilə yüksəlin, kök səbəbi aradan qaldırın, ən kiçik işlək diff. - **Məndə ADHD var (əvvəl hərəkət)** — növbəti hərəkət öndə gəlir, addımlar nömrələnir, bir konkret növbəti addım, girişsiz. - **Qısa CJK (文言)** — klassik-Çin ultra-qısa üslubu (`zh` lokalına məhdudlaşdırılıb). - **🎯 Adaptiv kontekst büdcəsi** _(tənzimləyici)_ — tək bir aç/bağla token həddi əvəzinə, ən ucuz, ən az itkili mühərrikləri yalnız **modelin kontekst pəncərəsinə sığdırmaq** üçün lazım olduğu qədər artırır. Siyasət: `reserve-output` (standart, modelə uyğun) · `percentage` · `absolute`. Rejim: `floor` (sığma zəmanəti) · `replace-autotrigger` (sizin açıq seçiminiz üstün gəlir) · `off` (köhnə hədd). - **🎛️ Sıxılmanın harada qərarlaşdırıldığı** _(prioritet, yüksək → aşağı)_ — sorğu başına `x-omniroute-compression` başlığı › marşrut-kombo ləğvi › aktiv adlı profil › adaptiv / avto-tetik › panel standartı › off. Tətbiq edilən plan `X-OmniRoute-Compression: ; source=` cavab başlığında geri əks olunur. Token həddi ilə avto-tetikdən istifadə edin, adaptiv tənzimləyicini aktivləşdirin, adlı profili sabitləyin, sorğu başına birdəfəlik tənzimləmə qurun və ya hər marşrut kombosuna pipeline təyin edin — iş yükünüzə hansı uyğundursa. İstəyə bağlı (opt-in) offline **eval harness** (`npm run eval:compression`) dəyişikliyi təsdiqləməzdən əvvəl sabitlənmiş korpus üzərində sədaqət və qənaət göstəricilərini 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-dep 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 versiya istifadə edirsiniz?** npm icazə verilmədikdə paketlərin həyat dövrü skriptlərini bloklaya bilər. OmniRoute-un `postinstall` skripti (`node scripts/build/postinstall.mjs`) yerli runtime fayllarını hazırlamaq üçün tələb olunur. Qlobal quraşdırma zamanı npm xəbərdarlığında adı çəkilən paketlərə icazə verin. OmniRoute 3.8.53 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 da 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ıq siyahısı buraxılışlar arasında dəyişə bilər; npm fərqli siyahı bildirirsə, həmin xəbərdarlıqdakı paket adlarından istifadə edin. Paketə icazə vermək onun quraşdırma skriptlərinin işə düşməsinə imkan verir. > **Gemini Web və ya başqa veb-cookie provayderi istifadə edirsiniz?** npm paketinə Playwright daxildir, lakin onun Chromium binar faylı daxil deyil. İlk veb-provayder sorğusunu etməzdən əvvəl > [Playwright Chromium quraşdırması](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium) > qeydinə baxın. İdarə paneli: `http://localhost:20128` · API: `http://localhost:20128/v1`. **2) Öz hesabınızla uyğun bir provayder qoşun** İdarə paneli → **Providers** → cari şərtləri və kvotası istifadə halınıza uyğun olan bir provayder seçin → onun API açarını əlavə edin və ya hesab axınını tamamlayın. Pulsuz tariflər qeydiyyat, təsdiq və ya ödəniş üsulu tələb edə bilər. [Pulsuz Tariflər Bələdçisi](docs/getting-started/FREE-TIERS-GUIDE.md) ilə tanış olun; açarsız mövcudluq zəmanətli deyil və `tos: avoid` ilə işarələnmiş provayderlər standart olaraq `auto`-dan kənarda saxlanılır. **3) Kodlaşdırma alətinizi yönləndirin** ```txt Base URL: http://localhost:20128/v1 API Key: [copy from Dashboard → Endpoints] Model: auto (routes among eligible connections — or choose provider/model) ``` **4) İşlədiyini yoxlayın** ```bash curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY" ``` Qoşulmuş modellərinizin siyahıda göründüyünü görməlisiniz. 🎉 Vəssalam — kod yazmağa başlayın, OmniRoute sizin üçün avtomatik marşrutlaşdırır və ehtiyat marşruta keçir. Müştəriniz fərdi başlıqlar göndərə bilmirsə, OmniRoute həmçinin tokenləşdirilmiş uyğunluq ləqəbləri təqdim edir: ```txt OpenAI catalog: http://localhost:20128/vscode/YOUR_KEY/ OpenAI models: http://localhost:20128/vscode/YOUR_KEY/models OpenAI chat: http://localhost:20128/vscode/YOUR_KEY/chat/completions OpenAI responses: http://localhost:20128/vscode/YOUR_KEY/responses Ollama chat: http://localhost:20128/vscode/YOUR_KEY/api/chat Ollama tags: http://localhost:20128/vscode/YOUR_KEY/api/tags ``` Bunları yalnız `Authorization: Bearer ...` başlığını əlavə edə bilməyən müştərilər üçün istifadə edin. Başlıq əsasında autentifikasiya üstün rejim 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.

# 🎬 OmniRoute Fəaliyyətdə

## 📹 Video Bələdçiləri

_{Panelin 2026-10-18 tarixli görüntüsü · İlkin kataloq: YT 1.352 | TT 334 | IG 290 · Yenilik müddəti (gün): YT 5 | TT 48 | IG 49}

🎬 #1 — Instagram
_{nick_saraev — 3,042,474 baxış}

🎬 #2 — Instagram
_{nnapier7 — 1,454,535 baxış}

🎬 #3 — YouTube
_{Amidia AI & Tech — 794,974 baxış}

🎬 #4 — Instagram
_{theopenstack — 692,419 baxış}

🎬 #5 — TikTok
_{migue.baena — 685,788 baxış}

**Tam reytinq (dublikatları silinmiş kanonik URL-lər, `v > 0`, ən böyük əhatə dairəsi):** | #1 | #2 | #3 | #4 | #5 | | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | | [nick_saraev — Instagram](https://www.instagram.com/reel/Da8ZthUPK98/) — **3,042,474** | [nnapier7 — Instagram](https://www.instagram.com/reel/Dbp7wv_CIO0/) — **1,454,535** | [Amidia AI & Tech — YouTube](https://www.youtube.com/watch?v=NJ0TQ-pyMDY) — **794,974** | [theopenstack — Instagram](https://www.instagram.com/reel/DaSs65mMrHk/) — **692,419** | [migue.baena — TikTok](https://www.tiktok.com/@migue.baena/video/7670919268216622358) — **685,788** | | #6 | #7 | #8 | #9 | #10 | | ------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | | [milesreevesai — TikTok](https://www.tiktok.com/@milesreevesai/video/7667980059189366019) — **620,400** | [nikothetech — TikTok](https://www.tiktok.com/@nikothetech/video/7671890769665477918) — **610,803** | [Vaibhav Sisinty — YouTube](https://www.youtube.com/watch?v=QucgvbO5gsM) — **509,281** | [buildwithai.club — Instagram](https://www.instagram.com/reel/DbIt9AjK7-U/) — **347,652** | [nivedan.ai — Instagram](https://www.instagram.com/reel/DbIrCksJiqq/) — **331,973** | 2026-10-18 tarixinə olan kanonik göstəricilər: **1.976 unikal video** · **20.220.289 məlum baxış** (`v > 0`) · **şəbəkələr üzrə 1.210 kanal/profil**. İlkin paneldə 1.976 sətir var (YouTube 1.352 = 740 uzun video + 612 Shorts · TikTok 334 · Instagram 290); hər video üçün ən yüksək baxış sayını saxlayan kanonik URL üzrə normallaşdırmadan sonra heç bir dublikat qalmayıb. YouTube məlumatlarının toplanması 2026-10-13 tarixində dayandırılıb (14–18/10 tarixlərində API kvotası tükənib), TikTok/Instagram məlumatlarının toplanması isə 2026-09-02 tarixindən dayandırılıb (məlumat toplama krediti yoxdur); 76 video üçün baxış sayı hələ də mövcud deyil. > 🎬 **OmniRoute haqqında video hazırlamısınız?** Linklə birlikdə [məsələ](https://github.com/diegosouzapw/OmniRoute/issues/new) və ya [müzakirə](https://github.com/diegosouzapw/OmniRoute/discussions) açın — onu burada nümayiş etdirəcəyik.

# 📧 İcma və Yardım > Hər şey bir yerdədir — layihə rəhbərini izləyin, icma ilə söhbət edin və ya məsələ açın. | Kanal | Harada / necə | | -------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- | | 💼 **LinkedIn** — müşayiətçini izləyin | [linkedin.com/in/diegosouzapw](https://www.linkedin.com/in/diegosouzapw/) | | 🐙 **GitHub** — buraxılışlar və məsləhətlər üçün izləyin | [@diegosouzapw](https://github.com/diegosouzapw) | | 💬 **Discord** | [discord.gg/U47eFqAXCn](https://discord.gg/U47eFqAXCn) | | ✈️ **Telegram** | [t.me/omnirouteOficial](https://t.me/omnirouteOficial) | | 🟢 **WhatsApp — 🌍 Qlobal** | [qrupa qoşulun](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) | | 🟢 **WhatsApp — 🇧🇷 Braziliya** | [qrupa qoşulun](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) | | 🌍 **Veb-sayt** | [omniroute.online](https://omniroute.online) | | 🌍 **🌍StHub OmniRoute İcması (pulsuz)** | [StHub portalı](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK) | | 📦 **Mənbə kodu** | [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute) | | 🐛 **Xəta bildirin** | [məsələ açın](https://github.com/diegosouzapw/OmniRoute/issues) — `npm run system-info` çıxışını əlavə edin | | 🤝 **Töhfə verin** | [CONTRIBUTING.md](CONTRIBUTING.md) · [Budaqlanma və Buraxılış Modeli](docs/ops/BRANCHING_MODEL.md) · bir `good first issue` seçin | | 💚 **Layihəni dəstəkləyin** | [Dəstək yolları ↑](#-support-omniroute) · [GitHub Sponsorları](https://github.com/sponsors/diegosouzapw) |

---

## 🛠️ Texnologiya Steki

Təbəqə	Texnologiya
İcra mühiti	Node.js 22.x / 24.x LTS — `>=22.22.2 <23 \|\| >=24.0.0 <27`
Dil	TypeScript 6.0 — `src/` və `open-sse/` üzrə 100% TypeScript (v2.0-dan bəri nüvədə sıfır `any`)
Freymvork	Next.js 16 + React 19 + Tailwind CSS 4
Verilənlər bazası	better-sqlite3 (SQLite, WAL jurnallaşdırma) + LowDB (köhnə JSON) — 147 domen modulu, 209 miqrasiya
Yaddaş	SQLite FTS5 tam mətn axtarışı + int8-kvantlaşdırılmış vektor embeddings, tipləndirilmiş decay
Sxemlər	Zod 4 — MCP alət I/O validasiyası + API müqavilələri
Protokollar	MCP (stdio / HTTP / SSE) + A2A v0.3 (JSON-RPC 2.0 + SSE)
Axın	Server-Sent Events (SSE) + WebSocket körpüsü (`/v1/ws`)
Sıxılma	12-mühərrikli pipeline — RTK, Caveman, LLMLingua-2 (MobileBERT ONNX), GCF, OmniGlyph
Autentifikasiya və təhlükəsizlik	OAuth 2.0 (PKCE) + JWT + API açarları + MCP scoped auth · saxlanma vəziyyətində AES-256-GCM · DOMPurify
Gizlənmə	wreq-js — JA3 / JA4 TLS fingerprint təqlidi, 3-səviyyəli proksi
Dayanıqlılıq	Circuit breaker, eksponensial backoff, anti-thundering-herd, avtomatik-kombo özünü bərpa
Loqlama	pino — sorğu konteksti ilə strukturlaşdırılmış JSON loqları
Test	Node.js test runner + Vitest — 7,800+ izlənilən test faylı üzrə 56,000+ statik test elanı (vahid, inteqrasiya, E2E, təhlükəsizlik, ekosistem)
Platformalar	Masaüstü (Electron) · Android (Termux) · PWA (istənilən brauzer)
CI/CD	GitHub Actions — reliz zamanı avtomatik npm nəşri + Docker Hub
Keçidlər	Veb-sayt · npm · Docker Hub

## 📖 Sənədlər

### 📘 Başlanğıc

Sənəd	Təsvir
İstifadəçi Təlimatı	Provayderlər, kombolar, CLI inteqrasiyası, yerləşdirmə
Quraşdırma Təlimatı	Tam quraşdırma üsulları, CLI alət konfiqurasiyaları, protokol quraşdırması, timeout tənzimlənməsi
CLI Alətləri Təlimatı	Claude Code, Codex, Cursor, Cline, OpenClaw, Kilo, Copilot üçün hər alət üzrə quraşdırma
Uzaq Rejim	Məhdudlaşdırılmış giriş tokenləri vasitəsilə noutbukunuzun CLI-sindən uzaq OmniRoute-u (VPS) idarə edin
Claude Code Konfiqurasiyası	Claude Code-u `launch` + hər model üzrə profillərlə OmniRoute-a (lokal/uzaq) yönləndirin
Sürətli Başlanğıc	3 addımlı quraşdırma → qoşulma → konfiqurasiya

### 🔧 Əməliyyatlar və Yerləşdirmə

Sənəd	Təsvir
Docker Təlimatı	Docker run, Compose profilləri, Caddy HTTPS, tunellər, image etiketləri
Podman Təlimatı	Quadlet systemd inteqrasiyası, podman-compose, SELinux
VM Yerləşdirməsi	Tam təlimat: VM + nginx + Cloudflare quraşdırması
Fly.io Yerləşdirməsi	Davamlı yaddaş ilə Fly.io-ya yerləşdirmə
Termux Təlimatı	OmniRoute-u Termux vasitəsilə Android-də işə salın
PWA Təlimatı	Progressive Web App quraşdırması, keşləmə, arxitektura
Silinmə Təlimatı	Bütün quraşdırma üsulları üçün təmiz silinmə
Mühit Konfiqurasiyası	Tam `.env` dəyişənləri və istinadlar

### 🧠 Xüsusiyyətlər və Arxitektura

Sənəd	Təsvir
Arxitektura	Sistem arxitekturası, məlumat axını və daxili quruluş
Sıxılma Təlimatı	7 seçimli pipeline: off / lite / standard / aggressive / ultra / RTK / stacked
RTK Sıxılması	Əmr çıxışının sıxılması, filtrlər, etibar, yoxlama, xam çıxışın bərpası
Sıxılma Mühərrikləri	Caveman, RTK, qatlı pipeline-lar, dashboard/API/MCP səthləri
Sıxılma Qaydaları Formatı	Caveman və RTK filtrləri üçün JSON qayda paketi sxemləri
Sıxılma Dil Paketləri	Dil aşkarlanması və Caveman qayda paketi müəllifliyi
Dayanıqlılıq Təlimatı	Circuit breaker-lər, cooldown-lar, növbə, thundering herd-ə qarşı müdafiə, TLS spoofing
Auto-Combo Mühərriki	16 faktorlu qiymətləndirmə, rejim paketləri, özünü bərpa
Proksi Təlimatı	3 səviyyəli proksi sistemi, 1proxy marketplace, registry CRUD
Pulsuz Səviyyələr	Konsolidə edilmiş kataloq: 34 sənədləşdirilmiş daimi hovuz / 467 kataloqlaşdırılmış pulsuz səviyyə qeydi
Xüsusiyyətlər Qalereyası	Ekran görüntüləri ilə vizual dashboard turu
Kod Bazası Sənədləşməsi	Yeni başlayanlar üçün uyğun kod bazası icmalı

### 🤖 Protokollar və API-lər

Sənəd	Təsvir
API İstinadı	Nümunələrlə bütün endpoint-lər
OpenAPI Spesifikasiyası	OpenAPI 3.0 spesifikasiyası
MCP Serveri	110 MCP aləti, IDE konfiqurasiyaları, Python/TS/Go klientləri
MCP Server Təlimatı	MCP quraşdırması, transportlar və alət istinadı
A2A Serveri	JSON-RPC 2.0 protokolu, bacarıqlar, axın, tapşırıq idarəetməsi
A2A Server Təlimatı	A2A agent kartı, tapşırıqlar, bacarıqlar və axın

### 📋 Layihə və Keyfiyyət

Sənəd	Təsvir
Töhfə vermə	İnkişaf mühitinin qurulması və təlimatlar
Budaqlanma və Buraxılış Modeli	PR-ların hədəfləndiyi yer (`release/*`), `main` və taqların nə ifadə etdiyi
Dəyişiklik jurnalı	Hər versiya üzrə tam buraxılış tarixçəsi
Təhlükəsizlik Siyasəti	Zəiflik bildirişi və təhlükəsizlik təcrübələri
i18n Bələdçisi	67 dil dəstəyi, tərcümə iş axını, RTL
Buraxılış Yoxlama Siyahısı	Buraxılışdan əvvəlki validasiya addımları
Əhatə Planı	7,800+ izlənən test faylı üzrə 56,000+ statik test deklarasiyası üçün test əhatə strategiyası

# ⭐ Ən Yaxşı Töhfəverənlər > OmniRoute həvəsli bir 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 misilsiz töhfələr vermişlər. **Təşəkkür edirik.** ### Birləşdirilmiş pull request-lərə görə xarici töhfəverənlər

Sıra	Töhfəverən	Birləşdirilmiş PR-lar	~Dəyişdirilmiş sətirlər
1	maxmad64bis	371	25,326,561
2	HouMinXi	269	13,456,272
3	backryun	210	270,562
4	oyi77	190	411,243
5	pacocartones	174	78,276
6	JxnLexn	151	3,562,936
6	KooshaPari	151	5,972,314
8	rdself	145	80,663
9	RaviTharuma	123	500,065
10	herjarsa	88	230,872
11	hartmark	84	2,849,554
12	jonlwheat2-gif	67	68,548
13	artickc	62	43,502
14	chirag127	52	6,661
15	xz-dev	50	245,976
16	xiaoyaner0201	47	33,626
17	woodsonl	46	809,391
18	rqzbeh	44	147,896
19	QuangBlue	43	13,112
20	MumuTW	40	26,093

_{Siyahıyaalma 2026-10-18 15:09:09 UTC tarixində canlı release/v3.8.52 zirvəsi 656f01cb43 ilə aparılıb. Səhifələnmiş GitHub GraphQL siyahıyaalması 9,191 birləşdirilmiş PR ehtiva edir: 3,834-ü depo sahibi, 229-u Dependabot, 6-sı digər botlar/tətbiqlər tərəfindən, həmçinin 835 fərqli töhfəverəndən 5,122 xarici PR. “Dəyişdirilmiş sətirlər” GitHub əlavələri + silinmələridir və yaradılmış faylları, lockfile-ları, kataloqları, tərcümələri və sənədləşməni əhatə edir; bu, müəllif tərəfindən yazılmış LOC deyil, dəyişiklik həcmidir. 49 PR 500,000 sətirdən yuxarı GitHub diff bildirir (məsələn, tək provayder əlavəsi olan #13399, 2,347 dəyişdirilmiş fayl göstərir), bu da yuxarıdakı bəzi cəmləri şişirdir. Bərabər nəticələr birlikdə sıralanır.} ### GitHub-a aid edilən commit-lər

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

_{2026-10-18 14:44:45 UTC tarixində yenidən yoxlanılıb: release/v3.8.52 standart branch-ı üçün repositoriyanın Contributors API-si tərəfindən bildirilən GitHub-a aid edilmiş commit-lər. API 849 identifikasiya qaytardı (429 istifadəçi, 2 bot, 418 anonim); bu cədvəl maintainer-i, botları və anonim identifikasiyaları istisna edir və bərabər nəticələri saxlayır. O, həm yuxarıdakı birləşdirilmiş-PR reytinqindən, həm də aşağıdakı Git-metadata siyahıyaalınmasından fərqlənir.} > 🙏 Bu töhfəçilərin funksiyaları, xəta düzəlişləri və infrastruktur təkmilləşdirmələri OmniRoute-u etibarlı və funksiyalarla zəngin edən şeyin **əsas hissəsidir**. Hər pull request, hər test case və hər i18n tərcümə faylı vacibdir. Açıq mənbə məhz onlar kimi insanlar tərəfindən qurulur.

---
## 💖 Sponsorlar

OmniRoute layihəsini ö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ə daim inkişafda qalmasına kömək edir.

Andrew _{💛 Aktiv aylıq sponsor}	Vlad I _{💛 Aktiv aylıq sponsor}	小妍儿 _{💛 Aktiv aylıq sponsor}	Guilherme Costa _{💛 Aktiv birdəfəlik sponsor}	Henrique Iurkiv _{💛 Aktiv birdəfəlik sponsor}	Somesh Ghaturle _{💛 Aktiv birdəfəlik sponsor}
Kolonie AI _{💛 Keçmiş birdəfəlik dəstəkçi}	Prof. Igor Morais _{💛 Keçmiş birdəfəlik dəstəkçi}	Pixma _{💛 Keçmiş birdəfəlik dəstəkçi}	Paco Cartones _{💛 Keçmiş birdəfəlik dəstəkçi}	longtao _{💛 Keçmiş birdəfəlik dəstəkçi}

_{… və anonim qalmağa üstünlük verən digərləri 💛} _{İctimai GitHub Sponsorları 2026-10-18 tarixində GitHub Sponsors GraphQL API vasitəsilə yenidən yoxlanılıb: ümumilikdə 14 sponsorluqdan 11-i ictimaidir (6 aktiv, 5 keçmiş). Yuxarıdakı aktiv etiketləri GitHub-un isActive statusu müəyyən edir; keçmiş ictimai birdəfəlik dəstəkçilərə təşəkkür edilməyə davam olunur, məxfi sponsorlar isə anonim qalır. Ko-fi, Buy Me a Coffee, Liberapay, PIX və kriptovalyuta ianələri ictimai sponsor qeydləri olmadığı üçün siyahıya daxil edilməyib.} 💖 Sponsor olun → — hər dollar OmniRoute-un pulsuz və müstəqil qalmasına kömək edir.

## 👥 900+ Töhfəçi

[![Töhfəçilər](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=993&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors) _{2026-10-18 tarixində aktiv release/v3.8.52 budağının son ad160ab2d1 kommitində (6,826 kommit) audit aparılıb: 993 normallaşdırılmış insan Git identifikatoru — 707-si kommit müəllifi (dəstəkləyici daxil olmaqla), 286-sı isə yalnız açıq şəkildə göstərilən Co-authored-by treylerlərində yer alır. Siyahıyaalma zamanı .mailmap tətbiq edilir, e-poçt ünvanları böyük-kiçik hərf fərqi nəzərə alınmadan müqayisə olunur, rəqəmsal və adi GitHub noreply ünvanları yalnız eyni istifadəçi adını kodlaşdırdıqda birləşdirilir, 26 bot/agent/xidmət/yer tutucu identifikatoru istisna edilir və adi e-poçt ünvanları yalnız görünən adları uyğun gəldiyinə görə birləşdirilmir. 2026-08-24 tarixli auditdə 639 nəticəsi dərc edilmişdi; bu metod həmin auditin əsas götürdüyü ac02c5b42f üzərində yenidən icra edildikdə 619 nəticəsini verir, buna görə də artım daha yumşaq metoddan deyil, yeni töhfəçilərdən qaynaqlanır.} ### Necə töhfə verməli 1. Repozitoriyanın forkunu yaradın 2. **Aktiv** `release/vX.Y.Z` budağının son vəziyyətindən (`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ı qaydalar üçü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 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 altsistem bu sahədə ilk addımı atan 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ı 18 oktyabr 2026-cı ildə GitHub REST API vasitəsilə yoxlanılıb — gedib bu layihələrə ulduz verin. Saylar müəyyən tarixə aid dəqiq görüntüdür və təbii olaraq dəyişəcək. ### 🧬 Mənşə və şlüz

Layihə	⭐	OmniRoute-a necə ilham verdi
9router	31,004	Bu fork-un əsaslandığı orijinal layihədir — burada multimodal API-lər və tam TypeScript yenidən yazılışı ilə genişləndirilib.
CLIProxyAPI	55,591	Bu JavaScript / TypeScript portuna ilham verən Go tətbiqidir.
LiteLLM	61,482	Açıq qiymət məlumatları dəsti xərc izləmə sinxronizasiyamızı qidalandıran və provayderlərin normallaşdırılması modeli marşrutlaşdırmamızı formalaşdıran süni intellekt şlüzüdür.
codex-chatgpt-web	14,526	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.
free-claude-code	61,430	Axın bərpasına, düşünməsiz alias-lara, ehtiyat veb axtarışına, sürüşən pəncərə limitlərinə, jurnal qeydlərinin redaktəsinə və gücləndirilmiş işəsalma axınlarına port edilmiş nümunələrdir.
composer-api	346	Doğma Cursor icraedicisinə uyğunlaşdırılmış Cursor Composer alət seçimi, çıxış məhdudiyyəti və alət təsdiqləmə nümunələridir.
codex-multi-auth	553	Codex OAuth vasitəsilə təkrar autentifikasiyaya port edilmiş yeni giriş və yeniləmə tokeninin rotasiyası nümunələridir.
opencode-anthropic-auth	558	Claude Code ilə uyğun transformasiya standartları və ödəniş başlığı davranışı OmniRoute-un konfiqurasiya ilə idarə olunan körpüsündə ümumiləşdirilib.
grok2api-merged	2	Onun Grok model uyğunlaşdırmaları, saxta TypeError yaradan Statsig generatoru, sorğu və cihaz standartları, eləcə də NDJSON cavab prosessoru əhəmiyyətli dərəcədə uyğunlaşdırılaraq OmniRoute-un Grok Web icraedicisinə daxil edilib.
TQZHR/grok2api	706	grok2api-merged layihəsinin arxasındakı əsas tranzitiv kod mənbəyidir; onun model, başlıq, faydalı yük, Statsig və prosessor tətbiqləri Grok Web mənşə xəttində qorunub saxlanılır.
chenyme/grok2api	7,819	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-pro	27	grok2api-merged tərəfindən proksi hovuzu qatı üçün istinad edilən tranzitiv mənbədir; OmniRoute həmin mənşə bildirişini qoruyur, lakin məhdud Grok Web icraedicisində proksi hovuzu portunun olduğunu iddia etmir.
GrokProxy	51	Onun kuki ilə autentifikasiya olunan Grok proksisi və `result.response.token` axın nümunəsi OmniRoute-un Grok Web nəqliyyat qatını formalaşdırıb.
GrokBridge	5	Orijinal Grok Web tətbiqi onun HTTP/brauzer yuxarı axın dizaynından istifadə edib; birbaşa HTTP yolu GrokProxy-dən törədiyi üçün müstəqil kod portu iddia edilmir.

### 🗜️ Kontekst və token sıxılması — mühərriklər

Layihə	⭐	OmniRoute-u necə ilhamlandırdı
Caveman	113,396	Viral olan «az token iş görürsə, niyə çox token istifadə etməli» layihəsi — onun mağara adamı üslubundakı fəlsəfəsi standart sıxılma rejimimizin və 30-dan çox doldurucu ifadələrin silinməsi/kondensasiya qaydasının əsasını təşkil edir.
RTK – Rust Token Killer	83,835	Yüksək performanslı əmr çıxışı sıxılması — 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.
headroom	75,741	Geri çevrilə bilən kontekst sıxılması (SmartCrusher) — `headroom` mühərrikimizə və `ccr` bərpa markerinin nümunəsinə ilham verdi.
LLMLingua	6,757	Prompt sıxılması tədqiqatı (LLMLingua / LLMLingua-2) — asinxron, kod üçün təhlükəsiz və xəta zamanı açıq qalan `llmlingua` mühərrikimizə ilham verdi.
llmlingua-2-js	32	LLMLingua mühərrikimiz üçün işçi axını arxa tərəfi kimi istifadə olunan JS/ONNX portu (MobileBERT / XLM-RoBERTa).
Troglodita	50	PT-BR token sıxılması — pt-BR dil paketimizi təmin edir: Braziliya portuqal dilinin qrammatikasına uyğunlaşdırılmış pleonazm azaldılması və doldurucu ifadələrin silinməsi.
ponytail	166,731	Viral «tənbəl senior developer» YAGNI kodlaşdırma bacarığı — less-code Çıxış Üslubumuza ilham verdi: _yaradılan_ kodun həcmini azaldan, işlək ən kiçik dəyişikliyə yönəltmə (Caveman-in yığcam nəsrinin çıxış oxundakı qarşılığı).
i-have-adhd	57,628	Onun əvvəlcə əmələ yönələn, ADHD üçün əlverişli cavab üslubu OmniRoute-un beş dildə yığcam çıxış üslubuna uyğunlaşdırıldı.

### 🧩 Yığcam formatlar, token tədqiqatları və koddan xəbərdar alətlər

Layihə	⭐	OmniRoute-u necə ilhamlandırdı
TOON	25,509	Token yönümlü obyekt notasiyası — onun sütunlu, başlıq və sətirlərdən ibarət modeli cədvəl sıxlaşdırma mərhələmizi formalaşdırdı.
GCF – Graph Compact Format	59	Onun yığcam qraf formatı və ümumi profil dizaynı OmniRoute-un cədvəl sıxlaşdırmasına və Headroom kodek formatına istiqamət verdi.
gcf-typescript	4	Birbaşa mənbə ağacına daxil edilərək Headroom-un ümumi profil kodeki kimi genişləndirilmiş MIT lisenziyalı TypeScript reallaşdırması.
token-optimizer-mcp	551	Brotli/SQLite keşi + hər sessiya üzrə kontekst fərqi — `session-dedup` mühərrikimizə ilham verdi.
token-savior	1,182	Bash çıxışının sıxlaşdırılması + MCP profilləri — sıxılmadan vaxtında imtina intizamımıza və MCP alət manifestinin azaldılmasına ilham verdi.
token-saver	154	Məzmundan xəbərdar, hər fayl növü üzrə və xətaları nəzərə alan çıxış sıxılması — növ üzrə yönləndirməmizi və minimal qazanc olduqda sıxılmanın ötürülməsini təsdiqlədi.
token-optimizer	2,595	«Gizli tokenləri tap» — onun kənara köçürmə + bərpa edilə bilən tutacaq nümunəsi CCR-də kənara köçürmə yanaşmamıza istiqamət verdi.
TokenMizer	33	Session-dedup dizaynımıza istiqamət verən sessiya qrafı + gedişlərarası sətir təkrarsızlaşdırma sxemi.
OmniCompress	3	Rust sütunlu JSON + məzmun ünvanlı bərpa + mesajlararası təkrarsızlaşdırma — `headroom`/`ccr`/`session-dedup` mühərrik dizaynımızı və keş sabitliyini təmin edən «sıxılmış forma mövqedən asılı deyil» invariantını təsdiqlədi.
mcp-compressor	133	MCP alət sxeminin/təsvirinin sıxılması — MCP alət manifestinin kardinallığının azaldılmasına istiqamət verdi.
RepoMapper	217	Aider üslublu repozitoriya xəritəsi sıralaması — repozitoriya xəritəsi / bərpa sıralaması araşdırmamıza istiqamət verdi.
quiet-shell-mcp	4	MCP üzərindən deklarativ shell çıxışı azaldılması — deklarativ bash çıxışı sıxlaşdırmamızı təsdiqlədi.
ts-morph	6,205	TypeScript Compiler API alətlər dəsti — sətir, şablon və regex literallarını qoruyan parser əsaslı şərh silmə mexanizmimizə ilham verdi.

### 🧠 Yaddaş və RAG

Layihə	⭐	OmniRoute-u necə ilhamlandırdı
Mem0	67,385	Universal yaddaş qatı — onun proksinin yazma/oxuma sərhədi kimi çıxış etdiyi model yaddaş arxitekturamızı formalaşdırdı.
Letta (MemGPT)	25,179	Səviyyəli yaddaşa malik vəziyyətli agentlər — Kontekstə Nəzarət və Bərpa (CCR) üçün səviyyəli modelimizi ilhamlandırdı.
WFGY	1,800	16 təkrarlanan RAG/LLM nasazlıq rejimini əhatə edən ProblemMap taksonomiyası — nasazlıqların aradan qaldırılması təlimatımızdakı ortaq terminologiya.

### 🛰️ Trafikin yoxlanılması, MITM və şəffaf proksi

Layihə	⭐	OmniRoute-u necə ilhamlandırdı
llm-interceptor	79	Kodlaşdırma köməkçisi ↔ LLM trafikinə MITM müdaxiləsi və onun təhlili ilkin Traffic Inspector tələblərini formalaşdırdı. Əvvəllər ondan törədilmiş 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 sanitizasiyası — açıq protokol standartları əsasında müstəqil təmiz otaq tətbiqləri ilə əvəz edilib. Host səviyyəsində ötürmə üçün iki səth (`passthrough.ts` və `_internal/bypass.cjs`) ayrıca təsnif edilmiş OmniRoute-daxili tətbiqlər olaraq qalır; həmin əvəzləmə çərçivəsində onlar yenidən yazılmayıb.
ProxyBridge	6,814	Hər proses üçün şəffaf proksi marşrutlaşdırması — qəzaya davamlı MITM dayandırmasını, soket boşdayanma vaxt limitlərini, `/proc` vasitəsilə proses aidiyyətinin müəyyənləşdirilməsini və TPROXY ilə trafikin tutulmasını ilhamlandırdı.

### 📚 Model məlumatları, müşahidəolunma və UI

Layihə	⭐	OmniRoute-u necə ilhamlandırdı
models.dev	7,286	AI model spesifikasiyalarının, qiymətlərinin və imkanlarının açıq məlumat bazası — model kataloqumuza yerli şəkildə sinxronlaşdırılır.
React Flow / xyflow	38,705	Real vaxt rejimində işləyən Compression Studio və Combo/Routing Studio-nu təmin edən qovşaq əsaslı qraf kitabxanası.
LangGraph	43,443	LangGraph Studio-nun canlı iş axını qrafı vizuallaşdırması Studios-un real vaxtlı kaskad görünüşünü ilhamlandırdı.
Langfuse	35,990	Onun trassa → interval → generasiya müşahidəolunma modeli Compression Studio-dakı şəlalə görünüşümüzü formalaşdırdı.
Kiali	3,645	Istio xidmət şəbəkəsinin müşahidəolunması — Routing/Combo Studio-dakı dövrəqıran nişanlarını və xəta kənarı vizuallarını ilhamlandırdı.
lobe-icons	2,615	İdarəetmə panelimizin hər yerində provayder ikonlarını göstərən AI/LLM brend loqoları.
flag-icons	12,473	README dil seçicisində istifadə olunan MIT lisenziyalı SVG bayraqlarını təmin edir.

### 🛡️ Təhlükəsizlik

Layihə	⭐	OmniRoute-u necə ilhamlandırdı
awesome-secure-defaults	722	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).

### 🧭 Tamamlayıcı alətlər

Layihə	⭐	OmniRoute-u necə ilhamlandırdı
ClawRouter	6,628	Sorğuların dublikatlarının aradan qaldırılmasını, fövqəladə sıfır xərcli ehtiyat mexanizmini, qoşula bilən Auto-Combo strategiyalarını və çoxdilli niyyət təsnifatını ilhamlandırdı.
Antigravity-Manager	32,333	Onun hesabdan xəbərdar model yenidən xəritələndirməsi, icra edilə bilən fayl yolunun yoxlanılması və plan etiketi davranışı OmniRoute-un Antigravity icra mühitini formalaşdırdı.
vscode-antigravity-cockpit	4,850	Onun kvota sıfırlanmasına qalan vaxtı göstərən yığcam geri sayım formatı OmniRoute-dakı müvafiq provayder limiti göstəricisini ilhamlandırdı.
AionUi	33,611	Onun ACP inteqrasiyaları OmniRoute-un quraşdırılmış CLI agentlərini avtomatik aşkarlamasını ilhamlandırdı.
CodexBar	22,616	Grok Build kvota səthini müəyyənləşdirdi; OmniRoute isə daha sonra canlı ötürmə formatını müstəqil şəkildə yoxladı və 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 AI icması üçün ❤️ ilə hazırlanıb. _{OmniRoute v3.8.53 · Node ≥22.22.2 · MIT Lisenziyası · omniroute.online}