# README (Հայերեն) 🌐 **Languages:** 🇺🇸 [English](../../../README.md) · 🇪🇹 [am](../am/README.md) · 🇸🇦 [ar](../ar/README.md) · 🇦🇿 [az](../az/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) · 🇮🇩 [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 — Անվճար AI դարպասը

OmniRoute — Երբեք մի՛ դադարեք կոդ գրել։ Յուրաքանչյուր AI գործիք → 375 մատակարար — 150+-ը՝ անվճար — մեկ վերջնակետի միջոցով։ Claude Code-ը, Codex-ը, Cursor-ը, Cline-ը, Copilot-ը և Antigravity-ն՝ ԱՆՎՃԱՐ Claude / GPT / Gemini-ի հետ՝ ավտոմատ պահուստային անցմամբ։ RTK + Caveman համակցված սեղմումը խնայում է նշանների 15–95%-ը (միջինը՝ ~89%)՝ երբեք չհասնելով սահմանաչափերին։ 375 AI մատակարար · 150+ անվճար սակագին · ամսական ~1.62 մլրդ անվճար նշան · երթուղավորման 20 ռազմավարություն · մեկնարկը՝ $0։

## 💰 ~1.62 մլրդ տոկեն / ամիս՝ երրորդ կողմերի անվճար փաթեթներում

> **Բերեք ձեր սեփական մատակարարի հաշիվները։** Սա գնահատված ագրեգատ է առանձին իրավասու երրորդ կողմերի անվճար փաթեթների միջև, ոչ թե OmniRoute-ի կողմից տոկենների տրամադրում։ Գրանցվեք, ստացեք հավատարմագրեր, որտեղ պահանջվում է, և միացրեք այն մատակարարներին, որոնք կարող եք օգտագործել․ յուրաքանչյուր մատակարար վերահսկում է իր սահմանափակումները, հասանելիությունը և պայմանները։ > > Անվճար փաթեթները ձեռքով կուտակելը ցավոտ գործ է՝ տասնյակ SDK-ներ, տասնյակ արագության սահմանափակումներ, և պատկերացում չկա, թե իրականում որքան ունեք։ OmniRoute-ը կատալոգում է **467 անվճար փաթեթի գրառում՝ 34 կրկնվող pool բանալիների ընթացքում** և հաշվարկում է տոկենների գլխավոր ցուցանիշը **17 pool-երից, որոնք ունեն հրապարակված դրական ամսական բյուջե, գումարած Groq-ի հինգ մոդել-հատուկ սահմանափակում**, կրկնօրինակազերծված ըստ ընդհանուր pool-ի։ Քվոտաները, որոնք բացվում են միայն տարածաշրջանային ինքնության ստուգումից հետո (այսօր՝ ModelScope), ցուցադրվում են առանձին՝ +~6M տարածաշրջանային ինքնության հաստատման հետևում, և երբեք չեն գումարվում գլխավոր ցուցանիշին։ Արդյունքը մնում է տեսանելի վահանակում (`/dashboard/free-tiers`)։

OmniRoute-ի անվճար փաթեթների բյուջեի քարտ՝ ~1.62 մլրդ անվճար տոկեն ամսական կայուն, մինչև ~2.22 մլրդ առաջին ամսում գրանցման վարկերով՝ 34 փաստաթղթավորված կրկնվող pool բանալիներից, որոնք ընդգրկում են 467 կատալոգացված անվճար փաթեթի գրառում մեկ վերջնակետի հետևում։ Ազնիվ pool-կրկնօրինակազերծված հաշվարկ՝ յուրաքանչյուր ընդհանուր pool հաշվվում է մեկ անգամ, ներառյալ 17 կրկնվող pool՝ հրապարակված դրական ամսական տոկենային բյուջեով, գումարած Groq-ի հինգ մոդել-հատուկ սահմանափակում; 12 մատակարար նշված են որպես «խուսափել» պայմանների ռիսկի կատալոգում, որպեսզի դուք որոշեք։ Բյուջեի գոտին ներառում է Mistral 1B, Nara 210M, LLM7 150M, xKiro 150M, Groq 30M (հինգ մոդել-հատուկ սահմանափակում) և ավելի փոքր pool-եր, գումարած առաջին ամսվա գրանցման վարկեր և մշտապես անվճար՝ առանց տոկենային սահմանափակման մատակարարներ, որոնք ցուցադրվում են առանձին, որպեսզի երբեք չուռճացնեն գլխավոր ցուցանիշը։ Օգտագործված/մնացածը՝ իրական ժամանակում /dashboard/free-tiers էջում։

> `/dashboard/free-tiers` իրական ժամանակի էջի անիմացված ամփոփում։ Ամբողջական մեթոդաբանություն (pool-ի կրկնօրինակազերծում, վարկերի աստիճաններ, մատակարարների պայմաններ)՝ **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**։ > > _{Այս թվերը վերաուդիտվում են երկու շաբաթը մեկ՝ ըստ իրական կատալոգի, և **շարժվում են երկու ուղղությամբ**՝ մատակարարը դադարեցնում է անվճար փաթեթը, և թիվը նվազում է. նորը հայտնվում է, և այն աճում է։ Մենք հրապարակում ենք այն, ինչ կատալոգը իրականում հաշվարկում է, երբեք՝ կլորացված լավագույն սցենար։}

⭐ Աստղացրեք ռեպոզիտորը, եթե OMNIROUTE-ը օգնել է ձեզ խնայել գումար և հեշտացնել ձեր աշխատանքը։

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

[![Star History Rank](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) ### 💬 Միացեք համայնքին **👋 Հետևեք սպասարկողին՝ առաջինը ստացեք նոր մատակարարներ, թողարկումներ և խորհուրդներ։** [![Follow Diego on LinkedIn](https://img.shields.io/badge/Follow_Diego_on-LinkedIn-0A66C2?style=for-the-badge&logo=linkedin&logoColor=white)](https://www.linkedin.com/in/diegosouzapw/) [![Follow @diegosouzapw on GitHub](https://img.shields.io/github/followers/diegosouzapw?style=for-the-badge&logo=github&logoColor=white&label=Follow%20on%20GitHub&color=181717)](https://github.com/diegosouzapw) [![Discord](https://img.shields.io/badge/Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/U47eFqAXCn) [![Telegram](https://img.shields.io/badge/Telegram-26A5E4?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/omnirouteOficial) [![WhatsApp Global](https://img.shields.io/badge/WhatsApp_Global-25D366?style=for-the-badge&logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) [![WhatsApp Brasil](https://img.shields.io/badge/WhatsApp_Brasil-25D366?style=for-the-badge&logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) [![Website](https://img.shields.io/badge/Website-omniroute.online-blue?logo=google-chrome&logoColor=white)](https://omniroute.online) **Հարցեր, մատակարարների խորհուրդներ, ճանապարհային քարտեզ և աջակցություն → [Discord](https://discord.gg/U47eFqAXCn) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 Գլոբալ](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) / [🇧🇷 Բրազիլիա](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) / [Պորտալ](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK)**
## 📈 Գեյթվեյը շարունակում է աճել

| | v3.8.50 | **v3.8.51** | `v3.8.53+` | | --------------------------------- | :--------------------------------: | :---------: | :-------------------: | | 🌐 Մատակարարներ | 352 | **358** | 375 | | 🧠 Չաթի մոդելների եզակի ID-ներ | 1320 | **1374** | 1475 | | 🖼️ Մոդալությունների կամուրջ | 🆕 տեսողություն + ձայն + տեսանյութ | ✓ | ✓ | | 📡 Ռադարի անվճար կատալոգ | 🆕 ըստ ցանկության միացում | ✓ | ✓ | | ⚖️ Քվոտան հաշվի առնող պլանավորում | 🆕 Quota-Share | ✓ | ✓ | | 📊 Քվոտայի հեռաչափություն | 🆕 իրական ժամանակում | ✓ | ✓ | | 🧰 Headless ռեժիմ | — | — | 🆕 `serve --headless` | | 🛤️ LTS ուղու ենթակառուցվածք | — | — | 🆕 թողարկման ալիքներ | | 🔎 Մոդելների հայտնաբերման API | — | — | 🆕 `/v1/models/query` | **→ [Ճանապարհային քարտեզ](ROADMAP.md) — ուղին տանում է դեպի `v3.9.0 LTS`**

## 🧩 Հասանելի է [![npm տարբերակ](https://img.shields.io/npm/v/omniroute?color=cb3837&logo=npm)](https://www.npmjs.com/package/omniroute) ![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) [![Լիցենզիա՝ MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](LICENSE) ![Docker ներբեռնումներ](https://img.shields.io/docker/pulls/diegosouzapw/omniroute?label=docker%20pulls&logo=docker&color=2496ED) ![Electron ներբեռնումներ](https://img.shields.io/github/downloads/diegosouzapw/omniroute/total?style=flat&label=electron%20downloads&logo=electron&color=47848F)

🚀 Սկիզբ	🚀 Արագ մեկնարկ	📦 Տեղադրում	🆓 Միացնել մատակարար
💡 Իմացեք ավելին	💥 Խոստումը	🤔 Ինչու OmniRoute	🏆 Ինչով է առանձնանում
⚙️ Հնարավորություններ	🎯 Համակցություններ	🌐 Մատակարարներ	🔌 CLI և MCP
	🗜️ Սեղմում	🖥️ Որտեղ է աշխատում	🔒 Գաղտնի
👀 Դիտեք	🎬 Գործողության մեջ	✨ Նորությունները	🤖 Համատեղելի CLI-ներ
💚 Աջակցություն	💚 Աջակցել / Նվիրաբերել	💬 Համայնք	💖 Հովանավորներ
📦 Նախագիծ	🛠️ Տեխնոլոգիական փաթեթ	📖 Փաստաթղթեր	👥 Մասնակիցներ

🌐 67 լեզուներով

## 🆓 Տեղադրեք, միացրեք մատակարար և այնուհետև երթուղավորեք մեկ վերջնակետի միջոցով

Երեք քայլ. տեղադրեք և գործարկեք OmniRoute-ը, միացրեք համապատասխան մատակարար՝ ձեր սեփական հաշվի կամ API բանալու միջոցով, ապա ձեր գործիքն ուղղեք դեպի localhost:20128/v1՝ օգտագործելով OmniRoute API բանալի և auto մոդելը։ Երթուղավորումը կախված է հասանելի համապատասխան կապերից և մատակարարների սահմանաչափերից։

```bash # Մատակարարին միանալուց հետո պատճենեք ձեր OmniRoute բանալին Dashboard → Endpoints բաժնից. 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`-ի համար անհրաժեշտ է համապատասխան երթուղի։ Նոր տեղադրումը կարող է չունենալ առանց բանալու որևէ համապատասխան թիրախ, իսկ առանց բանալու մատակարարը կարող է մերժել երրորդ կողմի հաճախորդներին։ `tos: avoid` նշումով մատակարարները, ներառյալ Kiro-ն, լռելյայն բացառվում են ավտոմատ երթուղավորումից․ հաշիվ միացնելը չի փոխում այդ կարգավորումը։ Մատակարար ընտրելուց առաջ տե՛ս [Անվճար սակագների ուղեցույցը](docs/getting-started/FREE-TIERS-GUIDE.md)։} _{📦 Պատճենման և տեղադրման համար պատրաստ արագ մեկնարկի սկրիպտներ **Python-ի, Node.js-ի, PHP-ի և cURL-ի** համար → [`examples/quickstart/`](examples/quickstart/)}

# 💥 Խոստումը

# 🤔 Ինչո՞ւ OmniRoute։

