# 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 → 372 provayder — 150-dən çoxu pulsuz — vahid son nöqtə vasitəsilə. Claude Code, Codex, Cursor, Cline, Copilot və Antigravity-ni avtomatik ehtiyat keçidi ilə PULSUZ Claude / GPT / Gemini-yə qoşun. RTK + Caveman çoxsəviyyəli sıxılma ilə tokenlərə 15–95% (orta hesabla ~89%) qənaət edir — limitlərə heç vaxt çatmayın. 372 süni intellekt provayderi · 150-dən çox pulsuz tarif · ayda ~1.62 milyard pulsuz token · 19 marşrutlaşdırma strategiyası · başlamaq üçün $0.

## 💰 Üçüncü Tərəf Pulsuz Paketləri üzrə Ayda ~1.62B Token

> **Öz provayder hesablarınızdan istifadə edin.** Bu, OmniRoute tərəfindən verilən token paketi deyil, ayrı-ayrılıqda uyğun olduğunuz üçüncü tərəf pulsuz paketlərinin təxmini ümumi həcmidir. Qeydiyyatdan keçin, tələb olunan hallarda giriş məlumatlarını əldə edin və istifadə edə bildiyiniz provayderləri qoşun; hər bir provayder öz limitlərini, əlçatanlığını və şərtlərini idarə edir. > > Pulsuz paketləri əl ilə birləşdirmək əziyyətlidir — onlarla SDK, onlarla sürət limiti və əslində nə qədər resursunuz olduğuna dair heç bir aydınlıq yoxdur. OmniRoute **35 təkrarlanan hovuz açarı üzrə 489 pulsuz paket qeydini** kataloqlaşdırır və token başlığını **dərc edilmiş müsbət aylıq büdcəyə malik 17 hovuzdan, üstəgəl model üzrə beş Groq limitindən** hesablayır; ortaq hovuzlar təkrarlanmadan nəzərə alınır. Yalnız regional şəxsiyyət yoxlamasından sonra açılan kvotalar (hazırda: ModelScope) ayrıca göstərilir — regional şəxsiyyət yoxlamasından sonra +~6M — və heç vaxt başlıqdakı ümumi məbləğə əlavə edilmir. Nəticə idarə panelində (`/dashboard/free-tiers`) görünməyə davam edir.

OmniRoute pulsuz paket büdcəsi kartı: ayda davamlı olaraq ~1.62B pulsuz token, qeydiyyat kreditləri ilə ilk ayda ~2.22B-dək; bir son nöqtə arxasında kataloqlaşdırılmış 489 pulsuz paket qeydini əhatə edən 35 sənədləşdirilmiş təkrarlanan hovuz açarından. Ortaq hovuzlar təkrarlanmadan dürüst hesablama — dərc edilmiş müsbət aylıq token büdcəsinə malik 17 təkrarlanan hovuz və model üzrə beş Groq limiti daxil olmaqla, hər ortaq hovuz yalnız bir dəfə hesablanır; qərarı sizin verməyiniz üçün 13 provayder şərtlər üzrə risk kataloqunda uzaq durulmalı kimi işarələnib. Büdcə zolağına Mistral 1B, Nara 210M, LLM7 150M, xKiro 150M, Groq 30M (model üzrə beş limit) və daha kiçik hovuzlar daxildir; həmçinin ilk ay üçün qeydiyyat kreditləri və daimi pulsuz, token limiti olmayan provayderlər ayrıca göstərilir ki, başlıqdakı məbləği heç vaxt süni şəkildə artırmasın. Canlı istifadə edilmiş/qalan göstəriciləri /dashboard/free-tiers səhifəsində.

> Canlı `/dashboard/free-tiers` səhifəsinin animasiyalı xülasəsi. Tam metodologiya (hovuzların təkrarsızlaşdırılması, kredit səviyyələri, provayder şərtləri): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**. > > _{Bu rəqəmlər hər iki həftədən bir canlı kataloq əsasında yenidən yoxlanılır və **hər iki istiqamətdə dəyişir** — provayder pulsuz paketi dayandırdıqda rəqəm azalır, yenisi əlavə edildikdə isə artır. Biz yuvarlaqlaşdırılaraq artırılmış ən yaxşı ehtimalı deyil, kataloqun faktiki hesabladığı nəticəni dərc edirik.}

