## 💰 ~1.62B Tocán sa Mhí Thar Shraitheanna Saor in Aisce ó Thráchtairí Tríú Páirtí
> **Tabhair leat do chuntais sholáthraithe féin.** Is comhiomlán measta é seo thar shraitheanna saor in aisce tríú páirtí atá incháilithe ar leithligh, ní deontas tocán ó OmniRoute. Cláraigh, faigh dintiúir nuair is gá, agus ceangail na soláthraithe is féidir leat a úsáid; bíonn a theorainneacha, a infhaighteacht agus a théarmaí féin faoi smacht ag gach soláthraí.
>
> Is pian é sraitheanna saor in aisce a chruachadh de láimh — na dosan SDK, na dosan teorainneacha ráta, agus gan a fhios agat cé mhéad atá agat i ndáiríre. Déanann OmniRoute catalógú ar **467 iontráil sraithe saor in aisce thar 34 eochair linne snámha athfhillteach** agus ríomhann sé an cheannlíne tocán ó na **17 linn snámha le buiséad míosúil dearfach foilsithe móide cúig theorainn Groq in aghaidh an mhúnla**, dídúbailte de réir linne chomhroinnte. Taispeántar ar leithligh cuótaí nach n-osclaíonn ach tar éis seiceáil aitheantais réigiúnaigh (inniu: ModelScope), +~6M taobh thiar d'fhíorú aitheantais réigiúnaigh, agus ní shuimítear sa cheannlíne riamh iad. Fanann an toradh le feiceáil ar an deais (`/dashboard/free-tiers`).
> Achoimre bheoite ar an leathanach beo `/dashboard/free-tiers`. Modheolaíocht iomlán (dídúbailt linne, sraitheanna creidmheasa, téarmaí soláthraithe): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**.
>
> Ath-iniúchtar na figiúirí seo gach coicís i gcomparáid leis an gcatalóg beo agus **bogann siad an dá bhealach** — cuireann soláthraí deireadh le sraith saor in aisce agus titeann an uimhir; tagann ceann nua agus dreapann sí. Foilisímid an méid a ríomhann an catalóg i ndáiríre, ní cás is fearr slánaithe in airde riamh.
⭐ Cuir réalta leis an repo má chuidigh OMNIROUTE leat airgead a shábháil agus d'obair a dhéanamh níos éasca.
[](https://github.com/diegosouzapw/OmniRoute)
[](https://www.star-history.com/diegosouzapw/omniroute)
[](https://olud.ai/project/diegosouzapw-omniroute.html)
### 💬 Bí páirteach sa phobal
**👋 Lean an cothaitheoir — bí ar na chéad daoine a fhaigheann soláthraithe nua, eisiúintí agus leideanna:**
[](https://www.linkedin.com/in/diegosouzapw/)
[](https://github.com/diegosouzapw)
[](https://discord.gg/U47eFqAXCn)
[](https://t.me/omnirouteOficial)
[](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4)
[](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4)
[](https://omniroute.online)
**Ceisteanna, leideanna solá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)**
## 📈 Leanann an Geata ag Fás
## 🆓 Suiteáil, ceangail soláthraí, agus ansin rutáil trí aon chríochphointe amháin
```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 nach mbeadh aon spriocanna incháilithe gan eochair i suiteáil nua, agus d'fhéadfadh soláthraí gan eochair diúltú do chliaint tríú páirtí. Fágtar soláthraithe atá marcáilte `tos: avoid`, Kiro ina measc, as an rutáil uathoibríoch de réir réamhshocraithe; ní sháraíonn ceangal cuntais an socrú sin. Féach an [Treoir um Sraitheanna Saor in Aisce](docs/getting-started/FREE-TIERS-GUIDE.md) sula roghnaíonn tú soláthraí.📦 Scripteanna tosaithe tapa le cóipeáil is greamú do **Python, Node.js, PHP, agus cURL** → [`examples/quickstart/`](examples/quickstart/)
# 💥 An Gealltanas
# 🤔 Cén fáth OmniRoute?
## 🤝 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é
> 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)
📖 [Inneall Auto-Combo](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 & mionsonraí 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
**🇧🇷 PIX** — láithreach, gan táillí (an Bhrasaíl)
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)**.
## ✨ Céard atá Nua
> Buaicphointí le déanaí ó **v3.8.20 → v3.8.53**. Stair iomlán in [`CHANGELOG.md`](CHANGELOG.md).
- **⚖️ Ródú `quota-weighted`** — déanann an 20ú straitéis teaglama neamhaird de chuntais ídithe, ansin roghnaíonn sí as an gcuid eile i gcomhréir leis an gcuóta atá fágtha ÷ an t-ualach atá ar siúl, agus coinníonn sí comhráite atá ann cheana greamaithe. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🧰 Mód headless** — ní ritheann `omniroute serve --headless` (nó `OMNIROUTE_HEADLESS=1`) ach inneall seachfhreastalaí `/v1/*`, agus an deais agus na fo-chórais a bhaineann leis an deais amháin múchta. → [Mód Headless](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 cinnteach 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** — greamaigh eochair API le samhail nó teaglam amháin le `forcedModel`, agus cuir samhlacha agus teaglaim eochrach leis nó bain iad go hidimhiúil (`/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 maiscithe saincheaptha bailíochtaithe agus cuntairí braite in aghaidh an chineáil; fanann an maisciú féin roghnach. → [Cosaintí](docs/security/GUARDRAILS.md)
- **🌍 67 teanga** — deais, scátháin doiciméad agus CLI, agus cuireann `npm run i18n:add-locale` teanga leis i ngach áit in aon ordú amháin. → [Treoir i18n](docs/guides/I18N.md)
- **🎛️ OmniConductor** — toscaireacht A2A isteach chuig do chabhlach gníomhairí, scileanna Conductor ar an gCárta Gníomhaire, agus painéal deais le comhrá gutha push-to-talk Faro. → [Freastalaí A2A](docs/frameworks/A2A-SERVER.md)
- **🛂 Iontráil oiriúnaitheach & cosaint róualaithe** — téann iarratais chomhrá throma ar scuaine in áit freagra 503 a thabhairt, le léasanna rollta adamhacha RPM in aghaidh an nasctha. → [Treoir Athléimneachta](docs/architecture/RESILIENCE_GUIDE.md)
- **🗂️ Ordú canónta `/v1/models`** — bloc leanúnach amháin grúpáilte de réir soláthraí in aghaidh an tsoláthraí (teaglaim greamaithe ar dtús), seasmhach thar gach foinse catalaíochta. → [Tagairt API](docs/reference/API_REFERENCE.md)
- **🗜️ Neartú comhbhrúite** — garda boliscithe ar siúl de réir réamhshocraithe, pacáistí Caveman do DE / FR / JA + an tSínis (wényán), scagairí RTK do Gradle & .NET. → [Comhbhrú](docs/compression/COMPRESSION_ENGINES.md)
- **💸 Costas macánta ar rátas cothrom** — taispeántar **$0** do sholáthraithe síntiúis / phleananna códaithe in anailísíocht chostais; leanann buiséad, cuóta & ródú de mheastachán a dhéanamh. → [Tagairt API](docs/reference/API_REFERENCE.md)
- **⚖️ Ródú Quota-Share** — roinn cuóta cuntais roinnte go cothrom thar eochracha comhthiomsaithe, le caomhnú oibre ionas go dtabharfar slisní díomhaoin ar iasacht. → [Treoir Athléimneachta](docs/architecture/RESILIENCE_GUIDE.md)
- **🤖 Socrú CLI/gníomhairí in aon ordú amháin** — 15 orduithe cláraithe `setup-*`; 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í+samhla agus ceannáin in aghaidh an chomhthéacs. → [Comhtháthuithe CLI](docs/guides/CLI-INTEGRATIONS.md)
- **🛰️ Mód cianda** — stiúir OmniRoute cianda le comharthaí scóipichte (`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** — teaglaim `auto/:`, **Fusion** (painéal samhlacha + breitheamh), ródú atá feasach ar an tasc, sárúcháin samhla / mód / bhuiséid USD in aghaidh an iarratais. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🗜️ Comhbhrú insheolaithe** — 12 inneall inchumasc + Compression Studios: LLMLingua-2, Ultra déshraithe, omniglyph, geata dílseachta in aghaidh an chéime, GCF v3.2, eagarthóir athordaithe tarraingthe. → [Comhbhrú](docs/compression/COMPRESSION_ENGINES.md)
- **🕵️ Díchriptiú MITM trédhearcach (TPROXY)** — gabhann sé CLIanna a dhéanann neamhaird d'athróga timpeallachta an tseachfhreastalaí, le CA in aghaidh SNI + suiteálaí stórais iontais. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md)
- **💸 Teilemé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 faoi do rialú** — múchta de réir réamhshocraithe, chainníochtú roghnach veicteora int8 + meath cineáilte, `x-omniroute-no-memory` in aghaidh an iarratais. → [Cuimhne](docs/frameworks/MEMORY.md)
- **🛡️ Slándáil** — garda insteallta leideanna ar gach bealach LLM (sraith red-team), cosaint roghnach maiscithe dintiúr (cheilt sí eochracha/rúin API sceite sa dá threo), cuardach gréasáin DuckDuckGo saor in aisce mar rogha dheireanach, agus geata logála isteach OIDC roghnach don deais (fanann logáil isteach le pasfhocal ar fáil i gcónaí). → [Cosaintí](docs/security/GUARDRAILS.md)
- **🖼️ Críochphointí nua** — críochnaíonn `/v1/ocr` (Mistral OCR) agus `/v1/audio/translations` (ar nós Whisper) dromchla na meán. → [Tagairt API](docs/reference/API_REFERENCE.md)
- **🎨 Giniúint íomhá / físe / fuaime** — API amháin do na meáin: físeán 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` frithsheachfhreastalaí, uathbhraith theanga an bhrabhsálaí, rianú gléasanna in aghaidh na heochrach, iontaobhas MITM gan root, logánú zh-TW. → [Timpeallacht](docs/reference/ENVIRONMENT.md)
- **🤝 Tuilleadh soláthraithe & gníomhairí** — gníomhairí scamall (Codex Cloud, Cursor, Devin, Jules), Grok Build (xAI) le logáil isteach brabhsálaí + OAuth, cárta céad-aicme Ollama, Claude Opus 5 & Sonnet 5, comhpháirtíocht oifigiúil Kimi (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… agus **catalóg 375 sholáthraí** athnuachan. → [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í/latency a sheirbheáil é, ródaíonn straitéis teaglama nua `cache-optimized` mar aon le fachtóir Auto-Combo `cacheAffinity` iarratais arís ar ais chuig an nasc a choinníonn an réimír thaiscthe, agus nochtann críochphointe inléite amháin `/v1/auto-combo/{channel}/candidates` linn iarrthóirí bheo chainéil `auto/*`. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **⚡ Feidhmíocht áitiúil & infreastruchtúr** — Redis áitiúil le haon chliceáil amháin, imscairteoirí sealaíochta Cloudflare Workers / Deno Deploy, Bifrost & Mux mar sheirbhísí leabaithe faoi mhaoirseacht. → [Seirbhísí Leabaithe](docs/frameworks/EMBEDDED-SERVICES.md)
- **🧩 Sa bhosca freisin** — creatlach breiseán + margadh, creataí scileanna Omni/Agent/GitHub, comhtháthú vault Obsidian (22 uirlis MCP), APIanna Batch & Files comhoiriúnacha le OpenAI, taisce freagartha séimeantaí, cluichíocht le cláir cheannais, aimsiú gníomhairí ACP (15 gníomhaire ionsuite), onnmhairiú sceidealta logaí go BigQuery, fan-out ilmhúnla comhthreomhar `auto/chaos`, droichead bot Telegram, bainisteoir leagain laistigh den aip agus rangúcháin 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 IS ar shamhlacha saor in aisce agus ar chostas íseal.
＋ oibríonn sé freisin le · Agent Deck · Kiro · Command Code · Antigravity · Windsurf · AMP · aon uirlis atá comhoiriúnach le OpenAI
📖 Socrú de réir uirlise do na 37 uirlis ar fad (27 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 de réir próisis, agus faigheann Qwen/Gemini eolaire baile aonuaire 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 # freisin: claude opencode qwen aider goose gemini cline continue kilo 5dive
```
Urramaíonn gach ordú an comhthéacs cianda gníomhach (`omniroute connect `), tugann `--dry-run`
réamhamharc ar na hathróga timpeallachta/argóintí beachta gan iad a rith, agus coinníonn `--api-key-env NAME` rúin amach
as stair do bhlaoisce. → [Comhtháthuithe CLI](docs/guides/CLI-INTEGRATIONS.md)
## 🌐 375 Soláthraithe AI — 153 Marcáilte Saor in Aisce sa Chatalóg
> **375 soláthraithe cláraithe** ar fud na mbailiúchán canónta comhrá, meán, cuardaigh, áitiúil, gníomhaire néil agus córais, lena n-áirítear **153 a iompraíonn meiteashonraí aimsithe `hasFree: true`**. Clúdaíonn clár samhlacha an chomhrá **239 soláthraí / 3,059 péire ar leith soláthraí-samhail / 1,475 aitheantas samhail amh**; tá **467 ró in aghaidh na samhla**, **34 linn athfhillteach** agus **51 soláthraí saor in aisce go deo athfhillteach/gan eochair** sa chatalóg ar leith don bhuiséad saor in aisce. Is ainmnitheoirí difriúla iad seo d'aon ghnó; tá na sainmhínithe agus na ríomhanna dídhúbláilte linne sa [Tagairt Soláthraithe](docs/reference/PROVIDER_REFERENCE.md) agus sna [Sraitheanna Saor in Aisce](docs/reference/FREE_TIERS.md).
### 🏢 Gach saotharlann mhór — trí aon 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 350+ eile — réitíonn 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 uasteorainn token
Kilo Code Auto-router, 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í gá eochair
Cloudflare AI 50+ samhaileanna 10K néarón/lá
NVIDIA NIM GLM, MiniMax ~40 RPM saor in aisce
Cerebras GLM 4.7, GPT-OSS Creidmheas $5 uair amháin; cárta de dhíth
OpenRouter Samhaileanna :free +$10 → RPM níos airde
📖 Catalóg iomlán 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
### 🧩 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**.
Ó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 é.
> 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)
### 🤝 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
Ó 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% Token — Go huathoibríoch
### 📖 Conas a oibríonn sé — píblíne, ailtireacht & mata na coigiltis
Ritheann an teaglaim réamhshocraithe chruachta `RTK → Caveman`. Nuair a fheidhmíonn an dá cheann ar an phálasta céanna uirlise/comhthéacs, carnann na coigiltis:
```txt
combined = 1 − (1 − RTK) × (1 − Caveman_input)
average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range = 78.4 – 94.6%
```
Tá bloic chóid, URLanna, JSON agus sonraí struchtúrtha **cosanta i gcónaí** ag an inneall caomhnaithe.
> **Cén fáth go leor token a úsáid nuair a dhéanann cúpla ceann an gnó?** Téann gach iarratas trí phíblíne comhbhrú OmniRoute **go trédhearcach** — gan aon athruithe ar an chliaint. Tá sé anois ina **chrann de 12 inneall in-chomhdhéanta** a ritheann in ord agus a mheascann agus a mheaitseálann de réir teaglaim ródaithe — ag tógáil 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 crann 12-inneall
Ritheann na hinnill in ord na píblíne; tá gach ceann in-toggleáil agus in-chumrú go neamhspleách de réir teaglaim:
#
Inneall
Cad a dhéanann sé
1
Session-Dedup
Fágann sé amach ábhar a dhéantar arís thar sealanna (seoltaí ábhair, tras-sheal)
2
CCR
Cartlannaíonn sé bloic mhóra taobh thiar de mharcóirí aisghabhála, a fhaightear ar éileamh
Scagadh cliste ar thorthaí uirlise, dí-dúbláil & teaspeadh (ar an eolas faoi ordú)
5
Responses Tool Output
JSON gan chailliúint ar dtús + comhbhrú diagnóiseach teoranta le haghaidh aschuir bhlaosc/paiste/cuardaigh/tógála (Responses API)
6
Headroom
Dlúthú táblach gan chailliúint ar eagair JSON (~30%) trí chódec GCF díoltóra
7
Relevance
Scóráil abairtí eastósctha i gcoinne an cheist úsáideora dheireanaigh
8
Caveman
Comhbhrú prós bunaithe ar rialacha (~65–75% ar aschur)
9
Aggressive
Achoimriú + aosú forásach ar sheansealanna
10
LLMLingua-2
Bearradh séimeantach ML trí MobileBERT ONNX — sábháilte do chód, async
11
Ultra
Bearradh teanndáileog heorastúil le sraith roghnach samhla bhig (SLM)
12
OmniGlyph
Ionchódú comhthéacs-mar-íomhá turgnamhach do Claude Fable 5 tomhaiste ar an sreang dhíreach Anthropic; fanann claochladáin GPT 5.6 faoi dhúnadh teipe go dtí go bhfaightear admháil ón soláthraí. Ceithre phróifíl chomhbhrú (ionsáiteach réamhshocraithe, cothromaithe, sábháilte do chód, passthrough) (is ionsáithí; rogha isteach)
Caomhnaítear bloic chóid, URLanna agus sonraí struchtúrtha **i gcónaí** go beacht de réir na mbeart. Comhcheanglaíonn **réamhshocruithe aonchliceála** na hinnill:
Mód
Coigiltis
Is fearr le haghaidh
🪶 Lite
~15%
Réamhshocrú sábháilte i gcónaí ar siúl
🪨 Standard (Caveman)
~30%
Códú laethúil
⚡ Aggressive
~50%
Seisiúin fhada throma ar uirlisí
🔥 Ultra
~75%
Uaschoigiltis
🧰 RTK
60–90%
Aschur blaosc/tástála/tógála/git
🔗 Stacked (RTK → Caveman)
78–95%
Leideanna measctha + logaí uirlise
**Sampla fíor — Mód Caighdeánach:**
> **Roimh (69 token):** _"Is é an chúis atá le do chomhpháirt React a bheith ag ath-rindreáil ná go bhfuil tú ag cruthú tagartha nua oibiachta ar gach timthriall rindreála. Nuair a chuireann tú oibiacht inlíne mar prop, feiceann comparáid éadomhain React í mar oibiacht dhifriúil gach uair, rud a spreagann ath-rindreáil. Mholfainn useMemo a úsáid chun an oibiacht a mheabhrú."_
>
> **Tar éis (19 token):** _"Tagairt nua oibiachta gach rindreáil. Prop oibiachta inlíne = tagairt nua = ath-rindreáil. Fill le useMemo."_
>
> **Freagra céanna. 72% níos lú token. Nialas caillteanais chruinnis.** ✅
**Sampla PT-BR — mód [Troglodita](https://github.com/leninejunior/troglodita):**
> **Roimhe (42 token):** _"Is é an fhadhb ná go bhfuil an comhpháirt ag ath-rindreáil toisc go gcruthaítear tagairt oibiachta nua i ngach timthriall rindreála. Mholfainn useMemo a úsáid."_
>
> **Ina dhiaidh (12 token):** _"Ath-rindreáil: tagairt nua gach timthriall (oibiacht inlíne athchruthaithe). Úsáid `useMemo`."_
>
> **An freagra céanna. ~70% níos lú token. Cruinneas teicniúil slán.** ✅
### 🎚️ Níos faide ná na hinnill — stíleanna aschuir, an lasc oiriúnaitheach & smacht in aghaidh an iarratais
Laghdaíonn na 12 inneall thuas an méid a théann **isteach**. Cruthaíonn trí shraith eile **conas**, **cathain**, agus an méid a thagann **amach**:
- **🪄 Stíleanna Aschuir** _(stiúradh ais an aschuir)_ — insteall treoracha cinnteacha a mhúnlaíonn freagraí agus atá sábháilte don taisce; in-chomhcheangailte, gach ceann ag déine `lite` / `full` / `ultra`. Is iontráil chlárlainne aon líne í stíl a chur leis:
- **Prós gonta** — fág amach líonbhreiseanna / ailt / maolú chainte; coinnigh an tsusbaint theicniúil beacht.
- **Níos lú cód** — YAGNI «forbróir sinsearach leisciúil»: an t-athrú oibre is lú, gan scafall nár iarradh.
- **Ponytail (forbróir sinsearach leisciúil)** — dreap dréimire YAGNI, deisigh an bhunchúis, an diff oibre is lú.
- **Tá ADHD orm (gníomh ar dtús)** — an chéad ghníomh eile ar tosach, céimeanna uimhrithe, céim choincréiteach amháin ina dhiaidh, gan réamhrá.
- **CJK gonta (文言)** — stíl ultra-ghonta tSínis chlasaiceach (geata locale go `zh`).
- **🎯 Buiséad comhthéacs oiriúnaitheach** _(an lasc)_ — in ionad tairsí token amháin ar/as, géaraigh na hinnill is saoire agus is neamhchaillteachaí ach a mhéid is gá chun **oiriúnú d'fhuinneog chomhthéacs an mhaidil**. Beartas: `reserve-output` (réamhshocrú, eolach ar an múnla) · `percentage` · `absolute`. Mód: `floor` (ráthaigh an oiriúnú) · `replace-autotrigger` (buaileann do rogha shainráite) · `off` (tairseach oidhreachta).
- **🎛️ Cá gcinntear an comhbhrú** _(tosaíocht, ard → íseal)_ — ceanntásc `x-omniroute-compression` in aghaidh an iarratais › sárú teaglaim ródaithe › próifíl ainmnithe ghníomhach › oiriúnaitheach / uath-spreag › réamhshocrú an phainéil › múchta. Macallaítear an plean a cuireadh i bhfeidhm ar ais i gceanntásc an fhreagartha `X-OmniRoute-Compression: ; source=`.
Uath-spreag de réir tairsí token, cas air an lasc oiriúnaitheach, greamaigh próifíl ainmnithe, socraigh ceann uair amháin in aghaidh an iarratais, nó sann píblíne in aghaidh teaglaim ródaithe — cibé ceann a oireann don ualach oibre. Scorálaíonn **huirnis mheastóireachta** (`npm run eval:compression`) roghnach as líne dílseacht vs. coigiltis 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 Mear
**1) Suiteáil & rith**
```bash
npm install -g omniroute
omniroute
```
> 💡 An bhfaca tú `npm warn ERESOLVE` nó rabhaidh peer-dep? [Tá siad neamhdhíobhálach](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated).
> **An bhfuil npm 11 nó níos déanaí á úsáid agat?** D'fhéadfadh npm scrioptanna saolré pacáiste a bhlocáil mura gceadaítear iad. Tá `postinstall` OmniRoute (`node scripts/build/postinstall.mjs`) riachtanach chun a chomhaid dúchasacha am rith a ullmhú. Ceadaigh na pacáistí a ainmnítear i rabhadh npm agus iad á suiteáil go domhanda. Maidir leis an tacar pacáistí a thuairiscigh OmniRoute 3.8.53:
>
> ```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 é, 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 an liosta spleáchais athrú idir eisiúintí; má thuairiscíonn npm liosta difriúil, bain úsáid as ainmneacha na bpacáistí ón rabhadh sin. Nuair a cheadaítear pacáiste, ceadaítear dá scrioptanna suiteála rith.
> **An bhfuil Gemini Web nó soláthraí eile fianán gréasáin á úsáid agat?** Áiríonn an pacáiste npm Playwright ach níl dénártha Chromium ann. Féach an nóta faoi [shocrú Playwright Chromium](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium)
> sula ndéanfaidh tú an chéad iarratas ar sholá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áthraitheoirí** → roghnaigh soláthraí a bhfuil a théarmaí agus a chuóta reatha oiriúnach do do chás úsáide → cuir a eochair API leis nó críochnaigh a shreabhadh cuntais. Féadfaidh sraitheanna saor in aisce clárú, faomhadh, nó modh íocaíochta a éileamh. Athbhreithnigh an [Treoir um Shraitheanna Saor in Aisce](docs/getting-started/FREE-TIERS-GUIDE.md); níl infhaighteacht gan eochair ráthaithe, agus déantar soláthraithe marcáilte `tos: avoid` a eisiamh ó `auto` de réir réamhshocraithe.
**3) Dirigh d'uirlis chódaithe**
```txt
Base URL: http://localhost:20128/v1
API Key: [cóipeáil ó Phainéal → Críochphointí]
Model: 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í nasctha a fheiceáil liostaithe. 🎉 Sin é — tosaigh ag códú, agus déanfaidh OmniRoute uathródú agus cúlghabháil ar do shon.
Mura féidir le do chliant ceanntásca saincheaptha a sheoladh, nochtann OmniRoute freisin ailias chomhoiriúnachta tokenaithe:
```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
```
Bain úsáid astu seo ach amháin le haghaidh cliaint nach féidir leo `Authorization: Bearer ...` a cheangal. Is é fíordheimhniú trí cheanntásc an modh is rogha 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.
Straitéis chlúdaigh tástála do 56,000+ dearbhú tástála statach thar 7,800+ comhad tástála rianaithe
# ⭐ Príomh-Rannpháirtithe
> Tá OmniRoute á mhúnlú ag pobal paiseanta foinse oscailte. Rinne na daoine seo rannchuidithe eisceachtúla a mbíonn tionchar díreach acu ar cháilíocht, chobhsaíocht agus scóip an tionscadail. **Go raibh maith agaibh.**
### Rannpháirtithe seachtracha de réir iarratas dtarraingthe cumaiscthe
Daonáireamh tógtha 2026-10-18 15:09:09 UTC le rinn bheo release/v3.8.52656f01cb43. Tá 9,191 PR cumaiscthe sa daonáireamh leathánaithe GitHub GraphQL: 3,834 ó úinéir an stórais, 229 ó Dependabot, 6 ó róbónna/aipeanna eile, agus 5,122 PR seachtrach ó 835 rannpháirtí uathúil. Is éard is “Línte athraithe” ann ná breiseanna + scriosanna GitHub agus áirítear ann comhaid ghinte, comhaid ghlasála, catalóga, aistriúcháin agus doiciméadú; is tomhas athraíochta é, ní LOC ón údar. Tuairiscíonn 49 PR dhifríochtaí GitHub de bhreis ar 500,000 líne (mar shampla, liostálann #13399, breis soláthraí aonair, 2,347 comhad athraithe), rud a ardaíonn roinnt de na hiomláin thuas. Rangaítear comhionannais le chéile.
### Tiomsuithe arna gcreidiúint ag GitHub
Athsheiceáilte ag 2026-10-18 14:44:45 UTC: commits creidiúnaithe ag GitHub arna dtuairisciú ag API Contributors an stórais don bhrainse réamhshocraithe release/v3.8.52. Thug an API 849 aitheantas ar ais (429 úsáideoir, 2 bot, 418 anaithnid); fágann an tábla seo an cothaitheoir, na botanna agus na haitheantais anaithnide as an áireamh, agus coinníonn sé na comhscóranna san iomaíocht. Tá sé ar leithligh ó rangú na bPR comhchumasctha thuas agus ó dhaonáireamh meiteashonraí Git thíos araon.
> 🙏 Is **cuid lárnach** de na rudaí a fhágann OmniRoute iontaofa agus saibhir ar ghnéithe iad gnéithe, ceartuithe fabhtanna agus feabhsúcháin bhonneagair na ranníocóirí seo. Tá tábhacht le gach iarratas tarraingthe, le gach cás tástála, agus le gach comhad aistriúcháin i18n. Is ag daoine cosúil leo siúd a thógtar an foinse oscailte.
---
## 💖 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.
… 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.
## 👥 900+ Rannpháirtí
[](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
Iniúchta ar 2026-10-18 ag barr beo release/v3.8.52, ad160ab2d1 (6,826 tiomantas): 993 aitheantas normalaithe daonna Git — tá 707 díobh le feiceáil mar údair tiomantais (an cothabhálaí san áireamh) agus níl 286 díobh le feiceáil ach i leantóirí sainráite Co-authored-by. Cuireann an daonáireamh .mailmap i bhfeidhm, déanann sé comparáid idir seoltaí ríomhphoist gan cás na litreacha a chur san áireamh, nascann sé seoltaí uimhriúla agus gnáthsheoltaí noreply GitHub ach amháin nuair a ionchódaíonn siad an hanla céanna, fágann sé 26 aitheantas róbait/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. Foilsíodh 639 san iniúchadh ar 2026-08-24; má ritear an modh seo arís ar bhonn an iniúchta sin, ac02c5b42f, faightear 619, mar sin is ó rannpháirtithe nua a thagann an méadú, seachas ó mhodh níos scaoilte.
### Conas Rannchuidiú
1. Déan forc den stór
2. Cruthaigh brainse ó bharr **gníomhach** `release/vX.Y.Z` (ní ó `main`) — féach [Samhail Bhrainseála & Eisiúna](docs/ops/BRANCHING_MODEL.md)
3. Cruthaigh do bhrainse gné (`git checkout -b feat/amazing-feature`)
4. Tiomnaigh d’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
## 🙏 Buíochas
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, spreag tionscadal foinse oscailte a bhain an sprioc amach roimhe 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í trí REST API GitHub an 18 Deireadh Fómhair 2026 — téigh agus tabhair réalta do na tionscadail seo. Is léargas cruinn dátaithe iad na figiúirí agus athróidh siad go nádúrtha.
### 🧬 Bunús & geata
An geata AI a sholáthraíonn a thacar sonraí praghsála poiblí sonraí dár sioncronú rianaithe costas, agus ar chuir a shamhail normalaithe soláthraithe bonn eolais faoinár ródú.
Foinse MIT a cuireadh in oiriúint don droichead cuachta ChatGPT Web → Codex Responses, lena n-áirítear cuibheoirí seisiúin brabhsálaí, frámaithe freagartha, úsáide agus cuardaigh gréasáin.
Patrúin a portaíodh isteach in athshlánú srutha, ailiasanna gan réasúnú, cuardach gréasáin cúltaca, teorainneacha fuinneoige sleamhnáin, ceilteoireacht logaí agus sreafaí tosaithe treisithe.
Réamhshocruithe claochlaithe atá comhoiriúnach le Claude Code agus iompar ceanntásca billeála a ginearálaíodh i ndroichead OmniRoute atá tiomáinte ag cumraíocht.
Cuireadh a mhapálacha samhlacha Grok, a ghineadóir bréige-TypeError Statsig, a réamhshocruithe iarratais agus gléis, agus a phróiseálaí freagartha NDJSON in oiriúint go substaintiúil do riteoir Grok Web OmniRoute.
An phríomhfhoinse indíreach cód taobh thiar de grok2api-merged; caomhnaítear a chur chun feidhme samhlacha, ceanntásca, pálasta, Statsig agus próiseálaí i mbunús Grok Web.
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.
Foinse indíreach a luaigh grok2api-merged dá shraith linn seachfhreastalaithe; caomhnaíonn OmniRoute an fógra bunúis sin ach ní mhaíonn sé gur portaíodh linn seachfhreastalaithe ina riteoir teoranta Grok Web.
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 portaíodh cód neamhspleách.
An tionscadal víreasach "cén fáth a n-úsáidfí mórán téadchomharthaí nuair a dhéanann cúpla téadchomhartha an gnó" — tá ár ngnáthmhód comhbhrúite agus breis agus 30 riail líontóra/comhdhlúthaithe bunaithe ar a fhealsúnacht uaimhfhir.
Comhbhrú ardfheidhmíochta ar aschur orduithe — spreag sé ár n-inneall RTK, DSL scagtha JSON, aisghabháil amh-aschuir agus an phíblíne chruachta RTK → Caveman.
Taighde ar chomhbhrú leideanna (LLMLingua / LLMLingua-2) — spreag sé ár n-inneall asincrónach llmlingua, atá sábháilte do chód agus a leanann ar aghaidh i gcás teipe.
Comhbhrú téadchomharthaí PT-BR — cumhachtaíonn sé ár bpacáiste teanga pt-BR: laghdú ar athrá iomarcach agus baint líontóra tiúnta do ghramadach Phortaingéilis na Brasaíle.
Scil víreasach códóra YAGNI an "fhorbróra shinsearaigh leisciúil" — spreag sí ár Stíl Aschuir níos lú cód: treorú i dtreo an athraithe oibríoch is lú, rud a laghdaíonn cód _ginithe_ (an comhghleacaí ar ais an aschuir de phrós gonta Caveman).
Comhbhrú aschuir atá feasach ar ábhar agus ar gach cineál comhaid, le héalú atá feasach ar theipeanna — dheimhnigh sé ár seoladh de réir cineáil agus scipeáil íosghnóthachain.
"Aimsigh na téadchomharthaí taibhsiúla" — chuaigh a phatrún seachlódála + hanla in-aisghabhála i bhfeidhm ar ár smaointeoireacht faoi sheachlódáil CCR.
JSON colúnach Rust + aisghabháil seolta de réir ábhair + dí-dhúbláil thar theachtaireachtaí — dheimhnigh sé dearadh ár n-inneall headroom/ccr/session-dedup agus an t-athróg dhobhogtha chobhsaí don taisce "tá an fhoirm chomhbhrúite neamhspleách ar shuíomh".
Chuir idircheapadh/anailís MITM ar thrácht cúntóir códúcháin ↔ 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á, ceilteoireacht rún agus sláintiú ceanntásc. Tá an dá dhromchla seach-churtha óstaigh (passthrough.ts agus _internal/bypass.cjs) fós ina bhfeidhmiúcháin inmheánacha de chuid OmniRoute a aicmítear go neamhspleách; níor athscríobhadh iad mar chuid den athsholáthar sin.
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íomhaointis soicéid, sannadh próisis /proc agus gabháil TPROXY.
Inbhraiteacht mogalra seirbhísí Istio — spreag sé ár suaitheantais scoradáin chiorcaid agus ár n-amharcléirithe imeall earráide sa Stiúideo Ródaithe/Teaglama.
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).
Chuir a athmhapáil samhlacha atá feasach ar chuntais, a bhailíochtú conairí inrite agus a iompar lipéad plean bonn eolais faoi am rite Antigravity OmniRoute.
D'aithin sé dromchla cuóta Grok Build; ansin dheimhnigh agus cheartaigh OmniRoute formáid bheo na sreinge go neamhspleách.
## 📄 Ceadúnas
Ceadúnas MIT - féach [LICENSE](LICENSE) le haghaidh sonraí.
---
**[⬆ Ar ais go barr](#-omniroute)** · Tógtha le ❤️ do phobal an AI foinse oscailte.
OmniRoute v3.8.53 · Node ≥22.22.2 · Ceadúnas MIT · omniroute.online
> Achoimre bheoite ar an leathanach beo `/dashboard/free-tiers`. Modheolaíocht iomlán (dídúbailt linne, sraitheanna creidmheasa, téarmaí soláthraithe): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**.
>
> Ath-iniúchtar na figiúirí seo gach coicís i gcomparáid leis an gcatalóg beo agus **bogann siad an dá bhealach** — cuireann soláthraí deireadh le sraith saor in aisce agus titeann an uimhir; tagann ceann nua agus dreapann sí. Foilisímid an méid a ríomhann an catalóg i ndáiríre, ní cás is fearr slánaithe in airde riamh.
```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 nach mbeadh aon spriocanna incháilithe gan eochair i suiteáil nua, agus d'fhéadfadh soláthraí gan eochair diúltú do chliaint tríú páirtí. Fágtar soláthraithe atá marcáilte `tos: avoid`, Kiro ina measc, as an rutáil uathoibríoch de réir réamhshocraithe; ní sháraíonn ceangal cuntais an socrú sin. Féach an [Treoir um Sraitheanna Saor in Aisce](docs/getting-started/FREE-TIERS-GUIDE.md) sula roghnaíonn tú soláthraí.
📦 Scripteanna tosaithe tapa le cóipeáil is greamú do **Python, Node.js, PHP, agus cURL** → [`examples/quickstart/`](examples/quickstart/)
> 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:
📖 [Inneall Auto-Combo](docs/routing/AUTO-COMBO.md) · [Treoir Athléimneachta](docs/architecture/RESILIENCE_GUIDE.md)
📊 An mhodheolaíocht iomlán & mionsonraí de réir gné i gcomparáid le 9router, OpenRouter, CLIProxyAPI & LiteLLM → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)
Eochair (randamach): `5d865059-bc44-483a-962d-43ceb80126eb`
PIX le cóipeáil agus greamú:
```
00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD
```
📖 [Údarú](docs/architecture/AUTHZ_GUIDE.md) · [Ráillí Cosanta](docs/security/GUARDRAILS.md) · [Comhlíonadh](docs/security/COMPLIANCE.md)
Ritheann an teaglaim réamhshocraithe chruachta `RTK → Caveman`. Nuair a fheidhmíonn an dá cheann ar an phálasta céanna uirlise/comhthéacs, carnann na coigiltis:
```txt
combined = 1 − (1 − RTK) × (1 − Caveman_input)
average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range = 78.4 – 94.6%
```
Tá bloic chóid, URLanna, JSON agus sonraí struchtúrtha **cosanta i gcónaí** ag an inneall caomhnaithe.
> **Cén fáth go leor token a úsáid nuair a dhéanann cúpla ceann an gnó?** Téann gach iarratas trí phíblíne comhbhrú OmniRoute **go trédhearcach** — gan aon athruithe ar an chliaint. Tá sé anois ina **chrann de 12 inneall in-chomhdhéanta** a ritheann in ord agus a mheascann agus a mheaitseálann de réir teaglaim ródaithe — ag tógáil 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 crann 12-inneall
Ritheann na hinnill in ord na píblíne; tá gach ceann in-toggleáil agus in-chumrú go neamhspleách de réir teaglaim:
