# 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

OmniRoute — Ná stop de bheith ag códú choíche. Gach uirlis AI → 372 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 chomharthaí (~89% ar an meán) — ná buail teorainneacha choíche. 372 soláthraí AI · 150+ sraith saor in aisce · ~1.62B comhartha saor in aisce/mí · 19 straitéis ródaithe · $0 le tosú.

## 💰 ~1.62B Comhartha / Mí ar fud Sraitheanna Saor in Aisce Tríú Páirtí

> **Bain úsáid as do chuntais soláthraithe féin.** Is meastachán comhiomlán é seo ar shraitheanna saor in aisce tríú páirtí a bhfuil incháilitheacht ar leith acu, ní deontas comharthaí ó OmniRoute. Cláraigh, faigh dintiúir nuair is gá, agus ceangail na soláthraithe is féidir leat a úsáid; rialaíonn gach soláthraí a theorainneacha, a infhaighteacht agus a théarmaí féin. > > Is mór an crá é sraitheanna saor in aisce a chruachadh de láimh — na dosaenacha SDKanna, na dosaenacha teorainneacha ráta, agus gan tuairim agat cé mhéad atá agat i ndáiríre. Déanann OmniRoute catalógú ar **489 iontráil sraithe saor in aisce thar 35 eochair linn athfhillteacha** agus ríomhann sé líon ceannlíne na gcomharthaí ó na **17 linn a bhfuil buiséad míosúil dearfach foilsithe acu, chomh maith le cúig theorainn Groq in aghaidh an mhúnla**, agus linnte comhroinnte á ndídhúbailt. Taispeántar ar leithligh cuótaí nach mbíonn ar fáil ach tar éis seiceáil aitheantais réigiúnaigh (faoi láthair: ModelScope), +~6M taobh thiar d’fhíorú aitheantais réigiúnaigh, agus ní chuirtear leis an gceannlí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 comhartha saor in aisce in aghaidh na míosa go seasta, suas le ~2.22B sa chéad mhí le creidmheasanna clárúcháin, ó 35 eochair linn athfhillteacha dhoiciméadaithe a chlúdaíonn 489 iontráil sraithe saor in aisce chatalógaithe taobh thiar d’aon chríochphointe amháin. Matamaitic ionraic dhídhúbailte de réir linne — déantar gach linn chomhroinnte a chomhaireamh uair amháin, lena n-áirítear 17 linn athfhillteacha a bhfuil buiséad míosúil dearfach comharthaí foilsithe acu, chomh maith le cúig theorainn Groq in aghaidh an mhúnla; tá 13 sholáthraí marcáilte le seachaint sa chatalóg riosca té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 an mhúnla) agus linnte níos lú, chomh maith le creidmheasanna clárúcháin don chéad mhí agus soláthraithe atá saor in aisce go buan gan teorainn chomharthaí, arna dtaispeáint ar leithligh ionas nach méadóidh siad an ceannlíne riamh. Úsáidte/fágtha beo ar /dashboard/free-tiers.

> Achoimre bheoite ar an leathanach beo `/dashboard/free-tiers`. Modheolaíocht iomlán (dídhúbailt linne, sraitheanna creidmheasa, téarmaí soláthraithe): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**. > > _{Déantar na figiúirí seo a athiniúchadh gach coicís i gcomparáid leis an gcatalóg bheo agus **bogann siad sa dá threo** — cuireann soláthraí deireadh le sraith saor in aisce agus titeann an uimhir; cuirtear ceann nua leis agus ardaíonn sí. Foilsímid an méid a ríomhann an chatalóg i ndáiríre, agus ní fhoilsímid cás is fearr arna shlánú suas riamh.}

⭐ Cuir réalta leis an stór má chabhraigh 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) ### 💬 Glac páirt sa phobal **👋 Lean an cothabhálaí — 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 Brasil](https://img.shields.io/badge/WhatsApp_Brasil-25D366?style=for-the-badge&logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) [![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) / [🇧🇷 Brasil](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.52+` | | --------------------------------------- | :---------------------: | :---------: | :-------------------: | | 🌐 Soláthraithe | 352 | **358** | 372 | | 🧠 Aitheantais uathúla samhlacha comhrá | 1320 | **1374** | 1443 | | 🖼️ Droichead módúlachta | 🆕 fís + fuaim + físeán | ✓ | ✓ | | 📡 Catalóg Radar saor in aisce | 🆕 roghnach | ✓ | ✓ | | ⚖️ Sceidealú atá feasach ar chuótaí | 🆕 Quota-Share | ✓ | ✓ | | 📊 Teiliméadracht cuótaí | 🆕 beo | ✓ | ✓ | | 🧰 Mód gan chomhéadan grafach | — | — | 🆕 `serve --headless` | | 🛤️ Bonneagar ráille LTS | — | — | 🆕 cainéil eisiúna | **→ [Treochlár](ROADMAP.md) — ag taisteal ar an ráille i dtreo `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) ![Íoslódálacha Míosúla NPM](https://img.shields.io/npm/dm/omniroute?label=npm/month&color=cb3837&logo=npm) [![Docker Hub](https://img.shields.io/docker/v/diegosouzapw/omniroute?label=Docker%20Hub&logo=docker&color=2496ED)](https://hub.docker.com/r/diegosouzapw/omniroute) [![Ceadúnas: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](LICENSE) ![Íoslódálacha 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)

🚀 Tosaigh	🚀 Tús Tapa	📦 Suiteáil	🆓 Gan chumraíocht
💡 Foghlaim	💥 An Gealltanas	🤔 Cén Fáth OmniRoute	🏆 Na Rudaí a Dhealaíonn É
⚙️ Gnéithe	🎯 Teaglamaí	🌐 Soláthraithe	🔌 CLI & MCP
	🗜️ Comhbhrú	🖥️ Cá Ritheann Sé	🔒 Príobháideach
👀 Féach air	🎬 I mBun Gnímh	✨ Céard atá Nua	🤖 CLIanna Comhoiriúnacha
💚 Tacaíocht	💚 Tacaigh / Tabhair Síntiús	💬 Pobal	💖 Urraitheoirí
📦 Tionscadal	🛠️ Cruach Teicneolaíochta	📖 Doiciméadacht	👥 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 heochair API, ansin dírigh d'uirlis ar localhost:20128/v1 ag úsáid eochair API OmniRoute agus na samhla auto. Braitheann an ródú 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 sprioc incháilithe gan eochair ag suiteáil úr, agus d'fhéadfadh soláthraí gan eochair cliaint tríú páirtí a dhiúltú. Fágtar soláthraithe marcáilte `tos: avoid`, lena n-áirítear OpenCode Free agus Kiro, as an ródú uathoibríoch de réir réamhshocraithe; ní sháraíonn ceangal cuntais an socrú sin. Féach ar an [Treoir maidir le Sraitheanna Saor in Aisce](docs/getting-started/FREE-TIERS-GUIDE.md) sula roghnaíonn tú soláthraí.} _{📦 Scripteanna mear-thosaithe le cóipeáil agus greamú do **Python, Node.js, PHP, agus cURL** → [`examples/quickstart/`](examples/quickstart/)}

# 💥 An Gealltanas

# 🤔 Cén Fáth OmniRoute?

Sreabhadh iarratais OmniRoute: glaonn d'IDE nó CLI (Claude Code, Cursor, Cline…) críochphointe áitiúil amháin (http://localhost:20128/v1); is féidir le Ródaire Cliste OmniRoute (comhbhrú RTK + Caveman, 19 straitéis ródaithe, scoradáin chiorcaid, duaithníocht TLS, MCP, A2A, ráillí cosanta) cúltaca a dhéanamh thar 4 shraith soláthraithe fad a bhíonn sprioc incháilithe shláintiúil ar fáil — Sraith 1 Síntiús, Sraith 2 Eochair API, Sraith 3 Saor agus Sraith 4 Saor 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é

Na 19 straitéis ródaithe teaglama ar fad beoite — 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, cache-optimized, lkgp, auto, fusion, pipeline. Féach an tábla thuas chun a fháil amach cad a dhéanann gach ceann acu.

> 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 go dtí an chéad samhail shláintiúil incháilithe eile. 🛡️ ### ⚡ Gan aon chumraíocht — níl le déanamh ach `auto` a úsáid 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, arna scóráil beo:

Aitheantas na samhla	An rud a optamaíonn sé
`auto`	🎯 Réamhshocrú cothromaithe (LKGP — cloíonn sé leis an soláthraí maith deireanach a bhí agat)
`auto/coding`	🧑💻 Ualuithe a thugann tús áite don cháilíocht le haghaidh giniúint cóid
`auto/fast`	⚡ An aga folaigh is ísle ar dtús
`auto/cheap`	💰 An costas is ísle in aghaidh an chomhartha ar dtús
`auto/offline`	🔋 An cuóta / lamháil teorann ráta is mó ar dtús
`auto/smart`	🔭 Tús áite don cháilíocht + 10% taiscéalaíochta chun samhlacha níos fearr a aimsiú
`auto/lkgp`	📌 Greamaitheacht shainráite don soláthraí maith is déanaí atá ar eolas
`auto/chaos`	🧪 Leathnú amach comhthreomhar chuig painéal samhlacha (ceann amháin in aghaidh an tsoláthraí, 5 de réir réamhshocraithe), agus freagra amháin á thabhairt ar ais; glao réamhtheachtach amháin in aghaidh gach samhla sa phainéal, ní ionsá lochtanna

