> Tá cruachadh na léibhéalacha saor in aisce de láimh pianmhár — oiread agus SDKanna, oiread agus teorainneacha rátaí, agus gan a fhios agat cé mhéid atá agat i ndáiríre. Míníonn OmniRoute **446 iontráil léibhéal saor in aisce thar 38 eochair linnte athfhillteach** agus ríomhann an teicneoir ceannlitreach ó na **20 linnte le buiséad míosúil dearfach foilsithe**, gan dul i bhfíorú agus gan dul i bhfíorú ag úsáid an linnte comhroinnte. Tá an toradh le feiceáil i gcónaí ar an bpainéal rialaithe (`/dashboard/free-tiers`).
> Achoimre bheo de leathanach beo `/dashboard/free-tiers`. Modheolaíocht iomlán (díolúine linnte, léibhéalacha creidmheachta, téarmaí soláthraí): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**.
>
> Athscrúdaítear na figiúirí seo gach dhá seachtain in aghaidh an chatalógh beo agus **bogann siad i ngach treo** — cuireann soláthraí deireadh le léibhéal saor in aisce agus laghdaíonn an uimhir; leagann sé nua síos agus sroicheann sé. Foilsímid an méid a ríomhann an catalóg i ndáiríre, riamh cás is fearr le huimhreacha méadaithe.
⭐ Stársáil an repo má chabhraigh OMNIROUTE leat airgead a shábháil agus do chuid oibre a éascú.
[](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 coimeádaí — faigh soláthraithe nua, scaoilteanna & 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 soláthraí, bótharraise & 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) / [Portal](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK)**
## 📈 An Geata ag Fás i gcónaí
## 🆓 Oibríonn sé an nóiméad a shuiteálann tú é — gan eochracha, gan chumraíocht
```bash
# Suiteáil úr, gan aon 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 backend saor in aisce ar leith? Glaoigh ar `oc/…` (OpenCode Free) go díreach. Ansin céim suas go `auto` agus lig do OmniRoute roghnú.📦 Scripteanna tapaidh cóipeáil-ghreamaithe do **Python, Node.js, PHP, agus cURL** → [`examples/quickstart/`](examples/quickstart/)
# 💥 An Gealltanas
# 🤔 Cén fáth OmniRoute?
## 🤝 Tacaíochtaí ó chairde an Fhoinse Oscailte
> **Ar mhaith leat bheith linn mar Charde an Fhoinse Oscailte?** Is iad na cuideachtaí seo a thacaíonn le foinse oscailte agus a chuidíonn le OmniRoute teacht ar aghaidh — agus deimhnímid go poibli cá dteastaíonn 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 Bunaitheach Foinse Oscailte, as an tionscadal seo a thacaíú! Is é Kimi an tsaotharlann intleachta artificial atá taobh thiar de na teaghlaigh samhlacha K2 agus K3 le meáchan oscailte — cuireann Kimi K3 ar fáil comhthéacs de 1M comhartha, radharc dúchasach agus códú ar an leibhéal teorann ar bhlas an tsraithphraghsanna de mhodhanna dúnta, agus oibríonn sé as an mbosca le Claude Code, Codex agus gach uirlis códaithe a sheirbheálann OmniRoute.
Ag cur cumhachta le tacaíochta Kimi: Cumhachtaíonn creidmheasanna API Kimi feadhphíobáin nuashonrú a fhíoraítear le AI de OmniRoute — an chéim Validation comhtháthaithe ag Kimi K3 a thaiscíonn gach iarratas tarraing roimh é a sheoladh — mar aon le forbairt gnéithe laethúil. Tacaíocht Kimi den chéad scoth seoltar ar an dá rille: an API Kimi díreach (kimi-k3) agus an plean códaithe Kimi Code (OAuth agus eochair API). Is é OmniRoute an chéad tionscadal foinse oscailte Brasaíle chomh maith i gclár tacaíochta Kimi. Faigh eochair API Kimi le 15% creidmheas breise →
Cheaper Inference cheaperinference.com
Buíochas le Cheaper Inference, Cara Foinse Oscailte de OmniRoute, as an tionscadal seo a thacaíú! Is geata ráitíoch é Cheaper Inference a dhíolaíonn 42 samhail teorann — Claude, GPT-5.x, Gemini, Kimi K3, GLM, DeepSeek, Grok agus MiniMax — taobh thiar de chríochphointe amháin atá comhoiriúnach le OpenAI, ag ródáil gach iarratais chuig an soláthraí inchuírite is saoire gan riamh a ghearradh os cionn an phraghs liosta Déantóra an tsamhail.
Tacaíocht den chéad scoth i OmniRoute: Comhlánaíochtaí Comhrá, an chríochphointe dúchasach /v1/responses, radharc, glao gairme agus 3 mhodh íomhá (grok-imagine, nano-banana-pro, nano-banana-2, inrochtana mar cheaperinference/<model>). Faigh eochair API →
Ceangailte le aff=omniroute iad na naisc. Maoiníonn siad an tionscadal gan aon chostas breise ort. 🎟️ Práchomhshóraigh Chairde — cóipeanna saor in aisce ó sholáthraithe nach dtacaímid leo (cliceáil le leathnú)Tá an rannán seo do chóipeanna tagartha/práchomhshóraigh amháin. Tá comhpháirtíochtaí urraíochta sa rannán 🤝 Tacaíochtaí ó chairde an Fhoinse Oscailte thuas. Níl aon urraíocht nó comhpháirtíocht ag OmniRoute leis na soláthraithe liostaithe anseo — is cóipeanna poiblí iad seo is féidir le duine ar bith a úsáid.
AgentRouter agentrouter.org
AgentRouter — clárú comhfhreagrach · $100 creidmheas 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á táirgeadh). Tacaíocht den chéad scoth i OmniRoute ó v3.8.50: Comhlánaíochtaí Comhrá, an formáid sreanga comhoiriúnach le Anthropic agus an cosán 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 comhfhreagrach — níl aon urraíocht nó comhpháirtíocht ag OmniRoute leis an soláthraí seo.
An bhfuil a fhios agat faoin soláthraí eile le cóip práchomhshóraigh saor in aisce flaithiúil ar fhabhrúsoirí úsáideoirí OmniRoute? Oscail ábhar agus cuirfimid é 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 agus mion-cúrsaí feidhmiúlachta i gcoinne 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ú.
## �📡 Radair OmniRoute
An príomhcheannlíne saor-tairisceana fanann mar **~1.51B comharthaí/an t-iomlán** ón catalóg,
atá dídhúblaithe ag líonra, thuas. Is féidir creidmheachtaí sínithe sealadach ard-soláthraí a ardú an chéad
mí go **~2.13B** ar leithligh. Is radair roghnach, catalóg shínithe é Radair le haghaidh daoine ar mian leo
ábharthacht saor-mhúnla nua-aimseartha idir eisiúintí OmniRoute; fanann an catalóg pobail agus gach gné
saor-tairisceana reatha saor in aisce.
Is féidir le tacaíocht tairbhithe an catalóg beo agus deiseanna soláthraí breise a fháil. Is é a leibhéal
inaistrithe ar leith **thart ar 3B comharthaí/an t-iomlán ar a mhéad**, ag brath ar fáilteacht an tsoláthraí.
Ní ráthaíocht é an leibhéal sin: is féidir le soláthraíteanna cuótaí, incháilitheacht, múnlaí nó réigiúin a athrú
am ar bith.
Tógtha le Radair agus gan ach GET. Ní uaslódálann cliant OmniRoute ceisteanna, tráffic, cumraíocht soláthraí,
teileamheadrach úsáide, ná stáid dhíothaithe fógra áitiúil. Faigh amach faoin incháilitheacht agus
an cataló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)
## 🤖 CLInna & Gníomhairí Códála Comhoiriúnacha
> Aon chumraíocht amháin — `http://localhost:20128/v1` — agus ritheann **gach** IDE AI nó CLI ar mhúnlaí saor in aisce agus ar chostas íseal.
+ oibríonn sé freisin le · Kiro · Command Code · Antigravity · Windsurf · AMP · aon uirlis atá comhoiriúnach le OpenAI
📖 Socrú in aghaidh na huirlise do na 36 uirlis go léir (26 CLI Code's + 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 tacaithe trí OmniRoute le hordú amháin** — gan aon chomhaid chumraíochta a scríobh,
dintiúir á instealladh in aghaidh an phróisis, faigheann Qwen/Gemini baile scoite sealadach:
```bash
omniroute run claude --model openai/gpt-5.4 # Claude Code
omniroute run codex --model glm/glm-5.2 # OpenAI Codex CLI
omniroute run aider --model glm/glm-5.2 -- --message "reply OK"
omniroute run goose --model glm/glm-5.2
omniroute run opencode --model glm/glm-5.2 -- run "reply OK"
omniroute run qwen --model glm/glm-5.2 -- -p "reply OK"
omniroute run gemini --model glm/glm-5.2 -- --skip-trust -p "reply OK"
# Nó roghnaigh soláthraí+múnla go hidirghníomhach agus scríobh cumraíocht na huirlise féin:
omniroute configure codex # freisin: claude opencode qwen aider goose gemini cline continue kilo
```
Tugann gach ordú ómós do chomhthéacs cianda gníomhach (`omniroute connect `), réamhamharcann `--dry-run`
ar na env/args beacht gan iad a fhorghníomhú, agus coinníonn `--api-key-env NAME` rúin amach
as do stair scaoill. → [Comhtháthú CLI](docs/guides/CLI-INTEGRATIONS.md)
## 🌐 352 Soláthraithe AI — 152 Curtha in iúl mar Saor sa Chatalog
> **352 soláthraí cláraithe** trí na bailiúcháin chaighdeánacha comhrá, meán, cuardach, áitiúil, áisiceán scamall agus córas, lena n-áirítear **152 iad siúd a bhfuil ábhar aimsire `hasFree: true` acu**. Clúdaíonn an chlár samhlacha comhrá **229 soláthraí / 2,554 péire soláthraí-samhlacha éagsúla / 1,283 aitheantóir samhlacha amh**; tá **446 ró ar gach samhail**, **355 umair athfhillteach** agus **53 soláthraí saor i gcónaí gan eochair** sa chatalog saor buiséid ar leith. Tá na hathróga éagsúla seo ann de dhíth; tá na sainmhínithe agus na hitheachtaí umar gan duaigh sa [Tagairt Soláthraí](docs/reference/PROVIDER_REFERENCE.md) agus [Tairseacha Saora](docs/reference/FREE_TIERS.md).
### 🏢 Gach saothar mór — trí chríochphointe amháin
OpenAI
Anthropic
Gemini
xAI Grok
DeepSeek
Mistral
Qwen
Meta Llama
Groq
NVIDIA
MiniMax
Cohere
Perplexity
HuggingFace
Together
Fireworks
Cloudflare
Baidu
…agus 330+ eile — déanann gach deilbhín réiteach beo as catalog soláthraithe an deilbhín. 📖 [Tagairt Soláthraí](docs/reference/PROVIDER_REFERENCE.md)
### 🆓 Saor go Deo — $0, gan chárta
OpenCode Zen DeepSeek V4, Nemotron 3 Gan teorainn comhartha
Kilo Code Auto-roghnóir, Tencent Hy3 Saor go deo
Requesty GPT-OSS 120B, Nemotron Saor go deo
SiliconFlow DeepSeek V3.2 / R1 Tairseach saor
Z.AI GLM GLM-4.7 / 4.5-Flash Saor go deo
Baidu ERNIE ERNIE 4.0 Saor go deo
Qoder AI Qwen3-Max, Kimi-K2 SAOR IN IOMLÁIN
Pollinations GPT, Llama, Claude Gan eochair ag teastáil
Cloudflare AI 50+ samhail 10K neurón/lá
NVIDIA NIM GLM, MiniMax ~40 RPM saor
Cerebras GLM 4.7, GPT-OSS 1M comhartha/lá
OpenRouter :saor samhlacha +$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 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.
Straithéis clúdach tástála do 39,000+ dearbhú tástála statacha ar fud 5,100+ comhad tástála rianaithe
# ⭐ Rannpháirtithe Barr
> Múnlaítear OmniRoute ag pobal foinse oscailte paiseanta. Rinne na daoine seo ranníocaíochtaí eisceachtúla a mbíonn tionchar díreach acu ar cháilíocht, chobhsaíocht, agus raon an tionscadail. **Go raibh maith agaibh.**
### Rannpháirtithe seachtracha de réir PRanna comhcheangailte
Reoite ag barr beo release/v3.8.50dafb4ae808, le comhcheangail trí 2026-08-24 05:26:03 UTC. Tá 5,911 PR comhcheangailte san áireamh sa daonáireamh GraphQL págáilte: 2,707 ag úinéir an stór, 179 ag Dependabot, agus 3,025 PR seachtracha ó 535 rannpháirtí ar leith. Is ionann “Línte Athraithe” agus suimitheanna agus scriosanna GitHub agus áirítear comhaid ghinte, comhaid ghlasála, catalóga, aistriúcháin agus doiciméadú; is corraíl é, ní LOC údaraithe. Coinnítear comhcheangail ag an ngearrthóg.
### Tiomantais chláraithe ag GitHub
Bob.Hou 🏅 51 tiomantas cláraithe ag GitHub · ceangailte #10
Xiangzhe 🏅 51 tiomantas cláraithe ag GitHub · ceangailte #10
Athsheiceáilte ag 2026-08-24 06:14:31 UTC: Tiomantais chláraithe ag GitHub a thuairiscigh API Rannpháirtithe an stóir don bhrainse réamhshocraithe release/v3.8.50. D'fhill an API 525 céannacht (415 úsáideoir, 2 róbat, 108 gan ainm); eisiann an tábla seo an cothaitheoir, róbait agus céannachtaí gan ainm agus coinníonn sé comhcheangail iomaíochta. Tá sé ar leith ón rangú PR comhcheangailte thuas agus ón daonáireamh meiteashonraí Git 639-duine thíos.
> 🙏 Gnéithe, ceartúcháin fabhtanna, agus feabhsuithe bonneagair na rannpháirtithe seo is ea croílár a dhéanann OmniRoute iontaofa agus saibhir i ngnéithe. Tá gach pull request, gach cás tástála, agus gach comhad aistriúcháin i18n tábhachtach. Tógtar foinse oscailte ag daoine cosúil leo.
---
## 💖 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).