# 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ü (AI Gateway)

OmniRoute — Heç vaxt kodlaşdırmağı dayandırmayın. Hər bir süni intellekt aləti → 358 təminatçı — 150+ pulsuz — bir nöqtə vasitəsilə. Claude Code, Codex, Cursor, Cline, Copilot və Antigravity avtomatik ehtiyat keçid (auto-fallback) ilə PULSUZ Claude / GPT / Gemini-yə qoşulur. RTK + Caveman yığılmış sıxılması 15–95% tokenə qənaət edir (təxminən 89% orta) — heç vaxt limitlərə düşməyin. 358 Süni İntellekt Təminatçısı · 150+ pulsuz səviyyə · Ayda təxminən 1.62B pulsuz token · 19 yönləndirmə strategiyası · Başlamaq üçün $0.

## 💰 Ayda ~1.62B Pulsuz Token

> Pulsuz səviyyələ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 təsəvvür yoxdur. OmniRoute **35 təkrarlanan hovuz açarı üzrə 489 pulsuz səviyyə qeydini** kataloqlaşdırır və token göstəricisini **dərc edilmiş müsbət aylıq büdcəsi olan 17 hovuz, üstəgəl model üzrə beş Groq limiti** əsasında hesablayır; ortaq hovuzlar təkrarlanmır. Yalnız regional şəxsiyyət yoxlamasından sonra açılan kvotalar (hazırda: ModelScope) ayrıca göstərilir — regional şəxsiyyət təsdiqinin arxasında +~6M — və heç vaxt əsas göstəriciyə əlavə edilmir. Nəticə idarəetmə panelində (`/dashboard/free-tiers`) görünən olaraq qalır.

OmniRoute pulsuz səviyyə büdcəsi kartı: ayda sabit ~1.62B pulsuz token, qeydiyyat kreditləri ilə ilk ayda ~2.22B-dək; bir son nöqtənin arxasında kataloqlaşdırılmış 489 pulsuz səviyyə qeydini əhatə edən 35 sənədləşdirilmiş təkrarlanan hovuz açarından. Dürüst, hovuz üzrə təkrarsız hesablamalar — hər ortaq hovuz yalnız bir dəfə hesablanır; buraya dərc edilmiş müsbət aylıq token büdcəsi olan 17 təkrarlanan hovuz, üstəgəl model üzrə beş Groq limiti daxildir; şərtlərlə bağlı risk kataloqunda 13 provayderdən çəkinmək tövsiyə olunur, qərarı siz verirsiniz. 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, əsas göstəricini heç vaxt şişirtməsinlər. /dashboard/free-tiers səhifəsində canlı istifadə olunan/qalan miqdar.

> 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ı kataloqla müqayisə edilərək yenidən yoxlanılır və **hər iki istiqamətdə dəyişir** — provayder pulsuz səviyyəni dayandırdıqda rəqəm azalır; yenisi əlavə edildikdə isə artır. Biz yuvarlaqlaşdırılmış ən yaxşı ssenarini 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ə, repoya ulduz verin.

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