## ### 🔀 Nó tóg do cheann féin — 19 straitéis ródaithe Na **19** straitéis ar fad — measc agus meaitseáil ag gach céim den teaglama:

#	Straitéis	An rud a dhéanann sí
1	`priority`	Liosta ordaithe ina dtugtar tús áite don chéad sprioc — ídigh gach ceann sula mbogtar go dtí an ché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, ceann i ndiaidh a chéile
5	`p2c`	Cothromú randamach ualaigh bunaithe ar chumhacht dhá rogha
6	`least-used`	Roghnaigh an sprioc a bhfuil an t-ualach reatha is ísle uirthi
7	`random`	Roghnú randamach aonfhoirmeach (dúblaigh bainte)
8	`strict-random`	Roghnú randamach gan athrá a dhídhúbailt 🎲
9	`cost-optimized`	Íoslaghdaigh an costas $ in aghaidh na hiarrata bunaithe ar phraghsáil bheo na catalóige 💸
10	`headroom`	Roghnaigh an sprioc a bhfuil an cuóta is mó fágtha aici
11	`reset-window`	Tabhair tús áite don sprioc a n-athshocraítear a fuinneog chuóta is luaithe
12	`reset-aware`	Rangaigh de réir am athshocraithe an chuóta — fuinneoga gearra ar dtús 📊
13	`context-relay`	Aistrigh an comhthéacs idir spriocanna le haghaidh comhráite fada 🧠
14	`context-optimized`	Roghnaigh an sprioc is oiriúnaí do mhéid reatha an chomhthéacs
15	`cache-optimized`	Ceangail gach réimír leid in-athúsáidte leis an gcuntas céanna — uasmhéadaigh amais i dtaisce na leide 🎯
16	`lkgp`	An Chonair Mhaith is Déanaí atá ar Eolas — ceanglaíonn sí leis an soláthraí deireanach ar éirigh leis, ansin téann sí siar chuig na rialacha
17	`auto`	Scóráil bheo 16 fhachtóir thar gach nasc 🤖
18	`fusion`	Leathnaigh amach chuig painéal samhlacha + déanann moltóir freagra amháin a shintéisiú 🧬
19	`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á athléimneacht ionsuite ann (3 shraith neamhspleácha)

Athléimneacht OmniRoute — 3 shraith neamhspleácha féinleighis, an tsraith cheart don teip cheart. Sraith 1, scoradán ciorcaid an tsoláthraí (an soláthraí iomlán): ní ghníomhachtaítear é ach ar 408/5xx, tairseacha OAuth 8× / eochair API 12× / áitiúil 2×, athshocraítear é tar éis 60s/30s/15s agus téann sé isteach i dtóraíocht LEATHOSCAILTE, téarnamh leisciúil; fad atá sé OSCAILTE, atreoraíonn an teaglama chuig an gcéad soláthraí eile. Sraith 2, tréimhse shuaimhnithe an naisc (eochair/cuntas amháin): bonntréimhse 5s do OAuth / 3s d’eochair API, cúlú easpónantúil ×2 le cosaint in aghaidh ró-ualach comhuaineach, cloíonn 429 le Retry-After, glanann rath gach staid earráide; scipeáiltear eochair amháin atá i dtréimhse shuaimhnithe agus leanann na heochracha eile den tseirbhís. Sraith 3, frithdhúnadh samhla (samhail amháin): cuireann 429 in aghaidh na samhla, 404 áitiúil nó diúltuithe móid frithdhúnadh ar an tsamhail sin amháin — ní ar an nasc iomlán riamh. Is don oibreoir iad staideanna foirceanta (toirmiscthe, imithe in éag, creidmheasanna ídithe), ní tréimhsí suaimhnithe iad.

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

## 🏆 Cad a Dhéanann OmniRoute Uathúil

_{📊 An mhodheolaíocht iomlán & sonraí de réir gné i gcomparáid le 9router, OpenRouter, CLIProxyAPI & 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.50**. Tá an stair iomlán in [`CHANGELOG.md`](CHANGELOG.md). - **🎛️ OmniConductor** — tarmligean isteach A2A chuig d’fhlít gníomhairí, scileanna Conductor ar an gCárta Gníomhaire, agus painéal deais le comhrá gutha brúigh-le-labhairt Faro. → [Freastalaí A2A](docs/frameworks/A2A-SERVER.md) - **🛂 Cead isteach oiriúnaitheach & cosaint ar ró-ualach** — cuirtear iarratais mhóra chomhrá i scuaine in ionad 503 a thabhairt, le léasanna rollacha adamhacha RPM in aghaidh an naisc. → [Treoir Athléimneachta](docs/architecture/RESILIENCE_GUIDE.md) - **🗂️ Ord canónach `/v1/models`** — bloc tadhlach amháin grúpáilte de réir soláthraí do gach soláthraí (teaglamaí socraithe ar dtús), cobhsaí thar gach foinse catalóige. → [Tagairt API](docs/reference/API_REFERENCE.md) - **🗜️ Cruachan comhbhrúite** — cosaint ar bhoilsciú cumasaithe de réir réamhshocraithe, pacáistí Caveman do DE / FR / JA + Sínis (wényán), scagairí RTK do Gradle & .NET. → [Comhbhrú](docs/compression/COMPRESSION_ENGINES.md) - **💸 Costas macánta ar ráta comhréidh** — léirítear **$0** san anailísíocht costais do sholáthraithe síntiúis / plean códaithe; leanann buiséad, cuóta & ródú de mheastacháin a dhéanamh. → [Tagairt API](docs/reference/API_REFERENCE.md) - **⚖️ Ródú Quota-Share** — roinn cuóta cuntais chomhroinnte go cothrom thar eochracha comhthiomsaithe, ar bhealach a chaomhnaíonn obair ionas go dtugtar slisní díomhaoine ar iasacht. → [Treoir Athléimneachta](docs/architecture/RESILIENCE_GUIDE.md) - **🤖 Socrú CLI/gníomhaire le hordú amháin** — 13 ordú cláraithe `setup-*`; seolann `omniroute run` 7 CLI (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); tacaíonn `omniroute configure` le 10 sprioc trí roghnóir idirghníomhach soláthraí+samhla agus ceanáin de réir comhthéacs. → [Comhtháthuithe CLI](docs/guides/CLI-INTEGRATIONS.md) - **🛰️ Mód cianda** — rialaigh OmniRoute cianda le comharthaí scóipeáilte (`connect` / `contexts` / `tokens`) + cúntóir OAuth `antigravity` le haghaidh suiteá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, sáruithe samhla / móid / buiséid-USD de réir iarratais. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🗜️ Comhbhrú inphlugáilte** — 12 inneall inchumtha + Compression Studios: LLMLingua-2, Ultra dhá shraith, omniglyph, geata dílseachta in aghaidh na céime, GCF v3.2, eagarthóir athordaithe tarraing-agus-scaoil. → [Comhbhrú](docs/compression/COMPRESSION_ENGINES.md) - **🕵️ Díchriptiú trédhearcach MITM (TPROXY)** — gabh CLIanna a dhéanann neamhaird d’athróga timpeallachta seachfhreastalaí, le CA in aghaidh SNI + suiteálaí stóras muiníne. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md) - **💸 Teiliméadracht costais i ngach áit** — ceanntásca costais/úsáide `X-OmniRoute-*` ar gach críochphointe, ceanntásc coigiltis cache-HIT, cuótaí caiteachais USD in aghaidh na heochrach. → [Tagairt API](docs/reference/API_REFERENCE.md) - **🧠 Cuimhne atá faoi do smacht** — díchumasaithe de réir réamhshocraithe, cainníochtú veicteora int8 roghnach + meath clóscríofa, `x-omniroute-no-memory` de réir iarratais. → [Cuimhne](docs/frameworks/MEMORY.md) - **🛡️ Slándáil** — cosaint ar instealladh leide ar gach bealach LLM (sraith tástála foirne deirge), ráille cosanta roghnach chun dintiúir a cheilt (ceileann sé eochracha API/rúin sceite sa dá threo), cuardach gréasáin DuckDuckGo saor in aisce mar rogha dheiridh, agus geata logála isteach OIDC roghnach don deais (bíonn logáil isteach le pasfhocal ar fáil i gcónaí). → [Ráillí Cosanta](docs/security/GUARDRAILS.md) - **🖼️ Críochphointí nua** — cuireann `/v1/ocr` (Mistral OCR) agus `/v1/audio/translations` (ar nós Whisper) an bailchríoch ar an dromchla meán. → [Tagairt API](docs/reference/API_REFERENCE.md) - **🎨 Giniúint íomhá / físe / fuaime** — API amháin do na meáin: físeáin xAI Grok Imagine & Novita AI, ComfyUI, Magnific, Adobe Firefly, Segmind, agus soláthraithe cainte ar nós ElevenLabs. → [Tagairt API](docs/reference/API_REFERENCE.md) - **🌍 Imscaradh & oibríochtaí** — `basePath` seachfhreastalaí droim ar ais, uathbhrath teanga brabhsálaí, rianú gléis in aghaidh na heochrach, muinín MITM gan root, logánú zh-TW. → [Timpeallacht](docs/reference/ENVIRONMENT.md) - **🤝 Tuilleadh soláthraithe & gníomhairí** — gníomhairí néil (Codex Cloud, Cursor, Devin, Jules), Grok Build (xAI) le brabhsálaí + logáil isteach OAuth, cárta den chéad scoth do Ollama, Claude Opus 5 & Sonnet 5, comhpháirtíocht oifigiúil Kimi (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… agus **catalóg 352 soláthraí** athnuaite. → [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í/folaigh a rinne freastal air, stiúrann straitéis teaglama nua `cache-optimized` + fachtóir `cacheAffinity` Auto-Combo iarratais athfhillteacha ar ais chuig an nasc ina bhfuil an réimír taiscthe, agus nochtann críochphointe inléite amháin `/v1/auto-combo/{channel}/candidates` comhthiomsú beo iarrthóirí cainéil `auto/*`. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **⚡ Feidhmíocht áitiúil & bonneagar** — Redis áitiúil le clic amháin, imscarthóirí athsheachadta Cloudflare Workers / Deno Deploy, 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), APIanna Batch & Files atá comhoiriúnach le OpenAI, taisce shéimeantach freagartha, géimniú le cláir cheannaireachta, aimsiú gníomhairí ACP (15 ghníomhaire ionsuite), easpórtáil sceidealaithe logaí chuig BigQuery, scaipeadh amach comhthreomhar il-samhla `auto/chaos`, droichead bota Telegram, bainisteoir leaganacha san aip agus ranguithe soláthraithe saor in aisce LMArena-ELO. → [Doiciméid](docs/README.md)

## 🤖 CLIanna & Gníomhairí Códúcháin Comhoiriúnacha > Cumraíocht amháin — `http://localhost:20128/v1` — agus ritheann **gach** IDE nó CLI intleachta saorga ar shamhlacha saor in aisce agus 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é le · Agent Deck · Kiro · Command Code · Antigravity · Windsurf · AMP · aon uirlis atá comhoiriúnach le OpenAI

_{📖 Socrú in aghaidh na huirlise do na 36 uirlis ar fad (26 CLI Code + 10 CLI Agent) → [`docs/reference/CLI-TOOLS.md`](docs/reference/CLI-TOOLS.md) · 🧩 Breiseán OpenCode → [`@omniroute/opencode-provider`](https://www.npmjs.com/package/@omniroute/opencode-provider)}

**Seol aon CLI a dtacaítear leis trí OmniRoute le hordú amháin** — ní scríobhtar aon chomhaid chumraíochta, instealltar dintiúir do gach próiseas, agus faigheann Qwen/Gemini eolaire baile sealadach leithlisithe: ```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 na huirlise féin: omniroute configure codex # chomh maith: claude opencode qwen aider goose gemini cline continue kilo ``` Cloíonn gach ordú leis an gcomhthéacs cianda gníomhach (`omniroute connect `), tugann `--dry-run` réamhamharc ar na hathróga timpeallachta/argóintí beachta gan iad a rith, agus coimeádann `--api-key-env NAME` rúin amach as stair do bhlaoisce. → [Comhtháthuithe CLI](docs/guides/CLI-INTEGRATIONS.md)

## 🌐 372 Soláthraí IS — 154 Marcáilte mar Shaor in Aisce sa Chatalóg

> **372 soláthraí cláraithe** ar fud na mbailiúchán canónach comhrá, meán, cuardaigh, áitiúil, gníomhairí néil agus córais, lena n-áirítear **154 a bhfuil meiteashonraí aimsithe `hasFree: true` acu**. Clúdaíonn clárlann na samhlacha comhrá **237 soláthraí / 3,009 péire ar leith soláthraí-samhla / 1,443 aitheantas amh samhla**; tá **491 ró in aghaidh na samhla**, **35 comhthiomsú athfhillteacha** agus **54 soláthraí athfhillteacha/gan eochair atá saor in aisce go deo** sa chatalóg ar leith de bhuiséid saor in aisce. Is ainmneoirí éagsúla iad seo d'aon ghnó; tá sainmhínithe agus ríomhanna dí-dhúbláilte de réir comhthiomsaithe le fáil sa [Tagairt Soláthraithe](docs/reference/PROVIDER_REFERENCE.md) agus sna [Sraitheanna Saor in Aisce](docs/reference/FREE_TIERS.md).

### 🏢 Gach mórshaotharlann — 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 330 eile — réitítear gach deilbhín go beo ó chatalóg soláthraithe an deais. 📖 [Tagairt Soláthraithe](docs/reference/PROVIDER_REFERENCE.md)}
### 🆓 Saor in Aisce go Deo — $0, gan chárta

OpenCode Zen _{DeepSeek V4, Nemotron 3 Gan teorainn chomharthaí}	Kilo Code _{Uathródaire, Tencent Hy3 Saor in aisce go deo}	Requesty _{GPT-OSS 120B, Nemotron Saor in aisce go deo}	SiliconFlow _{DeepSeek V3.2 / R1 Sraith saor in aisce}	Z.AI GLM _{GLM-4.7 / 4.5-Flash Saor in aisce go deo}	Baidu ERNIE _{ERNIE 4.0 Saor in aisce go deo}
Qoder AI _{Qwen3-Max, Kimi-K2 Saor in aisce GAN TEORAINN}	Pollinations _{GPT, Llama, Claude Níl eochair de dhíth}	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 _{samhlacha :free +$10 → RPM níos airde}

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

## 🖥️ An Áit a Ritheann OmniRoute — Áit ar bith

> An aip chéanna, d’inneall féin, do rialacha féin. Ó shuiteáil dhomhanda npm go dtí **do ghuthán** trí Termux.

Ardán	Suiteáil	Buaicphointí
📦 npm (domhanda)	`npm install -g omniroute`	Ordú amháin, aon OS
🐳 Docker	`docker run … diegosouzapw/omniroute`	Il-ailtireacht AMD64 + ARM64
🖥️ Deasc (Electron)	`npm run electron:build`	Fuinneog dhúchasach + tráidire córais — Windows / macOS / Linux
🎩 Barra roghchláir (OmniRouteTray)	`brew install --cask zoispag/tap/omniroute-tray`	Déanann sé maoirseacht ar an bhfreastalaí & nuashonraíonn sé go huathoibríoch é — macOS
💪 ARM	`arm64` dúchasach	Raspberry Pi, freastalaithe ARM, Apple Silicon
📱 Android (Termux)	`pkg install nodejs && npx -y omniroute`	Ritheann sé ar do ghuthán, 24/7, gan root
📲 PWA	"Cuir leis an Scáileán Baile"	Lánscáileán, as líne, insuiteáilte ón mbrabhsálaí
🧩 Breiseán OpenCode	`@omniroute/opencode-provider`	Comhtháthú dúchasach OpenCode
🤖 VS Code Copilot Chat	suiteáil an eisínteacht OmniCopilot	Gach samhail OmniRoute i roghnóir dúchasach Copilot Chat — cobhsaí & Insiders
🛠️ Ón bhfoinse	`npm install && npm run dev`	Déan forbairt air, rannchuidigh leis

_{📖 [Treoir Docker](docs/guides/DOCKER_GUIDE.md) · [Deasc](electron/README.md) · [Tráidire an bharra 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 laistigh de Copilot Chat dúchasach VS Code

> Gan aon bharra taoibh nua, gan aon chomhéadan comhrá nua — taispeántar gach samhail a fhreastalaíonn OmniRoute díreach sa > **roghnóir samhlacha Copilot Chat a úsáideann tú cheana féin**. Ó VS Code 1.122 i leith, oibríonn samhlacha soláthraí > gan síniú isteach ar GitHub ná síntiús Copilot — mód gníomhaire, glaoch uirlisí agus fís, agus iad > saor in aisce. Suiteáil an eisínteacht **[OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)**, dírigh ar do fhreastalaí OmniRoute í (`localhost:20128` de réir réamhshocraithe), ansin oscail Copilot Chat → roghnóir samhlacha → **Bainistigh Samhlacha…** → **OmniRoute**.

Siopa	Nasc	Oibríonn sé le
🧩 VS Code Marketplace	Suiteáil →	VS Code — cobhsaí & Insiders
🔓 Open VSX Registry	Suiteáil →	Cursor, Windsurf, VSCodium, Theia, code-server, Gitpod, Antigravity, Kiro…

Ón taobh istigh den eagarthóir: oscail an t-amharc **Eisínteachtaí**, cuardaigh **"OmniRoute"**, cliceáil **Suiteáil** — oibríonn sé ar an mbealach céanna sa dá shiopa. Tá an fhoinse, na fadhbanna agus an lámhleabhar foilsitheoireachta le fáil ag [diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot). _{📖 [Treoir VS Code Copilot Chat](docs/guides/VSCODE-COPILOT.md) — socrú, a dtaispeánann an roghnóir, deais i gcluaisín, fabhtcheartú}

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

> Is sona `omniroute serve` nuair a bhíonn sé ar siúl i gcónaí. Déanann **[OmniRouteTray](https://github.com/zoispag/omniroute-tray)** > aip barra roghchláir socraigh-agus-déan-dearmad di sin do macOS: tosaíonn sé an freastalaí, coimeádann sé beo é > tar éis atosuithe, nuashonraíonn sé ina áit é, agus cuireann sé do bhuiséad beo comharthaí faoi aon chliceáil amháin — **gan aon > fhuinneog teirminéil fágtha ar oscailt, gan aon `npm install -g omniroute` le coinneáil faoi chúram.** Tógtha le [Tauri v2](https://v2.tauri.app/) (croí Rust chomh beag le hearráid slánúcháin), tagann sé lena thimpeallacht reatha shínithe Node 24 féin agus bainistíonn sé suiteáil OmniRoute ar leis an aip í, mar sin ní théann sé riamh in adharca le do `node`/`bun` domhanda. **Roinneann sé an chumraíocht agus an bunachar sonraí atá agat cheana in `~/.omniroute/`** — mar sin is é an OmniRoute céanna é a ritheann tú cheana féin, ach hata air. 🎩

A ndéanann sé	Conas
🟢 Déanann sé maoirseacht ar an bhfreastalaí	Seolann sé `omniroute serve`, glacann sé le hásc atá ag rith cheana seachas é a dhúbailt
📊 Úsáid bheo le sracfhéachaint	Barraí cuóta soláthraí, teorainneacha seisiúin/seachtainiúla Claude le comhaireamh síos go dtí an t-athshocrú, miondealú costais 30 lá
🔄 Nuashonraíonn sé ina áit go huathoibríoch	Suiteáil chéimnithe, babhtáil adamhach, aischur ar theip — ar an eisiúint is nuaí i gcónaí
🚀 Tosaigh ar logáil isteach	Seoladh roghnach ar logáil isteach; tráidire amháin, gan deilbhín sa duga
🩺 Dochtúir & logaí	Diagnóisic aon chliceáil agus rochtain ar logaí an fhreastalaí

```sh brew install --cask zoispag/tap/omniroute-tray ``` _{An fearr leat íoslódáil? Faigh an .dmg is déanaí ó
Eisiúintí. Tá an cód foinseach, na saincheisteanna agus na doiciméid tógála ar fáil ag
zoispag/omniroute-tray.

💛 Tionscadal pobail le @zoispag — ní eisiúint oifigiúil de chuid 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 **painéal rialaithe iomlán líne na n-orduithe** é OmniRoute le **breis agus 80 ordú**, chomh maith le prótacail oscailte gníomhairí ionas gur féidir le gníomhaire AI é a oibriú **as a stuaim féin**. ### ⌨️ Fíor-CLI (ní hamháin `start`) ```bash omniroute # freastail ar an ngeata + an painéal (port 20128) omniroute chat # cliant comhrá idirghníomhach TUI (slais: /model /combo /skill /memory) omniroute setup # draoi treoraithe don chéad rith omniroute doctor # diagnóisigh soláthraithe, poirt, spleáchais dhúchasacha ``` ### 🛰️ Mód cianda — rith an CLI anseo, agus OmniRoute ar VPS OmniRoute ar fhreastalaí? Oibrigh é ó do ríomhaire glúine leis an **CLI céanna**. Logáil isteach uair amháin le comhartha rochtana scópáilte; díreoidh gach ordú ar an gcianfhreastalaí ina dhiaidh sin. ```bash omniroute connect 192.168.0.15 # focal faire → comhartha scópáilte, 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 # cruthaigh comharthaí níos cúinge do mheaisíní eile omniroute contexts use default # ← athraigh ar ais chuig an bhfreastalaí áitiúil ``` Tá na comharthaí scópáilte mar `read` / `write` / `admin`; fanann bealaí a sheolann próisis teoranta don lúb logánta 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 timthriallú trí dhromchla barrleibhéil 86 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 thar **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 scóip (forfheidhmiú roghnach), rian iniúchóireachta iomlán
📡 MCP (SSE)	`/api/mcp/sse`	Iompar sruthaithe MCP
🤝 A2A	`/.well-known/agent.json`	Gníomhaire le 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 teagmhais iarratais / cuóta chuig Slack, Discord, Telegram nó aon URL
🛰️ CLI Cianda	`omniroute connect`	Oibrigh ásc cianda le comharthaí rochtana scópáilte

```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 Thóicíní — Go hUathoibríoch

### 📖 Conas a oibríonn sé — píblíne, ailtireacht & matamaitic na gcoigilteas

Píblíne chomhbhrúite OmniRoute: téann iarratas léiritheach cliaint ina bhfuil 10,000 tóicín trí 12 inneall inchumtha — 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 agus thart ar 1,080 tóicín ann sa sampla cruachta doiciméadaithe. Cosnaítear ábhar struchtúrtha le cosaintí caomhnaithe agus geataí dílseachta ag gach céim; féadfaidh módanna follasacha caillteacha nó turgnamhacha ábhar incháilithe a chlaochlú.

Ritheann an teaglaim chruachta réamhshocraithe `RTK → Caveman`. Nuair a ghníomhaíonn an dá cheann ar an bpálasta uirlise/comhthéacs céanna, déantar na coigiltis a iolrú: ```txt combined = 1 − (1 − RTK) × (1 − Caveman_input) average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2% range = 78.4 – 94.6% ``` Cosnaíonn an t-inneall caomhnaithe bloic chóid, URLanna, JSON agus sonraí struchtúrtha **i gcónaí**. > **Cén fáth a n-úsáidfí mórán tóicíní nuair is leor cúpla tóicín?** Téann gach iarratas trí phíblíne chomhbhrúite OmniRoute **go trédhearcach** — níl aon athrú cliaint ag teastáil. Is **cruach de 12 inneall inchumtha** í anois, a ritheann in ord agus is féidir iad a mheascadh agus a mheaitseáil do gach 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 do gach teaglaim:

#	Inneall	A ndéanann sé
1	Session-Dedup	Baineann sé ábhar a athdhéantar thar sealanna (seoltaithe de réir ábhair, tras-seal)
2	CCR	Cartlannaíonn sé bloic mhóra taobh thiar de mharcóirí aisghabhála, a fhaightear ar éileamh
3	Lite	Bearradh spáis bháin + URLanna íomhá (bunlíne íseal-mhoille)
4	RTK	Scagadh cliste, dí-dhúbailt & teascadh torthaí uirlise (feasach ar orduithe)
5	Responses Tool Output	JSON atá gan chaillteanas ar dtús + comhbhrú diagnóiseach teoranta d’aschuir bhlaoisce/phaistí/cuardaigh/tógála (Responses API)
6	Headroom	Dlúthú tábla gan chaillteanas ar eagair JSON (~30%) trí chódac GCF a ionchorpraíodh sa tionscadal
7	Relevance	Scóráil eastóscach abairtí i gcomparáid leis an iarratas úsáideora is déanaí
8	Caveman	Comhbhrú próis bunaithe ar rialacha (~65–75% ar an aschur)
9	Aggressive	Achoimriú + aosú céimnithe ar shealsean
10	LLMLingua-2	Bearradh séimeantach ML trí MobileBERT ONNX — sábháilte do chód, aisioncrónach
11	Ultra	Bearradh heorastúil tóicíní le sraith roghnach mionsamhla (SLM)
12	OmniGlyph	Ionchódú turgnamhach comhthéacs-mar-íomhá do Claude Fable 5 tomhaiste ar an nasc díreach Anthropic; fanann claochladáin GPT 5.6 dúnta ar theip go dtí go bhfaightear admhálacha ón soláthraí. Ceithre phróifíl chomhbhrúite (ionsaitheach mar réamhshocrú, cothromaithe, sábháilte don chód, pas díreach) (an ceann is ionsaithí; roghnach)

Caomhnaítear bloic chóid, URLanna agus sonraí struchtúrtha **i gcónaí** go beacht beart ar bheart. Comhcheanglaíonn **réamhshocruithe aonchliceáil** na hinnill:

Mód	Coigilteas	Is fearr do
🪶 Lite	~15%	Réamhshocrú sábháilte atá ar siúl i gcónaí
🪨 Standard (Caveman)	~30%	Códú laethúil
⚡ Aggressive	~50%	Seisiúin fhada atá trom ar uirlisí
🔥 Ultra	~75%	An coigilteas is mó
🧰 RTK	60–90%	Aschur blaosca/tástála/tógála/git
🔗 Cruachta (RTK → Caveman)	78–95%	Leideanna measctha + logaí uirlise

**Fíorshampla — mód Standard:** > **Roimhe (69 tóicín):** _"Is dócha gurb é an fáth a bhfuil do chomhpháirt React á hathrindreáil ná go bhfuil tú ag cruthú tagairt oibiachta nua le linn gach timthrialla rindreála. Nuair a thugann tú oibiacht inlíne mar prop, feiceann comparáid éadomhain React í mar oibiacht dhifriúil gach uair, rud a spreagann athrindreáil. Mholfainn useMemo a úsáid chun an oibiacht a mheamramú."_ > > **Ina dhiaidh (19 tóicín):** _"Tagairt oibiachta nua gach rindreáil. Prop oibiachta inlíne = tagairt nua = athrindreáil. Timfhill 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 tócan):** _"Is í an fhadhb ná go bhfuil an chomhpháirt á hath-rindreáil toisc go bhfuil tagairt nua oibiachta á cruthú i ngach timthriall rindreála. Mholfainn useMemo a úsáid."_ > > **Ina dhiaidh sin (12 thócan):** _"Ath-rindreáil: tagairt nua gach timthriall (oibiacht inlíne athchruthaithe). Úsáid `useMemo`."_ > > **An freagra céanna. ~70% níos lú tócan. Cruinneas teicniúil slán.** ✅
### 🎚️ Taobh amuigh de na hinnill — stíleanna aschuir, an diail oiriúnaitheach agus rialú in aghaidh na hiarrata 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 ais-aschuir)_ — insteallann siad treoracha cinntitheacha atá sábháilte don taisce chun cruth a chur ar fhreagraí; is féidir iad a chomhcheangal, gach ceann acu ar dhéine `lite` / `full` / `ultra`. Ní gá ach iontráil aonlíne sa chlárlann chun stíl a chur leis: - **Prós gonta** — bain ábhar líonta / ailt / maolú cainte; coinnigh an tsubstaint theicniúil cruinn. - **Níos lú cóid** — YAGNI an “fhorbróra shinsearaigh leisciúil”: an t-athrú oibre is lú, gan scafall nár iarradh. - **Eireaball capaill (forbróir sinsearach leisciúil)** — téigh suas dréimire YAGNI, réitigh an bhunchúis, an difríocht oibre is lú. - **Tá ADHD orm (gníomh ar dtús)** — an chéad ghníomh chun tosaigh, céimeanna uimhrithe, aon chéad chéim nithiúil amháin, gan bhrollach. - **CJK gonta (文言)** — stíl an-ghonta Síneach chlasaicigh (teoranta don lóchaile `zh`). - **🎯 Buiséad comhthéacs oiriúnaitheach** _(an diail)_ — in ionad tairseach tócan aonair casta air/as, méadaigh úsáid na n-inneall is saoire agus is lú caillteanas a oiread agus is gá chun **luí isteach i bhfuinneog chomhthéacs na samhla**. Beartas: `reserve-output` (réamhshocrú, feasach ar an tsamhail) · `percentage` · `absolute`. Mód: `floor` (ráthaíonn sé go luífidh sé) · `replace-autotrigger` (bíonn forlámhas ag do rogha shainráite) · `off` (tairseach oidhreachta). - **🎛️ An áit a gcinntear an comhbhrú** _(tosaíocht, ard → íseal)_ — ceanntásc `x-omniroute-compression` in aghaidh na hiarrata › sárú teaglaim ródaithe › próifíl ainmnithe ghníomhach › oiriúnaitheach / truicear uathoibríoch › réamhshocrú an phainéil › as. Macallaítear an plean a cuireadh i bhfeidhm ar ais i gceanntásc freagartha `X-OmniRoute-Compression: ; source=`. Socraigh truicear uathoibríoch de réir tairsí tócan, cuir an diail oiriúnaitheach ar siúl, greamaigh próifíl ainmnithe, socraigh rogha aonuaire in aghaidh na hiarrata, nó sann píblíne do gach teaglaim ródaithe — cibé ceann a oireann don ualach oibre. Déanann **creat meastóireachta** as líne roghnach (`npm run eval:compression`) dílseacht a scóráil i gcoinne coigilteas ar chorpas greamaithe 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ó leagan níos déanaí á úsáid agat?** Féadfaidh npm scripteanna saolré pacáiste a bhlocáil mura gceadaítear iad. Tá `postinstall` OmniRoute (`node scripts/build/postinstall.mjs`) riachtanach chun a chomhaid dhúchasacha am rite a ullmhú. Agus tú á shuiteáil go domhanda, ceadaigh na pacáistí atá ainmnithe i rabhadh npm. Don tacar pacáistí a thuairiscigh OmniRoute 3.8.51: > > ```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 do shuiteálacha domhanda amach anseo, cumraigh uair amháin é, agus ansin suiteáil mar is gnách: > > ```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 eile, úsáid ainmneacha na bpacáistí ón rabhadh sin. Nuair a cheadaítear pacáiste, tugtar cead dá scripteanna suiteála rith. > **An bhfuil Gemini Web nó soláthraí fianán gréasáin eile á úsáid agat?** Cuimsíonn an pacáiste npm > Playwright ach ní chuimsíonn sé a dhénártha Chromium. Féach an nóta faoi > [shocrú 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. An painéal ag `http://localhost:20128` · An 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ó cuir sreabhadh a chuntais i gcrích. D’fhéadfadh go mbeadh clárú, faomhadh nó modh íocaíochta ag teastáil le haghaidh sraitheanna saor in aisce. Athbhreithnigh 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` orthu ar lár ó `auto` de réir réamhshocraithe. **3) Dírigh d’uirlis códaithe** ```txt Base URL: http://localhost:20128/v1 API Key: [copy from Dashboard → Endpoints] Model: auto (routes among eligible connections — or choose provider/model) ``` **4) Deimhnigh go bhfuil sé ag obair** ```bash curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY" ``` Ba cheart duit liosta de na samhlacha atá ceangailte agat a fheiceáil. 🎉 Sin é — tosaigh ag códú, agus déanfaidh OmniRoute ródú uathoibríoch agus cúltitim duit. Murar féidir le do chliant ceanntásca saincheaptha a sheoladh, nochtann OmniRoute ailiasanna comhoiriúnachta tócanaithe freisin: ```txt OpenAI catalog: http://localhost:20128/vscode/YOUR_KEY/ OpenAI models: http://localhost:20128/vscode/YOUR_KEY/models OpenAI chat: http://localhost:20128/vscode/YOUR_KEY/chat/completions OpenAI responses: http://localhost:20128/vscode/YOUR_KEY/responses Ollama chat: http://localhost:20128/vscode/YOUR_KEY/api/chat Ollama tags: http://localhost:20128/vscode/YOUR_KEY/api/tags ``` Ná húsáid iad seo ach do chliaint nach féidir leo `Authorization: Bearer ...` a cheangal. Is é fíordheimhniú ceanntáisc an modh 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 deais ar 2026-08-24 · Amhchatalóg: YT 809 | TT 137 | IG 124 · Úire (laethanta): YT 1 | TT 21 | IG 22}

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

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

🎬 #3 — TikTok
_{milesreevesai — 620,400 amharc}

🎬 #4 — YouTube
_{Vaibhav Sisinty — 391,109 amharc}

🎬 #5 — Instagram
_{buildwithai.club — 347,652 amharc}

**Rangú iomlán (URLanna canónacha dí-dhúbláilte, `v > 0`, an raon is mó):** | #1 | #2 | #3 | #4 | #5 | | -------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | | [nick_saraev — Instagram](https://www.instagram.com/reel/Da8ZthUPK98/) — **3,042,474** | [theopenstack — Instagram](https://www.instagram.com/reel/DaSs65mMrHk/) — **692,419** | [milesreevesai — TikTok](https://www.tiktok.com/@milesreevesai/video/7667980059189366019) — **620,400** | [Vaibhav Sisinty — YouTube](https://www.youtube.com/watch?v=QucgvbO5gsM) — **391,109** | [buildwithai.club — Instagram](https://www.instagram.com/reel/DbIt9AjK7-U/) — **347,652** | | #6 | #7 | #8 | #9 | #10 | | ----------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | | [nivedan.ai — Instagram](https://www.instagram.com/reel/DbIrCksJiqq/) — **331,973** | [vaibhavsisinty — Instagram](https://www.instagram.com/reel/Dae05TSAK1l/) — **263,744** | [Nick Automates — Físeáin Ghearra YouTube](https://www.youtube.com/shorts/fZIBK_4fKq8) — **218,174** | [theroshankrishna — Instagram](https://www.instagram.com/reel/Dapjs58z0P0/) — **186,786** | [midudev — TikTok](https://www.tiktok.com/@midudev/video/7664636453544152342) — **177,800** | Méadrachtaí canónacha ar 2026-08-24: **1.029 físeán uathúil** · **11.132.922 amharc aitheanta** (`v > 0`) · **639 cainéal/próifíl de réir líonra**. Tá 1.070 ró sa deais amh; normalaíodh 41 dúblach Instagram de réir an URL chanónaigh, agus coinníodh an líon is airde do gach 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 anseo é.

# 📧 Pobal & Cabhair > Gach rud in aon áit amháin — lean an cothaitheoir, comhráigh 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í & leideanna | [@diegosouzapw](https://github.com/diegosouzapw) | | 💬 **Discord** | [discord.gg/U47eFqAXCn](https://discord.gg/U47eFqAXCn) | | ✈️ **Telegram** | [t.me/omnirouteOficial](https://t.me/omnirouteOficial) | | 🟢 **WhatsApp — 🌍 Domhanda** | [gabh isteach sa ghrúpa](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) | | 🟢 **WhatsApp — 🇧🇷 An Bhrasaíl** | [gabh isteach 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` | | 🤝 **Rannchuidigh** | [CONTRIBUTING.md](CONTRIBUTING.md) · [Samhail Brainseála & Eisiúna](docs/ops/BRANCHING_MODEL.md) · roghnaigh `good first issue` | | 💚 **Tacaigh leis an tionscadal** | [Bealaí le tacaíocht a thabhairt ↑](#-support-omniroute) · [Urraitheoirí GitHub](https://github.com/sponsors/diegosouzapw) |

---

## 🛠️ Cruach Teicneolaíochta

Sraith	Teicneolaíocht
Timpeallacht rite	Node.js 22.x / 24.x LTS — `>=22.22.2 <23 \|\| >=24.0.0 <27`
Teanga	TypeScript 6.0 — 100% TypeScript ar fud `src/` agus `open-sse/` (gan aon `any` sa chroílár ó v2.0)
Creat	Next.js 16 + React 19 + Tailwind CSS 4
Bunachar sonraí	better-sqlite3 (SQLite, iriseoireacht WAL) + LowDB (oidhreacht JSON) — 137 modúl fearainn, 202 aistriú
Cuimhne	Cuardach lántéacs SQLite FTS5 + leabuithe veicteora cainníochtaithe go int8, meath clóscríofa
Scéimeanna	Zod 4 — bailíochtú ionchuir/aschuir uirlisí MCP + conarthaí API
Prótacail	MCP (stdio / HTTP / SSE) + A2A v0.3 (JSON-RPC 2.0 + SSE)
Sruthú	Server-Sent Events (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ú scóipthe MCP · AES-256-GCM nuair atá sonraí díomhaoin · DOMPurify
Folaíocht	wreq-js — pearsanú méarloirg TLS JA3 / JA4, seachfhreastalaí 3 leibhéal
Athléimneacht	Scoradán ciorcaid, cúlú easpónantúil, cosaint i gcoinne borrtha comhuaineach, féinleigheas uath-theaglama
Logáil	pino — logaí struchtúrtha JSON le comhthéacs iarratais
Tástáil	Reathaí tástála Node.js + Vitest — 39,000+ dearbhú tástála statach thar 5,100+ comhad tástála rianaithe (aonaid, comhtháthú, E2E, slándáil, éiceachóras)
Ardáin	Deasc (Electron) · Android (Termux) · PWA (aon bhrabhsálaí)
CI/CD	GitHub Actions — foilsiú uathoibríoch chuig npm + Docker Hub tráth eisiúna
Naisc	Suíomh gréasáin · npm · Docker Hub

## 📖 Doiciméadacht

### 📘 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	Rialaigh OmniRoute cianda (VPS) ó CLI do ríomhaire glúine trí chomharthaí rochtana le raon feidhme
Cumraíocht Claude Code	Dírigh Claude Code ar OmniRoute (áitiúil/cianda) le `launch` + próifílí de réir samhla
Tús Tapa	Suiteáil 3 chéim → ceangail → cumraigh

### 🔧 Oibríochtaí & 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	Imscar chuig Fly.io le stóráil mharthanach
Treoir Termux	Rith OmniRoute 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 & Ailtireacht

Doiciméad	Cur síos
Ailtireacht	Ailtireacht an chórais, sreabhadh sonraí, agus nithe inmheánacha
Treoir Chomhbhrúite	Píblíne 7 rogha: off / lite / standard / aggressive / ultra / RTK / stacked
Comhbhrú RTK	Comhbhrú aschur orduithe, scagairí, iontaoibh, fíorú, aisghabháil aschuir amh
Innill Chomhbhrúite	Caveman, RTK, píblínte cruachta, comhéadain deaise/API/MCP
Formáid Rialacha Comhbhrúite	Scéimrí pacáistí rialacha JSON le haghaidh scagairí Caveman agus RTK
Pacáistí Teanga Comhbhrúite	Brath teanga agus cumadh pacáistí rialacha Caveman
Treoir Athléimneachta	Scoradáin chiorcaid, tréimhsí maolaithe, scuaine, cosaint ar thréadphlódú, bréagaithris TLS
Inneall Auto-Combo	Scóráil 16 fhachtóir, pacáistí mód, féinleighis
Treoir Seachfhreastalaí	Córas seachfhreastalaí 3 leibhéal, margadh 1proxy, CRUD clárlainne
Sraitheanna Saor in Aisce	Eolaire comhdhlúite: 35 linn athfhillteacha dhoiciméadaithe / 489 iontráil sraithe saor in aisce catalógaithe
Gailearaí Gnéithe	Turas amhairc ar an deais le seatanna scáileáin
Doiciméadúchán an Bhunachair Chóid	Siúlóid tríd an mbunachar cód atá oiriúnach do thosaitheoirí

### 🤖 Prótacail & APIanna

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

### 📋 Tionscadal & Cáilíocht

Doiciméad	Cur síos
Rannchuidiú	Socrú forbartha agus treoirlínte
Samhail Chraobhaithe & Eisiúna	An áit a ndírítear PRanna (`release/*`), agus brí `main` agus clibeanna
Loga Athruithe	Stair iomlán eisiúintí de réir leagain
Beartas Slándála	Tuairisciú leochaileachtaí agus cleachtais slándála
Treoir i18n	Tacaíocht do 42 teanga, sreabhadh oibre aistriúcháin, RTL
Seicliosta Eisiúna	Céimeanna bailíochtaithe réamheisiúna
Plean Cumhdaigh	Straitéis cumhdaigh tástála le haghaidh 39,000+ dearbhú tástála statach thar 5,100+ comhad tástála rianaithe

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

Rang	Ranníocóir	PRanna cumaiscthe	~Línte athraithe
1	backryun	190	227,977
2	oyi77	180	407,678
3	rdself	145	80,663
4	JxnLexn	128	387,049
5	KooshaPari	101	125,747
6	herjarsa	88	230,872
7	RaviTharuma	79	55,106
8	maxmad64bis	69	394,715
9	artickc	59	33,260
10	HouMinXi	51	47,334
10	chirag127	51	5,153
12	xz-dev	50	245,976
13	hartmark	47	52,185
14	rqzbeh	39	143,181
15	dhaern	34	19,559
16	Dingding-leo	33	1,986
17	NomenAK	32	13,854
18	MumuTW	30	16,953
19	benzntech	29	11,641
20	pacocartones	24	9,331
20	Prudhvivuda	24	6,312

_{Reoite ag barr beo release/v3.8.50 dafb4ae808, agus cumaisc suas go dtí 2026-08-24 05:26:03 UTC san áireamh. Tá 5,911 PR cumaiscthe i ndaonáireamh leathanachaithe GitHub GraphQL: 2,707 ó úinéir na stórtha, 179 ó Dependabot, agus 3,025 PR sheachtracha ó 535 ranníocóir ar leith. Is éard atá i gceist le “Línte athraithe” ná breiseanna + scriosanna GitHub agus áirítear leis comhaid ghinte, glaschomhaid, catalóga, aistriúcháin agus doiciméadacht; tomhas ar an méid athraithe atá ann, ní LOC a scríobhadh. Coinnítear comhscóir ag an tairseach.} ### Tiomantais atá luaite le GitHub

backryun _{🥇 220 gealltanas arna chur i leith GitHub}	Paijo _{🥈 219 gealltanas arna chur i leith GitHub}	Randi _{🥉 108 ngealltanas arna gcur i leith GitHub}	Ravi Tharuma _{🏅 81 gealltanas arna chur i leith GitHub}	Chris _{🏅 70 gealltanas arna chur i leith GitHub}	Markus Hartung _{🏅 69 gealltanas arna chur i leith GitHub · ar comhchéim ag #6}
Dizzle _{🏅 69 gealltanas arna chur i leith GitHub · ar comhchéim ag #6}	Jan Leon _{🏅 64 gealltanas arna chur i leith GitHub}	zenobit _{🏅 62 gealltanas arna chur i leith GitHub}	Bob.Hou _{🏅 51 gealltanas arna chur i leith GitHub · ar comhchéim ag #10}	Xiangzhe _{🏅 51 gealltanas arna chur i leith GitHub · ar comhchéim ag #10}

_{Athsheiceáilte ag 2026-08-24 06:14:31 UTC: gealltanais arna gcur i leith GitHub mar a thuairiscigh API Rannpháirtithe na stórtha don bhrainse réamhshocraithe release/v3.8.50. Chuir an API 525 aitheantas ar ais (415 úsáideoir, 2 róbat, 108 n-aitheantas anaithnid); fágtar an cothaitheoir, róbait agus aitheantais anaithnide as an tábla seo agus coinnítear comhchéimeanna sa chomórtas. Tá sé éagsúil ón rangú PRanna cumaiscthe thuas agus ón daonáireamh meiteashonraí Git ina bhfuil 639 duine thíos.} > 🙏 Is **croíchuid** iad gnéithe, ceartúcháin fabhtanna agus feabhsuithe bonneagair na rannpháirtithe seo den mhéid a fhágann OmniRoute iontaofa agus saibhir ó thaobh gnéithe de. Tá tábhacht le gach iarratas tarraingthe, gach cás tástála agus gach comhad aistriúcháin i18n. Is daoine cosúil leo a chuireann foinse oscailte le chéile.

---
## 💖 Urraitheoirí

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

Andrew
_{💛 Urraitheoir míosúil gníomhach}

Vlad I
_{💛 Urraitheoir míosúil gníomhach}

Paco Cartones
_{💛 Urraitheoir aonuaire gníomhach}

An tOll. Igor Morais
_{💛 Tacadóir aonuaire roimhe seo}

longtao
_{💛 Tacadóir aonuaire roimhe seo}

_{… agus daoine eile ar fearr leo fanacht príobháideach 💛} _{Athbhailíochtaíodh Urraitheoirí poiblí GitHub ar 2026-08-24. Cinneann stádas activeOnly GitHub na lipéid ghníomhacha thuas; leantar de bhuíochas a ghabháil le tacadóirí aonuaire poiblí a nochtadh roimhe seo, agus fanann urraitheoirí príobháideacha gan ainm.} 💖 Bí i d’urraitheoir → — coinníonn gach dollar OmniRoute saor agus neamhspleách.

## 👥 600+ Rannpháirtí

[![Rannpháirtithe](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=639&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors) _{Rinneadh iniúchadh ar 2026-08-24 ag an mbonn reoite ac02c5b42f agus athsheiceáil ag rinn bheo release/v3.8.50, dafb4ae808: 639 aitheantas daonna Git normalaithe — tá 407 acu le feiceáil mar údair tiomantais (an cothaitheoir san áireamh) agus níl 232 acu le feiceáil ach i leantóirí follasacha Co-authored-by. Normalaíonn an daonáireamh ainmneacha úsáideora noreply GitHub, fágtar 26 aitheantas bota/gníomhaire/seirbhíse/ionadchoinneála as an áireamh, agus ní chumascann sé gnáthsheoltaí ríomhphoist díreach toisc go bhfuil a n-ainmneacha taispeána mar an gcéanna.} ### Conas Rannchuidiú 1. Déan forc den stór 2. Cruthaigh brainse ó rinn **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. Tiomnaigh do chuid athruithe (`git commit -m 'feat: add amazing feature'`) 5. Brúigh chuig an mbrainse (`git push origin feat/amazing-feature`) 6. Oscail Iarraidh Tarraingthe agus **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

## 🙏 Buíochas

Seasann OmniRoute ar ghuaillí fathach. Thosaigh sé mar fhorc de **[9router](https://github.com/decolua/9router)** agus mar leagan TypeScript den tionscadal Go **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** — agus uaidh sin amach, fuair gach fochóras thíos inspioráid ó thionscadal foinse oscailte a rinne é ar dtús. 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í trí API REST GitHub an 24 Lúnasa 2026 — téigh agus tabhair réalta do na tionscadail seo. Is léargas cruinn dar dáta iad na figiúirí agus athróidh siad go nádúrtha. ### 🧬 Bunús & geata

Tionscadal	⭐	Conas a spreag sé OmniRoute
9router	26,161	An buntionscadal ar a bhfuil an forc seo bunaithe — leathnaíodh anseo é le APIanna ilmhódacha agus athscríobh iomlán in TypeScript.
CLIProxyAPI	48,497	An cur chun feidhme in Go a spreag an port seo go JavaScript / TypeScript.
LiteLLM	57,100	An geata AI a sholáthraíonn a thacar sonraí poiblí praghsála sonraí dár sioncronú rianaithe costas agus ar chuir a shamhail normalaithe soláthraithe bonn eolais faoinár ródú.
codex-chatgpt-web	1,410	Foinse MIT a cuireadh in oiriúint don droichead díoltóra ChatGPT Web → Codex Responses, lena n-áirítear cuibheoirí seisiúin brabhsálaí, frámaithe freagartha, úsáide agus cuardaigh gréasáin.
free-claude-code	48,112	Patrúin a portaíodh chuig athshlánú srutha, ailiasanna gan smaointeoireacht, cuardach gréasáin cúltaca, teorainneacha fuinneoige sleamhnáin, folú faisnéise i logaí agus sreafaí lainseála treisithe.
composer-api	322	Patrúin roghnaithe uirlisí, srianta aschuir agus deimhnithe uirlisí Cursor Composer a cuireadh in oiriúint don fheidhmitheoir dúchasach Cursor.
codex-multi-auth	457	Patrúin logála isteach úir agus rothlaithe comharthaí athnuachana a portaíodh chuig athfhíordheimhniú Codex OAuth.
opencode-anthropic-auth	510	Réamhshocruithe trasfhoirmithe agus iompar ceanntásca billeála atá comhoiriúnach le Claude Code, ar ginearáladh iad i ndroichead OmniRoute atá faoi thiomáint cumraíochta.
grok2api-merged	2	Cuireadh a mhapálacha samhlacha Grok, a ghineadóir Statsig le TypeError bréige, a réamhshocruithe iarratais agus gléis, agus a phróiseálaí freagartha NDJSON in oiriúint go substaintiúil d’fheidhmitheoir Grok Web OmniRoute.
TQZHR/grok2api	705	An phríomhfhoinse thrasdultach chóid taobh thiar de grok2api-merged; caomhnaítear a chur chun feidhme samhlacha, ceanntásca, pálódálacha, Statsig agus próiseálaithe i nginealach Grok Web.
chenyme/grok2api	7,520	An bhunfhoinse MIT le haghaidh réamhshocruithe pálódála agus gléis Grok, an ghineadóra Statsig, agus an phróiseálaí `result.response` a tugadh ar aghaidh trí TQZHR agus grok2api-merged.
grok2api-pro	27	Foinse thrasdultach a luaigh grok2api-merged dá shraith linn seachfhreastalaithe; caomhnaíonn OmniRoute an fógra ginealaigh sin ach ní mhaíonn sé gur portáladh linn seachfhreastalaithe ina fheidhmitheoir teoranta Grok Web.
GrokProxy	50	Chuir a sheachfhreastalaí Grok fíordheimhnithe le fianán agus a phatrún sruthaithe `result.response.token` bonn eolais faoi iompar Grok Web OmniRoute.
GrokBridge	5	Chuaigh bunchur chun feidhme Grok Web i gcomhairle lena dhearadh réamhtheachtach HTTP/brabhsálaí; díorthaítear a chonair dhíreach HTTP ó GrokProxy, mar sin ní mhaítear gur port neamhspleách cóid atá ann.
grok-web-api	14	Chuir a scéimeanna Rust `ChatOptions` agus imchlúdaigh freagartha bonn eolais faoi chineálacha iarratais Grok agus freagartha sruthaithe TypeScript OmniRoute.

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

Tionscadal	⭐	Conas a spreag sé OmniRoute
Caveman	100,538	An tionscadal víreasach “cén fáth a lán comharthaí a úsáid nuair a dhéanann cúpla comhartha an gnó” — is í a fhealsúnacht urlabhra uaimheora a chumhachtaíonn ár mód caighdeánach comhbhrúite agus breis agus 30 riail líontóra/comhdhlúthaithe.
RTK – Rust Token Killer	77,185	Comhbhrú ardfheidhmíochta ar aschur orduithe — spreag sé ár n-inneall RTK, DSL scagaire JSON, aisghabháil aschuir amh agus an phíblíne chruachta RTK → Caveman.
headroom	67,310	Comhbhrú inchúlaithe comhthéacs (SmartCrusher) — spreag sé ár n-inneall `headroom` agus patrún marcóra aisghabhála `ccr`.
LLMLingua	6,598	Taighde ar chomhbhrú leid (LLMLingua / LLMLingua-2) — spreag sé ár n-inneall neamhshioncronach `llmlingua`, atá sábháilte do chód agus oscailte i gcás teipe.
llmlingua-2-js	31	An leagan aistrithe go JS/ONNX (MobileBERT / XLM-RoBERTa) a úsáidtear mar inneall cúil snáithe oibrí dár n-inneall LLMLingua.
Troglodita	40	Comhbhrú comharthaí PT-BR — cumhachtaíonn sé ár bpacáiste teanga pt-BR: laghdú athráchais agus baint líontóra arna dtiúnadh do ghramadach Phortaingéilis na Brasaíle.
ponytail	108,957	An scil ríomhchláraitheora YAGNI “forbróir sinsearach leisciúil” a chuaigh go víreasach — spreag sí ár Stíl Aschuir less-code: treorú i dtreo an athraithe oibríoch is lú, rud a laghdaíonn cód _ginte_ (an comhghleacaí ar ais an aschuir do phrós gonta Caveman).
i-have-adhd	23,526	Cuireadh a stíl freagartha atá dírithe ar ghníomh ar dtús agus atá oiriúnach do dhaoine le ADHD in oiriúint do stíl aschuir ghonta OmniRoute i gcúig theanga.

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

Tionscadal	⭐	Conas a spreag sé OmniRoute
TOON	25,233	Nodaireacht Oibiachtaí atá Dírithe ar Chomharthaí — mhúnlaigh a shamhail cholúnach, ceanntásc-móide-sraitheanna, ár gcéim dhlúthaithe tháblach.
GCF – Graph Compact Format	41	Bhí tionchar ag a fhormáid dhlúth graif agus a dhearadh próifíle cineálaí ar dhlúthú táblach OmniRoute agus ar fhormáid codec Headroom.
gcf-typescript	4	An cur chun feidhme MIT TypeScript a cuireadh isteach go díreach sa tionscadal agus a leathnaíodh mar chodec próifíle cineálaí Headroom.
token-optimizer-mcp	494	Taisce Brotli/SQLite + deilt chomhthéacs in aghaidh an tseisiúin — spreag sé ár n-inneall `session-dedup`.
token-savior	1,122	Dlúthú aschuir Bash + próifílí MCP — spreag sé ár ndisciplín maidir le scor den chomhbhrú agus laghdú ar liosta uirlisí MCP.
token-saver	138	Comhbhrú aschuir atá feasach ar ábhar, de réir cineáil comhaid, agus scor atá feasach ar theip — dheimhnigh sé ár ródú de réir cineáil agus ár scipeáil nuair nach mbaintear gnóthachan íosta amach.
token-optimizer	1,951	“Aimsigh na comharthaí taibhsiúla” — bhí tionchar ag a phatrún seachluchtaithe + hanla inghnóthaithe ar ár smaointeoireacht maidir le seachluchtú CCR.
TokenMizer	28	Treoirphlean de ghraf seisiúin + dí-dhúbailt línte thar sealanna a raibh tionchar aige ar ár ndearadh session-dedup.
OmniCompress	3	JSON colúnach Rust + aisghabháil seolta de réir ábhair + dí-dhúbailt thar theachtaireachtaí — dheimhnigh sé dearadh ár n-inneall `headroom`/`ccr`/`session-dedup` agus an t-airí dosháraitheachta cobhsaí don taisce “tá an fhoirm chomhbhrúite neamhspleách ar shuíomh”.
mcp-compressor	113	Comhbhrú scéimeanna/tuairiscí uirlisí MCP — bhí tionchar aige ar ár laghdú ar líonmhaireacht liosta uirlisí MCP.
RepoMapper	197	Rangú léarscáile stóir ar nós Aider — bhí tionchar aige ar ár bhfiosrú ar léarscáileanna stóir / rangú aisghabhála.
quiet-shell-mcp	4	Laghdú dearbhaitheach ar aschur bhlaosc trí MCP — dheimhnigh sé ár ndlúthú dearbhaitheach ar aschur bash.
ts-morph	6,162	Foireann uirlisí TypeScript Compiler API — spreag sí ár mbaint nótaí tráchta bunaithe ar pharsálaí a chaomhnaíonn teaghráin, teimpléid agus teaghráin litriúla slonn rialta.

### 🧠 Cuimhne & RAG

Tionscadal	⭐	Conas a spreag sé OmniRoute
Mem0	63,902	Ciseal cuimhne uilíoch — mhúnlaigh a shamhail seachfhreastalaí-mar-theorainn-scríofa/léite ár n-ailtireacht chuimhne.
Letta (MemGPT)	24,382	Gníomhairí staideacha le cuimhne srathaithe — spreag sé ár samhail shrathaithe um Rialú & Aisghabháil Comhthéacs (CCR).
WFGY	1,781	Tacsanomaíocht ProblemMap de 16 mhodh teipe athfhillteacha RAG/LLM — an stór focal comhroinnte inár dtreoir fabhtcheartaithe.

### 🛰️ Cigireacht tráchta, MITM & seachfhreastalaí trédhearcach

Tionscadal	⭐	Conas a spreag sé OmniRoute
llm-interceptor	66	Chuir idircheapadh/anailís MITM ar thrácht idir cúntóir códaithe ↔ LLM bonn eolais faoi riachtanais luatha an Chigire Tráchta. Cuireadh feidhmiúcháin neamhspleácha seomra ghlain, bunaithe ar chaighdeáin phoiblí prótacail, in ionad ceithre mhodúl a díorthaíodh roimhe seo — cumasc SSE, normalú comhráite, folú rúin agus sláintiú ceanntásc. Is feidhmiúcháin inmheánacha de chuid OmniRoute fós iad an dá dhromchla seachchuir óstaigh (`passthrough.ts` agus `_internal/bypass.cjs`), arna n-aicmiú go neamhspleách; níor athscríobhadh iad mar chuid den athsholáthar sin.
ProxyBridge	5,995	Ródú trédhearcach seachfhreastalaí de réir próisis — spreag sé ár ndíchóimeáil MITM atá sábháilte i gcás tuairteála, teorainneacha ama díomhaoin soicéid, sannadh próisis `/proc` agus gabháil TPROXY.

### 📚 Sonraí samhlacha, inbhraiteacht & UI

Tionscadal	⭐	Conas a spreag sé OmniRoute
models.dev	6,555	Bunachar sonraí oscailte de shonraíochtaí, praghsáil agus cumais samhlacha AI — sioncronaítear go dúchasach é lenár gcatalóg samhlacha.
React Flow / xyflow	38,108	An leabharlann ghraif nód-bhunaithe a chumhachtaíonn ár Stiúideo Comhbhrúite agus ár Stiúideo Teaglama/Ródaithe fíor-ama.
LangGraph	40,314	Spreag léirshamhlú beo ghraif sreafa oibre LangGraph Studio amharc easghrádaithe fíor-ama ár Stiúideonna.
Langfuse	33,592	Mhúnlaigh a shamhail inbhraiteachta rian → réise → giniúint ár n-eas sa Stiúideo Comhbhrúite.
Kiali	3,631	Inbhraiteacht mogalra seirbhíse Istio — spreag sé ár suaitheantais scoradáin chiorcaid agus ár n-amharcanna d'imeall earráide sa Stiúideo Ródaithe/Teaglama.
lobe-icons	2,428	Lógónna branda AI/LLM a rindreálann deilbhíní na soláthraithe ar fud ár bpainéil.
flag-icons	12,354	Soláthraíonn sé na bratacha SVG faoi cheadúnas MIT a úsáideann roghnóir teanga README.

### 🛡️ Slándáil

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

### 🧭 Uirlisí comhlántacha

Tionscadal	⭐	Conas a spreag sé OmniRoute
ClawRouter	6,564	Spreag sé dí-dhúbláil iarratas, cúlrogha éigeandála gan chostas, straitéisí inphlugáilte Auto-Combo agus aicmiú ilteangach rúin.
Antigravity-Manager	30,652	Chuir a athmhapáil samhlacha atá feasach ar chuntais, a bhailíochtú conairí inrite agus a iompar lipéad pleananna bonn eolais faoi thimpeallacht rite Antigravity in OmniRoute.
vscode-antigravity-cockpit	4,817	Spreag a fhormáid dhlúth chomhairimh síos d’athshocrú cuóta an taispeáint chomhfhreagrach de theorainneacha soláthraithe in OmniRoute.
AionUi	32,230	Spreag a chomhtháthuithe ACP brath uathoibríoch OmniRoute ar ghníomhairí CLI suiteáilte.
CodexBar	20,507	Shainaithin sé dromchla cuóta Grok Build; ansin d'fhíoraigh agus cheartaigh OmniRoute an fhormáid sreinge bheo go neamhspleách.

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

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