⭐ OMNIROUTE pula qənaət etməyinizə və işinizi asanlaşdırmağınıza kömək edibsə, repozitoriyaya 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 **👋 Məsul şəxsi 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/) [![GitHub-da @diegosouzapw hesabını 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, inkişaf planı 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.52+` | | ---------------------------- | :------------------------: | :---------: | :-------------------: | | 🌐 Provayderlər | 352 | **358** | 372 | | 🧠 Unikal çat model ID-ləri | 1320 | **1374** | 1443 | | 🖼️ Modallıq körpüsü | 🆕 görüntü + audio + video | ✓ | ✓ | | 📡 Radar pulsuz kataloqu | 🆕 könüllü qoşulma | ✓ | ✓ | | ⚖️ Kvota əsaslı planlaşdırma | 🆕 Quota-Share | ✓ | ✓ | | 📊 Kvota telemetriyası | 🆕 canlı | ✓ | ✓ | | 🧰 Başsız rejim | — | — | 🆕 `serve --headless` | | 🛤️ LTS reliz infrastrukturu | — | — | 🆕 reliz kanalları | **→ [Yol xəritəsi](ROADMAP.md) — `v3.9.0 LTS` relizinə 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 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ırma	🆓 Sıfır konfiqurasiya
💡 Öyrənin	💥 Vəd	🤔 Niyə OmniRoute	🏆 Fərqləndirən cəhətlər
⚙️ Funksiyalar	🎯 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, provayderi qoşun, sonra vahid son nöqtə vasitəsilə 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 provayderi qoşun, sonra OmniRoute API açarı və auto modeli ilə alətinizi localhost:20128/v1 ünvanına yönəldin. Yönləndirmə mövcud uyğun bağlantılardan və provayder məhdudiyyətlərindən asılıdır.

```bash # Provayderi qoşduqdan sonra OmniRoute açarınızı İdarəetmə paneli → Son nöqtələr bölməsindən kopyalayın: curl http://localhost:20128/v1/chat/completions \ -H "Authorization: Bearer YOUR_OMNIROUTE_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}' ``` _{`auto` uyğun marşrut tələb edir. Yeni quraşdırmada açarsız heç bir uyğun hədəf olmaya bilər və açarsız provayder üçüncü tərəf klientlərini rədd edə bilər. OpenCode Free və Kiro daxil olmaqla, `tos: avoid` ilə işarələnmiş provayderlər standart olaraq avtomatik yönləndirmədən xaric edilir; hesabın qoşulması bu ayarı ləğv etmir. Provayder seçməzdən əvvəl [Pulsuz tariflər üzrə təlimat](docs/getting-started/FREE-TIERS-GUIDE.md) ilə tanış olun.} _{📦 **Python, Node.js, PHP və cURL** üçün kopyalayıb yapışdırmağa hazır sürətli başlanğıc skriptləri → [`examples/quickstart/`](examples/quickstart/)}

# 💥 Vədimiz

# 🤔 Niyə OmniRoute?

OmniRoute sorğu axını: IDE və ya CLI-niz (Claude Code, Cursor, Cline…) vahid lokal son nöqtəyə (http://localhost:20128/v1) müraciət edir; uyğun və işlək hədəf mövcud olduğu müddətdə OmniRoute Ağıllı Yönləndiricisi (RTK + Caveman sıxılması, 19 yönləndirmə strategiyası, dövrə kəsiciləri, TLS maskalanması, MCP, A2A, qoruyucu məhdudiyyətlər) 4 provayder səviyyəsi üzrə ehtiyat keçid 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 — Əsas imkan

Bütün 19 kombo marşrutlaşdırma strategiyasının animasiyası — 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, cache-optimized, lkgp, auto, fusion, pipeline. Hər birinin nə etdiyini öyrənmək üçün yuxarıdakı cədvələ baxın.

> **Kombo** OmniRoute-un **avtomatik** marşrutlaşdırdığı modellər zənciridir. Kvota tükənərsə, provayder nasaz olarsa və ya xərclər kəskin artarsa, kombo növbəti uyğun və işlək modelə keçə bilər. 🛡️ ### ⚡ Sıfır konfiqurasiya — sadəcə `auto` istifadə edin Kombo yaratmağa ehtiyac yoxdur. Modelinizi `auto` (və ya onun bir variantı) olaraq təyin edin və OmniRoute qoşulmuş provayderlərinizdən real vaxtda qiymətləndirilən virtual kombo yaratsın:

Model ID-si	Nə üçün optimallaşdırılır
`auto`	🎯 Balanslaşdırılmış standart seçim (LKGP — son uğurlu provayderinizə bağlı qalır)
`auto/coding`	🧑💻 Kod generasiyası üçün keyfiyyətə üstünlük verən çəkilər
`auto/fast`	⚡ Əvvəlcə ən aşağı gecikmə
`auto/cheap`	💰 Əvvəlcə token başına ən ucuz seçim
`auto/offline`	🔋 Əvvəlcə ən çox kvota / sürət limiti ehtiyatı
`auto/smart`	🔭 Keyfiyyətə üstünlük + daha yaxşı modelləri aşkarlamaq üçün 10% araşdırma
`auto/lkgp`	📌 Son məlum uğurlu provayderə açıq şəkildə bağlı qalma
`auto/chaos`	🧪 Modellər panelinə paralel paylama (hər provayderdən bir model, standart olaraq 5), bir cavab qaytarır; nasazlıq inyeksiyası deyil, paneldəki hər model üçün bir yuxarı axın çağırışı edilir

## ### 🔀 Yaxud öz kombonuzu yaradın — 19 marşrutlaşdırma strategiyası Bütün **19** strategiya — hər kombo addımında qarışdırıb uyğunlaşdırın:

#	Strategiya	Nə edir
1	`priority`	İlk hədəfə üstünlük verən sıralı siyahı — növbəti hədəfə keçməzdən əvvəl hər birini tükəndirir 🥇
2	`fill-first`	Növbəti hədəfə keçməzdən əvvəl hər hədəfin kvotasını tam doldurur
3	`weighted`	Hər hədəfin çəkisinə əsaslanan çəkili təsadüfi seçim
4	`round-robin`	Hədəflər arasında ardıcıllıqla dövr edir
5	`p2c`	İki seçim prinsipinə əsaslanan təsadüfi yük balanslaşdırması
6	`least-used`	Cari yükü ən az olan hədəfi seçir
7	`random`	Bərabər ehtimallı təsadüfi seçim (təkrarlardan təmizlənmiş)
8	`strict-random`	Təkrarları aradan qaldırmadan təsadüfi seçim 🎲
9	`cost-optimized`	Canlı kataloq qiymətləri əsasında hər sorğu üçün $ xərcini minimuma endirir 💸
10	`headroom`	Ən çox qalan kvotaya malik hədəfi seçir
11	`reset-window`	Kvota pəncərəsi ən tez sıfırlanan hədəfə üstünlük verir
12	`reset-aware`	Kvotanın sıfırlanma vaxtına görə sıralayır — əvvəlcə qısa pəncərələr 📊
13	`context-relay`	Uzun söhbətlər üçün konteksti hədəflər arasında ötürür 🧠
14	`context-optimized`	Cari kontekst ölçüsünə ən uyğun hədəfi seçir
15	`cache-optimized`	Hər təkrar istifadə edilə bilən sorğu prefiksini eyni hesaba bağlayır — sorğu keşi uyğunluqlarını maksimuma çatdırır 🎯
16	`lkgp`	Son Məlum Uğurlu Yol — son uğurlu provayderə bağlanır, sonra qaydalara əsasən ehtiyat seçimə keçir
17	`auto`	Hər bağlantı üzrə 16 amilli real vaxt qiymətləndirməsi 🤖
18	`fusion`	Modellər panelinə paralel paylayır + hakim bir cavabı sintez edir 🧬
19	`pipeline`	Addımları zəncirləyir — hər hədəfin çıxışı növbəti hədəfə ötürülür 🔗

_{Auto-Combo mühərriki hər namizədi **16 amil** (işlək vəziyyət, kvota, xərc, gecikmə, tapşırığa uyğunluq, keyfiyyət, sessiyanın əlçatanlığı…) üzrə qiymətləndirir — [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md) sənədinə baxın.} ## ### 🧱 Dayanıqlılıq daxildən təmin edilir (3 müstəqil qat)

OmniRoute dayanıqlılığı — 3 müstəqil özünübərpa qatı, hər nasazlıq üçün uyğun qat. Qat 1 provayder dövrəqırıcısı (bütün provayder): yalnız 408/5xx hallarında işə düşür, hədlər OAuth 8× / API açarı 12× / lokal 2×, 60s/30s/15s sonra YARIM-AÇIQ yoxlama rejiminə keçir, tənbəl bərpa; AÇIQ olduğu müddətdə kombinasiya sorğuları növbəti provayderə yönləndirir. Qat 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, sorğu selinin qarşısını alan qoruma ilə eksponensial ×2 geriçəkilmə, 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; gözləmə rejimində olan bir açar ötürülür, digər açarlar isə xidmət göstərməyə davam edir. Qat 3 modelin bloklanması (bir model): model üzrə 429, lokal 404 və ya rejim imtinaları 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ə müddətləri deyil, operatorun müdaxiləsi üçündür.

_{📖 [Avtomatik Kombinasiya Mühərriki](docs/routing/AUTO-COMBO.md) · [Dayanıqlılıq Bələdçisi](docs/architecture/RESILIENCE_GUIDE.md)}

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

OmniRoute-u fərqləndirən xüsusiyyətlər — 13 imkan üzrə 9router, OpenRouter, CLIProxyAPI və LiteLLM ilə müqayisədə müəyyən tarixə aid xüsusiyyət icmalı. OmniRoute: 372 provayder, daxili 150-dən çox pulsuz tarif, 19 marşrutlaşdırma strategiyası, 12 mühərrikli token sıxışdırması, 110 aləti olan daxili MCP serveri, A2A agent protokolu, daimi yaddaş, qoruyucu məhdudiyyətlər, bulud agentləri, TLS rəqəmsal izinin gizlədilməsi, Desktop/Termux/PWA və istifadəçi interfeysi üçün 42 i18n lokalı. OmniRoute MIT lisenziyalıdır və öz serverinizdə yerləşdirilə bilər. Rəqiblərin imkanları və sayları dəyişə bilər; keçiddəki metodologiyaya baxın.

_{📊 Tam metodologiya və 9router, OpenRouter, CLIProxyAPI və LiteLLM ilə müqayisədə hər xüsusiyyət üzrə ətraflı məlumat → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)}
## 💚 OmniRoute-u dəstəkləyin OmniRoute MIT lisenziyalıdır və açıq şəkildə dəstəklənir. Əgər vaxtınıza və ya pulunuza qənaət edirsə, onun müstəqilliyini qorumağa belə kömək edə bilərsiniz — sizə uyğun olanı seçin. Sponsorluq heç vaxt yönləndirmə prioritetinə təsir etmir; reytinq deyil, görünürlük qazandırır.

⭐ 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.50** versiyalarındakı son əsas yeniliklər. Tam tarixçə [`CHANGELOG.md`](CHANGELOG.md) faylındadır. - **🎛️ OmniConductor** — agentlər parkınıza daxil olan A2A delegasiyası, Agent Card üzərində Conductor bacarıqları və Faro basıb-danışma səsli söhbəti olan idarəetmə paneli. → [A2A Serveri](docs/frameworks/A2A-SERVER.md) - **🛂 Adaptiv qəbul və həddindən artıq yüklənmədən qorunma** — resurs tutumlu söhbət sorğuları 503 xətası qaytarmaq əvəzinə növbəyə alınır və hər bağlantı üçün atomik RPM sürüşən icarələri tətbiq edilir. → [Dayanıqlılıq Bələdçisi](docs/architecture/RESILIENCE_GUIDE.md) - **🗂️ Kanonik `/v1/models` sıralaması** — hər provayder üçün bir bitişik, provayder üzrə qruplaşdırılmış blok (kombinasiyalar əvvəlcə sabitlənir); bütün kataloq mənbələrində sabit qalır. → [API İstinadı](docs/reference/API_REFERENCE.md) - **🗜️ Sıxılmanın möhkəmləndirilməsi** — standart olaraq aktiv genişlənmə qoruyucusu, DE / FR / JA + Çin dili (wényán) üçün Caveman paketləri, Gradle və .NET üçün RTK filtrləri. → [Sıxılma](docs/compression/COMPRESSION_ENGINES.md) - **💸 Dürüst sabit 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 isə təxmin aparmağa davam edir. → [API İstinadı](docs/reference/API_REFERENCE.md) - **⚖️ Quota-Share marşrutlaşdırması** — ortaq hesabın kvotasını hovuzdakı açarlar arasında ədalətli şəkildə bölür və iş yükünü qoruyaraq istifadə olunmayan payları başqalarına ötürür. → [Dayanıqlılıq Bələdçisi](docs/architecture/RESILIENCE_GUIDE.md) - **🤖 Bir əmrlə CLI/agent quraşdırması** — 13 qeydiyyatdan keçmiş `setup-*` əmri; `omniroute run` 7 CLI-ni (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI) işə salır; `omniroute configure` interaktiv provayder+model seçicisi və hər kontekst üzrə sevimlilərlə 10 hədəfi dəstəkləyir. → [CLI İnteqrasiyaları](docs/guides/CLI-INTEGRATIONS.md) - **🛰️ Uzaqdan rejim** — əhatə dairəsi məhdud tokenlərlə (`connect` / `contexts` / `tokens`) uzaq OmniRoute-u idarə edin; VPS quraşdırmaları üçün `antigravity` OAuth köməkçisi də mövcuddur. → [Uzaqdan Rejim](docs/guides/REMOTE-MODE.md) - **🧭 Daha ağıllı avtomatik marşrutlaşdırma** — `auto/:` kombinasiyaları, **Fusion** (model paneli + hakim), tapşırıqdan xəbərdar marşrutlaşdırma, hər sorğu üzrə model / rejim / USD büdcəsi əvəzləmələri. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🗜️ Qoşula bilən sıxılma** — 12 birləşdirilə bilən mühərrik + Compression Studios: LLMLingua-2, iki səviyyəli Ultra, omniglyph, hər addım üçün dəqiqlik şlüzü, GCF v3.2, sürükləyib yenidən sıralama redaktoru. → [Sıxılma](docs/compression/COMPRESSION_ENGINES.md) - **🕵️ Şəffaf MITM deşifrələməsi (TPROXY)** — hər SNI üçün CA və etibar anbarı quraşdırıcısı ilə proksi mühit dəyişənlərinə məhəl qoymayan CLI-ləri ələ keçirin. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md) - **💸 Hər yerdə xərc telemetriyası** — hər son nöqtədə `X-OmniRoute-*` xərc/istifadə başlıqları, keş-HIT qənaət başlığı, hər açar üzrə USD xərc kvotaları. → [API İstinadı](docs/reference/API_REFERENCE.md) - **🧠 İdarə etdiyiniz yaddaş** — standart olaraq deaktivdir, könüllü int8 vektor kvantlaşdırması + tipləşdirilmiş zəifləmə, hər sorğu üzrə `x-omniroute-no-memory`. → [Yaddaş](docs/frameworks/MEMORY.md) - **🛡️ Təhlükəsizlik** — hər LLM marşrutunda prompt inyeksiyası qoruyucusu (red-team test dəsti), könüllü etimadnamə maskalama qoruyucu məhdudiyyəti (sızmış API açarlarını/sirlərini hər iki istiqamətdə redaktə edir), pulsuz son çarə DuckDuckGo veb axtarışı və idarəetmə paneli üçün istəyə bağlı OIDC giriş şlüzü (parolla giriş həmişə əlçatan qalır). → [Qoruyucu Məhdudiyyətlər](docs/security/GUARDRAILS.md) - **🖼️ Yeni son nöqtələr** — `/v1/ocr` (Mistral OCR) və `/v1/audio/translations` (Whisper üslubunda) media imkanlarını tamamlayır. → [API İstinadı](docs/reference/API_REFERENCE.md) - **🎨 Şəkil / video / audio generasiyası** — media üçün vahid API: xAI Grok Imagine və Novita AI videosu, ComfyUI, Magnific, Adobe Firefly, Segmind və ElevenLabs kimi nitq provayderləri. → [API İstinadı](docs/reference/API_REFERENCE.md) - **🌍 Yerləşdirmə və əməliyyatlar** — əks proksi `basePath`, brauzer dilinin avtomatik aşkarlanması, hər açar üzrə cihaz izlənməsi, root tələb etməyən 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), tam dəstəklənən 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ş **352 provayderlik kataloq**. → [Provayderlər](docs/reference/PROVIDER_REFERENCE.md) - **📡 Marşrutlaşdırma şəffaflığı** — hər cavab onu təmin edən strategiya/provayder/gecikməni göstərən `X-OmniRoute-Decision` başlığı daşıyır; yeni `cache-optimized` kombinasiya strategiyası + Auto-Combo `cacheAffinity` amili təkrar sorğuları keşlənmiş prefiksi saxlayan bağlantıya geri yönləndirir; yalnız oxuma üçün `/v1/auto-combo/{channel}/candidates` son nöqtəsi isə `auto/*` kanalının canlı namizəd hovuzunu göstərir. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **⚡ Lokal performans və infrastruktur** — bir kliklə lokal Redis, Cloudflare Workers / Deno Deploy rele yerləşdiriciləri, nəzarət altında daxili xidmətlər kimi Bifrost və Mux. → [Daxili Xidmətlər](docs/frameworks/EMBEDDED-SERVICES.md) - **🧩 Paketə həmçinin daxildir** — plagin çərçivəsi + marketpleys, Omni/Agent/GitHub bacarıq çərçivələri, Obsidian anbarı inteqrasiyası (22 MCP aləti), OpenAI ilə uyğun Batch və Files API-ləri, semantik cavab keşi, liderlik cədvəlləri ilə oyunlaşdırma, ACP agent aşkarlanması (15 daxili agent), BigQuery-yə planlaşdırılmış jurnal ixracı, `auto/chaos` paralel çoxmodelli paylanması, Telegram bot körpüsü, tətbiqdaxili versiya meneceri və LMArena-ELO pulsuz provayder reytinqləri. → [Sənədlər](docs/README.md)

