## 💰 ~1.62B Comhartha Saor in Aisce / Mí
> Is cráite é sraitheanna saor in aisce a chruachadh de láimh — na dosaenacha SDKanna, na dosaenacha teorainneacha ráta, agus gan aon 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 chomhthiomsaithe athfhillteacha** agus ríomhann sé líon ceannlíne na gcomharthaí ó na **17 gcomhthiomsú a bhfuil buiséad míosúil dearfach foilsithe acu, chomh maith le cúig uasteorainn Groq in aghaidh na samhla**, agus comhthiomsuithe comhroinnte á ndídhúbláil. Taispeántar ar leithligh cuótaí nach n-osclaítear ach tar éis seiceáil aitheantais réigiúnaigh (faoi láthair: ModelScope), +~6M taobh thiar de fhíorú aitheantais réigiúnaigh, agus ní chuirtear iad leis an gceannlíne riamh. 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ídhúbláil comhthiomsuithe, sraitheanna creidmheasa, téarmaí soláthraithe): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**.
>
> Déantar athiniúchadh ar na figiúirí seo gach coicís i gcomparáid leis an gcatalóg bheo agus **bogann siad sa dá threo** — má chuireann soláthraí deireadh le sraith saor in aisce, titeann an uimhir; má chuirtear ceann nua leis, ardaíonn sí. Foilsímid an méid a ríomhann an chatalóg i ndáiríre, agus ní foilsímid cás is fearr arna shlánú suas riamh.
⭐ Cuir réalta leis an stór má chuidigh OMNIROUTE leat airgead a shábháil agus do chuid oibre 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)
### 💬 Glac páirt sa phobal
**👋 Lean an cothabhálaí — faigh soláthraithe nua, eisiúintí agus leideanna ar dtús:**
[](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 faoi sholáthraithe, treochlár agus tacaíocht → [Discord](https://discord.gg/U47eFqAXCn) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 Domhanda](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) / [🇧🇷 An Bhrasaíl](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) / [Tairseach](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK)**
## 📈 Tá an Geata ag Fás i gCónaí
## 🆓 Oibríonn sé an soicind a shuiteálann tú é — gan eochracha, gan cumraíocht
```bash
# Suiteáil úr, gan dintiúir — oibríonn `auto` cheana féin:
curl http://localhost:20128/v1/chat/completions \
-H "Content-Type: application/json" \
-d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}'
```
An fearr leat cúlra saor in aisce ar leith? Glaoigh ar `oc/…` (OpenCode Free) go díreach. Ansin aistrigh go `auto` agus lig do OmniRoute roghnú.📦 Scripteanna mear-thosaithe le cóipeáil agus a ghreamú do **Python, Node.js, PHP, agus cURL** → [`examples/quickstart/`](examples/quickstart/)
# 💥 An Gealltanas
# 🤔 Cén Fáth OmniRoute?
## 🤝 Tacaíonn ár gCairde Foinse Oscailte linn
> **Ar mhaith leat a bheith páirteach mar Chara Foinse Oscailte?** Is iad seo na cuideachtaí a thacaíonn le foinse oscailte agus a chabhraíonn le OmniRoute a choinneáil ag gluaiseacht — agus deirimid go poiblí cá dtéann gach comhartha a thugann siad dúinn. Déan teagmháil: [diegosouza.pw@outlook.com](mailto:diegosouza.pw@outlook.com)
Kimi Moonshot AI
Buíochas le Kimi (Moonshot AI), ár gCara Bunaithe Foinse Oscailte, as tacú leis an tionscadal seo! Is é Kimi an tsaotharlann AI taobh thiar de theaghlaigh mhúnla K2 agus K3 le meáchan oscailte — seachadann Kimi K3 fuinneog comhthéacs 1M-comhartha, fís dhúchasach agus códú ar leibhéal teorann ar chodán de phraghsanna múnlaí dúnta, agus oibríonn sé as an mbosca le Claude Code, Codex agus gach uirlis códaithe a fhreastalaíonn OmniRoute.
Cad a chumhachtaíonn tacaíocht Kimi: Cumhachtaíonn creidmheasanna API Kimi píblíne scaoilte AI-bhailíochtaithe OmniRoute — an chéim bailíochtaithe cumaisc faoi thiomáint ag Kimi K3 a athbhreithníonn gach iarratas tarraingthe sula seoltar é — móide forbairt gnéithe laethúla. Seoltar tacaíocht Kimi den chéad scoth ar an dá iarnród: 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 API Kimi le 15% creidmheasanna breise →
Inneall Inneall Níos Saoire cheaperinference.com
Buíochas le Cheaper Inference, Cara Foinse Oscailte OmniRoute, as tacú leis an tionscadal seo! Is geata rangaithe ó thaobh costais é Cheaper Inference a athdhíolann 42 múnla teorann — Claude, GPT-5.x, Gemini, Kimi K3, GLM, DeepSeek, Grok agus MiniMax — taobh thiar de phointe deiridh amháin atá comhoiriúnach le OpenAI, ag ródú gach iarratais chuig an soláthraí incháilithe is saoire gan táille a ghearradh riamh os cionn praghas liosta an déantóra múnla.
Tacaíocht den chéad scoth in OmniRoute: Comhlánuithe Comhrá, an pointe deiridh dúchasach /v1/responses, fís, glaoch uirlisí agus 3 mhúnla íomhá (grok-imagine, nano-banana-pro, nano-banana-2, inrochtana mar cheaperinference/<model>). Faigh eochair API →
Is naisc chomhpháirtíochta iad naisc a bhfuil clib aff=omniroute orthu. Maoiníonn siad an tionscadal gan aon chostas breise ort. 🎟️ Cur Chun Cinn Cleamhnaithe — cúpóin clárúcháin saor in aisce ó sholáthraithe nach ndéanaimid urraíocht orthu (cliceáil chun leathnú)Tá an chuid seo le haghaidh cóid atreoraithe/cúpóin amháin. Tá comhpháirtíochtaí urraithe le fáil in 🤝 Tacaíonn ár gCairde Foinse Oscailte linn 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 creidmheasanna saor in aisce ar chlárú (freastalaí saor in aisce, bí ag súil le moill níos airde — is fearr le haghaidh tástála, ní le haghaidh táirgeachta). 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 cosán atá comhoiriúnach le OpenAI. I measc na múnlaí atá ar fáil tá claude-opus-4-8, claude-opus-5, gpt-5.6-sol agus níos mó. Faigh do $100 →
⚠️ Nasc cleamhnaithe — Níl aon urraíocht ná comhpháirtíocht ag OmniRoute leis an soláthraí seo.
An bhfuil aithne agat ar sholáthraí eile le cúpón clárúcháin saor in aisce flaithiúil a théann chun tairbhe d'úsáideoirí OmniRoute? Oscail saincheist agus cuirfimid leis anseo é.
## 🎯 Comboanna — An Príomhghné
> Is éard is **combo** ann ná slabhra samhlacha a ródaíonn OmniRoute **go huathoibríoch**. Má ritheann cuóta amach, má theipeann ar sholáthraí, nó má ardaíonn costais, is féidir leis an gcombo bogadh go dtí an chéad tsamhail shláintiúil incháilithe eile. 🛡️
### ⚡ Nialas-chumraíocht — bain úsáid as `auto` díreach
Níl aon chombo le cruthú. Socraigh do mhúnla go `auto` (nó leagan de) agus tógann OmniRoute combo fíorúil ó do sholáthraithe nasctha, scóráilte beo:
Aitheantas Samhla
Cad a uasmhéadaíonn sé
auto
🎯 Réamhshocrú cothromaithe (LKGP — cloíonn sé le do sholáthraí maith deireanach)
auto/coding
🧑💻 Meáchain cháilíocht-ar dtús do ghiniúint chóid
auto/fast
⚡ An fho-iarmhairt is ísle ar dtús
auto/cheap
💰 An ceann is saoire in aghaidh an token ar dtús
auto/offline
🔋 An ceann is mó cuóta / ceannas ráta-teorainn ar dtús
auto/smart
🔭 Cáilíocht-ar dtús + 10% taiscéalaíocht chun samhlacha níos fearr a fháil amach
📊 Modheolaíocht iomlán & sonraí in aghaidh 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á MIT-cheadúnas ag OmniRoute agus coinnítear é oscailte. Má shábhálann sé am nó airgead duit, seo conas é a choinneáil neamhspleách — roghnaigh a oireann duit. Ní dhéanann urraíocht tionchar ar tosaíocht ródháilta; ceannaíonn sé infheictheacht, ná rangú.
⭐ Realtaigh an tionscadal
Saor in aisce — cuireann sé i ndáiríre le infheictheacht
**🇧🇷 PIX** — tapa, gan táillí (An Bhrasaíl)
Eochair (randamach): `5d865059-bc44-483a-962d-43ceb80126eb`
Cóip-phrása PIX:
```
00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD
```
₿ Cripteacha — BTC · ETH · USDT-TRC20 · USDC-Solana (cliceáil le leathnú)
₿ BTC
Bitcoin (SegWit)
bc1qh00smz004sy85wyl28v77tenkt3ckl6eaep7fd
Ξ ETH
Ethereum (ERC20)
0x64Cf6B68A6Ff34288e89172950a2d00102337a84
₮ USDT
Tron (TRC20)
TKAF41JpuQrHbKTnsQa9svJE2T192Hvsc2
$ USDC
Solana
2emNNZzVVWQc3FQ2wk9M6qXUQmW8AKdjjL174fXR28Tu
⚠️ Seol gach bonn ar an ngréasán amháin a thaispeántar — féadann seoladh ar an ngréasán mícheart caillteanas airgid a bheith mar thoradh air.
🐛 Fuarthas fabht nó tá aiseolas agat? Oscail [Díospóireacht](https://github.com/diegosouzapw/OmniRoute/discussions).
Nótaí forbróra: D'fhéadfadh an tionscadal comhad .env áitiúil a ghiniúint le linn npm install/postinstall le haghaidh áisiúlacht forbróra. Déantar an comhad seo a sheachaint go Soiléir trí .gitignore (féach .gitignore) agus níor cheart é a thiomnú choíche — má thiontúear é go teagmhasach, cas aon rúin nochtaithe agus bain an comhad amach as 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 comhartha/mí** ón gcatalóg dhoiciméadaithe thuas, agus 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 ó sholáthraithe an chéad mhí a ardú go **~2.22B** ar leithligh. Is forleagan roghnach sínithe catalóige é Radar do dhaoine ar mian leo
infhaighteacht níos úire ar shamhlacha 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 ó sholáthraithe a fháil. Is é
**thart ar 3B comhartha/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ú
tráth ar bith.
Tá Radar roghnach agus is iarratais GET amháin a úsáideann 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 tuilleadh eolais faoin incháilitheacht agus
faoin gcatalóg reatha ag **[radar.omniroute.online/planos](https://radar.omniroute.online/planos)**.
## ✨ An nua is déanaí
> Príomhphointí le déanaí ó **v3.8.20 → v3.8.50**. Stair iomlán i [`CHANGELOG.md`](CHANGELOG.md).
- **🎛️ OmniConductor** — seilbh A2A isteach chuig d'fhoireann gníomhaire, scileanna Conductor ar an gCárta Gníomhaire, agus painéal stiúrtha le comhrá fuaime Faro push-to-talk. → [Freastalaí A2A](docs/frameworks/A2A-SERVER.md)
- **🛂 Ionbhá agus cosaint ualach uathoibríoch** — cuirtear iarratais comhrá trom-iomlán in ionad 503ing, le ceadanna RPM rollta adamhacha in aghaidh an naisc. → [Treoir Seasmhachta](docs/architecture/RESILIENCE_GUIDE.md)
- **🗂️ Ordú canónach `/v1/models`** — bhloc aonáin sholáthraithe in aghaidh an tsoláthraí (ag cuimsiú combothaiceanna go príomh), seasmhach idir gach foinse catalóg. → [Tagairt API](docs/reference/API_REFERENCE.md)
- **🗜️ Deisiú comhbhrú** — garda inflisiúin réamhshocraithe, pacáistí Cavaman le haghaidh DE / FR / JA + Síneach (wényán), scagairí RTK le haghaidh Gradle agus .NET. → [Comhbhrú](docs/compression/COMPRESSION_ENGINES.md)
- **💸 Praghsáil ionracais cothrom** — soláthraí síntiúis / pleananna ríomhchlárnóireachta léann **$0** i mbunaitheannas costais; coinníonn buiséad, cuóta agus ródú ag meastachán. → [Tagairt API](docs/reference/API_REFERENCE.md)
- **⚖️ Ródú Cuóta-Comhroinn** — roinn cuóta cuntas comhroinnte go cothrom thar eochracha líonra, oibriúcháin choimeádta ionas go ndéantar sliceanna díomhaoin iasacht. → [Treoir Seasmhachta](docs/architecture/RESILIENCE_GUIDE.md)
- **🤖 Socrú CLI/gníomhaire le hordú amháin** — 13 ordú `setup-*` cláraithe; seolann `omniroute run` 7 CLI (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); tacaíonn `omniroute configure` le 10 spriocanna le roghnóir idirghníomhach soláthraí+múnla agus roghanna is fearr in aghaidh an comhthéacs. → [Comhtháthuithe CLI](docs/guides/CLI-INTEGRATIONS.md)
- **🛰️ Mód cianda** — rith cianda OmniRoute le teochóidí scóipe (`connect` / `contexts` / `tokens`) + cúntóir `antigravity` OAuth le haghaidh suiteálacha VPS. → [Mód Cianda](docs/guides/REMOTE-MODE.md)
- **🧭 Ródú uathoibríoch níos cliste** — combothaiceanna `auto/:`, **Fusion** (painéal múnla + breitheamh), ródú ionduchtaithe ag tasc, tarraing-ansc-ansáil múnla / mód / buiséad USD in aghaidh an iarratais. → [Uath-Combo](docs/routing/AUTO-COMBO.md)
- **🗜️ Comhbhrú in-suiteáilte** — 12 innill chomhdhírithe + Stiúideanna Comhbhrú: LLMLingua-2, dá-chéim Ultra, omnightil, geata ionracais in aghaidh an chéime, GCF v3.2, eagarthóir tarraing-athordú. → [Comhbhrú](docs/compression/COMPRESSION_ENGINES.md)
- **🕵️ Cripthír MITM trédhearcach (TPROXY)** — tógann CLIs nach n-úsáideann athróga timpeallachta seachfhreastalaí, le CA in aghaidh an SNI + suiteálaí stór iontaoibh. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md)
- **💸 Teileamheadrach costais i ngach áit** — ceadanna costas/úsáide `X-OmniRoute-*` ar gach pointe deiridh, ceadanna sábháilteacht caidhm-HIT, cuótaí caiteachas USD in aghaidh an eochrach. → [Tagairt API](docs/reference/API_REFERENCE.md)
- **🧠 Cuimhne faoi do rialú** - as as beagnach de réir réamhshocraithe, ionchóiriú veicteach in8 roghnach + tréchú ríthábhachtach, `x-omniroute-no-memory` in aghaidh an iarratais. → [Cuimhne](docs/frameworks/MEMORY.md)
- **🛡️ Slándáil** - garda inste idirghníomhaíochta ar gach cosán LLM (sraith dearg-fhoirne), garda fíorthaifeadh ainmneacha úsáideora roghnach (marthanann clárlann pasfhocail i gcónaí), cuardach gréasáin chúltaca DuckDuckGo saor in aisce, agus geata logáilte OIDC roghnach le haghaidh an phainéil stiúrtha. → [Treoracha Slándála](docs/security/GUARDRAILS.md)
- **🖼️ Pointí deiridh nua** - cuireann `/v1/ocr` (Mistral OCR) agus `/v1/audio/translations` (cosúil le Whisper) críoch le dromchla meáin. → [Tagairt API](docs/reference/API_REFERENCE.md)
- **🎨 Giniúint íomhá / físe / fuaime** - API amháin le haghaidh meáin: xAI Grok Imagine & Novita AI físeán, ComfyUI, Magnific, Adobe Firefly, Segmind, agus soláthraithe cainte cosúil le ElevenLabs. → [Tagairt API](docs/reference/API_REFERENCE.md)
- **🌍 Imscaradh agus oibríochtaí** - basePath seachfhreastalaí droim ar ais, braith teanga bhrabhsálaí uathoibríoch, rianú gléasanna in aghaidh an eochrach, iontaobh MITM gan fréamh, logánú zh-TW. → [Timpeallacht](docs/reference/ENVIRONMENT.md)
- **🤝 Tuilleadh soláthraí agus gníomhairí** - gníomhairí scamall (Codex Cloud, Cursor, Devin, Jules), Grok Build (xAI) le brabhsálaí + logáil isteach OAuth, cárta príomhshraith Ollama, Claude Opus 5 & Sonnet 5, comhpháirtíocht oifigiúil Kimi (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… agus catalóg athnuaite **352 soláthraí**. → [Soláthraíteanna](docs/reference/PROVIDER_REFERENCE.md)
- **📡 Trédhearcacht ródú** - iompraíonn gach freagra ceannlitir `X-OmniRoute-Decision` a ainmníonn an straitéis/soláthraí/ama freagairtha a chónaigh air, combothaiceanna `cache-optimized` nua + `cacheAffinity` uath-comhoiriúnach a sheolann iarrataí atá ag aisghníomhú ar ais go dtí an nasc a sheilg an réamhchostas caidhm, agus pointe deiridh léite amháin `/v1/auto-combo/{channel}/candidates` nochtaíonn poll iarrthóirí beo an chainéil `auto/*`. → [Uath-Combo](docs/routing/AUTOCOMBO.md)
- **⚡ Feidhmíocht agus bonneagar áitiúil** - Redis áitiúil le clic amháin, reolaithe rith Cloudflare Workers / Deno Deploy, Bifrost agus Mux mar sheirbhísí tacaíochta leabaithe. → [Seirbhísí Leabaithe](docs/frameworks/EMBEDDED-SERVICES.md)
- **🧩 Sa bhosca freisin** - frámaíochta breiseán + margadh, frámaíochta scileanna Omni/Agent/GhostHub, comhtháthú seicléis Obsidian (22 uirlis MCP), APIanna Grúpa agus Comhaid comhoiriúnach le OpenAI, freagra semantach caidhm, gamification le ceannaireachtaí, aimsiú ACP gníomhaire (16 gníomhaire bunaithe), easpórtáil logáil sceidealaithe go BigQuery, tástáil lochtanna `auto/chaos`, droichead bot Telegram, bainisteoir leagan in-app agus ritháin saor-tairisceana LMArena-ELO. → [Doiciméadú](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 36 uirlis ar fad (26 CLI Code + 10 CLI Agents) → [`docs/reference/CLI-TOOLS.md`](docs/reference/CLI-TOOLS.md) · 🧩 Breiseán OpenCode → [`@omniroute/opencode-provider`](https://www.npmjs.com/package/@omniroute/opencode-provider)
**Seol aon CLI a dtacaítear leis trí OmniRoute le hordú amháin** — ní scríobhtar aon chomhad cumraíochta,
instealltar dintiúir de réir próisis, agus faigheann Qwen/Gemini eolaire baile scoite sealadach:
```bash
omniroute run claude --model openai/gpt-5.4 # Claude Code
omniroute run codex --model glm/glm-5.2 # OpenAI Codex CLI
omniroute run aider --model glm/glm-5.2 -- --message "reply OK"
omniroute run goose --model glm/glm-5.2
omniroute run opencode --model glm/glm-5.2 -- run "reply OK"
omniroute run qwen --model glm/glm-5.2 -- -p "reply OK"
omniroute run gemini --model glm/glm-5.2 -- --skip-trust -p "reply OK"
# Nó roghnaigh soláthraí+múnla go hidirghníomhach agus scríobh cumraíocht 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)
## 🌐 357 Soláthraí IS — 152 Marcáilte mar Shaor in Aisce sa Chatalóg
> **357 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 **152 a bhfuil meiteashonraí aimsithe `hasFree: true` acu**. Cuimsíonn clárlann na samhlacha comhrá **229 soláthraí / 2,554 péire ar leith soláthraí-samhla / 1,283 aitheantas samhla amh**; tá **491 ró in aghaidh na samhla**, **35 linn athfhillteacha** agus **54 soláthraí athfhillteacha/gan eochair atá saor in aisce go deo** sa chatalóg ar leith de bhuiséid in aisce. Is ainmneoirí éagsúla iad seo de réir dearaidh; tá na sainmhínithe agus na ríomhanna dí-dhúbláilte de réir linne 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 330+ eile — réitítear gach íocón beo ó chatalóg soláthraithe an deais. 📖 [Tagairt Soláthraithe](docs/reference/PROVIDER_REFERENCE.md)
### 🆓 Saor in Aisce go Deo — $0, gan chárta creidmheasa
OpenCode Zen DeepSeek V4, Nemotron 3 Gan teorainn chomharthaí
Kilo Code Uath-ró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 1M comhartha/lá
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 n- ritheann OmniRoute — I ngach áit
> An t-iarratas céanna, do mheaisín, do rialacha. Ó shuiteáil npm domhanda go dtí **do ghuthán** trí Termux.
Ardán
Suiteáil
Gnéithe
📦 npm (domhanda)
npm install -g omniroute
Ordú amháin, aon OS
🐳 Docker
docker run … diegosouzapw/omniroute
Il-ailt AMD64 + ARM64
🖥️ Deisce (Electron)
npm run electron:build
Fuinneog dhúchais + tráidire córais — Windows / macOS / Linux
💪 ARM
dúchasach arm64
Raspberry Pi, freastalaithe ARM, Apple Silicon
📱 Android (Termux)
pkg install nodejs && npx -y omniroute
Ritheann ar do ghuthán, 24/7, gan fréamh
📲 PWA
"Cuir le Baile Scáileáin"
Lánscáileán, as-líonra, suiteáilte ón mbrabhsálaí
🧩 Breiseán OpenCode
@omniroute/opencode-provider
Comhtháthú dúchasach OpenCode
🤖 VS Code Copilot Chat
suiteáil an síneadh OmniCopilot
Gan samhail OmniRoute sa roghnóir Copilot Chat dúchasach — cobhsaí & Insiders
### 🧩 Nua: OmniRoute taobh istigh de Copilot Chat dúchasach VS Code
> Gan barra taoibh nua, gan comhéadan comhrá nua — gach samhail a sheirbheálann OmniRoute
> le feiceáil i díreach an **roghnóir samhla Copilot Chat a úsáideann tú cheana féin**. Ó VS Code 1.122,
> oibríonn samhlacha soláthraí gan síniú isteach GitHub nó síntiús Copilot — modh gníomhaire,
> glao uirlise agus amharc, saor in aisce.
Suiteáil an síneadh **[OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)**, cuir é
ar do bhunachar OmniRoute (réamhshocrú go dtí `localhost:20128`), ansin oscail Copilot Chat → roghnóir samhail
→ **Bainistigh Samhlacha…** → **OmniRoute**.
Iontaru ón eagarthóir: oscail an radharc **Sínithe**, cuardaigh **"OmniRoute"**, cliceáil **Suiteáil**
— oibríonn an bealach céanna ar an dá stóras. Foinse, saincheisteanna agus an leabhar oibre foilseácháin ag
[diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot).
📖 [Treoir VS Code Copilot Chat](docs/guides/VSCODE-COPILOT.md) — socrú, a bhfuil á feiceáil sa roghnóir, painéal i gcluaisín, fabhtcheartú
> Thar an bhfreastalaí, tá **cockpit líne ordaithe iomlán** ag OmniRoute le **80+ ordú**, chomh maith le prótacail gníomhaí oscailte ionas gur féidir le gníomhaí AI é a thiomáint **leis féin**.
### ⌨️ CLI fíor (ní hamháin `start`)
```bash
omniroute # freastalaí geata + deais (port 20128)
omniroute chat # cliant TUI comhrá idirghníomhach (scléip: /model /combo /skill /memory)
omniroute setup # treoir chéad-rith treoraithe
omniroute doctor # diagnóis soláthraithe, poirt, spleácháin dhúchasacha
```
### 🛰️ Mód cianda — rith an CLI anseo, OmniRoute ar VPS
OmniRoute ar fhreastalaí? Tiomáine é as do ríomhaire glúine leis an **CLI céanna**. Logáil isteach uair amháin le comhartha rochtana scópáilte; gach ordú ansin mar sin díríonn ar an gcéanna cianda.
```bash
omniroute connect 192.168.0.15 # pasfhocal → comhartha scópáilte, saabh mar théacs comhthéacs
omniroute models list # ← rith i gcoinne an fhreastalaí CIANDA
omniroute configure codex # ← roghnaíonn múnla cianda, scríobh próifíl Codex áitiúil
omniroute tokens create --name ci -- scope read # cuir comharthaí níos cúinge ar fáil do mheaisíní eile
omniroute contexts use default # ← athraigh ar ais go dtí an freastalaí áitiúil
```
Tá comharthaí scópáilte `read` / `write` / `admin`; fanann bealaí athrú próiseála i lúb-eisiach.
📖 [Mód Cianda](docs/guides/REMOTE-MODE.md)
### 🤝 Ceangail gníomhaí — agus rialaí sé OmniRoute féin
Nocht OmniRoute thar **MCP**, **A2A**, **REST API**, **webhooks** nó **CLI cianda** — beirann aon ghníomhaí inniúil (nó do chuid féin cóid) na heochracha ar fad an gheata: ródú, soláthraithe, combos, taisce, comhbhrú, cuimhne — go hiomhánach. Seirbhísí HTTP thíos faoin teideal `http://localhost:20128`.
Comhéadan
Críochphointe / ordú
Úsáid é le haghaidh
🧰 MCP (stdio)
omniroute --mcp
plugáil isteach i Claude Desktop, Cursor, aon chliant MCP
gníomhaí go gníomhaí, JSON-RPC 2.0 + SSE, 6 scileanna
🌐 REST API
/v1/*
ag teacht le OpenAI — comhrá, leabú, íomhanna, fuaim, OCR
🔔 Webhooks
/api/webhooks
brúigh iarratais / imeachtaí quota chuig Slack, Discord, Telegram nó aon URL
🛰️ CLI Cianda
omniroute connect
tiomáin cóiméid cianda le comharthaí rochtana scópáilte
```bash
# Tabhair an tacar uirlisí iomlán 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íomhaí](docs/frameworks/AGENT_PROTOCOLS_GUIDE.md)
## 🗜️ Sábháil 15–95% Comharthaí — go huathoibríoch
### 📞 Conas a oibríonn sé — paslíne, ailtireacht & matamasaic sábhála
Seinneann an comhcheangal réamhshocraithe stacáilte `RTK → Caveman`. Nuair a dhéanann an dá cheann obair ar an ualach uirlis/comhthéacs céanna, méadaítear na sábhálacha:
```txt
combined = 1 − (1 − RTK) × (1 − Caveman_input)
average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range = 78.4 – 94.6%
```
Tá **cosaint i gcónaí** ag an inneall caomhnaithe ar bhloic chód, URLanna, JSON agus sonraí struchtúrtha.
> **Cén fáth an oiread sin comharthaí a úsáid nuair a dhéanann roinnt beag an cleas?** Téann gach iarratas tríd paslíne comhbhrú OmniRoute **go trasnáitheach** — aon athrú ag an gcliant. Is é atá ann anois **stac 12 innealra in-堆叠tha** a rithann in ord agus a mheascann agus a mheaitseálann de réir comhcheangail 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 stac 12-innealra
Ritheann innealra i ndáiligh an phaslíne; tá gach ceann inaistrithe agus cumraithe go neamhspleách de réir comhcheangail:
#
Innealra
Cad a dhéanann sé
1
Session-Dedup
Léimíonn ábhar athráite thar thrasnáitheanna (seoladh-ábhar, tras-trasnáithe)
2
CCR
Cartlannann blocanna móra taobh thiar de marcóirí aisghnóthaithe, a fhaightear ar éileamh
3
Lite
Baineann bánadh bána agus gearradh URL-íomhá (bonnlíne éadrom iad a-lag)
4
RTK
Scagadh cliste toradh-uirlise, dedup agus gearradh (a bhuann le haithne ordaithe)
5
Responses Tool Output
JSON gan chaillteanas ar dtús + comhbhrú diagnóstach teoranta le haghaidh aschurisse shell/patch/search/build (Freagairtí API)
6
Headroom
Comhshróid thábla gan chaillteanas d'airgarnaí JSON (~30%) trí Codec GCF fhmhúnaithe
7
Relevance
Scóráil inghnóthacha abhairsiúlach in aghaidh an ionchur is déanaí úsáideora
8
Caveman
Comhbhrú próis bhunaithe ar ríleanna (~65–75% ar aschur)
9
Aggressive
Achoimriú + aosú dul chun cinn de thrasnáitheanna sean
10
LLMLingua-2
Prúnadh seimantach ML trí ONNX MobileBERT — slán ón gcód, asionchorrach
11
Ultra
Prúnadh comhartha heuristiciúil le leibhéal samhail bheag roghnach (SLM)
12
OmniGlyph
Ionchódáil comhthéacs-mar-iomhá turgnamhach do Claude Fable 5 díreach ar an sreang Anthropic; Tá trasfhoirneach GPT 5.6 fós gan fheabhsúchán go dtí go bhfaighidh siad admháil ón soláthraí. Ceithre phróifíl chomhbhrú (réamhshocrú ionsaitheach, cothrom, sábháilte don ríomhchlárú, pas-tríd) (is ionsaitheach é; roghnach)
Tá blocanna cóid, URLanna agus sonraí struchtúrtha **cosanta i gcónaí** go beacht píosa. **Roghanna réamhshocraithe cliceáil amháin** a chomhcheanglaíonn na innealra:
Modh
Sábhálacha
Is fearr le haghaidh
🪶 Lite
~15%
Réamhshocrú sábháilte i gcónaí
🪨 Caighdeánach (Caveman)
~30%
Códáil laethúil
⚡ Ionsaitheach
~50%
Seisiúin fhada lán-uirlisí
🔥 Ultra
~75%
Uasmhéid sábhála
🧰 RTK
60–90%
Aschur shell/tástáil/build/git
🔗 Stacáilte (RTK → Caveman)
78–95%
Leideanna measctha + logaí uirlisí
**Sampla fíor — Modh Caighdeánach:**
> **Roimhe (69 comhartha):** _"Is é is dóichí go bhfuil do chomhpháirt React ag athshreanmhuirearú toisc go bhfuil tagairt réad nua á cruthú agat i ngach timthriall sreanmhuirearú. Nuair a sheolann tú réad inlíne mar phróp, feiceann comhghaol Sainmhínithe React é mar réad difriúil gach uair, a spreagann sreanmhuirearú. Mholfinn useMemo a úsáid chun an réad a mheabhrú."_
>
> **I ndiaidh (19 comhartha):** _"Tagairt réad nua gach sreanmhuirearú. Próp réad inlíne = tagairt nua = sreanmhuirearú. Fill isteach i useMemo."_
>
> **Freagra céanna. 72% níos lú comharthaí. Náid caillteanais cruinne.** ✅
**Sampla PT-BR — Modh [Troglodita](https://github.com/leninejunior/troglodita):**
> **Roimhe (42 comhartha):** _"Is é an fhadhb ná go bhfuil an chomhpháirt ag athshreanmhuirearú mar go bhfuil tagairt réad nua á cruthú i ngach timthriall sreanmhuirearú. Molfinn useMemo a úsáid."_
>
> **I ndiaidh (12 comhartha):** _"Ath-shreanmhuirearú: tagairt nua gach timthriall (réad inlíne athchruthaithe). Úsáid `useMemo`."_
>
> **Freagra céanna. ~70% níos lú comharthaí. Cruinne teicniúil slán.** ✅
### 🎚️ Thar na innealra — stíleanna aschur, an dial iomlánaithe & rialú in aghaidh an iarratais
Laghdaíonn na 12 innealra thuas dul **isteach**. Múnlaíonn trí shraith eile **conas**, **cathain**, agus cad a thagann **amach**:
- **🪄 Stíleanna Aschur** _(stiúradh ais aschur)_ — instealladh treoracha iomlánachta aschur deterministik, sábháilte ón taisce; in-comhcheangailte, gach ceann ag láidreacht `lite` / `full` / `ultra`. Is iontráil chlárlainne líne amháin a chur le stíl:
- **Prós géar** — scaoil líonadh / altanna / coinníollacht; coinnigh substaint theicniúil beacht.
- **Níos lú cóid** — "saoi eagallach" YAGNI: athrú oibre is lú, gan formhaisithe gan éileamh.
- **Ponytail (saoi eagallach)** — téigh an staighre YAGNI, deisigh an fhréamhfhadhb, diff oibre is lú.
- **Tá ADHD agam (gníomh-ar dtús)** — ceannaireacht gníomhaíochta eile, na céimeanna uimhrithe, céim chéanna amháin concreta, gan réamhchaint.
- **Terse CJK (文言)** — stíl ultra-ghearr Síneach Clasaiceach (teoranta don rogha teanga `zh`).
- **🎯 Bhuiséad comhthéacs iomlánaithe** _(an dial)_ — in ionad imlíne comhartha amháin ar/díochlasach, Ard-údarás na n-innealra is saoire, is gan chaillteanas ach an méid is gá chun **oiriúnú don fhuinneog comhthéacs an tsamhail**. Polasaí: `reserve-output` (réamhshocrú, samhail-eolasach) · `percentage` · `absolute`. Modh: `floor` (ráthaigh oiriúnú) · `replace-autotrigger` (buaigh do rogha sainráiteacha) · `off` (imlíne sean-aimseartha).
- **🎛️ Áit a gcinnfear comhbhrú** _(tosaíocht, ard → íseal)_ — ceanntásc `x-omniroute-compression` in aghaidh an iarratais › forshuíomh comhcheangail ródaithe › próifíl ainmnithe ghníomhach / uaththriogaireacht iomlánaithe › réamhshocrú painéil › díochlasach. Cuireann an plean i bhfeidhm an freagra ar ais i gceanntásc freagra `X-OmniRoute-Compression: ; foinse=`.
Uaththriogaireacht de réir imlíne comhartha, cas air an dial iomlánaithe, pierce próifíl ainmnithe, socrú am-aonair in aghaidh an iarratais, nó socraigh paslíne do gach comhcheangal ródaithe — cibé rud a oibríonn leis an ualach oibre. Tá córas luachála aslínne roghnach (`npm run eval:compression`) ar fáil a scóráil dílseacht vs. sábhálacha ar choirpíoll shocraithe sula gcuirfidh tú athrú ar aghaidh.
📖 [`COMPRESSION_GUIDE.md`](docs/compression/COMPRESSION_GUIDE.md) · [`RTK_COMPRESSION.md`](docs/compression/RTK_COMPRESSION.md) · [`COMPRESSION_ENGINES.md`](docs/compression/COMPRESSION_ENGINES.md)
# ⚡ Tosaigh Tapa
**1) Suiteáil & rith**
```bash
npm install -g omniroute
omniroute
```
> 💡 Feiceann tú `npm warn ERESOLVE` nó rabhaidh comhpháirtíochta? [Tá siad neamhdhíobhálach](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated).
Painéal ag `http://localhost:20128` · API ag `http://localhost:20128/v1`.
**2) Ceangail soláthraí SAOR in aisce (gan clárú)**
Painéal → **Soláthraithe** → ceangail **Kiro AI** (Claude saor in aisce, ~50 creidimh/an t-údarás in aghaidh an chuntais) nó **OpenCode Free** (gan fíordheimhniú) → déanta.
**3) Treoraigh d'fheiste códála**
```txt
Bun-URL: http://localhost:20128/v1
Eochair API: [cóip ó Painéal → Deireanna]
Samhail: auto (ródáil chliste gan chumrú — nó aon soláthraí/samhail eile)
```
**4) Deimhnigh go bhfuil sé ag obair**
```bash
curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY"
```
Ba cheart duit na samhlacha ceangailte liostaithe a fheiceáil. 🎉 Sin é — tosaigh ag códáil, agus cuireann OmniRoute ródáil & trasbhealach ar fáil duit go huathoibríoch.
Más féidir le do chliant ceanntásca saincheaptha a sheoladh, nochtann OmniReceiver freisin ailtreabhair comhoiriúnachta comharthaithe:
```txt
Catalóg OpenAI: http://localhost:20128/vscode/YOUR_KEY/
Samhlacha OpenAI: http://localhost:20128/vscode/YOUR_KEY/models
Comhrá OpenAI: http://localhost:20128/vscode/YOUR_KEY/chat/completions
Freagairtí OpenAI: http://localhost:20128/vscode/YOUR_KEY/responses
Comhrá Ollama: http://localhost:20128/vscode/YOUR_KEY/api/chat
Clibeanna Ollama: http://localhost:20128/vscode/YOUR_KEY/api/tags
```
Úsáid na cinn seo ach amháin le haghaidh cláir nach féidir leo `Authorization: Bearer ...` a cheangal. Tá fíordheimhniú ceanntásca fós an mód is fearr.
## 📦 Níos mó modhanna suiteála — Docker, foinse, pnpm, Arch
**🐳 Docker**
```bash
docker run -d --name omniroute --restart unless-stopped --stop-timeout 40 \
-p 127.0.0.1:20128:20128 -v omniroute-data:/app/data diegosouzapw/omniroute:latest
```
`:latest` leanann an leagan seasmhach **foilsithe** is airde SemVer. Ní leanann sé príomh-`main` git. Cuir `:X.Y.Z` le haghaidh GitOps. Féach [Cainéil Scaoileadh Docker](docs/guides/DOCKER_GUIDE.md#release-channels).Phinnann an íomhá **`OMNIROUTE_MEMORY_MB=1024`**. Tá sin leor don deais agus comhrá éadrom. Tá **gníomhairí ríomhchlárúcháin** (`POST /v1/responses` ó Claude Code, Codex, Grok, …) ag teastáil ó heap V8 i bhfad níos mó nó déanfaidh an phróiseas `FATAL ERROR` ag thart ar 12 GiB faoi dhá chomhthéacs fada ag teacht le chéile. Méadaigh an coimeádán os cionn an heap (sit buffreachtaí dúchasigh taobh amuigh de V8):
| Ualach | Heap (`-e OMNIROUTE_MEMORY_MB`) | Coimeádán (`--memory`) |
| ------------------------------------- | ------------------------------- | ---------------------- |
| Deais / comhrá éadrom | `1024` (ríomhshocrú íomhá) | ≥2 g |
| Aon ghníomhaire ríomhchlárúcháin | `8192` | ≥10 g |
| Dhá `/v1/responses` fada comhuaineach | `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
```
Tábla iomlán: [Treoir Docker — RAM am rite](docs/guides/DOCKER_GUIDE.md#runtime-ram-for-coding-agents).
> **Cainéal réamhshaoileadh Docker:** Leanann `diegosouzapw/omniroute:next` agus
> `diegosouzapw/omniroute:next-web` an brainse réamhshocraithe reatha `release/v*`.
> Tá na clibeanna inathraitheacha seo dírithe ach amháin le haghaidh tástála
> socrúcháin neamhshaoilithe agus **ní thacaítear leo le haghaidh táirgíochta**. Féach
> [Cainéil Scaoileadh 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 rithimh Bun:
- **`bun:sqlite` ionsuite**: Úsáideann OmniRoute tiománaí `bun:sqlite` ionsuite Bun agus é ag rith faoi Bun, ag filleadh ar `better-sqlite3` faoi Node.js nó `sql.js`.
- **Roghnú uathoibríoch Webpack bundler san fhorbairt**: Déanann forbairt (`bun run dev`) brath uathoibríoch ar Bun agus díchumasaíonn Turbopack ar son Webpack chun neamh-chomhoiriúnacht ceangail dúchasach V8 a chosc. Leanann tógálacha táirgíochta (`bun run build`) `OMNIROUTE_USE_TURBOPACK` go díreach mar ar Node: Turbopach de réir réamhshocraithe, `OMNIROUTE_USE_TURBOPACK=0` le tógáil le Webpack (`nochtann Dockerfile.bun é mar `--build-arg`).
- **Dockerfile Bun tiomnaithe**: `Dockerfile.bun` il-chéime le haghaidh rithimheanna táirgíochta dúchasacha Bun (`docker build -f Dockerfile.bun -t omniroute:bun .`).
```bash
# Suiteáil agus rith le Bun
bun install
bun run dev
```
**🛠️ Ón bhfoinse**
```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 Nix flakes
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, HTTPS Caddy, tolláin Cloudflare.
**🦭 Podman**
```bash
# 1. Réitigh an eolaire sonraí ceangailte-aithéil
mkdir -p data
# 2. Linux + Podman dúchasach neamhfréamhaithe amháin (riamh cliant Podman Machine cianda):
podman unshare chown 1000:1000 ./data
# 3. Socraigh an leid rithimha, tóg an íomhá Compose áitiúil, agus tosaigh
echo "CONTAINER_HOST=podman" >> .env
podman compose --profile base up -d --build
```
Ar macOS nó Windows, úsáideann Podman Podman Machine cianda: scipeáil `podman unshare` agus
lean an [treoir sonraí de réir topeolaíochta](contrib/podman/README.md#data-directory-permissions-by-topology).
📖 [Treoir Podman](contrib/podman/README.md) — Tógálacha Compose, Podman Machine, agus
socruithe Quadlet Linux/systemd.
**⚡ Suiteáil níos tapúla / éadrom (scipeáil an tógáil dhúchasach)**
Is spleáchanas **roghnach** é an t-inneall SQLite dúchasach (`better-sqlite3`), mar sin ní
bhlocálann suiteáil dhomhcheist riamh ar chompiláil ón bhfoinse: úsáideann sé déantán
réamhthógtha nuair a mheaitseann ceann do ardán/Node, agus mar sin de fillfeann sé go
trédhearcach ar inneall JS lom (`node:sqlite` ar Node 22+, nó an ceanglán `sql.js` WASM eile) —
níl aon uirlisí tógála ag teastáil.
Chun an téamh ina dhiaidh-suiteála a scipeáil go hiomlán (CI, gan ceapaire, nó meaisíní mall):
```bash
OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute # osclaíonn CI=1 é freisin
```
Le haghaidh na suiteálacha is tapúla roghnaigh **pnpm** (stóras seoladh-inniúil + naisc crua — féach thuas).
Le haghaidh rithimha gan deais, gan ceapaire úsáid próifíl `base` Docker (thuas) nó an
[treoir Termux](docs/guides/TERMUX_GUIDE.md). Seirbheálann an CLI agus an deais gréasáin an
phróiseas céanna ar aon amháin poirt, mar sin níl aon phacáiste CLI-amháin ann inniu.
Straitéis cumhdaigh tástálacha do 39,000+ dearbhú statach tástála thar 5,100+ comhad tástála rianaithe
# ⭐ Na Rannchuiditheoirí is Fearr
> Tá OmniRoute múnlaithe 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 fairsinge an tionscadail. **Go raibh maith agaibh.**
### Rannchuiditheoirí seachtracha de réir iarrataí tarraingthe cumaiscthe
Reoite ag barr beo release/v3.8.50dafb4ae808, le cumaisc go dtí 2026-08-24 05:26:03 UTC. Tá 5,911 PR cumaiscthe i ndaonáireamh leathanachaithe GitHub GraphQL: 2,707 ó úinéir na stórtha, 179 ó Dependabot, agus 3,025 PR seachtrach ó 535 rannchuiditheoir ar leith. Is ionann “Línte athraithe” agus suimiú + scriosadh GitHub agus áirítear ann comhaid ghinte, comhaid ghlais, catalóga, aistriúcháin agus doiciméadacht; is méid athraithe é, ní LOC a scríobhadh. Coinnítear comhscóir ag an tairseach.
### Tiomantais arna gcur i leith GitHub
Bob.Hou 🏅 51 tiomantas arna sannadh ag GitHub · cothrom sa 10ú háit
Xiangzhe 🏅 51 tiomantas arna sannadh ag GitHub · cothrom sa 10ú háit
Athsheiceáilte ag 2026-08-24 06:14:31 UTC: tiomantais arna sannadh ag GitHub a thuairiscigh API Rannpháirtithe na stórtha don bhrainse réamhshocraithe release/v3.8.50. D'fhill an API 525 aitheantas (415 úsáideoir, 2 róbat, 108 gan ainm); fágtar an cothaitheoir, na róbait agus na haitheantais gan ainm as an tábla seo agus coinnítear comhscóir an chomórtais ann. Tá sé éagsúil ón rangú PRanna cumaiscthe thuas agus ón daonáireamh meiteashonraí Git ina bhfuil 639 duine thíos.
> 🙏 Is **cuid lárnach** 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 iad daoine cosúil leo a thógann bogearraí foinse oscailte.
---
## 💖 Urraitheoirí
Buíochas ó chroí le daoine a mhaoiníonn OmniRoute as a bpóca féin — coinníonn gach síntiús an tionscadal saor, neamhspleách agus ag gluaiseacht.
… agus daoine eile ar fearr leo fanacht príobháideach 💛Urraitheoirí poiblí GitHub athdheimhnithe ar 2026-08-24. Cinnfidh stádas activeOnly GitHub na lipéid ghníomhacha thuas; fanann na tacadóirí poiblí aonuaire a nochtadh roimhe seo buíochas leo, agus fanann urraitheoirí príobháideacha gan ainm.💖 Bí i d'urraitheoir → — coinníonn gach dollar OmniRoute saor agus neamhspleách.
## 👥 600+ Rannpháirtithe
[](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
Iniúchadh ar 2026-08-24 ag bonn reoite ac02c5b42f agus athsheiceáil ag barr beo release/v3.8.50dafb4ae808: 639 aitheantais daonna Git normalaithe — feictear 407 mar údair tiomantais (lena n-áirítear an cothaitheoir) agus 232 ach amháin i línte Co-authored-by sainráite. Déanann an daonáireamh normalú ar láimhseálacha noreply GitHub, eisiann 26 aitheantas bot/gníomhaire/seirbhís/áitchoimeádta, agus ní chumascann sé seoltaí ríomhphoist gnáthacha toisc amháin go meaitseálann a n-ainmneacha taispeána.
### Conas Rannchuidiú
1. Déan fork ar an stór
2. Cruthaigh brainse ó bharr **gníomhach** `release/vX.Y.Z` (ní ó `main`) — féach [Samhail Brainse & Scaoilte](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 go dtí an brainse (`git push origin feat/amazing-feature`)
6. Oscail Iarratas Tarraingthe le **bonn = an brainse `release/vX.Y.Z` sin**
Féach [CONTRIBUTING.md](CONTRIBUTING.md) le haghaidh treoirlínte mionsonraithe.
### Scaoileadh Leagan Nua
```bash
# Cruthaigh scaoileadh — tarlaíonn foilsiú npm go huathoibríoch
VERSION=x.y.z
gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes
```
## 📊 Réaltaí
## 🌍 StarMapper
## 🙏 Buíochais
Seasann OmniRoute ar gualainn na ngianta. Thosaigh sé mar forghabháil ar **[9router](https://github.com/decolua/9router)** agus mar aschur TypeScript de thionscadal Go **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** — agus ó shin i leith, coimeádaigh gach fo-chóras thíos ag tionscadal foinse oscailte a shroich ann ar dtús. Gach ceann acu mhúin píosa concreach den OmniRoute. Seo é ár mbuíochas do gach aon acu. 🙏
> ⚍ cuntais réaltaí deimhnithe ó REST API GitHub ar 24 Lúnasa 2026 — téigh ag tabhairt réalta do na tionscadail seo. Tá na cuntais ina scáthshonraí beacht dáta agus athróidh siad go nádúrtha.
### 🧬 Líneáil agus geata
Foinse MIT comhoiriúnaithe isteach sa droichead ChatGPT Web → Codex Freagraí, lena n-áirítear seisiún brabhsála, frámáil freagra, úsáid agus coimeádaithe cuardaigh gréasáin.
Patrúin curtha ar a dtús isteach i ndéanamh srutha, ailtiúin gan smaointeoireacht, cuardach gréasáin ionadacha, teorainneacha fuinneoige sleamhain, scriosadh loga agus sreafaí seoladóra crua.
Réamhshocruithe claochlaithe comhoiriúnach le Claude Code agus iompar ceanntacs billeála ginearálaithe isteach sa droichead cumraíochta-rialaithe OmniRoute.
Dá dhéanamh Grok, gineadóir Statsig fake-TypeError, réamhshocruithe iarratais agus gléas, agus próiseálaí freagra NDJSON comhoiriúnaithe go mór isteach i rithóir Grok Web OmniRoute.
An príomhfhoinse idirthreorach cóid taobh thiar de grok2api-merged; cuirtear cur i bhfeidhm a shamhla, ceanntacs, íoslódáil, Statsig agus próiseálaí in iúl i líneáil Grok Web.
An bhunfhoinse MIT le haghaidh réamhshocruithe íoslódála agus gléas Grok, an gineadóir Statsig, agus an próiseálaí result.response a iompraítear trí TQZHR agus grok2api-merged.
Foinse idirthreorach a deirtear le grok2api-merged dá chiseal púla seachbhóthair; coimeádann OmniRoute an fhógra líneála sin ach ní éilíonn sé port púla seachbhóthair ina rithóir Grok Web teoranta.
Déanadh an tionscadal bunaidh Grok Web a chur i bhfeidhm a dhearadh HTTP/brabhsálaí uachtarach; díorthaíonn a shlí HTTP díreach ó GrokProxy, mar sin ní éilítear port cóid neamhspleách.
Dá chomhchruinniú ChatOptions Rust agus scéimeanna um chaibidil freagraí d'fhoghlaim cineálacha iarratais agus freagraí srutha TypeScript Grok OmniRoute.
### 🗜️ Comhthéacs agus comhbhrú comharthaí — inneall
An tionscadal víreasach "cén fáth a úsáid mórán comharthaí nuair a dhéanann beagán cleas" — a chuid fealsúnachta caveman-speak a chumhachtaíonn ár mód comhbhrú caighdeánach agus 30+ riail líonadh/dlúthú.
Comhbhrú comharthaí PT-BR — a chumhachtaíonn ár bpacáil teanga pt-BR: laghdú pleonásm agus bhaint líonadh athrige don ghramadach Phortaiginéise-Brazil.
Comhbhrú aschur eolasach in aghaidh an chineáil comhaid le teip eolasach — dheimhnigh ár ndáileadh in aghaidh an chineáil agus scipeadh ar mhíreachtainí ar a laghad.
Bailiúchán uirlisí API Compiler TypeScript — spreag ár mbaint tuairimíanna-bhunaithe pháirsóra a shábhálann teaghráin, samhlacha agus litreacha rialta.
Idirghabháil/anailís MITM ar thráchta cúntóra ionchlannáin ↔ LLM a d'fhoghlaim riachtanais luath-Thaiscéalaí Tráchta. Ceithre mhodúl a tháinig anuas roimhe seo — cumascú SSE, normalú comhrá, scríobadh rúnda agus sláintíú ceanntacs — tá siad curtha in ionad maidir le cur i bhfeidhm neamhspleách glan-bhunaíochta bunaithe ar shonraíochtaí prótacail phoiblí. Tá an dá dhromchla pas-through óstach (passthrough.ts agus _internal/bypass.cjs) fós ina ríochtaí inmheánacha OmniRoute a chatagóriú go neamhspleách; níor athscríobh iad mar chuid den athsholáthar sin.
Ródú seachbhóthair trédhearcach in aghaidh an phróisis — spreag ár ndímhúchadh MITM saor ó thuirlingt, amanna díomhaoin soicinn, ainmniúchán próiseis /proc agus gafa TPROXY.
### 📚 Sonraí samhla, infheictheacht agus comhéadan úsáideora
Liostáil choimeádta de leabharlanna sábháilte le réamhshocruithe a threoraíonn ár roghanna slándála (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).
> Achoimre bheoite ar an leathanach beo `/dashboard/free-tiers`. Modheolaíocht iomlán (dídhúbláil comhthiomsuithe, sraitheanna creidmheasa, téarmaí soláthraithe): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**.
>
> Déantar athiniúchadh ar na figiúirí seo gach coicís i gcomparáid leis an gcatalóg bheo agus **bogann siad sa dá threo** — má chuireann soláthraí deireadh le sraith saor in aisce, titeann an uimhir; má chuirtear ceann nua leis, ardaíonn sí. Foilsímid an méid a ríomhann an chatalóg i ndáiríre, agus ní foilsímid cás is fearr arna shlánú suas riamh.
```bash
# Suiteáil úr, gan dintiúir — oibríonn `auto` cheana féin:
curl http://localhost:20128/v1/chat/completions \
-H "Content-Type: application/json" \
-d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}'
```
An fearr leat cúlra saor in aisce ar leith? Glaoigh ar `oc/…` (OpenCode Free) go díreach. Ansin aistrigh go `auto` agus lig do OmniRoute roghnú.
📦 Scripteanna mear-thosaithe le cóipeáil agus a ghreamú do **Python, Node.js, PHP, agus cURL** → [`examples/quickstart/`](examples/quickstart/)
> Is éard is **combo** ann ná slabhra samhlacha a ródaíonn OmniRoute **go huathoibríoch**. Má ritheann cuóta amach, má theipeann ar sholáthraí, nó má ardaíonn costais, is féidir leis an gcombo bogadh go dtí an chéad tsamhail shláintiúil incháilithe eile. 🛡️
### ⚡ Nialas-chumraíocht — bain úsáid as `auto` díreach
Níl aon chombo le cruthú. Socraigh do mhúnla go `auto` (nó leagan de) agus tógann OmniRoute combo fíorúil ó do sholáthraithe nasctha, scóráilte beo:
📖 [Inneall Auto-Combo](docs/routing/AUTO-COMBO.md) · [Treoir Athléimneachta](docs/architecture/RESILIENCE_GUIDE.md)
📊 Modheolaíocht iomlán & sonraí in aghaidh 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`
Cóip-phrása PIX:
```
00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD
```
📖 [Údarú](docs/architecture/AUTHZ_GUIDE.md) · [Bainistíochta Sábháilteachta](docs/security/GUARDRAILS.md) · [Comhlíonadh](docs/security/COMPLIANCE.md)
Seinneann an comhcheangal réamhshocraithe stacáilte `RTK → Caveman`. Nuair a dhéanann an dá cheann obair ar an ualach uirlis/comhthéacs céanna, méadaítear na sábhálacha:
```txt
combined = 1 − (1 − RTK) × (1 − Caveman_input)
average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range = 78.4 – 94.6%
```
Tá **cosaint i gcónaí** ag an inneall caomhnaithe ar bhloic chód, URLanna, JSON agus sonraí struchtúrtha.
> **Cén fáth an oiread sin comharthaí a úsáid nuair a dhéanann roinnt beag an cleas?** Téann gach iarratas tríd paslíne comhbhrú OmniRoute **go trasnáitheach** — aon athrú ag an gcliant. Is é atá ann anois **stac 12 innealra in-堆叠tha** a rithann in ord agus a mheascann agus a mheaitseálann de réir comhcheangail 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 stac 12-innealra
Ritheann innealra i ndáiligh an phaslíne; tá gach ceann inaistrithe agus cumraithe go neamhspleách de réir comhcheangail:
