# README (Gaeilge) 🌐 **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) · 🇮🇳 [gu](../gu/README.md) · 🇳🇬 [ha](../ha/README.md) · 🇮🇱 [he](../he/README.md) · 🇮🇳 [hi](../hi/README.md) · 🇭🇷 [hr](../hr/README.md) · 🇭🇺 [hu](../hu/README.md) · 🇦🇲 [hy](../hy/README.md) · 🇮🇩 [id](../id/README.md) · 🇳🇬 [ig](../ig/README.md) · 🇮🇹 [it](../it/README.md) · 🇯🇵 [ja](../ja/README.md) · 🇬🇪 [ka](../ka/README.md) · 🇰🇭 [km](../km/README.md) · 🇮🇳 [kn](../kn/README.md) · 🇰🇷 [ko](../ko/README.md) · 🇱🇹 [lt](../lt/README.md) · 🇱🇻 [lv](../lv/README.md) · 🇮🇳 [ml](../ml/README.md) · 🇮🇳 [mr](../mr/README.md) · 🇲🇾 [ms](../ms/README.md) · 🇲🇹 [mt](../mt/README.md) · 🇲🇲 [my](../my/README.md) · 🇳🇵 [ne](../ne/README.md) · 🇳🇱 [nl](../nl/README.md) · 🇳🇴 [no](../no/README.md) · 🇮🇳 [or](../or/README.md) · 🇮🇳 [pa](../pa/README.md) · 🇵🇭 [phi](../phi/README.md) · 🇵🇱 [pl](../pl/README.md) · 🇵🇹 [pt](../pt/README.md) · 🇧🇷 [pt-BR](../pt-BR/README.md) · 🇷🇴 [ro](../ro/README.md) · 🇷🇺 [ru](../ru/README.md) · 🇱🇰 [si](../si/README.md) · 🇸🇰 [sk](../sk/README.md) · 🇸🇮 [sl](../sl/README.md) · 🇷🇸 [sr](../sr/README.md) · 🇸🇪 [sv](../sv/README.md) · 🇰🇪 [sw](../sw/README.md) · 🇮🇳 [ta](../ta/README.md) · 🇮🇳 [te](../te/README.md) · 🇹🇭 [th](../th/README.md) · 🇹🇷 [tr](../tr/README.md) · 🇺🇦 [uk-UA](../uk-UA/README.md) · 🇵🇰 [ur](../ur/README.md) · 🇺🇿 [uz](../uz/README.md) · 🇻🇳 [vi](../vi/README.md) · 🇳🇬 [yo](../yo/README.md) · 🇨🇳 [zh-CN](../zh-CN/README.md) · 🇹🇼 [zh-TW](../zh-TW/README.md) ---

# 🚀 OmniRoute — An Geata AI Saor in Aisce **Cruthaithe ag [Diego Souza](https://github.com/diegosouzapw)**

OmniRoute — Ná stop den chódú riamh. Gach uirlis AI → 388 soláthraí — 150+ saor in aisce — trí chríochphointe amháin. Claude Code, Codex, Cursor, Cline, Copilot & Antigravity isteach i Claude / GPT / Gemini SAOR IN AISCE le cúltaca uathoibríoch. Sábhálann comhbhrú cruachta RTK + Caveman 15–95% de na comharthaí (~89% ar an meán) — ná sroich teorainneacha riamh. 388 soláthraí AI · 150+ sraith saor in aisce · ~1.62B comhartha saor in aisce/mí · 20 straitéis ródaithe · $0 chun tosú.

## 💰 ~1.62B Tócan / Mí Ar fud Sraitheanna Saor in Aisce Tríú Páirtithe

> **Tabhair do chuntais soláthraithe féin leat.** Is meastachán comhiomlánaithe é seo ar fud sraitheanna saor in aisce tríú páirtithe atá incháilithe ar leithligh, ní deontas tócan ó OmniRoute. Cláraigh, faigh dintiúir nuair is gá, agus ceangail na soláthraithe is féidir leat a úsáid; is é gach soláthraí a rialaíonn a theorainneacha, a infhaighteacht agus a théarmaí. > > Is pianmhar sraitheanna saor in aisce a chruachadh de láimh — an iliomad SDKanna, an iliomad teorainneacha ráta, agus gan aon tuairim cé mhéad atá agat i ndáiríre. Déanann OmniRoute catalógú ar **465 iontráil saor-sraithe thar 34 eochair linnte athfhillteacha** agus ríomhann sé an ceannlíne tócan ó na **17 linn a bhfuil buiséad dearfach míosúil foilsithe acu móide cúig theorainn Groq in aghaidh na samhla**, agus iad dí-dúbláilte de réir linn chomhroinnte. Taispeántar ar leithligh cuótaí nach n-osclaíonn ach tar éis seiceáil aitheantais réigiúnaí (inniu: ModelScope), +~6M tar éis fíorú aitheantais réigiúnaí, agus ní chuirtear san áireamh sa cheannlíne riamh iad. Fanann an toradh le feiceáil ar an deais (`/dashboard/free-tiers`).

Cárta buiséid sraithe saor in aisce OmniRoute: ~1.62B tócan saor in aisce in aghaidh na míosa go seasta, suas le ~2.22B sa chéad mhí le creidmheasanna clárúcháin, ó 34 eochair linn athfhillteach doiciméadaithe a chlúdaíonn 465 iontráil saor-sraithe chatalógaithe taobh thiar d'aon chríochphointe amháin. Matamaitic ionraic dí-dúbláilte de réir linne — gach linn chomhroinnte san áireamh uair amháin, lena n-áirítear 17 linn athfhillteacha a bhfuil buiséad dearfach míosúil tócan foilsithe acu móide cúig theorainn Groq in aghaidh na samhla; tá 12 soláthraí marcáilte mar sholáthraithe le seachaint i gcatalóg riosca na dtéarmaí ionas gur féidir leat cinneadh a dhéanamh. Áirítear sa bharra buiséid Mistral 1B, Nara 210M, LLM7 150M, xKiro 150M, Groq 30M (cúig theorainn in aghaidh na samhla) agus linnte níos lú, móide creidmheasanna clárúcháin na chéad míosa agus soláthraithe atá saor in aisce go buan gan teorainn tócan a chuirtear i láthair ar leithligh ionas nach méadóidh siad an ceannlíne choíche. Úsáidte/fágtha beo ar /dashboard/free-tiers.

> Achoimre bheoite ar an leathanach beo `/dashboard/free-tiers`. Modheolaíocht iomlán (dí-dúbailt linnte, sraitheanna creidmheasa, téarmaí soláthraithe): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**. > > _{Athiniúchtáiltear na figiúirí seo gach coicís i gcoinne na catalóige beo agus **athraíonn siad sa dá threo** — má chuireann soláthraí deireadh le sraith saor in aisce, titeann an uimhir; má thagann ceann nua i láthair, ardaíonn sí. Foilsímid an méid a ríomhann an chatalóg i ndáiríre, agus ní cás is fearr atá slánaithe suas riamh.}

⭐ Tabhair réalta don stóras má chuidigh OMNIROUTE leat airgead a shábháil agus do chuid oibre a dhéanamh níos éasca.

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