## 🤖 Uyğun CLI-lər və Kodlaşdırma Agentləri > Bir konfiqurasiya — `http://localhost:20128/v1` — və **hər bir** süni intellekt IDE-si və ya CLI pulsuz və aşağı qiymətli modellərdə işləyir.

_{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 36 alət üçün ayrıca quraşdırma (26 CLI Code + 10 CLI Agent) → [`docs/reference/CLI-TOOLS.md`](docs/reference/CLI-TOOLS.md) · 🧩 OpenCode plagini → [`@omniroute/opencode-provider`](https://www.npmjs.com/package/@omniroute/opencode-provider)}

**Dəstəklənən istənilən CLI-ni OmniRoute vasitəsilə bir əmrlə başladın** — heç bir konfiqurasiya faylı yazılmır, giriş məlumatları hər proses üçün ayrıca ötürülür, Qwen/Gemini isə birdəfəlik, təcrid olunmuş ev qovluğu əldə edir: ```bash omniroute run claude --model openai/gpt-5.4 # Claude Code omniroute run codex --model glm/glm-5.2 # OpenAI Codex CLI omniroute run aider --model glm/glm-5.2 -- --message "reply OK" omniroute run goose --model glm/glm-5.2 omniroute run opencode --model glm/glm-5.2 -- run "reply OK" omniroute run qwen --model glm/glm-5.2 -- -p "reply OK" omniroute run gemini --model glm/glm-5.2 -- --skip-trust -p "reply OK" # Yaxud provayderi və modeli interaktiv şəkildə seçin və alətin öz konfiqurasiyasını yazın: omniroute configure codex # həmçinin: claude opencode qwen aider goose gemini cline continue kilo ``` Hər bir əmr aktiv uzaq konteksti (`omniroute connect `) nəzərə alır, `--dry-run` icra etmədən dəqiq mühit dəyişənlərini/arqumentləri əvvəlcədən göstərir, `--api-key-env NAME` isə məxfi məlumatların əmr tarixçənizə düşməsinin qarşısını alır. → [CLI inteqrasiyaları](docs/guides/CLI-INTEGRATIONS.md)

## 🌐 372 AI Provayderi — 154-ü Kataloqda Pulsuz Kimi İşarələnib

> Kanonik çat, media, axtarış, lokal, bulud agenti və sistem kolleksiyalarında **372 qeydiyyatdan keçmiş provayder**, o cümlədən **`hasFree: true` aşkarlama metadatasına malik 154 provayder** var. Çat modeli reyestri **237 provayderi / 3,009 unikal provayder-model cütünü / 1,443 xam model ID-sini** əhatə edir; ayrıca pulsuz büdcə kataloqunda isə **modellər üzrə 491 sətir**, **35 təkrarlanan hovuz** və **54 təkrarlanan/açarsız, həmişəlik pulsuz provayder** var. Bunlar məqsədli şəkildə fərqli məxrəclərdir; təriflər və hovuzlar üzrə dublikatları aradan qaldırılmış hesablamalar [Provayder Arayışı](docs/reference/PROVIDER_REFERENCE.md) və [Pulsuz Tariflər](docs/reference/FREE_TIERS.md) bölmələrində verilib.

### 🏢 Bütün əsas laboratoriyalar — vahid son nöqtə vasitəsilə

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

_{…və daha 330+ provayder — hər bir ikon birbaşa idarə panelinin provayder kataloqundan yüklənir. 📖 [Provayder Arayışı](docs/reference/PROVIDER_REFERENCE.md)}
### 🆓 Həmişəlik Pulsuz — $0, kart tələb olunmur

OpenCode Zen _{DeepSeek V4, Nemotron 3 Token limiti yoxdur}	Kilo Code _{Avtomatik marşrutlaşdırıcı, Tencent Hy3 Həmişə pulsuz}	Requesty _{GPT-OSS 120B, Nemotron Həmişə pulsuz}	SiliconFlow _{DeepSeek V3.2 / R1 Pulsuz 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 Gündə 10K neyron}	NVIDIA NIM _{GLM, MiniMax Pulsuz ~40 RPM}	Cerebras _{GLM 4.7, GPT-OSS Birdəfəlik $5 kredit; kart tələb olunur}	OpenRouter _{:free modelləri +$10 → daha yüksək RPM}

📖 Maşın tərəfindən oxuna bilən tam 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ə panelidir** və açıq agent protokolları sayəsində süni intellekt agenti onu **müstəqil şəkildə** idarə edə bilər. ### ⌨️ Əsl CLI (yalnız `start` deyil) ```bash omniroute # şlüzü + idarəetmə panelini işə salır (port 20128) omniroute chat # interaktiv TUI söhbət klienti (əmrlər: /model /combo /skill /memory) omniroute setup # ilk işəsalma üçün addım-addım köməkçi omniroute doctor # provayderləri, portları və yerli asılılıqları diaqnostika edir ``` ### 🛰️ Uzaqdan rejim — CLI-ni burada, OmniRoute-u VPS-də işlədin OmniRoute serverdədir? Onu noutbukunuzdan **eyni CLI** ilə idarə edin. Əhatə dairəsi məhdud giriş tokeni ilə bir dəfə daxil olun; bundan sonra hər əmr uzaq serverə yönələcək. ```bash omniroute connect 192.168.0.15 # parol → əhatə dairəsi məhdud token, kontekst kimi saxlanılır omniroute models list # ← UZAQ serverdə icra olunur omniroute configure codex # ← uzaq modeli seçir, lokal Codex profili yazır omniroute tokens create --name ci --scope read # digər maşınlar üçün daha məhdud tokenlər yaradır omniroute contexts use default # ← yenidən lokal serverə keçir ``` Tokenlərin əhatə dairəsi `read` / `write` / `admin` olur; proses yaradan marşrutlar yalnız loopback üçün əlçatan qalır. _{📖 [Uzaqdan rejim](docs/guides/REMOTE-MODE.md)}

OmniRoute CLI-ni nümayiş etdirən animasiyalı terminal — omniroute providers list, omniroute combo list və omniroute health — 86 əmrlik üst səviyyə imkanları arasında dövr edir: 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 — imkanlı istənilən agent (və ya öz kodunuz) bütün şlüzü avtonom şəkildə idarə edə biləcək: marşrutlaşdırma, provayderlər, kombinasiyalar, keş, sıxılma, yaddaş. Aşağıdakı HTTP son nöqtələri `http://localhost:20128` ünvanı altında təqdim olunur.

İnterfeys	Son nöqtə / əmr	İstifadə məqsədi
🧰 MCP (stdio)	`omniroute --mcp`	Claude Desktop, Cursor və istənilən MCP klientinə qoşulma
🌊 MCP (HTTP)	`/api/mcp/stream`	Uzaqdan MCP — 110 alət, 33 əhatə dairəsi (məcburi tətbiq seçim əsasında), tam audit jurnalı
📡 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 — söhbət, yerləşdirmələr, şəkillər, audio, OCR
🔔 Webhook-lar	`/api/webhooks`	Sorğu / kvota hadisələrini Slack, Discord, Telegram və ya istənilən URL-ə göndərmə
🛰️ Uzaqdan CLI	`omniroute connect`	Uzaq instansı əhatə dairəsi məhdud giriş tokenləri ilə idarə etmə

```bash # Claude Code-a MCP üzərindən tam OmniRoute alətlər dəstini verin: claude mcp add-server omniroute --type http --url http://localhost:20128/api/mcp/stream ``` _{📖 [MCP serveri](docs/frameworks/MCP-SERVER.md) · [A2A serveri](docs/frameworks/A2A-SERVER.md) · [Agent protokolları](docs/frameworks/AGENT_PROTOCOLS_GUIDE.md)}

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

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

OmniRoute sıxlaşdırma konveyeri: 10.000 tokenlik nümunəvi müştəri sorğusu 12 birləşdirilə 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ş ardıcıl nümunədə provayderə təxminən 1.080 tokenlə çata bilər. Strukturlaşdırılmış məzmun qoruma mexanizmləri və hər addım üzrə dəqiqlik yoxlamaları ilə müdafiə olunur; açıq şəkildə seçilən itkili və ya eksperimental rejimlər uyğun məzmunu dəyişdirə bilər.

Defolt ardıcıl kombinasiya `RTK → Caveman` istifadə edir. Hər ikisi eyni alət/kontekst yükünə tətbiq edildikdə qənaət mürəkkəb şəkildə artır: ```txt combined = 1 − (1 − RTK) × (1 − Caveman_input) average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2% range = 78.4 – 94.6% ``` Kod blokları, URL-lər, JSON və strukturlaşdırılmış verilənlər qoruma mühərriki tərəfindən **həmişə qorunur**. > **Az token kifayət edərkən niyə çox token istifadə edəsiniz?** Hər sorğu OmniRoute-un sıxlaşdırma konveyerindən **şəffaf şəkildə** keçir — müştəri tərəfində heç bir dəyişiklik tələb olunmur. Bu, artıq ardıcıllıqla işləyən və hər marşrutlaşdırma kombinasiyası üçün qarışdırılıb uyğunlaşdırıla bilən **12 birləşdirilə bilən mühərrikdən ibarət yığındır** — [RTK](https://github.com/rtk-ai/rtk), [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ 90K+), [LLMLingua-2](https://github.com/microsoft/LLMLingua) və [Troglodita](https://github.com/leninejunior/troglodita) (PT-BR) layihələrinin ideyaları əsasında qurulub. ### 🧱 12 mühərrikdən ibarət yığın Mühərriklər konveyer ardıcıllığı ilə işləyir; hər biri ayrıca aktivləşdirilə və hər kombinasiya üçün konfiqurasiya edilə bilər:

#	Mühərrik	Nə edir
1	Session-Dedup	Dialoqun gedişləri boyunca təkrarlanan məzmunu silir (məzmun üzrə ünvanlanan, gedişlərarası)
2	CCR	Böyük blokları tələb əsasında əldə edilən çağırış markerlərinin arxasında arxivləşdirir
3	Lite	Boşluqları və şəkil URL-lərini ixtisar edir (az gecikməli baza rejimi)
4	RTK	Alət nəticələrini ağıllı şəkildə filtrləyir, təkrarları silir və ixtisar edir (əmrləri nəzərə alır)
5	Responses Tool Output	Shell/patch/axtarış/qurma çıxışları üçün əvvəlcə itkisiz JSON + məhdud diaqnostik sıxlaşdırma (Responses API)
6	Headroom	Daxilə daxil edilmiş GCF kodeki vasitəsilə JSON massivlərinin itkisiz cədvəlvari yığcamlaşdırılması (~30%)
7	Relevance	Son istifadəçi sorğusuna əsasən cümlələrin çıxarış yönümlü qiymətləndirilməsi
8	Caveman	Qaydalara əsaslanan mətn sıxlaşdırması (çıxışda ~65–75%)
9	Aggressive	Köhnə gedişlərin xülasələşdirilməsi və mərhələli köhnəldilməsi
10	LLMLingua-2	MobileBERT ONNX vasitəsilə ML əsaslı semantik budama — kod üçün təhlükəsiz, asinxron
11	Ultra	İxtiyari kiçik model (SLM) səviyyəsi ilə evristik token budaması
12	OmniGlyph	Birbaşa Anthropic bağlantısında ölçülmüş Claude Fable 5 üçün eksperimental kontekst-şəkil kodlaşdırması; provayder təsdiqləri əldə edilənədək GPT 5.6 transformerləri təhlükəsizlik məqsədilə bağlı qalır. Dörd sıxlaşdırma profili (defolt aqressiv, balanslaşdırılmış, kodlaşdırma üçün təhlükəsiz, dəyişikliksiz ötürmə) (ən aqressiv; ayrıca aktivləşdirilir)

Kod blokları, URL-lər və strukturlaşdırılmış verilənlər bayt səviyyəsində **həmişə qorunur**. **Bir kliklə seçilən hazır konfiqurasiyalar** mühərrikləri birləşdirir:

Rejim	Qənaət	Ən uyğun istifadə sahəsi
🪶 Lite	~15%	Həmişə aktiv, təhlükəsiz defolt
🪨 Standard (Caveman)	~30%	Gündəlik kodlaşdırma
⚡ Aggressive	~50%	Alətlərdən çox istifadə edilən uzun sessiyalar
🔥 Ultra	~75%	Maksimum qənaət
🧰 RTK	60–90%	Shell/test/qurma/git çıxışları
🔗 Stacked (RTK → Caveman)	78–95%	Qarışıq sorğular + alət jurnalları

**Real nümunə — Standard rejimi:** > **Əvvəl (69 token):** _"React komponentinizin yenidən render edilməsinin səbəbi, çox güman ki, hər render dövründə yeni obyekt istinadı yaratmağınızdır. Prop kimi sətirdaxili obyekt ötürdükdə, React-in səthi müqayisəsi onu hər dəfə fərqli obyekt kimi görür və bu da yenidən render edilməni işə salır. Obyekti yadda saxlamaq üçün useMemo istifadə etməyi tövsiyə edərdim."_ > > **Sonra (19 token):** _"Hər renderdə yeni obyekt istinadı. Sətirdaxili obyekt prop-u = yeni istinad = yenidən render. useMemo ilə əhatə edin."_ > > **Eyni cavab. 72% daha az token. Dəqiqlik itkisi yoxdur.** ✅ **PT-BR nümunəsi — [Troglodita](https://github.com/leninejunior/troglodita) rejimi:** > **Əvvəl (42 token):** _"Problem ondadır ki, hər render dövründə yeni obyekt istinadı yaradıldığı üçün komponent yenidən render olunur. `useMemo` istifadə etməyi tövsiyə edərdim."_ > > **Sonra (12 token):** _"Yenidən render: hər dövrdə yeni istinad (inline obyekt yenidən yaradılır). `useMemo` istifadə edin."_ > > **Eyni cavab. ~70% daha az token. Texniki dəqiqlik qorunub.** ✅
### 🎚️ Mühərriklərdən əlavə — çıxış üslubları, adaptiv tənzimləyici və hər sorğu üzrə idarəetmə Yuxarıdakı 12 mühərrik daxil olanları kiçildir. Daha üç qat isə cavabın **necə**, **nə zaman** və hansı formada **çıxdığını** müəyyənləşdirir: - **🪄 Çıxış üslubları** _(çıxış oxu üzrə yönləndirmə)_ — deterministik, keş üçün təhlükəsiz cavab formalaşdırma təlimatları əlavə edir; üslublar birləşdirilə bilər və hər biri `lite` / `full` / `ultra` intensivliyində işləyir. Üslub əlavə etmək reyestrə bir sətirlik qeyd daxil etmək qədər sadədir: - **Yığcam mətn** — dolğu sözlərini / artiklları / qeyri-müəyyən ifadələri çıxarır; texniki məzmunu dəqiq saxlayır. - **Daha az kod** — "tənbəl təcrübəli proqramçı" YAGNI yanaşması: işləyən ən kiçik dəyişiklik, tələb olunmamış əlavə struktur yoxdur. - **Ponytail (tənbəl təcrübəli proqramçı)** — YAGNI pillələri ilə irəliləyir, əsas səbəbi aradan qaldırır, işləyən ən kiçik fərqi yaradır. - **Məndə ADHD var (əvvəlcə əməl)** — növbəti əməl öndədir, addımlar nömrələnir, bir konkret növbəti addım verilir, giriş yoxdur. - **Yığcam CJK (文言)** — klassik Çin dilində son dərəcə yığcam üslub (lokal üzrə yalnız `zh` üçün aktivdir). - **🎯 Adaptiv kontekst büdcəsi** _(tənzimləyici)_ — vahid aktiv/deaktiv token həddi əvəzinə modelin kontekst pəncərəsinə **sığmaq üçün** ən ucuz və ən az itkili mühərrikləri yalnız lazım olan səviyyəyədək işə salır. Siyasət: `reserve-output` (standart, modeli nəzərə alır) · `percentage` · `absolute`. Rejim: `floor` (sığmanı təmin edir) · `replace-autotrigger` (açıq seçiminiz üstün olur) · `off` (köhnə hədd). - **🎛️ Sıxışdırmanın müəyyən edildiyi yer** _(üstünlük sırası, yüksək → aşağı)_ — hər sorğu üzrə `x-omniroute-compression` başlığı › marşrutlaşdırma kombinasiyasının üstə yazması › aktiv adlandırılmış profil › adaptiv / avtomatik işəsalma › panelin standart ayarı › deaktiv. Tətbiq edilmiş plan cavabdakı `X-OmniRoute-Compression: ; source=` başlığında əks olunur. Token həddinə əsasən avtomatik işəsalmanı qurun, adaptiv tənzimləyicini aktivləşdirin, adlandırılmış profili sabitləyin, sorğu üçün birdəfəlik parametr təyin edin və ya hər marşrutlaşdırma kombinasiyasına emal zənciri təyin edin — iş yükünə uyğun olanı seçin. Könüllü oflayn **qiymətləndirmə aləti** (`npm run eval:compression`) dəyişikliyi istifadəyə verməzdən əvvəl sabitlənmiş korpus üzərində uyğunluğu və qənaəti qiymətləndirir. 📖 [`COMPRESSION_GUIDE.md`](docs/compression/COMPRESSION_GUIDE.md) · [`RTK_COMPRESSION.md`](docs/compression/RTK_COMPRESSION.md) · [`COMPRESSION_ENGINES.md`](docs/compression/COMPRESSION_ENGINES.md)

# ⚡ Sürətli başlanğıc

**1) Quraşdırın və işə salın** ```bash npm install -g omniroute omniroute ``` > 💡 `npm warn ERESOLVE` və ya peer-asılılıq xəbərdarlıqları görürsünüz? [Onlar zərərsizdir](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated). > **npm 11 və ya daha yeni versiyadan istifadə edirsiniz?** İcazə verilmədiyi halda npm paketlərin həyat dövrü skriptlərini bloklaya bilər. OmniRoute-un `postinstall` skripti (`node scripts/build/postinstall.mjs`) onun yerli icra mühiti fayllarını hazırlamaq üçün tələb olunur. Qlobal quraşdırma zamanı npm xəbərdarlığında göstərilən paketlərə icazə verin. OmniRoute 3.8.51 tərəfindən bildirilən paket dəsti üçün: > > ```bash > npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute > ``` > > Bu icazə siyahısını gələcək qlobal quraşdırmalarda yenidən istifadə etmək üçün onu bir dəfə konfiqurasiya edin, sonra adi qaydada quraşdırın: > > ```bash > npm config set allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild --location=user > npm install -g omniroute > ``` > > Asılılıqların siyahısı buraxılışlar arasında dəyişə bilər; npm fərqli siyahı göstərərsə, həmin xəbərdarlıqdakı paket adlarından istifadə edin. Paketə icazə vermək onun quraşdırma skriptlərinin icrasına imkan yaradır. > **Gemini Web və ya veb kukilərindən istifadə edən başqa provayder işlədirsiniz?** npm paketinə > Playwright daxildir, lakin onun Chromium binar faylı daxil deyil. İlk veb-provayder sorğusunu göndərməzdən əvvəl > [Playwright Chromium quraşdırması](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium) > qeydini oxuyun. İdarəetmə paneli: `http://localhost:20128` · API: `http://localhost:20128/v1`. **2) Öz hesabınızdan istifadə edərək uyğun provayderə qoşulun** İdarəetmə paneli → **Provayderlər** → cari şərtləri və kvotası istifadə ssenarinizə uyğun olan provayderi seçin → onun API açarını əlavə edin və ya hesab prosedurunu tamamlayın. Pulsuz səviyyələr qeydiyyat, təsdiq və ya ödəniş üsulu tələb edə bilər. [Pulsuz səviyyələr üzrə təlimat](docs/getting-started/FREE-TIERS-GUIDE.md) ilə tanış olun; açarsız əlçatanlığa zəmanət verilmir və `tos: avoid` ilə işarələnmiş provayderlər standart olaraq `auto` seçimindən çıxarılır. **3) Kodlaşdırma alətinizi yönləndirin** ```txt Baza URL-i: http://localhost:20128/v1 API açarı: [İdarəetmə paneli → Son nöqtələr bölməsindən kopyalayın] Model: auto (uyğun bağlantılar arasında marşrutlaşdırır — yaxud provayder/model seçin) ``` **4) İşlədiyini yoxlayın** ```bash curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY" ``` Qoşulmuş modellərinizin siyahısını görməlisiniz. 🎉 Budur — kodlaşdırmağa başlayın, OmniRoute sizin üçün avtomatik marşrutlaşdıracaq və ehtiyat varianta keçəcək. Klientiniz xüsusi başlıqlar göndərə bilmirsə, OmniRoute tokenləşdirilmiş uyğunluq ləqəblərini də təqdim edir: ```txt OpenAI kataloqu: http://localhost:20128/vscode/YOUR_KEY/ OpenAI modelləri: http://localhost:20128/vscode/YOUR_KEY/models OpenAI söhbəti: http://localhost:20128/vscode/YOUR_KEY/chat/completions OpenAI cavabları: http://localhost:20128/vscode/YOUR_KEY/responses Ollama söhbəti: http://localhost:20128/vscode/YOUR_KEY/api/chat Ollama teqləri: http://localhost:20128/vscode/YOUR_KEY/api/tags ``` Bunlardan yalnız `Authorization: Bearer ...` əlavə edə bilməyən klientlər üçün istifadə edin. Başlıqla autentifikasiya üstün tutulan üsul olaraq qalır.
## 📦 Daha çox quraşdırma üsulu — Docker, mənbə kodu, pnpm, Arch **🐳 Docker** ```bash docker run -d --name omniroute --restart unless-stopped --stop-timeout 40 \ -p 127.0.0.1:20128:20128 -v omniroute-data:/app/data diegosouzapw/omniroute:latest ``` `:latest` ən yüksək **dərc edilmiş** stabil SemVer versiyasını izləyir. O, git `main` budağını izləmir. GitOps üçün `:X.Y.Z` versiyasını sabitləyin. [Docker buraxılış kanalları](docs/guides/DOCKER_GUIDE.md#release-channels) bölməsinə baxın. İmic **`OMNIROUTE_MEMORY_MB=1024`** dəyərini sabitləyir. Bu, idarəetmə paneli və yüngül söhbət üçün kifayətdir. **Kodlaşdırma agentləri** (Claude Code, Codex, Grok və s.-dən `POST /v1/responses`) daha böyük V8 yığını tələb edir, əks halda üst-üstə düşən iki uzun kontekst zamanı proses təxminən 12 GiB səviyyəsində `FATAL ERROR` ilə dayanır. Konteyner ölçüsünü yığından böyük təyin edin (yerli buferlər V8-dən kənarda yerləşir): | İş yükü | Yığın (`-e OMNIROUTE_MEMORY_MB`) | Konteyner (`--memory`) | | -------------------------------- | -------------------------------- | ---------------------- | | İdarəetmə paneli / yüngül söhbət | `1024` (imicin standart dəyəri) | ≥2 g | | Bir kodlaşdırma agenti | `8192` | ≥10 g | | İki paralel uzun `/v1/responses` | `10240`–`12288` | ≥12–16 g | ```bash docker run -d --name omniroute --restart unless-stopped --stop-timeout 40 \ -e OMNIROUTE_MEMORY_MB=8192 --memory=10g \ -p 127.0.0.1:20128:20128 -v omniroute-data:/app/data diegosouzapw/omniroute:latest ``` Tam cədvəl: [Docker təlimatı — icra zamanı RAM](docs/guides/DOCKER_GUIDE.md#runtime-ram-for-coding-agents). > **İlkin buraxılış Docker kanalı:** `diegosouzapw/omniroute:next` və > `diegosouzapw/omniroute:next-web` cari standart `release/v*` > budağını izləyir. Bu dəyişən teqlər yalnız buraxılmamış düzəlişləri sınaqdan keçirmək üçün nəzərdə tutulub və > **istehsal mühitində dəstəklənmir**. Baxın: > [Docker buraxılış kanalları](docs/guides/DOCKER_GUIDE.md#release-channels). **🥟 Bun** Standart `bun install` və qlobal quraşdırma (`bun install -g omniroute`) Bun icra mühitinin aşkarlanması vasitəsilə dəstəklənir: - **Daxili `bun:sqlite`**: OmniRoute Bun altında işləyərkən onun daxili `bun:sqlite` drayverindən istifadə edir, Node.js mühitində isə `better-sqlite3` və ya `sql.js` variantına keçir. - **İnkişaf mühitində avtomatik Webpack paketləyicisi seçimi**: İnkişaf rejimi (`bun run dev`) Bun-u avtomatik aşkarlayır və yerli V8 bağlamalarının uyğunsuzluqlarının qarşısını almaq üçün Turbopack-i söndürərək Webpack-dən istifadə edir. İstehsal yığımları (`bun run build`) `OMNIROUTE_USE_TURBOPACK` dəyişəninə Node-da olduğu kimi dəqiq əməl edir: standart olaraq Turbopack, Webpack ilə yığmaq üçün isə `OMNIROUTE_USE_TURBOPACK=0` (`Dockerfile.bun` bunu `--build-arg` kimi təqdim edir). - **Xüsusi Bun Dockerfile faylı**: Yerli Bun istehsal yerləşdirmələri üçün çoxmərhələli `Dockerfile.bun` (`docker build -f Dockerfile.bun -t omniroute:bun .`). ```bash # Bun ilə quraşdırın və işə salın bun install bun run dev ``` **🛠️ Mənbə kodundan** ```bash cp .env.example .env && npm install PORT=20128 npm run dev ``` **📦 pnpm** ```bash pnpm add -g omniroute@latest --allow-build=better-sqlite3 --allow-build=@swc/core && omniroute ``` **🐧 Arch Linux (AUR)** ```bash yay -S omniroute-bin && systemctl --user enable --now omniroute.service ``` **🔧 Nix (Flake)** ```bash # Nix flakes istifadə etməklə nix develop npm run dev # Və ya devbox istifadə etməklə devbox run npm run dev ``` 📖 [Docker təlimatı](docs/guides/DOCKER_GUIDE.md) — Compose profilləri, Caddy HTTPS, Cloudflare tunelləri. **🦭 Podman** ```bash # 1. Bağlama ilə qoşulan məlumat qovluğunu hazırlayın mkdir -p data # 2. Yalnız Linux + yerli rootless Podman üçün (heç vaxt uzaq Podman Machine klientində deyil): podman unshare chown 1000:1000 ./data # 3. İcra mühiti göstərişini təyin edin, yerli Compose imicini yığın və başladın echo "CONTAINER_HOST=podman" >> .env podman compose --profile base up -d --build ``` macOS və ya Windows-da Podman uzaq Podman Machine istifadə edir: `podman unshare` addımını ötürün və [topologiyaya uyğun məlumat qovluğu təlimatlarına](contrib/podman/README.md#data-directory-permissions-by-topology) əməl edin. 📖 [Podman təlimatı](contrib/podman/README.md) — Compose yığımları, Podman Machine və Linux/systemd Quadlet quraşdırması. **⚡ Daha sürətli / daha yüngül quraşdırma (yerli yığımı ötürün)** Yerli SQLite mühərriki (`better-sqlite3`) **ixtiyari** asılılıqdır, buna görə də qlobal quraşdırma heç vaxt mənbə kodundan kompilyasiyanı gözləyərək bloklanmır: platformanıza/Node-a uyğun olduqda əvvəlcədən yığılmış binar fayldan istifadə edir, əks halda şəffaf şəkildə saf JS mühərrikinə (Node 22+ mühitində `node:sqlite`, əks halda paketə daxil edilmiş `sql.js` WASM) keçir — yığım alətləri tələb olunmur. Quraşdırmadan sonrakı yerli ilkin hazırlığı tamamilə ötürmək üçün (CI, başsız və ya yavaş maşınlar): ```bash OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute # CI=1 də bunu ötürür ``` Ən sürətli quraşdırma üçün **pnpm**-ə üstünlük verin (məzmun ünvanlı saxlanc + sərt keçidlər — yuxarıya baxın). İdarəetmə panelsiz, başsız icra mühiti üçün Docker `base` profilindən (yuxarıda) və ya [Termux təlimatından](docs/guides/TERMUX_GUIDE.md) istifadə edin. CLI və veb idarəetmə paneli eyni proses tərəfindən bir portda təqdim olunur, buna görə hazırda ayrıca yalnız CLI üçün paket yoxdur.