[![Ulduz Tarixçəsi Sıralaması](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) [![Vebsayt](https://img.shields.io/badge/Website-omniroute.online-blue?logo=google-chrome&logoColor=white)](https://omniroute.online) **Suallar, provayder məsləhətləri, yol xəritəsi və dəstək → [Discord](https://discord.gg/U47eFqAXCn) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 Qlobal](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) / [🇧🇷 Braziliya](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) / [Portal](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK)**
## 📈 Şlüz Böyüməyə Davam Edir

| | v3.8.49 | **v3.8.50** | `v3.8.51+` | | ---------------------------- | :-----: | :---------------------------: | :------------------: | | 🌐 Provayderlər | 290 | **357** | daha çoxu növbədədir | | 🧠 Unikal çat modeli ID-ləri | 1185 | **1312** | — | | 🖼️ Modallıq Körpüsü | — | 🆕 görüntü + audio + video | — | | 📡 Radar pulsuz kataloqu | — | 🆕 istəyə bağlı aktivləşdirmə | — | | ⚖️ Kvota əsaslı planlaşdırma | — | 🆕 Quota-Share | — | | 📊 Kvota telemetriyası | — | 🆕 canlı | — | **→ [`v3.9.0 LTS` versiyasına aparan yolda — Yol xəritəsi](ROADMAP.md)**

## 🧩 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şlanğıc	🚀 Sürətli başlanğıc	📦 Quraşdırma	🆓 Konfiqurasiyasız
💡 Ö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

🌐 66 dildə

## 🆓 Quraşdırdığınız saniyədə işləyir — açarsız, konfiqurasiyasız

```bash # Fresh install, zero credentials — `auto` already works: curl http://localhost:20128/v1/chat/completions \ -H "Content-Type: application/json" \ -d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}' ``` _{Müəyyən pulsuz backendə üstünlük verirsiniz? Birbaşa `oc/…` (OpenCode Free) çağırın. Sonra `auto`-ya keçin və OmniRoute-un seçməsinə icazə verin.} _{📦 **Python, Node.js, PHP və cURL** üçün sürətli start skriptlərini kopyalayıb-yapışdırın → [`examples/quickstart/`](examples/quickstart/)}

# 💥 Vəd

The Promise — One endpoint and 358 providers. Automatic fallback keeps routing while another healthy target is available. Six pillars: resilient fallback across 358 providers · up to 95% token savings on eligible workloads · $0 to start with 150+ free tiers and 54 recurring/keyless free-forever providers · 36 CLI/agent integrations through one config · OpenAI, Claude, Gemini and Responses API compatibility at /v1 · production controls including circuit breakers, TLS stealth, MCP 110 tools, A2A, memory, guardrails, evals and 39,000+ static test declarations across 5,100+ tracked test files.

# 🤔 Niyə məhz OmniRoute?

OmniRoute request flow: your IDE or CLI (Claude Code, Cursor, Cline…) calls one local endpoint (http://localhost:20128/v1); the OmniRoute Smart Router (RTK + Caveman compression, 19 routing strategies, circuit breakers, TLS stealth, MCP, A2A, guardrails) can fall back across 4 provider tiers while an eligible healthy target remains — Tier 1 Subscription, Tier 2 API Key, Tier 3 Cheap and Tier 4 Free.

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

19 kombo marşrutlaşdırma strategiyasının hamısı animasiyalı şəkildə — 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** olaraq aralarında marşrutlaşdırdığı modellər zənciridir. Kvota tükənərsə, provayder sıradan çıxarsa və ya xərclər kəskin artarsa, kombo növbəti uyğun və sağlam 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 canlı qiymətləndirmə əsasında qoşulmuş provayderlərinizdən virtual kombo yaratsın:

Model ID-si	Nəyi optimallaşdırır
`auto`	🎯 Balanslaşdırılmış standart seçim (LKGP — son yaxşı 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şkar etmək üçün 10% araşdırma
`auto/lkgp`	📌 Son məlum yaxşı provayderə açıq şəkildə bağlı qalma
`auto/chaos`	🧪 Dayanıqlılıq sınaqları üçün nasazlıq yeritmə çəkiləri (xaos mühəndisliyi)

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

#	Strategiya	Nə edir
1	`priority`	İlk hədəfə üstünlük verən sıralanmış siyahı — növbətiyə keçməzdən əvvəl hər birini tükədin 🥇
2	`fill-first`	Növbətiyə keçməzdən əvvəl hər hədəfin kvotasını tam doldurun
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 edin
5	`p2c`	İki seçim gücünə əsaslanan təsadüfi yük balanslaşdırması
6	`least-used`	Cari yükü ən aşağı olan hədəfi seçin
7	`random`	Bərabər ehtimallı təsadüfi seçim (təkrarlar silinir)
8	`strict-random`	Təkrarları silmədən təsadüfi seçim 🎲
9	`cost-optimized`	Canlı kataloq qiymətləri əsasında sorğu başına $ məbləğini minimuma endirin 💸
10	`headroom`	Ən çox qalan kvotaya malik hədəfi seçin
11	`reset-window`	Kvota pəncərəsi ən tez sıfırlanan hədəfə üstünlük verin
12	`reset-aware`	Kvotanın sıfırlanma vaxtına görə sıralayın — ə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ün 🧠
14	`context-optimized`	Cari kontekst ölçüsünə ən uyğun hədəfi seçin
15	`cache-optimized`	Hər təkrar istifadə edilə bilən prompt prefiksini eyni hesaba sabitləyin — prompt keşi uyğunluqlarını maksimuma çatdırın 🎯
16	`lkgp`	Son Məlum Yaxşı Yol — son uğurlu provayderə sabitləyir, sonra qaydalara əsaslanan ehtiyat seçimə keçir
17	`auto`	Hər bağlantı üzrə 16 amilli canlı qiymətləndirmə 🤖
18	`fusion`	Model panelinə paralel sorğular göndərir + hakim vahid cavab hazırlayır 🧬
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** (sağlamlıq, 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ıranı (bütün provayder): yalnız 408/5xx hallarında işə düşür, hədlər OAuth 8× / API açarı 12× / lokal 2×, HALF-OPEN sınağına 60s/30s/15s ərzində sıfırlanır, tənbəl bərpa; OPEN vəziyyətində kombinasiya növbəti provayderə yönləndirilir. Qat 2 bağlantının gözləmə müddəti (bir açar/hesab): baza OAuth üçün 5s / API açarı üçün 3s, kütləvi eyni vaxtda sorğu axınından qorunma ilə eksponensial ×2 geriçəkilmə, 429 Retry-After göstərişinə əməl edir, uğur bütün xəta vəziyyətlərini təmizləyir; gözləmə rejimindəki bir açar ötürülür, digər açarlar isə xidmət göstərməyə davam edir. Qat 3 model 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. Terminal vəziyyətlər (bloklanmış, müddəti bitmiş, kreditləri tükənmiş) gözləmə müddətləri üçün deyil, operator üçündür.

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

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

_{📊 Tam metodologiya və 9router, OpenRouter, CLIProxyAPI & LiteLLM ilə hər xüsusiyyət üzrə detallar → [`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** — agent parkınıza daxil olan A2A delegasiyası, Agent Card-da Conductor bacarıqları və Faro bas-danış 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** — ağır çat 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 lizinq mexanizmindən istifadə edilir. → [Dayanıqlı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ış vahid bitişik blok (əvvəlcə sabitlənmiş kombinasiyalar), bütün kataloq mənbələrində sabitdir. → [API İstinadı](docs/reference/API_REFERENCE.md) - **🗜️ Gücləndirilmiş sıxılma** — standart olaraq aktiv açılma qoruyucusu, DE / FR / JA + Çin dili (wényán) üçün Caveman paketləri, Gradle və .NET üçün RTK filtrləri. → [Sıxılma](docs/compression/COMPRESSION_ENGINES.md) - **💸 Dürüst sabit tarif dəyəri** — 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) - **⚖️ Kvota-Paylaşımı marşrutlaşdırması** — ortaq hesabın kvotasını birləşdirilmiş açarlar arasında ədalətlə bölür və iş yükünü qoruyaraq boş payların istifadəyə verilməsini təmin edir. → [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 üçün favoritlərlə 10 hədəfi dəstəkləyir. → [CLI İnteqrasiyaları](docs/guides/CLI-INTEGRATIONS.md) - **🛰️ Uzaq 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çisindən istifadə edin. → [Uzaq Rejim](docs/guides/REMOTE-MODE.md) - **🧭 Daha ağıllı avtomatik marşrutlaşdırma** — `auto/:` kombinasiyaları, **Fusion** (model paneli + hakim), tapşırıqdan xəbərdar marşrutlaşdırma, hər sorğu üçün model / rejim / USD-büdcə əvəzləmələri. → [Avtomatik Kombinasiya](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əyərək 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ərini nəzərə almayan 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 üçün USD xərc kvotaları. → [API İstinadı](docs/reference/API_REFERENCE.md) - **🧠 İdarə etdiyiniz yaddaş** — standart olaraq deaktivdir, seçim əsasında int8 vektor kvantlaşdırması + tipləşdirilmiş zəifləmə, hər sorğu üçün `x-omniroute-no-memory`. → [Yaddaş](docs/frameworks/MEMORY.md) - **🛡️ Təhlükəsizlik** — hər LLM marşrutunda prompt inyeksiyası qoruyucusu (red-team test dəsti), seçim əsasında giriş məlumatlarını maskalayan qoruyucu mexanizm (hər iki istiqamətdə sızmış API açarlarını/məxfi məlumatları redaktə edir), son çarə kimi pulsuz 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 Mexanizmlər](docs/security/GUARDRAILS.md) - **🖼️ Yeni son nöqtələr** — `/v1/ocr` (Mistral OCR) və `/v1/audio/translations` (Whisper üslubunda) media imkanlarını tamamlayır. → [API İ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əmə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), birinci dərəcəli Ollama kartı, Claude Opus 5 və Sonnet 5, Kimi rəsmi tərəfdaşlığı (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… və yenilənmiş **352 provayderlik kataloq**. → [Provayderlər](docs/reference/PROVIDER_REFERENCE.md) - **📡 Marşrutlaşdırma şəffaflığı** — hər cavabda ona xidmət göstərmiş strategiyanı/provayderi/gecikməni bildirən `X-OmniRoute-Decision` başlığı olur, yeni `cache-optimized` kombinasiya strategiyası + Auto-Combo `cacheAffinity` amili təkrar sorğuları keşlənmiş prefiksi saxlayan bağlantıya yönləndirir və yalnız oxuma üçün `/v1/auto-combo/{channel}/candidates` son nöqtəsi `auto/*` kanalının canlı namizəd hovuzunu göstərir. → [Avtomatik Kombinasiya](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) - **🧩 Paketə həmçinin daxildir** — plagin çərçivəsi + marketpleys, Omni/Agent/GitHub bacarıq çərçivələri, Obsidian vault inteqrasiyası (22 MCP aləti), OpenAI-uyğun Batch və Files API-ləri, semantik cavab keşi, lider cədvəlləri ilə oyunlaşdırma, ACP agent aşkarlanması (15 daxili agent), jurnalların planlaşdırılmış şəkildə BigQuery-yə ixracı, `auto/chaos` xəta inyeksiyası, 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)

## 🌐 357 AI Provayderi — 152-si Kataloqda Pulsuz Olaraq İşarələnib

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

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

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

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

OpenCode Zen _{DeepSeek V4, Nemotron 3 Token limiti yoxdur}	Kilo Code _{Avtomatik yönləndirici, Tencent Hy3 Həmişə pulsuz}	Requesty _{GPT-OSS 120B, Nemotron Həmişə pulsuz}	SiliconFlow _{DeepSeek V3.2 / R1 Pulsuz tarif}	Z.AI GLM _{GLM-4.7 / 4.5-Flash Həmişə pulsuz}	Baidu ERNIE _{ERNIE 4.0 Həmişə pulsuz}
Qoder AI _{Qwen3-Max, Kimi-K2 Limitsiz 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 Pulsuz ~40 RPM}	Cerebras _{GLM 4.7, GPT-OSS Gündə 1M token}	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

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

OmniRoute sıxış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ş birləşdirilmiş 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ə uyğunluq yoxlamaları ilə mühafizə olunur; açıq şəkildə seçilən itkili və ya eksperimental rejimlər uyğun məzmunu dəyişdirə bilər.

Standart birləşdirilmiş kombinasiya `RTK → Caveman` ardıcıllığı ilə işləyir. Hər ikisi eyni alət/kontekst yükünə tətbiq edildikdə qənaət mürəkkəb şəkildə hesablanır: ```txt combined = 1 − (1 − RTK) × (1 − Caveman_input) average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2% range = 78.4 – 94.6% ``` Kod blokları, URL-lər, JSON və strukturlaşdırılmış məlumatlar qoruma mühərriki tərəfindən **həmişə qorunur**. > **Az token kifayət etdiyi halda niyə çox token istifadə edəsiniz?** Hər sorğu OmniRoute-un sıxış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	Gedişlər arasında təkrarlanan məzmunu silir (məzmun ünvanlı, 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ın + şəkil URL-lərinin ixtisarı (aşağı gecikməli baza səviyyəsi)
4	RTK	Alət nəticələrinin ağıllı filtrasiyası, təkrarların silinməsi və ixtisarı (əmrləri nəzərə alır)
5	Responses Tool Output	Shell/patch/axtarış/qurma çıxışları üçün ilk növbədə itkisiz JSON + məhdudlaşdırılmış diaqnostik sıxışdırma (Responses API)
6	Headroom	Paketə 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 ekstraktiv qiymətləndirilməsi
8	Caveman	Qaydalara əsaslanan mətn sıxışdırması (çıxışda ~65–75%)
9	Aggressive	Köhnə gedişlərin xülasələndirilməsi + mərhələli köhnəldilməsi
10	LLMLingua-2	MobileBERT ONNX vasitəsilə ML semantik ixtisarı — kod üçün təhlükəsiz, asinxron
11	Ultra	Opsional kiçik model (SLM) səviyyəsi ilə evristik token ixtisarı
12	OmniGlyph	Birbaşa Anthropic bağlantısında ölçülmüş Claude Fable 5 üçün eksperimental kontekst-şəkil kodlaşdırması; GPT 5.6 transformerləri provayder təsdiqləri əldə edilənədək nasazlıq zamanı qapalı qalır. Dörd sıxışdırma profili (standart olaraq aqressiv, balanslaşdırılmış, kodlaşdırma üçün təhlükəsiz, dəyişikliksiz ötürmə) (ən aqressiv; ayrıca aktivləşdirilməlidir)

Kod blokları, URL-lər və strukturlaşdırılmış məlumatlar **həmişə bayt səviyyəsində dəyişməz saxlanılır**. **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 standart seçim
🪨 Standard (Caveman)	~30%	Gündəlik kodlaşdırma
⚡ Aggressive	~50%	Alətlərdən geniş istifadə olunan uzun sessiyalar
🔥 Ultra	~75%	Maksimum qənaət
🧰 RTK	60–90%	Shell/test/qurma/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 edilməsinin səbəbi, çox güman ki, 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, yenidən render edilməyə səbəb olur. 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 sıfırdır.** ✅ **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 olanı kiçildir. Daha üç səviyyə isə nəticənin **necə**, **nə vaxt** və hansı formada **çıxacağı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; birləşdirilə bilər və hər biri `lite` / `full` / `ultra` intensivliyinə malikdir. Üslub əlavə etmək üçün reyestrə bir sətirlik qeyd kifayətdir: - **Qısa mətn** — doldurucu sözləri / artiklləri / tərəddüd ifadələrini çıxarın; texniki məzmunu dəqiq saxlayın. - **Daha az kod** — "tənbəl senior developer" YAGNI yanaşması: işləyən ən kiçik dəyişiklik, istənilməmiş əlavə struktur yoxdur. - **Ponytail (tənbəl senior developer)** — YAGNI pillələri ilə irəliləyin, əsas səbəbi aradan qaldırın, işləyən ən kiçik diff-i yaradın. - **Məndə ADHD var (əvvəlcə fəaliyyət)** — növbəti fəaliyyətlə başlayın, addımları nömrələyin, yalnız bir konkret növbəti addım verin, giriş sözü yazmayın. - **Qısa CJK (文言)** — klassik Çin dilində ultra-qısa üslub (yalnız `zh` lokalı üçün). - **🎯 Adaptiv kontekst büdcəsi** _(tənzimləyici)_ — tək bir aktiv/deaktiv token həddi əvəzinə, modelin kontekst pəncərəsinə **sığmaq** üçün yalnız lazım olduğu qədər ən ucuz və ən az itkili mühərrikləri mərhələli şəkildə 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ırmaya harada qərar verilir** _(ü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 ləğvetməsi › aktiv adlandırılmış profil › adaptiv / avtomatik işəsalma › panelin standart ayarı › deaktiv. Tətbiq edilmiş plan cavabın `X-OmniRoute-Compression: ; source=` başlığında əks olunur. Token həddinə görə avtomatik işəsalmanı seçin, adaptiv tənzimləyicini aktivləşdirin, adlandırılmış profili sabitləyin, hər sorğu üçün birdəfəlik ayar təyin edin və ya hər marşrutlaşdırma kombinasiyasına ayrıca pipeline təyin edin — iş yükünə hansı uyğundursa. Könüllü, oflayn **qiymətləndirmə sistemi** (`npm run eval:compression`) dəyişikliyi tətbiq etməzdən əvvəl sabitlənmiş korpusda dəqiqliyi 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-dep xəbərdarlıqları görürsünüz? [Onlar zərərsizdir](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated). İdarəetmə paneli: `http://localhost:20128` · API: `http://localhost:20128/v1`. **2) PULSUZ provayder qoşun (qeydiyyat tələb olunmur)** İdarəetmə paneli → **Provayderlər** → **Kiro AI** (pulsuz Claude, hər hesab üçün ayda ~50 kredit) və ya **OpenCode Free** (autentifikasiya tələb olunmur) qoşun → hazırdı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 (konfiqurasiyasız ağıllı marşrutlaşdırma — və ya istənilən provayder/model) ``` **4) İşlədiyini yoxlayın** ```bash curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY" ``` Qoşduğunuz modellərin siyahısını görməlisiniz. 🎉 Bu qədər — kodlaşdırmağa başlayın, OmniRoute isə sorğularınızı avtomatik marşrutlaşdıracaq və xəta halında alternativə keçəcək. Müştəriniz xüsusi başlıqlar göndərə bilmirsə, OmniRoute tokenləşdirilmiş uyğunluq aliasları da 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 cavabları: 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 ``` Bunları yalnız `Authorization: Bearer ...` əlavə edə bilməyən müştərilər üçün istifadə edin. Başlıqla autentifikasiya üstünlük verilən rejim olaraq qalır.
## 📦 Daha çox quraşdırma üsulu — Docker, mənbə kodu, pnpm, Arch **🐳 Docker** ```bash docker run -d --name omniroute --restart unless-stopped --stop-timeout 40 \ -p 127.0.0.1:20128:20128 -v omniroute-data:/app/data diegosouzapw/omniroute:latest ``` `:latest` ən yüksək **dərc edilmiş** stabil SemVer versiyasını izləyir. O, git `main` budağını izləmir. GitOps üçün `:X.Y.Z` versiyasını sabitləyin. [Docker buraxılış kanalları](docs/guides/DOCKER_GUIDE.md#release-channels) bölməsinə baxın. İmic **`OMNIROUTE_MEMORY_MB=1024`** dəyərini sabitləyir. Bu, idarəetmə paneli və yüngül söhbət üçün kifayətdir. **Kodlaşdırma agentləri** (Claude Code, Codex, Grok və s.-dən `POST /v1/responses`) daha böyük V8 yığını tələb edir, əks halda üst-üstə düşən iki uzun kontekst zamanı proses təxminən 12 GiB səviyyəsində `FATAL ERROR` ilə dayanır. Konteyner ölçüsünü yığından böyük təyin edin (yerli buferlər V8-dən kənarda yerləşir): | İş yükü | Yığın (`-e OMNIROUTE_MEMORY_MB`) | Konteyner (`--memory`) | | -------------------------------- | -------------------------------- | ---------------------- | | İdarəetmə paneli / yüngül söhbət | `1024` (imicin standart dəyəri) | ≥2 g | | Bir kodlaşdırma agenti | `8192` | ≥10 g | | İki paralel uzun `/v1/responses` | `10240`–`12288` | ≥12–16 g | ```bash docker run -d --name omniroute --restart unless-stopped --stop-timeout 40 \ -e OMNIROUTE_MEMORY_MB=8192 --memory=10g \ -p 127.0.0.1:20128:20128 -v omniroute-data:/app/data diegosouzapw/omniroute:latest ``` Tam cədvəl: [Docker təlimatı — icra zamanı RAM](docs/guides/DOCKER_GUIDE.md#runtime-ram-for-coding-agents). > **İlkin buraxılış Docker kanalı:** `diegosouzapw/omniroute:next` və > `diegosouzapw/omniroute:next-web` cari standart `release/v*` > budağını izləyir. Bu dəyişən teqlər yalnız buraxılmamış düzəlişləri sınaqdan keçirmək üçün nəzərdə tutulub və > **istehsal mühitində dəstəklənmir**. Baxın: > [Docker buraxılış kanalları](docs/guides/DOCKER_GUIDE.md#release-channels). **🥟 Bun** Standart `bun install` və qlobal quraşdırma (`bun install -g omniroute`) Bun icra mühitinin aşkarlanması vasitəsilə dəstəklənir: - **Daxili `bun:sqlite`**: OmniRoute Bun altında işləyərkən onun daxili `bun:sqlite` drayverindən istifadə edir, Node.js mühitində isə `better-sqlite3` və ya `sql.js` variantına keçir. - **İnkişaf mühitində avtomatik Webpack paketləyicisi seçimi**: İnkişaf rejimi (`bun run dev`) Bun-u avtomatik aşkarlayır və yerli V8 bağlamalarının uyğunsuzluqlarının qarşısını almaq üçün Turbopack-i söndürərək Webpack-dən istifadə edir. İstehsal yığımları (`bun run build`) `OMNIROUTE_USE_TURBOPACK` dəyişəninə Node-da olduğu kimi dəqiq əməl edir: standart olaraq Turbopack, Webpack ilə yığmaq üçün isə `OMNIROUTE_USE_TURBOPACK=0` (`Dockerfile.bun` bunu `--build-arg` kimi təqdim edir). - **Xüsusi Bun Dockerfile faylı**: Yerli Bun istehsal yerləşdirmələri üçün çoxmərhələli `Dockerfile.bun` (`docker build -f Dockerfile.bun -t omniroute:bun .`). ```bash # Bun ilə quraşdırın və işə salın bun install bun run dev ``` **🛠️ Mənbə kodundan** ```bash cp .env.example .env && npm install PORT=20128 npm run dev ``` **📦 pnpm** ```bash pnpm add -g omniroute@latest --allow-build=better-sqlite3 --allow-build=@swc/core && omniroute ``` **🐧 Arch Linux (AUR)** ```bash yay -S omniroute-bin && systemctl --user enable --now omniroute.service ``` **🔧 Nix (Flake)** ```bash # Nix flakes istifadə etməklə nix develop npm run dev # Və ya devbox istifadə etməklə devbox run npm run dev ``` 📖 [Docker təlimatı](docs/guides/DOCKER_GUIDE.md) — Compose profilləri, Caddy HTTPS, Cloudflare tunelləri. **🦭 Podman** ```bash # 1. Bağlama ilə qoşulan məlumat qovluğunu hazırlayın mkdir -p data # 2. Yalnız Linux + yerli rootless Podman üçün (heç vaxt uzaq Podman Machine klientində deyil): podman unshare chown 1000:1000 ./data # 3. İcra mühiti göstərişini təyin edin, yerli Compose imicini yığın və başladın echo "CONTAINER_HOST=podman" >> .env podman compose --profile base up -d --build ``` macOS və ya Windows-da Podman uzaq Podman Machine istifadə edir: `podman unshare` addımını ötürün və [topologiyaya uyğun məlumat qovluğu təlimatlarına](contrib/podman/README.md#data-directory-permissions-by-topology) əməl edin. 📖 [Podman təlimatı](contrib/podman/README.md) — Compose yığımları, Podman Machine və Linux/systemd Quadlet quraşdırması. **⚡ Daha sürətli / daha yüngül quraşdırma (yerli yığımı ötürün)** Yerli SQLite mühərriki (`better-sqlite3`) **ixtiyari** asılılıqdır, buna görə də qlobal quraşdırma heç vaxt mənbə kodundan kompilyasiyanı gözləyərək bloklanmır: platformanıza/Node-a uyğun olduqda əvvəlcədən yığılmış binar fayldan istifadə edir, əks halda şəffaf şəkildə saf JS mühərrikinə (Node 22+ mühitində `node:sqlite`, əks halda paketə daxil edilmiş `sql.js` WASM) keçir — yığım alətləri tələb olunmur. Quraşdırmadan sonrakı yerli ilkin hazırlığı tamamilə ötürmək üçün (CI, başsız və ya yavaş maşınlar): ```bash OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute # CI=1 də bunu ötürür ``` Ən sürətli quraşdırma üçün **pnpm**-ə üstünlük verin (məzmun ünvanlı saxlanc + sərt keçidlər — yuxarıya baxın). İdarəetmə panelsiz, başsız icra mühiti üçün Docker `base` profilindən (yuxarıda) və ya [Termux təlimatından](docs/guides/TERMUX_GUIDE.md) istifadə edin. CLI və veb idarəetmə paneli eyni proses tərəfindən bir portda təqdim olunur, buna görə hazırda ayrıca yalnız CLI üçün paket yoxdur.

# 🎬 OmniRoute Fəaliyyətdə

## 📹 Video 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 Yığını

Qat	Texnologiya
İşləmə mühiti	Node.js 22.x / 24.x LTS — `>=22.22.2 <23 \|\| >=24.0.0 <27`
Dil	TypeScript 6.0 — 100% TypeScript `src/` və `open-sse/` boyunca (v2.0-dan bəri əsasda sıfır `any`)
Çərçivə	Next.js 16 + React 19 + Tailwind CSS 4
Verilənlər bazası	better-sqlite3 (SQLite, WAL jurnalizasiyası) + LowDB (JSON köhnə) — 122 domen modulu, 183 miqrasiya
Yaddaş	SQLite FTS5 tam mətn + int8-kvantlaşdırılmış vektor daxiletmələri, tipli parçalanma
Sxemlər	Zod 4 — MCP alətinin I/O yoxlaması + API müqavilələri
Protokollar	MCP (stdio / HTTP / SSE) + A2A v0.3 (JSON-RPC 2.0 + SSE)
Axın	Server-Sent Events (SSE) + WebSocket körpüsü (`/v1/ws`)
Sıxılma	12-mühərrikli boru kəməri — RTK, Caveman, LLMLingua-2 (MobileBERT ONNX), GCF, OmniGlyph
Doğrulama və təhlükəsizlik	OAuth 2.0 (PKCE) + JWT + API Açar sözləri + MCP əhatəli doğrulama · AES-256-GCM istirahətdə · DOMPurify
Gizlilik	wreq-js — JA3 / JA4 TLS barmaq izi imitasiyası, 3 səviyyəli proksi
Davamlılıq	Dövrə kəsici, eksponensial geri çəkilmə, anti-thundering-herd, avtomatik-kombo özünü bərpa etmə
Qeydiyyat	pino — sorğu konteksti ilə strukturlaşdırılmış JSON qeydləri
Test	Node.js test runner + Vitest — 39,000+ statik test bəyanatı 5,100+ izlənilən test faylı (vahid, inteqrasiya, E2E, təhlükəsizlik, ekosistem) boyunca
Platformalar	Masaüstü (Electron) · Android (Termux) · PWA (istənilən brauzer)
CI/CD	GitHub Actions — avtomatik npm nəşri + Docker Hub buraxılışda
Keçidlər	Vebsayt · 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.51 · Node ≥22.22.2 · MIT Lisenziyası · omniroute.online}