# 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 AI Şlüzü **[Diego Souza](https://github.com/diegosouzapw) tərəfindən yaradılıb**

OmniRoute — Kod yazmağı heç vaxt dayandırmayın. Hər AI aləti → 388 provayder — 150+ pulsuz — bir endpoint vasitəsilə. Claude Code, Codex, Cursor, Cline, Copilot və Antigravity → PULSUZ Claude / GPT / Gemini ilə avtomatik ehtiyat keçidi. RTK + Caveman yığılmış sıxışdırması 15–95% tokenə (~89% orta hesabla) qənaət edir — limitlərə heç vaxt çatmayın. 388 AI provayderi · 150+ pulsuz tarif · ayda ~1.62B pulsuz token · 20 marşrutlaşdırma strategiyası · Başlamaq üçün $0.

## 💰 Üçüncü tərəflərin pulsuz planlarında ayda ~1,62 milyard token

> **Öz provayder hesablarınızı gətirin.** Bu, ayrıca uyğunluq şərtlərinə malik üçüncü tərəflərin pulsuz planları üzrə təxmini məcmu göstəricidir və OmniRoute tərəfindən verilən token hədiyyəsi deyil. Qeydiyyatdan keçin, tələb olunduğu halda giriş məlumatlarını əldə edin və istifadə edə bildiyiniz provayderləri qoşun; limitlərə, əlçatanlığa və şərtlərə hər provayder özü nəzarət edir. > > Pulsuz planları əl ilə birləşdirmək çətindir — onlarla SDK, onlarla sorğu limiti və əslində nə qədər resursunuz olduğunu bilməmək. OmniRoute **34 təkrarlanan hovuz açarı üzrə 465 pulsuz plan qeydi** kataloqlaşdırır və token göstəricisini **dərc edilmiş müsbət aylıq büdcəsi olan 17 hovuzdan, üstəgəl hər model üçün beş Groq limitindən** hesablayır; ümumi hovuzlar üzrə təkrar hesablama aparılmır. Yalnız regional şəxsiyyət yoxlamasından sonra aktivləşən kvotalar (hazırda: ModelScope) ayrıca göstərilir, regional şəxsiyyət təsdiqinin arxasında əlavə ~6M olmaqla, əsas göstəriciyə heç vaxt daxil edilmir. Nəticə idarə panelində görünən olaraq qalır (`/dashboard/free-tiers`).

OmniRoute pulsuz plan büdcə kartı: ayda sabit ~1,62 milyard pulsuz token, qeydiyyat kreditləri ilə ilk ayda ~2,22 milyarda qədər; vahid endpoint arxasında 34 sənədləşdirilmiş təkrarlanan hovuz açarı 465 kataloqlaşdırılmış pulsuz plan qeydini əhatə edir. Dürüst, hovuz üzrə təkrar hesablamadan aparılan riyazi hesab — hər ümumi hovuz yalnız bir dəfə hesablanır; buna dərc edilmiş müsbət aylıq token büdcəsi olan 17 təkrarlanan hovuz, üstəgəl hər model üçün beş Groq limiti daxildir; şərt riskləri kataloqunda 12 provayderdən istifadə etmək tövsiyə edilmir, qərarı siz verirsiniz. Büdcə zolağına Mistral 1B, Nara 210M, LLM7 150M, xKiro 150M, Groq 30M (hər model üçün beş limit) və daha kiçik hovuzlar, həmçinin ilk ay qeydiyyat kreditləri və daimi olaraq pulsuz, token limiti olmayan provayderlər daxildir; bunlar ayrıca göstərilir ki, əsas göstəricini heç vaxt şişirtməsin. /dashboard/free-tiers ünvanında canlı istifadə edilmiş/qalan göstəricilər.

> Canlı `/dashboard/free-tiers` səhifəsinin animasiyalı xülasəsi. Tam metodologiya (hovuzların təkrar hesablanmasının qarşısının alınması, 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ı kataloqla yenidən yoxlanılır və **hər iki istiqamətdə dəyişə bilər** — provayder pulsuz planı dayandırırsa, rəqəm azalır; yenisi əlavə olunursa, artır. Biz kataloqun həqiqətən hesabladığı göstəricini dərc edirik, heç vaxt yuvarlaqlaşdırılmış ən yaxşı ssenarini yox.}

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

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