# 🎬 OmniRoute Fəaliyyətdə

## 📹 Video Təlimatları

_{2026-08-24 tarixində panelin görüntüsü · Xam kataloq: YT 809 | TT 137 | IG 124 · Yenilik (gün): YT 1 | TT 21 | IG 22}

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

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

🎬 #3 — TikTok
_{milesreevesai — 620,400 baxış}

🎬 #4 — YouTube
_{Vaibhav Sisinty — 391,109 baxış}

Instagram Reels videosu — buildwithai.club

🎬 #5 — Instagram
_{buildwithai.club — 347,652 baxış}

**Tam sıralama (təkrarlardan təmizlənmiş kanonik URL-lər, `v > 0`, ən geniş əhatə):** | #1 | #2 | #3 | #4 | #5 | | -------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | | [nick_saraev — Instagram](https://www.instagram.com/reel/Da8ZthUPK98/) — **3,042,474** | [theopenstack — Instagram](https://www.instagram.com/reel/DaSs65mMrHk/) — **692,419** | [milesreevesai — TikTok](https://www.tiktok.com/@milesreevesai/video/7667980059189366019) — **620,400** | [Vaibhav Sisinty — YouTube](https://www.youtube.com/watch?v=QucgvbO5gsM) — **391,109** | [buildwithai.club — Instagram](https://www.instagram.com/reel/DbIt9AjK7-U/) — **347,652** | | #6 | #7 | #8 | #9 | #10 | | ----------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | | [nivedan.ai — Instagram](https://www.instagram.com/reel/DbIrCksJiqq/) — **331,973** | [vaibhavsisinty — Instagram](https://www.instagram.com/reel/Dae05TSAK1l/) — **263,744** | [Nick Automates — YouTube Shorts](https://www.youtube.com/shorts/fZIBK_4fKq8) — **218,174** | [theroshankrishna — Instagram](https://www.instagram.com/reel/Dapjs58z0P0/) — **186,786** | [midudev — TikTok](https://www.tiktok.com/@midudev/video/7664636453544152342) — **177,800** | 2026-08-24 tarixində kanonik göstəricilər: **1.029 unikal video** · **11.132.922 məlum baxış** (`v > 0`) · **şəbəkələr üzrə 639 kanal/profil**. Xam paneldə 1.070 sətir var; Instagram-dakı 41 dublikat kanonik URL əsasında normallaşdırılıb və hər video üçün ən yüksək baxış sayı saxlanılıb. > 🎬 **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 təqdim edəcəyik.