OmniRoute հարցման հոսքը՝ ձեր IDE-ն կամ CLI-ն (Claude Code, Cursor, Cline…) կանչում է մեկ տեղային վերջնակետ (http://localhost:20128/v1)․ OmniRoute խելացի երթուղիչը (RTK + Caveman սեղմում, երթուղավորման 20 ռազմավարություն, շղթայի անջատիչներ, TLS քողարկում, MCP, A2A, պաշտպանիչ սահմանափակումներ) կարող է պահուստային անցում կատարել մատակարարների 4 մակարդակների միջև, քանի դեռ առկա է համապատասխան աշխատունակ թիրախ՝ Մակարդակ 1՝ Բաժանորդագրություն, Մակարդակ 2՝ API բանալի, Մակարդակ 3՝ Էժան և Մակարդակ 4՝ Անվճար։

## 🤝 Աջակցվում է մեր բաց կոդով ընկերների կողմից

> **Ցանկանու՞մ եք միանալ որպես բաց կոդով ընկեր:** Սրանք այն ընկերություններն են, որոնք աջակցում են բաց կոդին և օգնում են OmniRoute-ին շարունակել աշխատել, և մենք հրապարակայնորեն նշում ենք, թե ուր է գնում նրանց տված յուրաքանչյուր թոքենը: Կապ հաստատեք՝ [diegosouza.pw@outlook.com](mailto:diegosouza.pw@outlook.com)

Kimi
_{Moonshot AI} Շնորհակալություն Kimi (Moonshot AI)-ին՝ մեր հիմնադիր բաց կոդով ընկերոջը, այս նախագծին աջակցելու համար: Kimi-ն AI լաբորատորիան է, որը ստեղծել է բաց քաշով K2 և K3 մոդելների ընտանիքները. Kimi K3-ն ապահովում է 1M-թոքեն համատեքստային պատուհան, բնիկ տեսողություն և առաջնակարգ կոդավորում փակ մոդելների գների մի մասով, և աշխատում է Claude Code-ի, Codex-ի և OmniRoute-ի կողմից սպասարկվող յուրաքանչյուր կոդավորման գործիքի հետ:

Ինչ է ապահովում Kimi-ի աջակցությունը. Kimi-ի API վարկերը սնուցում են OmniRoute-ի AI-ով վավերացված թողարկման խողովակաշարը՝ Kimi K3-ով սնուցվող միաձուլման վավերացման փուլը, որը վերանայում է յուրաքանչյուր քաշման հարցում մինչև դրա առաքումը, գումարած ամենօրյա ֆունկցիոնալության մշակումը: Առաջին կարգի Kimi աջակցությունն ապահովվում է երկու ուղղություններով՝ ուղղակի Kimi API (kimi-k3) և Kimi Code կոդավորման պլան (OAuth և API բանալի): OmniRoute-ն նաև առաջին բրազիլական բաց կոդով նախագիծն է Kimi-ի աջակցության ծրագրում: Ստացեք Kimi API բանալի 15% լրացուցիչ վարկերով →

Ավելի էժան ինֆերենցիա
_{cheaperinference.com} Շնորհակալություն Cheaper Inference-ին՝ OmniRoute-ի բաց կոդով ընկերոջը, այս նախագծին աջակցելու համար: Cheaper Inference-ը ծախսերով դասակարգված դարպաս է, որը վերավաճառում է 42 առաջնակարգ մոդելներ՝ Claude, GPT-5.x, Gemini, Kimi K3, GLM, DeepSeek, Grok և MiniMax՝ մեկ OpenAI-ի հետ համատեղելի վերջնակետի հետևում, յուրաքանչյուր հարցում ուղղելով ամենաէժան համապատասխան մատակարարին՝ երբեք չգանձելով մոդել ստեղծողի ցուցակային գնից բարձր:

Առաջին կարգի աջակցություն OmniRoute-ում. Զրույցի ավարտներ, բնիկ /v1/responses վերջնակետ, տեսողություն, գործիքների կանչում և 3 պատկերային մոդել (grok-imagine, nano-banana-pro, nano-banana-2, հասանելի որպես cheaperinference/<model>): Ստացեք API բանալի →

_{aff=omniroute պիտակով հղումները գործընկերային հղումներ են: Դրանք ֆինանսավորում են նախագիծը առանց ձեզ համար լրացուցիչ ծախսերի:}

_{🎟️ Աֆիլիատների պրոմո — անվճար գրանցման կտրոններ մատակարարներից, որոնց մենք չենք հովանավորում (սեղմեք՝ ընդլայնելու համար)}

_{Այս բաժինը միայն ուղղորդման/կտրոնների կոդերի համար է: Հովանավորվող գործընկերությունները գտնվում են վերևում՝ 🤝 Աջակցվում է մեր բաց կոդով ընկերների կողմից բաժնում: OmniRoute-ը չունի հովանավորություն կամ գործընկերություն այստեղ նշված մատակարարների հետ. սրանք հանրային կտրոններ են, որոնք յուրաքանչյուրը կարող է օգտագործել:}

_AgentRouter
_{agentrouter.org} _{AgentRouter — աֆիլիատի գրանցում · $100 անվճար վարկեր գրանցվելիս (անվճար սերվեր, ակնկալեք ավելի բարձր ուշացում՝ լավագույնը թեստավորման համար, ոչ արտադրության): Առաջին կարգի աջակցություն OmniRoute-ում v3.8.50-ից սկսած. Զրույցի ավարտներ, Anthropic-ի հետ համատեղելի մետաղալարային ձևաչափ և OpenAI-ի հետ համատեղելի ուղի: Հասանելի մոդելները ներառում են claude-opus-4-8, claude-opus-5, gpt-5.6-sol և այլն: Ստացեք ձեր $100 →}

_{⚠️ Աֆիլիատի հղում — OmniRoute-ը չունի հովանավորություն կամ գործընկերություն այս մատակարարի հետ:}

_{Գիտե՞ք մեկ այլ մատակարարի, որն ունի առատաձեռն անվճար գրանցման կտրոն, որը օգուտ է բերում OmniRoute-ի օգտատերերին: Բացեք խնդիր, և մենք այն կավելացնենք այստեղ:}

## 🎯 Կոմբինացիաներ — առաջատար հնարավորությունը

20 կոմբինացիոն երթուղավորման ռազմավարություններից 18-ի անիմացված օրինակներ՝ յուրաքանչյուր ռազմավարության համար մեկ սալիկ՝ priority, fill-first, weighted, round-robin, p2c, least-used, random, strict-random, cost-optimized, headroom, reset-window, reset-aware, context-relay, context-optimized, lkgp, auto, fusion, pipeline։ cache-optimized-ը և quota-weighted-ը անիմացված չեն․ ստորև բերված աղյուսակը նկարագրում է բոլոր 20-ը։

> **Կոմբինացիան** մոդելների շղթա է, որոնց միջև OmniRoute-ն երթուղավորում է **ինքնաբերաբար**։ Եթե քվոտան սպառվում է, մատակարարը խափանվում է կամ ծախսերը կտրուկ աճում են, կոմբինացիան կարող է անցնել հաջորդ համապատասխան ու անխափան աշխատող մոդելին։ 🛡️ ### ⚡ Առանց կազմաձևման՝ պարզապես օգտագործեք `auto` Կոմբինացիա ստեղծելու կարիք չկա։ Ձեր մոդելը սահմանեք որպես `auto` (կամ դրա տարբերակներից մեկը), և OmniRoute-ը ձեր միացված մատակարարներից կկառուցի վիրտուալ կոմբինացիա՝ իրական ժամանակում գնահատելով դրանք.

Մոդելի ID	Ինչի համար է այն օպտիմալացվում
`auto`	🎯 Հավասարակշռված լռելյայն տարբերակ (LKGP՝ պահպանում է կապը ձեր վերջին հաջող մատակարարի հետ)
`auto/coding`	🧑💻 Կոդի գեներացման համար որակն առաջնահերթ համարող կշիռներ
`auto/fast`	⚡ Նախ՝ ամենացածր ուշացումը
`auto/cheap`	💰 Նախ՝ յուրաքանչյուր թոքենի ամենացածր արժեքը
`auto/subscription`	🎟️ Միայն բաժանորդագրության այն քվոտան, որի համար արդեն վճարում եք՝ խափանման դեպքում փակվում է և երբեք չի անցնում վճարովի պահուստային տարբերակի (ուղեցույց)
`auto/thrifty`	🪜 Նախ՝ փաթեթի քվոտան, այնուհետև աստիճանաբար անցում ամենաէժան վճարովի տարբերակներին՝ վերադառնալով փաթեթին քվոտայի վերականգնումից հետո (ուղեցույց)
`auto/offline`	🔋 Նախ՝ քվոտայի / արագության սահմանաչափի ամենամեծ պաշարը
`auto/smart`	🔭 Նախ՝ որակը + 10% հետազոտում՝ ավելի լավ մոդելներ հայտնաբերելու համար
`auto/lkgp`	📌 Բացահայտ ամրագրում վերջին հայտնի հաջող մատակարարին
`auto/chaos`	🧪 Զուգահեռ բաշխում մոդելների խմբին (յուրաքանչյուր մատակարարից՝ մեկական, լռելյայն՝ 5), որը վերադարձնում է մեկ պատասխան․ խմբի յուրաքանչյուր մոդելի համար կատարվում է մեկ վերին հոսքի կանչ, սա խափանումների ներարկում չէ

## ### 🔀 Կամ ստեղծեք ձերը՝ երթուղավորման 20 ռազմավարությամբ Բոլոր **20** ռազմավարությունները՝ համադրեք ըստ ցանկության կոմբինացիայի յուրաքանչյուր քայլում.

#	Ռազմավարություն	Ինչ է այն անում
1	`priority`	Ըստ առաջին թիրախի դասավորված ցանկ՝ սպառել յուրաքանչյուրն ամբողջությամբ՝ հաջորդին անցնելուց առաջ 🥇
2	`fill-first`	Յուրաքանչյուր թիրախի քվոտան ամբողջությամբ լրացնել՝ հաջորդին անցնելուց առաջ
3	`weighted`	Կշռված պատահական ընտրություն՝ ըստ յուրաքանչյուր թիրախի կշռի
4	`round-robin`	Թիրախների հերթական շրջանցում
5	`p2c`	Բեռի պատահական հավասարակշռում՝ երկու ընտրության մեթոդով
6	`least-used`	Ընտրել ընթացիկ ամենացածր բեռնվածությամբ թիրախը
7	`random`	Հավասարաչափ պատահական ընտրություն (առանց կրկնօրինակների)
8	`strict-random`	Պատահական ընտրություն՝ առանց կրկնությունները հեռացնելու 🎲
9	`cost-optimized`	Նվազագույնի հասցնել յուրաքանչյուր հարցման $ արժեքը՝ ըստ կատալոգի ընթացիկ գնագոյացման 💸
10	`headroom`	Ընտրել ամենամեծ մնացորդային քվոտայով թիրախը
11	`quota-weighted`	Բաց թողնել սպառված հաշիվները, ապա ընտրել մնացած քվոտա ÷ ընթացիկ բեռ հարաբերությանը համամասնորեն․ առկա խոսակցությունները մնում են ամրագրված ⚖️
12	`reset-window`	Նախընտրել այն թիրախը, որի քվոտայի պատուհանն ամենաշուտն է վերականգնվում
13	`reset-aware`	Դասակարգել ըստ քվոտայի վերականգնման ժամանակի՝ նախ կարճ պատուհանները 📊
14	`context-relay`	Երկար խոսակցությունների համար համատեքստը փոխանցել թիրախների միջև 🧠
15	`context-optimized`	Ընտրել ընթացիկ համատեքստի չափին լավագույնս համապատասխանող տարբերակը
16	`cache-optimized`	Յուրաքանչյուր վերօգտագործելի հուշման նախածանց ամրագրել նույն հաշվին՝ առավելագույնի հասցնելով հուշումների քեշի համընկնումները 🎯
17	`lkgp`	Վերջին հայտնի հաջող ուղի՝ ամրագրում է վերջին հաջող մատակարարին, ապա անհրաժեշտության դեպքում անցնում կանոններով որոշվող պահուստային տարբերակներին
18	`auto`	Իրական ժամանակի 16-գործոն գնահատում բոլոր միացումների միջև 🤖
19	`fusion`	Բաշխում մոդելների խմբին + դատավոր, որը համադրում է մեկ պատասխան 🧬
20	`pipeline`	Քայլերի շղթա՝ յուրաքանչյուր թիրախի ելքը փոխանցվում է հաջորդին 🔗

_{Auto-Combo շարժիչը յուրաքանչյուր թեկնածուին գնահատում է **16 գործոնով** (աշխատունակություն, քվոտա, արժեք, ուշացում, առաջադրանքին համապատասխանություն, որակ, սեսիայի հասանելիություն…) — տե՛ս [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md)։} ## ### 🧱 Դիմակայունությունը ներկառուցված է (3 անկախ շերտ)

OmniRoute-ի դիմակայունություն՝ ինքնավերականգնման 3 անկախ շերտ, ճիշտ շերտը՝ ճիշտ խափանման համար։ Շերտ 1՝ մատակարարի circuit breaker (ամբողջ մատակարարը). գործարկվում է միայն 408/5xx դեպքերում, շեմերը՝ OAuth 8× / API-key 12× / տեղային 2×, 60s/30s/15s անց անցնում է HALF-OPEN փորձարկման, ծույլ վերականգնում. OPEN վիճակում combo-ն երթուղին փոխում է դեպի հաջորդ մատակարարը։ Շերտ 2՝ կապի cooldown (մեկ բանալի/հաշիվ). բազային արժեքը՝ 5s OAuth / 3s API-key, էքսպոնենցիալ ×2 հետքայլ՝ միաժամանակյա հարցումների հեղեղից պաշտպանության մեխանիզմով, 429-ը հարգում է Retry-After-ը, հաջողությունը մաքրում է սխալների ամբողջ վիճակը. սառեցման մեջ գտնվող մեկ բանալին բաց է թողնվում, մինչդեռ մյուս բանալիները շարունակում են սպասարկել։ Շերտ 3՝ մոդելի արգելափակում (մեկ մոդել). յուրաքանչյուր մոդելի 429-ը, տեղային 404-ը կամ ռեժիմի մերժումները արգելափակում են միայն տվյալ մոդելը, ոչ երբեք ամբողջ կապը։ Վերջնական վիճակները (արգելափակված, ժամկետանց, սպառված կրեդիտներ) նախատեսված են օպերատորի միջամտության համար, ոչ թե cooldown-ների։

_{📖 [Auto-Combo շարժիչ](docs/routing/AUTO-COMBO.md) · [Դիմակայունության ուղեցույց](docs/architecture/RESILIENCE_GUIDE.md)}

## 🏆 Ինչով է առանձնանում OmniRoute-ը

_{📊 Ամբողջական մեթոդաբանությունն ու յուրաքանչյուր հնարավորության մանրամասները՝ 9router-ի, OpenRouter-ի, CLIProxyAPI-ի և LiteLLM-ի համեմատությամբ → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)}
## 💚 Աջակցեք OmniRoute-ին OmniRoute-ը տարածվում է MIT արտոնագրով և բաց կերպով սպասարկվում է։ Եթե այն խնայում է ձեր ժամանակը կամ գումարը, ահա թե ինչպես կարող եք օգնել, որ այն անկախ մնա․ ընտրեք ձեզ հարմար տարբերակը։ Հովանավորությունը երբեք չի ազդում երթուղավորման առաջնահերթության վրա․ այն ապահովում է տեսանելիություն, ոչ թե վարկանիշ։

⭐ Աստղ տվեք պահոցին	Անվճար է և իսկապես օգնում է տեսանելիությանը	Աստղ տվեք OmniRoute-ին
🐙 GitHub Sponsors	Միանվագ կամ ամսական · հարթակի միջնորդավճար՝ զրո	github.com/sponsors/diegosouzapw
☕ Ko-fi	Արագ միանվագ նվիրատվություն՝ առանց նվիրատուի գրանցման	ko-fi.com/diegosouzapw
🧋 Buy Me a Coffee	Փոքր, ոչ պաշտոնական աջակցության ժեստ	buymeacoffee.com/diegosouzapw
🖐 Liberapay	Պարբերական · ոչ առևտրային · բաց կոդով	liberapay.com/diegosouzapw
🇧🇷 PIX (Բրազիլիա)	Ակնթարթային, առանց վճարների	բանալին և QR-ը՝ ստորև
₿ Կրիպտոարժույթ	BTC · ETH · USDT-TRC20 · USDC-Solana	հասցեները՝ ստորև

**🇧🇷 PIX** — ակնթարթային, առանց վճարների (Բրազիլիա) OmniRoute-ի PIX QR կոդը

Բանալի (պատահական)՝ `5d865059-bc44-483a-962d-43ceb80126eb` Pix պատճենելու և տեղադրելու կոդը՝ ``` 00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD ```

₿ Կրիպտոարժույթ — BTC · ETH · USDT-TRC20 · USDC-Solana (սեղմեք՝ բացելու համար)

₿ BTC	Bitcoin (SegWit)	`bc1qh00smz004sy85wyl28v77tenkt3ckl6eaep7fd`
Ξ ETH	Ethereum (ERC20)	`0x64Cf6B68A6Ff34288e89172950a2d00102337a84`
₮ USDT	Tron (TRC20)	`TKAF41JpuQrHbKTnsQa9svJE2T192Hvsc2`
$ USDC	Solana	`2emNNZzVVWQc3FQ2wk9M6qXUQmW8AKdjjL174fXR28Tu`

_{⚠️ Յուրաքանչյուր արժույթ ուղարկեք միայն նշված ցանցով․ սխալ ցանցով ուղարկելու դեպքում միջոցները կարող են կորսվել։}

