## 💰 ~1.62 մլրդ տոկեն / ամիս՝ երրորդ կողմերի անվճար մակարդակներում
> **Օգտագործեք ձեր սեփական մատակարարների հաշիվները։** Սա առանձին հասանելի երրորդ կողմերի անվճար մակարդակների գնահատված հանրագումարն է, այլ ոչ թե OmniRoute-ի կողմից տրամադրվող տոկենների փաթեթ։ Գրանցվեք, անհրաժեշտության դեպքում ստացեք մուտքային տվյալները և միացրեք այն մատակարարներին, որոնցից կարող եք օգտվել․ յուրաքանչյուր մատակարար ինքն է վերահսկում իր սահմանաչափերը, հասանելիությունն ու պայմանները։
>
> Անվճար մակարդակները ձեռքով համատեղելը բարդ է՝ տասնյակ SDK-ներ, տասնյակ արագության սահմանաչափեր, և ոչ մի հստակ պատկերացում, թե իրականում որքան ռեսուրս ունեք։ OmniRoute-ը ցուցակագրում է **անվճար մակարդակի 489 գրառում՝ 35 կրկնվող փուլի բանալիներում** և տոկենների վերնագրային թիվը հաշվարկում է **հրապարակված դրական ամսական բյուջե ունեցող 17 փուլի՝ գումարած Groq-ի յուրաքանչյուր մոդելի հինգ սահմանաչափերի հիման վրա**՝ բացառելով ընդհանուր փուլերի կրկնակի հաշվարկը։ Այն քվոտաները, որոնք հասանելի են դառնում միայն տարածաշրջանային ինքնության ստուգումից հետո (ներկայում՝ ModelScope), ցուցադրվում են առանձին՝ +~6M տարածաշրջանային ինքնության հաստատման հետևում, և երբեք չեն գումարվում վերնագրային թվին։ Արդյունքը մշտապես տեսանելի է կառավարման վահանակում (`/dashboard/free-tiers`)։
> Գործող `/dashboard/free-tiers` էջի անիմացիոն ամփոփագիրը։ Ամբողջական մեթոդաբանությունը (փուլերի կրկնակի հաշվարկի բացառում, բոնուսային մակարդակներ, մատակարարների պայմաններ)՝ **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**։
>
> Այս թվերը յուրաքանչյուր երկու շաբաթը մեկ կրկին ստուգվում են գործող կատալոգի համեմատ և **փոխվում են երկու ուղղությամբ էլ**․ երբ մատակարարն ավարտում է անվճար մակարդակի տրամադրումը, թիվը նվազում է, իսկ երբ ավելանում է նորը՝ աճում։ Մենք հրապարակում ենք այն, ինչ իրականում հաշվարկում է կատալոգը, ոչ թե դեպի վեր կլորացված լավագույն հնարավոր տարբերակը։
⭐ Աստղ տվեք շտեմարանին, եթե OMNIROUTE-ն օգնել է ձեզ գումար խնայել և հեշտացնել ձեր աշխատանքը։
[](https://github.com/diegosouzapw/OmniRoute)
[](https://www.star-history.com/diegosouzapw/omniroute)
[](https://olud.ai/project/diegosouzapw-omniroute.html)
### 💬 Միացեք համայնքին
**👋 Հետևեք նախագծի սպասարկողին՝ նոր մատակարարների, թողարկումների և խորհուրդների մասին առաջինը տեղեկանալու համար․**
[](https://www.linkedin.com/in/diegosouzapw/)
[](https://github.com/diegosouzapw)
[](https://discord.gg/U47eFqAXCn)
[](https://t.me/omnirouteOficial)
[](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4)
[](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4)
[](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)**
## 📈 Gateway-ը շարունակում է աճել
## 🆓 Տեղադրեք, միացրեք մատակարար և ուղղորդեք մեկ վերջնակետի միջոցով
```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` նշումով մատակարարները, ներառյալ OpenCode Free-ը և Kiro-ն, լռելյայն բացառվում են ավտոմատ ուղղորդումից․ հաշիվ միացնելը չի շրջանցում այդ կարգավորումը։ Մատակարար ընտրելուց առաջ ծանոթացեք [Անվճար սակագների ուղեցույցին](docs/getting-started/FREE-TIERS-GUIDE.md)։📦 Պատճենելու և տեղադրելու արագ մեկնարկի սկրիպտներ **Python-ի, Node.js-ի, PHP-ի և cURL-ի** համար → [`examples/quickstart/`](examples/quickstart/)
# 💥 Խոստումը
# 🤔 Ինչո՞ւ OmniRoute։
## 🤝 Աջակցվում է մեր բաց կոդով ընկերների կողմից
> **Ցանկանու՞մ եք միանալ որպես բաց կոդով ընկեր:** Սրանք այն ընկերություններն են, որոնք աջակցում են բաց կոդին և օգնում են 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-ի օգտատերերին: Բացեք խնդիր, և մենք այն կավելացնենք այստեղ:
## 🎯 Կոմբոներ — առաջատար հնարավորությունը
> **Կոմբոն** մոդելների շղթա է, որոնց միջև OmniRoute-ը երթուղավորում է **ավտոմատ կերպով**։ Եթե քվոտան սպառվում է, մատակարարը խափանվում է կամ ծախսերը կտրուկ աճում են, կոմբոն կարող է անցնել հաջորդ համապատասխան և անխափան մոդելին։ 🛡️
### ⚡ Զրոյական կազմաձևում — պարզապես օգտագործեք `auto`
Կոմբո ստեղծելու կարիք չկա։ Ձեր մոդելը սահմանեք որպես `auto` (կամ դրա տարբերակներից մեկը), և OmniRoute-ը ձեր միացված մատակարարներից կկազմի վիրտուալ կոմբո՝ իրական ժամանակում գնահատելով դրանք.
Մոդելի ID
Ինչի համար է այն օպտիմալացնում
auto
🎯 Հավասարակշռված լռելյայն տարբերակ (LKGP — մնում է ձեր վերջին հաջող մատակարարի հետ)
auto/coding
🧑💻 Կոդի գեներացման համար՝ նախ որակը հաշվի առնող կշիռներ
auto/fast
⚡ Նախ՝ նվազագույն ուշացումը
auto/cheap
💰 Նախ՝ մեկ տոկենի նվազագույն արժեքը
auto/offline
🔋 Նախ՝ քվոտայի / հաճախականության սահմանաչափի ամենամեծ պաշարը
auto/smart
🔭 Նախ՝ որակը + 10% հետազոտում՝ ավելի լավ մոդելներ հայտնաբերելու համար
auto/lkgp
📌 Բացահայտ ամրագրում վերջին հայտնի հաջող մատակարարին
auto/chaos
🧪 Զուգահեռ հարցումներ մոդելների խմբին (մեկը՝ յուրաքանչյուր մատակարարից, լռելյայն՝ 5), վերադարձնում է մեկ պատասխան. մեկ վերին մակարդակի կանչ՝ խմբի յուրաքանչյուր մոդելի համար, ոչ թե խափանումների ներարկում
##
### 🔀 Կամ ստեղծեք ձերը — երթուղավորման 19 ռազմավարություն
Բոլոր **19** ռազմավարությունները. ազատորեն համադրեք դրանք կոմբոյի յուրաքանչյուր քայլում.
#
Ռազմավարություն
Ինչ է այն անում
1
priority
Առաջին թիրախի առաջնահերթությամբ դասավորված ցանկ. յուրաքանչյուրն ամբողջությամբ օգտագործվում է՝ հաջորդին անցնելուց առաջ 🥇
2
fill-first
Յուրաքանչյուր թիրախի քվոտան ամբողջությամբ օգտագործվում է՝ հաջորդին անցնելուց առաջ
3
weighted
Կշռված պատահական ընտրություն՝ ըստ յուրաքանչյուր թիրախի կշռի
4
round-robin
Թիրախների հերթական շրջանցում՝ ըստ սահմանված կարգի
5
p2c
Բեռնվածության պատահական հավասարակշռում՝ երկու տարբերակներից ընտրության սկզբունքով
6
least-used
Ընտրում է ներկայումս նվազագույն բեռնվածություն ունեցող թիրախը
Պատահական ընտրություն՝ առանց կրկնությունները հեռացնելու 🎲
9
cost-optimized
Նվազագույնի է հասցնում մեկ հարցման $ արժեքը՝ ըստ կատալոգի ընթացիկ գների 💸
10
headroom
Ընտրում է առավելագույն մնացած քվոտա ունեցող թիրախը
11
reset-window
Նախապատվություն է տալիս այն թիրախին, որի քվոտայի պատուհանն ամենաշուտը կվերակայվի
12
reset-aware
Դասակարգում է ըստ քվոտայի վերակայման ժամանակի՝ նախ կարճ պատուհանները 📊
13
context-relay
Երկար զրույցների համար համատեքստը փոխանցում է թիրախների միջև 🧠
14
context-optimized
Ընտրում է ընթացիկ համատեքստի չափին լավագույնս համապատասխանող տարբերակը
15
cache-optimized
Յուրաքանչյուր վերօգտագործելի հարցման նախածանց ամրագրում է նույն հաշվին՝ հարցումների քեշի համընկնումները առավելագույնի հասցնելու համար 🎯
16
lkgp
Վերջին հայտնի հաջող ուղի. ամրագրվում է վերջին հաջող մատակարարին, ապա անհաջողության դեպքում անցնում է կանոններին
17
auto
Իրական ժամանակի 16-գործոն գնահատում՝ բոլոր կապերի համար 🤖
18
fusion
Հարցումները զուգահեռ ուղարկում է մոդելների խմբին, իսկ դատավոր մոդելը համադրում է մեկ պատասխան 🧬
19
pipeline
Շղթայում է քայլերը. յուրաքանչյուր թիրախի ելքը փոխանցվում է հաջորդին 🔗
Auto-Combo շարժիչը յուրաքանչյուր թեկնածուի գնահատում է **16 գործոնով** (աշխատունակություն, քվոտա, արժեք, ուշացում, առաջադրանքին համապատասխանություն, որակ, աշխատաշրջանի հասանելիություն…) — տես [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md)։
##
### 🧱 Դիմակայունությունը ներկառուցված է (3 անկախ շերտ)
📖 [Ավտոմատ կոմբոյի շարժիչ](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 արտոնագրով և բաց կերպով սպասարկվում է։ Եթե այն խնայում է ձեր ժամանակը կամ գումարը, ահա թե ինչպես կարող եք օգնել, որ այն անկախ մնա․ ընտրեք ձեզ հարմար տարբերակը։ Հովանավորությունը երբեք չի ազդում երթուղավորման առաջնահերթության վրա․ այն ապահովում է տեսանելիություն, ոչ թե վարկանիշ։
⚠️ Յուրաքանչյուր արժույթ ուղարկեք միայն նշված ցանցով․ սխալ ցանցով ուղարկելու դեպքում միջոցները կարող են կորսվել։
🐛 Սխա՞լ եք գտել կամ կարծիք ունե՞ք։ Բացեք [քննարկում](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.50** տարբերակների վերջին կարևոր փոփոխությունները։ Ամբողջական պատմությունը՝ [`CHANGELOG.md`](CHANGELOG.md)-ում։
- **🎛️ OmniConductor** — մուտքային A2A պատվիրակում ձեր գործակալների խմբին, Conductor-ի հմտություններ Agent Card-ում և Faro push-to-talk ձայնային զրույցով կառավարման վահանակ։ → [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-ի/գործակալի կարգավորում մեկ հրամանով** — գրանցված 13 `setup-*` հրաման․ `omniroute run`-ը գործարկում է 7 CLI (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI), իսկ `omniroute configure`-ը սպասարկում է 10 թիրախ՝ մատակարարի և մոդելի ինտերակտիվ ընտրիչով ու յուրաքանչյուր համատեքստի նախընտրած տարբերակներով։ → [CLI ինտեգրումներ](docs/guides/CLI-INTEGRATIONS.md)
- **🛰️ Հեռավար ռեժիմ** — կառավարեք հեռավար OmniRoute-ը սահմանափակ գործողության տիրույթով թոքեններով (`connect` / `contexts` / `tokens`) և VPS տեղադրումների համար նախատեսված `antigravity` OAuth օգնականով։ → [Հեռավար ռեժիմ](docs/guides/REMOTE-MODE.md)
- **🧭 Ավելի խելացի ավտոմատ երթուղավորում** — `auto/:` կոմբինացիաներ, **Fusion** (մոդելների վահանակ + դատավոր), առաջադրանքը հաշվի առնող երթուղավորում, յուրաքանչյուր հարցման համար մոդելի / ռեժիմի / USD բյուջեի վերասահմանումներ։ → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🗜️ Ընդլայնելի սեղմում** — համադրվող 12 շարժիչ + Compression Studios՝ LLMLingua-2, երկաստիճան Ultra, omniglyph, յուրաքանչյուր քայլի ճշգրտության դարպաս, GCF v3.2 և քաշելով վերադասավորելու խմբագրիչ։ → [Սեղմում](docs/compression/COMPRESSION_ENGINES.md)
- **🕵️ Թափանցիկ MITM վերծանում (TPROXY)** — որսացեք proxy միջավայրի փոփոխականներն անտեսող 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)
- **🌍 Տեղակայում և շահագործում** — հակադարձ proxy-ի `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… և թարմացված **352 մատակարարից բաղկացած կատալոգ**։ → [Մատակարարներ](docs/reference/PROVIDER_REFERENCE.md)
- **📡 Երթուղավորման թափանցիկություն** — յուրաքանչյուր պատասխան պարունակում է այն սպասարկած ռազմավարությունը/մատակարարին/ուշացումը նշող `X-OmniRoute-Decision` վերնագիր, նոր `cache-optimized` կոմբինացիոն ռազմավարությունը + Auto-Combo-ի `cacheAffinity` գործոնը կրկնվող հարցումները հետ են ուղարկում քեշավորված նախածանցը պահող կապին, իսկ միայն ընթերցման համար նախատեսված `/v1/auto-combo/{channel}/candidates` վերջնակետը ցուցադրում է `auto/*` ալիքի ընթացիկ թեկնածուների հավաքածուն։ → [Auto-Combo](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` զուգահեռ բազմամոդելային ճյուղավորում, Telegram բոտի կամուրջ, հավելվածի ներսում տարբերակների կառավարիչ և անվճար մատակարարների LMArena-ELO վարկանիշներ։ → [Փաստաթղթեր](docs/README.md)
## 🤖 Համատեղելի CLI-ներ և կոդավորման գործակալներ
> Մեկ կոնֆիգուրացիա՝ `http://localhost:20128/v1`, և **յուրաքանչյուր** AI IDE կամ CLI աշխատում է անվճար և ցածրարժեք մոդելների վրա:
+ աշխատում է նաև · Agent Deck · Kiro · Command Code · Antigravity · Windsurf · AMP · ցանկացած OpenAI-ի հետ համատեղելի գործիքի հետ
📖 Յուրաքանչյուր գործիքի կարգավորում բոլոր 36 գործիքների համար (26 CLI Code's + 10 CLI Agents) → [`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 կոդ
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
```
Յուրաքանչյուր հրաման հարգում է ակտիվ հեռավոր կոնտեքստը (`omniroute connect `), `--dry-run`-ը
նախադիտում է ճշգրիտ միջավայրը/փաստարկները՝ առանց կատարելու, իսկ `--api-key-env NAME`-ը գաղտնիքները պահում է
ձեր shell-ի պատմությունից դուրս: → [CLI ինտեգրումներ](docs/guides/CLI-INTEGRATIONS.md)
## 🌐 372 AI մատակարար — 154-ը կատալոգում նշված են որպես անվճար
> **372 գրանցված մատակարար**՝ զրույցի, մեդիայի, որոնման, տեղային, ամպային գործակալների և համակարգային կանոնական հավաքածուներում, որոնցից **154-ն ունեն `hasFree: true` հայտնաբերման մետատվյալներ**։ Զրույցի մոդելների ռեեստրը ներառում է **237 մատակարար / մատակարար-մոդել 3,009 տարբեր զույգ / մոդելների 1,443 չմշակված ID**․ անվճար բյուջեների առանձին կատալոգն ունի **491 տող՝ ըստ մոդելի**, **35 պարբերաբար թարմացվող ռեսուրսային ավազան** և **54 պարբերաբար հասանելի կամ առանց բանալու՝ ընդմիշտ անվճար մատակարար**։ Նախագծային նկատառումներով սրանք տարբեր հաշվարկային հիմքեր են․ սահմանումները և կրկնությունները բացառող՝ ըստ ավազանների հաշվարկները հասանելի են [Մատակարարների տեղեկատուում](docs/reference/PROVIDER_REFERENCE.md) և [Անվճար մակարդակներում](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
…և ևս 330+ մատակարար․ յուրաքանչյուր պատկերակ իրական ժամանակում բեռնվում է կառավարման վահանակի մատակարարների կատալոգից։ 📖 [Մատակարարների տեղեկատու](docs/reference/PROVIDER_REFERENCE.md)
### 🆓 Ընդմիշտ անվճար՝ $0, առանց քարտի
OpenCode Zen DeepSeek V4, Nemotron 3 Թոքենների սահմանափակում չկա
Kilo Code Ավտոմատ երթուղիչ, 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 նեյրոն
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 տարբերակներում
### 🧩 Նորություն․ 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**։
Խմբագրիչի ներսում բացեք **Ընդլայնումներ** տեսքը, որոնեք **«OmniRoute»**, սեղմեք **Տեղադրել**
․ երկու շտեմարաններում էլ այն աշխատում է նույն կերպ։ Սկզբնաղբյուրը, խնդիրները և հրապարակման գործակարգը հասանելի են
[diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot) հասցեում։
📖 [VS Code Copilot Chat-ի ուղեցույց](docs/guides/VSCODE-COPILOT.md) — կարգավորում, ընտրիչում ցուցադրվող տվյալներ, կառավարման վահանակը ներդիրում, խնդիրների լուծում
> `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 գործընթաց, իսկ արդեն աշխատող օրինակը կրկնօրինակելու փոխարեն՝ ընդունում է այն
Փուլային տեղադրում, ատոմային փոխարինում, ձախողման դեպքում հետադարձում՝ միշտ ամենանոր թողարկմամբ
🚀 Գործարկում մուտք գործելիս
Ընտրովի գործարկում մուտք գործելիս․ միայն սկուտեղում, առանց dock պատկերակի
🩺 Ստուգում և մատյաններ
Մեկ սեղմումով ախտորոշում և հասանելիություն սերվերի մատյաններին
```sh
brew install --cask zoispag/tap/omniroute-tray
```
Նախընտրո՞ւմ եք ներբեռնել։ Վերջին .dmg-ը վերցրեք
Թողարկումներ բաժնից։ Սկզբնաղբյուրի կոդը, խնդիրները և հավաքման
փաստաթղթերը հասանելի են zoispag/omniroute-tray-ում։
💛 @zoispag-ի համայնքային նախագիծ է, ոչ թե OmniRoute-ի պաշտոնական թողարկում։
> Սերվերից բացի, OmniRoute-ը **հրամանային տողի ամբողջական կառավարման կենտրոն** է՝ **80+ հրամաններով**, ինչպես նաև գործակալների բաց արձանագրություններով, որպեսզի AI գործակալը կարողանա այն կառավարել **ինքնուրույն**։
### ⌨️ Իրական CLI (ոչ միայն `start`)
```bash
omniroute # գործարկել անցուղին + կառավարման վահանակը (պորտ 20128)
omniroute chat # ինտերակտիվ TUI զրույցի հաճախորդ (թեք գծով՝ /model /combo /skill /memory)
omniroute setup # առաջին գործարկման ուղղորդվող կարգաբերման օգնական
omniroute doctor # ախտորոշել մատակարարները, պորտերը, բնիկ կախվածությունները
```
### 🛰️ Հեռավար ռեժիմ — CLI-ն գործարկեք այստեղ, իսկ OmniRoute-ը՝ VPS-ում
OmniRoute-ը սերվերո՞ւմ է։ Կառավարեք այն ձեր նոութբուքից՝ **նույն CLI-ով**։ Մեկ անգամ մուտք գործեք
սահմանափակ հասանելիության թոքենով, որից հետո յուրաքանչյուր հրաման կուղղվի հեռավար սերվերին։
```bash
omniroute connect 192.168.0.15 # գաղտնաբառ → սահմանափակ թոքեն՝ պահպանված որպես համատեքստ
omniroute models list # ← գործարկվում է ՀԵՌԱՎԱՐ սերվերի նկատմամբ
omniroute configure codex # ← ընտրում է հեռավար մոդել, գրում է տեղային Codex պրոֆիլ
omniroute tokens create --name ci --scope read # ստեղծել ավելի նեղ հասանելիությամբ թոքեններ այլ մեքենաների համար
omniroute contexts use default # ← վերադառնալ տեղային սերվերին
```
Թոքենների շրջանակներն են `read` / `write` / `admin`, իսկ գործընթացներ մեկնարկող երթուղիները հասանելի են միայն loopback-ով։
📖 [Հեռավար ռեժիմ](docs/guides/REMOTE-MODE.md)
### 🤝 Միացրեք գործակալ — և այն ինքնուրույն կկառավարի OmniRoute-ը
Հասանելի դարձրեք OmniRoute-ը **MCP**-ի, **A2A**-ի, **REST API**-ի, **webhook-ների** կամ **հեռավար CLI**-ի միջոցով, և ցանկացած ունակ գործակալ (կամ ձեր սեփական կոդը) հասանելիություն կստանա ամբողջ անցուղուն՝ երթուղավորմանը, մատակարարներին, համակցություններին, քեշին, սեղմմանը և հիշողությանը՝ ինքնավար կերպով։ Ստորև նշված HTTP վերջնակետերը սպասարկվում են `http://localhost:20128` հասցեով։
Միջերես
Վերջնակետ / հրաման
Օգտագործեք հետևյալի համար
🧰 MCP (stdio)
omniroute --mcp
Միացում Claude Desktop-ին, Cursor-ին կամ ցանկացած MCP հաճախորդի
🌊 MCP (HTTP)
/api/mcp/stream
Հեռավար MCP՝ 110 գործիք, 33 շրջանակ (պարտադրումը՝ ըստ ցանկության), աուդիտի ամբողջական մատյան
```bash
# Claude Code-ին տրամադրել OmniRoute-ի գործիքների ամբողջական հավաքածուն MCP-ի միջոցով.
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%-ը՝ ավտոմատ կերպով
### 📖 Ինչպես է այն աշխատում՝ խողովակաշար, ճարտարապետություն և խնայողությունների հաշվարկ
Լռելյայն շարված համադրությունն աշխատեցնում է `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
Մեծ բլոկներն արխիվացնում է առբերման նշիչների հետևում՝ ըստ պահանջի ստանալու համար
Նախադասությունների քաղվածքային գնահատում՝ վերջին օգտատիրոջ հարցման համեմատ
8
Caveman
Կանոնների վրա հիմնված արձակ տեքստի սեղմում (ելքի ~65–75%-ը)
9
Aggressive
Ամփոփում + հին քայլերի աստիճանական հնացում
10
LLMLingua-2
ML իմաստաբանական զտում MobileBERT ONNX-ի միջոցով՝ կոդի համար անվտանգ, ասինխրոն
11
Ultra
Թոքենների էվրիստիկ զտում՝ փոքր մոդելի (SLM) ընտրովի մակարդակով
12
OmniGlyph
Համատեքստը որպես պատկեր կոդավորելու փորձարարական եղանակ՝ ուղիղ Anthropic կապով չափված Claude Fable 5-ի համար. GPT 5.6 փոխակերպիչները շարունակում են փակ մնալ ձախողման դեպքում՝ մինչև մատակարարի հաստատումների ստացումը։ Սեղմման չորս պրոֆիլ (լռելյայն ագրեսիվ, հավասարակշռված, կոդավորման համար անվտանգ, անփոփոխ փոխանցում) (ամենաագրեսիվը. միացվում է ըստ ցանկության)
Կոդի բլոկները, 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, React-ի մակերեսային համեմատությունն ամեն անգամ այն դիտարկում է որպես տարբեր օբյեկտ, ինչը վերարտապատկերում է գործարկում։ Խորհուրդ կտայի useMemo-ի միջոցով օբյեկտը հիշապահել։"_
>
> **Հետո (19 թոքեն).** _"Յուրաքանչյուր արտապատկերման ժամանակ՝ օբյեկտի նոր հղում։ Ներկառուցված օբյեկտային prop = նոր հղում = վերարտապատկերում։ Փաթաթեք useMemo-ով։"_
>
> **Նույն պատասխանը։ 72%-ով ավելի քիչ թոքեն։ Ճշգրտության զրոյական կորուստ։** ✅
**PT-BR օրինակ՝ [Troglodita](https://github.com/leninejunior/troglodita) ռեժիմ.**
> **Առաջ (42 տոկեն):** _«Խնդիրն այն է, որ բաղադրիչը վերառենդերավորվում է, քանի որ յուրաքանչյուր ռենդերավորման ցիկլում ստեղծվում է օբյեկտի նոր հղում։ Խորհուրդ կտայի օգտագործել useMemo»։_
>
> **Հետո (12 տոկեն):** _«Վերառենդերում՝ նոր հղում ամեն ցիկլում (inline օբյեկտը վերստեղծվում է)։ Օգտագործել `useMemo`»։_
>
> **Նույն պատասխանը։ ~70% պակաս տոկեն։ Տեխնիկական ճշգրտությունն անփոփոխ է։** ✅
### 🎚️ Շարժիչներից անդին՝ ելքի ոճեր, հարմարվողական կարգավորիչ և յուրաքանչյուր հարցման կառավարում
Վերևի 12 շարժիչները կրճատում են այն, ինչ **մուտքագրվում է**։ Եվս երեք շերտ ձևավորում են, թե **ինչպես**, **երբ** և ինչ է **ելքագրվում**․
- **🪄 Ելքի ոճեր** _(ելքի առանցքի ուղղորդում)_ — ներարկում են դետերմինացված, քեշի համար անվտանգ հրահանգներ՝ պատասխանի ձևը կառավարելու համար։ Դրանք համադրելի են, և յուրաքանչյուրն ունի `lite` / `full` / `ultra` ինտենսիվություն։ Ոճ ավելացնելու համար բավական է ռեեստրում մեկ տող ավելացնել․
- **Հակիրճ շարադրանք** — հեռացնել ավելորդ բառերը / հոդերը / վերապահումները՝ տեխնիկական բովանդակությունը պահելով ճշգրիտ։
- **Ավելի քիչ կոդ** — «ծույլ ավագ ծրագրավորողի» YAGNI մոտեցում՝ ամենափոքր աշխատող փոփոխությունը, առանց չպահանջված ենթակառուցվածքի։
- **Ponytail (ծույլ ավագ ծրագրավորող)** — բարձրանալ YAGNI-ի աստիճաններով, շտկել բուն պատճառը, կատարել ամենափոքր աշխատող diff-ը։
- **Ես ունեմ ADHD (գործողությունն առաջինը)** — սկսել հաջորդ գործողությունից, համարակալել քայլերը, տալ մեկ կոնկրետ հաջորդ քայլ՝ առանց նախաբանի։
- **Հակիրճ CJK (文言)** — դասական չինարենի գերհակիրճ ոճ (`zh` տեղայնացմամբ սահմանափակված)։
- **🎯 Հարմարվողական համատեքստի բյուջե** _(կարգավորիչը)_ — մեկ միացված/անջատված տոկենային շեմի փոխարեն աստիճանաբար գործարկում է ամենաէժան և նվազագույն կորուստներով շարժիչները միայն այնքան, որքան անհրաժեշտ է՝ **մոդելի համատեքստային պատուհանում տեղավորվելու համար**։ Քաղաքականություն՝ `reserve-output` (լռելյայն, մոդելը հաշվի առնող) · `percentage` · `absolute`։ Ռեժիմ՝ `floor` (երաշխավորել տեղավորումը) · `replace-autotrigger` (ձեր բացահայտ ընտրությունը գերակայում է) · `off` (հին շեմը)։
- **🎛️ Որտեղ է որոշվում սեղմումը** _(առաջնահերթություն՝ բարձրից ցածր)_ — յուրաքանչյուր հարցման `x-omniroute-compression` վերնագիր › երթուղավորման համակցության վերասահմանում › ակտիվ անվանված պրոֆիլ › հարմարվողական / ավտոմատ գործարկում › վահանակի լռելյայն արժեք › անջատված։ Կիրառված պլանը վերադարձվում է `X-OmniRoute-Compression: ; source=` պատասխանի վերնագրում։
Կարգավորեք ավտոմատ գործարկումը՝ ըստ տոկենների շեմի, միացրեք հարմարվողական կարգավորիչը, ամրագրեք անվանված պրոֆիլ, սահմանեք մեկանգամյա արժեք յուրաքանչյուր հարցման համար կամ խողովակաշար նշանակեք երթուղավորման յուրաքանչյուր համակցությանը՝ ընտրելով աշխատանքային ծանրաբեռնվածությանը համապատասխան տարբերակը։ Կամընտիր անցանց **գնահատման գործիքակազմը** (`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-ը կարող է արգելափակել փաթեթի կենսացիկլի սկրիպտները, եթե դրանք թույլատրված չեն։ OmniRoute-ի `postinstall`-ը (`node scripts/build/postinstall.mjs`) անհրաժեշտ է դրա բնիկ կատարման միջավայրի ֆայլերը պատրաստելու համար։ Համընդհանուր տեղադրման ժամանակ թույլատրեք npm-ի նախազգուշացման մեջ նշված փաթեթները։ OmniRoute 3.8.51-ի հաղորդած փաթեթների հավաքածուի համար՝
>
> ```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-ը հաղորդում է այլ ցանկ, օգտագործեք այդ նախազգուշացման մեջ նշված փաթեթների անունները։ Փաթեթի թույլատրումը հնարավորություն է տալիս գործարկել դրա տեղադրման սկրիպտները։
> **Օգտագործո՞ւմ եք Gemini Web կամ վեբ cookie-ների այլ մատակարար։** npm փաթեթը ներառում է
> Playwright-ը, բայց ոչ դրա Chromium բինար ֆայլը։ Նախքան վեբ մատակարարին առաջին հարցումն ուղարկելը՝ ծանոթացեք
> [Playwright Chromium-ի կարգավորման](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium)
> նշմանը։
Կառավարման վահանակը՝ `http://localhost:20128` · API-ն՝ `http://localhost:20128/v1`։
**2) Միացրեք համապատասխան մատակարար՝ օգտագործելով ձեր սեփական հաշիվը**
Կառավարման վահանակ → **Մատակարարներ** → ընտրեք մատակարար, որի ընթացիկ պայմաններն ու քվոտան համապատասխանում են ձեր օգտագործման դեպքին → ավելացրեք դրա API բանալին կամ ավարտեք հաշվի միացման գործընթացը։ Անվճար սակագները կարող են պահանջել գրանցում, հաստատում կամ վճարման եղանակ։ Ուսումնասիրեք [Անվճար սակագների ուղեցույցը](docs/getting-started/FREE-TIERS-GUIDE.md)։ Առանց բանալու հասանելիությունը երաշխավորված չէ, իսկ `tos: avoid` նշումով մատակարարները լռելյայն բացառվում են `auto`-ից։
**3) Կարգավորեք ձեր ծրագրավորման գործիքը**
```txt
Հիմնական URL՝ http://localhost:20128/v1
API բանալի՝ [պատճենեք Կառավարման վահանակ → Վերջնակետեր բաժնից]
Մոդել՝ auto (երթուղավորում է համապատասխան միացումների միջև կամ ընտրեք մատակարար/մոդել)
```
**4) Ստուգեք, որ այն աշխատում է**
```bash
curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY"
```
Դուք պետք է տեսնեք ձեր միացված մոդելների ցանկը։ 🎉 Ահա և վերջ՝ սկսեք ծրագրավորել, իսկ OmniRoute-ը ձեզ համար ավտոմատ կընտրի երթուղին և խափանման դեպքում կանցնի պահուստային տարբերակի։
Եթե ձեր հաճախորդը չի կարող ուղարկել հատուկ վերնագրեր, OmniRoute-ը նաև տրամադրում է տոկենացված համատեղելիության այլանուններ․
```txt
OpenAI կատալոգ՝ http://localhost:20128/vscode/YOUR_KEY/
OpenAI մոդելներ՝ http://localhost:20128/vscode/YOUR_KEY/models
OpenAI զրույց՝ http://localhost:20128/vscode/YOUR_KEY/chat/completions
OpenAI պատասխաններ՝ http://localhost:20128/vscode/YOUR_KEY/responses
Ollama զրույց՝ http://localhost:20128/vscode/YOUR_KEY/api/chat
Ollama պիտակներ՝ http://localhost:20128/vscode/YOUR_KEY/api/tags
```
Դրանք օգտագործեք միայն այն հաճախորդների համար, որոնք չեն կարող կցել `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-ը ձևավորվում է կրքոտ բաց կոդով համայնքի կողմից: Այս անհատները կատարել են բացառիկ ներդրումներ, որոնք ուղղակիորեն ազդում են նախագծի որակի, կայունության և հասանելիության վրա: **Շնորհակալություն:**
### Արտաքին աջակիցներն ըստ միաձուլված pull request-ների
Ֆիքսված է ըստ ակտիվ release/v3.8.50-ի dafb4ae808 կետի, ներառյալ միաձուլումները մինչև 2026-08-24 05:26:03 UTC: GitHub GraphQL-ի էջավորված մարդահամարը պարունակում է 5,911 միաձուլված PR. 2,707-ը՝ ռեպոզիտորիայի սեփականատիրոջ կողմից, 179-ը՝ Dependabot-ի կողմից, և 3,025 արտաքին PR-ներ 535 տարբեր աջակիցներից: «Փոփոխված տողերը» GitHub-ի ավելացումների + ջնջումների հանրագումարն է և ներառում է գեներացված ֆայլերը, lock-ֆայլերը, կատալոգները, թարգմանությունները և փաստաթղթերը. դա ընդհանուր շարժն է, այլ ոչ թե հեղինակային կոդի տողերը (LOC): Սահմանագծին հավասար արդյունքները պահպանված են:
### GitHub-ի կողմից վերագրված commit-ներ
Bob.Hou 🏅 51 GitHub-վերագրվող կոմիտներ · #10-րդ տեղը կիսող
Xiangzhe 🏅 51 GitHub-վերագրվող կոմիտներ · #10-րդ տեղը կիսող
Վերստուգվել է 2026-08-24 06:14:31 UTC-ին: GitHub-վերագրվող կոմիտները, որոնք հաղորդվել են պահոցի Contributors API-ի կողմից `release/v3.8.50` լռելյայն ճյուղի համար: API-ն վերադարձրել է 525 ինքնություն (415 օգտատեր, 2 բոտ, 108 անանուն); այս աղյուսակը բացառում է սպասարկողին, բոտերին և անանուն ինքնությունները և պահպանում է մրցակցային կապերը: Այն տարբերվում է ինչպես վերևի միաձուլված PR-ի վարկանիշից, այնպես էլ ստորև ներկայացված 639 հոգանոց Git-մետատվյալների մարդահամարից:
> 🙏 Այս ներդրողների կողմից տրամադրված հնարավորությունները, սխալների շտկումները և ենթակառուցվածքային բարելավումները **հիմնական մասն են** այն ամենի, ինչը OmniRoute-ն դարձնում է հուսալի և հարուստ գործառույթներով: Յուրաքանչյուր pull request, յուրաքանչյուր թեստային դեպք և յուրաքանչյուր i18n թարգմանության ֆայլ կարևոր է: Բաց կոդով ծրագրակազմը ստեղծվում է նրանց նման մարդկանց կողմից:
---
## 💖 Հովանավորներ
Սրտանց շնորհակալություն այն մարդկանց, ովքեր իրենց միջոցներով ֆինանսավորում են OmniRoute-ը. յուրաքանչյուր ներդրում օգնում է, որ նախագիծը մնա անվճար, անկախ և շարունակի զարգանալ։
… և մյուսները, ովքեր նախընտրում են պահպանել գաղտնիությունը 💛GitHub-ի հանրային հովանավորների տվյալները կրկին վավերացվել են 2026-08-24-ին։ GitHub-ի activeOnly կարգավիճակն է որոշում վերևում նշված գործող հովանավորների պիտակները. նախկինում հրապարակայնորեն նշված միանվագ աջակիցներին շարունակում ենք շնորհակալություն հայտնել, իսկ գաղտնի հովանավորները մնում են անանուն։💖 Դարձեք հովանավոր → — յուրաքանչյուր դոլար օգնում է OmniRoute-ը պահել անվճար և անկախ։
## 👥 600+ ներդրողներ
[](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
Ստուգվել է 2026-08-24-ին՝ սառեցված բազային ac02c5b42f տարբերակում, և կրկին ստուգվել ընթացիկ release/v3.8.50 տարբերակի վերջին dafb4ae808 կետում. 639 նորմալացված մարդկային Git ինքնություն՝ 407-ը հանդես են գալիս որպես commit-ի հեղինակներ (ներառյալ սպասարկողը), իսկ 232-ը՝ միայն բացահայտ Co-authored-by վերջնագրերում։ Հաշվառումը նորմալացնում է GitHub-ի noreply օգտանունները, բացառում է բոտերի/գործակալների/ծառայությունների/տեղապահների 26 ինքնություն և չի միավորում սովորական էլփոստի հասցեները միայն այն պատճառով, որ դրանց ցուցադրվող անունները համընկնում են։
### Ինչպես ներդրում կատարել
1. Ստեղծեք շտեմարանի fork-ը
2. Ճյուղավորեք **գործող** `release/vX.Y.Z` տարբերակի վերջին կետից (ոչ թե `main`-ից) — տե՛ս [Ճյուղավորման և թողարկման մոդելը](docs/ops/BRANCHING_MODEL.md)
3. Ստեղծեք ձեր գործառույթի ճյուղը (`git checkout -b feat/amazing-feature`)
4. Commit արեք ձեր փոփոխությունները (`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)**-ի ֆորկ և Go-ով գրված **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** նախագծի TypeScript պորտ, իսկ այնուհետև ստորև ներկայացված յուրաքանչյուր ենթահամակարգ ոգեշնչվել է իրենից առաջ այդ խնդիրը լուծած բաց կոդով նախագծից։ Դրանցից յուրաքանչյուրը ձևավորել է OmniRoute-ի որոշակի մասը։ Սա մեր շնորհակալությունն է նրանց բոլորին։ 🙏
> ⭐ աստղերի քանակը ստուգվել է GitHub-ի REST API-ի միջոցով 2026 թվականի օգոստոսի 24-ին․ գնացե՛ք և աստղ տվեք այս նախագծերին։ Նշված քանակները տվյալ ամսաթվի ճշգրիտ պատկերն են և, բնականաբար, ժամանակի ընթացքում կփոխվեն։
### 🧬 Ծագումնաբանություն և դարպաս
AI դարպասը, որի գնագոյացման հանրային տվյալակազմը մատակարարում է ծախսերի հետագծման մեր համաժամացմանը, իսկ մատակարարների նորմալացման մոդելն ուղղություն է տվել մեր երթուղավորմանը։
MIT աղբյուր, որը հարմարեցվել է ներկառուցված ChatGPT Web → Codex Responses կամրջում՝ ներառյալ դիտարկիչի աշխատաշրջանի, պատասխանի շրջանակման, օգտագործման և վեբ որոնման ադապտերները։
Հոսքի վերականգնման, առանց մտածողության կեղծանունների, պահուստային վեբ որոնման, սահող պատուհանի սահմանաչափերի, մատյանների խմբագրման և ամրապնդված գործարկիչների հոսքերի մեջ տեղափոխված օրինաչափություններ։
Դրա Grok մոդելների համապատասխանեցումները, կեղծ TypeError-ով Statsig գեներատորը, հարցման և սարքի լռելյայն արժեքները և NDJSON պատասխանի մշակիչը էականորեն հարմարեցվել են OmniRoute-ի Grok Web կատարիչում։
grok2api-merged-ի հիմքում ընկած հիմնական անուղղակի կոդային աղբյուրը․ դրա մոդելի, վերնագրերի, օգտակար բեռի, Statsig-ի և մշակիչի իրականացումները պահպանվել են Grok Web-ի ծագումնաբանության մեջ։
Grok-ի օգտակար բեռի և սարքի լռելյայն արժեքների, Statsig գեներատորի և result.response մշակիչի հիմքում ընկած MIT աղբյուրը, որը փոխանցվել է TQZHR-ի և grok2api-merged-ի միջոցով։
Անուղղակի աղբյուր, որին grok2api-merged-ը հղում է անում իր պրոքսի-փուլի շերտի համար․ OmniRoute-ը պահպանում է այդ ծագումնաբանական նշումը, սակայն չի հավակնում, որ իր սահմանափակ Grok Web կատարիչը պրոքսի-փուլի պորտ է։
Grok Web-ի սկզբնական իրականացումը հիմնվել է դրա HTTP/դիտարկիչային վերին հոսքի նախագծման վրա․ դրա անմիջական HTTP ուղին բխում է GrokProxy-ից, ուստի անկախ կոդային պորտի մասին պնդում չի արվում։
Վիրուսային դարձած «ինչու օգտագործել շատ թոքեն, երբ քիչ թոքեն գործ անել» նախագիծը․ դրա քարանձավաբնակային խոսքի փիլիսոփայությունն ընկած է մեր ստանդարտ սեղմման ռեժիմի և ավելորդ բառերի հեռացման/խտացման ավելի քան 30 կանոնների հիմքում։
Հուշումների սեղմման հետազոտություն (LLMLingua / LLMLingua-2)․ ոգեշնչել է մեր ասինխրոն, կոդի համար անվտանգ, խափանման դեպքում բաց գործող llmlingua շարժիչը։
PT-BR թոքենների սեղմում․ ապահովում է մեր pt-BR լեզվային փաթեթի աշխատանքը՝ ավելաբանության կրճատում և ավելորդ բառերի հեռացում՝ հարմարեցված բրազիլական պորտուգալերենի քերականությանը։
Վիրուսային դարձած «ծույլ ավագ ծրագրավորող» YAGNI-կոդավորման հմտությունը․ ոգեշնչել է մեր ավելի քիչ կոդ ելքի ոճը՝ նվազագույն աշխատող փոփոխության ուղղորդում, որը կրճատում է _գեներացվող_ կոդը (Caveman-ի հակիրճ արձակի ելքային առանցքի համարժեքը)։
Դրա՝ գործողությունն առաջնահերթ համարող, ADHD ունեցող մարդկանց համար հարմար պատասխանների ոճը հարմարեցվել է OmniRoute-ի հակիրճ ելքային ոճին՝ հինգ լեզուներով։
### 🧩 Կոմպակտ ձևաչափեր, թոքենների հետազոտություն և կոդը հաշվի առնող գործիքակազմ
Բովանդակությունը հաշվի առնող, ըստ ֆայլի տեսակի ելքի սեղմում՝ խափանումները հաշվի առնող հրաժարման մեխանիզմով․ հաստատել է ըստ տեսակի մեր ուղղորդման և նվազագույն շահույթի դեպքում բաց թողնելու մոտեցումը։
Rust սյունակային JSON + ըստ բովանդակության հասցեավորվող առբերում + հաղորդագրությունների միջև կրկնօրինակների վերացում․ հաստատել է մեր headroom/ccr/session-dedup շարժիչների նախագծումը և քեշի նկատմամբ կայուն «սեղմված ձևը դիրքից անկախ է» ինվարիանտը։
TypeScript Compiler API գործիքակազմ․ ոգեշնչել է վերլուծիչի վրա հիմնված մեկնաբանությունների հեռացման մեր մեխանիզմը, որը պահպանում է տողային, ձևանմուշային և կանոնավոր արտահայտությունների լիտերալները։
Կոդավորման օգնական ↔ LLM երթևեկության MITM որսալը/վերլուծությունը ձևավորեց Traffic Inspector-ի սկզբնական պահանջները։ Նախկինում ածանցված չորս մոդուլները՝ SSE միավորումը, զրույցների նորմալացումը, գաղտնիքների քողարկումը և վերնագրերի մաքրումը, փոխարինվել են հանրային արձանագրությունների ստանդարտների հիման վրա ստեղծված անկախ, մաքուր սենյակի սկզբունքով իրականացումներով։ Հոսթի միջանցիկ փոխանցման երկու մակերեսները (passthrough.ts և _internal/bypass.cjs) շարունակում են մնալ OmniRoute-ի ներքին իրականացումներ՝ անկախ դասակարգմամբ․ դրանք այդ փոխարինման շրջանակում չեն վերագրվել։
Յուրաքանչյուր գործընթացի համար թափանցիկ պրոքսի երթուղավորում․ ոգեշնչեց խափանումների նկատմամբ անվտանգ MITM ապամոնտաժումը, սոկետների անգործության ժամանակային սահմանները, /proc-ի միջոցով գործընթացների վերագրումը և TPROXY որսումը։
Istio ծառայությունների ցանցի դիտարկելիություն․ ոգեշնչեց Routing/Combo Studio-ում մեր շղթայական անջատիչների նշաններն ու սխալների եզրերի տեսողական տարրերը։
Լռելյայն անվտանգ գրադարանների համակարգված ցանկ, որն ուղղորդում է անվտանգության մեր ընտրությունները (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink)։
Բացահայտեց Grok Build-ի քվոտայի մակերեսը, որից հետո OmniRoute-ն անկախորեն ստուգեց և ուղղեց հաղորդալարային կենդանի ձևաչափը։
## 📄 Լիցենզիա
MIT լիցենզիա — մանրամասների համար տե՛ս [LICENSE](LICENSE)։
---
**[⬆ Վերադառնալ վերև](#-omniroute)** · Ստեղծված է ❤️-ով՝ բաց կոդով AI համայնքի համար։
OmniRoute v3.8.52 · Node ≥22.22.2 · MIT լիցենզիա · omniroute.online