# 📧 İcma və Yardım > Hər şey bir yerdə — layihə müşayiətçisini izləyin, icma ilə söhbət edin və ya məsələ açın. | Kanal | Harada / necə | | -------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- | | 💼 **LinkedIn** — texniki xidmə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 Sponsors](https://github.com/sponsors/diegosouzapw) |

---

## 🛠️ Texnologiya Steki

Səviyyə	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/` boyunca 100% TypeScript (v2.0-dan bəri nüvədə sıfır `any`)
Çərçivə	Next.js 16 + React 19 + Tailwind CSS 4
Verilənlər bazası	better-sqlite3 (SQLite, WAL jurnallaşdırması) + LowDB (köhnə JSON sistemi) — 137 domen modulu, 202 miqrasiya
Yaddaş	SQLite FTS5 tam mətn axtarışı + int8-kvantlaşdırılmış vektor yerləşdirmələri, tipləşdirilmiş zəifləmə
Sxemlər	Zod 4 — MCP alətlərinin giriş/çıxış 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ış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əli autentifikasiya · saxlanma zamanı AES-256-GCM · DOMPurify
Gizlilik	wreq-js — JA3 / JA4 TLS barmaq izi təqlidi, 3 səviyyəli proksi
Dayanıqlılıq	Dövrə qırıcı, eksponensial gecikmə, kütləvi paralel sorğuların qarşısının alınması, avtomatik kombinasiyalı özünübərpa
Jurnallaşdırma	pino — sorğu konteksti ilə strukturlaşdırılmış JSON jurnalları
Testləşdirmə	Node.js test icraçısı + Vitest — izlənilən 5,100-dən çox test faylında 39,000-dən çox statik test elanı (modul, inteqrasiya, E2E, təhlükəsizlik, ekosistem)
Platformalar	Masaüstü (Electron) · Android (Termux) · PWA (istənilən brauzer)
CI/CD	GitHub Actions — buraxılış zamanı npm-də avtomatik dərc + Docker Hub
Keçidlər	Veb-sayt · npm · Docker Hub

## 📖 Sənədləşdirmə

### 📘 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ətlərinin konfiqurasiyaları, protokol quraşdırması, vaxt aşımı tənzimləməsi
CLI alətləri təlimatı	Claude Code, Codex, Cursor, Cline, OpenClaw, Kilo və Copilot üçün ayrıca quraşdırma
Uzaq rejim	Məhdud əhatəli giriş tokenləri vasitəsilə noutbukunuzdakı CLI-dan uzaq OmniRoute-u (VPS) idarə edin
Claude Code konfiqurasiyası	`launch` və hər model üçün profillərlə Claude Code-u OmniRoute-a (lokal/uzaq) yönləndirin
Sürətli başlanğıc	3 addımda quraşdırma → qoşulma → konfiqurasiya

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

Sənəd	Təsvir
Docker təlimatı	Docker işə salınması, Compose profilləri, Caddy HTTPS, tunellər, təsvir teqləri
Podman təlimatı	Quadlet systemd inteqrasiyası, podman-compose, SELinux
VM yerləşdirilməsi	Tam təlimat: VM + nginx + Cloudflare quraşdırması
Fly.io-da yerləşdirmə	Davamlı yaddaşla Fly.io-da yerləşdirin
Termux təlimatı	OmniRoute-u Termux vasitəsilə Android-də işə salın
PWA təlimatı	Proqressiv veb tətbiqin quraşdırılması, keşləmə, arxitektura
Silmə təlimatı	Bütün quraşdırma üsulları üçün təmiz silmə
Mühit konfiqurasiyası	Tam `.env` dəyişənləri və istinadlar

### 🧠 Funksiyalar 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: söndürülmüş / yüngül / standart / aqressiv / ultra / RTK / yığılmış
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, yığılmış konveyerlər, idarə paneli/API/MCP interfeyslə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	Dilin aşkarlanması və Caveman qayda paketinin yaradılması
Dayanıqlılıq təlimatı	Dövrə kəsiciləri, soyuma müddətləri, növbə, kütləvi eyni vaxtlı 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
Proksi təlimatı	3 səviyyəli proksi sistemi, 1proxy bazarı, reyestr CRUD əməliyyatları
Pulsuz səviyyələr	Birləşdirilmiş kataloq: sənədləşdirilmiş 35 təkrarlanan hovuz / kataloqlaşdırılmış 489 pulsuz səviyyə qeydi
Funksiyalar qalereyası	Ekran görüntüləri ilə idarə panelinə vizual baxış
Kod bazasının sənədləşdirilməsi	Yeni başlayanlar üçün anlaşılan kod bazası icmalı

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

Sənəd	Təsvir
API istinadı	Nümunələrlə 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 klientləri
MCP serveri təlimatı	MCP quraşdırılması, nəqliyyat mexanizmləri və alətlər üzrə istinad
A2A serveri	JSON-RPC 2.0 protokolu, bacarıqlar, axın ötürməsi, tapşırıqların idarə edilməsi
A2A serveri təlimatı	A2A agent kartı, tapşırıqlar, bacarıqlar və axın ötürməsi

### 📋 Layihə və keyfiyyət

Sənəd	Təsvir
Töhfə vermə	İnkişaf mühitinin qurulması və qaydalar
Budaqlanma və buraxılış modeli	PR-lərin hansı budağa yönəldildiyi (`release/*`), `main` və teqlərin nə ifadə etdiyi
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 təcrübələri
i18n təlimatı	42 dil dəstəyi, tərcümə iş axını, RTL
Buraxılış yoxlama siyahısı	Buraxılışdan əvvəl doğrulama addımları
Əhatə planı	5,100-dən çox izlənilən test faylındakı 39,000-dən çox statik test elanı üçün test əhatəsi strategiyası

# ⭐ Ən fəal töhfəçilər > OmniRoute həvəsli açıq mənbə icması tərəfindən formalaşdırılır. Bu şəxslər layihənin keyfiyyətinə, sabitliyinə və əhatə dairəsinə birbaşa təsir edən müstəsna töhfələr veriblər. **Təşəkkür edirik.** ### Birləşdirilmiş pull request-lərin sayına görə xarici töhfəçilər

Sıra	Töhfəçi	Birləşdirilmiş PR-lər	~Dəyişdirilmiş sətirlər
1	backryun	190	227,977
2	oyi77	180	407,678
3	rdself	145	80,663
4	JxnLexn	128	387,049
5	KooshaPari	101	125,747
6	herjarsa	88	230,872
7	RaviTharuma	79	55,106
8	maxmad64bis	69	394,715
9	artickc	59	33,260
10	HouMinXi	51	47,334
10	chirag127	51	5,153
12	xz-dev	50	245,976
13	hartmark	47	52,185
14	rqzbeh	39	143,181
15	dhaern	34	19,559
16	Dingding-leo	33	1,986
17	NomenAK	32	13,854
18	MumuTW	30	16,953
19	benzntech	29	11,641
20	pacocartones	24	9,331
20	Prudhvivuda	24	6,312

_{2026-08-24 05:26:03 UTC tarixinədək birləşdirmələri əhatə etməklə, aktiv release/v3.8.50 budağının son dafb4ae808 kommiti üzrə sabitlənib. Səhifələnmiş GitHub GraphQL siyahısında 5,911 birləşdirilmiş PR var: 2,707-si repozitoriya sahibindən, 179-u Dependabot-dan və 535 fərqli töhfəçidən 3,025 xarici PR. “Dəyişdirilmiş sətirlər” GitHub əlavələri ilə silinmələrinin cəmidir və yaradılmış faylları, kilid fayllarını, kataloqları, tərcümələri və sənədləri əhatə edir; bu, dəyişiklik həcmini göstərir, müəllif tərəfindən yazılmış LOC deyil. Son həddə bərabər nəticələr saxlanılıb.} ### GitHub-a aid edilən kommitlər

backryun _{🥇 GitHub-a aid 220 commit}	Paijo _{🥈 GitHub-a aid 219 commit}	Randi _{🥉 GitHub-a aid 108 commit}	Ravi Tharuma _{🏅 GitHub-a aid 81 commit}	Chris _{🏅 GitHub-a aid 70 commit}	Markus Hartung _{🏅 GitHub-a aid 69 commit · 6-cı yer bölüşdürülür}
Dizzle _{🏅 GitHub-a aid 69 commit · 6-cı yer bölüşdürülür}	Jan Leon _{🏅 GitHub-a aid 64 commit}	zenobit _{🏅 GitHub-a aid 62 commit}	Bob.Hou _{🏅 GitHub-a aid 51 commit · 10-cu yer bölüşdürülür}	Xiangzhe _{🏅 GitHub-a aid 51 commit · 10-cu yer bölüşdürülür}

_{2026-08-24 06:14:31 UTC tarixində yenidən yoxlanılıb: repozitoriyanın Contributors API-si tərəfindən standart release/v3.8.50 budağı üçün bildirilən GitHub-a aid commitlər. API 525 identiklik qaytardı (415 istifadəçi, 2 bot, 108 anonim); bu cədvəl texniki xidmətçini, botları və anonim identiklikləri istisna edir və bərabər nəticələri saxlayır. Bu, həm yuxarıdakı birləşdirilmiş PR sıralamasından, həm də aşağıdakı 639 nəfərlik Git metadata siyahıyaalmasından fərqlidir.} > 🙏 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 amillərin **əsas hissəsidir**. Hər bir pull request, hər bir test nümunəsi və hər bir i18n tərcümə faylı vacibdir. Açıq mənbə onların kimi insanlar tərəfindən qurulur.

---
## 💖 Sponsorlar

OmniRoute-u öz vəsaitləri hesabına maliyyələşdirən insanlara ürəkdən təşəkkür edirik — hər bir töhfə layihənin pulsuz, müstəqil və davamlı inkişaf etməsinə kömək edir.

Andrew
_{💛 Aktiv aylıq sponsor}

Vlad I
_{💛 Aktiv aylıq sponsor}

Paco Cartones
_{💛 Aktiv birdəfəlik sponsor}

Prof. Igor Morais
_{💛 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-08-24 tarixində yenidən yoxlanılıb. GitHub-un activeOnly statusu yuxarıdakı aktiv etiketləri müəyyən edir; əvvəllər açıqlanmış ictimai birdəfəlik dəstəkçilərə təşəkkür edilməyə davam olunur, məxfi sponsorlar isə anonim qalır.} 💖 Sponsor olun → — hər bir dollar OmniRoute-un pulsuz və müstəqil qalmasına kömək edir.

## 👥 600-dən çox töhfəçi

[![Töhfəçilər](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=639&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors) _{2026-08-24 tarixində dondurulmuş ac02c5b42f bazasında audit aparılıb və canlı release/v3.8.50 budağının dafb4ae808 ucunda yenidən yoxlanılıb: 639 normallaşdırılmış insan Git identifikatoru — 407-si kommit müəllifi (texniki xidmətçi daxil olmaqla), 232-si isə yalnız açıq şəkildə göstərilmiş Co-authored-by treylerlərində yer alır. Siyahıyaalma GitHub noreply istifadəçi adlarını normallaşdırır, 26 bot/agent/xidmət/yer tutucu identifikatorunu istisna edir və adi e-poçt ünvanlarını yalnız göstərilən adları uyğun gəldiyinə görə birləşdirmir.} ### Necə töhfə verməli 1. Repozitoriyanın fork-unu yaradın 2. **Aktiv** `release/vX.Y.Z` ucundan (`main` budağından deyil) yeni budaq yaradın — [Budaqlanma və buraxılış modelinə](docs/ops/BRANCHING_MODEL.md) baxın 3. Funksional imkan budağınızı yaradın (`git checkout -b feat/amazing-feature`) 4. Dəyişikliklərinizi kommit edin (`git commit -m 'feat: add amazing feature'`) 5. Budağa göndərin (`git push origin feat/amazing-feature`) 6. **base = həmin `release/vX.Y.Z` budağı** olmaqla Pull Request açın Ətraflı təlimatlar üçün [CONTRIBUTING.md](CONTRIBUTING.md) sənədinə baxın. ### Yeni versiyanın buraxılması ```bash # Buraxılış yaradın — npm publish avtomatik olaraq baş verir VERSION=x.y.z gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes ```

## 📊 Ulduzlar

## 🌍 StarMapper

## 🙏 Təşəkkürlər

OmniRoute nəhənglərin çiyinləri üzərində dayanır. O, **[9router](https://github.com/decolua/9router)** layihəsinin bir fork-u və Go layihəsi olan **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)**-nin TypeScript portu kimi başladı — bundan sonra isə aşağıdakı hər bir alt sistem bu sahədə ilk addımı atmış açıq mənbəli layihədən ilhamlandı. Onların hər biri OmniRoute-un konkret bir hissəsini formalaşdırdı. Bu, onların hamısına təşəkkürümüzdür. 🙏 > ⭐ ulduz sayları 24 avqust 2026-cı ildə GitHub-ın REST API-si vasitəsilə yoxlanılıb — gedin, bu layihələrə ulduz verin. Saylar müəyyən tarixə aid dəqiq ani görüntüdür və təbii olaraq dəyişəcək. ### 🧬 Mənşə və şlüz

Layihə	⭐	OmniRoute üçün necə ilham mənbəyi olub
9router	26,161	Bu fork-un əsaslandığı ilkin layihədir — burada multimodal API-lər əlavə edilərək genişləndirilib və tamamilə TypeScript ilə yenidən yazılıb.
CLIProxyAPI	48,497	Bu JavaScript / TypeScript portuna ilham verən Go tətbiqidir.
LiteLLM	57,100	Açıq qiymət məlumat dəsti xərclərin izlənməsi üzrə sinxronizasiyamızı təmin edən və provayderlərin normallaşdırılması modeli marşrutlaşdırmamıza istiqamət verən süni intellekt şlüzüdür.
codex-chatgpt-web	1,410	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	48,112	Axın bərpasına, düşünmə olmadan işləyən aliaslara, ehtiyat veb axtarışına, sürüşən pəncərə məhdudiyyətlərinə, jurnal məlumatlarının maskalanmasına və gücləndirilmiş işəsalma axınlarına köçürülmüş nümunələrdir.
composer-api	322	Doğma Cursor icraçısına 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	457	Codex OAuth vasitəsilə təkrar autentifikasiyaya köçürülmüş yeni giriş və yeniləmə tokenlərinin rotasiyası nümunələridir.
opencode-anthropic-auth	510	Claude Code ilə uyğun çevirmə standartları və hesablaşma başlığı davranışı OmniRoute-un konfiqurasiya ilə idarə olunan körpüsündə ümumiləşdirilib.
grok2api-merged	2	Onun Grok model uyğunluqları, saxta TypeError yaradan Statsig generatoru, sorğu və cihaz standartları, eləcə də NDJSON cavab prosessoru əhəmiyyətli dərəcədə OmniRoute-un Grok Web icraçısına uyğunlaşdırılıb.
TQZHR/grok2api	705	grok2api-merged-in əsas dolayı kod mənbəyidir; onun model, başlıq, faydalı yük, Statsig və prosessor tətbiqləri Grok Web xəttində qorunub saxlanılıb.
chenyme/grok2api	7,520	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 dolayı mənbədir; OmniRoute bu mənşə bildirişini qoruyur, lakin məhdud Grok Web icraçısında proksi hovuzu portunun mövcudluğunu iddia etmir.
GrokProxy	50	Onun kuki vasitəsilə autentifikasiya olunan Grok proksisi və `result.response.token` axın nümunəsi OmniRoute-un Grok Web nəqliyyat qatına istiqamət verib.
GrokBridge	5	İlkin Grok Web tətbiqində onun HTTP/brauzer əsaslı yuxarı axın dizaynına istinad edilib; birbaşa HTTP yolu GrokProxy-dən törədiyi üçün müstəqil kod portunun mövcudluğu iddia edilmir.
grok-web-api	14	Onun Rust `ChatOptions` və cavab zərfi sxemləri OmniRoute-un TypeScript Grok sorğu və axın cavabı tiplərinə istiqamət verib.

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

Layihə	⭐	OmniRoute-a necə ilham verdi
Caveman	100,538	Viral olan «az token iş görürsə, niyə çox token istifadə edək» layihəsi — onun mağara adamı üslubundakı fəlsəfəsi standart sıxışdırma rejimimizi və 30-dan çox doldurucu ifadələrin silinməsi/yığcamlaşdırma qaydasını təmin edir.
RTK – Rust Token Killer	77,185	Yüksək performanslı əmr çıxışı sıxışdırması — RTK mühərrikimizə, JSON filtr DSL-inə, xam çıxışın bərpasına və ardıcıl RTK → Caveman emal xəttinə ilham verdi.
headroom	67,310	Geri çevrilə bilən kontekst sıxışdırması (SmartCrusher) — `headroom` mühərrikimizə və `ccr` əldəetmə marker nümunəsinə ilham verdi.
LLMLingua	6,598	Prompt sıxışdırması araşdırması (LLMLingua / LLMLingua-2) — asinxron, kod üçün təhlükəsiz və xəta zamanı ilkin nəticəni qaytaran `llmlingua` mühərrikimizə ilham verdi.
llmlingua-2-js	31	LLMLingua mühərrikimiz üçün işçi axın arxa ucu kimi istifadə edilən JS/ONNX portu (MobileBERT / XLM-RoBERTa).
Troglodita	40	PT-BR token sıxışdırması — pt-BR dil paketimizi təmin edir: Braziliya portuqalcasının qrammatikasına uyğunlaşdırılmış pleonazm azaldılması və doldurucu ifadələrin silinməsi.
ponytail	108,957	Viral olan «tənbəl böyük proqramçı» YAGNI kodlayıcı bacarığı — daha-az-kod Çıxış Üslubumuza ilham verdi: _yaradılan_ kodu azaldan, işlək olan ən kiçik dəyişikliyə yönləndirmə (Caveman-in yığcam nəsrinin çıxış oxundakı qarşılığı).
i-have-adhd	23,526	Onun ilk növbədə fəaliyyətə yönəlmiş, ADHD-yə uyğun cavab üslubu OmniRoute-un beş dildə yığcam çıxış üslubuna uyğunlaşdırıldı.

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

Layihə	⭐	OmniRoute-a necə ilham verdi
TOON	25,233	Token-Yönümlü Obyekt Notasiyası — onun sütunlu, başlıq və sətirlərdən ibarət modeli cədvəlvari yığcamlaşdırma mərhələmizi formalaşdırdı.
GCF – Graph Compact Format	41	Onun yığcam qraf formatı və ümumi profil dizaynı OmniRoute-un cədvəlvari yığcamlaşdırmasına və Headroom kodek formatına istiqamət verdi.
gcf-typescript	4	Headroom ümumi profil kodeki kimi birbaşa layihəyə daxil edilən və genişləndirilən MIT TypeScript tətbiqi.
token-optimizer-mcp	494	Brotli/SQLite keşi + hər sessiya üzrə kontekst fərqi — `session-dedup` mühərrikimizə ilham verdi.
token-savior	1,122	Bash çıxışının yığcamlaşdırılması + MCP profilləri — sıxışdırmadan vaxtında imtina yanaşmamıza və MCP alət manifestinin azaldılmasına ilham verdi.
token-saver	138	Məzmunu nəzərə alan, hər fayl növü üzrə və xətaları nəzərə alaraq imtina edən çıxış sıxışdırması — növə görə yönləndirməmizi və minimal qazanc olmadıqda ötürmə yanaşmamızı təsdiqlədi.
token-optimizer	1,951	«Kabus tokenləri tap» — onun xaricə ötürmə + bərpa edilə bilən identifikator nümunəsi CCR xaricə ötürmə yanaşmamıza istiqamət verdi.
TokenMizer	28	Session-dedup dizaynımıza istiqamət verən sessiya qrafı + mesajlararası sətir təkrarsızlaşdırma planı.
OmniCompress	3	Rust sütunlu JSON + məzmunla ünvanlanan əldəetmə + mesajlararası təkrarsızlaşdırma — `headroom`/`ccr`/`session-dedup` mühərrik dizaynımızı və keşin sabitliyini təmin edən «sıxışdırılmış forma mövqedən asılı deyil» invariantını təsdiqlədi.
mcp-compressor	113	MCP alət sxeminin/təsvirinin sıxışdırılması — MCP alət manifestinin element sayının azaldılmasına istiqamət verdi.
RepoMapper	197	Aider üslublu repozitoriya xəritəsi sıralaması — repozitoriya xəritəsi / əldəetmə 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ışı yığcamlaşdırmamızı təsdiqlədi.
ts-morph	6,162	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 üçün necə ilham mənbəyi olub
Mem0	63,902	Universal yaddaş qatı — onun yazma/oxuma sərhədi kimi proksi modeli yaddaş arxitekturamızı formalaşdırdı.
Letta (MemGPT)	24,382	Səviyyəli yaddaşa malik vəziyyətli agentlər — Context Control & Recovery (CCR) üçün səviyyəli modelimizə ilham verdi.
WFGY	1,781	16 təkrarlanan RAG/LLM nasazlıq rejimini əhatə edən ProblemMap taksonomiyası — nasazlıqların aradan qaldırılması üzrə bələdçimizdə istifadə olunan ortaq terminologiya.

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

Layihə	⭐	OmniRoute üçün necə ilham mənbəyi olub
llm-interceptor	66	Kodlaşdırma köməkçisi ↔ LLM trafikinin MITM vasitəsilə ələ keçirilməsi/təhlili ilkin Traffic Inspector tələblərini formalaşdırdı. Əvvəllər törəmə olan dörd modul — SSE birləşdirməsi, söhbətin normallaşdırılması, məxfi məlumatların maskalanması və başlıqların təmizlənməsi — açıq protokol standartlarına əsaslanan müstəqil, sıfırdan hazırlanmış tətbiqlərlə əvəz edilib. Host trafikinin birbaşa ötürülməsi üçün iki səth (`passthrough.ts` və `_internal/bypass.cjs`) müstəqil şəkildə təsnif edilmiş OmniRoute-daxili tətbiqlər olaraq qalır; onlar həmin əvəzləmə çərçivəsində yenidən yazılmayıb.
ProxyBridge	5,995	Hər proses üzrə şəffaf proksi marşrutlaşdırması — qəza zamanı təhlükəsiz MITM söndürülməsinə, soketlərin boşdayanma taymautlarına, `/proc` proses aidiyyətinin müəyyənləşdirilməsinə və TPROXY vasitəsilə trafikin tutulmasına ilham verdi.

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

Layihə	⭐	OmniRoute üçün necə ilham mənbəyi olub
models.dev	6,555	AI model spesifikasiyaları, qiymətləri və imkanlarının açıq verilənlər bazası — model kataloqumuza yerli şəkildə sinxronlaşdırılır.
React Flow / xyflow	38,108	Real vaxt rejimində işləyən Compression Studio və Combo/Routing Studio-nu təmin edən düyün əsaslı qraf kitabxanası.
LangGraph	40,314	LangGraph Studio-nun canlı iş axını qrafı vizuallaşdırması Studio-larımızın real vaxt rejimindəki kaskad görünüşünə ilham verdi.
Langfuse	33,592	Onun trassa → span → generasiya müşahidə modeli Compression Studio-dakı şəlalə görünüşümüzü formalaşdırdı.
Kiali	3,631	Istio xidmət şəbəkəsinin müşahidə oluna bilməsi — Routing/Combo Studio-dakı dövrəqıran nişanlarımıza və xəta kənarı vizuallarımıza ilham verdi.
lobe-icons	2,428	İdarəetmə panelimizin hər yerində provayder ikonlarını göstərən AI/LLM brend loqoları.
flag-icons	12,354	README dil seçicisində istifadə olunan MIT lisenziyalı SVG bayraqlarını təmin edir.

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

Layihə	⭐	OmniRoute üçün necə ilham mənbəyi olub
awesome-secure-defaults	721	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 üçün necə ilham mənbəyi olub
ClawRouter	6,564	Sorğuların dublikatlarının aradan qaldırılmasına, fövqəladə sıfır xərcli ehtiyat keçidinə, qoşula bilən Auto-Combo strategiyalarına və çoxdilli niyyət təsnifatına ilham verdi.
Antigravity-Manager	30,652	Onun hesabı nəzərə alan model xəritələndirməsi, icra edilə bilən fayl yolunun doğrulanması və plan etiketi davranışı OmniRoute-un Antigravity icra mühitini formalaşdırdı.
vscode-antigravity-cockpit	4,817	Onun kompakt kvota sıfırlanması gerisayım formatı OmniRoute-dakı müvafiq provayder limiti göstəricisinə ilham verdi.
AionUi	32,230	Onun ACP inteqrasiyaları OmniRoute-un quraşdırılmış CLI agentlərini avtomatik aşkarlamasına ilham verdi.
CodexBar	20,507	Grok Build kvota səthini müəyyənləşdirdi; daha sonra OmniRoute canlı ötürmə formatını müstəqil şəkildə yoxlayıb düzəltdi.

## 📄 Lisenziya MIT Lisenziyası — ətraflı məlumat üçün [LICENSE](LICENSE) faylına baxın. ---

**[⬆ Yuxarı qayıt](#-omniroute)** · Açıq mənbəli süni intellekt icması üçün ❤️ ilə hazırlanıb. _{OmniRoute v3.8.52 · Node ≥22.22.2 · MIT Lisenziyası · omniroute.online}