🐛 Սխա՞լ եք գտել կամ կարծիք ունե՞ք։ Բացեք [քննարկում](https://github.com/diegosouzapw/OmniRoute/discussions)։

Նշումներ մշակողների համար․ Մշակողների հարմարության համար նախագիծը npm install/postinstall-ի ընթացքում կարող է ստեղծել տեղային .env ֆայլ։ Այս ֆայլը միտումնավոր անտեսվում է .gitignore-ի միջոցով (տես .gitignore) և երբեք չպետք է ներառվի commit-ում․ եթե այն պատահաբար ներառվել է, փոխարինեք բացահայտված բոլոր գաղտնիքները և հեռացրեք ֆայլը պատմությունից։ Տեղային միջավայրի ֆայլերի և գաղտնիքների կառավարման վերաբերյալ ուղեցույցը տեսեք docs/DEVELOPER-ENVIRONMENT.md-ում։

## 📡 OmniRoute Radar Անվճար մակարդակի հիմնական ցուցանիշը շարունակում է մնալ **~1.62B տոկեն/ամիս**՝ համաձայն վերևում ներկայացված, ընդհանուր պաշարների կրկնօրինակումներից մաքրված կատալոգի։ Մատակարարների՝ գրանցման համար տրամադրվող ժամանակավոր կրեդիտները կարող են առաջին ամսվա ծավալն առանձին բարձրացնել մինչև **~2.22B**։ Radar-ը կամընտիր, ստորագրված կատալոգային վերադիր է նրանց համար, ովքեր ցանկանում են OmniRoute-ի թողարկումների միջև ընկած ժամանակահատվածում ավելի թարմ տեղեկություններ ստանալ անվճար մոդելների հասանելիության մասին․ համայնքային կատալոգը և առկա բոլոր անվճար գործառույթները շարունակում են մնալ անվճար։ Աջակիցները կարող են ստանալ ընթացիկ կատալոգը և օգտվել մատակարարների լրացուցիչ հնարավորություններից։ Դրա առանձին, փոփոխական առավելագույն սահմանաչափը **մոտավորապես առավելագույնը 3B տոկեն/ամիս է**՝ կախված մատակարարների հասանելիությունից։ Այդ սահմանաչափը երաշխիք չէ․ մատակարարները ցանկացած պահի կարող են փոխել քվոտաները, իրավասության չափանիշները, մոդելները կամ տարածաշրջանները։ Radar-ի օգտագործումը կամընտիր է, և այն աշխատում է միայն GET հարցումներով։ OmniRoute-ի հաճախորդը չի վերբեռնում հուշումները, թրաֆիկը, մատակարարների կազմաձևումները, օգտագործման հեռաչափությունը կամ հայտարարությունները փակելու տեղային վիճակը։ Իրավասության չափանիշների և ընթացիկ կատալոգի մասին տեղեկացեք **[radar.omniroute.online/planos](https://radar.omniroute.online/planos)** հասցեում։

## ✨ Ինչ նորություն կա

> **v3.8.20 → v3.8.53** տարբերակների վերջին կարևոր փոփոխությունները։ Ամբողջական պատմությունը՝ [`CHANGELOG.md`](CHANGELOG.md) ֆայլում։ - **⚖️ `quota-weighted` երթուղում** — 20-րդ համակցված ռազմավարությունը բաց է թողնում սպառված հաշիվները, ապա մնացածներից ընտրում է մնացորդային քվոտա ÷ ընթացիկ բեռնվածություն հարաբերությանը համամասնորեն՝ պահպանելով առկա զրույցների ամրակցումը։ → [Ավտոմատ համակցում](docs/routing/AUTO-COMBO.md) - **🧰 Անգլուխ ռեժիմ** — `omniroute serve --headless` հրամանը (կամ `OMNIROUTE_HEADLESS=1`) գործարկում է միայն `/v1/*` միջնորդային շարժիչը՝ անջատելով կառավարման վահանակը և միայն վահանակին վերաբերող ենթահամակարգերը։ → [Անգլուխ ռեժիմ](docs/guides/HEADLESS.md) - **🔎 Մոդելների հայտնաբերում** — `/v1/models`-ը զտում է ըստ հնարավորության, համատեքստի, տեսակի և տեքստի, իսկ `POST /v1/models/query`-ն վերադարձնում է կարճ, դետերմինիստական ընտրանի՝ յուրաքանչյուր բանալու համար նույն տեսանելիությամբ։ → [API տեղեկատու](docs/reference/API_REFERENCE.md) - **🔑 Յուրաքանչյուր բանալու երթուղման կառավարում** — API բանալին ամրակցեք մեկ մոդելի կամ համակցման՝ `forcedModel`-ի միջոցով, ինչպես նաև ատոմար կերպով ավելացրեք կամ հեռացրեք բանալու մոդելներն ու համակցումները (`/api/keys/{id}/access`)։ → [API տեղեկատու](docs/reference/API_REFERENCE.md) · [OpenAPI](docs/openapi.yaml) - **🛡️ PII-ի ավելի ճշգրիտ կառավարում** — ընտրություն ըստ տեսակի, մինչև 20 վավերացված հատուկ քողարկման ձևանմուշ և հայտնաբերման հաշվիչներ ըստ տեսակի․ քողարկումն ինքնին շարունակում է պահանջել կամավոր միացում։ → [Պաշտպանիչ սահմանափակումներ](docs/security/GUARDRAILS.md) - **🌍 67 լեզու** — կառավարման վահանակ, փաստաթղթերի հայելիներ և CLI, ընդ որում `npm run i18n:add-locale` հրամանը մեկ քայլով ամենուր ավելացնում է լեզու։ → [i18n ուղեցույց](docs/guides/I18N.md) - **🎛️ OmniConductor** — մուտքային A2A պատվիրակում ձեր գործակալների խմբին, Conductor-ի հմտություններ Agent Card-ում և կառավարման վահանակի վահանակամաս՝ Faro-ի «սեղմիր և խոսիր» ձայնային զրույցով։ → [A2A սերվեր](docs/frameworks/A2A-SERVER.md) - **🛂 Հարմարվողական ընդունում և գերբեռնվածությունից պաշտպանություն** — մեծածավալ զրույցի հարցումները 503 սխալ վերադարձնելու փոխարեն հերթագրվում են՝ յուրաքանչյուր կապի համար RPM-ի ատոմար սահող վարձակալումներով։ → [Կայունության ուղեցույց](docs/architecture/RESILIENCE_GUIDE.md) - **🗂️ `/v1/models`-ի կանոնական դասավորում** — յուրաքանչյուր մատակարարի համար մեկ անընդհատ, ըստ մատակարարի խմբավորված բլոկ (համակցումները՝ սկզբում ամրակցված), որը կայուն է կատալոգի բոլոր աղբյուրներում։ → [API տեղեկատու](docs/reference/API_REFERENCE.md) - **🗜️ Սեղմման ամրապնդում** — լռելյայն միացված ընդարձակման պաշտպանիչ սահմանափակում, Caveman փաթեթներ DE / FR / JA + չինարենի (wényán) համար, RTK զտիչներ Gradle-ի և .NET-ի համար։ → [Սեղմում](docs/compression/COMPRESSION_ENGINES.md) - **💸 Ազնիվ հաստատագրված արժեք** — բաժանորդագրության / կոդավորման պլանի մատակարարների արժեքը վերլուծական տվյալներում նշվում է որպես **$0**, մինչդեռ բյուջեն, քվոտան և երթուղումը շարունակում են գնահատվել։ → [API տեղեկատու](docs/reference/API_REFERENCE.md) - **⚖️ Քվոտայի համատեղ օգտագործմամբ երթուղում** — ընդհանուր հաշվի քվոտան արդարացիորեն բաժանեք միավորված բանալիների միջև՝ պահպանելով աշխատանքի արդյունավետությունը, որպեսզի չօգտագործվող բաժինները ժամանակավորապես տրամադրվեն մյուսներին։ → [Կայունության ուղեցույց](docs/architecture/RESILIENCE_GUIDE.md) - **🤖 CLI-ի/գործակալի կարգավորում մեկ հրամանով** — գրանցված 15 `setup-*` հրաման․ `omniroute run`-ը գործարկում է 7 CLI (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI), իսկ `omniroute configure`-ն աջակցում է 11 թիրախ՝ մատակարարի և մոդելի ինտերակտիվ ընտրիչով ու յուրաքանչյուր համատեքստի նախընտրելիներով։ → [CLI ինտեգրումներ](docs/guides/CLI-INTEGRATIONS.md) - **🛰️ Հեռակա ռեժիմ** — կառավարեք հեռակա OmniRoute-ը սահմանափակված գործողության տիրույթով տոկենների (`connect` / `contexts` / `tokens`) և VPS տեղադրումների համար նախատեսված `antigravity` OAuth օգնականի միջոցով։ → [Հեռակա ռեժիմ](docs/guides/REMOTE-MODE.md) - **🧭 Ավելի խելացի ավտոմատ երթուղում** — `auto/:` համակցումներ, **Fusion** (մոդելների վահանակ + դատավոր), առաջադրանքը հաշվի առնող երթուղում, յուրաքանչյուր հարցման համար մոդելի / ռեժիմի / USD բյուջեի վերասահմանումներ։ → [Ավտոմատ համակցում](docs/routing/AUTO-COMBO.md) - **🗜️ Ընդլայնելի սեղմում** — համադրվող 12 շարժիչ + Compression Studios՝ LLMLingua-2, երկաստիճան Ultra, omniglyph, յուրաքանչյուր քայլի ճշգրտության սահմանիչ, GCF v3.2, քաշելով վերադասավորելու խմբագրիչ։ → [Սեղմում](docs/compression/COMPRESSION_ENGINES.md) - **🕵️ Թափանցիկ MITM վերծանում (TPROXY)** — որսացեք պրոքսիի միջավայրի փոփոխականներն անտեսող CLI-ները՝ յուրաքանչյուր SNI-ի համար առանձին CA-ով և վստահության պահոցի տեղադրիչով։ → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md) - **💸 Արժեքի հեռաչափություն ամենուր** — `X-OmniRoute-*` արժեքի/օգտագործման վերնագրեր յուրաքանչյուր վերջնակետում, cache-HIT խնայողությունների վերնագիր և յուրաքանչյուր բանալու համար USD ծախսի քվոտաներ։ → [API տեղեկատու](docs/reference/API_REFERENCE.md) - **🧠 Ձեր կողմից կառավարվող հիշողություն** — լռելյայն անջատված, կամավոր միացվող int8 վեկտորային քվանտացում + տիպավորված մարում, յուրաքանչյուր հարցման համար՝ `x-omniroute-no-memory`։ → [Հիշողություն](docs/frameworks/MEMORY.md) - **🛡️ Անվտանգություն** — հուշման ներարկումից պաշտպանություն յուրաքանչյուր LLM երթուղում (red-team թեստերի հավաքածու), կամավոր միացվող հավատարմագրերի քողարկման պաշտպանիչ սահմանափակում (երկու ուղղությամբ էլ թաքցնում է արտահոսած API բանալիները/գաղտնիքները), DuckDuckGo-ի անվճար վեբ որոնում՝ որպես վերջին միջոց, և կառավարման վահանակի համար ընտրովի OIDC մուտքի սահմանափակում (գաղտնաբառով մուտքը միշտ հասանելի է մնում)։ → [Պաշտպանիչ սահմանափակումներ](docs/security/GUARDRAILS.md) - **🖼️ Նոր վերջնակետեր** — `/v1/ocr` (Mistral OCR) և `/v1/audio/translations` (Whisper ոճով) լրացնում են մեդիա հնարավորությունների շրջանակը։ → [API տեղեկատու](docs/reference/API_REFERENCE.md) - **🎨 Պատկերների / տեսանյութերի / ձայնանյութերի գեներացում** — մեկ API մեդիայի համար՝ xAI Grok Imagine և Novita AI տեսանյութեր, ComfyUI, Magnific, Adobe Firefly, Segmind և խոսքի մատակարարներ, ինչպիսին է ElevenLabs-ը։ → [API տեղեկատու](docs/reference/API_REFERENCE.md) - **🌍 Տեղակայում և շահագործում** — հակադարձ պրոքսիի `basePath`, դիտարկիչի լեզվի ավտոմատ հայտնաբերում, սարքերի հետևում ըստ բանալու, առանց root-ի MITM վստահություն, zh-TW տեղայնացում։ → [Միջավայր](docs/reference/ENVIRONMENT.md) - **🤝 Ավելի շատ մատակարարներ և գործակալներ** — ամպային գործակալներ (Codex Cloud, Cursor, Devin, Jules), Grok Build (xAI)՝ դիտարկիչով և OAuth մուտքով, Ollama-ի լիարժեք քարտ, Claude Opus 5 և Sonnet 5, պաշտոնական համագործակցություն Kimi-ի հետ (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… և թարմացված **375 մատակարարից բաղկացած կատալոգ**։ → [Մատակարարներ](docs/reference/PROVIDER_REFERENCE.md) - **📡 Երթուղման թափանցիկություն** — յուրաքանչյուր պատասխան պարունակում է `X-OmniRoute-Decision` վերնագիր, որը նշում է այն սպասարկած ռազմավարությունը/մատակարարին/ուշացումը, նոր `cache-optimized` համակցման ռազմավարությունը և Auto-Combo-ի `cacheAffinity` գործոնը կրկնվող հարցումները վերադարձնում են քեշավորված նախածանցը պահող կապին, իսկ միայն ընթերցման համար նախատեսված `/v1/auto-combo/{channel}/candidates` վերջնակետը ցուցադրում է `auto/*` ալիքի ընթացիկ թեկնածուների հավաքածուն։ → [Ավտոմատ համակցում](docs/routing/AUTO-COMBO.md) - **⚡ Տեղական արտադրողականություն և ենթակառուցվածք** — մեկ սեղմումով տեղական Redis, Cloudflare Workers / Deno Deploy ռելեների տեղակայիչներ, Bifrost և Mux՝ որպես վերահսկվող ներկառուցված ծառայություններ։ → [Ներկառուցված ծառայություններ](docs/frameworks/EMBEDDED-SERVICES.md) - **🧩 Նաև փաթեթում** — փլագինների շրջանակ + մարքեթփլեյս, Omni/Agent/GitHub հմտությունների շրջանակներ, Obsidian պահոցի ինտեգրում (22 MCP գործիք), OpenAI-համատեղելի Batch & Files API-ներ, իմաստային պատասխանների քեշ, գեյմիֆիկացիա առաջատարների աղյուսակներով, ACP գործակալների հայտնաբերում (15 ներկառուցված գործակալ), մատյանների պլանավորված արտահանում BigQuery, `auto/chaos` զուգահեռ բազմամոդելային fan-out, Telegram բոտի կամուրջ, հավելվածի ներսում տարբերակների կառավարիչ և LMArena-ELO անվճար մատակարարների վարկանիշներ։ → [Փաստաթղթեր](docs/README.md)

## 🤖 Համատեղելի CLI-ներ և կոդավորման գործակալներ > Մեկ կազմաձևում՝ `http://localhost:20128/v1`, և **յուրաքանչյուր** AI IDE կամ CLI աշխատում է անվճար ու ցածրարժեք մոդելներով։

_{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

＋ նաև աշխատում է հետևյալների հետ · Agent Deck · Kiro · Command Code · Antigravity · Windsurf · AMP · OpenAI-ի հետ համատեղելի ցանկացած գործիք

_{📖 Յուրաքանչյուր գործիքի կարգավորում բոլոր 37 գործիքների համար (27 CLI Code + 10 CLI գործակալ) → [`docs/reference/CLI-TOOLS.md`](docs/reference/CLI-TOOLS.md) · 🧩 OpenCode հավելում → [`@omniroute/opencode-provider`](https://www.npmjs.com/package/@omniroute/opencode-provider)}

**Գործարկեք աջակցվող ցանկացած CLI OmniRoute-ի միջոցով՝ մեկ հրամանով** — առանց կազմաձևման ֆայլեր ստեղծելու, հավաստագրերը ներարկվում են յուրաքանչյուր գործընթացի համար, իսկ Qwen/Gemini-ն ստանում են ժամանակավոր մեկուսացված տնային պանակ․ ```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" # Կամ ինտերակտիվ կերպով ընտրեք մատակարարն ու մոդելը և ստեղծեք գործիքի սեփական կազմաձևումը․ omniroute configure codex # նաև՝ claude opencode qwen aider goose gemini cline continue kilo 5dive ``` Յուրաքանչյուր հրաման հաշվի է առնում ակտիվ հեռակա համատեքստը (`omniroute connect `), `--dry-run`-ը նախապես ցուցադրում է ճշգրիտ միջավայրի փոփոխականներն ու արգումենտները՝ առանց գործարկման, իսկ `--api-key-env NAME`-ը գաղտնիքները չի պահում ձեր shell-ի պատմության մեջ։ → [CLI ինտեգրումներ](docs/guides/CLI-INTEGRATIONS.md)

## 🌐 375 AI մատակարար — 153-ը կատալոգում նշված են որպես անվճար

> **375 գրանցված մատակարար**՝ ըստ կանոնական chat, media, search, local, cloud-agent և system հավաքածուների, ներառյալ **153-ը, որոնք կրում են `hasFree: true` հայտնաբերման մետատվյալներ**։ Chat մոդելների ռեեստրը ընդգրկում է **239 մատակարար / 3,059 տարբեր մատակարար-մոդել զույգ / 1,475 հում մոդել ID**; առանձին անվճար բյուջեի կատալոգն ունի **467 տող մեկ մոդելի համար**, **34 կրկնվող փուլ** և **51 կրկնվող/առանց բանալու ընդմիշտ անվճար մատակարար**։ Սրանք տարբեր հայտարարներ են ըստ նախագծման. սահմանումները և փուլերով ապակրկնօրինակված հաշվարկները գտնվում են [Provider Reference](docs/reference/PROVIDER_REFERENCE.md) և [Free Tiers](docs/reference/FREE_TIERS.md) փաստաթղթերում։

### 🏢 Բոլոր խոշոր լաբորատորիաները՝ մեկ վերջնակետով

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

_{…և ևս 350+ — յուրաքանչյուր պատկերանշան իրական ժամանակում լուծվում է վահանակի մատակարարների կատալոգից։ 📖 [Provider Reference](docs/reference/PROVIDER_REFERENCE.md)}
### 🆓 Ընդմիշտ անվճար — $0, առանց քարտի

OpenCode Zen _{DeepSeek V4, Nemotron 3 Առանց token-ների սահմանափակման}	Kilo Code _{Auto-router, Tencent Hy3 Ընդմիշտ անվճար}	Requesty _{GPT-OSS 120B, Nemotron Ընդմիշտ անվճար}	SiliconFlow _{DeepSeek V3.2 / R1 Անվճար փաթեթ}	Z.AI GLM _{GLM-4.7 / 4.5-Flash Ընդմիշտ անվճար}	Baidu ERNIE _{ERNIE 4.0 Ընդմիշտ անվճար}
Qoder AI _{Qwen3-Max, Kimi-K2 Անսահմանափակ ԱՆՎՃԱՐ}	Pollinations _{GPT, Llama, Claude Բանալին պետք չէ}	Cloudflare AI _{50+ մոդել 10K neurons/օր}	NVIDIA NIM _{GLM, MiniMax ~40 RPM անվճար}	Cerebras _{GLM 4.7, GPT-OSS Միանվագ $5 վարկ; քարտը պարտադիր է}	OpenRouter _{:free մոդելներ +$10 → ավելի բարձր RPM}

📖 Ամբողջական մեքենայաընթեռնելի կատալոգ → [`docs/reference/PROVIDER_REFERENCE.md`](docs/reference/PROVIDER_REFERENCE.md)

## 🖥️ Որտեղ է աշխատում OmniRoute-ը՝ ամենուր

> Նույն հավելվածը, ձեր սարքը, ձեր կանոնները։ Համընդհանուր npm տեղադրումից մինչև **ձեր հեռախոսը**՝ Termux-ի միջոցով։

Հարթակ	Տեղադրում	Առավելություններ
📦 npm (համընդհանուր)	`npm install -g omniroute`	Մեկ հրաման, ցանկացած ՕՀ
🐳 Docker	`docker run … diegosouzapw/omniroute`	Բազմաճարտարապետական՝ AMD64 + ARM64
🖥️ Աշխատասեղանային (Electron)	`npm run electron:build`	Բնիկ պատուհան + համակարգային սկուտեղ՝ Windows / macOS / Linux
🎩 Ընտրացանկի գոտի (OmniRouteTray)	`brew install --cask zoispag/tap/omniroute-tray`	Վերահսկում և ինքնաշխատ թարմացնում է սերվերը՝ macOS
💪 ARM	բնիկ `arm64`	Raspberry Pi, ARM սերվերներ, Apple Silicon
📱 Android (Termux)	`pkg install nodejs && npx -y omniroute`	Աշխատում է ձեր հեռախոսում, շուրջօրյա, առանց root-ի
📲 PWA	«Ավելացնել գլխավոր էկրանին»	Ամբողջ էկրանով, անցանց, դիտարկիչից տեղադրվող
🧩 OpenCode հավելում	`@omniroute/opencode-provider`	Բնիկ OpenCode ինտեգրում
🤖 VS Code Copilot Chat	տեղադրեք OmniCopilot ընդլայնումը	OmniRoute-ի բոլոր մոդելները Copilot Chat-ի բնիկ ընտրիչում՝ կայուն և Insiders տարբերակներում
🛠️ Սկզբնաղբյուրից	`npm install && npm run dev`	Փոփոխեք և ներդրում կատարեք

_{📖 [Docker-ի ուղեցույց](docs/guides/DOCKER_GUIDE.md) · [Աշխատասեղանային տարբերակ](electron/README.md) · [Ընտրացանկի գոտու սկուտեղ](https://github.com/zoispag/omniroute-tray) · [Termux](docs/guides/TERMUX_GUIDE.md) · [PWA](docs/guides/PWA_GUIDE.md) · [OpenCode](docs/frameworks/OPENCODE.md)}

### 🧩 Նորություն․ OmniRoute-ը՝ VS Code-ի բնիկ Copilot Chat-ում

> Ո՛չ նոր կողագոտի, ո՛չ նոր զրույցի միջերես․ OmniRoute-ի տրամադրած յուրաքանչյուր մոդել հայտնվում է հենց > **Copilot Chat-ի՝ ձեր արդեն օգտագործած մոդելների ընտրիչում**։ VS Code 1.122-ից սկսած՝ մատակարարների մոդելներն աշխատում են > առանց GitHub մուտքի կամ Copilot բաժանորդագրության՝ գործակալի ռեժիմ, գործիքների կանչում և տեսողական մշակում՝ > անվճար։ Տեղադրեք **[OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)** ընդլայնումը, ուղղեք այն ձեր OmniRoute սերվերին (լռելյայն՝ `localhost:20128`), ապա բացեք Copilot Chat → մոդելների ընտրիչ → **Կառավարել մոդելները…** → **OmniRoute**։

Շտեմարան	Հղում	Համատեղելի է
🧩 VS Code Marketplace	Տեղադրել →	VS Code՝ կայուն և Insiders տարբերակներ
🔓 Open VSX Registry	Տեղադրել →	Cursor, Windsurf, VSCodium, Theia, code-server, Gitpod, Antigravity, Kiro…

Խմբագրիչի ներսում բացեք **Ընդլայնումներ** տեսքը, որոնեք **«OmniRoute»**, սեղմեք **Տեղադրել** ․ երկու շտեմարաններում էլ այն աշխատում է նույն կերպ։ Սկզբնաղբյուրը, խնդիրները և հրապարակման գործակարգը հասանելի են [diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot) հասցեում։ _{📖 [VS Code Copilot Chat-ի ուղեցույց](docs/guides/VSCODE-COPILOT.md) — կարգավորում, ընտրիչում ցուցադրվող տվյալներ, կառավարման վահանակը ներդիրում, խնդիրների լուծում}

### 🎩 Նորություն․ OmniRouteTray՝ ձեր անցուղին՝ ընտրացանկի գոտում

> `omniroute serve`-ն առավել լավ է աշխատում, երբ միշտ միացված է։ **[OmniRouteTray](https://github.com/zoispag/omniroute-tray)** > այն վերածում է macOS-ի՝ մեկ անգամ կարգավորվող և այլևս ուշադրություն չպահանջող ընտրացանկի գոտու հավելվածի․ այն գործարկում է սերվերը, շարունակում աշխատեցնել այն > վերագործարկումներից հետո, տեղում թարմացնում է այն և մեկ սեղմումով հասանելի է դարձնում ձեր ընթացիկ տոկենների բյուջեն՝ **առանց > բաց թողնված տերմինալի պատուհանի և առանց մշտապես վերահսկվող `npm install -g omniroute`-ի։** Կառուցված լինելով [Tauri v2](https://v2.tauri.app/)-ով (Rust միջուկով, որի չափը գրեթե աննշան է)՝ այն ներառում է իր սեփական ստորագրված Node 24 գործարկման միջավայրը և կառավարում հավելվածին պատկանող OmniRoute տեղադրումը, ուստի երբեք չի հակասում ձեր համընդհանուր `node`/`bun`-ին։ Այն **օգտագործում է ձեր առկա `~/.omniroute/` կազմաձևը և տվյալների բազան**․ այսպիսով, դա նույն OmniRoute-ն է, որն արդեն գործարկում եք, պարզապես՝ գլխարկով։ 🎩

Ինչ է այն անում	Ինչպես
🟢 Վերահսկում է սերվերը	Ստեղծում է `omniroute serve` գործընթաց, իսկ արդեն աշխատող օրինակը կրկնօրինակելու փոխարեն՝ ընդունում է այն
📊 Ընթացիկ օգտագործումը՝ մեկ հայացքով	Մատակարարների քվոտաների սանդղակներ, Claude-ի աշխատաշրջանի/շաբաթական սահմանաչափեր՝ զրոյացման հետհաշվարկներով, 30-օրյա ծախսերի բաշխում
🔄 Ինքնաշխատ թարմացվում է տեղում	Փուլային տեղադրում, ատոմային փոխարինում, ձախողման դեպքում հետադարձում՝ միշտ ամենանոր թողարկմամբ
🚀 Գործարկում մուտք գործելիս	Ընտրովի գործարկում մուտք գործելիս․ միայն սկուտեղում, առանց dock պատկերակի
🩺 Ստուգում և մատյաններ	Մեկ սեղմումով ախտորոշում և հասանելիություն սերվերի մատյաններին

```sh brew install --cask zoispag/tap/omniroute-tray ``` _{Նախընտրո՞ւմ եք ներբեռնել։ Վերջին .dmg-ը վերցրեք
Թողարկումներ բաժնից։ Սկզբնաղբյուրի կոդը, խնդիրները և հավաքման
փաստաթղթերը հասանելի են zoispag/omniroute-tray-ում։

💛 @zoispag-ի համայնքային նախագիծ է, ոչ թե OmniRoute-ի պաշտոնական թողարկում։}

## 🔒 Մասնավոր և տեղայինն առաջնահերթ

_{📖 [Լիազորում](docs/architecture/AUTHZ_GUIDE.md) · [Պաշտպանիչ սահմանափակումներ](docs/security/GUARDRAILS.md) · [Համապատասխանություն](docs/security/COMPLIANCE.md)}

## 🔌 Ամբողջական CLI + A2A և MCP

> Բացի սերվերից, OmniRoute-ը **հրամանային տողի լիարժեք կառավարման վահանակ** է՝ **80+ հրամաններով**, ինչպես նաև գործակալների բաց արձանագրություններով, որպեսզի AI գործակալը կարողանա այն կառավարել **ինքնուրույն**։ ### ⌨️ Իրական CLI (ոչ միայն `start`) ```bash omniroute # գործարկել gateway-ը և կառավարման վահանակը (պորտ 20128) omniroute chat # ինտերակտիվ TUI զրույցի հաճախորդ (slash հրամաններ՝ /model /combo /skill /memory) omniroute setup # առաջին գործարկման քայլ առ քայլ օգնական omniroute doctor # ախտորոշել մատակարարները, պորտերը և բնիկ կախվածությունները ``` ### 🛰️ Հեռակա ռեժիմ — CLI-ն գործարկեք այստեղ, իսկ OmniRoute-ը՝ VPS-ում OmniRoute-ը սերվերի՞ վրա է։ Կառավարեք այն ձեր նոութբուքից՝ օգտագործելով **նույն CLI-ն**։ Մուտք գործեք մեկ անգամ սահմանափակ իրավասություններով հասանելիության token-ով, որից հետո յուրաքանչյուր հրաման կուղղվի հեռակա սերվերին։ ```bash omniroute connect 192.168.0.15 # գաղտնաբառ → սահմանափակ իրավասություններով token, պահպանվում է որպես context omniroute models # ← գործարկվում է ՀԵՌԱԿԱ սերվերի վրա omniroute configure codex # ← ընտրում է հեռակա model և գրում տեղային Codex profile omniroute tokens create --name ci --scope read # ստեղծում է ավելի նեղ իրավասություններով token-ներ այլ մեքենաների համար omniroute contexts use default # ← վերադառնալ տեղային սերվերին ``` Token-ների իրավասություններն են՝ `read` / `write` / `admin`, իսկ գործընթացներ գործարկող route-երը հասանելի են միայն loopback-ից։ _{📖 [Հեռակա ռեժիմ](docs/guides/REMOTE-MODE.md)}

OmniRoute CLI-ն ցուցադրող անիմացված տերմինալ՝ omniroute providers list, omniroute combo list և omniroute health հրամաններով, որն անցնում է վերին մակարդակի 89 հրամաններով՝ 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 …

### 🤝 Միացրեք գործակալ — և այն ինքնուրույն կկառավարի OmniRoute-ը Հասանելի դարձրեք OmniRoute-ը **MCP**, **A2A**, **REST API**, **webhooks** կամ **հեռակա CLI** միջերեսներով, և ցանկացած ունակ գործակալ (կամ ձեր սեփական կոդը) կստանա ամբողջ gateway-ը՝ routing-ը, մատակարարները, combo-ները, cache-ը, compression-ը և memory-ն ինքնավար կառավարելու հնարավորություն։ Ստորև նշված HTTP endpoint-ները հասանելի են `http://localhost:20128` հասցեում։

Միջերես	Endpoint / հրաման	Օգտագործման նպատակ
🧰 MCP (stdio)	`omniroute --mcp`	Միացրեք Claude Desktop-ին, Cursor-ին կամ ցանկացած MCP client-ի
🌊 MCP (HTTP)	`/api/mcp/stream`	Հեռակա MCP՝ 110 գործիք, 33 scope (կիրարկումը միացվում է ըստ ցանկության), ամբողջական audit trail
📡 MCP (SSE)	`/api/mcp/sse`	Հոսքային MCP transport
🤝 A2A	`/.well-known/agent.json`	Գործակալից գործակալ հաղորդակցություն՝ JSON-RPC 2.0 + SSE, 6 հմտություն
🌐 REST API	`/v1/*`	OpenAI-ի հետ համատեղելի՝ զրույց, embeddings, պատկերներ, աուդիո, OCR
🔔 Webhooks	`/api/webhooks`	Ուղարկեք request-ի / quota-ի իրադարձությունները Slack, Discord, Telegram կամ ցանկացած URL
🛰️ Հեռակա CLI	`omniroute connect`	Կառավարեք հեռակա instance-ը սահմանափակ իրավասություններով հասանելիության token-ների միջոցով

```bash # MCP-ի միջոցով Claude Code-ին տրամադրեք OmniRoute-ի գործիքների ամբողջական հավաքածուն. claude mcp add-server omniroute --type http --url http://localhost:20128/api/mcp/stream ``` _{📖 [MCP սերվեր](docs/frameworks/MCP-SERVER.md) · [A2A սերվեր](docs/frameworks/A2A-SERVER.md) · [Գործակալների արձանագրություններ](docs/frameworks/AGENT_PROTOCOLS_GUIDE.md)}

## 🗜️ Խնայեք 15–95% թոքեններ — ավտոմատ

### 📖 Ինչպես է աշխատում — փայփլայն, ճարտարապետություն և խնայողության հաշվարկ

OmniRoute-ի սեղմման փայփլայն. պատկերազարդ 10,000 թոքենանոց հաճախորդի հարցումն անցնում է 12 կոմպոզիցիոն շարժիչներով՝ Session-Dedup, CCR, Lite, RTK, Responses Tool Output, Headroom, Relevance, Caveman, Aggressive, LLMLingua-2, Ultra և OmniGlyph, և փաստագրված կուտակային օրինակում կարող է հասնել մատակարարին մոտ 1,080 թոքենով։ Կառուցվածքային բովանդակությունը պաշտպանված է պահպանման զսպիչներով և քայլ առ քայլ հավատարմության դարպասներով. բացահայտ կորուստային կամ փորձարարական ռեժիմները կարող են ձևափոխել համապատասխան բովանդակությունը։

Լռելյայն կուտակային կոմբոն գործարկում է `RTK → Caveman`: Երբ երկուսն էլ ազդում են նույն գործիքի/կոնտեքստի բեռնվածքի վրա, խնայողությունները բարդանում են. ```txt combined = 1 − (1 − RTK) × (1 − Caveman_input) average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2% range = 78.4 – 94.6% ``` Կոդի բլոկները, URL-ները, JSON-ը և կառուցվածքային տվյալները **միշտ պաշտպանված են** պահպանման շարժիչի կողմից։ > **Ինչու՞ օգտագործել շատ թոքեններ, երբ քիչ թոքենները բավարարում են։** Յուրաքանչյուր հարցում անցնում է OmniRoute-ի սեղմման փայփլայնով **թափանցիկ կերպով**՝ առանց հաճախորդի փոփոխությունների։ Այն այժմ **12 կոմպոզիցիոն շարժիչների փաթեթ է**, որոնք գործում են հերթականությամբ և խառնվում ու համադրվում են ըստ երթուղման կոմբոյի՝ հիմնվելով [RTK](https://github.com/rtk-ai/rtk)-ի, [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ 90K+), [LLMLingua-2](https://github.com/microsoft/LLMLingua)-ի և [Troglodita](https://github.com/leninejunior/troglodita) (PT-BR)-ի գաղափարների վրա։ ### 🧱 12 շարժիչների փաթեթը Շարժիչները գործում են փայփլայնի հերթականությամբ. յուրաքանչյուրը ինքնուրույն միացվող և կարգավորվող է՝ ըստ կոմբոյի։

#	Շարժիչ	Ինչ է անում
1	Session-Dedup	Հեռացնում է հերթափոխերի ընթացքում կրկնվող բովանդակությունը (բովանդակության հասցեավորված, միջհերթափոխային)
2	CCR	Արխիվացնում է մեծ բլոկները վերականգնման նշիչների հետևում՝ բերվող ըստ պահանջի
3	Lite	Բացատանիշերի + պատկերի URL-ների կրճատում (ցածր հետաձգությամբ բազային)
4	RTK	Գործիքների արդյունքների խելացի զտում, ապակրկնօրինակում և կրճատում (հրամանին տեղյակ)
5	Responses Tool Output	Առաջին հերթին անկորուստ JSON + սահմանափակ ախտորոշիչ սեղմում shell/patch/search/build ելքերի համար (Responses API)
6	Headroom	JSON զանգվածների անկորուստ աղյուսակային խտացում (~30%) ներկառուցված GCF կոդեկի միջոցով
7	Relevance	Էքստրակտիվ նախադասությունների գնահատում վերջին օգտատերական հարցման նկատմամբ
8	Caveman	Կանոնների վրա հիմնված արձակի սեղմում (~65–75% ելքի վրա)
9	Aggressive	Ամփոփում + հին հերթափոխերի աստիճանական հնացում
10	LLMLingua-2	ML իմաստային էտում MobileBERT ONNX-ի միջոցով — կոդի համար անվտանգ, ասինխրոն
11	Ultra	Էվրիստիկ թոքենների էտում՝ փոքր մոդելի (SLM) ըստ ցանկության մակարդակով
12	OmniGlyph	Փորձարարական կոնտեքստ-որպես-պատկեր կոդավորում՝ չափված Claude Fable 5-ի համար ուղիղ Anthropic մետաղալարով. GPT 5.6 տրանսֆորմերները մնում են fail-closed՝ սպասելով մատակարարի անդորրագրերին։ Չորս սեղմման պրոֆիլ (ագրեսիվ լռելյայն, հավասարակշռված, կոդի համար անվտանգ, passthrough) (ամենաագրեսիվը. opt-in)

Կոդի բլոկները, URL-ները և կառուցվածքային տվյալները **միշտ պահպանվում են** բայթ-կատարյալ։ **Մեկ սեղմումով նախակարգավորումները** համադրում են շարժիչները.

Ռեժիմ	Խնայողություն	Լավագույնը
🪶 Lite	~15%	Մշտապես միացված անվտանգ լռելյայն
🪨 Standard (Caveman)	~30%	Ամենօրյա ծրագրավորում
⚡ Aggressive	~50%	Երկար գործիքակենտրոն սեսիաներ
🔥 Ultra	~75%	Առավելագույն խնայողություն
🧰 RTK	60–90%	Shell/test/build/git ելք
🔗 Stacked (RTK → Caveman)	78–95%	Խառը հուշումներ + գործիքների մատյաններ

**Իրական օրինակ — Standard ռեժիմ:** > **Մինչև (69 թոքեն).** _"Ձեր React կոմպոնենտի վերայիրկման պատճառը, հավանաբար, այն է, որ դուք յուրաքանչյուր ցուցադրման ցիկլում ստեղծում եք նոր օբյեկտի հղում։ Երբ որպես prop փոխանցում եք inline օբյեկտ, React-ի մակերեսային համեմատությունը այն տեսնում է որպես տարբեր օբյեկտ ամեն անգամ, ինչը հրահրում է վերայիրկում։ Խորհուրդ եմ տալիս օգտագործել useMemo՝ օբյեկտը մեմոիզացնելու համար։"_ > > **Հետո (19 թոքեն).** _"Նոր օբյեկտի հղում յուրաքանչյուր ցուցադրման ժամանակ։ Inline օբյեկտ prop = նոր հղում = վերայիրկում։ Փաթաթեք useMemo-ով։"_ > > **Նույն պատասխանը։ 72%-ով քիչ թոքեններ։ Զրո ճշգրտության կորուստ։** ✅ **PT-BR օրինակ — [Troglodita](https://github.com/leninejunior/troglodita) ռեժիմ.** > **Առաջ (42 tokens):** _"Խնդիրն այն է, որ կոմպոնենտը կրկին ռենդերվում է, քանի որ յուրաքանչյուր ռենդերի ցիկլում ստեղծվում է օբյեկտի նոր հղում։ Ես խորհուրդ կտայի օգտագործել useMemo։"_ > > **Հետո (12 tokens):** _"Վերա-ռենդեր՝ նոր հղում ամեն ցիկլում (inline օբյեկտը վերստեղծվում է)։ Օգտագործել `useMemo`։"_ > > **Նույն պատասխանը։ ~70%-ով պակաս tokens։ Տեխնիկական ճշգրտությունը անփոփոխ։** ✅
### 🎚️ Շարժիչներից այն կողմ — ելքի ոճեր, հարմարվող կարգավորիչ և հարցում-առ հարցում կառավարում Վերևի 12 շարժիչները նվազեցնում են այն, ինչ **մտնում է**։ Եվս երեք շերտ ձևավորում են **ինչպես**, **երբ** և ինչ է **դուրս գալիս**։ - **🪄 Ելքի ոճեր** _(ելքի առանցքի կառավարում)_ — ներարկում են դետերմինիստական, քեշի համար անվտանգ պատասխան-ձևավորող հրահանգներ. համակցելի են, յուրաքանչյուրը՝ `lite` / `full` / `ultra` ինտենսիվությամբ։ Ոճ ավելացնելը ռեեստրի մեկ տողանոց գրառում է. - **Հակիրճ արձակ** — հեռացնել լցոնը / հոդերը / երկմտանքը. պահել տեխնիկական էությունը ճշգրիտ։ - **Ավելի քիչ կոդ** — «ծույլ ավագ ծրագրավորող» YAGNI. ամենափոքր աշխատող փոփոխությունը, առանց չպահանջված կառուցվածքի։ - **Ponytail (ծույլ ավագ ծրագրավորող)** — բարձրանալ YAGNI սանդուղքով, շտկել արմատական պատճառը, ամենափոքր աշխատող դիֆը։ - **Ես ADHD ունեմ (գործողություն-առաջին)** — հաջորդ գործողությունը գլխավորում է, քայլերը համարակալված, մեկ կոնկրետ հաջորդ քայլ, առանց նախաբանի։ - **Հակիրճ CJK (文言)** — դասական-չինարեն գերհակիրճ ոճ (լոկալիզացված `zh`-ի համար)։ - **🎯 Հարմարվող context-budget** _(կարգավորիչը)_ — մեկ միացված/անջատված token շեմի փոխարեն աստիճանաբար միացնել ամենաէժան, ամենաանկորուստ շարժիչները միայն այնքան, որքան անհրաժեշտ է **տեղավորվելու մոդելի context պատուհանում**։ Քաղաքականություն՝ `reserve-output` (կանխադրված, մոդելին տեղյակ) · `percentage` · `absolute`։ Ռեժիմ՝ `floor` (երաշխավորել տեղավորումը) · `replace-autotrigger` (ձեր բացահայտ ընտրությունը հաղթում է) · `off` (հին շեմ)։ - **🎛️ Որտեղ է որոշվում սեղմումը** _(գերակայություն, բարձր → ցածր)_ — հարցում-առ `x-omniroute-compression` վերնագիր › երթուղային-համակցության վերագրանցում › ակտիվ անվանված պրոֆիլ › հարմարվող / ինքնա-գործարկում › պանելի կանխադրված › անջատված։ Կիրառված պլանը հետ է արտացոլվում `X-OmniRoute-Compression: ; source=` պատասխանի վերնագրում։ Ինքնա-գործարկում token շեմով, հարմարվող կարգավորիչի միացում, անվանված պրոֆիլի ամրագրում, մեկանգամյա հարցում-առ կարգավորում կամ pipeline-ի նշանակում յուրաքանչյուր երթուղային համակցության համար — ինչը որ համապատասխանում է աշխատանքային ծանրաբեռնվածությանը։ Օպցիոնալ օֆլայն **eval harness** (`npm run eval:compression`) գնահատում է ճշգրտությունը ընդդեմ խնայողության ամրագրված կորպուսի վրա, նախքան փոփոխությունը առաջ տանելը։ 📖 [`COMPRESSION_GUIDE.md`](docs/compression/COMPRESSION_GUIDE.md) · [`RTK_COMPRESSION.md`](docs/compression/RTK_COMPRESSION.md) · [`COMPRESSION_ENGINES.md`](docs/compression/COMPRESSION_ENGINES.md)

# ⚡ Արագ մեկնարկ

**1) Տեղադրել և գործարկել** ```bash npm install -g omniroute omniroute ``` > 💡 Տեսնո՞ւմ եք `npm warn ERESOLVE` կամ peer-dep նախազգուշացումներ։ [Դրանք անվնաս են](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated)։ > **Օգտագործո՞ւմ եք npm 11 կամ ավելի նոր։** npm-ը կարող է արգելափակել փաթեթների lifecycle սկրիպտները, եթե դրանք թույլատրված չեն։ OmniRoute-ի `postinstall`-ը (`node scripts/build/postinstall.mjs`) անհրաժեշտ է իր native runtime ֆայլերը պատրաստելու համար։ Գլոբալ տեղադրման ժամանակ թույլատրեք npm-ի նախազգուշացման մեջ նշված փաթեթները։ OmniRoute 3.8.53-ի հաղորդած փաթեթների հավաքածուի համար. > > ```bash > npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute > ``` > > Այս թույլատրելի ցանկը ապագա գլոբալ տեղադրումների համար վերօգտագործելու համար կարգավորեք այն մեկ անգամ, ապա տեղադրեք սովորական ձևով. > > ```bash > npm config set allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild --location=user > npm install -g omniroute > ``` > > Կախվածությունների ցանկը կարող է փոխվել թողարկումների միջև. եթե npm-ը հաղորդում է այլ ցանկ, օգտագործեք այդ նախազգուշացման փաթեթների անունները։ Փաթեթին թույլատրելը թույլ է տալիս նրա install սկրիպտներին աշխատել։ > **Օգտագործո՞ւմ եք Gemini Web կամ այլ web-cookie պրովայդեր։** npm փաթեթը ներառում է > Playwright, բայց ոչ նրա Chromium binary-ն։ Տե՛ս > [Playwright Chromium տեղադրում](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium) > նշումը նախքան առաջին web-provider հարցումը կատարելը։ Dashboard-ը՝ `http://localhost:20128` · API-ն՝ `http://localhost:20128/v1`։ **2) Միացրեք համապատասխան պրովայդեր՝ օգտագործելով ձեր սեփական հաշիվը** Dashboard → **Providers** → ընտրեք պրովայդեր, որի ընթացիկ պայմաններն ու քվոտան համապատասխանում են ձեր օգտագործման դեպքին → ավելացրեք նրա API բանալին կամ ավարտեք նրա հաշվի հոսքը։ Անվճար փաթեթները կարող են պահանջել գրանցում, հաստատում կամ վճարման եղանակ։ Ծանոթացե՛ք [Անվճար փաթեթների ուղեցույցին](docs/getting-started/FREE-TIERS-GUIDE.md). առանց բանալու հասանելիությունը երաշխավորված չէ, և `tos: avoid` նշված պրովայդերները լռելյայն բացառվում են `auto`-ից։ **3) Ուղղեք ձեր կոդավորման գործիքը** ```txt Base URL: http://localhost:20128/v1 API Key: [copy from Dashboard → Endpoints] Model: auto (routes among eligible connections — or choose provider/model) ``` **4) Ստուգեք, որ այն աշխատում է** ```bash curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY" ``` Դուք պետք է տեսնեք ձեր միացված մոդելների ցանկը։ 🎉 Վե՛րջ — սկսեք կոդավորել, և OmniRoute-ը ինքնաշխատ ուղղորդում և fallback է անում ձեզ համար։ Եթե ձեր client-ը չի կարող ուղարկել հատուկ վերնագրեր, OmniRoute-ը նաև տրամադրում է tokenized համատեղելիության alias-ներ. ```txt OpenAI catalog: http://localhost:20128/vscode/YOUR_KEY/ OpenAI models: http://localhost:20128/vscode/YOUR_KEY/models OpenAI chat: http://localhost:20128/vscode/YOUR_KEY/chat/completions OpenAI responses: http://localhost:20128/vscode/YOUR_KEY/responses Ollama chat: http://localhost:20128/vscode/YOUR_KEY/api/chat Ollama tags: http://localhost:20128/vscode/YOUR_KEY/api/tags ``` Օգտագործե՛ք դրանք միայն այն client-ների համար, որոնք չեն կարող կցել `Authorization: Bearer ...`։ Վերնագրով նույնականացումը մնում է նախընտրելի ռեժիմը։
## 📦 Տեղադրման լրացուցիչ եղանակներ — Docker, սկզբնական կոդ, 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`-ը հետևում է ամենաբարձր **հրապարակված** կայուն SemVer տարբերակին։ Այն չի հետևում git-ի `main` ճյուղին։ GitOps-ի համար ամրագրեք `:X.Y.Z` տարբերակը։ Տե՛ս [Docker-ի թողարկման ալիքները](docs/guides/DOCKER_GUIDE.md#release-channels)։ Պատկերում ամրագրված է **`OMNIROUTE_MEMORY_MB=1024`**։ Դա բավարար է կառավարման վահանակի և թեթև զրույցի համար։ **Կոդավորման գործակալներին** (Claude Code-ից, Codex-ից, Grok-ից և այլն ուղարկվող `POST /v1/responses`) անհրաժեշտ է շատ ավելի մեծ V8 heap, այլապես երկու համընկնող երկար համատեքստերի դեպքում պրոցեսը մոտավորապես 12 GiB-ի սահմանում ավարտվում է `FATAL ERROR`-ով։ Կոնտեյների չափը սահմանեք heap-ից մեծ (բնական բուֆերները գտնվում են V8-ից դուրս)։ | Աշխատաբեռնվածություն | Heap (`-e OMNIROUTE_MEMORY_MB`) | Կոնտեյներ (`--memory`) | | ---------------------------------------- | -------------------------------- | ---------------------- | | Կառավարման վահանակ / թեթև զրույց | `1024` (պատկերի լռելյայն արժեքը) | ≥2 g | | Մեկ կոդավորման գործակալ | `8192` | ≥10 g | | Երկու միաժամանակյա երկար `/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 ``` Ամբողջական աղյուսակը՝ [Docker-ի ուղեցույց — կատարման ժամանակի RAM](docs/guides/DOCKER_GUIDE.md#runtime-ram-for-coding-agents)։ > **Docker-ի նախաթողարկման ալիք.** `diegosouzapw/omniroute:next` և > `diegosouzapw/omniroute:next-web` թեգերը հետևում են ընթացիկ լռելյայն `release/v*` > ճյուղին։ Այս փոփոխական թեգերը նախատեսված են միայն դեռ չթողարկված ուղղումները փորձարկելու համար և > **չեն աջակցվում արտադրական միջավայրում**։ Տե՛ս > [Docker-ի թողարկման ալիքները](docs/guides/DOCKER_GUIDE.md#release-channels)։ **🥟 Bun** Ստանդարտ `bun install`-ը և գլոբալ տեղադրումը (`bun install -g omniroute`) աջակցվում են Bun-ի կատարման միջավայրի հայտնաբերման միջոցով։ - **Ներկառուցված `bun:sqlite`**. Bun-ի ներքո աշխատելիս OmniRoute-ն օգտագործում է Bun-ի ներկառուցված `bun:sqlite` դրայվերը՝ Node.js-ի դեպքում անցնելով `better-sqlite3`-ի կամ `sql.js`-ի։ - **Մշակման ընթացքում Webpack փաթեթավորիչի ավտոմատ ընտրություն**. Մշակման ռեժիմը (`bun run dev`) ավտոմատ հայտնաբերում է Bun-ը և Turbopack-ն անջատում է հօգուտ Webpack-ի՝ բնական V8 կապակցումների անհամատեղելիությունները կանխելու համար։ Արտադրական կառուցումները (`bun run build`) հետևում են `OMNIROUTE_USE_TURBOPACK`-ին ճիշտ այնպես, ինչպես Node-ում՝ լռելյայն օգտագործելով Turbopack, իսկ Webpack-ով կառուցելու համար՝ `OMNIROUTE_USE_TURBOPACK=0` (`Dockerfile.bun`-ն այն հասանելի է դարձնում որպես `--build-arg`)։ - **Bun-ի համար նախատեսված Dockerfile**. Բազմափուլ `Dockerfile.bun`՝ Bun-ի բնական արտադրական տեղակայումների համար (`docker build -f Dockerfile.bun -t omniroute:bun .`)։ ```bash # Տեղադրեք և գործարկեք Bun-ով bun install bun run dev ``` **🛠️ Սկզբնական կոդից** ```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-ի օգտագործմամբ nix develop npm run dev # Կամ devbox-ի օգտագործմամբ devbox run npm run dev ``` 📖 [Docker-ի ուղեցույց](docs/guides/DOCKER_GUIDE.md) — Compose պրոֆիլներ, Caddy HTTPS, Cloudflare թունելներ։ **🦭 Podman** ```bash # 1. Պատրաստեք bind mount-ով միացվող տվյալների պանակը mkdir -p data # 2. Միայն Linux + տեղային rootless Podman (երբեք ոչ հեռավար Podman Machine հաճախորդ). podman unshare chown 1000:1000 ./data # 3. Սահմանեք կատարման միջավայրի հուշումը, կառուցեք տեղային Compose պատկերը և գործարկեք echo "CONTAINER_HOST=podman" >> .env podman compose --profile base up -d --build ``` macOS-ում կամ Windows-ում Podman-ն օգտագործում է հեռավար Podman Machine. բաց թողեք `podman unshare`-ը և հետևեք [տոպոլոգիային հատուկ տվյալների պանակի ցուցումներին](contrib/podman/README.md#data-directory-permissions-by-topology)։ 📖 [Podman-ի ուղեցույց](contrib/podman/README.md) — Compose կառուցումներ, Podman Machine և Linux/systemd Quadlet-ի կարգավորում։ **⚡ Ավելի արագ / թեթև տեղադրում (բաց թողեք բնական կառուցումը)** Բնական SQLite շարժիչը (`better-sqlite3`) **ընտրովի** կախվածություն է, ուստի գլոբալ տեղադրումը երբեք չի արգելափակվում սկզբնական կոդից կոմպիլյացիայի պատճառով. այն օգտագործում է նախապես կառուցված բինար ֆայլ, երբ առկա է ձեր հարթակին/Node-ին համապատասխանող տարբերակ, իսկ հակառակ դեպքում աննկատ անցնում է զուտ JS շարժիչի (Node 22+-ում՝ `node:sqlite`, այլապես՝ փաթեթում ներառված `sql.js` WASM)՝ առանց կառուցման գործիքների անհրաժեշտության։ Հետտեղադրման բնական նախապատրաստումն ամբողջությամբ բաց թողնելու համար (CI, առանց գրաֆիկական միջավայրի կամ դանդաղ մեքենաներում)՝ ```bash OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute # CI=1-ը նույնպես բաց է թողնում այն ``` Ամենաարագ տեղադրումների համար նախընտրեք **pnpm**-ը (բովանդակությամբ հասցեագրվող պահոց + կոշտ հղումներ՝ տե՛ս վերևում)։ Առանց կառավարման վահանակի, առանց գրաֆիկական միջավայրի կատարման համար օգտագործեք Docker-ի `base` պրոֆիլը (վերևում) կամ [Termux-ի ուղեցույցը](docs/guides/TERMUX_GUIDE.md)։ CLI-ն և վեբ կառավարման վահանակը սպասարկվում են նույն պրոցեսի կողմից՝ մեկ պորտով, ուստի ներկայում առանձին՝ միայն CLI-ի համար նախատեսված փաթեթ չկա։

# 🎬 OmniRoute-ը գործողության մեջ

## 📹 Տեսաուղեցույցներ

_{Վահանակի պատկերը՝ 2026-10-18-ի դրությամբ · Չմշակված կատալոգ՝ YT 1.352 | TT 334 | IG 290 · Թարմություն (օրերով)՝ YT 5 | TT 48 | IG 49}

🎬 #1 — Instagram
_{nick_saraev — 3,042,474 դիտում}

🎬 #2 — Instagram
_{nnapier7 — 1,454,535 դիտում}

🎬 #3 — YouTube
_{Amidia AI & Tech — 794,974 դիտում}

🎬 #4 — Instagram
_{theopenstack — 692,419 դիտում}

🎬 #5 — TikTok
_{migue.baena — 685,788 դիտում}

**Ամբողջական վարկանիշ (ապակրկնօրինակված կանոնական URL-ներ, `v > 0`, առավելագույն հասանելիություն).** | #1 | #2 | #3 | #4 | #5 | | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | | [nick_saraev — Instagram](https://www.instagram.com/reel/Da8ZthUPK98/) — **3,042,474** | [nnapier7 — Instagram](https://www.instagram.com/reel/Dbp7wv_CIO0/) — **1,454,535** | [Amidia AI & Tech — YouTube](https://www.youtube.com/watch?v=NJ0TQ-pyMDY) — **794,974** | [theopenstack — Instagram](https://www.instagram.com/reel/DaSs65mMrHk/) — **692,419** | [migue.baena — TikTok](https://www.tiktok.com/@migue.baena/video/7670919268216622358) — **685,788** | | #6 | #7 | #8 | #9 | #10 | | ------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | | [milesreevesai — TikTok](https://www.tiktok.com/@milesreevesai/video/7667980059189366019) — **620,400** | [nikothetech — TikTok](https://www.tiktok.com/@nikothetech/video/7671890769665477918) — **610,803** | [Vaibhav Sisinty — YouTube](https://www.youtube.com/watch?v=QucgvbO5gsM) — **509,281** | [buildwithai.club — Instagram](https://www.instagram.com/reel/DbIt9AjK7-U/) — **347,652** | [nivedan.ai — Instagram](https://www.instagram.com/reel/DbIrCksJiqq/) — **331,973** | Կանոնական չափանիշները՝ 2026-10-18-ի դրությամբ. **1.976 եզակի տեսանյութ** · **20.220.289 հայտնի դիտում** (`v > 0`) · **1.210 ալիք/պրոֆիլ՝ ըստ հարթակի**։ Չմշակված վահանակը պարունակում է 1.976 տող (YouTube 1.352 = 740 երկար տեսանյութ + 612 Shorts · TikTok 334 · Instagram 290)։ Կանոնական URL-ով նորմալացումից հետո կրկնօրինակներ չեն մնացել. յուրաքանչյուր տեսանյութի համար պահպանվել է դիտումների ամենամեծ քանակը։ YouTube-ի տվյալների հավաքումը սառեցված է 2026-10-13-ից (API-ի քվոտան սպառվել է 14-ից մինչև 18/10), իսկ TikTok/Instagram-ինը՝ 2026-09-02-ից (տվյալների հավաքման կրեդիտներ չկան)։ 76 տեսանյութի դիտումների քանակը դեռևս բացակայում է։ > 🎬 **Տեսանյութ պատրաստե՞լ եք OmniRoute-ի մասին։** Բացեք [խնդիր](https://github.com/diegosouzapw/OmniRoute/issues/new) կամ [քննարկում](https://github.com/diegosouzapw/OmniRoute/discussions)՝ ավելացնելով հղումը. մենք այն կներկայացնենք այստեղ։

# 📧 Համայնք և օգնություն > Ամեն ինչ մեկ վայրում՝ հետևեք նախագծի սպասարկողին, զրուցեք համայնքի հետ կամ բացեք խնդիր։ | Ալիք | Որտեղ / ինչպես | | ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ | | 💼 **LinkedIn** — հետևեք սպասարկողին | [linkedin.com/in/diegosouzapw](https://www.linkedin.com/in/diegosouzapw/) | | 🐙 **GitHub** — հետևեք թողարկումներին և խորհուրդներին | [@diegosouzapw](https://github.com/diegosouzapw) | | 💬 **Discord** | [discord.gg/U47eFqAXCn](https://discord.gg/U47eFqAXCn) | | ✈️ **Telegram** | [t.me/omnirouteOficial](https://t.me/omnirouteOficial) | | 🟢 **WhatsApp — 🌍 Գլոբալ** | [միանալ խմբին](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) | | 🟢 **WhatsApp — 🇧🇷 Բրազիլիա** | [միանալ խմբին](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) | | 🌍 **Կայք** | [omniroute.online](https://omniroute.online) | | 🌍 **🌍StHub OmniRoute համայնք (անվճար)** | [StHub հարթակ](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK) | | 📦 **Սկզբնական կոդ** | [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute) | | 🐛 **Հաղորդել սխալի մասին** | [բացել խնդիր](https://github.com/diegosouzapw/OmniRoute/issues) — կցեք `npm run system-info` հրամանի արդյունքը | | 🤝 **Ներդրում կատարել** | [CONTRIBUTING.md](CONTRIBUTING.md) · [Ճյուղավորման և թողարկման մոդել](docs/ops/BRANCHING_MODEL.md) · ընտրեք `good first issue` | | 💚 **Աջակցել նախագծին** | [Աջակցության եղանակներ ↑](#-support-omniroute) · [GitHub Sponsors](https://github.com/sponsors/diegosouzapw) |

---

## 🛠️ Տեխնոլոգիական փաթեթ

Շերտ	Տեխնոլոգիա
Գործարկման միջավայր	Node.js 22.x / 24.x LTS — `>=22.22.2 <23 \|\| >=24.0.0 <27`
Լեզու	TypeScript 6.0 — 100% TypeScript `src/` և `open-sse/` գրացուցակներում (զրո `any` միջուկում՝ v2.0-ից ի վեր)
Շրջանակ	Next.js 16 + React 19 + Tailwind CSS 4
Տվյալների բազա	better-sqlite3 (SQLite, WAL ժուռնալավորում) + LowDB (JSON ժառանգություն) — 147 դոմենային մոդուլ, 209 միգրացիա
Հիշողություն	SQLite FTS5 ամբողջական տեքստ + int8-քվանտացված վեկտորային ներկառուցումներ, տիպավորված decay
Սխեմաներ	Zod 4 — MCP գործիքի I/O վալիդացիա + API պայմանագրեր
Արձանագրություններ	MCP (stdio / HTTP / SSE) + A2A v0.3 (JSON-RPC 2.0 + SSE)
Հոսքային հաղորդում	Server-Sent Events (SSE) + WebSocket կամուրջ (`/v1/ws`)
Սեղմում	12-շարժիչ խողովակաշար — RTK, Caveman, LLMLingua-2 (MobileBERT ONNX), GCF, OmniGlyph
Նույնականացում և անվտանգություն	OAuth 2.0 (PKCE) + JWT + API բանալիներ + MCP սկոպավորված նույնականացում · AES-256-GCM պահեստում · DOMPurify
Գաղտնիություն	wreq-js — JA3 / JA4 TLS մատնահետքի իմիտացիա, 3 մակարդակի պրոքսի
Կայունություն	Անջատիչ (circuit breaker), էքսպոնենցիալ հետաձգում, հակա-բազմակի հարձակում, auto-combo ինքնավերականգնում
Մատյանագրում	pino — կառուցվածքավորված JSON մատյաններ հարցման կոնտեքստով
Թեստավորում	Node.js թեստային վազորդ + Vitest — 56,000+ ստատիկ թեստային հայտարարություն 7,800+ հետևվող թեստային ֆայլերում (մոդուլ, ինտեգրացիա, E2E, անվտանգություն, էկոհամակարգ)
Հարթակներ	Սեղանային (Electron) · Android (Termux) · PWA (ցանկացած բրաուզեր)
CI/CD	GitHub Actions — ավտոմատ npm հրապարակում + Docker Hub թողարկման պահին
Հղումներ	Վեբկայք · npm · Docker Hub

## 📖 Փաստաթղթավորում

### 📘 Սկիզբ

Փաստաթուղթ	Նկարագրություն
Օգտատիրոջ ուղեցույց	Մատակարարներ, կոմբոներ, CLI ինտեգրացիա, տեղակայում
Տեղադրման ուղեցույց	Տեղադրման ամբողջական եղանակներ, CLI գործիքների կոնֆիգուրացիաներ, արձանագրության կարգավորում, timeout-ի կարգաբերում
CLI գործիքների ուղեցույց	Գործիք առ գործիք կարգավորում Claude Code-ի, Codex-ի, Cursor-ի, Cline-ի, OpenClaw-ի, Kilo-ի, Copilot-ի համար
Հեռավոր ռեժիմ	Կառավարեք հեռավոր OmniRoute-ը (VPS) ձեր նոթբուքից CLI-ի միջոցով՝ սահմանափակված հասանելիության թոքեններով
Claude Code-ի կոնֆիգուրացիա	Ուղղորդեք Claude Code-ը դեպի OmniRoute (լոկալ/հեռավոր) `launch`-ի + մոդել առ մոդել պրոֆիլների միջոցով
Արագ սկիզբ	3 քայլ. տեղադրում → միացում → կարգավորում

### 🔧 Գործառնություններ և տեղակայում

Փաստաթուղթ	Նկարագրություն
Docker-ի ուղեցույց	Docker run, Compose պրոֆիլներ, Caddy HTTPS, թունելներ, image թեգեր
Podman-ի ուղեցույց	Quadlet systemd ինտեգրացիա, podman-compose, SELinux
VM-ի տեղակայում	Ամբողջական ուղեցույց. VM + nginx + Cloudflare կարգավորում
Fly.io-ի տեղակայում	Տեղակայեք Fly.io-ում՝ մշտական պահոցով
Termux-ի ուղեցույց	Աշխատեցրեք OmniRoute-ը Android-ում Termux-ի միջոցով
PWA ուղեցույց	Progressive Web App-ի տեղադրում, քեշավորում, ճարտարապետություն
Ապատեղադրման ուղեցույց	Մաքուր հեռացում տեղադրման բոլոր եղանակների համար
Միջավայրի կոնֆիգուրացիա	Ամբողջական `.env` փոփոխականներ և հղումներ

### 🧠 Հնարավորություններ և ճարտարապետություն

Փաստաթուղթ	Նկարագրություն
Ճարտարապետություն	Համակարգի ճարտարապետություն, տվյալների հոսք և ներքին կառուցվածք
Սեղմման ուղեցույց	7 տարբերակով փայփլայն. off / lite / standard / aggressive / ultra / RTK / stacked
RTK սեղմում	Հրամանի ելքի սեղմում, զտիչներ, վստահություն, ստուգում, չմշակված ելքի վերականգնում
Սեղմման շարժիչներ	Caveman, RTK, կուտակված փայփլայններ, dashboard/API/MCP մակերեսներ
Սեղմման կանոնների ձևաչափ	JSON կանոնների փաթեթների սխեմաներ Caveman-ի և RTK-ի զտիչների համար
Սեղմման լեզվական փաթեթներ	Լեզվի հայտնաբերում և Caveman կանոնների փաթեթների հեղինակում
Կայունության ուղեցույց	Անջատիչներ, սառեցումներ, հերթ, anti-thundering herd, TLS spoofing
Auto-Combo շարժիչ	16 գործոնով գնահատում, ռեժիմի փաթեթներ, ինքնավերականգնում
Պրոքսիի ուղեցույց	3 մակարդակի պրոքսի համակարգ, 1proxy շուկա, ռեեստրի CRUD
Անվճար մակարդակներ	Համախմբված տեղեկատու. 34 փաստաթղթավորված պարբերական փուլեր / 467 գրանցված անվճար մակարդակի գրառումներ
Հնարավորությունների պատկերասրահ	Տեսողական շրջայց dashboard-ում՝ էկրանների պատկերներով
Կոդային բազայի փաստաթղթավորում	Սկսնակների համար հարմար ծանոթացում կոդային բազային

### 🤖 Արձանագրություններ և API-ներ

Փաստաթուղթ	Նկարագրություն
API հղում	Բոլոր վերջնակետերը օրինակներով
OpenAPI սպեցիֆիկացիա	OpenAPI 3.0 սպեցիֆիկացիա
MCP սերվեր	110 MCP գործիքներ, IDE կոնֆիգուրացիաներ, Python/TS/Go հաճախորդներ
MCP սերվերի ուղեցույց	MCP տեղադրում, փոխադրամիջոցներ և գործիքների հղում
A2A սերվեր	JSON-RPC 2.0 արձանագրություն, հմտություններ, սթրիմինգ, առաջադրանքների կառավարում
A2A սերվերի ուղեցույց	A2A գործակալի քարտ, առաջադրանքներ, հմտություններ և սթրիմինգ

### 📋 Նախագիծ և որակ

Փաստաթուղթ	Նկարագրություն
Մասնակցություն	Մշակման միջավայրի կարգավորում և ուղեցույցներ
Ճյուղավորման և թողարկման մոդել	Թե ուր են ուղղվում PR-ները (`release/*`), և ինչ են նշանակում `main`-ը և թեգերը
Փոփոխությունների մատյան	Թողարկումների ամբողջական պատմություն՝ ըստ տարբերակների
Անվտանգության քաղաքականություն	Խոցելիությունների մասին հաղորդում և անվտանգության գործելակերպեր
i18n ուղեցույց	67 լեզվի աջակցություն, թարգմանության աշխատանքային հոսք, RTL
Թողարկման ստուգաթերթ	Նախաթողարկումային վավերացման քայլեր
Ծածկույթի պլան	Թեստային ծածկույթի ռազմավարություն՝ 7,800-ից ավելի հետագծվող թեստային ֆայլերում առկա 56,000-ից ավելի ստատիկ թեստային հայտարարությունների համար

# ⭐ Լավագույն մասնակիցներ > OmniRoute-ը ձևավորվում է բաց կոդով ծրագրային ապահովման նվիրված համայնքի շնորհիվ։ Այս անձինք բացառիկ ներդրում են ունեցել, որն անմիջականորեն ազդում է նախագծի որակի, կայունության և հասանելիության վրա։ **Շնորհակալություն։** ### Արտաքին մասնակիցները՝ ըստ միավորված pull request-ների

Դիրք	Մասնակից	Միավորված PR-ներ	~Փոփոխված տողեր
1	maxmad64bis	371	25,326,561
2	HouMinXi	269	13,456,272
3	backryun	210	270,562
4	oyi77	190	411,243
5	pacocartones	174	78,276
6	JxnLexn	151	3,562,936
6	KooshaPari	151	5,972,314
8	rdself	145	80,663
9	RaviTharuma	123	500,065
10	herjarsa	88	230,872
11	hartmark	84	2,849,554
12	jonlwheat2-gif	67	68,548
13	artickc	62	43,502
14	chirag127	52	6,661
15	xz-dev	50	245,976
16	xiaoyaner0201	47	33,626
17	woodsonl	46	809,391
18	rqzbeh	44	147,896
19	QuangBlue	43	13,112
20	MumuTW	40	26,093

_{Տվյալները հավաքվել են 2026-10-18 15:09:09 UTC-ին՝ ընթացիկ release/v3.8.52 ճյուղի վերջին 656f01cb43 կոմիթի հիման վրա։ Էջավորված GitHub GraphQL հաշվառումը ներառում է 9,191 միավորված PR՝ 3,834-ը ռեպոզիտորիայի սեփականատիրոջից, 229-ը՝ Dependabot-ից, 6-ը՝ այլ բոտերից/հավելվածներից, իսկ 5,122 արտաքին PR՝ 835 տարբեր մասնակիցներից։ «Փոփոխված տողեր»-ը GitHub-ի ավելացումների և ջնջումների հանրագումարն է և ներառում է գեներացված ֆայլեր, lockfile-եր, կատալոգներ, թարգմանություններ և փաստաթղթեր․ սա փոփոխությունների ծավալն է, այլ ոչ թե հեղինակի գրած կոդի տողերի քանակը։ 49 PR-ի համար GitHub-ը հայտնում է 500,000 տողից ավելի տարբերություն (օրինակ՝ #13399-ը, որը մեկ մատակարարի հավելում է, թվարկում է 2,347 փոփոխված ֆայլ), ինչն ուռճացնում է վերոնշյալ մի քանի ընդհանուր ցուցանիշ։ Հավասար արդյունքներն ունեն նույն դիրքը։} ### GitHub-ին վերագրված կոմիթներ

Dizzle _{🥇 367 commit՝ վերագրված GitHub-ին}	Bob.Hou _{🥈 269 commit՝ վերագրված GitHub-ին}	Paijo _{🥉 229 commit՝ վերագրված GitHub-ին}	backryun _{🏅 202 commit՝ վերագրված GitHub-ին}	Paco Cartones _{🏅 174 commit՝ վերագրված GitHub-ին}	Ravi Tharuma _{🏅 126 commit՝ վերագրված GitHub-ին}
Markus Hartung _{🏅 114 commit՝ վերագրված GitHub-ին}	Randi _{🏅 108 commit՝ վերագրված GitHub-ին}	Jan Leon _{🏅 87 commit՝ վերագրված GitHub-ին}	Chris _{🏅 70 commit՝ վերագրված GitHub-ին}	Koosha Paridehpour _{🏅 68 commit՝ վերագրված GitHub-ին}

_{Վերստուգված է 2026-10-18 14:44:45 UTC-ին. GitHub-ին վերագրված commit-ները, որոնք հաղորդել է repository-ի Contributors API-ն release/v3.8.52 լռելյայն ճյուղի համար։ API-ն վերադարձրել է 849 ինքնություն (429 օգտատեր, 2 bot, 418 անանուն)․ այս աղյուսակը բացառում է maintainer-ին, bot-երին և անանուն ինքնություններին ու պահպանում է հավասար արդյունքներով դիրքերը։ Այն տարբերվում է ինչպես վերևում բերված merged-PR վարկանիշից, այնպես էլ ներքևում բերված Git մետատվյալների հաշվառումից։} > 🙏 Այս ներդրողների ֆունկցիոնալությունները, սխալների շտկումները և ենթակառուցվածքային բարելավումները **հիմնական մասն** են այն ամենի, ինչը OmniRoute-ը դարձնում է հուսալի և ֆունկցիոնալությամբ հարուստ։ Կարևոր է յուրաքանչյուր pull request-ը, յուրաքանչյուր թեստային դեպքը և յուրաքանչյուր i18n թարգմանության ֆայլ։ Բաց կոդը ստեղծում են նրանց նման մարդիկ։

---
## 💖 Հովանավորներ

Սրտանց շնորհակալություն այն մարդկանց, ովքեր սեփական միջոցներով ֆինանսավորում են OmniRoute-ը․ յուրաքանչյուր ներդրում օգնում է նախագծին մնալ անվճար, անկախ և շարունակել զարգանալ։

Andrew _{💛 Ակտիվ ամսական հովանավոր}	Vlad I _{💛 Ակտիվ ամսական հովանավոր}	小妍儿 _{💛 Ակտիվ ամսական հովանավոր}	Guilherme Costa _{💛 Ակտիվ մեկանգամյա հովանավոր}	Henrique Iurkiv _{💛 Ակտիվ մեկանգամյա հովանավոր}	Somesh Ghaturle _{💛 Ակտիվ մեկանգամյա հովանավոր}
Kolonie AI _{💛 Նախկին մեկանգամյա աջակից}	Prof. Igor Morais _{💛 Նախկին մեկանգամյա աջակից}	Pixma _{💛 Նախկին մեկանգամյա աջակից}	Paco Cartones _{💛 Նախկին մեկանգամյա աջակից}	longtao _{💛 Նախկին մեկանգամյա աջակից}

_{… և ուրիշներ, ովքեր նախընտրում են անանուն մնալ 💛} _{GitHub Sponsors-ի հանրային տվյալները վերավավերացվել են 2026-10-18-ին՝ GitHub Sponsors GraphQL API-ի միջոցով․ ընդհանուր 14 հովանավորությունից 11-ը հանրային են (6-ը՝ ակտիվ, 5-ը՝ նախկին)։ GitHub-ի isActive կարգավիճակն է որոշում վերևում նշված ակտիվ պիտակները․ նախկին հանրային մեկանգամյա աջակիցներին շարունակում ենք շնորհակալություն հայտնել, իսկ մասնավոր հովանավորները մնում են անանուն։ Ko-fi-ի, Buy Me a Coffee-ի, Liberapay-ի, PIX-ի և կրիպտոարժույթով նվիրատվությունները նշված չեն, քանի որ դրանց համար հովանավորության հանրային գրառում չկա։} 💖 Դարձեք հովանավոր → — յուրաքանչյուր դոլար օգնում է OmniRoute-ին մնալ անվճար և անկախ։

## 👥 900+ ներդրողներ

[![Ներդրողներ](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=993&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors) _{Աուդիտն իրականացվել է 2026-10-18-ին՝ գործող release/v3.8.52 ճյուղի վերջին ad160ab2d1 կոմիթի դրությամբ (6,826 կոմիթ)․ 993 նորմալացված՝ մարդկանց պատկանող Git ինքնություն․ 707-ը հանդես են գալիս որպես կոմիթների հեղինակներ (ներառյալ սպասարկողը), իսկ 286-ը՝ միայն հստակ Co-authored-by վերջնագրերում։ Հաշվարկը կիրառում է .mailmap-ը, էլփոստի հասցեները համեմատում է առանց տառաչափը հաշվի առնելու, թվային և սովորական GitHub noreply հասցեները միավորում է միայն այն դեպքում, երբ դրանք կոդավորում են նույն օգտանունը, բացառում է բոտերի/գործակալների/ծառայությունների/տեղապահների 26 ինքնություն և չի միավորում սովորական էլփոստի հասցեները միայն այն պատճառով, որ դրանց ցուցադրվող անունները համընկնում են։ 2026-08-24-ի աուդիտը հրապարակել էր 639 թիվը․ այս մեթոդը տվյալ աուդիտի հիմքային ac02c5b42f կոմիթի վրա կրկին կիրառելիս ստացվում է 619, ուստի աճը պայմանավորված է նոր ներդրողներով, այլ ոչ թե ավելի մեղմ մեթոդաբանությամբ։} ### Ինչպես ներդրում կատարել 1. Ստեղծեք պահոցի fork-ը 2. Ճյուղ ստեղծեք **ակտիվ** `release/vX.Y.Z` ճյուղի վերջին կոմիթից (ոչ թե `main`-ից) — տե՛ս [Ճյուղավորման և թողարկման մոդելը](docs/ops/BRANCHING_MODEL.md) 3. Ստեղծեք ձեր գործառութային ճյուղը (`git checkout -b feat/amazing-feature`) 4. Կոմիթ արեք ձեր փոփոխությունները (`git commit -m 'feat: add amazing feature'`) 5. Ուղարկեք փոփոխությունները ճյուղ (`git push origin feat/amazing-feature`) 6. Բացեք Pull Request՝ որպես **base նշելով տվյալ `release/vX.Y.Z` ճյուղը** Մանրամասն ուղեցույցների համար տե՛ս [CONTRIBUTING.md](CONTRIBUTING.md)։ ### Նոր տարբերակի թողարկում ```bash # Ստեղծեք թողարկում․ npm publish-ը կատարվում է ինքնաբերաբար VERSION=x.y.z gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes ```

## 📊 Աստղեր

## 🌍 Աստղային Քարտեզագիր

## 🙏 Երախտագիտություն

OmniRoute-ը կառուցված է հսկաների ուսերին։ Այն սկզբնապես **[9router](https://github.com/decolua/9router)**-ի fork էր և Go-ով գրված **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** նախագծի TypeScript տեղափոխում, իսկ դրանից հետո ստորև ներկայացված յուրաքանչյուր ենթահամակարգ ոգեշնչվել է բաց կոդով նախագծից, որն առաջինն էր հասել այդ լուծմանը։ Դրանցից յուրաքանչյուրը ձևավորել է OmniRoute-ի որոշակի բաղադրիչ։ Սա մեր շնորհակալությունն է նրանց բոլորին։ 🙏 > ⭐ աստղերի քանակները ստուգվել են GitHub-ի REST API-ի միջոցով 2026 թվականի հոկտեմբերի 18-ին․ գնացեք և աստղ տվեք այս նախագծերին։ Քանակները տվյալ ամսաթվի դրությամբ ճշգրիտ ակնթարթային պատկեր են և, բնականաբար, կփոխվեն։ ### 🧬 Ծագում և gateway

Նախագիծ	⭐	Ինչպես է այն ոգեշնչել OmniRoute-ը
9router	31,004	Բնօրինակ նախագիծը, որի վրա կառուցված է այս fork-ը՝ այստեղ ընդլայնված բազմամոդալ API-ներով և TypeScript-ով ամբողջական վերաշարադրմամբ։
CLIProxyAPI	55,591	Go իրականացումը, որը ոգեշնչել է JavaScript / TypeScript-ով այս տեղափոխումը։
LiteLLM	61,482	AI gateway-ը, որի հանրային գնագոյացման տվյալակազմը սնուցում է ծախսերի հետագծման մեր համաժամացումը, իսկ մատակարարների նորմալացման մոդելն ուղղորդել է մեր երթուղավորումը։
codex-chatgpt-web	14,526	MIT աղբյուր, որը հարմարեցվել է ներկառուցված ChatGPT Web → Codex Responses կամրջում՝ ներառյալ դիտարկիչի աշխատաշրջանի, պատասխանի շրջանակավորման, օգտագործման և վեբ որոնման ադապտերները։
free-claude-code	61,430	Նախշեր, որոնք տեղափոխվել են հոսքի վերականգնման, առանց մտածողության այլանունների, պահուստային վեբ որոնման, սահող պատուհանի սահմանաչափերի, մատյանների տվյալների քողարկման և խստացված գործարկիչի հոսքերի մեջ։
composer-api	346	Cursor Composer-ի գործիքի ընտրության, ելքի սահմանափակման և գործիքի հաստատման նախշերը հարմարեցվել են բնիկ Cursor կատարիչում։
codex-multi-auth	553	Նոր մուտքի և թարմացման նշանի ռոտացիայի նախշերը տեղափոխվել են Codex OAuth-ի վերանույնականացման մեջ։
opencode-anthropic-auth	558	Claude Code-ի հետ համատեղելի փոխակերպման լռելյայն արժեքները և հաշվարկային վերնագրերի վարքագիծը ընդհանրացվել են OmniRoute-ի կազմաձևով կառավարվող կամրջում։
grok2api-merged	2	Դրա Grok մոդելների համապատասխանեցումները, կեղծ TypeError-ով Statsig գեներատորը, հարցման և սարքի լռելյայն արժեքները, ինչպես նաև NDJSON պատասխանի մշակիչը էականորեն հարմարեցվել են OmniRoute-ի Grok Web կատարիչում։
TQZHR/grok2api	706	grok2api-merged-ի հիմքում ընկած հիմնական անցումային կոդային աղբյուրը․ դրա մոդելի, վերնագրերի, օգտակար բեռի, Statsig-ի և մշակիչի իրականացումները պահպանվել են Grok Web-ի ծագումնաբանության մեջ։
chenyme/grok2api	7,819	Grok-ի օգտակար բեռի և սարքի լռելյայն արժեքների, Statsig գեներատորի և `result.response` մշակիչի հիմքում ընկած MIT աղբյուրը, որը փոխանցվել է TQZHR-ի և grok2api-merged-ի միջոցով։
grok2api-pro	27	Անցումային աղբյուր, որը grok2api-merged-ը նշել է որպես իր proxy-pool շերտի աղբյուր․ OmniRoute-ը պահպանում է այդ ծագման մասին նշումը, սակայն չի պնդում, որ իր սահմանափակ Grok Web կատարիչում տեղափոխել է proxy-pool-ը։
GrokProxy	51	Դրա cookie-ով նույնականացվող Grok proxy-ն և `result.response.token` հոսքային փոխանցման նախշը նպաստել են OmniRoute-ի Grok Web փոխադրման ձևավորմանը։
GrokBridge	5	Grok Web-ի սկզբնական իրականացման համար ուսումնասիրվել է դրա HTTP/դիտարկիչային upstream-ի դիզայնը․ դրա ուղղակի HTTP ուղին բխում է GrokProxy-ից, ուստի անկախ կոդային տեղափոխման մասին պնդում չի արվում։

### 🗜️ Համատեքստի և թոքենների սեղմում — շարժիչներ

Նախագիծ	⭐	Ինչպես է այն ոգեշնչել OmniRoute-ը
Caveman	113,396	Վիրուսային դարձած «ինչու օգտագործել շատ թոքեն, երբ քիչ թոքեն գործ անել» նախագիծը․ դրա քարանձավային խոսքի փիլիսոփայությունն ընկած է մեր ստանդարտ սեղմման ռեժիմի և 30+ ավելորդաբանությունների հեռացման/խտացման կանոնների հիմքում։
RTK – Rust Token Killer	83,835	Հրամանների ելքային տվյալների բարձր արտադրողականությամբ սեղմում․ ոգեշնչել է մեր RTK շարժիչը, JSON զտիչների DSL-ը, չմշակված ելքային տվյալների վերականգնումը և շերտավորված RTK → Caveman խողովակաշարը։
headroom	75,741	Համատեքստի դարձելի սեղմում (SmartCrusher)․ ոգեշնչել է մեր `headroom` շարժիչը և `ccr` առբերման նշիչի ձևանմուշը։
LLMLingua	6,757	Հուշումների սեղմման հետազոտություն (LLMLingua / LLMLingua-2)․ ոգեշնչել է մեր ասինխրոն, կոդի համար անվտանգ, սխալի դեպքում սկզբնական տվյալները պահպանող `llmlingua` շարժիչը։
llmlingua-2-js	32	JS/ONNX փոխադրումը (MobileBERT / XLM-RoBERTa), որն օգտագործվում է որպես մեր LLMLingua շարժիչի աշխատանքային հոսքի հետնամաս։
Troglodita	50	PT-BR թոքենների սեղմում․ ապահովում է մեր pt-BR լեզվային փաթեթի աշխատանքը՝ ավելորդաբանությունների կրճատմամբ և բրազիլական պորտուգալերենի քերականությանը հարմարեցված լցոնիչ բառերի հեռացմամբ։
ponytail	166,731	Վիրուսային դարձած «ծույլ ավագ ծրագրավորողի» YAGNI կոդավորման հմտությունը․ ոգեշնչել է մեր քիչ կոդ ելքային ոճը՝ նվազագույն աշխատող փոփոխության ուղղորդում, որը կրճատում է _ստեղծվող_ կոդը (Caveman-ի հակիրճ արձակի՝ ելքային առանցքի նմանակը)։
i-have-adhd	57,628	Դրա՝ գործողությունն առաջնահերթ համարող և ADHD ունեցող մարդկանց համար հարմար պատասխանների ոճը հարմարեցվել է՝ դառնալով OmniRoute-ի հակիրճ ելքային ոճը հինգ լեզուներով։

### 🧩 Կոմպակտ ձևաչափեր, թոքենների հետազոտություն և կոդը հաշվի առնող գործիքակազմ

Նախագիծ	⭐	Ինչպես է այն ոգեշնչել OmniRoute-ը
TOON	25,509	Թոքեններին ուղղված օբյեկտների նշագրում․ դրա սյունակային՝ վերնագիր-գումարած-տողեր մոդելը ձևավորել է աղյուսակային խտացման մեր փուլը։
GCF – Graph Compact Format	59	Դրա կոմպակտ գրաֆային ձևաչափը և ընդհանրական պրոֆիլի կառուցվածքն ազդել են OmniRoute-ի աղյուսակային խտացման և Headroom կոդեկի ձևաչափի վրա։
gcf-typescript	4	MIT արտոնագրով TypeScript իրականացումը, որն ուղղակիորեն ներառվել և ընդլայնվել է որպես Headroom-ի ընդհանրական պրոֆիլի կոդեկ։
token-optimizer-mcp	551	Brotli/SQLite քեշ + յուրաքանչյուր նստաշրջանի համատեքստային տարբերություն․ ոգեշնչել է մեր `session-dedup` շարժիչը։
token-savior	1,182	Bash ելքային տվյալների խտացում + MCP պրոֆիլներ․ ոգեշնչել է սեղմումից հրաժարվելու մեր կարգապահությունը և MCP գործիքների մանիֆեստի կրճատումը։
token-saver	154	Բովանդակությունը հաշվի առնող, ըստ ֆայլի տեսակի ելքային տվյալների սեղմում՝ խափանումը հաշվի առնող հրաժարման մեխանիզմով․ հաստատել է ըստ տեսակի բաշխման և նվազագույն շահույթի դեպքում բաց թողնելու մեր մոտեցումը։
token-optimizer	2,595	«Գտնել ուրվական թոքենները»․ դրա արտաբեռնման + վերականգնելի բռնակի ձևանմուշն ազդել է CCR արտաբեռնման վերաբերյալ մեր մոտեցման վրա։
TokenMizer	33	Նստաշրջանային գրաֆի + հաղորդագրությունների միջև տողերի կրկնազերծման նախագիծ, որն ազդել է մեր session-dedup կառուցվածքի վրա։
OmniCompress	3	Rust սյունակային JSON + բովանդակության հասցեավորմամբ առբերում + հաղորդագրությունների միջև կրկնազերծում․ հաստատել է մեր `headroom`/`ccr`/`session-dedup` շարժիչների կառուցվածքը և քեշի համար կայուն «սեղմված ձևը դիրքից անկախ է» անփոփոխակը։
mcp-compressor	133	MCP գործիքների սխեմաների/նկարագրությունների սեղմում․ ազդել է MCP գործիքների մանիֆեստի հզորության կրճատման մեր մոտեցման վրա։
RepoMapper	217	Aider ոճի շտեմարանի քարտեզի դասակարգում․ ազդել է շտեմարանի քարտեզի / առբերման դասակարգման մեր ուսումնասիրության վրա։
quiet-shell-mcp	4	Shell ելքային տվյալների դեկլարատիվ կրճատում MCP-ի միջոցով․ հաստատել է bash ելքային տվյալների դեկլարատիվ խտացման մեր մոտեցումը։
ts-morph	6,205	TypeScript Compiler API գործիքակազմ․ ոգեշնչել է վերլուծիչի վրա հիմնված մեկնաբանությունների հեռացումը, որը պահպանում է տողային, ձևանմուշային և կանոնավոր արտահայտությունների լիտերալները։

### 🧠 Հիշողություն և RAG

Նախագիծ	⭐	Ինչպես է այն ոգեշնչել OmniRoute-ը
Mem0	67,385	Հիշողության համընդհանուր շերտ․ որպես գրելու/կարդալու սահման հանդես եկող պրոքսիի մոդելը ձևավորել է մեր հիշողության ճարտարապետությունը։
Letta (MemGPT)	25,179	Վիճակ պահպանող գործակալներ՝ մակարդակավորված հիշողությամբ․ ոգեշնչել է մեր Context Control & Recovery (CCR) մակարդակավորված մոդելը։
WFGY	1,800	RAG/LLM-ի 16 կրկնվող խափանման ռեժիմների ProblemMap դասակարգումը՝ մեր անսարքությունների վերացման ուղեցույցում կիրառվող ընդհանուր բառապաշարը։

### 🛰️ Երթևեկության ստուգում, MITM և թափանցիկ պրոքսի

Նախագիծ	⭐	Ինչպես է այն ոգեշնչել OmniRoute-ը
llm-interceptor	79	Կոդավորման օգնականի ↔ LLM երթևեկության MITM կալանումը/վերլուծությունը հիմք է հանդիսացել Traffic Inspector-ի սկզբնական պահանջների համար։ Նախկինում ածանցված չորս մոդուլները՝ SSE միավորումը, զրույցների նորմալացումը, գաղտնի տվյալների քողարկումը և վերնագրերի մաքրումը, փոխարինվել են հրապարակային արձանագրությունների ստանդարտների հիման վրա ստեղծված անկախ, զրոյից իրականացումներով։ Հոսթը շրջանցող երկու մակերեսները (`passthrough.ts` և `_internal/bypass.cjs`) մնում են OmniRoute-ի ներքին իրականացումներ, որոնք դասակարգվել են առանձին․ դրանք չեն վերագրվել այդ փոխարինման շրջանակում։
ProxyBridge	6,814	Թափանցիկ, ըստ գործընթացի պրոքսի երթուղավորում․ ոգեշնչել է մեր խափանման նկատմամբ անվտանգ MITM ապամոնտաժումը, սոքեթների անգործության ժամանակային սահմանափակումները, `/proc`-ի միջոցով գործընթացների վերագրումը և TPROXY կալանումը։

### 📚 Մոդելների տվյալներ, դիտարկելիություն և UI

Նախագիծ	⭐	Ինչպես է այն ոգեշնչել OmniRoute-ը
models.dev	7,286	AI մոդելների բնութագրերի, գնագոյացման և հնարավորությունների բաց տվյալների բազա՝ բնիկ եղանակով համաժամացվում է մեր մոդելների կատալոգի հետ։
React Flow / xyflow	38,705	Հանգույցների վրա հիմնված գրաֆների գրադարանը, որն ապահովում է մեր իրական ժամանակի Compression Studio-ի և Combo/Routing Studio-ի աշխատանքը։
LangGraph	43,443	LangGraph Studio-ի աշխատանքային հոսքի գրաֆի կենդանի պատկերացումը ոգեշնչել է մեր Studios-ի իրական ժամանակի կասկադային տեսքը։
Langfuse	35,990	Դրա հետագիծ → հատված → գեներացում դիտարկելիության մոդելը ձևավորել է մեր Compression Studio-ի ջրվեժային ներկայացումը։
Kiali	3,645	Istio սպասարկման ցանցի դիտարկելիությունը ոգեշնչել է Routing/Combo Studio-ում մեր շղթայի անջատիչների նշանները և սխալների եզրերի պատկերումները։
lobe-icons	2,615	AI/LLM բրենդների պատկերանշանները, որոնք մեր վահանակում ցուցադրում են մատակարարների պատկերակները։
flag-icons	12,473	Տրամադրում է README-ի լեզվի ընտրիչում օգտագործվող՝ MIT արտոնագրով SVG դրոշները։

### 🛡️ Անվտանգություն

Նախագիծ	⭐	Ինչպես է այն ոգեշնչել OmniRoute-ը
awesome-secure-defaults	722	Լռելյայն անվտանգ գրադարանների ընտրված ցանկ, որն ուղղորդում է անվտանգության վերաբերյալ մեր ընտրությունները (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink)։

### 🧭 Լրացուցիչ գործիքներ

Նախագիծ	⭐	Ինչպես է այն ոգեշնչել OmniRoute-ը
ClawRouter	6,628	Ոգեշնչել է հարցումների կրկնօրինակների վերացումը, արտակարգ իրավիճակների համար զրոյական արժեքով պահուստային տարբերակը, ընդլայնելի Auto-Combo ռազմավարությունները և բազմալեզու մտադրությունների դասակարգումը։
Antigravity-Manager	32,333	Դրա՝ հաշիվը հաշվի առնող մոդելների վերաքարտեզագրումը, գործարկվող ֆայլի ուղու վավերացումը և պլանի պիտակների վարքագիծը հիմք են հանդիսացել OmniRoute-ի Antigravity գործարկման միջավայրի համար։
vscode-antigravity-cockpit	4,850	Քվոտայի վերակայման հետհաշվարկի դրա հակիրճ ձևաչափը ոգեշնչել է OmniRoute-ում մատակարարի սահմանաչափի համապատասխան ցուցադրումը։
AionUi	33,611	Դրա ACP ինտեգրումները ոգեշնչել են OmniRoute-ում տեղադրված CLI գործակալների ավտոմատ հայտնաբերումը։
CodexBar	22,616	Բացահայտել է Grok Build-ի քվոտայի մակերեսը․ այնուհետև OmniRoute-ն ինքնուրույն ստուգել և ուղղել է գործող հաղորդալարային ձևաչափը։

## 📄 Լիցենզիա MIT License - մանրամասների համար տե՛ս [LICENSE](LICENSE)։ ---

**[⬆ Վերև վերադառնալ](#-omniroute)** · Ստեղծված է ❤️-ով բաց կոդով AI համայնքի համար։ _{OmniRoute v3.8.53 · Node ≥22.22.2 · MIT License · omniroute.online}