[![Rang Stair na Réaltaí](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) ### 💬 Bí páirteach sa phobal **👋 Lean an cothaitheoir — faigh soláthraithe nua, eisiúintí agus leideanna ar dtús:** [![Lean Diego ar 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/) [![Lean @diegosouzapw ar 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 Domhanda](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 na Brasaíle](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) [![Suíomh Gréasáin](https://img.shields.io/badge/Website-omniroute.online-blue?logo=google-chrome&logoColor=white)](https://omniroute.online) **Ceisteanna, leideanna faoi sholáthraithe, treochlár agus tacaíocht → [Discord](https://discord.gg/U47eFqAXCn) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 Domhanda](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) / [🇧🇷 An Bhrasaíl](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) / [Tairseach](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK)**
## 📈 Tá an Geata ag Fás i gCónaí

| | v3.8.50 | **v3.8.51** | `v3.8.54+` | | ---------------------------------------- | :---------------------: | :---------: | :-------------------: | | 🌐 Soláthraithe | 352 | **358** | 388 | | 🧠 Aitheantóirí uathúla samhlacha comhrá | 1320 | **1374** | 1491 | | 🖼️ Droichead ilmhódúlachta | 🆕 fís + fuaim + físeán | ✓ | ✓ | | 📡 Catalóg shaor Radar | 🆕 rogha isteach | ✓ | ✓ | | ⚖️ Sceidealú feasach ar chuótaí | 🆕 Quota-Share | ✓ | ✓ | | 📊 Teiliméadracht chuótaí | 🆕 beo | ✓ | ✓ | | 🧰 Mód gan cheann | — | — | 🆕 `serve --headless` | | 🛤️ Bonneagar iarnróid LTS | — | — | 🆕 cainéil eisithe | | 🔎 API fionnachtana samhlacha | — | — | 🆕 `/v1/models/query` | **→ [Treochlár](ROADMAP.md) — ag taisteal ar an iarnród go `v3.9.0 LTS`**

## 🧩 Ar fáil [![Leagan npm](https://img.shields.io/npm/v/omniroute?color=cb3837&logo=npm)](https://www.npmjs.com/package/omniroute) ![npm míosúil](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) [![Ceadúnas: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](LICENSE) ![Aistarraingtí Docker](https://img.shields.io/docker/pulls/diegosouzapw/omniroute?label=docker%20pulls&logo=docker&color=2496ED) ![Íoslódálacha Electron](https://img.shields.io/github/downloads/diegosouzapw/omniroute/total?style=flat&label=electron%20downloads&logo=electron&color=47848F)

🚀 Tús	🚀 Tús tapa	📦 Suiteáil	🆓 Ceangail soláthraí
💡 Foghlaim	💥 An Gealltanas	🤔 Cén fáth OmniRoute	🏆 Cad a Dhéanann OmniRoute Éagsúil
⚙️ Gnéithe	🎯 Teaglamaí	🌐 Soláthraithe	🔌 CLI & MCP
	🗜️ Comhbhrú	🖥️ Cá Ritheann sé	🔒 Príobháideach
👀 Féach air	🎬 I mbun gnímh	✨ Cad atá nua	🤖 CLIanna comhoiriúnacha
💚 Tacaíocht	💚 Tacaigh / Tabhair síntiús	💬 Pobal	💖 Urraitheoirí
📦 Tionscadal	🛠️ Stack teicneolaíochta	📖 Cáipéisíocht	👥 Rannpháirtithe

🌐 I 67 teanga

## 🆓 Suiteáil, ceangail soláthraí, ansin ródáil trí chríochphointe amháin

Trí chéim: suiteáil agus tosaigh OmniRoute, ceangail soláthraí incháilithe le do chuntas féin nó le d’eochair API, ansin dírigh d’uirlis chuig localhost:20128/v1 ag úsáid eochair API OmniRoute agus samhail auto. Braitheann an ródáil ar na naisc incháilithe atá ar fáil agus ar theorainneacha an tsoláthraí.

```bash # Tar éis soláthraí a cheangal, cóipeáil d’eochair 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!"}]}' ``` _{Teastaíonn bealach incháilithe ó `auto`. D’fhéadfadh sé nach mbeadh aon spriocanna incháilithe gan eochair ag suiteáil úr, agus d’fhéadfadh soláthraí gan eochair cliaint tríú páirtí a dhiúltú. Eisiatar soláthraithe a bhfuil `tos: avoid` marcáilte orthu, Kiro san áireamh, ón ródáil uathoibríoch de réir réamhshocraithe; ní sháraíonn ceangal cuntais an socrú sin. Féach ar an [Treoir maidir le Sraitheanna Saora](docs/getting-started/FREE-TIERS-GUIDE.md) sula roghnaíonn tú soláthraí.} _{📦 Scripteanna tapa tosaithe le cóipeáil agus a ghreamú do **Python, Node.js, PHP, agus cURL** → [`examples/quickstart/`](examples/quickstart/)}

# 💥 An Gealltanas

# 🤔 Cén fáth OmniRoute?

Sreabhadh iarratais OmniRoute: glaonn d’Aitheantas Comhtháite nó do CLI (Claude Code, Cursor, Cline…) ar chríochphointe áitiúil amháin (http://localhost:20128/v1); is féidir leis an Ródaire Cliste OmniRoute (comhbhrú RTK + Caveman, 20 straitéis ródála, scoradáin chiorcaid, stealth TLS, MCP, A2A, ráillí cosanta) cúltaca a dhéanamh trasna 4 shraith soláthraithe fad is atá sprioc incháilithe shláintiúil ar fáil — Sraith 1 Síntiús, Sraith 2 Eochair API, Sraith 3 Saor agus Sraith 4 In Aisce.

## 🤝 Le tacaíocht ónár gCairde Foinse Oscailte

> **Ar mhaith leat a bheith i do Chara Foinse Oscailte?** Seo iad na cuideachtaí a thacaíonn le foinse oscailte agus a chabhraíonn le OmniRoute leanúint ar aghaidh — agus deirimid go poiblí cá dtéann gach comhartha a thugann siad dúinn. Déan teagmháil linn: [diegosouza.pw@outlook.com](mailto:diegosouza.pw@outlook.com)

Kimi
_{Moonshot AI} Gabhaimid buíochas le Kimi (Moonshot AI), ár gCara Bunaidh Foinse Oscailte, as tacú leis an tionscadal seo! Is é Kimi an tsaotharlann IS atá taobh thiar de theaghlaigh samhlacha oscailte-ualaigh K2 agus K3 — soláthraíonn Kimi K3 fuinneog chomhthéacs 1M comhartha, fís dhúchasach agus códú ar thús cadhnaíochta ar chodán de phraghsanna samhlacha dúnta, agus oibríonn sé láithreach le Claude Code, Codex agus gach uirlis chódaithe a bhfreastalaíonn OmniRoute uirthi.

An méid a chumasaíonn tacaíocht Kimi: Cumasaíonn creidmheasanna API Kimi píblíne eisiúna OmniRoute atá bailíochtaithe ag IS — an chéim bailíochtú cumaisc faoi thiomáint Kimi K3 a dhéanann athbhreithniú ar gach iarratas tarraingthe sula seoltar é — chomh maith le forbairt gnéithe ó lá go lá. Seoltar tacaíocht den chéad scoth do Kimi ar an dá bhealach: an Kimi API díreach (kimi-k3) agus an plean códaithe Kimi Code (OAuth agus eochair API). Is é OmniRoute an chéad tionscadal foinse oscailte Brasaíleach i gclár tacaíochta Kimi freisin. Faigh eochair Kimi API le 15% de chreidmheasanna breise →

Cheaper Inference
_{cheaperinference.com} Gabhaimid buíochas le Cheaper Inference, Cara Foinse Oscailte OmniRoute, as tacú leis an tionscadal seo! Is geata rangaithe de réir costais é Cheaper Inference a athdhíolann 42 samhail ar thús cadhnaíochta — Claude, GPT-5.x, Gemini, Kimi K3, GLM, DeepSeek, Grok agus MiniMax — taobh thiar d'aon chríochphointe amháin atá comhoiriúnach le OpenAI, agus a sheolann gach iarratas chuig an soláthraí incháilithe is saoire gan táille níos airde ná praghas liosta chruthaitheoir na samhla a ghearradh riamh.

Tacaíocht den chéad scoth in OmniRoute: Comhlánuithe Comhrá, an críochphointe dúchasach /v1/responses, fís, glaoch uirlisí agus 3 shamhail íomhá (grok-imagine, nano-banana-pro, nano-banana-2, ar fáil mar cheaperinference/<model>). Faigh eochair API →

_{Is naisc chomhpháirtíochta iad na naisc a bhfuil aff=omniroute orthu. Maoiníonn siad an tionscadal gan aon chostas breise ort.}

_{🎟️ Cur Chun Cinn Cleamhnaithe — cúpóin saor in aisce le clárú ó sholáthraithe nach ndéanaimid urraíocht orthu (cliceáil lena leathnú)}

_{Is le haghaidh cóid atreoraithe/cúpóin amháin atá an rannán seo. Tá comhpháirtíochtaí urraithe sa rannán 🤝 Le tacaíocht ónár gCairde Foinse Oscailte thuas. Níl aon urraíocht ná comhpháirtíocht ag OmniRoute leis na soláthraithe atá liostaithe anseo — is cúpóin phoiblí iad seo is féidir le duine ar bith a úsáid.}

_AgentRouter
_{agentrouter.org} _{AgentRouter — clárú cleamhnaithe · $100 de chreidmheasanna saor in aisce nuair a chláraíonn tú (freastalaí saor in aisce, bí ag súil le foighne níos airde — is fearr é le haghaidh tástála, ní táirgthe). Tacaíocht den chéad scoth in OmniRoute ó v3.8.50: Comhlánuithe Comhrá, an fhormáid sreinge atá comhoiriúnach le Anthropic agus an chonair atá comhoiriúnach le OpenAI. I measc na samhlacha atá ar fáil tá claude-opus-4-8, claude-opus-5, gpt-5.6-sol agus tuilleadh. Faigh do $100 →}

_{⚠️ Nasc cleamhnaithe — níl aon urraíocht ná comhpháirtíocht ag OmniRoute leis an soláthraí seo.}

_{An bhfuil eolas agat ar sholáthraí eile a bhfuil cúpón flaithiúil saor in aisce aige le clárú, a théann chun tairbhe úsáideoirí OmniRoute? Oscail saincheist agus cuirfimid anseo é.}

## 🎯 Teaglamaí — An Phríomhghné

Samplaí beoite de 18 gcinn den 20 straitéis ródaithe teaglamaí — tíl amháin in aghaidh na straitéise: 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. Níl cache-optimized ná quota-weighted beoite; déantar cur síos sa tábla thíos ar gach ceann den 20 ceann.

> Is éard is **teaglama** ann ná slabhra samhlacha a ndéanann OmniRoute ródú eatarthu **go huathoibríoch**. Má ídítear an cuóta, má theipeann ar sholáthraí, nó má ardaíonn costais go tobann, is féidir leis an teaglama bogadh ar aghaidh chuig an gcéad samhail incháilithe shláintiúil eile. 🛡️ ### ⚡ Gan chumraíocht — úsáid `auto` Ní gá teaglama a chruthú. Socraigh do shamhail mar `auto` (nó mar mhalairt air) agus tógann OmniRoute teaglama fíorúil ó do sholáthraithe nasctha, agus scóráiltear é i bhfíor-am:

Aitheantas na samhla	An rud a optamaíonn sé dó
`auto`	🎯 Réamhshocrú cothromaithe (LKGP — fanann sé le do sholáthraí maith is déanaí)
`auto/coding`	🧑💻 Ualuithe a thugann tús áite don cháilíocht le haghaidh giniúint cóid
`auto/fast`	⚡ An mhoill is ísle ar dtús
`auto/cheap`	💰 An costas is ísle in aghaidh an chomhartha ar dtús
`auto/subscription`	🎟️ An cuóta síntiúis a n-íocann tú as cheana féin amháin — dúnann sé nuair a theipeann air, gan aon chúltaca inmhuirearaithe riamh (treoir)
`auto/thrifty`	🪜 Cuóta an phlean ar dtús, ansin céim ar chéim chuig na roghanna íoctha is saoire — ar ais ar an bplean tar éis dó athshocrú (treoir)
`auto/offline`	🔋 An méid spáis is mó sa chuóta / sa teorainn ráta ar dtús
`auto/smart`	🔭 Cáilíocht ar dtús + taiscéalaíocht 10% chun samhlacha níos fearr a aimsiú
`auto/lkgp`	📌 Greamaitheacht shainráite leis an soláthraí maith is déanaí atá ar eolas
`auto/chaos`	🧪 Scaipeadh amach comhthreomhar chuig painéal samhlacha (ceann amháin in aghaidh an tsoláthraí, 5 de réir réamhshocraithe), agus cuirtear freagra amháin ar ais; glao réamhtheachtach amháin in aghaidh gach samhla painéil, ní instealladh lochta

## ### 🔀 Nó tóg do cheann féin — 20 straitéis ródaithe Gach ceann de na **20** straitéis — measc agus meaitseáil iad ag gach céim den teaglama:

#	Straitéis	An rud a dhéanann sí
1	`priority`	Liosta ordaithe de réir an chéad sprioc — ídigh gach ceann sula mbogtar ar aghaidh chuig an gcéad cheann eile 🥇
2	`fill-first`	Líon cuóta gach sprice go hiomlán sula mbogtar ar aghaidh
3	`weighted`	Roghnú randamach ualaithe de réir mheáchan gach sprice
4	`round-robin`	Téigh trí na spriocanna in ord ar bhonn timthriallach
5	`p2c`	Cothromú randamach ualaigh trí chumhacht dhá rogha
6	`least-used`	Roghnaigh an sprioc ag a bhfuil an t-ualach reatha is ísle
7	`random`	Roghnú randamach aonfhoirmeach (gan dúblaigh)
8	`strict-random`	Roghnú randamach gan athrá a dhí-dhúbláil 🎲
9	`cost-optimized`	Íoslaghdaigh $ in aghaidh na hiarrata de réir phraghsáil bheo na catalóige 💸
10	`headroom`	Roghnaigh an sprioc ag a bhfuil an cuóta is mó fágtha
11	`quota-weighted`	Scipeáil cuntais ídithe, ansin roghnaigh i gcomhréir leis an gcuóta atá fágtha ÷ an t-ualach reatha — fanann comhráite atá ann cheana pionnáilte ⚖️
12	`reset-window`	Tabhair tús áite don sprioc a n-athshocrófar fuinneog a cuóta is luaithe
13	`reset-aware`	Rangaigh de réir am athshocraithe an chuóta — fuinneoga gearra ar dtús 📊
14	`context-relay`	Cuir an comhthéacs ar aghaidh idir spriocanna le haghaidh comhráite fada 🧠
15	`context-optimized`	Roghnaigh an oiriúnacht is fearr do mhéid reatha an chomhthéacs
16	`cache-optimized`	Pionnáil gach réimír leide in-athúsáidte leis an gcuntas céanna — uasmhéadaigh amais i dtaisce na leid 🎯
17	`lkgp`	Conair Mhaith is Déanaí atá ar Eolas — pionnálann sí leis an soláthraí deireanach ar éirigh leis, ansin téann sí siar chuig rialacha
18	`auto`	Scóráil bheo 16 fhachtóir thar gach nasc 🤖
19	`fusion`	Scaip amach chuig painéal samhlacha + déanann moltóir freagra amháin a shintéisiú 🧬
20	`pipeline`	Slabhraigh céimeanna — cothaíonn aschur gach sprice an chéad cheann eile 🔗

_{Scórálann inneall Auto-Combo gach iarrthóir de réir **16 fhachtóir** (sláinte, cuóta, costas, aga folaigh, oiriúnacht don tasc, cáilíocht, infhaighteacht seisiúin…) — féach [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md).} ## ### 🧱 Tá an athléimneacht ionsuite (3 shraith neamhspleácha)

Athléimneacht OmniRoute — 3 shraith neamhspleácha fhéinchneasaithe, an tsraith cheart don teip cheart. Sraith 1: scoradán ciorcaid an tsoláthraí (an soláthraí iomlán): tuislíonn sé ar 408/5xx amháin, tairseacha OAuth 8× / eochair API 12× / áitiúil 2×, athshocraíonn sé tar éis 60s/30s/15s chuig tóireadóir HALF-OPEN, aisghabháil leisciúil; agus é OPEN, atreoraíonn an teaglama chuig an gcéad soláthraí eile. Sraith 2: tréimhse shuaimhnithe an naisc (eochair/cuntas amháin): bonn 5s OAuth / 3s eochair API, cúlú easpónantúil ×2 le cosaint ar thréad toirní, cloíonn 429 le Retry-After, glanann rath gach staid earráide; scipeáiltear eochair amháin atá i mbun suaimhnithe agus leanann eochracha eile den tseirbhís. Sraith 3: frithdhúnadh samhla (samhail amháin): déanann 429 in aghaidh na samhla, 404 áitiúil nó diúltuithe móid an tsamhail sin amháin a fhrithdhúnadh — ní an nasc iomlán riamh. Is faoin oibreoir atá stáit chríochfoirt (toirmiscthe, imithe in éag, creidmheasanna ídithe), ní tréimhsí suaimhnithe iad.

_{📖 [Inneall Auto-Combo](docs/routing/AUTO-COMBO.md) · [Treoir Athléimneachta](docs/architecture/RESILIENCE_GUIDE.md)}

## 🏆 Cad a Leagann OmniRoute Amach

_{📊 Modheolaíocht iomlán agus sonraí in aghaidh na gné i gcomparáid le 9router, OpenRouter, CLIProxyAPI agus LiteLLM → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)}
## 💚 Tacaigh le OmniRoute Tá OmniRoute ceadúnaithe faoi MIT agus á chothabháil go hoscailte. Má shábhálann sé am nó airgead duit, seo mar is féidir cabhrú leis fanacht neamhspleách — roghnaigh cibé rud a oireann duit. Ní théann urraíocht i bhfeidhm riamh ar thosaíocht ródaithe; ceannaíonn sí infheictheacht, ní rangú.

⭐ Cuir réalta leis an stór	Saor in aisce — cuidíonn sé go mór leis an infheictheacht	Cuir réalta le OmniRoute
🐙 GitHub Sponsors	Aonuaire nó míosúil · gan aon táille ardáin	github.com/sponsors/diegosouzapw
☕ Ko-fi	Síntiús tapa aonuaire, ní gá don deontóir clárú	ko-fi.com/diegosouzapw
🧋 Buy Me a Coffee	Comhartha beag neamhfhoirmiúil	buymeacoffee.com/diegosouzapw
🖐 Liberapay	Athfhillteach · neamhbhrabúsach · foinse oscailte	liberapay.com/diegosouzapw
🇧🇷 PIX (an Bhrasaíl)	Láithreach, gan táillí	eochair & cód QR thíos
₿ Criptea-airgeadra	BTC · ETH · USDT-TRC20 · USDC-Solana	seoltaí thíos

**🇧🇷 PIX** — láithreach, gan táillí (an Bhrasaíl) Cód QR PIX OmniRoute

Eochair (randamach): `5d865059-bc44-483a-962d-43ceb80126eb` PIX le cóipeáil agus greamú: ``` 00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD ```

₿ Criptea-airgeadra — BTC · ETH · USDT-TRC20 · USDC-Solana (cliceáil lena leathnú)

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

_{⚠️ Ná seol gach bonn ach ar an líonra a thaispeántar — má sheoltar ar an líonra mícheart é, d’fhéadfaí na cistí a chailleadh.}

🐛 Ar aimsigh tú fabht nó an bhfuil aiseolas agat? Oscail [Plé](https://github.com/diegosouzapw/OmniRoute/discussions).

Nótaí d’fhorbróirí: Féadfaidh an tionscadal comhad áitiúil .env a ghiniúint le linn npm install/postinstall ar mhaithe le háisiúlacht na bhforbróirí. Déantar neamhaird d’aon ghnó den chomhad seo trí .gitignore (féach .gitignore) agus níor cheart é a chur faoi rialú leaganacha choíche — má chuirtear faoi rialú leaganacha é de thaisme, rothlaigh aon rúin a nochtadh agus bain an comhad den stair. Féach docs/DEVELOPER-ENVIRONMENT.md le haghaidh treorach maidir le comhaid timpeallachta áitiúla agus rúin a bhainistiú.

## 📡 Radar OmniRoute Is é **~1.62B tóicín/mí** ón gcatalóg dhoiciméadaithe thuas, a bhfuil dúbláil bainte aisti ar fud na linnte, príomhfhigiúr na sraithe saor in aisce fós. Is féidir le creidmheasanna sealadacha clárúcháin soláthraithe an chéad mhí a ardú go **~2.22B** ar leithligh. Is forleagan catalóige roghnach sínithe é Radar do dhaoine ar mian leo infhaighteacht níos úire samhlacha saor in aisce idir eisiúintí OmniRoute; fanann catalóg an phobail agus gach gné shaor in aisce atá ann cheana saor in aisce. Is féidir le lucht tacaíochta an chatalóg bheo agus deiseanna breise soláthraithe a fháil. Is é **thart ar 3B tóicín/mí ar a mhéad** a uasteorainn ar leith inathraithe, ag brath ar infhaighteacht soláthraithe. Ní ráthaíocht í an uasteorainn sin: is féidir le soláthraithe cuótaí, incháilitheacht, samhlacha nó réigiúin a athrú am ar bith. Tá Radar roghnach agus is le GET amháin a oibríonn sé. Ní uaslódálann cliant OmniRoute leideanna, trácht, cumraíocht soláthraithe, teiliméadracht úsáide ná staid áitiúil dhíbhe na bhfógraí. Faigh eolas faoin incháilitheacht agus faoin gcatalóg reatha ag **[radar.omniroute.online/planos](https://radar.omniroute.online/planos)**.

## ✨ Cad atá Nua

> Buaicphointí le déanaí ó **v3.8.20 → v3.8.54**. An stair iomlán in [`CHANGELOG.md`](CHANGELOG.md). - **⚖️ Ródú `quota-weighted`** — seachnaíonn an 20ú straitéis teaglaim cuntais ídithe, ansin roghnaíonn sí i measc na cinn eile i gcomhréir le cuóta fágtha ÷ ualach eitilte, agus coinníonn sí comhráite atá ann cheana ceangailte. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🧰 Mód gan cheann** — ritheann `omniroute serve --headless` (nó `OMNIROUTE_HEADLESS=1`) inneall seachfhreastalaí `/v1/*` amháin, agus an painéal agus na fochórais atá teoranta don phainéal múchta. → [Mód gan Cheann](docs/guides/HEADLESS.md) - **🔎 Fionnachtain samhlacha** — scagann `/v1/models` de réir cumais, comhthéacs, cineáil agus téacs, agus tugann `POST /v1/models/query` gearrliosta gearr cinntitheach ar ais leis an infheictheacht chéanna in aghaidh na heochrach. → [Tagairt API](docs/reference/API_REFERENCE.md) - **🔑 Rialú ródaithe in aghaidh na heochrach** — bioráin `forcedModel` eochair API le samhail nó teaglaim amháin, agus cuireann sé samhlacha agus teaglamaí eochrach leis nó baintear iad go hadaimh (`/api/keys/{id}/access`). → [Tagairt API](docs/reference/API_REFERENCE.md) · [OpenAPI](docs/openapi.yaml) - **🛡️ Rialuithe PII níos míne** — roghnú in aghaidh an chineáil, suas le 20 patrún saincheaptha bailíochtaithe um chumhdach agus cuntair braite in aghaidh an chineáil; fanann an cumhdach féin roghnach. → [Cosaintí](docs/security/GUARDRAILS.md) - **🌍 67 teanga** — an painéal, scátháin na cáipéisíochta agus an CLI, agus cuireann `npm run i18n:add-locale` teanga leis i ngach áit le hordú amháin. → [Treoir i18n](docs/guides/I18N.md) - **🎛️ OmniConductor** — tarmligean A2A isteach chuig do chabhlach gníomhairí, scileanna Conductor ar an gCárta Gníomhaire, agus painéal le comhrá gutha brúigh-chun-labhairt Faro. → [Freastalaí A2A](docs/frameworks/A2A-SERVER.md) - **🛂 Glacadh oiriúnaitheach agus cosaint ró-ualaigh** — cuirtear iarratais chomhrá thromchúiseacha i scuaine seachas 503 a thabhairt, le léasanna rollta RPM adamhacha in aghaidh an naisc. → [Treoir Athléimneachta](docs/architecture/RESILIENCE_GUIDE.md) - **🗂️ Ordú canónach `/v1/models`** — bloc comhleanúnach amháin grúpáilte de réir soláthraí in aghaidh an tsoláthraí (teaglamaí bioraithe ar dtús), cobhsaí trasna gach foinse catalóige. → [Tagairt API](docs/reference/API_REFERENCE.md) - **🗜️ Neartú comhbhrúite** — garda boilscithe cumasaithe de réir réamhshocraithe, pacáistí Caveman do DE / FR / JA agus Sínis (wényán), scagairí RTK do Gradle agus .NET. → [Comhbhrú](docs/compression/COMPRESSION_ENGINES.md) - **💸 Costas cothrom-ráta macánta** — léann soláthraithe síntiúis / pleananna códála **$0** in anailísíocht costas; leanann buiséad, cuóta agus ródú den mheastachán. → [Tagairt API](docs/reference/API_REFERENCE.md) - **⚖️ Ródú Quota-Share** — roinneann sé cuóta cuntais chomhroinnte go cothrom thar eochracha comhthiomsaithe, agus tugtar slisní díomhaoin ar iasacht ionas go mbaintear úsáid éifeachtach astu. → [Treoir Athléimneachta](docs/architecture/RESILIENCE_GUIDE.md) - **🤖 Socrú CLI/gníomhaire le hordú amháin** — 15 ordú `setup-*` cláraithe; seolann `omniroute run` 7 CLI (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); tacaíonn `omniroute configure` le 11 sprioc le roghnóir idirghníomhach soláthraí+samhlach agus ceanáin in aghaidh an chomhthéacs. → [Comhtháthuithe CLI](docs/guides/CLI-INTEGRATIONS.md) - **🛰️ Mód cianda** — rialaigh OmniRoute cianda le comharthaí teoranta ó thaobh raoin (`connect` / `contexts` / `tokens`) + cúntóir OAuth `antigravity` do shuiteálacha VPS. → [Mód Cianda](docs/guides/REMOTE-MODE.md) - **🧭 Uathródú níos cliste** — teaglamaí `auto/:`, **Fusion** (painéal samhlacha + breitheamh), ródú atá feasach ar thascanna, agus sáruithe in aghaidh na hiarrata ar shamhail / mhód / bhuiséad USD. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🗜️ Comhbhrú inphlugáilte** — 12 inneall in-chomhchodaithe + Compression Studios: LLMLingua-2, Ultra dhá shraith, omniglyph, geata dílseachta in aghaidh na céime, GCF v3.2, eagarthóir tarraing-agus-athordú. → [Comhbhrú](docs/compression/COMPRESSION_ENGINES.md) - **🕵️ Díchriptiú MITM trédhearcach (TPROXY)** — CLIanna gabhála a dhéanann neamhaird d’athróga timpeallachta an tseachfhreastalaí, le suiteálaí CA in aghaidh an SNI + stór iontaoibhe. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md) - **💸 Teiliméadracht costas i ngach áit** — ceanntásca costais/úsáide `X-OmniRoute-*` ar gach críochphointe, ceanntásc coigiltis HIT taisce, agus cuótaí caiteachais USD in aghaidh na heochrach. → [Tagairt API](docs/reference/API_REFERENCE.md) - **🧠 Cuimhne faoi do smacht** — múchta de réir réamhshocraithe, cainníochtú veicteora int8 roghnach + meath clóscríofa, agus `x-omniroute-no-memory` in aghaidh na hiarrata. → [Cuimhne](docs/frameworks/MEMORY.md) - **🛡️ Slándáil** — garda in aghaidh instealladh leideanna ar gach bealach LLM (sraith red-team), cosaint chumhdaigh dintiúr roghnach (déanann sé eochracha API/rúin sceite a cheilt sa dá threo), cuardach gréasáin DuckDuckGo saor in aisce mar rogha dheiridh, agus geata logála isteach roghnach OIDC don phainéal (fanann logáil isteach le pasfhocal ar fáil i gcónaí). → [Cosaintí](docs/security/GUARDRAILS.md) - **🖼️ Críochphointí nua** — comhlánaíonn `/v1/ocr` (Mistral OCR) agus `/v1/audio/translations` (stíl Whisper) an dromchla meán. → [Tagairt API](docs/reference/API_REFERENCE.md) - **🎨 Giniúint íomhánna / físeáin / fuaime** — API amháin do mheáin: físeán xAI Grok Imagine agus Novita AI, ComfyUI, Magnific, Adobe Firefly, Segmind, agus soláthraithe cainte ar nós ElevenLabs. → [Tagairt API](docs/reference/API_REFERENCE.md) - **🌍 Imscaradh agus oibríochtaí** — `basePath` seachfhreastalaí droim ar ais, uathbhraith teanga an bhrabhsálaí, rianú gléis in aghaidh na heochrach, muinín MITM gan fhréamh, logánú zh-TW. → [Timpeallacht](docs/reference/ENVIRONMENT.md) - **🤝 Tuilleadh soláthraithe agus gníomhairí** — gníomhairí néil (Codex Cloud, Cursor, Devin, Jules), Grok Build (xAI) le brabhsálaí + logáil isteach OAuth, cárta Ollama den chéad scoth, Claude Opus 5 agus Sonnet 5, comhpháirtíocht oifigiúil Kimi (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… agus catalóg athnuaite de **388 soláthraí**. → [Soláthraithe](docs/reference/PROVIDER_REFERENCE.md) - **📡 Trédhearcacht ródaithe** — iompraíonn gach freagra ceanntásc `X-OmniRoute-Decision` a ainmníonn an straitéis/soláthraí/moille a sheirbheáil é; cuireann straitéis teaglaim nua `cache-optimized` + fachtóir Auto-Combo `cacheAffinity` iarratais athdhéanta ar ais chuig an nasc a bhfuil an réimír taiscthe aige; agus nochtann críochphointe inléite amháin `/v1/auto-combo/{channel}/candidates` linn bheo iarrthóirí cainéil `auto/*`. → [Auto-Combo](docs/routing/AUTO-COMBO.md). - **⚡ Feidhmíocht áitiúil agus bonneagar** — Redis áitiúil le cliceáil amháin, imlonnóirí athsheachadáin Cloudflare Workers / Deno Deploy, agus Bifrost & Mux mar sheirbhísí leabaithe faoi mhaoirseacht. → [Seirbhísí Leabaithe](docs/frameworks/EMBEDDED-SERVICES.md) - **🧩 Sa bhosca freisin** — creat breiseán + margadh, creataí scileanna Omni/Agent/GitHub, comhtháthú cruinneacháin Obsidian (22 uirlis MCP), APIs Batch & Files atá comhoiriúnach le OpenAI, taisce freagartha shéimeantach, cluichíocht le cláir cheannródaíochta, aimsiú gníomhairí ACP (15 ghníomhaire ionsuite), easpórtáil sceidealaithe logaí chuig BigQuery, luchtú amach comhthreomhar ilmhúnlaí `auto/chaos`, droichead bot Telegram, bainisteoir leaganacha in-aip agus ranguithe soláthraithe saor in aisce LMArena-ELO. → [Doiciméadú](docs/README.md)

## 🤖 CLIs & Gníomhairí Cóid Comhoiriúnacha > Aon chumraíocht amháin — `http://localhost:20128/v1` — agus ritheann **gach** IDE AI nó CLI ar mhúnlaí saor in aisce & ar chostas íseal.

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

＋ oibríonn sé freisin le · Agent Deck · Kiro · Command Code · Antigravity · Windsurf · AMP · aon uirlis atá comhoiriúnach le OpenAI

_{📖 Socrú in aghaidh uirlis do gach ceann de na 39 uirlisí (28 CLI Code's + 11 CLI Agents) → [`docs/reference/CLI-TOOLS.md`](docs/reference/CLI-TOOLS.md) · 🧩 Breiseán OpenCode → [`@omniroute/opencode-provider`](https://www.npmjs.com/package/@omniroute/opencode-provider)}

**Tosaigh aon CLI tacaíochta trí OmniRoute le haon ordú amháin** — gan aon chomhaid chumraíochta scríofa, dintiúir insteallta in aghaidh próisis, faigheann Qwen/Gemini baile scoite sealadach: ```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" # Nó roghnaigh soláthraí+múnla go hidirghníomhach agus scríobh cumraíocht uirlise féin: omniroute configure codex # freisin: claude opencode qwen aider goose gemini cline continue kilo 5dive ``` Géilleann gach ordú don chomhthéacs cianda gníomhach (`omniroute connect `), taispeánann `--dry-run` an timpeallacht/args cruinn gan é a rith, agus coimeádann `--api-key-env NAME` rúin as do stair bhlaosc. → [Comhtháthuithe CLI](docs/guides/CLI-INTEGRATIONS.md)

## 🌐 388 Soláthraí AI — 153 Marcáilte sa Chatalóg mar Shaor

> **388 soláthraí cláraithe** sna bailiúcháin chanónacha comhrá, meán, cuardaigh, áitiúla, gníomhairí néalbhunaithe agus chórais, lena n-áirítear **153 a bhfuil meiteashonraí fionnachtana `hasFree: true` acu**. Clúdaíonn clárlann na samhlacha comhrá **239 soláthraí / 3,059 péire soláthraí-samhail ar leith / 1,475 aitheantóir amh samhla**; tá **471 ró in aghaidh na samhla**, **34 linn athfhillteacha** agus **52 soláthraí athfhillteacha/saor go deo gan eochair** sa chatalóg bhuiséid shaor ar leith. Is ainmneoirí éagsúla iad seo de réir dearaidh; tá na sainmhínithe agus na ríomhanna dí-dúbláilte de réir linne sa [Tagairt Soláthraithe](docs/reference/PROVIDER_REFERENCE.md) agus sna [Sraitheanna Saora](docs/reference/FREE_TIERS.md).

### 🏢 Gach saotharlann mhór — trí chríochphointe amháin

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

_{…agus breis agus 350 eile — réitíonn gach deilbhín beo ó chatalóg soláthraithe an deais. 📖 [Tagairt Soláthraithe](docs/reference/PROVIDER_REFERENCE.md)}
### 🆓 Saor go Deo — $0, gan chárta

OpenCode Zen _{DeepSeek V4, Nemotron 3 Gan teorainn ar chomharthaí}	Kilo Code _{Uathródaitheoir, Tencent Hy3 Saor go deo}	Requesty _{GPT-OSS 120B, Nemotron Saor go deo}	SiliconFlow _{DeepSeek V3.2 / R1 Sraith saor in aisce}	Z.AI GLM _{GLM-4.7 / 4.5-Flash Saor go deo}	Baidu ERNIE _{ERNIE 4.0 Saor go deo}
Qoder AI _{Qwen3-Max, Kimi-K2 SAOR gan teorainn}	Pollinations _{GPT, Llama, Claude Níl eochair ag teastáil}	Cloudflare AI _{50+ samhail 10K néarón/lá}	NVIDIA NIM _{GLM, MiniMax ~40 RPM saor in aisce}	Cerebras _{GLM 4.7, GPT-OSS Creidmheas aonuaire $5; cárta riachtanach}	OpenRouter _{:free models +$10 → RPM níos airde}

📖 Catalóg iomlán inléite ag meaisín → [`docs/reference/PROVIDER_REFERENCE.md`](docs/reference/PROVIDER_REFERENCE.md)

## 🖥️ Cá Ritheann OmniRoute - Áit ar bith

> An aip chéanna, do mheaisín, do rialacha. Ó shuiteáil npm domhanda go** do ghuthán** trí Termux. Ardán

	Suiteáil	Buaicphointí
📦 npm (global)	`npm install -g omniroute`	Ordú amháin, aon OS
⚡ Bun (domhanda)	`bun cuir -g omniroute`	Tarball clárlainne céanna, suiteálann sé níos tapúla
🐳 Docker	`docker run … diegosouzapw/omniroute`	Il-áirse AMD64 + ARM64
🖥️ Deasc (Electron)	`npm run electron: tóg`	Fuinneog + córais zqm — Windows / macOS / Linux
🎩 barra Roghchláir (OmniRouteTray)	`brew install --cask zoispag/tap/omniroute-tray`	Maoirsíonn & an freastalaí a nuashonrú go huathoibríoch — macOS
💪 ARM	`arm64`	Raspberry Pi, freastalaithe ARM, Apple Silicon
📱 Android ( Termux )	`pkg shuiteáil nodejs && npx -y omniroute`	Ritheann do ghuthán , 24/7, gan fhréamh
📲 PWA	"Cuir leis an Scáileán Baile"	Lánscáileán, as líne, is féidir é a shuiteáil ón mbrabhsálaí
🧩 OpenCode breiseán	`@omniroute/opencode-provider`	Comhtháthú OpenCode Dúchasach
🤖 VS Cód Copilot Comhrá	shuiteáil OmniCopilot síneadh	OmniRoute samhail zqo sa roghnóir Comhrá Copilot dúchais — cobhsaí & Insiders
🛠️ Ó fhoinse	`npm install && npm run dev`	Hack ar sé, rannchuidigh

[Docker](docs/guides/DOCKER_GUIDE.md)_{📖 zqc · [Deisce](electron/README.md) · [Tráidire barra roghchláir](https://github.com/zoispag/omniroute-tray) · [Termux](docs/guides/TERMUX_GUIDE.md) · [PWA](docs/guides/PWA_GUIDE.md) · [OpenCode](docs/frameworks/OPENCODE.md)}

### 🧩 Nua: OmniRoute taobh istigh VS Cód dúchais Copilot Comhrá

> Uimh sidebar nua, aon comhrá nua UI - gach samhail a fhreastalaíonn ar OmniRoute léiríonn suas díreach sa**Copilot Roghnóir múnla comhrá a úsáideann tú cheana féin** . Ós rud é go Cód VS 1.122, oibríonn samhlacha soláthraithe gan síniú isteach GitHub nó síntiús Copilot - modh gníomhaire, glaoch uirlisí agus fís, saor in aisce. Suiteáil an** [OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)** síneadh, cuir in iúl é ag do fhreastalaí OmniRoute (réamhshocraithe go `localhost:20128`), ansin oscail Copilot Chat → model picker →** Bainistigh Múnlaí…** →**OmniRoute** . < td ailíniú ="clé">VS Cód — cobhsaí & Insiders

Store	Nasc	Oibríonn sé le
🧩 VS Cód Áit an Mhargaidh	Suiteáil →
🔓 Oscailte VSX Chlárlann	Suiteáil →< td ailíniú ="clé">Cursor, Windsurf, VSCodium, Theia, cód-freastalaí, Gitpod, Antigravity, Kiro…

Ón taobh istigh den eagarthóir: oscail an** Eisínteachtaí** amharc, cuardach** "OmniRoute"** , cliceáil** Suiteáil** — oibríonn ar an mbealach céanna ar an dá stór. Foinse, eisiúintí agus an leabhar reatha foilsitheoireachta beo ag [diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot). _{📖 [VS Code Copilot Treoir comhrá](docs/guides/VSCODE-COPILOT.md) — socrú, cad a thaispeánann an roghnóir, painéal i gcluaisín, fabhtcheartú}

### 🎩 Nua: OmniRouteTray — do gheata, ina gcónaí sa bharra roghchláir

> Tá `omniroute serve` níos sona nuair a bhíonn sé ar siúl i gcónaí.** [OmniRouteTray](https://github.com/zoispag/omniroute-tray)** iompaíonn sé sin ina aip barra roghchláir socraithe agus dearmad le haghaidh macOS: cuireann sé tús leis an bhfreastalaí, coinníonn sé beo é thar atosaithe, déanann sé é a nuashonrú, agus cuireann sé do bhuiséad comhartha beo cliceáil ar shiúl -** níl aon fhuinneog teirminéil fágtha ar oscailt, gan aon `npm install -g omniroute` le cúram leanaí.** Tógtha le [Tauri v2](https://v2.tauri.app/) (croílár Rust ar mhéid earráid shlánaithe), seolann sé a chuid ama rite Node 24 sínithe féin agus bainistíonn sé suiteáil OmniRoute faoi úinéireacht app, mar sin ní throideann sé do `node`/`bun` domhanda riamh. é** scaireanna do chumraíocht `~/.omniroute/` agus bunachar sonraí atá ann cheana féin** - mar sin is é an OmniRoute céanna a ritheann tú cheana féin, díreach le hata air. 🎩 logs

Cad a dhéanann sé	Conas
🟢 Maoirsíonn sé an freastalaí	Spawns `omniroute server` , glacann sé cás atá ar siúl cheana féin seachas é a dhúbailt
📊 Sracfhéachaint ar úsáid bheo	Barraí cuóta an tsoláthraí, teorainneacha Claude session/weekly le comhaireamh anuas athshocraithe, miondealú costais 30 lá
🔄 Auto-nuashonruithe i bhfeidhm	Suiteáil céimnithe, babhtáil adamhach, rolladh siar ar theip — i gcónaí ar an scaoileadh is nua
🚀 Tosaigh ar logáil isteach	Seoladh roghnach ag logáil isteach; tráidire amháin, gan aon deilbhín duga
🩺 Dochtúir &	Diagnóisic aon-cliceáil agus rochtain loga freastalaí

```sh brew install --cask zoispag/tap/omniroute-tray ``` _{Is fearr leat a íoslódáil? Faigh an .dmg is déanaí ó
Scaoileann . Foinse, saincheisteanna agus tógáil
docs beo ag zoispag/omniroute-tray.

💛 Tionscadal pobail le @zoispag — ní eisiúint oifigiúil OmniRoute.}

## 🔒 Príobháideach & Áitiúil ar dTús

Príobháideach agus áitiúil ar dtús — ritheann geata agus plána rialaithe OmniRoute ar do ríomhaire. Seoltar leideanna chuig an soláthraí réamhtheachtach a roghnaítear do gach iarratas; ní chuireann OmniRoute aon chéim óstáilte próiseála leideanna leis agus tá teiliméadracht díchumasaithe de réir réamhshocraithe. Criptítear dintiúir ar fos le AES-256-GCM; áirítear leis na rialuithe scópáil eochracha API, scagadh IP, teorainneacha ráta, cosaintí ar instealladh leideanna, glanadh ceanntásca réamhtheachtacha, folú PII ar bhonn roghnach, earráidí sláintithe agus rian iniúchóireachta áitiúil SQLite. Tá OmniRoute ceadúnaithe faoi MIT agus is féidir é a fhéinnostáil.

_{📖 [Údarú](docs/architecture/AUTHZ_GUIDE.md) · [Ráillí Cosanta](docs/security/GUARDRAILS.md) · [Comhlíonadh](docs/security/COMPLIANCE.md)}

## 🔌 CLI Iomlán + A2A & MCP

> Taobh amuigh den fhreastalaí, is **deais iomlán líne na n-orduithe** é OmniRoute ina bhfuil **breis agus 80 ordú**, chomh maith le prótacail oscailte gníomhairí ionas gur féidir le gníomhaire AI é a rialú **as a stuaim féin**. ### ⌨️ Fíor-CLI (ní `start` amháin) ```bash omniroute # freastalaíonn sé ar an ngeata + an deais (port 20128) omniroute chat # cliant comhrá idirghníomhach TUI (slais: /model /combo /skill /memory) omniroute setup # treoraí céadrite treoraithe omniroute doctor # déanann sé soláthraithe, poirt agus spleáchais dhúchasacha a dhiagnóisiú ``` ### 🛰️ Mód cianda — rith an CLI anseo, agus OmniRoute ar VPS An bhfuil OmniRoute ar fhreastalaí? Rialaigh ó do ríomhaire glúine é leis an **CLI céanna**. Logáil isteach uair amháin le comhartha rochtana a bhfuil raon feidhme aige; díríonn gach ordú ar an gcianfhreastalaí ansin. ```bash omniroute connect 192.168.0.15 # focal faire → comhartha le raon feidhme, sábháilte mar chomhthéacs omniroute models # ← ritheann sé i gcoinne an chianfhreastalaí omniroute configure codex # ← roghnaíonn sé samhail chianda, scríobhann sé próifíl áitiúil Codex omniroute tokens create --name ci --scope read # cruthaíonn sé comharthaí le raon níos cúinge do mheaisíní eile omniroute contexts use default # ← athraigh ar ais go dtí an freastalaí áitiúil ``` Tá raon feidhme `read` / `write` / `admin` ag na comharthaí; fanann bealaí a thosaíonn próisis teoranta don loopback amháin. _{📖 [Mód Cianda](docs/guides/REMOTE-MODE.md)}

Taispeántas beoite teirminéil den OmniRoute CLI — omniroute providers list, omniroute combo list agus omniroute health — ag rothaíocht trí dhromchla barrleibhéil na 89 ordú: 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 …

### 🤝 Ceangail gníomhaire — agus rialaíonn sé OmniRoute féin Nocht OmniRoute trí **MCP**, **A2A**, **REST API**, **webhooks** nó **CLI cianda** — faigheann aon ghníomhaire cumasach (nó do chód féin) na heochracha don gheata iomlán: ródú, soláthraithe, teaglamaí, taisce, comhbhrú, cuimhne — go huathrialach. Freastalaítear ar na críochphointí HTTP thíos faoi `http://localhost:20128`.

Comhéadan	Críochphointe / ordú	Úsáid é le haghaidh
🧰 MCP (stdio)	`omniroute --mcp`	Ceangail le Claude Desktop, Cursor nó aon chliant MCP
🌊 MCP (HTTP)	`/api/mcp/stream`	MCP cianda — 110 uirlis, 33 raon feidhme (forfheidhmiú roghnach), rian iniúchta iomlán
📡 MCP (SSE)	`/api/mcp/sse`	Iompar sruthaithe MCP
🤝 A2A	`/.well-known/agent.json`	Ó ghníomhaire go gníomhaire, JSON-RPC 2.0 + SSE, 6 scil
🌐 REST API	`/v1/*`	Comhoiriúnach le OpenAI — comhrá, leabuithe, íomhánna, fuaim, OCR
🔔 Webhooks	`/api/webhooks`	Brúigh imeachtaí iarratais / cuóta chuig Slack, Discord, Telegram nó aon URL
🛰️ CLI Cianda	`omniroute connect`	Rialaigh ásc cianda le comharthaí rochtana a bhfuil raon feidhme acu

```bash # Tabhair tacar iomlán uirlisí OmniRoute do Claude Code thar MCP: claude mcp add-server omniroute --type http --url http://localhost:20128/api/mcp/stream ``` _{📖 [Freastalaí MCP](docs/frameworks/MCP-SERVER.md) · [Freastalaí A2A](docs/frameworks/A2A-SERVER.md) · [Prótacail Gníomhairí](docs/frameworks/AGENT_PROTOCOLS_GUIDE.md)}

## 🗜️ Sábháil 15–95% de na Tóicíní — Go huathoibríoch

### 📖 Conas a oibríonn sé — píblíne, ailtireacht agus matamaitic na sábhála

Píblíne comhbhrúite OmniRoute: téann iarratas cliaint léiritheach le 10,000 tóicín trí 12 inneall in-chumraithe — Session-Dedup, CCR, Lite, RTK, Responses Tool Output, Headroom, Relevance, Caveman, Aggressive, LLMLingua-2, Ultra agus OmniGlyph — agus féadfaidh sé an soláthraí a bhaint amach le thart ar 1,080 tóicín sa sampla cruachta doiciméadaithe. Cosnaítear ábhar struchtúrtha le gardaí caomhnaithe agus geataí dílseachta in aghaidh na céime; féadfaidh modhanna sainráite caillteacha nó turgnamhacha ábhar incháilithe a athrú.

Ritheann an teaglaim chruachta réamhshocraithe `RTK → Caveman`. Nuair a ghníomhaíonn an dá cheann ar an ualach pála uirlise/comhthéacs céanna, cruachtaíonn na sábhálacha: ```txt combined = 1 − (1 − RTK) × (1 − Caveman_input) average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2% range = 78.4 – 94.6% ``` Bíonn bloic chóid, URLanna, JSON agus sonraí struchtúrtha **cosanta i gcónaí** ag an inneall caomhnaithe. > **Cén fáth an oiread sin tóicíní a úsáid nuair is leor cúpla ceann?** Téann gach iarratas trí phíblíne comhbhrúite OmniRoute **go trédhearcach** — gan aon athruithe ar an gcliant. Is **cruach de 12 inneall in-chumraithe** atá ann anois a ritheann in ord agus a mheascann agus a mheaitseálann de réir teaglaim ródaithe — bunaithe ar smaointe ó [RTK](https://github.com/rtk-ai/rtk), [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ 90K+), [LLMLingua-2](https://github.com/microsoft/LLMLingua), agus [Troglodita](https://github.com/leninejunior/troglodita) (PT-BR). ### 🧱 An chruach 12 inneall Ritheann na hinnill in ord na píblíne; is féidir gach ceann acu a scoránú agus a chumrú go neamhspleách de réir teaglaim:

#	Inneall	A bhfeidhm
1	Session-Dedup	Scaoileann sé ábhar a athdhéantar idir sealanna (seoladh ábhair, tras-sealanna)
2	CCR	Cuireann sé bloic mhóra i gcartlann taobh thiar de mharcóirí aisghabhála, agus faightear iad ar éileamh
3	Lite	Bearradh spás bán + URLanna íomhánna (bunlíne éadrom ó thaobh na moille de)
4	RTK	Scagadh cliste ar thorthaí uirlisí, dedup agus teascadh (feasach ar orduithe)
5	Responses Tool Output	JSON caillteanas-neamhbhunaithe ar dtús + comhbhrú diagnóiseach teoranta d’aschuir shell/patch/search/build (Responses API)
6	Headroom	Comhdhlúthú táblach gan chaillteanas d’eagair JSON (~30%) trí chóideach GCF arna chuachadh isteach
7	Relevance	Scóráil eastósctha abairtí i gcomparáid leis an bhfiosrúchán úsáideora is deireanaí
8	Caveman	Comhbhrú próis bunaithe ar rialacha (~65–75% ar an aschur)
9	Aggressive	Achoimriú + aosú forásach sean-sealanna
10	LLMLingua-2	Bearradh séimeantach ML trí MobileBERT ONNX — sábháilte ó thaobh cóid de, asincrónach
11	Ultra	Bearradh heorastúil tóicíní le sraith roghnach samhla bhig (SLM)
12	OmniGlyph	Ionchódú turgnamhach comhthéacs-mar-íomhá le haghaidh Claude Fable 5 tomhaiste ar an sreang dhíreach Anthropic; fanann trasfhoirmeoirí GPT 5.6 i mód teipe-dúnta go dtí go bhfaightear admhálacha ón soláthraí. Ceithre phróifíl chomhbhrúite (réamhshocrú ionsaitheach, cothrom, sábháilte ó thaobh códaithe de, pas-tríd) (is ionsaithí; roghnach)

Caomhnaítear bloic chóid, URLanna agus sonraí struchtúrtha **go foirfe beart ar bheart i gcónaí**. Comhcheanglaíonn **réamhshocruithe aon-chliceála** na hinnill:

Mód	Sábhálacha	Oiriúnach do
🪶 Lite	~15%	Réamhshocrú sábháilte a bhíonn ar siúl i gcónaí
🪨 Standard (Caveman)	~30%	Códú laethúil
⚡ Aggressive	~50%	Seisiúin fhada le neart uirlisí
🔥 Ultra	~75%	Uasmhéid sábhálacha
🧰 RTK	60–90%	Aschur shell/test/build/git
🔗 Stacked (RTK → Caveman)	78–95%	Leideanna measctha + logaí uirlisí

**Sampla fíor — mód Standard:** > **Roimhe seo (69 tóicín):** _"Is dócha gurb é an chúis a bhfuil do chomhpháirt React á athrindreáil ná go bhfuil tú ag cruthú tagairt réada nua i ngach timthriall rindreála. Nuair a chuireann tú réad inlíne ar aghaidh mar prop, feiceann comparáid éadomhain React é mar réad difriúil gach uair, rud a spreagann athrindreáil. Mholfainn useMemo a úsáid chun an réad a mheamramhú."_ > > **Ina dhiaidh sin (19 tóicín):** _"Tagairt réada nua i ngach rindreáil. Prop réada inlíne = tagairt nua = athrindreáil. Clúdaigh le useMemo."_ > > **An freagra céanna. 72% níos lú tóicíní. Gan aon chaillteanas cruinnis.** ✅ **Sampla PT-BR — mód [Troglodita](https://github.com/leninejunior/troglodita):** > **Roimhe seo (42 chomhartha):** _"Is í an fhadhb ná go bhfuil an chomhpháirt á hathrindreáil toisc go bhfuil tagairt nua réada á cruthú i ngach timthriall rindreála. Mholfainn `useMemo` a úsáid."_ > > **Ina dhiaidh sin (12 chomhartha):** _"Athrindreáil: tagairt nua i ngach timthriall (réad inlíne athchruthaithe). Úsáid `useMemo`."_ > > **An freagra céanna. ~70% níos lú comharthaí. Beachtas teicniúil slán.** ✅
### 🎚️ Taobh amuigh de na hinnill — stíleanna aschuir, an diail oiriúnaitheach agus rialú in aghaidh iarratais Laghdaíonn na 12 inneall thuas an méid a théann **isteach**. Múnlaíonn trí shraith eile **conas**, **cathain**, agus cad a thagann **amach**: - **🪄 Stíleanna Aschuir** _(stiúradh ar ais an aschuir)_ — insteallann siad treoracha cinntitheacha, sábháilte ó thaobh taisce de, chun freagraí a mhúnlú; is féidir iad a chomhcheangal, agus tá gach ceann acu ar fáil ag déine `lite` / `full` / `ultra`. Is iontráil aonlíne sa chlár ná stíl a chur leis: - **Prós gonta** — bain líontóirí / ailt / maoluithe; coinnigh an tsubstaint theicniúil cruinn. - **Lúide cód** — YAGNI an “fhorbróra shinsearaigh leisciúil”: an t-athrú oibre is lú, gan bonneagar nach bhfuil iarrtha. - **Eireaball capaill (forbróir sinsearach leisciúil)** — téigh suas dréimire YAGNI, réitigh bunchúis na faidhbe, agus déan an difríocht oibre is lú. - **Tá ADHD orm (gníomh ar dtús)** — cuir an chéad ghníomh chun tosaigh, uimhreachaigh na céimeanna, tabhair chéad chéim nithiúil amháin, gan réamhrá. - **CJK gonta (文言)** — stíl ultra-ghonta na Sínise clasaicí (teoranta de réir locale do `zh`). - **🎯 Buiséad comhthéacs oiriúnaitheach** _(an diail)_ — in áit tairsí comharthaí amháin a bheith ann, bíodh sé air/as, méadaigh na hinnill is saoire agus is lú caillteanais de réir mar is gá chun **fuinneog chomhthéacs an mhúnla a bhaint amach**. Polasaí: `reserve-output` (réamhshocrú, feasach ar an múnla) · `percentage` · `absolute`. Mód: `floor` (ráthaigh go n-oireann) · `replace-autotrigger` (bíonn tosaíocht ag do rogha shonrach) · `off` (tairseach oidhreachta). - **🎛️ An áit a gcinntítear comhbhrú** _(tosaíocht, ard → íseal)_ — ceanntásc iarratais `x-omniroute-compression` › sárú teaglaim ródaithe › próifíl ainmnithe ghníomhach › truicear oiriúnaitheach / uathoibríoch › réamhshocrú an phainéil › as. Macallaíonn an plean feidhmithe é féin sa cheanntásc freagartha `X-OmniRoute-Compression: ; source=`. Spreag go huathoibríoch é de réir tairsí comharthaí, smeach an diail oiriúnaitheach air, pionnaigh próifíl ainmnithe, socraigh é uair amháin in aghaidh iarratais, nó sann píblíne in aghaidh teaglaim ródaithe — cibé acu is fearr don ualach oibre. Déanann **úim mheasúnaithe** roghnach as líne (`npm run eval:compression`) dílseacht i gcoinne coigiltis a scóráil ar chorpais phionnaithe sula gcuireann tú athrú chun cinn. 📖 [`COMPRESSION_GUIDE.md`](docs/compression/COMPRESSION_GUIDE.md) · [`RTK_COMPRESSION.md`](docs/compression/RTK_COMPRESSION.md) · [`COMPRESSION_ENGINES.md`](docs/compression/COMPRESSION_ENGINES.md)

# ⚡ Tús Tapa

**1) Suiteáil agus rith** ```bash npm install -g omniroute omniroute ``` > 💡 An bhfeiceann tú `npm warn ERESOLVE` nó rabhaidh faoi spleáchais chomhghleacaithe? [Tá siad neamhdhíobhálach](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated). > **An bhfuil npm 11 nó níos nuaí á úsáid agat?** Féadfaidh npm scripteanna shaolré na bpacáistí a bhlocáil mura gceadaítear iad. Tá `postinstall` OmniRoute (`node scripts/build/postinstall.mjs`) riachtanach chun a chomhaid dhúchasacha ama rite a ullmhú. Ceadaigh na pacáistí atá ainmnithe i rabhadh npm agus tú á suiteáil go domhanda. Maidir leis an tacar pacáistí a thuairiscigh OmniRoute 3.8.54: > > ```bash > npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute > ``` > > Chun an liosta ceadaithe seo a athúsáid le haghaidh suiteálacha domhanda amach anseo, cumraigh é uair amháin, ansin suiteáil de ghnáth: > > ```bash > npm config set allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild --location=user > npm install -g omniroute > ``` > > Féadfaidh liosta na spleáchas athrú idir eisiúintí; má thuairiscíonn npm liosta difriúil, bain úsáid as ainmneacha na bpacáistí ón rabhadh sin. Má cheadaítear pacáiste, ceadaítear a scripteanna suiteála a rith. > **An bhfuil Gemini Web nó soláthraí eile bunaithe ar fhianáin ghréasáin á úsáid agat?** Áirítear sa phacáiste npm > Playwright ach ní áirítear a dhénártha Chromium ann. Féach an nóta > [Socrú Chromium do Playwright](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium) > sula ndéanann tú an chéad iarratas chuig soláthraí gréasáin. Painéal ag `http://localhost:20128` · API ag `http://localhost:20128/v1`. **2) Ceangail soláthraí incháilithe le do chuntas féin** Painéal → **Soláthraithe** → roghnaigh soláthraí a bhfuil a théarmaí reatha agus a chuóta oiriúnach do do chás úsáide → cuir a eochair API leis nó comhlánaigh próiseas a chuntais. D’fhéadfadh clárú, ceadú nó modh íocaíochta a bheith riachtanach do shraitheanna saor in aisce. Déan athbhreithniú ar an [Treoir maidir le Sraitheanna Saor in Aisce](docs/getting-started/FREE-TIERS-GUIDE.md); ní ráthaítear infhaighteacht gan eochair, agus fágtar soláthraithe a bhfuil `tos: avoid` marcáilte orthu as `auto` de réir réamhshocraithe. **3) Díriú ar d’uirlis chódúcháin** ```txt BunURL: http://localhost:20128/v1 Eochair API: [cóipeáil ón bPainéal → Críochphointí] Múnla: auto (ródú idir naisc incháilithe — nó roghnaigh soláthraí/múnla) ``` **4) Deimhnigh go bhfuil sé ag obair** ```bash curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY" ``` Ba cheart duit do mhúnlaí ceangailte a fheiceáil sa liosta. 🎉 Sin é — tosaigh ag códú, agus déanann OmniRoute ródú agus cúltaca uathoibríoch duit. Mura féidir le do chliant ceanntásca saincheaptha a sheoladh, soláthraíonn OmniRoute ailiasanna comhoiriúnachta comharthaíochta freisin: ```txt Catalóg OpenAI: http://localhost:20128/vscode/YOUR_KEY/ Múnlaí OpenAI: http://localhost:20128/vscode/YOUR_KEY/models Comhrá OpenAI: http://localhost:20128/vscode/YOUR_KEY/chat/completions Freagraí OpenAI: http://localhost:20128/vscode/YOUR_KEY/responses Comhrá Ollama: http://localhost:20128/vscode/YOUR_KEY/api/chat Clibeanna Ollama: http://localhost:20128/vscode/YOUR_KEY/api/tags ``` Bain úsáid astu seo amháin le haghaidh cliant nach féidir leo `Authorization: Bearer ...` a cheangal. Is é fíordheimhniú ceanntásca an mód is fearr fós.
## 📦 Tuilleadh modhanna suiteála — Docker, cód foinseach, 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 ``` Leanann `:latest` an SemVer cobhsaí **foilsithe** is airde. Ní leanann sé git `main`. Pionnáil `:X.Y.Z` le haghaidh GitOps. Féach [Cainéil Eisiúna Docker](docs/guides/DOCKER_GUIDE.md#release-channels). Pionnálann an íomhá **`OMNIROUTE_MEMORY_MB=1024`**. Is leor é sin don deais agus do chomhrá éadrom. Teastaíonn carn V8 i bhfad níos mó ó **ghníomhairí códaithe** (`POST /v1/responses` ó Claude Code, Codex, Grok, …), nó faigheann an próiseas `FATAL ERROR` ag thart ar 12 GiB le linn dhá chomhthéacs fhada atá ag forluí. Socraigh méid an choimeádáin os cionn mhéid an chairn (bíonn maoláin dhúchasacha lasmuigh de V8): | Ualach oibre | Carn (`-e OMNIROUTE_MEMORY_MB`) | Coimeádán (`--memory`) | | ---------------------------------------- | ------------------------------- | ---------------------- | | Deais / comhrá éadrom | `1024` (réamhshocrú na híomhá) | ≥2 g | | Gníomhaire códaithe amháin | `8192` | ≥10 g | | Dhá `/v1/responses` fhada chomhuaineacha | `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 ``` An tábla iomlán: [Treoir Docker — RAM ag am rite](docs/guides/DOCKER_GUIDE.md#runtime-ram-for-coding-agents). > **Cainéal réamheisiúna Docker:** leanann `diegosouzapw/omniroute:next` agus > `diegosouzapw/omniroute:next-web` an brainse réamhshocraithe reatha `release/v*`. > Níl na clibeanna inathraithe seo beartaithe ach amháin chun ceartúcháin neamheisithe a thástáil agus > **ní thacaítear leo le haghaidh táirgeachta**. Féach > [Cainéil Eisiúna Docker](docs/guides/DOCKER_GUIDE.md#release-channels). **🥟 Bun** Tacaítear le `bun install` caighdeánach agus suiteáil dhomhanda (`bun install -g omniroute`) trí bhrath am rite Bun: - **`bun:sqlite` ionsuite**: Úsáideann OmniRoute tiománaí ionsuite Bun, `bun:sqlite`, agus é ag rith faoi Bun, agus téann sé siar chuig `better-sqlite3` ar Node.js nó `sql.js`. - **Roghnú uathoibríoch cuachta Webpack i bhforbairt**: Braitheann an fhorbairt (`bun run dev`) Bun go huathoibríoch agus díchumasaíonn sí Turbopack i bhfabhar Webpack chun neamh-chomhoiriúnachtaí ceangailteacha dúchasacha V8 a chosc. Leanann leaganacha táirgeachta (`bun run build`) `OMNIROUTE_USE_TURBOPACK` go díreach mar a dhéantar ar Node: Turbopack de réir réamhshocraithe, `OMNIROUTE_USE_TURBOPACK=0` chun tógáil le Webpack (nochtann `Dockerfile.bun` é mar `--build-arg`). - **Dockerfile tiomnaithe do Bun**: `Dockerfile.bun` ilchéime le haghaidh imscaradh táirgeachta dúchasach Bun (`docker build -f Dockerfile.bun -t omniroute:bun .`). ```bash # Suiteáil agus rith le Bun bun install bun run dev ``` **🛠️ Ón gcód foinseach** ```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 # Ag úsáid calóga Nix nix develop npm run dev # Nó ag úsáid devbox devbox run npm run dev ``` 📖 [Treoir Docker](docs/guides/DOCKER_GUIDE.md) — Próifílí Compose, Caddy HTTPS, tolláin Cloudflare. **🦭 Podman** ```bash # 1. Ullmhaigh an t-eolaire sonraí gléasta le ceangal mkdir -p data # 2. Linux + Podman logánta gan fhréamh amháin (ná húsáid cliant cianda Podman Machine riamh): podman unshare chown 1000:1000 ./data # 3. Socraigh an leid ama rite, tóg an íomhá áitiúil Compose, agus tosaigh í echo "CONTAINER_HOST=podman" >> .env podman compose --profile base up -d --build ``` Ar macOS nó Windows, úsáideann Podman Podman Machine cianda: fág `podman unshare` ar lár agus lean an [treoir don eolaire sonraí a bhaineann go sonrach leis an toipeolaíocht](contrib/podman/README.md#data-directory-permissions-by-topology). 📖 [Treoir Podman](contrib/podman/README.md) — Leaganacha Compose, Podman Machine, agus socrú Quadlet Linux/systemd. **⚡ Suiteáil níos tapúla / níos éadroime (scipeáil an leagan dúchasach)** Is spleáchas **roghnach** é inneall dúchasach SQLite (`better-sqlite3`), mar sin ní chuirtear bac riamh ar shuiteáil dhomhanda de bharr tiomsú ón gcód foinseach: úsáideann sé dénártha réamhthógtha nuair a mheaitseálann ceann d’ardán/Node, agus murach sin téann sé siar go trédhearcach chuig inneall JavaScript íon (`node:sqlite` ar Node 22+, nó an WASM `sql.js` cuachta) — níl aon uirlisí tógála ag teastáil. Chun an **réamhthéamh dúchasach** iarshuiteála a scipeáil go hiomlán (CI, córas gan chomhéadan grafach, nó ríomhairí malla). Nóta: ní dhéanann sé seo ach céim réamhthéimh dhúchasach SQLite (`scripts/postinstall.mjs`) a scipeáil; ritheann an crúca cóipeála/deisiúcháin dhénártha (`scripts/build/postinstall.mjs`) mar is gnách fós: ```bash OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute # Scipeálann CI=1 é freisin ``` Le haghaidh na suiteálacha is tapúla, roghnaigh **pnpm** (stóras a bhfuil seoltaí ábhair aige + naisc chrua — féach thuas). Le haghaidh am rite gan deais agus gan chomhéadan grafach, úsáid próifíl Docker `base` (thuas) nó an [treoir Termux](docs/guides/TERMUX_GUIDE.md). Freastalaíonn an próiseas céanna ar an CLI agus ar an deais ghréasáin ar phort amháin, mar sin níl aon phacáiste ar leith don CLI amháin ann faoi láthair.

# 🎬 OmniRoute i bhFeidhm

## 📹 Treoracha Físe

_{Léargas den phainéal ar 2026-10-18 · Catalóg amh: YT 1.352 | TT 334 | IG 290 · Úire (laethanta): YT 5 | TT 48 | IG 49}

🎬 #1 — Instagram
_{nick_saraev — 3,042,474 amharc}

🎬 #2 — Instagram
_{nnapier7 — 1,454,535 amharc}

🎬 #3 — YouTube
_{Amidia AI & Tech — 794,974 amharc}

🎬 #4 — Instagram
_{theopenstack — 692,419 amharc}

🎬 #5 — TikTok
_{migue.baena — 685,788 amharc}

**Rangú iomlán (URLanna canónacha dí-dhúbláilte, `v > 0`, an teacht is mó):** | #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** | Méadrachtaí canónacha ar 2026-10-18: **1.976 físeán uathúil** · **20.220.289 amharc aitheanta** (`v > 0`) · **1.210 cainéal/próifíl de réir líonra**. Tá 1.976 líne sa phainéal amh (YouTube 1.352 = 740 físeán fada + 612 Shorts · TikTok 334 · Instagram 290); níor fágadh aon dúblach tar éis normalú de réir an URL chanónaigh, a choinníonn an líon is airde do gach físeán. Tá bailiú sonraí YouTube reoite ag 2026-10-13 (cóta an API ídithe ón 14 go dtí an 18/10) agus tá bailiú sonraí TikTok/Instagram reoite ó 2026-09-02 (gan creidmheasanna bailithe); níl comhaireamh amharc fós ag 76 físeán. > 🎬 **An ndearna tú físeán faoi OmniRoute?** Oscail [saincheist](https://github.com/diegosouzapw/OmniRoute/issues/new) nó [plé](https://github.com/diegosouzapw/OmniRoute/discussions) leis an nasc — cuirfimid chun suntais anseo é.

# 📧 Pobal & Cabhair > Gach rud in aon áit amháin — lean an cothabhálaí, déan comhrá leis an bpobal, nó oscail saincheist. | Cainéal | Cá háit / conas | | ----------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | | 💼 **LinkedIn** — lean an cothabhálaí | [linkedin.com/in/diegosouzapw](https://www.linkedin.com/in/diegosouzapw/) | | 🐙 **GitHub** — lean é le haghaidh eisiúintí agus leideanna | [@diegosouzapw](https://github.com/diegosouzapw) | | 💬 **Discord** | [discord.gg/U47eFqAXCn](https://discord.gg/U47eFqAXCn) | | ✈️ **Telegram** | [t.me/omnirouteOficial](https://t.me/omnirouteOficial) | | 🟢 **WhatsApp — 🌍 Domhanda** | [glac páirt sa ghrúpa](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) | | 🟢 **WhatsApp — 🇧🇷 An Bhrasaíl** | [glac páirt sa ghrúpa](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) | | 🌍 **Suíomh gréasáin** | [omniroute.online](https://omniroute.online) | | 🌍 **🌍Pobal StHub OmniRoute (saor in aisce)** | [tairseach StHub](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK) | | 📦 **Cód foinseach** | [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute) | | 🐛 **Tuairiscigh fabht** | [oscail saincheist](https://github.com/diegosouzapw/OmniRoute/issues) — ceangail aschur `npm run system-info` leis | | 🤝 **Rannchuidigh** | [CONTRIBUTING.md](CONTRIBUTING.md) · [Samhail Brainseála agus Eisiúna](docs/ops/BRANCHING_MODEL.md) · roghnaigh `good first issue` | | 💚 **Tacaigh leis an tionscadal** | [Bealaí chun tacú ↑](#-support-omniroute) · [Urraitheoirí GitHub](https://github.com/sponsors/diegosouzapw) |

---

## 🛠️ Cruach Teicneolaíochta

Ciseal	Teicneolaíocht
Am rite	Node.js 22.x / 24.x LTS — `>=22.22.2 <23 \|\| >=24.0.0 <27`
Teanga	TypeScript 6.0 — TypeScript 100% ar fud `src/` agus `open-sse/` (nialas `any` sa chroílár ó v2.0)
Creat	Next.js 16 + React 19 + Tailwind CSS 4
Bunachar sonraí	better-sqlite3 (SQLite, dialannú WAL) + LowDB (JSON oidhreachta) — 147 modúl fearainn, 233 imirce
Cuimhne	Téacs iomlán SQLite FTS5 + leabuithe veicteora cainníochtaithe int8, meath clóscríofa
Scéimeanna	Zod 4 — bailíochtú I/A uirlisí MCP + conarthaí API
Prótacail	MCP (stdio / HTTP / SSE) + A2A v0.3 (JSON-RPC 2.0 + SSE)
Sruthú	Imeachtaí Seolta ag an bhFreastalaí (SSE) + droichead WebSocket (`/v1/ws`)
Comhbhrú	Píblíne 12 inneall — RTK, Caveman, LLMLingua-2 (MobileBERT ONNX), GCF, OmniGlyph
Fíordheimhniú & slándáil	OAuth 2.0 (PKCE) + JWT + Eochracha API + fíordheimhniú MCP le raon feidhme · AES-256-GCM agus é ar fos · DOMPurify
Stealth	wreq-js — pearsanú méarlorg TLS JA3 / JA4, seachfhreastalaí 3 leibhéal
Athléimneacht	Bristeoir ciorcaid, cúlchéimniú easpónantúil, frith-throdaí slua, féinleigheas uath-chomhcheangail
Logáil	pino — logaí JSON struchtúrtha le comhthéacs iarratais
Tástáil	Rithí tástála Node.js + Vitest — níos mó ná 60,000 dearbhú tástála statach ar fud níos mó ná 8,400 comhad tástála rianaithe (aonaid, comhtháthú, E2E, slándáil, éiceachóras)
Ardáin	Deasc (Electron) · Android (Termux) · PWA (brabhsálaí ar bith)
CI/CD	GitHub Actions — foilsiú uathoibríoch npm + Docker Hub nuair a scaoiltear leagan
Naisc	Suíomh gréasáin · npm · Docker Hub

## 📖 Doiciméadú

### 📘 Tús a Chur Leis

Doiciméad	Cur Síos
Treoir Úsáideora	Soláthraithe, teaglamaí, comhtháthú CLI, imscaradh
Treoir Socraithe	Modhanna iomlána suiteála, cumraíochtaí uirlisí CLI, socrú prótacail, mionchoigeartú teorainneacha ama
Treoir Uirlisí CLI	Socrú de réir uirlise do Claude Code, Codex, Cursor, Cline, OpenClaw, Kilo, Copilot
Mód Cianda	OmniRoute cianda (VPS) a rialú ó CLI do ríomhaire glúine trí chomharthaí rochtana teoranta
Cumraíocht Claude Code	Claude Code a dhíriú ar OmniRoute (áitiúil/cianda) le `launch` + próifílí de réir samhla
Tús Tapa	Suiteáil → ceangail → cumraigh i 3 chéim

### 🔧 Oibríochtaí agus Imscaradh

Doiciméad	Cur Síos
Treoir Docker	Docker run, próifílí Compose, Caddy HTTPS, tolláin, clibeanna íomhá
Treoir Podman	Comhtháthú Quadlet systemd, podman-compose, SELinux
Imscaradh VM	Treoir iomlán: socrú VM + nginx + Cloudflare
Imscaradh Fly.io	Imscaradh chuig Fly.io le stóráil bhuan
Treoir Termux	OmniRoute a rith ar Android trí Termux
Treoir PWA	Suiteáil Aip Ghréasáin Fhorásach, taisceadh, ailtireacht
Treoir Díshuiteála	Baint ghlan do gach modh suiteála
Cumraíocht Timpeallachta	Athróga agus tagairtí iomlána `.env`

### 🧠 Gnéithe agus Ailtireacht

Doiciméad	Cur Síos
Ailtireacht	Ailtireacht an chórais, sreabhadh sonraí agus inmheánacha
Treoir Chomhbhrúite	Píblíne 7 rogha: as / éadrom / caighdeánach / ionsaitheach / ultra / RTK / cruachta
Comhbhrú RTK	Comhbhrú aschur na n-orduithe, scagairí, iontaoibh, fíorú, aisghabháil aschuir amh
Innill Chomhbhrúite	Caveman, RTK, píblínte cruachta, dromchlaí painéil/API/MCP
Formáid Rialacha Comhbhrúite	Scéimeanna pacáistí rialacha JSON do scagairí Caveman agus RTK
Pacáistí Teanga Comhbhrúite	Brath teanga agus údarú pacáistí rialacha Caveman
Treoir Athléimneachta	Briseoirí ciorcaid, tréimhsí fuaraithe, scuaine, cosc ar threoigeadán na n-iarratas, spoofáil TLS
Inneall Uath-Teaglama	Scóráil 16 fhachtóir, pacáistí mód, féinleigheas
Treoir Proxy	Córas proxy 3 leibhéal, margadh 1proxy, CRUD clárlainne
Sraitheanna Saora	Comhadlann chomhdhlúite: 34 chomhthiomsú athfhillteach doiciméadaithe / 465 iontráil chatalógaithe ar shraitheanna saor
Gailearaí Gnéithe	Turas amhairc ar an bpainéal le scáileáin den scoth
Doiciméadú an Bhunachóid	Siúlóid ar an mbunachar cód atá soláimhsithe do thosaitheoirí

### 🤖 Prótacail agus APIanna

Doiciméad	Cur Síos
Tagairt API	Gach críochphointe le samplaí
Sonraíocht OpenAPI	Sonraíocht OpenAPI 3.0
Freastalaí MCP	110 uirlis MCP, cumraíochtaí IDE, cliaint Python/TS/Go
Treoir Freastalaí MCP	Suiteáil MCP, iompar agus tagairt uirlisí
Freastalaí A2A	Prótacal JSON-RPC 2.0, scileanna, sruthú, bainistíocht tascanna
Treoir Freastalaí A2A	Cárta gníomhaire A2A, tascanna, scileanna agus sruthú

### 📋 Tionscadal agus Cáilíocht

Doiciméad	Cur síos
Rannchuidiú	Socrú agus treoirlínte forbartha
Múnla Brainseála & Eisiúna	Cá ndírítear PRanna (`release/*`), agus cad is brí le `main` agus clibeanna
Log Athruithe	Stair iomlán na n-eisiúintí de réir leagain
Polasaí Slándála	Tuairisciú leochaileachtaí agus cleachtais slándála
Treoir i18n	Tacaíocht do 67 teanga, sreabhadh oibre aistriúcháin, RTL
Seicliosta Eisiúna	Céimeanna bailíochtaithe roimh eisiúint
Plean Clúdaigh	Straitéis clúdaigh tástála do bhreis agus 60,000 dearbhú tástála statach thar bhreis agus 8,400 comhad tástála a rianaítear

# ⭐ Na Rannchuiditheoirí is Fearr > Is pobal paiseanta foinse oscailte a mhúnlaíonn OmniRoute. Tá rannchuidithe eisceachtúla déanta ag na daoine seo a mbíonn tionchar díreach acu ar cháilíocht, chobhsaíocht agus raon an tionscadail. **Go raibh maith agaibh.** ### Rannchuiditheoirí seachtracha de réir iarratas tarraingthe cumaiscthe

Rang	Rannchuiditheoir	PRanna cumaiscthe	Línte athraithe ~
1	maxmad64bis	418	25,367,739
2	HouMinXi	295	13,557,796
3	pacocartones	222	81,551
4	backryun	210	270,562
5	JxnLexn	198	3,570,623
6	oyi77	190	411,243
7	KooshaPari	151	5,972,314
8	rdself	145	80,663
9	RaviTharuma	123	500,065
10	herjarsa	88	230,872
11	hartmark	85	2,849,623
12	jonlwheat2-gif	68	69,097
13	artickc	62	43,502
14	xiaoyaner0201	59	126,220
15	chirag127	52	6,661
16	xz-dev	50	245,976
17	woodsonl	48	811,771
18	rqzbeh	46	151,229
19	MumuTW	43	28,166
19	QuangBlue	43	13,112

_{Rinneadh an daonáireamh an 2026-11-03 03:01:19 UTC le barr beo release/v3.8.53 ag 05bc048d6c. Tá 9,947 PR cumaiscthe sa daonáireamh GitHub GraphQL le leathanachú: 4,130 ón úinéir stórtha, 240 ó Dependabot, 6 ó róbait/aip eile, agus 5,571 PR seachtrach ó 883 rannchuiditheoir ar leith. Is éard atá i gceist le “Línte athraithe” ná breiseanna + scriosadh GitHub agus áirítear leo comhaid ghinte, comhaid ghlais, catalóga, aistriúcháin agus doiciméadacht; is athrú é, ní LOC údaraithe. Tuairiscíonn 53 PR difríochtaí GitHub os cionn 500,000 líne (mar shampla #13399, breisiú aonair soláthraí, ina liostaítear 2,347 comhad athraithe), rud a ardaíonn roinnt de na hiomláin thuas. Rangaítear comhscóir le chéile.} ### Coistí arna gcur i leith GitHub

Dizzle _{🥇 418 coimití a chuirtear i leith GitHub}	Bob.Hou _{🥈 294 coimití a chuirtear i leith GitHub}	Paijo _{🥉 229 coimití a chuirtear i leith GitHub}	Paco Cartones _{🏅 222 coimití a chuirtear i leith GitHub}	backryun _{🏅 202 coimití a chuirtear i leith GitHub}	Jan Leon _{🏅 134 coimití a chuirtear i leith GitHub}
Ravi Tharuma _{🏅 126 coimití a chuirtear i leith GitHub}	Markus Hartung _{🏅 115 coimití a chuirtear i leith GitHub}	Randi _{🏅 108 coimití a chuirtear i leith GitHub}	Chris _{🏅 70 coimití a chuirtear i leith GitHub}	WebPerson _{🏅 68 coimití a chuirtear i leith GitHub}	Koosha Paridehpour _{🏅 68 coimití a chuirtear i leith GitHub}

_{Athsheiceáilte ag 2026-11-03 02:09:16 UTC: coimití a chuirtear i leith GitHub agus a thuairiscíonn API Contributors na stórtha don bhrainse réamhshocraithe release/v3.8.53. D’fhill an API 903 aitheantas (429 úsáideoir, 2 róbat, 472 gan ainm); fágann an tábla seo an cothaitheoir, na róbait agus na haitheantais gan ainm ar lár agus coinníonn sé comhscóir sa chomórtas. Tá sé éagsúil ón rangú PRanna cumaiscthe thuas agus ó dhaonáireamh meiteashonraí Git thíos.} > 🙏 Is **cuid lárnach** de na rudaí a fhágann go bhfuil OmniRoute iontaofa agus lán le gnéithe iad gnéithe, réitigh fabhtanna agus feabhsuithe bonneagair na rannpháirtithe seo. Tá tábhacht le gach iarratas tarraingthe, gach cás tástála agus gach comhad aistriúcháin i18n. Tógtar foinse oscailte ag daoine cosúil leo.

---
## 💖 Urraitheoirí

Buíochas ó chroí leis na daoine a mhaoiníonn OmniRoute as a bpóca féin — coimeádann gach ranníocaíocht an tionscadal saor in aisce, neamhspleách agus ag dul ar aghaidh.

Andrew _{💛 Urraitheoir míosúil gníomhach}	Vlad I _{💛 Urraitheoir míosúil gníomhach}	小妍儿 _{💛 Urraitheoir míosúil gníomhach}	Guilherme Costa _{💛 Urraitheoir aonuaire gníomhach}	Henrique Iurkiv _{💛 Urraitheoir aonuaire gníomhach}	Somesh Ghaturle _{💛 Urraitheoir aonuaire gníomhach}
Kolonie AI _{💛 Tacadóir aonuaire roimhe seo}	Prof. Igor Morais _{💛 Tacadóir aonuaire roimhe seo}	Pixma _{💛 Tacadóir aonuaire roimhe seo}	Paco Cartones _{💛 Tacadóir aonuaire roimhe seo}	longtao _{💛 Tacadóir aonuaire roimhe seo}

_{… agus daoine eile ar fearr leo fanacht príobháideach 💛} _{Athfhíoraíodh Urraitheoirí poiblí GitHub an 2026-10-18 trí GitHub Sponsors GraphQL API: 11 urraíocht phoiblí (6 ghníomhacha, 5 roimhe seo) as 14 san iomlán. Is é stádas isActive GitHub a chinneann na lipéid ghníomhacha thuas; tugtar buíochas i gcónaí do thacadóirí poiblí aonuaire roimhe seo, agus fanann urraitheoirí príobháideacha gan ainm. Ní liostaítear síntiúis trí Ko-fi, Buy Me a Coffee, Liberapay, PIX ná criptea-airgeadra toisc nach bhfuil aon taifead poiblí urraitheora acu.} 💖 Bí i d’urraitheoir → — coimeádann gach dollar OmniRoute saor in aisce agus neamhspleách.

## 👥 1,000+ Rannpháirtithe

[![Contributors](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=1074&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors) _{Iniúchadh déanta an 2026-11-02 ar an leid bheo release/v3.8.53 1c7135e0fb (7,972 coimit): 1,074 aitheantas daonna normalaithe Git — tá 759 le feiceáil mar údair choimit (an cothaitheoir san áireamh) agus níl 315 eile le feiceáil ach i dtrailéirí sainráite Co-authored-by. Cuirtear .mailmap i bhfeidhm sa daonáireamh, cuirtear seoltaí ríomhphoist i gcomparáid gan idirdhealú idir cásanna, ceanglaítear seoltaí uimhriúla agus simplí GitHub noreply ach amháin nuair a ionchódaíonn siad an láimhseáil chéanna, fágtar 29 aitheantas róbó, gníomhaire, seirbhíse agus ionadchoinneálaí ar lár, agus ní dhéantar gnáthsheoltaí ríomhphoist a chumasc díreach toisc go bhfuil a n-ainmneacha taispeána mar an gcéanna. D’fhoilsigh iniúchadh 2026-08-24 639; tugann an modh seo, nuair a reáchtáiltear arís é ar bhunús an iniúchta sin ac02c5b42f, 619, mar sin is ó rannpháirtithe nua a thagann an méadú, ní ó mhodh níos scaoilte.} ### Conas Rannchuidiú 1. Déan forc den stór 2. Déan brainse ón leid ghníomhach `release/vX.Y.Z` (ní ó `main`) — féach [Samhail Brainseála agus Eisiúna](docs/ops/BRANCHING_MODEL.md) 3. Cruthaigh do bhrainse gné (`git checkout -b feat/amazing-feature`) 4. Déan coimit ar do chuid athruithe (`git commit -m 'feat: add amazing feature'`) 5. Brúigh chuig an mbrainse (`git push origin feat/amazing-feature`) 6. Oscail Iarratas Tarraingthe le **base = an brainse `release/vX.Y.Z` sin** Féach [CONTRIBUTING.md](CONTRIBUTING.md) le haghaidh treoirlínte mionsonraithe. ### Leagan Nua a Eisiúint ```bash # Cruthaigh eisiúint — tarlaíonn npm publish go huathoibríoch VERSION=x.y.z gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes ```

## 📊 Réaltaí

## 🌍 StarMapper

## 🙏 Admhálacha

Seasann OmniRoute ar ghuaillí fathach. Thosaigh sé mar fhorc de **[9router](https://github.com/decolua/9router)** agus mar phort TypeScript den tionscadal Go **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** — agus uaidh sin amach, ba é tionscadal foinse oscailte a bhí ann romhainn a spreag gach fochóras thíos. Mhúnlaigh gach ceann acu cuid nithiúil de OmniRoute. Seo ár mbuíochas leo go léir. 🙏 > ⭐ Fíoraíodh líon na réaltaí ó API REST GitHub an 3 Samhain 2026 — téigh agus tabhair réalta do na tionscadail seo. Is seat cruinn dátaithe iad na huimhreacha agus athróidh siad go nádúrtha. ### 🧬 Línse & geata

Tionscadal	⭐	An chaoi ar spreag sé OmniRoute
9router	31,861	An tionscadal bunaidh ar a bhfuil an forcsheasamh seo tógtha — leathnaíodh anseo é le APIanna ilmhódacha agus athscríobh iomlán TypeScript.
CLIProxyAPI	57,329	An cur i bhfeidhm Go a spreag an port JavaScript / TypeScript seo.
LiteLLM	62,580	An geata AI a sholáthraíonn a thacar sonraí poiblí praghsála don sioncronú rianaithe costais againn, agus ar chuir a mhúnla normalaithe soláthraithe bonn eolais faoinár ródú.
codex-chatgpt-web	15,435	Cód MIT oiriúnaithe sa droichead vendored ChatGPT Web → Codex Responses, lena n-áirítear oiriúnaitheoirí seisiúin bhrabhsálaí, frámaithe freagartha, úsáide agus cuardaigh ghréasáin.
free-claude-code	65,966	Patrúin a portáladh isteach in aisghabháil srutha, ailiasanna gan smaoineamh, cuardach gréasáin cúltaca, teorainneacha fuinneoige sleamhnáin, athscriosadh logaí agus sreafaí lainseála níos daingne.
composer-api	347	Patrúin roghnúcháin uirlise, srianta aschuir agus tiomantais uirlise Cursor Composer curtha in oiriúint don fheidhmitheoir dúchasach Cursor.
codex-multi-auth	561	Patrúin logála isteach úr agus rothlaithe comharthaí athnuachana portálta isteach in athfhíordheimhniú OAuth Codex.
opencode-anthropic-auth	562	Rinneadh réamhshocruithe claochlaithe atá comhoiriúnach le Claude Code agus iompar ceanntásca billeála a ghinearálú isteach i ndroichead OmniRoute atá tiomáinte ag cumraíocht.
grok2api-merged	2	Cuireadh a mhapálacha samhlacha Grok, a ghineadóir Statsig fake-TypeError, a réamhshocruithe iarratais agus gléis, agus a phróiseálaí freagartha NDJSON in oiriúint go hábhartha d’fheidhmitheoir Grok Web de chuid OmniRoute.
TQZHR/grok2api	707	An phríomhfhoinse chóid thrasdultach taobh thiar de grok2api-merged; coimeádtar a fheidhmithe samhla, ceanntáisc, pálasta, Statsig agus próiseálaí i línse Grok Web.
chenyme/grok2api	7,874	An bhunfhoinse MIT do réamhshocruithe pálasta agus gléis Grok, don ghineadóir Statsig, agus don phróiseálaí `result.response` a tugadh ar aghaidh trí TQZHR agus grok2api-merged.
grok2api-pro	27	Foinse thrasdultach a dtugann grok2api-merged creidiúint di as a shraith linnte seachfhreastalaí; coimeádann OmniRoute an fógra línse sin, ach ní mhaíonn sé go bhfuil port linnte seachfhreastalaí ann ina fheidhmitheoir teoranta Grok Web.
GrokProxy	52	Chuir a sheachfhreastalaí Grok fíordheimhnithe le fianáin agus a phatrún sruthaithe `result.response.token` bonn eolais faoi iompar Grok Web de chuid OmniRoute.
GrokBridge	5	Rinneadh comhairliúchán le cur i bhfeidhm bunaidh Grok Web maidir le dearadh a réamhsrutha HTTP/brabhsálaí; eascraíonn a chonair dhíreach HTTP ó GrokProxy, mar sin ní mhaítear aon phort neamhspleách cóid.

### 🗜️ Comhbhrú comhthéacs & comharthaí — innill

Tionscadal	⭐	An chaoi ar spreag sé OmniRoute
Caveman	116,957	Tionscadal víreasach “why use many token when few token do trick” — cumhachtaíonn a fhealsúnacht chainte uaimh ár mód comhbhrúite chaighdeánach agus os cionn 30 riail líonta/comhdhlúthaithe.
RTK – Rust Token Killer	85,350	Comhbhrú aschuir orduithe ardfheidhmíochta — spreag sé ár n-inneall RTK, DSL scagaire JSON, aisghabháil aschuir amh agus an píblíne cruachta RTK → Caveman.
headroom	78,672	Comhbhrú comhthéacs inchúlaithe (SmartCrusher) — spreag sé ár n-inneall `headroom` agus patrún marcóra aisghabhála `ccr`.
LLMLingua	6,797	Taighde ar chomhbhrú leideanna (LLMLingua / LLMLingua-2) — spreag sé ár n-inneall `llmlingua` asincrónach, sábháilte do chód agus a osclaíonn ar theip.
llmlingua-2-js	33	An port JS/ONNX (MobileBERT / XLM-RoBERTa) a úsáidtear mar inneall cúil snáithe oibre dár n-inneall LLMLingua.
Troglodita	50	Comhbhrú comharthaí PT-BR — cumhachtaíonn sé ár bpacáiste teanga pt-BR: laghdú ar phléonasmaí agus baint líontóirí arna mionchoigeartú do ghramadach na Portaingéilise Brasaíle.
ponytail	182,929	Scil YAGNI an “fhorbróra sinsearaigh leisciúil” a chuaigh víreasach — spreag sí ár Stíl Aschuir less-code: treoir don athrú is lú a oibríonn, a laghdaíonn an cód _ginte_ (an comhpháirt aschuir de phrós gonta Caveman).
i-have-adhd	59,838	Cuireadh a stíl freagartha atá dírithe ar ghníomh agus oiriúnach do ADHD in oiriúint do stíl aschuir achomair OmniRoute i gcúig theanga.

### 🧩 Formáidí dlútha, taighde ar chomharthaí agus uirlisí atá feasach ar chód

Tionscadal	⭐	An chaoi ar spreag sé OmniRoute
TOON	25,602	Token-Oriented Object Notation — mhúnla a cholúnach, le ceanntásc agus sraitheanna, ár gcéim chomhbhrúite tháblaigh.
GCF – Graph Compact Format	61	Chuir a fhormáid dhlúth ghraif agus a dhearadh próifíl chineálach eolas ar fáil do chomhbhrú táblaí OmniRoute agus d’fhormáid chódóra Headroom.
gcf-typescript	4	An cur i bhfeidhm MIT TypeScript a cuireadh isteach go díreach agus a leathnaíodh mar chódóir próifíle chineálaigh Headroom.
token-optimizer-mcp	566	Taisce Brotli/SQLite + deilte comhthéacs in aghaidh an tseisiúin — spreag sé ár n-inneall `session-dedup`.
token-savior	1,203	Comhbhrú aschuir Bash + próifílí MCP — spreag sé ár smacht ar scor an chomhbhrúite agus laghdú léiriú uirlisí MCP.
token-saver	162	Comhbhrú aschuir atá feasach ar ábhar agus in aghaidh an chineáil comhaid, le scor feasach ar theipeanna — dheimhnigh sé ár seoladh in aghaidh an chineáil agus ár scipeáil nuair nach mbaintear an gnóthachan íosta amach.
token-optimizer	2,853	“Aimsigh na comharthaí taibhsiúla” — chuir a phatrún seachfhoinsithe agus láimhseála in-aisghabhála eolas ar fáil dár smaointeoireacht maidir le seachfhoinsiú CCR.
TokenMizer	34	Treoirphlean seisiúin-ghraif + dedupliú línte tras-uaire a chuir eolas ar fáil do dhearadh ár session-dedup.
OmniCompress	3	JSON colúnach Rust + aisghabháil bunaithe ar ábhar + dedupliú trasna teachtaireachtaí — dheimhnigh sé dearadh ár n-inneall `headroom`/`ccr`/`session-dedup` agus an t-athraitheas cobhsaí ó thaobh taisce de: tá an “fhoirm chomhbhrúite neamhspleách ar shuíomh”.
mcp-compressor	140	Comhbhrú scéimre/tuairiscí uirlisí MCP — chuir sé eolas ar fáil dár laghdú ar chairdinéalacht léiriú uirlisí MCP.
RepoMapper	218	Rangú léarscáile stórtha ar nós Aider — chuir sé eolas ar fáil dár n-iniúchadh ar rangú léarscáile stórtha / aisghabhála.
quiet-shell-mcp	4	Laghdú dearbhaitheach ar aschur sliogáin thar MCP — dheimhnigh sé ár gcomhbhrú dearbhaitheach ar aschur bash.
ts-morph	6,222	Foireann uirlisí API Tiomsaitheora TypeScript — spreag sé ár mbaint tuairimí bunaithe ar pharsálaí, a chaomhnaíonn literálacha teaghráin, teimpléid agus nathanna rialta.

### 🧠 Cuimhne agus RAG

Tionscadal	⭐	An chaoi ar spreag sé OmniRoute
Mem0	68,294	Ciseal cuimhne uilíoch — mhúnlaigh a shamhail seachfhreastalaí mar theorainn scríofa/léite ár n-ailtireacht chuimhne.
Letta (MemGPT)	25,321	Gníomhairí stáit le cuimhne shraitheach — spreag sé ár samhail shraitheach Context Control & Recovery (CCR).
WFGY	1,804	Tacsanomaíocht ProblemMap de 16 mhodh teipe athfhillteach RAG/LLM — an stór focal comhroinnte inár dtreoir fabhtcheartaithe.

### 🛰️ Iniúchadh tráchta, MITM agus seachfhreastalaí trédhearcach

Tionscadal	⭐	An chaoi ar spreag sé OmniRoute
llm-interceptor	81	Chuir idircheapadh/anailís MITM ar thrácht idir cúntóirí códaithe ↔ LLM eolas ar fáil do riachtanais luatha Traffic Inspector. Tá ceithre mhodúl a díorthaíodh roimhe seo — cumasc SSE, normalú comhrá, mascadh rúin agus sláintíocht ceanntásca — curtha in ionad cur chun feidhme neamhspleách glan-seomra atá bunaithe ar chaighdeáin phrótacail phoiblí. Fanann an dá dhromchla pasáiste óstach (`passthrough.ts` agus `_internal/bypass.cjs`) ina gcur chun feidhme inmheánacha de chuid OmniRoute, a aicmítear go neamhspleách; níor athscríobhadh iad mar chuid den athsholáthar sin.
ProxyBridge	6,978	Ródú trédhearcach seachfhreastalaí in aghaidh an phróisis — spreag sé ár ndíshuiteáil MITM atá sábháilte i gcás tuairteála, teorainneacha ama neamhghníomhaíochta soicéid, sannadh próiseas `/proc` agus gabháil TPROXY.

### 📚 Sonraí samhlacha, inbhraiteacht agus comhéadan úsáideora

Tionscadal	⭐	An chaoi ar spreag sé OmniRoute
models.dev	7,486	Bunachar sonraí oscailte de shonraíochtaí, phraghsáil agus chumais samhlacha AI — sioncronaithe go dúchasach inár gcatalóg samhlacha.
React Flow / xyflow	38,874	An leabharlann ghraif nód-bhunaithe a chumhachtaíonn ár Compression Studio agus Combo/Routing Studio fíorama.
LangGraph	44,349	Spreag léirshamhlú beo ghraf sreafa oibre LangGraph Studio amharc cascáide fíorama ár Studios.
Langfuse	36,907	Mhúnlaigh a shamhail inbhraiteachta trace → span → generation ár n-eas uisce i Compression Studio.
Kiali	3,647	Inbhraiteacht mhogalra seirbhíse Istio — spreag sé ár suaitheantais scoradáin chiorcaid agus ár n-amharcanna ar imill earráide in Routing/Combo Studio.
lobe-icons	2,666	Lógónna branda AI/LLM a thaispeánann deilbhíní na soláthraithe ar fud ár ndeais.
flag-icons	12,499	Soláthraíonn sé na bratacha SVG atá ceadúnaithe faoin MIT a úsáideann roghnóir teanga an README.

### 🛡️ Slándáil

Tionscadal	⭐	An chaoi ar spreag sé OmniRoute
awesome-secure-defaults	723	Liosta coimeádta de leabharlanna atá slán de réir réamhshocraithe a threoraíonn ár roghanna slándála (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).

### 🧭 Uirlisí comhlántacha

Tionscadal	⭐	An chaoi ar spreag sé OmniRoute
ClawRouter	6,649	Spreag sé dí-dúbláil iarratas, cúltaca éigeandála ar chostas nialasach, straitéisí Auto-Combo inphlugáilte agus aicmiú intinne ilteangach.
Antigravity-Manager	32,785	Chuir a athmapáil samhlacha a thuigeann cuntais, a bhailíochtú cosán inrite agus a iompar lipéad plean eolas ar fáil do runtime Antigravity de chuid OmniRoute.
vscode-antigravity-cockpit	4,852	Spreag a fhormáid dhlúth comhaireamh síos athshocraithe cuóta an taispeáint chomhfhreagrach ar theorainn an tsoláthraí in OmniRoute.
AionUi	33,996	Spreag a chomhtháthuithe ACP braiteadh uathoibríoch OmniRoute ar ghníomhairí CLI suiteáilte.
CodexBar	22,955	D’aithin sé dromchla cuóta Grok Build; rinne OmniRoute formáid bheo na sreinge a fhíorú agus a cheartú go neamhspleách ina dhiaidh sin.

## 📄 Ceadúnas Ceadúnas MIT - féach ar [LICENSE](LICENSE) le haghaidh sonraí. ---

**[⬆ Ar ais go dtí an barr](#-omniroute)** · Tógtha le ❤️ don phobal AI foinse oscailte. _{Cruthaithe ag Diego Souza · OmniRoute v3.8.54 · Node ≥22.22.2 · Ceadúnas MIT · omniroute.online}