[![Ulduz tarixçəsi 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 **👋 Layihə rəhbərini izləyin — yeni provayderlər, buraxılışlar və məsləhətlərdən ilk siz xəbərdar olun:** [![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/) [![@diegosouzapw istifadəçisini GitHub-da 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 Global](https://img.shields.io/badge/WhatsApp_Global-25D366?style=for-the-badge&logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) [![WhatsApp Brasil](https://img.shields.io/badge/WhatsApp_Brasil-25D366?style=for-the-badge&logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) [![Veb-sayt](https://img.shields.io/badge/Website-omniroute.online-blue?logo=google-chrome&logoColor=white)](https://omniroute.online) **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) / [🇧🇷 Brasil](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) / [Portal](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK)**
## 📈 Gateway Böyüməyə Davam Edir

| | v3.8.50 | **v3.8.51** | `v3.8.54+` | | --------------------------------- | :------------------------: | :---------: | :--------------------: | | 🌐 Təchizatçılar | 352 | **358** | 388 | | 🧠 Unikal çat model ID-ləri | 1320 | **1374** | 1491 | | 🖼️ Modallıq körpüsü | 🆕 görüntü + audio + video | ✓ | ✓ | | 📡 Radar pulsuz kataloqu | 🆕 qoşulma seçimi | ✓ | ✓ | | ⚖️ Kvotadan xəbərdar planlaşdırma | 🆕 Quota-Share | ✓ | ✓ | | 📊 Kvota telemetriyası | 🆕 canlı | ✓ | ✓ | | 🧰 Başlıqsız rejim | — | — | 🆕 `serve --headless` | | 🛤️ LTS rel infrastrukturu | — | — | 🆕 buraxılış kanalları | | 🔎 Model kəşfi API-si | — | — | 🆕 `/v1/models/query` | **→ [Yol xəritəsi](ROADMAP.md) — rel üzrə `v3.9.0 LTS`-ə doğru**

## 🧩 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 yükləmələri](https://img.shields.io/docker/pulls/diegosouzapw/omniroute?label=docker%20pulls&logo=docker&color=2496ED) ![Electron yükləmələri](https://img.shields.io/github/downloads/diegosouzapw/omniroute/total?style=flat&label=electron%20downloads&logo=electron&color=47848F)

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

🌐 67 dildə

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

Üç addım: OmniRoute-u quraşdırın və başladın, öz hesabınız və ya API açarınızla uyğun provayder qoşun, sonra alətinizi OmniRoute API açarı və model auto ilə 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 qoşduqdan sonra OmniRoute açarınızı İdarə paneli → 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. `tos: avoid` kimi işarələnmiş provayderlər, o cümlədən Kiro, standart olaraq avtomatik yönləndirmədən kənarlaşdırılır; hesab qoşmaq bu ayarı 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 kopyalayıb yapışdırmağa hazır sürətli başlanğıc skriptləri → [`examples/quickstart/`](examples/quickstart/)}

# 💥 Vəd

# 🤔 Niyə OmniRoute?

OmniRoute sorğu axını: IDE və ya CLI-niz (Claude Code, Cursor, Cline…) bir lokal endpoint-i (http://localhost:20128/v1) çağırır; OmniRoute Smart Router (RTK + Caveman sıxılması, 20 yönləndirmə strategiyası, circuit breaker-lər, TLS stealth, MCP, A2A, guardrails) uyğun sağlam hədəf mövcud olduğu müddətdə 4 provayder səviyyəsi üzrə ehtiyat keçidi 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 cəhətlər

_{📊 9router, OpenRouter, CLIProxyAPI və LiteLLM ilə tam metodologiya və hər xüsusiyyət üzrə təfərrüatlar → [`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.54** arasındakı son yeniliklər. Tam tarixçə [`CHANGELOG.md`](CHANGELOG.md) faylındadır. - **⚖️ `quota-weighted` marşrutlaşdırma** — 20-ci kombinasiya strategiyası limiti tükənmiş hesabları ötürür, sonra qalanlar arasında qalıq kvota ÷ icra olunan sorğular yükü nisbətində seçim edir və mövcud söhbətlərin eyni hesaba yönləndirilməsini qoruyur. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🧰 Başsız rejim** — `omniroute serve --headless` (və ya `OMNIROUTE_HEADLESS=1`) yalnız `/v1/*` proksi mühərrikini işlədir, idarə panelini və yalnız idarə panelinə aid alt sistemləri deaktiv edir. → [Başsız rejim](docs/guides/HEADLESS.md) - **🔎 Model aşkarlanması** — `/v1/models` imkan, kontekst, növ və mətn üzrə filtrləyir, `POST /v1/models/query` isə hər açar üçün eyni görünürlük qaydaları ilə qısa, deterministik namizədlər siyahısı qaytarır. → [API arayışı](docs/reference/API_REFERENCE.md) - **🔑 Açar üzrə marşrutlaşdırma nəzarəti** — API açarını `forcedModel` ilə bir modelə və ya kombinasiyaya bağlayın, həmçinin açarın modellərini və kombinasiyalarını atomik şəkildə əlavə edin və ya silin (`/api/keys/{id}/access`). → [API arayışı](docs/reference/API_REFERENCE.md) · [OpenAPI](docs/openapi.yaml) - **🛡️ Daha dəqiq PII nəzarətləri** — növ üzrə seçim, təsdiqlənən 20-yə qədər fərdi maskalama nümunəsi və növ üzrə aşkarlama sayğacları; maskalamanın özü isə yalnız seçim əsasında aktivləşdirilir. → [Qoruyucu tədbirlər](docs/security/GUARDRAILS.md) - **🌍 67 dil** — idarə paneli, sənəd güzgüləri və CLI üçün; `npm run i18n:add-locale` əmri bir dillə hər yerdə dil əlavə edir. → [i18n bələdçisi](docs/guides/I18N.md) - **🎛️ OmniConductor** — agentlər parkınıza daxil olan A2A delegasiyası, Agent Card üzərində Conductor bacarıqları və Faro push-to-talk səsli çatına malik idarə paneli bölməsi. → [A2A serveri](docs/frameworks/A2A-SERVER.md) - **🛂 Adaptiv qəbul və həddən artıq yüklənmədən qorunma** — ağır çat sorğuları 503 qaytarmaq əvəzinə növbəyə əlavə olunur, hər bağlantı üzrə RPM sürüşən icarələri isə atomik şəkildə idarə edilir. → [Davamlılıq bələdçisi](docs/architecture/RESILIENCE_GUIDE.md) - **🗂️ Kanonik `/v1/models` sıralaması** — hər provayder üçün provayder üzrə qruplaşdırılmış, fasiləsiz bir blok (kombinasiyalar əvvəl olmaqla); bütün kataloq mənbələrində sabitdir. → [API arayışı](docs/reference/API_REFERENCE.md) - **🗜️ Sıxlaşdırmanın gücləndirilməsi** — defolt olaraq aktiv inflyasiya qoruması, DE / FR / JA və Çin dili (wényán) üçün Caveman paketləri, Gradle və .NET üçün RTK filtrləri. → [Sıxlaşdırma](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** kimi göstərilir; büdcə, kvota və marşrutlaşdırma hesablama aparmağa davam edir. → [API arayışı](docs/reference/API_REFERENCE.md) - **⚖️ Quota-Share marşrutlaşdırması** — ümumi hesabın kvotasını hovuzdakı açarlar arasında ədalətli bölür və boş qalan payların istifadəyə verilməsi sayəsində resurslardan səmərəli istifadəni təmin edir. → [Davamlılıq bələdçisi](docs/architecture/RESILIENCE_GUIDE.md) - **🤖 Bir əmrlə CLI/agent quraşdırılması** — 15 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ə 11 hədəfi dəstəkləyir. → [CLI inteqrasiyaları](docs/guides/CLI-INTEGRATIONS.md) - **🛰️ Uzaq rejim** — əhatə dairəsi məhdud tokenlərlə (`connect` / `contexts` / `tokens`) uzaqdakı OmniRoute-u idarə edin və VPS quraşdırmaları üçün `antigravity` OAuth köməkçisindən istifadə edin. → [Uzaq rejim](docs/guides/REMOTE-MODE.md) - **🧭 Daha ağıllı avtomatik marşrutlaşdırma** — `auto/:` kombinasiyaları, **Fusion** (model paneli + qiymətləndirici), tapşırıqdan xəbərdar marşrutlaşdırma, sorğu üzrə model / rejim / ABŞ dolları büdcəsi dəyişiklikləri. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🗜️ Qoşula bilən sıxlaşdırma** — 12 birləşdirilə bilən mühərrik və Sıxlaşdırma Studiyaları: LLMLingua-2, iki səviyyəli Ultra, omniglyph, addım üzrə uyğunluq qapısı, GCF v3.2, sürüklə-yenidən-sırala redaktoru. → [Sıxlaşdırma](docs/compression/COMPRESSION_ENGINES.md) - **🕵️ Şəffaf MITM şifr açılması (TPROXY)** — proksi mühit dəyişənlərinə məhəl qoymayan CLI-lər üçün trafik tutma, SNI üzrə CA və etibar anbarı quraşdırıcısı ilə. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md) - **💸 Hər yerdə xərc telemetriyası** — hər endpoint-də `X-OmniRoute-*` xərc/istifadə başlıqları, keş-HIT qənaəti başlığı, açar üzrə ABŞ dolları xərcləmə kvotaları. → [API arayışı](docs/reference/API_REFERENCE.md) - **🧠 Nəzarət etdiyiniz yaddaş** — defolt olaraq deaktivdir; seçim əsasında aktivləşdirilən int8 vektor kvantlaşdırması və tipli köhnəlmə, sorğu üzrə `x-omniroute-no-memory`. → [Yaddaş](docs/frameworks/MEMORY.md) - **🛡️ Təhlükəsizlik** — hər LLM marşrutunda prompt inyeksiyasından qoruma (red-team test dəsti), seçim əsasında aktivləşdirilən credential maskalama qoruyucusu (hər iki istiqamətdə sızmış API açarlarını/seçimlərini redaktə edir), son çarə kimi pulsuz DuckDuckGo veb axtarışı və idarə paneli üçün seçimə bağlı OIDC giriş qapısı (parolla giriş həmişə əlçatan olaraq qalır). → [Qoruyucu tədbirlər](docs/security/GUARDRAILS.md) - **🖼️ Yeni endpoint-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 yaradılması** — 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ı, 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 olan Grok Build (xAI), birinci dərəcəli Ollama kartı, Claude Opus 5 və Sonnet 5, Kimi ilə rəsmi tərəfdaşlıq (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… və yenilənmiş **388 provayderli kataloq**. → [Provayderlər](docs/reference/PROVIDER_REFERENCE.md) - **📡 Marşrutlaşdırma şəffaflığı** — hər cavab onu təqdim edən strategiyanın/provayderin/gecikmənin adını göstərən `X-OmniRoute-Decision` başlığını daşıyır; yeni `cache-optimized` kombinasiya strategiyası və Auto-Combo `cacheAffinity` faktoru təkrarlanan sorğuları keşlənmiş prefiksi saxlayan bağlantıya geri yönləndirir; yalnız oxunan `/v1/auto-combo/{channel}/candidates` endpoint-i isə `auto/*` kanalının canlı namizədlər hovuzunu təqdim edir. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **⚡ Lokal performans və infrastruktur** — bir kliklə lokal 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) - **🧩 Qutuda olanlar** — plagin çərçivəsi və marketplace, 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şləmə, lider cədvəlləri ilə qamifikasiya, ACP agent kəşfi (15 daxili agent), BigQuery-yə planlaşdırılmış jurnal 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-lar və Kodlaşdırma Agentləri > Bir konfiqurasiya — `http://localhost:20128/v1` — və **bütün** AI IDE və CLI-lar pulsuz və ucuz 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 işləyir · Agent Deck · Kiro · Command Code · Antigravity · Windsurf · AMP · istənilən OpenAI-uyğun alət

_{📖 Bütün 39 alət üçün ayrıca qurulum (28 CLI Code's + 11 CLI Agents) → [`docs/reference/CLI-TOOLS.md`](docs/reference/CLI-TOOLS.md) · 🧩 OpenCode plaqini → [`@omniroute/opencode-provider`](https://www.npmjs.com/package/@omniroute/opencode-provider)}

**İstənilən dəstəklənən CLI-ni OmniRoute vasitəsilə bir əmrlə işə salın** — heç bir konfiqurasiya faylı yazılmır, etimadnamələr hər proses üçün yeridilir, Qwen/Gemini üçün müvəqqəti izolyasiya olunmuş home yaradılır: ```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" # Və ya provayder+modeli interaktiv 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 konteksti nəzərə alır (`omniroute connect `), `--dry-run` dəqiq mühit/parametrləri icra etmədən əvvəlcədən göstərir və `--api-key-env NAME` gizli məlumatları shell tarixçənizdən kənarda saxlayır. → [CLI İnteqrasiyaları](docs/guides/CLI-INTEGRATIONS.md)

## 🌐 388 AI provayderi — kataloqda qeyd olunan 153 pulsuz provayder

> **388 qeydiyyatdan keçmiş provayder** kanonik çat, media, axtarış, lokal, bulud-agent və sistem kolleksiyaları üzrə mövcuddur; bunlardan **153-ü `hasFree: true` kəşf metadatasını daşıyır**. Çat model reyestrində **239 provayder / 3,059 fərqli provayder-model cütü / 1,475 xam model ID-si** əhatə olunur; ayrıca pulsuz büdcə kataloqunda **471 model üzrə sətir**, **34 təkrarlanan hovuz** və **52 təkrarlanan/açar tələb etməyən həmişəlik pulsuz provayder** var. Bunlar məqsədli şəkildə fərqli məxrəclərdir; təriflər və hovuzların dublikatları çıxıldıqdan sonra aparılan hesablamalar [Provider Reference](docs/reference/PROVIDER_REFERENCE.md) və [Free Tiers](docs/reference/FREE_TIERS.md) bölmələrində təqdim olunur.

### 🏢 Bütün əsas 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-dən çox provayder — hər bir ikon idarə panelinin provayder kataloqundan canlı şəkildə yüklənir. 📖 [Provider Reference](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 yönləndirici, Tencent Hy3 Həmişəlik pulsuz}	Requesty _{GPT-OSS 120B, Nemotron Həmişəlik pulsuz}	SiliconFlow _{DeepSeek V3.2 / R1 Pulsuz tarif}	Z.AI GLM _{GLM-4.7 / 4.5-Flash Həmişəlik pulsuz}	Baidu ERNIE _{ERNIE 4.0 Həmişəlik pulsuz}
Qoder AI _{Qwen3-Max, Kimi-K2 Limitsiz 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 Təxminən 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)

## 🖥️ Harada OmniRoute Runs — İstənilən yerdə

> Eyni proqram, maşınınız, qaydalarınız. Qlobal npm quraşdırmasından** telefonunuz** Termux vasitəsilə. Windows / macOS / Linux

Platforma	Quraşdırın	Əsas məqamlar
📦 npm (qlobal)	`npm quraşdırma -g omniroute`	Bir əmr, istənilən OS
⚡ Bun (qlobal)	`bun əlavə edin -g omniroute`	Eyni registr tarball, daha sürətli quraşdırma
🐳 Docker	`docker run … diegosouzapw/omniroute`	Multi-arch AMD64 + ARM64
🖥️ Desktop (Electron)	`npm run elektron:build`	Doğma pəncərə + sistem tepsisi
🎩 Menyu çubuğu (OmniRouteTray)	`brew quraşdırma --cask zoispag/tap/omniroute-tray`	& serverin avtomatik yenilənməsinə nəzarət edir — macOS
💪 ARM	yerli `arm64`	Raspberry Pi, ARM serverləri, Apple Silicon
📱 Android (Termux)	`pkg quraşdırma nodejs && npx -y omniroute`	Telefonunuzda işlədir , 24/7, kök
📲 PWA	"Əsas ekrana əlavə et"	Tam ekran, oflayn, brauzerdən quraşdırıla bilər
🧩 OpenCode plugin	`@omniroute/opencode-provider`	Native OpenCode inteqrasiyası
🤖 VS Kodu Copilot Chat	quraşdırma OmniCopilot genişləndirilməsi	Doğma Copilot -də hər bir OmniRoute modeli Çat seçicisi — stabil & Insider
🛠️ Mənbədən	`npm quraşdırın && npm run dev`	Hack edin, töhfə verin

_{📖 [Docker Bələdçi](docs/guides/DOCKER_GUIDE.md) · [İş masası](electron/README.md) · [Menyu-bar lövhəsi](https://github.com/zoispag/omniroute-tray) · [Termux](docs/guides/TERMUX_GUIDE.md) · [PWA](docs/guides/PWA_GUIDE.md) · [OpenCode](docs/frameworks/OPENCODE.md)}

### 🧩 Yeni: OmniRoute daxilində VS Kodunun doğma Copilot Çatı

> Yeni yan panel yoxdur, yeni söhbət UI yoxdur — OmniRoute xidmət etdiyi hər bir model birbaşa ekranda görünür** artıq istifadə etdiyiniz Copilot Chat model seçicisi** . VS Code 1.122-dən bəri provayder modelləri GitHub girişi və ya Copilot abunəsi olmadan işləyir - agent rejimi, alət çağırışı və görmə, pulsuz. quraşdırın** [OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)** genişləndirmək üçün onu OmniRoute serverinizə yönəldin (defolt olaraq `localhost:20128`), sonra Copilot Chat → model seçicisini → açın** Modelləri idarə edin...** →**OmniRoute** . ilə işləyir < td align ="sola">VS Code — stabil & Insider < td align ="sola">Cursor, Windsurf, VSCodium, Theia Antigravity code-server …Kiro

Mağaza	Link
🧩 VS Code Marketplace	Quraşdırın →
🔓 VSX Reyestrini	Quraşdırın →

Redaktorun içindən: açın** Genişləndiricilər** baxmaq, axtarmaq** "OmniRoute"** , klikləyin** Quraşdırın** — hər iki mağazada eyni şəkildə işləyir. Mənbə, məsələlər və nəşriyyat kitabçası [diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot) -də canlı yayımlanır. _{📖 [VS Code Copilot Çat bələdçisi](docs/guides/VSCODE-COPILOT.md) — quraşdırma, seçicinin göstərdikləri, tabloda-a-tab, problemlərin aradan qaldırılması}

### 🎩 Yeni: OmniRouteTray — menyu çubuğunda yaşayan qapınız

> `omniroute serve` həmişə aktiv olduqda ən xoşbəxtdir.** [OmniRouteTray](https://github.com/zoispag/omniroute-tray)** bunu macOS üçün təyin et və unut menyu çubuğu proqramına çevirir: o, serveri işə salır, onu yenidən yükləmələr zamanı canlı saxlayır, onu yerində yeniləyir və canlı nişan büdcənizi bir kliklə yerinə yetirir —** heç bir terminal pəncərəsi açıq qalmayıb, uşaq baxmağa `npm install -g omniroute` yoxdur.** [Tauri v2](https://v2.tauri.app/) (yuvarlaqlaşdırma xətası ölçüsündə olan Rust nüvəsi) ilə qurulmuş, o, özünün imzalanmış Node 24 iş vaxtını göndərir və proqrama məxsus OmniRoute quraşdırmasını idarə edir, buna görə də qlobal `node`/`bun` ilə heç vaxt mübarizə aparmır. Bu** mövcud `~/.omniroute/` konfiqurasiyanızı və verilənlər bazanızı paylaşır** — deməli, artıq qaçdığınız eyni OmniRoute, sadəcə şapka ilə. 🎩 yoxdur

nə edir	Necə
🟢 Serverə nəzarət edir	Spawns `omniroute service` , onu təkrarlamaq əvəzinə artıq işləyən nümunəni qəbul edir
📊 Bir baxışda canlı istifadə	Provayder kvota çubuqları, geri saymaların sıfırlanması ilə Claude session/weekly limitləri, 30 günlük xərc bölgüsü
🔄 Avtomatik yeniləmələr yerində	Mərhələli quraşdırma, atom dəyişdirmə, uğursuzluq zamanı geriyə qayıtma — həmişə ən yeni buraxılışda
🚀 Girişdə başlayın	Giriş zamanı isteğe bağlı işə salın; yalnız tray, dock icon
🩺 Doktor & qeydləri	Bir kliklə diaqnostika və server jurnalına giriş

```sh brew install --cask zoispag/tap/omniroute-tray ``` _{Yükləməyə üstünlük verirsiniz? Ən son .dmg ni əldə edin
buraxır. Mənbə, problemlər və quruluş
sənədlər zoispag/omniroute-tray-də yaşayır.

💛 zqc @zoispag icma layihəsi — 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)}

## 🗜️ Tokenlara 15–95% qənaət edin — Avtomatik olaraq

### 📖 Bu necə işləyir — konveyer, arxitektura və qənaət hesablaması

OmniRoute sıxılma konveyeri: illüstrativ 10 000 tokenlik müştəri sorğusu 12 kompozisiya edilə bilən mühərrikdən — Session-Dedup, CCR, Lite, RTK, Responses Tool Output, Headroom, Relevance, Caveman, Aggressive, LLMLingua-2, Ultra və OmniGlyph — keçərək 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 qoruyucuları və hər addım üzrə uyğunluq yoxlamaları ilə mühafizə olunur; açıq şəkildə itkilə işləyən və ya eksperimental rejimlər uyğun məzmunu dəyişə bilər.

Defolt yığılmış kombinasiyada `RTK → Caveman` işlədilir. Hər ikisi eyni alət/kontekst yükünə tətbiq edildikdə qənaət üst-üstə toplanı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 **həmişə** qoruma mühərriki tərəfindən mühafizə olunur. > **Az token kifayət etdiyi halda niyə çox token istifadə edək?** Hər sorğu OmniRoute-un sıxılma konveyerindən **şəffaf şəkildə** keçir — müştəri tərəfində heç bir dəyişiklik tələb olunmur. İndi bu, ardıcıllıqla işləyən və hər marşrutlaşdırma kombinasiyası üzrə qarışdırılıb uyğunlaşdırıla bilən **12 kompozisiya edilə 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) ideyaları üzərində 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 müstəqil şəkildə aktivləşdirilə və hər kombinasiya üzrə konfiqurasiya edilə bilər:

#	Mühərrik	Gördüyü iş
1	Session-Dedup	Döngələr arasında təkrarlanan məzmunu silir (məzmun ünvanlı, döngələrarası)
2	CCR	Böyük blokları əldəetmə markerlərinin arxasında arxivləşdirir, tələb olunduqda gətirir
3	Lite	Boşluqların və şəkil URL-lərinin ixtisarı (gecikməsi az olan baza)
4	RTK	Ağıllı alət-nəticəsi filtrasiyası, dublikatların silinməsi və kəsilməsi (əmr-xəbərdar)
5	Responses Tool Output	Shell/patch/search/build çıxışları üçün itkisizliyi prioritetləşdirən JSON və məhdud diaqnostik sıxılma (Responses API)
6	Headroom	Vendored GCF kodekindən istifadə etməklə 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 ekstraktiv qiymətləndirilməsi
8	Caveman	Qayda əsaslı nəsr sıxılması (çıxışda ~65–75%)
9	Aggressive	Köhnə döngələrin xülasələşdirilməsi və tədricən köhnəldilməsi
10	LLMLingua-2	MobileBERT ONNX vasitəsilə ML semantik budaması — 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 kontekstdən şəkilə kodlaşdırma; GPT 5.6 transformerləri provayder qəbzləri gözlənildiyi üçün hələlik uğursuzluqda bağlanır. Dörd sıxılma profili (defolt olaraq aqressiv, balanslaşdırılmış, kodlaşdırma üçün təhlükəsiz, passthrough) (ən aqressiv; könüllü aktivləşdirilir)

Kod blokları, URL-lər və strukturlaşdırılmış məlumatlar **həmişə** bayt səviyyəsində dəqiq qorunur. **Bir kliklə tətbiq olunan presetlər** mühərrikləri birləşdirir:

Rejim	Qənaət	Ən uyğun olduğu sahə
🪶 Lite	~15%	Həmişə aktiv təhlükəsiz defolt
🪨 Standard (Caveman)	~30%	Gündəlik kodlaşdırma
⚡ Aggressive	~50%	Alətlərlə zəngin uzun sessiyalar
🔥 Ultra	~75%	Maksimum qənaət
🧰 RTK	60–90%	Shell/test/build/git çıxışı
🔗 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 olunmasının ehtimal olunan səbəbi hər render dövründə yeni obyekt istinadı yaratmağınızdır. Sətirdaxili obyekti prop kimi ö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 olunmanı işə salır. Obyekti memoizasiya etmək üçün useMemo istifadə etməyinizi tövsiyə edərdim."_ > > **Sonra (19 token):** _"Hər renderdə yeni obyekt istinadı. Sətirdaxili obyekt propu = 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, komponent hər render dövründə yeni obyekt referansı yaradıldığı üçün yenidən render olunur. `useMemo` istifadə etməyi tövsiyə edərdim."_ > > **Sonra (12 token):** _"Yenidən render: hər dövrdə yeni ref (inline obyekt yenidən yaradılır). `useMemo` istifadə edin."_ > > **Eyni cavab. Təxminən 70% daha az token. Texniki dəqiqlik qorunub.** ✅
### 🎚️ Mühərriklərdən kənarda — çıxış üslubları, adaptiv tənzimləyici və hər sorğuya nəzarət Yuxarıdakı 12 mühərrik **daxil olanı** kiçildir. Daha üç qat **necə**, **nə vaxt** və nəyin **çıxacağını** formalaşdırır: - **🪄 Çıxış üslubları** _(çıxış oxunun yönləndirilməsi)_ — deterministik, keş üçün təhlükəsiz cavab-formalaşdırma təlimatları əlavə edir; birləşdirilə bilər, hər biri `lite` / `full` / `ultra` intensivliklərindədir. Üslub əlavə etmək üçün registrə bir sətirlik qeyd kifayətdir: - **Yığcam nəsr** — doldurucu sözləri / artiklları / ehtiyatlı ifadələri çıxarır; texniki məzmunu tam dəqiq saxlayır. - **Daha az kod** — YAGNI prinsipi ilə "tənbəl senior proqramçı": ən kiçik işlək dəyişiklik, istənilməyən əlavə hazırlıq yoxdur. - **Atquyruğu (tənbəl senior proqramçı)** — YAGNI nərdivanı ilə irəliləyir, kök səbəbi düzəldir, ən kiçik işlək diff-i yaradır. - **Məndə ADHD var (fəaliyyətə yönəlik)** — növbəti fəaliyyət öndə gəlir, addımlar nömrələnir, bir konkret növbəti addım verilir, giriş yoxdur. - **Yığcam CJK (文言)** — klassik Çin dilində ultra-yığcam üslub (`zh` lokali ilə məhdudlaşdırılır). - **🎯 Adaptiv kontekst-büdcəsi** _(tənzimləyici)_ — tək açıq/söndürülmüş token həddi əvəzinə, ən ucuz və ən az informasiya itkisi yaradan mühərrikləri yalnız modelin kontekst pəncərəsinə **sığmaq** üçün lazım olan həddə qədər işə salır. Siyasət: `reserve-output` (standart, modelə uyğun) · `percentage` · `absolute`. Rejim: `floor` (sığmanı zəmanət verir) · `replace-autotrigger` (açıq seçiminiz üstün sayılır) · `off` (köhnə hədd). - **🎛️ Sıxışdırmanın harada müəyyən edildiyi** _(üstünlük, yüksəkdən aşağıya)_ — sorğuya görə `x-omniroute-compression` başlığı › marşrutlaşdırma kombinasiyasının əvəzləməsi › aktiv adlı profil › adaptiv / avtomatik işə salma › panel standartı › off. Tətbiq olunan plan `X-OmniRoute-Compression: ; source=` cavab başlığında geri qaytarılır. Token həddi ilə avtomatik işə salın, adaptiv tənzimləyicini aktiv edin, adlı profili sabitləyin, hər sorğu üçün birdəfəlik parametr təyin edin və ya hər marşrutlaşdırma kombinasiyasına pipeline təyin edin — iş yükünə ən uyğun olan variantı seçin. Könüllü, oflayn **qiymətləndirmə harness-i** (`npm run eval:compression`) dəyişikliyi tətbiq etməzdən əvvəl sabit korpus üzərində sədaqəti qənaətlə müqayisə edərək 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 sonrakı versiyadan istifadə edirsiniz?** npm paket həyat dövrü skriptlərini icazə verilmədiyi halda bloklaya bilər. OmniRoute-un `postinstall` (`node scripts/build/postinstall.mjs`) skripti yerli runtime fayllarını hazırlamaq üçün tələb olunur. Qlobal quraşdırma zamanı npm xəbərdarlığında adı göstərilən paketlərə icazə verin. OmniRoute 3.8.54 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ı bildirərsə, həmin xəbərdarlıqda göstərilən paket adlarından istifadə edin. Paketə icazə verilməsi onun quraşdırma skriptlərinin işə salınmasına imkan verir. > **Gemini Web və ya başqa veb-cookie təminatçısından istifadə edirsiniz?** npm paketi > Playwright-ı ehtiva edir, lakin onun Chromium binar faylını ehtiva etmir. İlk veb-təminatçı sorğusunu göndərməzdən əvvəl > [Playwright Chromium quraşdırılması](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium) > qeydinə baxın. Panel: `http://localhost:20128` · API: `http://localhost:20128/v1`. **2) Öz hesabınızdan istifadə edərək uyğun təminatçıya qoşulun** Panel → **Təminatçılar** → mövcud şərtləri və kvotası istifadə ssenarinizə uyğun olan təminatçını seçin → API açarını əlavə edin və ya hesab prosesini 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 bələdçisi](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ş təminatçılar standart olaraq `auto` seçimindən xaric edilir. **3) Kodlaşdırma alətinizi yönləndirin** ```txt Əsas URL: http://localhost:20128/v1 API açarı: [Panel → 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 — və ya təminatçı/model seçin) ``` **4) İşlədiyini yoxlayın** ```bash curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY" ``` Qoşulmuş modellərin siyahıda göstərildiyini görməlisiniz. 🎉 Bu qədər — kodlaşdırmağa başlayın, OmniRoute isə sizin üçün avtomatik marşrutlaşdırır və ehtiyat seçimə keçir. Müştəriniz fərdi 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 çat: http://localhost:20128/vscode/YOUR_KEY/chat/completions OpenAI responses: http://localhost:20128/vscode/YOUR_KEY/responses Ollama çatı: 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 müştərilər üçün istifadə edin. Başlıq autentifikasiyası hələ də üstünlük verilən rejimdir.
## 📦 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 stəki

Təbəqə	Texnologiya
İşləmə 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 etibarən 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ırması) + LowDB (JSON legacy) — 147 domen modulu, 233 miqrasiya
Yaddaş	SQLite FTS5 tam mətn axtarışı + int8-kvantlaşdırılmış vektor daxiletmələri, tipləndirilmiş zəifləmə
Sxemlər	Zod 4 — MCP alətləri üçün I/O yoxlaması + API müqavilələri
Protokollar	MCP (stdio / HTTP / SSE) + A2A v0.3 (JSON-RPC 2.0 + SSE)
Axınlaşdırma	Server tərəfindən göndərilən hadisələr (SSE) + WebSocket körpüsü (`/v1/ws`)
Sıxışdırma	12 mühərrikli konveyer — RTK, Caveman, LLMLingua-2 (MobileBERT ONNX), GCF, OmniGlyph
Autentifikasiya və təhlükəsizlik	OAuth 2.0 (PKCE) + JWT + API açarları + MCP əhatə dairəli autentifikasiya · saxlanılan məlumatlar üçün AES-256-GCM · DOMPurify
Gizlilik	wreq-js — JA3 / JA4 TLS barmaq izi təqlidi, 3 səviyyəli proksi
Davamlılıq	Devre kəsici, eksponensial geriçəkilmə, izdiham effektinə qarşı qoruma, avtomatik kombinə edilmiş özünütəmir
Jurnallaşdırma	pino — sorğu kontekstinə malik strukturlaşdırılmış JSON jurnalları
Test	Node.js test icraçısı + Vitest — 8 400-dən çox izlənən test faylı üzrə 60 000-dən çox statik test elanı (unit, inteqrasiya, E2E, təhlükəsizlik, ekosistem)
Platformalar	Masaüstü (Electron) · Android (Termux) · PWA (istənilən brauzer)
CI/CD	GitHub Actions — buraxılış zamanı avtomatik npm yayımlaması + Docker Hub
Keçidlər	Veb-sayt · npm · Docker Hub

## 📖 Sənədləşmə

### 📘 Başlanğıc

Sənəd	Təsvir
İstifadəçi təlimatı	Provayderlər, kombinasiyalar, CLI inteqrasiyası, yerləşdirmə
Quraşdırma təlimatı	Tam quraşdırma üsulları, CLI alət konfiqurasiyaları, protokol quraşdırması, vaxt aşımının tənzimlənməsi
CLI alətləri təlimatı	Claude Code, Codex, Cursor, Cline, OpenClaw, Kilo, Copilot üçün ayrı-ayrılıqda quraşdırma
Uzaq rejim	Əhatə dairəsi məhdud giriş tokenləri vasitəsilə noutbukunuzdakı CLI-dan uzaq OmniRoute-u (VPS) idarə edin
Claude Code konfiqurasiyası	Claude Code-u `launch` + hər model üçün profillər vasitəsilə OmniRoute-a (lokal/uzaq) yönləndirin
Sürətli başlanğıc	3 addımda quraşdırın → qoşulun → konfiqurasiya edin

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

Sənəd	Təsvir
Docker təlimatı	Docker ilə işə salma, Compose profilləri, Caddy HTTPS, tunellər, imic teqlə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	Daimi yaddaşla Fly.io-a yerləşdirin
Termux təlimatı	OmniRoute-u Termux vasitəsilə Android-də işə salın
PWA təlimatı	Progressive Web App quraşdırılması, keşləmə, arxitektura
Silinmə təlimatı	Bütün quraşdırma üsulları üçün tam 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 mexanizmlər
Sıxışdırma təlimatı	7 seçimli konveyer: off / lite / standard / aggressive / ultra / RTK / stacked
RTK sıxışdırması	Əmr çıxışının sıxışdırılması, filtrlər, etibar, yoxlama, xam çıxışın bərpası
Sıxışdırma mühərrikləri	Caveman, RTK, üst-üstə yerləşdirilmiş konveyerlər, idarə paneli/API/MCP səthləri
Sıxışdırma qaydalarının formatı	Caveman və RTK filtrləri üçün JSON qayda paketi sxemləri
Sıxışdırma dil paketləri	Dil aşkarlanması və Caveman qayda paketlərinin hazırlanması
Davamlılıq təlimatı	Devre kəsiciləri, soyuma müddətləri, növbə, kütləvi sorğuların qarşısının alınması, TLS saxtalaşdırması
Auto-Combo mühərriki	16 amilli qiymətləndirmə, rejim paketləri, özünü bərpa etmə
Proksi təlimatı	3 səviyyəli proksi sistemi, 1proxy marketplace, reyestrin CRUD əməliyyatları
Pulsuz səviyyələr	Birləşdirilmiş kataloq: sənədləşdirilmiş 34 təkrarlanan hovuz / kataloqlaşdırılmış 465 pulsuz səviyyə qeydi
Xüsusiyyətlər qalereyası	Ekran görüntüləri ilə vizual idarə paneli turu
Kod bazasının sənədləşməsi	Başlayanlar üçün uyğun kod bazasına baxış

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

Sənəd	Təsvir
API arayışı	Nümunələrlə birlikdə bütün son nöqtələr
OpenAPI spesifikasiyası	OpenAPI 3.0 spesifikasiyası
MCP serveri	110 MCP aləti, IDE konfiqurasiyaları, Python/TS/Go müştəriləri
MCP serveri təlimatı	MCP quraşdırılması, nəqliyyat vasitələri və alət arayışı
A2A serveri	JSON-RPC 2.0 protokolu, bacarıqlar, axın, tapşırıqların idarə edilməsi
A2A serveri 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ühiti və təlimatlar
Budaqlanma və buraxılış modeli	PR-lərin hara yönəldildiyi (`release/*`), `main` və teqlərin nə demək olduğu
Dəyişikliklər jurnalı	Versiyalar üzrə tam buraxılış tarixçəsi
Təhlükəsizlik siyasəti	Zəifliklərin bildirilməsi və təhlükəsizlik praktikaları
i18n təlimatı	67 dil dəstəyi, tərcümə iş axını, RTL
Buraxılış yoxlama siyahısı	Buraxılışdan əvvəl yoxlama mərhələləri
Əhatə planı	8,400-dən çox izlənən test faylı üzrə 60,000-dən çox statik test deklarasiyası üçü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ərə görə xarici töhfəçilər

Reytinq	Töhfəçi	Birləşdirilmiş PR-lər	~Dəyişdirilmiş sətirlər
1	maxmad64bis	418	25,367,739
2	HouMinXi	295	13,557,796
3	pacocartones	222	81,551
4	backryun	210	270,562
5	JxnLexn	198	3,570,623
6	oyi77	190	411,243
7	KooshaPari	151	5,972,314
8	rdself	145	80,663
9	RaviTharuma	123	500,065
10	herjarsa	88	230,872
11	hartmark	85	2,849,623
12	jonlwheat2-gif	68	69,097
13	artickc	62	43,502
14	xiaoyaner0201	59	126,220
15	chirag127	52	6,661
16	xz-dev	50	245,976
17	woodsonl	48	811,771
18	rqzbeh	46	151,229
19	MumuTW	43	28,166
19	QuangBlue	43	13,112

_{Siyahıyaalma canlı release/v3.8.53 ucu 05bc048d6c ilə 2026-11-03 03:01:19 UTC tarixində aparılıb. Səhifələnmiş GitHub GraphQL siyahıyaalması 9,947 birləşdirilmiş PR ehtiva edir: 4,130-u repozitoriya sahibinə, 240-ı Dependabot-a, 6-sı digər botlara/tətbiqlərə, 5,571-i isə 883 fərqli töhfəçidən gələn xarici PR-lərə aiddir. “Dəyişdirilmiş sətirlər” GitHub additions + deletions göstəricisidir və yaradılmış faylları, lockfile-ları, kataloqları, tərcümələri və sənədləri əhatə edir; bu, müəlliflik edilmiş LOC deyil, dəyişiklik həcmini göstərir. 53 PR GitHub diff-lərində 500,000-dən çox sətir göstərir (məsələn, tək bir provayder əlavə edən #13399 PR-ında 2,347 dəyişdirilmiş fayl göstərilir) və bu da yuxarıdakı bəzi yekunları şişirdir. Eyni nəticə göstərənlər birlikdə sıralanır.} ### GitHub-a aid edilən commit-lər

Dizzle _{🥇 GitHub-a aid edilən 418 commit}	Bob.Hou _{🥈 GitHub-a aid edilən 294 commit}	Paijo _{🥉 GitHub-a aid edilən 229 commit}	Paco Cartones _{🏅 GitHub-a aid edilən 222 commit}	backryun _{🏅 GitHub-a aid edilən 202 commit}	Jan Leon _{🏅 GitHub-a aid edilən 134 commit}
Ravi Tharuma _{🏅 GitHub-a aid edilən 126 commit}	Markus Hartung _{🏅 GitHub-a aid edilən 115 commit}	Randi _{🏅 GitHub-a aid edilən 108 commit}	Chris _{🏅 GitHub-a aid edilən 70 commit}	WebPerson _{🏅 GitHub-a aid edilən 68 commit}	Koosha Paridehpour _{🏅 GitHub-a aid edilən 68 commit}

_{Sonuncu dəfə 2026-11-03 02:09:16 UTC tarixində yoxlanılıb: release/v3.8.53 defolt branch-i üçün repozitoriyanın Contributors API-si tərəfindən bildirilən GitHub-a aid commitlər. API 903 identifikator qaytardı (429 istifadəçi, 2 bot, 472 anonim); bu cədvəldə maintainer, botlar və anonim identifikatorlar nəzərə alınmayıb, müsabiqədəki bərabər nəticələr isə saxlanılıb. Bu məlumat 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 xüsusiyyətləri, səhv düzəlişləri və infrastruktur təkmilləşdirmələri OmniRoute-u etibarlı və zəngin funksiyalı edən məqamların **əsas hissəsidir**. Hər pull request, hər test nümunəsi və hər i18n tərcümə faylı önəmlidir. Açıq mənbə onlar kimi insanlar tərəfindən yaradılır.

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

## 👥 1,000+ Töhfəçi

[![Contributors](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=1074&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors) _{2026-11-02 tarixində canlı release/v3.8.53 ucunda 1c7135e0fb (7,972 commit) yoxlanılıb: 1,074 normallaşdırılmış real Git identikliyi — 759-u commit müəllifləri kimi (o cümlədən texniki xidmət göstərən şəxs) görünür, 315-i isə yalnız açıq Co-authored-by trailer-lərindədir. Siyahıyaalma .mailmap-dən istifadə edir, e-poçt ünvanlarını registrə həssas olmadan müqayisə edir, rəqəmli və adi GitHub noreply ünvanlarını yalnız eyni istifadəçi adını kodlaşdırdıqları halda birləşdirir, 29 bot/agent/xidmət/placeholder identikliyini istisna edir və yalnız göstərilən adları uyğun gəldiyinə görə adi e-poçt ünvanlarını birləşdirmir. 2026-08-24 tarixli yoxlamada 639 göstərilmişdi; həmin yoxlamanın baza ac02c5b42f-si üzərində bu metodun yenidən tətbiqi 619 nəticəsi verir, buna görə artım metodun yumşaldılmasından deyil, yeni töhfəçilərdən qaynaqlanır.} ### Necə töhfə vermək olar 1. Repozitoriyanı fork edin 2. **Aktiv** `release/vX.Y.Z` ucundan (`main` deyil) budaqlanın — [Budaqlanma və buraxılış modeli](docs/ops/BRANCHING_MODEL.md) bölməsinə baxın 3. Funksiyanız üçün budaq yaradın (`git checkout -b feat/amazing-feature`) 4. Dəyişikliklərinizi commit 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) faylına baxın. ### Yeni versiyanın buraxılması ```bash # Buraxılış yaradın — npm publish avtomatik icra olunur 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 **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)**-nin TypeScript portu kimi başladı — bundan sonra isə aşağıda sadalanan hər bir alt sistem əvvəl bu işi görmüş açıq mənbəli bir layihədən ilhamlandı. Onların hər biri OmniRoute-un konkret bir hissəsini formalaşdırdı. Bu, hamısına təşəkkürümüzdür. 🙏 > ⭐ ulduz sayları 3 noyabr 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 snapshot-dır və təbii olaraq dəyişəcək. ### 🧬 Mənşə və gateway

Layihə	⭐	OmniRoute-a necə ilham verib
9router	31,861	Bu fork-un əsasını təşkil edən orijinal layihə — burada multi-modal API-lər və tam TypeScript yenidən yazılması ilə genişləndirilib.
CLIProxyAPI	57,329	Bu JavaScript / TypeScript portuna ilham verən Go implementasiyası.
LiteLLM	62,580	Açıq qiymət məlumat dəsti xərc izləmə sinxronizasiyamızı təmin edən və provider normallaşdırma modeli marşrutlaşdırmamıza istiqamət verən AI gateway-i.
codex-chatgpt-web	15,435	Vendored ChatGPT Web → Codex Responses körpüsünə, o cümlədən brauzer sessiyası, response çərçivələndirməsi, istifadə və web axtarışı adapterlərinə uyğunlaşdırılmış MIT mənbə kodu.
free-claude-code	65,966	Axın bərpası, thinking-siz alias-lar, ehtiyat web axtarışı, sürüşən pəncərə məhdudiyyətləri, log redaktəsi və gücləndirilmiş launcher axınlarına port edilmiş nümunələr.
composer-api	347	Cursor Composer alət seçimi, çıxış məhdudiyyəti və alət commit nümunələri native Cursor icraçısına uyğunlaşdırılıb.
codex-multi-auth	561	İlkin giriş və refresh-token rotasiyası nümunələri Codex OAuth yenidən autentifikasiyasına port edilib.
opencode-anthropic-auth	562	Claude Code ilə uyğun transformasiya standartları və billing-header davranışı OmniRoute-un konfiqurasiya ilə idarə olunan körpüsündə ümumiləşdirilib.
grok2api-merged	2	Onun Grok model xəritələndirmələri, saxta TypeError Statsig generatoru, sorğu və cihaz standartları, eləcə də NDJSON response prosessoru OmniRoute-un Grok Web icraçısına əhəmiyyətli dərəcədə uyğunlaşdırılıb.
TQZHR/grok2api	707	grok2api-merged-in əsas transitive kod mənbəyi; onun model, header, payload, Statsig və prosessor implementasiyaları Grok Web mənşəyində qorunub saxlanılıb.
chenyme/grok2api	7,874	TQZHR və grok2api-merged vasitəsilə ötürülən Grok payload və cihaz standartlarının, Statsig generatorunun və `result.response` prosessorunun əsas MIT mənbəyi.
grok2api-pro	27	Proxy-pool qatına görə grok2api-merged tərəfindən istinad edilən transitive mənbə; OmniRoute bu mənşə qeydini qoruyur, lakin məhdudlaşdırılmış Grok Web icraçısında proxy-pool portu olduğunu iddia etmir.
GrokProxy	52	Onun cookie ilə autentifikasiya olunan Grok proxy-si və `result.response.token` axın nümunəsi OmniRoute-un Grok Web nəqliyyatına istiqamət verib.
GrokBridge	5	Orijinal Grok Web implementasiyasının HTTP/brauzer upstream dizaynına müraciət edilib; onun birbaşa HTTP yolu GrokProxy-dən törəyir, buna görə ayrıca kod portu iddia edilmir.

### 🗜️ Kontekst və token sıxlaşdırması — mühərriklər

Layihə	⭐	OmniRoute-a necə ilham verdi
Caveman	116,957	Viral “az token istifadə et, çünki az tokenlə də iş görülür” layihəsi — onun mağara adamı üslubundakı fəlsəfəsi standart sıxılma rejimimizi və 30-dan çox doldurucu/kondensasiya qaydasını formalaşdırır.
RTK – Rust Token Killer	85,350	Komanda çıxışının yüksək məhsuldarlıqlı sıxılması — RTK mühərrikimizə, JSON filtr DSL-inə, xam çıxışın bərpasına və RTK → Caveman ardıcıl pipeline-ına ilham verdi.
headroom	78,672	Bərpa edilə bilən kontekst sıxılması (SmartCrusher) — `headroom` mühərrikimizə və `ccr` bərpa marker nümunəsinə ilham verdi.
LLMLingua	6,797	Prompt sıxılması üzrə araşdırmalar (LLMLingua / LLMLingua-2) — asinxron, kodu təhlükəsiz və fail-open `llmlingua` mühərrikimizə ilham verdi.
llmlingua-2-js	33	LLMLingua mühərrikimiz üçün worker-thread backend kimi istifadə olunan JS/ONNX portu (MobileBERT / XLM-RoBERTa).
Troglodita	50	PT-BR token sıxılması — Braziliya-portuqal qrammatikasına uyğunlaşdırılmış pleonazmın azaldılması və doldurucuların silinməsi ilə pt-BR dil paketimizi təmin edir.
ponytail	182,929	Viral “tənbəl senior developər” YAGNI-koder bacarığı — less-code Output Style-ımıza ilham verdi: Caveman-ın yığcam nəsrinin çıxış oxu üzrə analoqu olan, _generasiya edilmiş_ kodu azaldan ən kiçik işlək dəyişiklik yönləndirməsi.
i-have-adhd	59,838	Onun əməl-yönümlü, ADHD-yə uyğun cavab üslubu beş dil üzrə OmniRoute-un yığcam çıxış üslubuna uyğunlaşdırıldı.

### 🧩 Yığcam formatlar, token araşdırmaları və kodu nəzərə alan alətlər

Layihə	⭐	OmniRoute-a necə ilham verdi
TOON	25,602	Token-Oriented Object Notation — onun sütun əsaslı, 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	61	Onun yığcam qraf formatı və ümumi profil dizaynı OmniRoute-un cədvəl sıxlaşdırmasına və Headroom kodek formatına təsir etdi.
gcf-typescript	4	Headroom ümumi profil kodeki kimi birbaşa vendora əlavə edilən və genişləndirilən MIT TypeScript tətbiqi.
token-optimizer-mcp	566	Brotli/SQLite keş + sessiya üzrə kontekst deltası — `session-dedup` mühərrikimizə ilham verdi.
token-savior	1,203	Bash çıxışının sıxlaşdırılması + MCP profilləri — sıxılmadan imtina intizamımıza və MCP alət manifestinin azaldılmasına ilham verdi.
token-saver	162	Məzmunu nəzərə alan, fayl tipinə görə çıxış sıxılması və xətadan xəbərdar imtina mexanizmi — tip üzrə yönləndirməmizi və minimal qazanc olduqda ötürməni təsdiqlədi.
token-optimizer	2,853	“Gizli tokenləri tapın” — onun offload + bərpa edilə bilən handle nümunəsi CCR offload yanaşmamıza təsir etdi.
TokenMizer	34	Sessiya qrafı + növbələrarası sətir dedupl ikasiyası üzrə blueprint session-dedup dizaynımıza təsir etdi.
OmniCompress	3	Rust sütun əsaslı JSON + məzmuna əsaslanan bərpa + mesajlararası deduplikasiya — `headroom`/`ccr`/`session-dedup` mühərrik dizaynımızı və keş baxımından sabit “sıxılmış forma mövqedən asılı deyil” invariantını təsdiqlədi.
mcp-compressor	140	MCP alət sxeminin/təsvirinin sıxılması — MCP alət manifestində element sayının azaldılmasına təsir etdi.
RepoMapper	218	Aider üslubunda repo xəritəsinin sıralanması — repo xəritəsi / axtarış sıralaması üzrə araşdırmamıza təsir etdi.
quiet-shell-mcp	4	MCP üzərindən deklarativ shell çıxışının azaldılması — deklarativ bash çıxışının sıxlaşdırılmasını təsdiqlədi.
ts-morph	6,222	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-a necə ilham verdi
Mem0	68,294	Universal yaddaş qatı — onun proxy-as-write/read-boundary modeli yaddaş arxitekturamızı formalaşdırdı.
Letta (MemGPT)	25,321	Qatlı yaddaşa malik vəziyyətli agentlər — Context Control & Recovery (CCR) qatlı modelimizə ilham verdi.
WFGY	1,804	16 təkrarlanan RAG/LLM uğursuzluq rejimindən ibarət ProblemMap taksonomiyası — problemlərin aradan qaldırılması təlimatımızdakı ortaq terminologiya.

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

Layihə	⭐	OmniRoute-a necə ilham verdi
llm-interceptor	81	Kodlaşdırma köməkçisi ↔ LLM trafikinə MITM müdaxiləsi və təhlili ilkin Traffic Inspector tələblərinin formalaşmasına kömək etdi. Əvvəllər əldə edilmiş 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 sanitarlaşdırılması — ictimai protokol standartlarına əsaslanan müstəqil clean-room tətbiqləri ilə əvəz edilib. İki host-passthrough səthi (`passthrough.ts` və `_internal/bypass.cjs`) OmniRoute-a məxsus daxili tətbiqlər olaraq ayrıca təsnif edilir; onlar həmin əvəzləmə çərçivəsində yenidən yazılmayıb.
ProxyBridge	6,978	Proses üzrə şəffaf proxy marşrutlaşdırması — qəza zamanı təhlükəsiz MITM söndürülməsinə, socket boşdayanma vaxtı limitlərinə, `/proc` proses aidiyyətinin müəyyənləşdirilməsinə və TPROXY ələ keçirilməsinə ilham verdi.

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

Layihə	⭐	OmniRoute-a necə ilham verdi
models.dev	7,486	AI modellərinin spesifikasiyaları, qiymətləri və imkanlarından ibarət açıq verilənlər bazası — model kataloqumuza yerli şəkildə sinxronlaşdırılır.
React Flow / xyflow	38,874	Real vaxt rejimində işləyən Compression Studio və Combo/Routing Studio-nu təmin edən qovşaq əsaslı qraf kitabxanası.
LangGraph	44,349	LangGraph Studio-nun canlı iş axını qrafikinin vizuallaşdırılması Studios-un real vaxt rejimindəki kaskad görünüşünə ilham verdi.
Langfuse	36,907	Onun trace → span → generation müşahidəolunma modeli Compression Studio-dakı waterfall görünüşümüzü formalaşdırdı.
Kiali	3,647	Istio xidmət-mesh müşahidəolunması — Routing/Combo Studio-dakı circuit-breaker nişanlarına və xəta kənarlarının vizuallarına ilham verdi.
lobe-icons	2,666	İdarə panelimizdə provayder ikonlarını göstərən AI/LLM brend loqoları.
flag-icons	12,499	README dil seçicisində istifadə olunan MIT lisenziyalı SVG bayraqlarını təmin edir.

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

Layihə	⭐	OmniRoute-a necə ilham verdi
awesome-secure-defaults	723	Təhlükəsizliyi standart olaraq təmin edən, seçilmiş kitabxanaların siyahısı; təhlükəsizlik seçimlərimizə (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink) istiqamət verir.

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

Layihə	⭐	OmniRoute-a necə ilham verdi
ClawRouter	6,649	Sorğuların deduplikasiyasına, fövqəladə hallarda sıfır xərcli ehtiyat mexanizminə, plaginləşdirilə bilən Auto-Combo strategiyalarına və çoxdilli niyyət təsnifatına ilham verdi.
Antigravity-Manager	32,785	Onun hesabdan xəbərdar model remapinqi, icra edilə bilən yolun yoxlanılması və plan etiketlərinin davranışı OmniRoute-un Antigravity runtime mühitinə istiqamət verdi.
vscode-antigravity-cockpit	4,852	Onun yığcam kvota sıfırlanması geri sayım formatı OmniRoute-dakı müvafiq provayder limiti görünüşünə ilham verdi.
AionUi	33,996	Onun ACP inteqrasiyaları OmniRoute-un quraşdırılmış CLI agentlərini avtomatik aşkarlamasına ilham verdi.
CodexBar	22,955	Grok Build kvota səthini müəyyənləşdirdi; OmniRoute daha sonra canlı wire 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 süni intellekt icması üçün ❤️ ilə hazırlanıb. _{Diego Souza tərəfindən yaradılıb · OmniRoute v3.8.54 · Node ≥22.22.2 · MIT lisenziyası · omniroute.online}