# README (Filipino) 🌐 **Languages:** 🇺🇸 [English](../../../README.md) · 🇪🇹 [am](../am/README.md) · 🇸🇦 [ar](../ar/README.md) · 🇦🇿 [az](../az/README.md) · 🇧🇬 [bg](../bg/README.md) · 🇧🇩 [bn](../bn/README.md) · 🇧🇦 [bs](../bs/README.md) · 🇨🇿 [cs](../cs/README.md) · 🇩🇰 [da](../da/README.md) · 🇩🇪 [de](../de/README.md) · 🇬🇷 [el](../el/README.md) · 🇪🇸 [es](../es/README.md) · 🇪🇪 [et](../et/README.md) · 🇮🇷 [fa](../fa/README.md) · 🇫🇮 [fi](../fi/README.md) · 🇫🇷 [fr](../fr/README.md) · 🇮🇪 [ga](../ga/README.md) · 🇮🇳 [gu](../gu/README.md) · 🇳🇬 [ha](../ha/README.md) · 🇮🇱 [he](../he/README.md) · 🇮🇳 [hi](../hi/README.md) · 🇭🇷 [hr](../hr/README.md) · 🇭🇺 [hu](../hu/README.md) · 🇦🇲 [hy](../hy/README.md) · 🇮🇩 [id](../id/README.md) · 🇳🇬 [ig](../ig/README.md) · 🇮🇹 [it](../it/README.md) · 🇯🇵 [ja](../ja/README.md) · 🇬🇪 [ka](../ka/README.md) · 🇰🇭 [km](../km/README.md) · 🇮🇳 [kn](../kn/README.md) · 🇰🇷 [ko](../ko/README.md) · 🇱🇹 [lt](../lt/README.md) · 🇱🇻 [lv](../lv/README.md) · 🇮🇳 [ml](../ml/README.md) · 🇮🇳 [mr](../mr/README.md) · 🇲🇾 [ms](../ms/README.md) · 🇲🇹 [mt](../mt/README.md) · 🇲🇲 [my](../my/README.md) · 🇳🇵 [ne](../ne/README.md) · 🇳🇱 [nl](../nl/README.md) · 🇳🇴 [no](../no/README.md) · 🇮🇳 [or](../or/README.md) · 🇮🇳 [pa](../pa/README.md) · 🇵🇱 [pl](../pl/README.md) · 🇵🇹 [pt](../pt/README.md) · 🇧🇷 [pt-BR](../pt-BR/README.md) · 🇷🇴 [ro](../ro/README.md) · 🇷🇺 [ru](../ru/README.md) · 🇱🇰 [si](../si/README.md) · 🇸🇰 [sk](../sk/README.md) · 🇸🇮 [sl](../sl/README.md) · 🇷🇸 [sr](../sr/README.md) · 🇸🇪 [sv](../sv/README.md) · 🇰🇪 [sw](../sw/README.md) · 🇮🇳 [ta](../ta/README.md) · 🇮🇳 [te](../te/README.md) · 🇹🇭 [th](../th/README.md) · 🇹🇷 [tr](../tr/README.md) · 🇺🇦 [uk-UA](../uk-UA/README.md) · 🇵🇰 [ur](../ur/README.md) · 🇺🇿 [uz](../uz/README.md) · 🇻🇳 [vi](../vi/README.md) · 🇳🇬 [yo](../yo/README.md) · 🇨🇳 [zh-CN](../zh-CN/README.md) · 🇹🇼 [zh-TW](../zh-TW/README.md) ---

# 🚀 OmniRoute — Ang Libreng AI Gateway

OmniRoute — Huwag tumigil sa pag-code. Bawat AI tool → 375 provider — 150+ libre — sa pamamagitan ng iisang endpoint. Claude Code, Codex, Cursor, Cline, Copilot at Antigravity sa LIBRENG Claude / GPT / Gemini na may awtomatikong fallback. Ang pinagsamang compression ng RTK + Caveman ay nakakatipid ng 15–95% ng mga token (~89% sa karaniwan) — huwag nang maabot ang mga limitasyon. 375 AI provider · 150+ libreng tier · ~1.62B libreng token/buwan · 20 diskarte sa routing · $0 para magsimula.

## 💰 ~1.62B Token / Buwan sa Lahat ng Third-Party Free Tier

> **Dalhin ang sarili mong provider accounts.** Ito ay tinatayang pinagsama-samang bilang mula sa hiwalay na karapat-dapat na third-party free tiers, hindi token grant mula sa OmniRoute. Mag-sign up, kumuha ng credentials kung kailangan, at ikonekta ang mga provider na magagamit mo; kinokontrol ng bawat provider ang mga limit, availability, at terms nito. > > Ang manu-manong pag-stack ng free tiers ay mahirap — dose-dosenang SDK, dose-dosenang rate limit, at walang ideya kung gaano talaga ang mayroon ka. Kinakatalogo ng OmniRoute ang **467 free-tier entries sa 34 na paulit-ulit na pool keys** at kinokompute ang token headline mula sa **17 pools na may nai-publish na positibong buwanang budget kasama ang limang per-model Groq caps**, na deduplicated ayon sa shared pool. Ang mga quota na bumubukas lamang pagkatapos ng regional identity check (ngayon: ModelScope) ay ipinapakita nang hiwalay, +~6M sa likod ng regional identity verification, at hindi kailanman isinasama sa headline. Nananatiling nakikita ang resulta sa dashboard (`/dashboard/free-tiers`).

> Animated na buod ng live na `/dashboard/free-tiers` page. Buong methodology (pool dedupe, credit tiers, provider terms): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**. > > _{Ang mga figure na ito ay muling ini-audit tuwing dalawang linggo laban sa live catalog at **gumagalaw sa dalawang direksyon** — nagtatapos ang isang provider ng free tier at bumababa ang numero; may bago na dumarating at umaakyat ito. Ini-publish namin ang aktwal na kinokompute ng catalog, hindi kailanman isang ni-round-up na best case.}

⭐ I-star ang repo kung nakatulong sa iyo ang OMNIROUTE na makatipid at gawing mas madali ang trabaho mo.

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

[![Star History Rank](https://api.star-history.com/badge?repo=diegosouzapw/OmniRoute&theme=dark)](https://www.star-history.com/diegosouzapw/omniroute) [![olud.ai](https://olud.ai/badge.php?tool=diegosouzapw-omniroute)](https://olud.ai/project/diegosouzapw-omniroute.html) ### 💬 Sumali sa komunidad **👋 Sundan ang maintainer — makuha muna ang mga bagong provider, release at tip:** [![Sundan si Diego sa LinkedIn](https://img.shields.io/badge/Follow_Diego_on-LinkedIn-0A66C2?style=for-the-badge&logo=linkedin&logoColor=white)](https://www.linkedin.com/in/diegosouzapw/) [![Sundan si @diegosouzapw sa GitHub](https://img.shields.io/github/followers/diegosouzapw?style=for-the-badge&logo=github&logoColor=white&label=Follow%20on%20GitHub&color=181717)](https://github.com/diegosouzapw) [![Discord](https://img.shields.io/badge/Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/U47eFqAXCn) [![Telegram](https://img.shields.io/badge/Telegram-26A5E4?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/omnirouteOficial) [![WhatsApp Global](https://img.shields.io/badge/WhatsApp_Global-25D366?style=for-the-badge&logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) [![WhatsApp Brasil](https://img.shields.io/badge/WhatsApp_Brasil-25D366?style=for-the-badge&logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) [![Website](https://img.shields.io/badge/Website-omniroute.online-blue?logo=google-chrome&logoColor=white)](https://omniroute.online) **Mga tanong, provider tip, roadmap at suporta → [Discord](https://discord.gg/U47eFqAXCn) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 Global](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) / [🇧🇷 Brasil](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)**
## 📈 Patuloy na Lumalaki ang Gateway

| | v3.8.50 | **v3.8.51** | `v3.8.53+` | | --------------------------------------- | :-----------------------: | :---------: | :-------------------: | | 🌐 Mga Provider | 352 | **358** | 375 | | 🧠 Natatanging chat model ID | 1320 | **1374** | 1475 | | 🖼️ Modality Bridge | 🆕 vision + audio + video | ✓ | ✓ | | 📡 Libreng catalog ng Radar | 🆕 opt-in | ✓ | ✓ | | ⚖️ Scheduling na may kamalayan sa quota | 🆕 Quota-Share | ✓ | ✓ | | 📊 Telemetry ng quota | 🆕 live | ✓ | ✓ | | 🧰 Headless mode | — | — | 🆕 `serve --headless` | | 🛤️ LTS rail infra | — | — | 🆕 release channels | | 🔎 API sa paghahanap ng Model | — | — | 🆕 `/v1/models/query` | **→ [Roadmap](ROADMAP.md) — sakay sa riles patungong `v3.9.0 LTS`**

## 🧩 Magagamit [![bersyon ng npm](https://img.shields.io/npm/v/omniroute?color=cb3837&logo=npm)](https://www.npmjs.com/package/omniroute) ![Buwanan sa NPM](https://img.shields.io/npm/dm/omniroute?label=npm/month&color=cb3837&logo=npm) [![Docker Hub](https://img.shields.io/docker/v/diegosouzapw/omniroute?label=Docker%20Hub&logo=docker&color=2496ED)](https://hub.docker.com/r/diegosouzapw/omniroute) [![Lisensya: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](LICENSE) ![Mga Pag-pull sa Docker](https://img.shields.io/docker/pulls/diegosouzapw/omniroute?label=docker%20pulls&logo=docker&color=2496ED) ![Mga Download sa Electron](https://img.shields.io/github/downloads/diegosouzapw/omniroute/total?style=flat&label=electron%20downloads&logo=electron&color=47848F)

🚀 Magsimula	🚀 Mabilisang Pagsisimula	📦 I-install	🆓 Kumonekta sa isang provider
💡 Matuto	💥 Ang Pangako	🤔 Bakit OmniRoute	🏆 Ano ang Nagpapaiba Rito
⚙️ Mga Feature	🎯 Mga Combo	🌐 Mga Provider	🔌 CLI at MCP
	🗜️ Compression	🖥️ Kung Saan Ito Tumatakbo	🔒 Pribado
👀 Tingnan ito	🎬 Aktuwal na Paggamit	✨ Ano ang Bago	🤖 Mga Katugmang CLI
💚 Suporta	💚 Suportahan / Mag-donate	💬 Komunidad	💖 Mga Sponsor
📦 Proyekto	🛠️ Tech Stack	📖 Dokumentasyon	👥 Mga Contributor

🌐 Sa 67 wika

## 🆓 Mag-install, kumonekta sa isang provider, pagkatapos ay mag-route sa pamamagitan ng iisang endpoint

Tatlong hakbang: i-install at simulan ang OmniRoute, kumonekta sa isang kwalipikadong provider gamit ang sarili mong account o API key, pagkatapos ay ituro ang iyong tool sa localhost:20128/v1 gamit ang isang OmniRoute API key at modelong auto. Nakadepende ang routing sa mga available na kwalipikadong koneksyon at mga limitasyon ng provider.

```bash # Pagkatapos kumonekta sa isang provider, kopyahin ang iyong OmniRoute key mula sa Dashboard → Endpoints: curl http://localhost:20128/v1/chat/completions \ -H "Authorization: Bearer YOUR_OMNIROUTE_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}' ``` _{Nangangailangan ang `auto` ng kwalipikadong route. Maaaring walang kwalipikadong keyless target ang bagong installation, at maaaring tanggihan ng isang keyless provider ang mga third-party client. Ang mga provider na minarkahang `tos: avoid`, kabilang ang Kiro, ay hindi isinasama sa awtomatikong routing bilang default; hindi ino-override ng pagkonekta ng account ang setting na iyon. Tingnan ang [Gabay sa mga Libreng Tier](docs/getting-started/FREE-TIERS-GUIDE.md) bago pumili ng provider.} _{📦 Mga copy-paste na quickstart script para sa **Python, Node.js, PHP, at cURL** → [`examples/quickstart/`](examples/quickstart/)}

# 💥 Ang Pangako

# 🤔 Bakit OmniRoute?

Daloy ng request sa OmniRoute: tumatawag ang iyong IDE o CLI (Claude Code, Cursor, Cline…) sa iisang local endpoint (http://localhost:20128/v1); maaaring mag-fallback ang OmniRoute Smart Router (RTK + Caveman compression, 20 diskarte sa routing, mga circuit breaker, TLS stealth, MCP, A2A, mga guardrail) sa 4 na tier ng provider habang may natitirang kwalipikado at maayos na target — Tier 1 Subscription, Tier 2 API Key, Tier 3 Cheap, at Tier 4 Free.

## 🤝 Sinusuportahan ng Aming Mga Kaibigan sa Open Source

> **Gusto mo bang sumali bilang isang Kaibigan sa Open Source?** Ito ang mga kumpanyang sumusuporta sa open source at tumutulong na panatilihing gumagana ang OmniRoute — at ipinapahayag namin sa publiko kung saan napupunta ang bawat token na ibinibigay nila sa amin. Makipag-ugnayan: [diegosouza.pw@outlook.com](mailto:diegosouza.pw@outlook.com)

Kimi
_{Moonshot AI} Salamat sa Kimi (Moonshot AI), ang aming founding Open Source Friend, sa pagsuporta sa proyektong ito! Ang Kimi ay ang AI lab sa likod ng open-weight K2 at K3 model families — ang Kimi K3 ay naghahatid ng 1M-token context window, native vision at frontier-level coding sa isang bahagi ng presyo ng closed-model, at gumagana agad sa Claude Code, Codex at bawat coding tool na inihahatid ng OmniRoute.

Ano ang pinapagana ng suporta ng Kimi: Ang mga API credit ng Kimi ay nagpapagana sa AI-validated release pipeline ng OmniRoute — ang merge validation na pinapagana ng Kimi K3 stage na sumusuri sa bawat pull request bago ito ilabas — kasama ang pang-araw-araw na pagbuo ng feature. Ang first-class na suporta ng Kimi ay inilalabas sa parehong rails: ang direktang Kimi API (kimi-k3) at ang Kimi Code coding plan (OAuth at API key). Ang OmniRoute din ang unang Brazilian open-source project sa support program ng Kimi. Kumuha ng Kimi API key na may 15% dagdag na credits →

Cheaper Inference
_{cheaperinference.com} Salamat sa Cheaper Inference, isang OmniRoute Open Source Friend, sa pagsuporta sa proyektong ito! Ang Cheaper Inference ay isang cost-ranked gateway na nagbebenta muli ng 42 frontier models — Claude, GPT-5.x, Gemini, Kimi K3, GLM, DeepSeek, Grok at MiniMax — sa likod ng isang OpenAI-compatible endpoint, na nagruruta ng bawat kahilingan sa pinakamurang karapat-dapat na provider nang hindi kailanman naniningil ng mas mataas sa list price ng gumawa ng modelo.

First-class na suporta sa OmniRoute: Chat Completions, ang native na /v1/responses endpoint, vision, tool calling at 3 image models (grok-imagine, nano-banana-pro, nano-banana-2, na naaabot bilang cheaperinference/<model>). Kumuha ng API key →

_{Ang mga link na may tag na aff=omniroute ay mga partner link. Pinopondohan nila ang proyekto nang walang dagdag na gastos sa iyo.}

_{🎟️ Affiliates Promo — libreng signup coupons mula sa mga provider na hindi namin sinusuportahan (i-click para palawakin)}

_{Ang seksyong ito ay para lamang sa referral/coupon codes. Ang mga sponsored partnership ay nasa 🤝 Sinusuportahan ng Aming Mga Kaibigan sa Open Source sa itaas. Walang sponsorship o partnership ang OmniRoute sa mga provider na nakalista dito — ito ay mga pampublikong coupon na maaaring gamitin ng sinuman.}

_AgentRouter
_{agentrouter.org} _{AgentRouter — affiliate signup · $100 libreng credits sa signup (libreng server, asahan ang mas mataas na latency — pinakamahusay para sa pagsubok, hindi para sa produksyon). First-class na suporta sa OmniRoute mula noong v3.8.50: Chat Completions, ang Anthropic-compatible wire format at ang OpenAI-compatible path. Kasama sa mga available na modelo ang claude-opus-4-8, claude-opus-5, gpt-5.6-sol at marami pa. Kunin ang iyong $100 →}

_{⚠️ Affiliate link — Walang sponsorship o partnership ang OmniRoute sa provider na ito.}

_{May alam ka bang ibang provider na may mapagbigay na libreng signup coupon na makikinabang sa mga user ng OmniRoute? Magbukas ng isyu at idaragdag namin ito dito.}

## 🎯 Mga Combo — Ang Pangunahing Tampok

Mga animated na halimbawa para sa 18 sa 20 diskarte sa pagruruta ng combo — isang tile bawat diskarte: priority, fill-first, weighted, round-robin, p2c, least-used, random, strict-random, cost-optimized, headroom, reset-window, reset-aware, context-relay, context-optimized, lkgp, auto, fusion, pipeline. Hindi animated ang cache-optimized at quota-weighted; inilalarawan ng talahanayan sa ibaba ang lahat ng 20.

> Ang **combo** ay isang hanay ng mga model na **awtomatikong** pinagrurutahan ng OmniRoute. Kung maubos ang quota, pumalya ang isang provider, o biglang tumaas ang mga gastos, maaaring lumipat ang combo sa susunod na kwalipikado at maayos na model. 🛡️ ### ⚡ Walang configuration — gamitin lang ang `auto` Walang combo na kailangang gawin. Itakda ang iyong model sa `auto` (o isang variant) at bubuo ang OmniRoute ng virtual na combo mula sa iyong mga nakakonektang provider, na sinusuri nang live:

Model ID	Kung para saan ito nag-o-optimize
`auto`	🎯 Balanseng default (LKGP — nananatili sa iyong huling maayos na provider)
`auto/coding`	🧑💻 Mga weight na inuuna ang kalidad para sa pagbuo ng code
`auto/fast`	⚡ Pinakamababang latency muna
`auto/cheap`	💰 Pinakamura bawat token muna
`auto/subscription`	🎟️ Tanging ang quota ng subscription na binabayaran mo na — hihinto kapag nabigo, at hindi kailanman lilipat sa fallback na may bayad (gabay)
`auto/thrifty`	🪜 Quota ng plan muna, pagkatapos ay paisa-isang antas patungo sa pinakamurang mga opsyong may bayad — babalik sa plan pagkatapos nitong mag-reset (gabay)
`auto/offline`	🔋 Pinakamalaking natitirang quota / kapasidad sa rate limit muna
`auto/smart`	🔭 Inuuna ang kalidad + 10% eksplorasyon upang makatuklas ng mas mahuhusay na model
`auto/lkgp`	📌 Tahasang pananatili sa huling kilalang maayos na provider
`auto/chaos`	🧪 Sabay-sabay na pagpapadala sa isang panel ng mga model (isa bawat provider, 5 bilang default), at nagbabalik ng isang sagot; isang upstream call bawat model sa panel, hindi fault injection

## ### 🔀 O bumuo ng sarili mo — 20 diskarte sa pagruruta Lahat ng **20** diskarte — paghalu-haluin at pagtugmain sa bawat hakbang ng combo:

#	Diskarte	Kung ano ang ginagawa nito
1	`priority`	Listahang nakaayos ayon sa unang target — ubusin ang bawat isa bago lumipat sa susunod 🥇
2	`fill-first`	Lubusang punuin ang quota ng bawat target bago lumipat
3	`weighted`	Random na pagpili batay sa weight ng bawat target
4	`round-robin`	Umikot sa mga target ayon sa pagkakasunod-sunod
5	`p2c`	Random na load balancing gamit ang power-of-two-choices
6	`least-used`	Piliin ang target na may pinakamababang kasalukuyang load
7	`random`	Pantay-pantay na random na pagpili (inaalis ang mga duplicate)
8	`strict-random`	Random nang hindi inaalis ang mga pag-uulit 🎲
9	`cost-optimized`	Pinapaliit ang $ bawat request batay sa live na pagpepresyo sa catalog 💸
10	`headroom`	Piliin ang target na may pinakamaraming natitirang quota
11	`quota-weighted`	Laktawan ang mga account na ubos na, pagkatapos ay pumili nang proporsyonal sa natitirang quota ÷ kasalukuyang load — mananatiling naka-pin ang mga umiiral na pag-uusap ⚖️
12	`reset-window`	Unahin ang target na may quota window na pinakamalapit nang mag-reset
13	`reset-aware`	I-ranggo ayon sa oras ng pag-reset ng quota — maiikling window muna 📊
14	`context-relay`	Ilipat ang context sa iba't ibang target para sa mahahabang pag-uusap 🧠
15	`context-optimized`	Piliin ang pinakaangkop para sa kasalukuyang laki ng context
16	`cache-optimized`	I-pin ang bawat muling magagamit na prefix ng prompt sa parehong account — i-maximize ang mga hit sa prompt cache 🎯
17	`lkgp`	Huling Kilalang Maayos na Path — ipinipin sa huling matagumpay na provider, pagkatapos ay lilipat sa mga panuntunan bilang fallback
18	`auto`	Live na pagmamarka gamit ang 16 na salik sa lahat ng koneksyon 🤖
19	`fusion`	Ipadala sa isang panel ng mga model + isang tagahatol ang magsasama-sama ng iisang sagot 🧬
20	`pipeline`	Ikadena ang mga hakbang — ang output ng bawat target ay ipinapasa sa susunod 🔗

_{Binibigyan ng Auto-Combo engine ng puntos ang bawat kandidato batay sa **16 na salik** (kalusugan, quota, gastos, latency, pagiging angkop sa gawain, kalidad, availability ng session…) — tingnan ang [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md).} ## ### 🧱 Nakapaloob na ang resilience (3 independiyenteng layer)

Resilience ng OmniRoute — 3 independiyenteng layer na kusang bumabawi, ang tamang layer para sa tamang pagkabigo. Layer 1 provider circuit breaker (buong provider): tumitigil lamang sa 408/5xx, mga threshold na OAuth 8× / API-key 12× / lokal 2×, nagre-reset pagkalipas ng 60s/30s/15s patungo sa isang HALF-OPEN na pagsubok, lazy recovery; habang OPEN, inililipat ng combo ang ruta sa susunod na provider. Layer 2 connection cooldown (isang key/account): batayang 5s OAuth / 3s API-key, exponential ×2 backoff na may proteksiyon laban sa thundering herd, sinusunod ng 429 ang Retry-After, nililinis ng tagumpay ang lahat ng error state; nilalampasan ang isang key na nasa cooldown habang patuloy na nagseserbisyo ang mga kapatid nitong key. Layer 3 model lockout (isang model): ang per-model na 429, lokal na 404, o mga pagtanggi sa mode ay nagla-lock lamang sa model na iyon — hindi kailanman sa buong koneksiyon. Ang mga terminal state (banned, expired, ubos na credits) ay para sa operator, hindi para sa mga cooldown.

_{📖 [Auto-Combo Engine](docs/routing/AUTO-COMBO.md) · [Gabay sa Resilience](docs/architecture/RESILIENCE_GUIDE.md)}

## 🏆 Ang Nagpapabukod-tangi sa OmniRoute

_{📊 Kumpletong metodolohiya & mga detalye ng bawat feature kumpara sa 9router, OpenRouter, CLIProxyAPI & LiteLLM → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)}
## 💚 Suportahan ang OmniRoute Ang OmniRoute ay may lisensyang MIT at hayagang pinapanatili. Kung nakakatipid ito ng oras o pera para sa iyo, narito kung paano mo ito matutulungang manatiling malaya — piliin ang naaangkop sa iyo. Hindi kailanman naaapektuhan ng sponsorship ang priyoridad sa routing; visibility ang binibili nito, hindi ranggo.

⭐ I-star ang repo	Libre — talagang nakakatulong sa visibility	I-star ang OmniRoute
🐙 GitHub Sponsors	Isang beses o buwanan · walang bayarin sa platform	github.com/sponsors/diegosouzapw
☕ Ko-fi	Mabilis na minsanang tip, hindi kailangang mag-sign up ang donor	ko-fi.com/diegosouzapw
🧋 Buy Me a Coffee	Maliit at di-pormal na pagpapahalaga	buymeacoffee.com/diegosouzapw
🖐 Liberapay	Paulit-ulit · non-profit · open source	liberapay.com/diegosouzapw
🇧🇷 PIX (Brazil)	Agad-agad, walang bayarin	key at QR sa ibaba
₿ Crypto	BTC · ETH · USDT-TRC20 · USDC-Solana	mga address sa ibaba

**🇧🇷 PIX** — agad-agad, walang bayarin (Brazil) QR code ng OmniRoute PIX

Key (random): `5d865059-bc44-483a-962d-43ceb80126eb` Kopyahin-at-i-paste na Pix: ``` 00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD ```

₿ Crypto — BTC · ETH · USDT-TRC20 · USDC-Solana (i-click para palawakin)

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

_{⚠️ Ipadala lamang ang bawat coin sa ipinapakitang network — maaaring mawala ang mga pondo kapag ipinadala sa maling network.}

🐛 Nakakita ng bug o may feedback? Magbukas ng [Talakayan](https://github.com/diegosouzapw/OmniRoute/discussions).

Mga tala para sa developer: Maaaring bumuo ang proyekto ng lokal na .env file habang isinasagawa ang npm install/postinstall para sa kaginhawaan ng developer. Sadyang binabalewala ang file na ito sa pamamagitan ng .gitignore (tingnan ang .gitignore) at hindi ito kailanman dapat i-commit — kung aksidenteng na-commit, palitan ang anumang nalantad na secret at alisin ang file mula sa history. Tingnan ang docs/DEVELOPER-ENVIRONMENT.md para sa gabay sa pamamahala ng mga lokal na environment file at secret.

## 📡 OmniRoute Radar Ang pangunahing headline para sa libreng tier ay nananatiling **~1.62B token/buwan** mula sa nakadokumento at na-deduplicate ayon sa pool na catalog sa itaas. Maaaring hiwalay na mapataas ng pansamantalang signup credits ng provider ang unang buwan sa **~2.22B**. Ang Radar ay isang opsyonal at nilagdaang catalog overlay para sa mga taong nais ng mas napapanahong availability ng mga libreng modelo sa pagitan ng mga release ng OmniRoute; mananatiling libre ang catalog ng komunidad at ang bawat umiiral na libreng feature. Maaaring matanggap ng mga supporter ang live na catalog at mga karagdagang oportunidad mula sa provider. Ang hiwalay at nababagong limitasyon nito ay **humigit-kumulang 3B token/buwan sa pinakamataas**, depende sa availability ng provider. Hindi garantiya ang limitasyong iyon: maaaring baguhin ng mga provider ang mga quota, pagiging kwalipikado, mga modelo, o mga rehiyon anumang oras. Ang Radar ay opt-in at GET-only. Hindi nag-a-upload ang OmniRoute client ng mga prompt, traffic, configuration ng provider, telemetry ng paggamit, o lokal na estado ng pag-dismiss sa announcement. Alamin ang tungkol sa pagiging kwalipikado at ang kasalukuyang catalog sa **[radar.omniroute.online/planos](https://radar.omniroute.online/planos)**.

## ✨ Ano ang Bago

> Mga kamakailang highlight mula sa **v3.8.20 → v3.8.53**. Buong kasaysayan sa [`CHANGELOG.md`](CHANGELOG.md). - **⚖️ `quota-weighted` na routing** — ang ika-20 combo strategy ay lumalaktaw sa mga naubos na account, pagkatapos ay pumipili sa natitira ayon sa proporsyon ng natitirang quota ÷ in-flight load, habang pinananatiling naka-pin ang mga kasalukuyang usapan. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🧰 Headless mode** — ang `omniroute serve --headless` (o `OMNIROUTE_HEADLESS=1`) ay nagpapatakbo lamang ng `/v1/*` proxy engine, naka-off ang dashboard at mga subsystem na para lang sa dashboard. → [Headless Mode](docs/guides/HEADLESS.md) - **🔎 Pagtuklas ng model** — ang `/v1/models` ay nagfi-filter ayon sa capability, context, kind at text, at ang `POST /v1/models/query` ay nagbabalik ng maikling deterministic na shortlist na may parehong per-key visibility. → [API Reference](docs/reference/API_REFERENCE.md) - **🔑 Kontrol sa routing kada key** — i-pin ang isang API key sa isang model o combo gamit ang `forcedModel`, at idagdag o alisin nang atomiko ang mga model at combo ng isang key (`/api/keys/{id}/access`). → [API Reference](docs/reference/API_REFERENCE.md) · [OpenAPI](docs/openapi.yaml) - **🛡️ Mas pinong mga kontrol sa PII** — pagpili kada uri, hanggang 20 validated na custom masking pattern at per-type detection counter; nananatiling opt-in ang masking mismo. → [Guardrails](docs/security/GUARDRAILS.md) - **🌍 67 na wika** — dashboard, mga docs mirror at CLI, kung saan ang `npm run i18n:add-locale` ay nagdaragdag ng wika sa lahat ng lugar sa isang command. → [i18n Guide](docs/guides/I18N.md) - **🎛️ OmniConductor** — papasok na A2A delegation patungo sa iyong agent fleet, mga Conductor skill sa Agent Card, at panel sa dashboard na may Faro push-to-talk voice chat. → [A2A Server](docs/frameworks/A2A-SERVER.md) - **🛂 Adaptive admission at proteksyon sa overload** — ang mabibigat na chat request ay pumipila sa halip na mag-503, na may atomic RPM rolling lease kada koneksyon. → [Resilience Guide](docs/architecture/RESILIENCE_GUIDE.md) - **🗂️ Canonical na pagkakasunod-sunod ng `/v1/models`** — isang magkadikit na block na naka-group ayon sa provider para sa bawat provider (mga combo ang naka-pin muna), stable sa lahat ng catalog source. → [API Reference](docs/reference/API_REFERENCE.md) - **🗜️ Pagpapatatag ng compression** — naka-default na inflation guard, mga Caveman pack para sa DE / FR / JA + Chinese (wényán), mga RTK filter para sa Gradle at .NET. → [Compression](docs/compression/COMPRESSION_ENGINES.md) - **💸 Tapat na flat-rate na gastos** — ang subscription / coding-plan provider ay nagbabasa ng **$0** sa cost analytics; patuloy na nag-e-estimate ang budget, quota at routing. → [API Reference](docs/reference/API_REFERENCE.md) - **⚖️ Quota-Share na routing** — hatiin nang patas ang quota ng shared account sa mga pooled key, work-conserving upang mapahiram ang mga idle slice. → [Resilience Guide](docs/architecture/RESILIENCE_GUIDE.md) - **🤖 One-command na setup ng CLI/agent** — 15 na rehistradong `setup-*` command; ang `omniroute run` ay naglulunsad ng 7 CLI (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); sinusuportahan ng `omniroute configure` ang 11 target na may interactive na provider+model picker at per-context favorites. → [CLI Integrations](docs/guides/CLI-INTEGRATIONS.md) - **🛰️ Remote mode** — i-drive ang remote na OmniRoute gamit ang scoped token (`connect` / `contexts` / `tokens`) + isang `antigravity` OAuth helper para sa VPS install. → [Remote Mode](docs/guides/REMOTE-MODE.md) - **🧭 Mas matalinong auto-routing** — mga combo na `auto/:`, **Fusion** (model panel + judge), task-aware routing, per-request na override sa model / mode / USD-budget. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🗜️ Pluggable na compression** — 12 composable engine + Compression Studios: LLMLingua-2, two-tier Ultra, omniglyph, per-step fidelity gate, GCF v3.2, drag-reorder editor. → [Compression](docs/compression/COMPRESSION_ENGINES.md) - **🕵️ Transparent na MITM decrypt (TPROXY)** — i-capture ang mga CLI na hindi pinapansin ang proxy env var, may per-SNI CA + trust-store installer. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md) - **💸 Cost telemetry sa lahat ng dako** — `X-OmniRoute-*` cost/usage header sa bawat endpoint, cache-HIT savings header, per-key na USD spend quota. → [API Reference](docs/reference/API_REFERENCE.md) - **🧠 Memory na ikaw ang may kontrol** — off by default, opt-in na int8 vector quantization + typed decay, per-request na `x-omniroute-no-memory`. → [Memory](docs/frameworks/MEMORY.md) - **🛡️ Security** — prompt-injection guard sa bawat LLM route (red-team suite), opt-in na credential-masking guardrail (nagre-redact ng na-leak na API key/secret sa parehong direksyon), libreng DuckDuckGo last-resort web search, at opsyonal na OIDC login gate para sa dashboard (palaging available ang password login). → [Guardrails](docs/security/GUARDRAILS.md) - **🖼️ Mga bagong endpoint** — kinukumpleto ng `/v1/ocr` (Mistral OCR) at `/v1/audio/translations` (Whisper-style) ang media surface. → [API Reference](docs/reference/API_REFERENCE.md) - **🎨 Pagbuo ng image / video / audio** — isang API para sa media: xAI Grok Imagine at Novita AI video, ComfyUI, Magnific, Adobe Firefly, Segmind, at mga speech provider tulad ng ElevenLabs. → [API Reference](docs/reference/API_REFERENCE.md) - **🌍 Deployment at ops** — reverse-proxy `basePath`, auto-detect ng wika ng browser, per-key device tracking, root-less MITM trust, localization sa zh-TW. → [Environment](docs/reference/ENVIRONMENT.md) - **🤝 Mas maraming provider at agent** — mga cloud agent (Codex Cloud, Cursor, Devin, Jules), Grok Build (xAI) na may browser + OAuth login, first-class card ng Ollama, Claude Opus 5 at Sonnet 5, opisyal na partnership sa Kimi (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… at na-refresh na **375-provider catalog**. → [Providers](docs/reference/PROVIDER_REFERENCE.md) - **📡 Transparency sa routing** — bawat response ay may `X-OmniRoute-Decision` header na nagpapangalan sa strategy/provider/latency na naghatid nito, isang bagong `cache-optimized` combo strategy + Auto-Combo `cacheAffinity` factor na nagro-route ng mga paulit-ulit na request pabalik sa koneksyong may hawak ng cached prefix, at ang read-only na `/v1/auto-combo/{channel}/candidates` endpoint ay naglalabas ng live candidate pool ng isang `auto/*` channel. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **⚡ Lokal na performance at infra** — one-click na lokal na Redis, Cloudflare Workers / Deno Deploy relay deployers, Bifrost at Mux bilang mga supervised embedded service. → [Embedded Services](docs/frameworks/EMBEDDED-SERVICES.md) - **🧩 Kasama rin sa kahon** — plugin framework + marketplace, Omni/Agent/GitHub skills frameworks, Obsidian vault integration (22 MCP tools), OpenAI-compatible na Batch at Files APIs, semantic response cache, gamification na may mga leaderboard, ACP agent discovery (15 built-in na agent), naka-iskedyul na log export sa BigQuery, `auto/chaos` parallel multi-model fan-out, isang Telegram bot bridge, isang in-app na version manager at LMArena-ELO free-provider rankings. → [Docs](docs/README.md)

## 🤖 Mga Katugmang CLI at Coding Agent > Isang config — `http://localhost:20128/v1` — at **bawat** AI IDE o CLI ay gumagana sa mga libre at murang modelo.

_{Claude Code}	_{Codex CLI}	_Cline	_{Kilo Code}	_{Zoo Code}	_Continue
_Aider	_ForgeCode	_jcode	_{DeepSeek TUI}	_CodeWhale	_OpenCode
_{Factory Droid}	_{Copilot CLI}	_{Cursor CLI}	_Smelt	_Pi	_{Grok Build}
_{Hermes Agent}	_OpenClaw	_Goose	_{Open Interpreter}	_{Warp AI}	_deyin.ai

＋ gumagana rin sa · Agent Deck · Kiro · Command Code · Antigravity · Windsurf · AMP · anumang tool na katugma sa OpenAI

_{📖 Pag-setup sa bawat tool para sa lahat ng 37 tool (27 CLI Code + 10 CLI Agent) → [`docs/reference/CLI-TOOLS.md`](docs/reference/CLI-TOOLS.md) · 🧩 OpenCode plugin → [`@omniroute/opencode-provider`](https://www.npmjs.com/package/@omniroute/opencode-provider)}

**Ilunsad ang anumang sinusuportahang CLI sa pamamagitan ng OmniRoute gamit ang iisang command** — walang isinusulat na mga config file, ini-inject ang mga credential sa bawat proseso, at binibigyan ang Qwen/Gemini ng pansamantalang nakahiwalay na home: ```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" # O pumili ng provider+model nang interaktibo at isulat ang sariling config ng tool: omniroute configure codex # gayundin: claude opencode qwen aider goose gemini cline continue kilo 5dive ``` Sinusunod ng bawat command ang aktibong remote context (`omniroute connect `), ipinapakita muna ng `--dry-run` ang eksaktong env/args nang hindi isinasagawa ang mga ito, at pinapanatili ng `--api-key-env NAME` ang mga secret na wala sa iyong shell history. → [Mga Integrasyon ng CLI](docs/guides/CLI-INTEGRATIONS.md)

## 🌐 375 AI Provider — 153 Minarkahan ng Catalog bilang Libre

> **375 na rehistradong provider** sa mga canonical na koleksyon ng chat, media, search, local, cloud-agent at system, kabilang ang **153 na may dalang `hasFree: true` na discovery metadata**. Sakop ng chat model registry ang **239 provider / 3,059 natatanging provider-model pair / 1,475 raw model ID**; ang hiwalay na free-budget catalog ay may **467 per-model row**, **34 recurring pool** at **51 recurring/keyless na free-forever provider**. Magkaiba ang mga denominator na ito ayon sa disenyo; ang mga depinisyon at pool-deduped na kalkulasyon ay nasa [Provider Reference](docs/reference/PROVIDER_REFERENCE.md) at [Free Tiers](docs/reference/FREE_TIERS.md).

### 🏢 Bawat pangunahing lab — sa isang endpoint

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

_{…at 350+ pa — bawat icon ay live na nare-resolve mula sa provider catalog ng dashboard. 📖 [Provider Reference](docs/reference/PROVIDER_REFERENCE.md)}
### 🆓 Libre Magpakailanman — $0, walang card

OpenCode Zen _{DeepSeek V4, Nemotron 3 Walang limitasyon sa token}	Kilo Code _{Auto-router, Tencent Hy3 Libre magpakailanman}	Requesty _{GPT-OSS 120B, Nemotron Libre magpakailanman}	SiliconFlow _{DeepSeek V3.2 / R1 Libreng tier}	Z.AI GLM _{GLM-4.7 / 4.5-Flash Libre magpakailanman}	Baidu ERNIE _{ERNIE 4.0 Libre magpakailanman}
Qoder AI _{Qwen3-Max, Kimi-K2 Walang limitasyong LIBRE}	Pollinations _{GPT, Llama, Claude Hindi kailangan ng key}	Cloudflare AI _{50+ modelo 10K neuron/araw}	NVIDIA NIM _{GLM, MiniMax ~40 RPM libre}	Cerebras _{GLM 4.7, GPT-OSS Isang beses na $5 credit; kailangan ng card}	OpenRouter _{:free na mga modelo +$10 → mas mataas na RPM}

📖 Buong katalogong mababasa ng makina → [`docs/reference/PROVIDER_REFERENCE.md`](docs/reference/PROVIDER_REFERENCE.md)

## 🖥️ Saan Gumagana ang OmniRoute — Kahit Saan

> Parehong app, sarili mong makina, sarili mong mga tuntunin. Mula sa global na pag-install gamit ang npm hanggang sa **iyong telepono** sa pamamagitan ng Termux.

Platform	Pag-install	Mga Tampok
📦 npm (global)	`npm install -g omniroute`	Isang command, anumang OS
🐳 Docker	`docker run … diegosouzapw/omniroute`	Multi-arch na AMD64 + ARM64
🖥️ Desktop (Electron)	`npm run electron:build`	Native na window + system tray — Windows / macOS / Linux
🎩 Menu-bar (OmniRouteTray)	`brew install --cask zoispag/tap/omniroute-tray`	Sinusubaybayan at awtomatikong ina-update ang server — macOS
💪 ARM	native na `arm64`	Raspberry Pi, mga ARM server, Apple Silicon
📱 Android (Termux)	`pkg install nodejs && npx -y omniroute`	Gumagana sa iyong telepono, 24/7, walang root
📲 PWA	"Idagdag sa Home Screen"	Fullscreen, offline, maaaring i-install mula sa browser
🧩 OpenCode plugin	`@omniroute/opencode-provider`	Native na integrasyon sa OpenCode
🤖 VS Code Copilot Chat	i-install ang OmniCopilot extension	Lahat ng modelo ng OmniRoute sa native na Copilot Chat picker — stable at Insiders
🛠️ Mula sa source	`npm install && npm run dev`	Baguhin ito, mag-ambag

_{📖 [Gabay sa Docker](docs/guides/DOCKER_GUIDE.md) · [Desktop](electron/README.md) · [Menu-bar tray](https://github.com/zoispag/omniroute-tray) · [Termux](docs/guides/TERMUX_GUIDE.md) · [PWA](docs/guides/PWA_GUIDE.md) · [OpenCode](docs/frameworks/OPENCODE.md)}

### 🧩 Bago: OmniRoute sa loob ng native na Copilot Chat ng VS Code

> Walang bagong sidebar, walang bagong chat UI — bawat modelong inihahatid ng OmniRoute ay lalabas mismo sa > **Copilot Chat model picker na ginagamit mo na**. Mula sa VS Code 1.122, gumagana ang mga provider model > nang hindi kailangang mag-sign in sa GitHub o magkaroon ng Copilot subscription — agent mode, tool calling, at vision, > nang libre. I-install ang **[OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)** extension, ituro ito sa iyong OmniRoute server (default ang `localhost:20128`), pagkatapos ay buksan ang Copilot Chat → model picker → **Pamahalaan ang Mga Modelo…** → **OmniRoute**.

Store	Link	Gumagana sa
🧩 VS Code Marketplace	I-install →	VS Code — stable at Insiders
🔓 Open VSX Registry	I-install →	Cursor, Windsurf, VSCodium, Theia, code-server, Gitpod, Antigravity, Kiro…

Mula sa loob ng editor: buksan ang **Extensions** view, hanapin ang **"OmniRoute"**, at i-click ang **Install** — pareho ang paraan ng paggana sa dalawang store. Matatagpuan ang source, mga issue, at runbook sa pag-publish sa [diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot). _{📖 [Gabay sa VS Code Copilot Chat](docs/guides/VSCODE-COPILOT.md) — pag-setup, kung ano ang ipinapakita ng picker, dashboard-sa-isang-tab, pag-troubleshoot}

### 🎩 Bago: OmniRouteTray — ang iyong gateway na nasa menu bar

> Pinakamahusay na gumagana ang `omniroute serve` kapag palagi itong naka-on. Ginagawang set-and-forget na menu-bar app para sa macOS ng **[OmniRouteTray](https://github.com/zoispag/omniroute-tray)** > ang setup na iyon: sinisimulan nito ang server, pinananatili itong gumagana > sa bawat pag-reboot, ina-update ito nang hindi inililipat, at inilalagay ang iyong kasalukuyang token budget isang click lang ang layo — **walang > terminal window na kailangang manatiling bukas, walang `npm install -g omniroute` na kailangang bantayan.** Binuo gamit ang [Tauri v2](https://v2.tauri.app/) (isang Rust core na napakaliit), kasama rito ang sarili nitong signed na Node 24 runtime at pinamamahalaan nito ang pag-install ng OmniRoute na pag-aari ng app, kaya hindi ito kailanman sumasalungat sa iyong global na `node`/`bun`. **Ibinabahagi nito ang kasalukuyan mong `~/.omniroute/` config at database** — kaya ito rin ang OmniRoute na ginagamit mo na, ngunit may suot lamang na sombrero. 🎩

Ano ang ginagawa nito	Paano
🟢 Sinusubaybayan ang server	Inilulunsad ang `omniroute serve` at ginagamit ang tumatakbo nang instance sa halip na gumawa ng duplicate nito
📊 Aktuwal na paggamit sa isang tingin	Mga quota bar ng provider, mga limitasyon ng Claude session/lingguhan na may countdown bago mag-reset, at 30-araw na breakdown ng gastos
🔄 Awtomatikong nag-a-update nang hindi inililipat	Staged na pag-install, atomic swap, rollback kapag nabigo — palaging nasa pinakabagong release
🚀 Simulan sa pag-login	Opsyonal na paglunsad sa pag-login; tray lamang, walang dock icon
🩺 Doctor at mga log	Isang-click na diagnostics at access sa mga server log

```sh brew install --cask zoispag/tap/omniroute-tray ``` _{Mas gusto mong mag-download? Kunin ang pinakabagong .dmg mula sa
Mga Release. Ang source, mga issue, at dokumentasyon sa build ay
makikita sa zoispag/omniroute-tray.

💛 Isang proyektong pangkomunidad ni @zoispag — hindi isang opisyal na release ng OmniRoute.}

## 🔒 Pribado at Lokal Muna

_{📖 [Awtorisasyon](docs/architecture/AUTHZ_GUIDE.md) · [Mga Pananggalang](docs/security/GUARDRAILS.md) · [Pagsunod](docs/security/COMPLIANCE.md)}

## 🔌 Kumpletong CLI + A2A at MCP

> Bukod sa server, ang OmniRoute ay isang **kumpletong command-line cockpit** na may **80+ command**, pati mga bukas na protocol para makontrol ito ng isang AI agent nang **mag-isa**. ### ⌨️ Isang tunay na CLI (hindi lang `start`) ```bash omniroute # patakbuhin ang gateway + dashboard (port 20128) omniroute chat # interaktibong TUI chat client (slash: /model /combo /skill /memory) omniroute setup # ginabayang wizard para sa unang pagpapatakbo omniroute doctor # suriin ang mga provider, port, at native dependency ``` ### 🛰️ Remote mode — patakbuhin ang CLI rito, at ang OmniRoute sa isang VPS Nasa isang server ang OmniRoute? Kontrolin ito mula sa iyong laptop gamit ang **parehong CLI**. Mag-log in nang isang beses gamit ang scoped access token; pagkatapos, ang bawat command ay itutuon sa remote. ```bash omniroute connect 192.168.0.15 # password → scoped token, sine-save bilang isang context omniroute models # ← tumatakbo laban sa REMOTE server omniroute configure codex # ← pumipili ng remote model, nagsusulat ng lokal na Codex profile omniroute tokens create --name ci --scope read # gumawa ng mas limitadong mga token para sa ibang machine omniroute contexts use default # ← bumalik sa lokal na server ``` May scope na `read` / `write` / `admin` ang mga token; nananatiling loopback-only ang mga route na naglulunsad ng process. _{📖 [Remote Mode](docs/guides/REMOTE-MODE.md)}

Animated na terminal na nagde-demo ng OmniRoute CLI — omniroute providers list, omniroute combo list at omniroute health — umiikot sa 89-command na top-level surface: providers · oauth · keys · combo · nodes · models · cache · compression · cost · usage · quota · health · resilience · telemetry · logs · audit · mcp · a2a · cloud · memory · skills · eval · tunnel · backup · sync · webhooks · policy · pricing · translator · simulate …

### 🤝 Ikonekta ang isang agent — at kokontrolin nito mismo ang OmniRoute Ilantad ang OmniRoute sa pamamagitan ng **MCP**, **A2A**, isang **REST API**, mga **webhook**, o isang **remote CLI** — makukuha ng anumang may kakayahang agent (o ng sarili mong code) ang mga susi sa buong gateway: routing, mga provider, combo, cache, compression, memory — nang awtonomo. Inihahatid ang mga HTTP endpoint sa ibaba sa ilalim ng `http://localhost:20128`.

Interface	Endpoint / command	Gamitin ito para sa
🧰 MCP (stdio)	`omniroute --mcp`	Ikonekta sa Claude Desktop, Cursor, o anumang MCP client
🌊 MCP (HTTP)	`/api/mcp/stream`	Remote MCP — 110 tool, 33 scope (opsyonal ang pagpapatupad), kumpletong audit trail
📡 MCP (SSE)	`/api/mcp/sse`	Streaming na MCP transport
🤝 A2A	`/.well-known/agent.json`	Agent-to-agent, JSON-RPC 2.0 + SSE, 6 na skill
🌐 REST API	`/v1/*`	Compatible sa OpenAI — chat, embedding, larawan, audio, OCR
🔔 Mga Webhook	`/api/webhooks`	Mag-push ng mga request / quota event sa Slack, Discord, Telegram, o anumang URL
🛰️ Remote CLI	`omniroute connect`	Kontrolin ang isang remote instance gamit ang mga scoped access token

```bash # Ibigay sa Claude Code ang kumpletong toolset ng OmniRoute sa pamamagitan ng MCP: claude mcp add-server omniroute --type http --url http://localhost:20128/api/mcp/stream ``` _{📖 [MCP Server](docs/frameworks/MCP-SERVER.md) · [A2A Server](docs/frameworks/A2A-SERVER.md) · [Mga Protocol ng Agent](docs/frameworks/AGENT_PROTOCOLS_GUIDE.md)}

## 🗜️ Makatipid ng 15–95% na Token — Awtomatiko

### 📖 Paano ito gumagana — pipeline, arkitektura at matematika ng pagtitipid

OmniRoute compression pipeline: isang ilustratibong 10,000-token na kahilingan ng client ang dumadaan sa 12 na composable engine — Session-Dedup, CCR, Lite, RTK, Responses Tool Output, Headroom, Relevance, Caveman, Aggressive, LLMLingua-2, Ultra at OmniGlyph — at maaaring umabot sa provider sa humigit-kumulang 1,080 token sa dokumentadong stacked na halimbawa. Ang structured na nilalaman ay pinoprotektahan ng preservation guards at per-step fidelity gates; ang tahasang lossy o experimental na mga mode ay maaaring mag-transform ng karapat-dapat na nilalaman.

Ang default na stacked combo ay nagpapatakbo ng `RTK → Caveman`. Kapag pareho silang gumagana sa parehong tool/context payload, nagpapatong ang pagtitipid: ```txt combined = 1 − (1 − RTK) × (1 − Caveman_input) average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2% range = 78.4 – 94.6% ``` Ang mga code block, URL, JSON at structured data ay **laging protektado** ng preservation engine. > **Bakit gagamit ng maraming token kung kaya namang gawin ng kaunting token?** Ang bawat kahilingan ay dumadaan sa compression pipeline ng OmniRoute nang **transparent** — walang pagbabago sa client. Ito na ngayon ay isang **stack ng 12 composable engine** na tumatakbo nang sunud-sunod at nagmi-mix & match per routing combo — nakaugat sa mga ideya mula sa [RTK](https://github.com/rtk-ai/rtk), [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ 90K+), [LLMLingua-2](https://github.com/microsoft/LLMLingua), at [Troglodita](https://github.com/leninejunior/troglodita) (PT-BR). ### 🧱 Ang stack na may 12 engine Tumatakbo ang mga engine sa ayos ng pipeline; ang bawat isa ay malayang ma-toggle at ma-configure per combo:

#	Engine	Ano ang ginagawa nito
1	Session-Dedup	Inaalis ang nilalamang paulit-ulit sa mga turn (content-addressed, cross-turn)
2	CCR	Ina-archive ang malalaking block sa likod ng retrieve markers, kinukuha kapag kailangan
3	Lite	Pag-trim ng whitespace + image-URL (latency-light na baseline)
4	RTK	Matalinong pag-filter ng tool-result, dedup at truncation (command-aware)
5	Responses Tool Output	Lossless-first na JSON + bounded diagnostic compression para sa shell/patch/search/build output (Responses API)
6	Headroom	Lossless na tabular compaction ng JSON arrays (~30%) gamit ang vendored na GCF codec
7	Relevance	Extractive na pag-score ng pangungusap laban sa huling query ng user
8	Caveman	Rule-based na prose compression (~65–75% sa output)
9	Aggressive	Summarization + progresibong pagtanda ng lumang turn
10	LLMLingua-2	ML semantic pruning sa pamamagitan ng MobileBERT ONNX — code-safe, async
11	Ultra	Heuristic token pruning na may opsyonal na small-model (SLM) tier
12	OmniGlyph	Experimental na context-as-image encoding para sa sinukat na Claude Fable 5 sa direktang Anthropic wire; ang GPT 5.6 transformers ay nananatiling fail-closed habang hinihintay ang provider receipts. Apat na compression profile (aggressive default, balanced, coding-safe, passthrough) (pinaka-agresibo; opt-in)

Ang mga code block, URL at structured data ay **laging pinapanatili** nang byte-perfect. Pinagsasama ng **one-click preset** ang mga engine:

Mode	Tipid	Pinakamainam para sa
🪶 Lite	~15%	Ligtas na default na laging naka-on
🪨 Standard (Caveman)	~30%	Araw-araw na coding
⚡ Aggressive	~50%	Mahabang session na maraming tool
🔥 Ultra	~75%	Pinakamataas na pagtitipid
🧰 RTK	60–90%	Output ng shell/test/build/git
🔗 Stacked (RTK → Caveman)	78–95%	Halong prompt + tool log

**Tunay na halimbawa — Standard mode:** > **Bago (69 token):** _"Malamang na ang dahilan kung bakit nagre-render muli ang iyong React component ay dahil gumagawa ka ng bagong object reference sa bawat render cycle. Kapag nagpasa ka ng inline object bilang prop, nakikita ito ng shallow comparison ng React bilang ibang object sa bawat pagkakataon, na nagti-trigger ng re-render. Inirerekomenda kong gamitin ang useMemo para i-memoize ang object."_ > > **Pagkatapos (19 token):** _"Bagong object ref bawat render. Inline object prop = bagong ref = re-render. I-wrap sa useMemo."_ > > **Parehong sagot. 72% mas kaunting token. Walang pagkawala ng accuracy.** ✅ **Halimbawang PT-BR — mode na [Troglodita](https://github.com/leninejunior/troglodita):** > **Bago (42 tokens):** _"Ang problema ay nagre-render muli ang component dahil isang bagong object reference ang ginagawa sa bawat render cycle. Irerekomenda ko ang paggamit ng `useMemo`."_ > > **Pagkatapos (12 tokens):** _"Re-render: bagong ref bawat cycle (inline object na ginagawa muli). Gamitin ang `useMemo`."_ > > **Parehong sagot. ~70% mas kaunting tokens. Buo ang teknikal na katumpakan.** ✅
### 🎚️ Higit pa sa mga engine — mga output style, ang adaptive dial at per-request na kontrol Binabawasan ng 12 engine sa itaas ang pumapasok. Tatlong karagdagang layer ang humuhubog sa **paano**, **kailan**, at kung ano ang **lumalabas**: - **🪄 Output Styles** _(pag-steer sa output-axis)_ — nag-inject ng deterministic, cache-safe na mga instruksiyon sa paghubog ng sagot; mapagsasama, bawat isa sa `lite` / `full` / `ultra` na intensity. Ang pagdaragdag ng style ay isang linyang registry entry: - **Terse prose** — alisin ang filler / articles / hedging; panatilihing eksakto ang teknikal na substansiya. - **Less code** — "lazy senior dev" na YAGNI: pinakamaliit na gumaganang pagbabago, walang hindi hinihinging scaffolding. - **Ponytail (lazy senior dev)** — akyatin ang YAGNI ladder, ayusin ang root cause, pinakamaliit na gumaganang diff. - **I have ADHD (action-first)** — nauuna ang susunod na aksyon, may bilang ang mga hakbang, isang konkretong susunod na hakbang, walang preamble. - **Terse CJK (文言)** — klasikal na Chinese na ultra-terse na estilo (naka-locale sa `zh`). - **🎯 Adaptive context-budget** _(ang dial)_ — sa halip na isang on/off na token threshold, i-escalate ang pinakamura at pinakawalang-loss na mga engine hanggang sa kinakailangan lang para **magkasya sa context window ng modelo**. Policy: `reserve-output` (default, model-aware) · `percentage` · `absolute`. Mode: `floor` (garantiyahan ang fit) · `replace-autotrigger` (mananalo ang iyong tahasang pinili) · `off` (legacy threshold). - **🎛️ Saan nagpapasya ang compression** _(precedence, mataas → mababa)_ — per-request `x-omniroute-compression` header › routing-combo override › aktibong named profile › adaptive / auto-trigger › panel default › off. Ang inilapat na plano ay ibinabalik sa `X-OmniRoute-Compression: ; source=` response header. Mag-auto-trigger sa token threshold, i-on ang adaptive dial, i-pin ang isang named profile, magtakda ng one-off per request, o magtalaga ng pipeline per routing combo — kung alin ang bagay sa workload. Isang opt-in na offline **eval harness** (`npm run eval:compression`) ang nagsusuri ng fidelity vs. savings sa isang naka-pin na corpus bago mo i-promote ang isang pagbabago. 📖 [`COMPRESSION_GUIDE.md`](docs/compression/COMPRESSION_GUIDE.md) · [`RTK_COMPRESSION.md`](docs/compression/RTK_COMPRESSION.md) · [`COMPRESSION_ENGINES.md`](docs/compression/COMPRESSION_ENGINES.md)

# ⚡ Mabilis na Simula

**1) I-install at patakbuhin** ```bash npm install -g omniroute omniroute ``` > 💡 Nakikita mo ang `npm warn ERESOLVE` o peer-dep warnings? [Hindi sila mapanganib](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated). > **Gumagamit ng npm 11 o mas bago?** Maaaring harangin ng npm ang mga package lifecycle script maliban kung pinapayagan ang mga ito. Kinakailangan ang `postinstall` ng OmniRoute (`node scripts/build/postinstall.mjs`) para ihanda ang mga native runtime file nito. Payagan ang mga package na pinangalanan sa warning ng npm kapag nag-i-install nang global. Para sa package set na iniulat ng OmniRoute 3.8.53: > > ```bash > npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute > ``` > > Para magamit muli ang allowlist na ito para sa mga susunod na global install, i-configure ito nang isang beses, pagkatapos ay mag-install nang normal: > > ```bash > npm config set allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild --location=user > npm install -g omniroute > ``` > > Maaaring magbago ang dependency list sa pagitan ng mga release; kung iba ang iniulat ng npm na listahan, gamitin ang mga pangalan ng package mula sa warning na iyon. Ang pagpayag sa isang package ay nagpapahintulot sa mga install script nito na tumakbo. > **Gumagamit ng Gemini Web o ibang web-cookie provider?** Kasama sa npm package ang Playwright pero hindi ang Chromium binary nito. Tingnan ang [Playwright Chromium setup](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium) na tala bago gawin ang unang web-provider request. Dashboard sa `http://localhost:20128` · API sa `http://localhost:20128/v1`. **2) Ikonekta ang isang karapat-dapat na provider gamit ang sarili mong account** Dashboard → **Providers** → pumili ng provider na ang kasalukuyang terms at quota ay bagay sa iyong use case → idagdag ang API key nito o kumpletuhin ang account flow nito. Maaaring mangailangan ang mga free tier ng signup, approval, o payment method. Repasuhin ang [Free Tiers Guide](docs/getting-started/FREE-TIERS-GUIDE.md); hindi garantisado ang keyless availability, at ang mga provider na may markang `tos: avoid` ay hindi kasama sa `auto` bilang default. **3) Ituro ang iyong coding tool** ```txt Base URL: http://localhost:20128/v1 API Key: [copy from Dashboard → Endpoints] Model: auto (routes among eligible connections — or choose provider/model) ``` **4) I-verify na gumagana ito** ```bash curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY" ``` Dapat mong makita ang mga nakakonektang modelo na nakalista. 🎉 Iyon na — magsimulang mag-code, at awtomatikong nag-a-auto-route at nag-fa-fallback ang OmniRoute para sa iyo. Kung hindi makapagpadala ang iyong client ng custom header, naglalabas din ang OmniRoute ng tokenized compatibility aliases: ```txt OpenAI catalog: http://localhost:20128/vscode/YOUR_KEY/ OpenAI models: http://localhost:20128/vscode/YOUR_KEY/models OpenAI chat: http://localhost:20128/vscode/YOUR_KEY/chat/completions OpenAI responses: http://localhost:20128/vscode/YOUR_KEY/responses Ollama chat: http://localhost:20128/vscode/YOUR_KEY/api/chat Ollama tags: http://localhost:20128/vscode/YOUR_KEY/api/tags ``` Gamitin lamang ang mga ito para sa mga client na hindi makakabit ng `Authorization: Bearer ...`. Ang header auth pa rin ang ginustong mode.
## 📦 Higit pang paraan ng pag-install — Docker, source, 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 ``` Sinusundan ng `:latest` ang pinakamataas na **na-publish** na stable na SemVer. Hindi nito sinusubaybayan ang git `main`. I-pin ang `:X.Y.Z` para sa GitOps. Tingnan ang [Mga Channel ng Release ng Docker](docs/guides/DOCKER_GUIDE.md#release-channels). Naka-pin sa image ang **`OMNIROUTE_MEMORY_MB=1024`**. Sapat iyon para sa dashboard at magaan na chat. Nangangailangan ang mga **coding agent** (`POST /v1/responses` mula sa Claude Code, Codex, Grok, …) ng mas malaking V8 heap, kung hindi ay magkakaroon ng `FATAL ERROR` ang proseso sa ~12 GiB kapag may dalawang magkapatong na mahabang context. Maglaan sa container ng higit sa laki ng heap (nasa labas ng V8 ang mga native buffer): | Workload | Heap (`-e OMNIROUTE_MEMORY_MB`) | Container (`--memory`) | | ------------------------------------------ | ------------------------------- | ---------------------- | | Dashboard / magaan na chat | `1024` (default ng image) | ≥2 g | | Isang coding agent | `8192` | ≥10 g | | Dalawang sabay na mahabang `/v1/responses` | `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 ``` Buong talahanayan: [Gabay sa Docker — runtime RAM](docs/guides/DOCKER_GUIDE.md#runtime-ram-for-coding-agents). > **Pre-release na channel ng Docker:** Sinusundan ng `diegosouzapw/omniroute:next` at > `diegosouzapw/omniroute:next-web` ang kasalukuyang default na branch na `release/v*`. > Ang mga nababagong tag na ito ay inilaan lamang para sa pagsubok ng mga hindi pa > nailalabas na pag-aayos at **hindi sinusuportahan para sa production**. Tingnan ang > [Mga Channel ng Release ng Docker](docs/guides/DOCKER_GUIDE.md#release-channels). **🥟 Bun** Sinusuportahan ang karaniwang `bun install` at global na pag-install (`bun install -g omniroute`) sa pamamagitan ng pagtukoy sa Bun runtime: - **Built-in na `bun:sqlite`**: Ginagamit ng OmniRoute ang built-in na `bun:sqlite` driver ng Bun kapag tumatakbo sa Bun, at bumabalik sa `better-sqlite3` sa Node.js o `sql.js`. - **Awtomatikong pagpili ng Webpack bundler sa dev**: Awtomatikong tinutukoy ng development (`bun run dev`) ang Bun at dini-disable ang Turbopack pabor sa Webpack upang maiwasan ang mga incompatibility sa native V8 binding. Eksaktong sinusunod ng mga production build (`bun run build`) ang `OMNIROUTE_USE_TURBOPACK` gaya sa Node: Turbopack bilang default, `OMNIROUTE_USE_TURBOPACK=0` upang mag-build gamit ang Webpack (inilalantad ito ng `Dockerfile.bun` bilang `--build-arg`). - **Nakalaang Bun Dockerfile**: Multi-stage na `Dockerfile.bun` para sa mga native na Bun production deployment (`docker build -f Dockerfile.bun -t omniroute:bun .`). ```bash # Mag-install at patakbuhin gamit ang Bun bun install bun run dev ``` **🛠️ Mula sa source** ```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 # Gamit ang mga Nix flake nix develop npm run dev # O gamit ang devbox devbox run npm run dev ``` 📖 [Gabay sa Docker](docs/guides/DOCKER_GUIDE.md) — Mga Compose profile, Caddy HTTPS, mga Cloudflare tunnel. **🦭 Podman** ```bash # 1. Ihanda ang bind-mounted na data directory mkdir -p data # 2. Para lamang sa Linux + lokal na rootless Podman (huwag kailanman sa remote na Podman Machine client): podman unshare chown 1000:1000 ./data # 3. Itakda ang runtime hint, buuin ang lokal na Compose image, at simulan echo "CONTAINER_HOST=podman" >> .env podman compose --profile base up -d --build ``` Sa macOS o Windows, gumagamit ang Podman ng remote na Podman Machine: laktawan ang `podman unshare` at sundin ang [gabay sa data directory na partikular sa topology](contrib/podman/README.md#data-directory-permissions-by-topology). 📖 [Gabay sa Podman](contrib/podman/README.md) — Mga Compose build, Podman Machine, at pag-setup ng Linux/systemd Quadlet. **⚡ Mas mabilis / mas magaan na pag-install (laktawan ang native build)** Ang native na SQLite engine (`better-sqlite3`) ay isang **opsyonal** na dependency, kaya ang global na pag-install ay hindi kailanman mahahadlangan ng pag-compile mula sa source: gumagamit ito ng prebuilt binary kapag may tumutugma sa iyong platform/Node, at kung wala ay awtomatikong bumabalik sa isang pure-JS engine (`node:sqlite` sa Node 22+, o kung hindi ay ang kasamang `sql.js` WASM) — walang kinakailangang build tool. Upang ganap na laktawan ang native warm-up pagkatapos ng pag-install (CI, headless, o mababagal na machine): ```bash OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute # Nilalaktawan din ito ng CI=1 ``` Para sa pinakamabilis na pag-install, piliin ang **pnpm** (content-addressed store + mga hard link — tingnan sa itaas). Para sa headless runtime na walang dashboard, gamitin ang Docker `base` profile (sa itaas) o ang [gabay sa Termux](docs/guides/TERMUX_GUIDE.md). Inihahatid ng iisang proseso sa iisang port ang CLI at web dashboard, kaya walang hiwalay na CLI-only package sa kasalukuyan.

# 🎬 Aktuwal na Paggamit sa OmniRoute

## 📹 Mga Gabay sa Video

_{Snapshot ng dashboard noong 2026-10-18 · Hilaw na katalogo: YT 1.352 | TT 334 | IG 290 · Pagiging bago (mga araw): YT 5 | TT 48 | IG 49}

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

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

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

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

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

**Kumpletong ranggo (mga na-deduplicate na canonical URL, `v > 0`, pinakamalawak na abot):** | #1 | #2 | #3 | #4 | #5 | | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | | [nick_saraev — Instagram](https://www.instagram.com/reel/Da8ZthUPK98/) — **3,042,474** | [nnapier7 — Instagram](https://www.instagram.com/reel/Dbp7wv_CIO0/) — **1,454,535** | [Amidia AI & Tech — YouTube](https://www.youtube.com/watch?v=NJ0TQ-pyMDY) — **794,974** | [theopenstack — Instagram](https://www.instagram.com/reel/DaSs65mMrHk/) — **692,419** | [migue.baena — TikTok](https://www.tiktok.com/@migue.baena/video/7670919268216622358) — **685,788** | | #6 | #7 | #8 | #9 | #10 | | ------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | | [milesreevesai — TikTok](https://www.tiktok.com/@milesreevesai/video/7667980059189366019) — **620,400** | [nikothetech — TikTok](https://www.tiktok.com/@nikothetech/video/7671890769665477918) — **610,803** | [Vaibhav Sisinty — YouTube](https://www.youtube.com/watch?v=QucgvbO5gsM) — **509,281** | [buildwithai.club — Instagram](https://www.instagram.com/reel/DbIt9AjK7-U/) — **347,652** | [nivedan.ai — Instagram](https://www.instagram.com/reel/DbIrCksJiqq/) — **331,973** | Mga canonical na sukatan noong 2026-10-18: **1.976 natatanging video** · **20.220.289 kilalang panonood** (`v > 0`) · **1.210 channel/profile ayon sa network**. Naglalaman ang hilaw na dashboard ng 1.976 linya (YouTube 1.352 = 740 mahahabang video + 612 Shorts · TikTok 334 · Instagram 290); walang natirang duplicate pagkatapos ng normalisasyon ayon sa canonical URL, na nagpapanatili ng pinakamataas na bilang para sa bawat video. Naka-freeze ang pangongolekta mula sa YouTube noong 2026-10-13 (naubos ang quota ng API mula 14 hanggang 18/10), at ang TikTok/Instagram naman mula 2026-09-02 (walang credit para sa pangongolekta); 76 na video ang wala pa ring bilang ng panonood. > 🎬 **Gumawa ka ba ng video tungkol sa OmniRoute?** Magbukas ng [issue](https://github.com/diegosouzapw/OmniRoute/issues/new) o [discussion](https://github.com/diegosouzapw/OmniRoute/discussions) na may kasamang link — itatampok namin ito rito.

# 📧 Komunidad at Tulong > Lahat ay nasa iisang lugar — sundan ang maintainer, makipag-chat sa komunidad, o magbukas ng issue. | Channel | Saan / paano | | ------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- | | 💼 **LinkedIn** — sundan ang maintainer | [linkedin.com/in/diegosouzapw](https://www.linkedin.com/in/diegosouzapw/) | | 🐙 **GitHub** — sundan para sa mga release at tip | [@diegosouzapw](https://github.com/diegosouzapw) | | 💬 **Discord** | [discord.gg/U47eFqAXCn](https://discord.gg/U47eFqAXCn) | | ✈️ **Telegram** | [t.me/omnirouteOficial](https://t.me/omnirouteOficial) | | 🟢 **WhatsApp — 🌍 Pandaigdigan** | [sumali sa grupo](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) | | 🟢 **WhatsApp — 🇧🇷 Brazil** | [sumali sa grupo](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) | | 🌍 **Website** | [omniroute.online](https://omniroute.online) | | 🌍 **🌍Komunidad ng StHub OmniRoute (libre)** | [portal ng StHub](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK) | | 📦 **Source code** | [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute) | | 🐛 **Mag-ulat ng bug** | [magbukas ng issue](https://github.com/diegosouzapw/OmniRoute/issues) — ilakip ang output ng `npm run system-info` | | 🤝 **Mag-ambag** | [CONTRIBUTING.md](CONTRIBUTING.md) · [Modelo ng Branching at Release](docs/ops/BRANCHING_MODEL.md) · pumili ng `good first issue` | | 💚 **Suportahan ang proyekto** | [Mga paraan upang sumuporta ↑](#-support-omniroute) · [GitHub Sponsors](https://github.com/sponsors/diegosouzapw) |

---

## 🛠️ Mga Teknolohiyang Ginagamit

Antas	Teknolohiya
Runtime	Node.js 22.x / 24.x LTS — `>=22.22.2 <23 \|\| >=24.0.0 <27`
Wika	TypeScript 6.0 — 100% TypeScript sa buong `src/` at `open-sse/` (walang `any` sa core mula noong v2.0)
Framework	Next.js 16 + React 19 + Tailwind CSS 4
Database	better-sqlite3 (SQLite, WAL journaling) + LowDB (JSON legacy) — 147 na domain module, 209 na migration
Memory	SQLite FTS5 full-text + int8-quantized vector embeddings, typed decay
Mga Schema	Zod 4 — MCP tool I/O validation + mga kontrata ng API
Mga Protocol	MCP (stdio / HTTP / SSE) + A2A v0.3 (JSON-RPC 2.0 + SSE)
Streaming	Server-Sent Events (SSE) + tulay na WebSocket (`/v1/ws`)
Compression	Pipeline na may 12 engine — RTK, Caveman, LLMLingua-2 (MobileBERT ONNX), GCF, OmniGlyph
Auth at seguridad	OAuth 2.0 (PKCE) + JWT + API Keys + MCP scoped auth · AES-256-GCM kapag nakaimbak · DOMPurify
Stealth	wreq-js — JA3 / JA4 TLS fingerprint impersonation, proxy na may 3 antas
Resilience	Circuit breaker, exponential backoff, anti-thundering-herd, auto-combo self-healing
Logging	pino — naka-istrukturang JSON log na may konteksto ng request
Testing	Node.js test runner + Vitest — 56,000+ static test declarations sa 7,800+ na sinusubaybayang test file (unit, integration, E2E, security, ecosystem)
Mga Platform	Desktop (Electron) · Android (Termux) · PWA (anumang browser)
CI/CD	GitHub Actions — auto npm publish + Docker Hub kapag may release
Mga Link	Website · npm · Docker Hub

## 📖 Dokumentasyon

### 📘 Pagsisimula

Dokumento	Paglalarawan
Gabay sa Paggamit	Mga provider, combo, integrasyon ng CLI, deployment
Gabay sa Setup	Kumpletong mga paraan ng pag-install, mga config ng CLI tool, setup ng protocol, pag-tune ng timeout
Gabay sa mga CLI Tool	Setup kada tool para sa Claude Code, Codex, Cursor, Cline, OpenClaw, Kilo, Copilot
Remote Mode	Patakbuhin ang remote na OmniRoute (VPS) mula sa iyong laptop CLI gamit ang mga scoped access token
Config ng Claude Code	Ituro ang Claude Code sa OmniRoute (local/remote) gamit ang `launch` + mga profile kada modelo
Mabilisang Simula	3-hakbang na install → connect → configure

### 🔧 Mga Operasyon at Deployment

Dokumento	Paglalarawan
Gabay sa Docker	Docker run, mga Compose profile, Caddy HTTPS, mga tunnel, mga image tag
Gabay sa Podman	Integrasyon ng Quadlet systemd, podman-compose, SELinux
Deployment sa VM	Kumpletong gabay: setup ng VM + nginx + Cloudflare
Deployment sa Fly.io	I-deploy sa Fly.io na may persistent na storage
Gabay sa Termux	Patakbuhin ang OmniRoute sa Android gamit ang Termux
Gabay sa PWA	Pag-install ng Progressive Web App, caching, arkitektura
Gabay sa Pag-uninstall	Malinis na pagtanggal para sa lahat ng paraan ng pag-install
Config ng Environment	Kumpletong mga variable at reference ng `.env`

### 🧠 Mga Feature at Arkitektura

Dokumento	Paglalarawan
Arkitektura	Arkitektura ng sistema, daloy ng data, at mga internal
Gabay sa Compression	7-option na pipeline: off / lite / standard / aggressive / ultra / RTK / stacked
RTK Compression	Pag-compress ng command output, mga filter, trust, verify, pag-recover ng raw output
Mga Compression Engine	Caveman, RTK, mga stacked pipeline, mga surface ng dashboard/API/MCP
Format ng mga Compression Rule	Mga JSON rule-pack schema para sa Caveman at RTK filter
Mga Compression Language Pack	Pag-detect ng wika at pag-author ng Caveman rule-pack
Gabay sa Resilience	Mga circuit breaker, cooldown, queue, anti-thundering herd, TLS spoofing
Auto-Combo Engine	16-factor na scoring, mga mode pack, self-healing
Gabay sa Proxy	3-level na proxy system, 1proxy marketplace, registry CRUD
Mga Free Tier	Pinagsamang direktoryo: 34 na dokumentadong recurring pool / 467 na naka-catalog na free-tier entry
Galeri ng mga Feature	Biswal na paglilibot sa dashboard na may mga screenshot
Dokumentasyon ng Codebase	Walkthrough ng codebase na madaling maintindihan ng baguhan

### 🤖 Mga Protocol at API

Dokumento	Paglalarawan
Reference ng API	Lahat ng endpoint na may mga halimbawa
OpenAPI Spec	Espesipikasyon ng OpenAPI 3.0
MCP Server	110 MCP tool, mga config ng IDE, mga client na Python/TS/Go
Gabay sa MCP Server	Pag-install ng MCP, mga transport, at reference ng tool
A2A Server	JSON-RPC 2.0 protocol, mga skill, streaming, pamamahala ng task
Gabay sa A2A Server	A2A agent card, mga task, skill, at streaming

### 📋 Proyekto at Kalidad

Dokumento	Paglalarawan
Pag-aambag	Pag-setup at mga alituntunin sa pag-develop
Modelo ng Branching at Release	Kung saan nakatuon ang mga PR (`release/*`), at kung ano ang ibig sabihin ng `main` at mga tag
Talaan ng mga Pagbabago	Kumpletong kasaysayan ng release para sa bawat bersyon
Patakaran sa Seguridad	Pag-uulat ng mga kahinaan at mga kasanayan sa seguridad
Gabay sa i18n	Suporta sa 67 wika, daloy ng trabaho sa pagsasalin, RTL
Checklist ng Release	Mga hakbang sa pagpapatunay bago ang release
Plano sa Coverage	Estratehiya sa test coverage para sa 56,000+ static na deklarasyon ng test sa 7,800+ sinusubaybayang test file

# ⭐ Mga Nangungunang Contributor > Ang OmniRoute ay hinuhubog ng isang masigasig na open-source na komunidad. Ang mga indibidwal na ito ay gumawa ng mga natatanging kontribusyon na direktang nakaaapekto sa kalidad, katatagan, at abot ng proyekto. **Maraming salamat.** ### Mga panlabas na contributor ayon sa mga na-merge na pull request

Ranggo	Contributor	Mga Na-merge na PR	~Mga Nabagong Linya
1	maxmad64bis	371	25,326,561
2	HouMinXi	269	13,456,272
3	backryun	210	270,562
4	oyi77	190	411,243
5	pacocartones	174	78,276
6	JxnLexn	151	3,562,936
6	KooshaPari	151	5,972,314
8	rdself	145	80,663
9	RaviTharuma	123	500,065
10	herjarsa	88	230,872
11	hartmark	84	2,849,554
12	jonlwheat2-gif	67	68,548
13	artickc	62	43,502
14	chirag127	52	6,661
15	xz-dev	50	245,976
16	xiaoyaner0201	47	33,626
17	woodsonl	46	809,391
18	rqzbeh	44	147,896
19	QuangBlue	43	13,112
20	MumuTW	40	26,093

_{Isinagawa ang census noong 2026-10-18 15:09:09 UTC gamit ang pinakabagong tip ng release/v3.8.52 na 656f01cb43. Naglalaman ang naka-page na census ng GitHub GraphQL ng 9,191 na na-merge na PR: 3,834 mula sa may-ari ng repository, 229 mula sa Dependabot, 6 mula sa iba pang mga bot/app, at 5,122 panlabas na PR mula sa 835 natatanging contributor. Ang “Mga nabagong linya” ay mga pagdaragdag + pagbubura sa GitHub at kabilang dito ang mga nabuong file, lockfile, catalog, pagsasalin, at dokumentasyon; ito ay dami ng pagbabago, hindi LOC na aktuwal na isinulat. Nag-uulat ang 49 na PR ng mga diff sa GitHub na lampas sa 500,000 linya (halimbawa, ang #13399, isang pagdaragdag ng provider, ay naglilista ng 2,347 nabagong file), na nagpapalaki sa ilan sa mga kabuuang bilang sa itaas. Magkakapareho ang ranggo ng mga tabla.} ### Mga commit na iniuugnay ng GitHub

Dizzle _{🥇 367 na commit na naka-attribute sa GitHub}	Bob.Hou _{🥈 269 na commit na naka-attribute sa GitHub}	Paijo _{🥉 229 na commit na naka-attribute sa GitHub}	backryun _{🏅 202 na commit na naka-attribute sa GitHub}	Paco Cartones _{🏅 174 na commit na naka-attribute sa GitHub}	Ravi Tharuma _{🏅 126 na commit na naka-attribute sa GitHub}
Markus Hartung _{🏅 114 na commit na naka-attribute sa GitHub}	Randi _{🏅 108 na commit na naka-attribute sa GitHub}	Jan Leon _{🏅 87 na commit na naka-attribute sa GitHub}	Chris _{🏅 70 na commit na naka-attribute sa GitHub}	Koosha Paridehpour _{🏅 68 na commit na naka-attribute sa GitHub}

_{Muling sinuri noong 2026-10-18 14:44:45 UTC: mga commit na naka-attribute sa GitHub na iniulat ng Contributors API ng repository para sa `release/v3.8.52` default branch. Nagbalik ang API ng 849 na identity (429 na user, 2 bot, 418 anonymous); hindi kasama sa table na ito ang maintainer, mga bot, at mga anonymous na identity at pinapanatili ang mga tie sa kompetisyon. Naiiba ito sa parehong ranking ng merged-PR sa itaas at sa census ng Git-metadata sa ibaba.} > 🙏 Ang mga feature, bug fix, at pagpapahusay sa infrastructure ng mga contributor na ito ay **pangunahing bahagi** ng dahilan kung bakit maaasahan at puno ng feature ang OmniRoute. Mahalaga ang bawat pull request, bawat test case, at bawat i18n translation file. Ang open source ay binubuo ng mga taong tulad nila.

--- ## 💖 Mga Sponsor

Taos-pusong pasasalamat sa mga taong nagpopondo sa OmniRoute mula sa sarili nilang bulsa — ang bawat ambag ay tumutulong upang manatiling libre, independiyente, at patuloy na umuunlad ang proyekto.

Andrew _{💛 Aktibong buwanang sponsor}	Vlad I _{💛 Aktibong buwanang sponsor}	小妍儿 _{💛 Aktibong buwanang sponsor}	Guilherme Costa _{💛 Aktibong minsanang sponsor}	Henrique Iurkiv _{💛 Aktibong minsanang sponsor}	Somesh Ghaturle _{💛 Aktibong minsanang sponsor}
Kolonie AI _{💛 Dating minsanang tagasuporta}	Prof. Igor Morais _{💛 Dating minsanang tagasuporta}	Pixma _{💛 Dating minsanang tagasuporta}	Paco Cartones _{💛 Dating minsanang tagasuporta}	longtao _{💛 Dating minsanang tagasuporta}

_{… at sa iba pang mas gustong manatiling pribado 💛} _{Muling napatunayan ang mga pampublikong GitHub Sponsor noong 2026-10-18 sa pamamagitan ng GitHub Sponsors GraphQL API: 11 pampublikong sponsorship (6 na aktibo, 5 ang nakaraan) mula sa kabuuang 14. Ang status na isActive ng GitHub ang batayan ng mga aktibong label sa itaas; patuloy na pinasasalamatan ang mga dating pampublikong minsanang tagasuporta, at nananatiling hindi pinapangalanan ang mga pribadong sponsor. Hindi nakalista ang mga donasyon sa Ko-fi, Buy Me a Coffee, Liberapay, PIX, at crypto dahil wala silang pampublikong rekord ng sponsor.} 💖 Maging sponsor → — bawat dolyar ay tumutulong upang manatiling libre at independiyente ang OmniRoute.

## 👥 900+ Kontribyutor

[![Mga Kontribyutor](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=993&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors) _{Na-audit noong 2026-10-18 sa pinakabagong commit na ad160ab2d1 ng live na release/v3.8.52 (6,826 commit): 993 na-normalize na pagkakakilanlan ng mga tao sa Git — 707 ang lumilitaw bilang mga may-akda ng commit (kabilang ang tagapanatili) at 286 ang nasa tahasang mga trailer na Co-authored-by lamang. Inilalapat ng sensus ang .mailmap, inihahambing ang mga e-mail address nang hindi isinasaalang-alang ang laki o liit ng titik, pinagsasama ang mga numeriko at karaniwang GitHub noreply address kapag nag-encode lamang ang mga ito ng parehong handle, ibinubukod ang 26 na pagkakakilanlan ng bot/agent/serbisyo/placeholder, at hindi pinagsasama ang mga karaniwang e-mail address dahil lamang magkatugma ang kanilang mga display name. Ang audit noong 2026-08-24 ay nag-ulat ng 639; ang muling pagpapatakbo ng paraang ito sa base ng audit na iyon na ac02c5b42f ay nagbibigay ng 619, kaya ang pagtaas ay nagmula sa mga bagong kontribyutor, hindi sa mas maluwag na paraan.} ### Paano Mag-ambag 1. I-fork ang repository 2. Gumawa ng branch mula sa pinakabagong commit ng **aktibong** `release/vX.Y.Z` (hindi sa `main`) — tingnan ang [Modelo ng Pagba-branch at Pag-release](docs/ops/BRANCHING_MODEL.md) 3. Gumawa ng iyong feature branch (`git checkout -b feat/amazing-feature`) 4. I-commit ang iyong mga pagbabago (`git commit -m 'feat: add amazing feature'`) 5. I-push sa branch (`git push origin feat/amazing-feature`) 6. Magbukas ng Pull Request na may **base = ang branch na `release/vX.Y.Z` na iyon** Tingnan ang [CONTRIBUTING.md](CONTRIBUTING.md) para sa mga detalyadong alituntunin. ### Pag-release ng Bagong Bersyon ```bash # Gumawa ng release — awtomatikong nagaganap ang npm publish VERSION=x.y.z gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes ```

## 📊 Mga Star

## 🌍 StarMapper

## 🙏 Mga Pasasalamat

Nakatayo ang OmniRoute sa mga balikat ng mga higante. Nagsimula ito bilang fork ng **[9router](https://github.com/decolua/9router)** at TypeScript port ng Go project na **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** — at mula roon, ang bawat subsystem sa ibaba ay binigyang-inspirasyon ng isang open-source project na naunang nakarating doon. Ang bawat isa ay humubog sa isang konkretong bahagi ng OmniRoute. Ito ang aming pasasalamat sa kanilang lahat. 🙏 > ⭐ na-verify ang mga bilang ng star mula sa REST API ng GitHub noong Oktubre 18, 2026 — bigyan ninyo ng star ang mga proyektong ito. Ang mga bilang ay eksaktong snapshot na may petsa at likas na magbabago sa paglipas ng panahon. ### 🧬 Pinagmulan at gateway

Proyekto	⭐	Paano nito binigyang-inspirasyon ang OmniRoute
9router	31,004	Ang orihinal na proyektong pinagbabatayan ng fork na ito — pinalawak dito gamit ang mga multi-modal API at isang ganap na muling pagsulat sa TypeScript.
CLIProxyAPI	55,591	Ang implementasyon sa Go na nagbigay-inspirasyon sa JavaScript / TypeScript port na ito.
LiteLLM	61,482	Ang AI gateway na ang pampublikong dataset ng pagpepresyo ang pinagmumulan ng aming cost-tracking sync at ang modelo nito para sa pag-normalize ng provider ang humubog sa aming routing.
codex-chatgpt-web	14,526	MIT source na inangkop sa naka-vendor na ChatGPT Web → Codex Responses bridge, kabilang ang mga adapter para sa browser session, response framing, paggamit, at web search.
free-claude-code	61,430	Mga pattern na na-port sa stream recovery, mga no-thinking alias, fallback na web search, sliding-window limit, pag-redact ng log, at mga pinatibay na daloy ng launcher.
composer-api	346	Mga pattern ng tool choice, output constraint, at tool commit ng Cursor Composer na inangkop sa native na Cursor executor.
codex-multi-auth	553	Mga pattern ng bagong pag-login at pag-rotate ng refresh token na na-port sa muling pagpapatotoo ng Codex OAuth.
opencode-anthropic-auth	558	Mga default ng transform na compatible sa Claude Code at gawi ng billing header na ginawang pangkalahatan sa config-driven bridge ng OmniRoute.
grok2api-merged	2	Ang mga mapping nito para sa Grok model, fake-TypeError Statsig generator, mga default ng request at device, at NDJSON response processor ay malaking bahagi ng inangkop sa Grok Web executor ng OmniRoute.
TQZHR/grok2api	706	Ang pangunahing transitive na pinagmulan ng code sa likod ng grok2api-merged; pinanatili sa pinagmulan ng Grok Web ang mga implementasyon nito para sa model, header, payload, Statsig, at processor.
chenyme/grok2api	7,819	Ang pinagbabatayang MIT source para sa mga default ng Grok payload at device, ang Statsig generator, at ang `result.response` processor na ipinasa sa pamamagitan ng TQZHR at grok2api-merged.
grok2api-pro	27	Isang transitive na source na kinilala ng grok2api-merged para sa proxy-pool layer nito; pinananatili ng OmniRoute ang pabatid tungkol sa pinagmulang iyon ngunit hindi nito inaangkin na nag-port ito ng proxy pool sa saklaw nitong Grok Web executor.
GrokProxy	51	Ang Grok proxy nitong pinatotohanan gamit ang cookie at ang `result.response.token` streaming pattern nito ang humubog sa Grok Web transport ng OmniRoute.
GrokBridge	5	Sinangguni ng orihinal na implementasyon ng Grok Web ang upstream design nito para sa HTTP/browser; nagmula sa GrokProxy ang direktang HTTP path nito, kaya walang inaangking hiwalay na pag-port ng code.

### 🗜️ Pag-compress ng context at token — mga engine

Proyekto	⭐	Paano nito binigyang-inspirasyon ang OmniRoute
Caveman	113,396	Ang viral na proyektong "bakit gumamit maraming token kung kaunting token sapat na" — ang pilosopiya nitong pananalitang-taong-kuweba ang nagpapatakbo sa aming karaniwang compression mode at mahigit 30 panuntunan sa pag-aalis ng filler at pagkokondensa.
RTK – Rust Token Killer	83,835	Mataas-na-pagganap na compression ng command output — nagbigay-inspirasyon sa aming RTK engine, JSON filter DSL, pagbawi ng raw output, at sa pinagsalansang na RTK → Caveman pipeline.
headroom	75,741	Nababaligtad na context compression (SmartCrusher) — nagbigay-inspirasyon sa aming `headroom` engine at sa retrieve-marker pattern na `ccr`.
LLMLingua	6,757	Pananaliksik sa prompt compression (LLMLingua / LLMLingua-2) — nagbigay-inspirasyon sa aming asynchronous, ligtas-sa-code, at fail-open na `llmlingua` engine.
llmlingua-2-js	32	Ang JS/ONNX port (MobileBERT / XLM-RoBERTa) na ginagamit bilang worker-thread backend para sa aming LLMLingua engine.
Troglodita	50	PT-BR token compression — nagpapatakbo sa aming pt-BR language pack: pagbabawas ng pleonasm at pag-aalis ng filler na iniangkop para sa gramatika ng Brazilian Portuguese.
ponytail	166,731	Ang viral na YAGNI-coder skill ng "tamad na senior dev" — nagbigay-inspirasyon sa aming less-code Output Style: paggabay tungo sa pinakamaliit na gumaganang pagbabago na nagpapabawas sa _nabubuong_ code (ang kapatid sa output axis ng maikling prosa ng Caveman).
i-have-adhd	57,628	Ang istilo nitong inuuna ang aksiyon at madaling sundan ng mga may ADHD ay iniangkop sa maikling output style ng OmniRoute sa limang wika.

### 🧩 Mga compact na format, pananaliksik sa token, at tooling na may kamalayan sa code

Proyekto	⭐	Paano nito binigyang-inspirasyon ang OmniRoute
TOON	25,509	Token-Oriented Object Notation — ang columnar na modelo nitong header-plus-rows ang humubog sa aming yugto ng tabular compaction.
GCF – Graph Compact Format	59	Ang compact graph format at generic-profile design nito ang nagsilbing batayan ng tabular compaction ng OmniRoute at ng format ng Headroom codec.
gcf-typescript	4	Ang MIT TypeScript implementation na direktang isinama at pinalawak bilang generic-profile codec ng Headroom.
token-optimizer-mcp	551	Brotli/SQLite cache + per-session context delta — nagbigay-inspirasyon sa aming `session-dedup` engine.
token-savior	1,182	Bash-output compaction + MCP profiles — nagbigay-inspirasyon sa aming disiplinadong paghinto sa compression at pagbabawas ng MCP tool manifest.
token-saver	154	Compression ng output ayon sa uri ng file at may kamalayan sa nilalaman, kasama ang paghinto kapag may pagkabigo — pinagtibay nito ang aming dispatch ayon sa uri at paglaktaw kapag kulang ang pakinabang.
token-optimizer	2,595	"Hanapin ang mga ghost token" — ang pattern nitong offload + recoverable handle ang nagsilbing batayan ng aming pag-iisip tungkol sa CCR offload.
TokenMizer	33	Isang blueprint ng session graph + cross-turn line dedup na nagsilbing batayan ng aming session-dedup design.
OmniCompress	3	Rust columnar JSON + content-addressed retrieve + cross-message dedup — pinagtibay nito ang disenyo ng aming `headroom`/`ccr`/`session-dedup` engine at ang cache-stable na invariant na "ang compressed form ay hindi nakadepende sa posisyon."
mcp-compressor	133	Compression ng MCP tool schema/paglalarawan — nagsilbing batayan ng aming pagbabawas sa cardinality ng MCP tool manifest.
RepoMapper	217	Aider-style na pagraranggo ng repo map — nagsilbing batayan ng aming paggalugad sa repo map / retrieval ranking.
quiet-shell-mcp	4	Deklaratibong pagbabawas ng shell output sa pamamagitan ng MCP — pinagtibay nito ang aming deklaratibong bash-output compaction.
ts-morph	6,205	TypeScript Compiler API toolkit — nagbigay-inspirasyon sa aming parser-based na pag-aalis ng komento na pinananatili ang mga string, template, at regex literal.

### 🧠 Memorya at RAG

Proyekto	⭐	Paano nito binigyang-inspirasyon ang OmniRoute
Mem0	67,385	Universal na memory layer — hinubog ng modelo nitong proxy-bilang-hangganan-ng-pagsulat/pagbasa ang aming arkitektura ng memory.
Letta (MemGPT)	25,179	Mga stateful agent na may nakaantas na memory — nagbigay-inspirasyon sa aming nakaantas na modelo ng Context Control & Recovery (CCR).
WFGY	1,800	Ang ProblemMap taxonomy ng 16 na paulit-ulit na failure mode ng RAG/LLM — ang magkakatulad na bokabularyo sa aming gabay sa pag-troubleshoot.

### 🛰️ Inspeksiyon ng trapiko, MITM at transparent proxy

Proyekto	⭐	Paano nito binigyang-inspirasyon ang OmniRoute
llm-interceptor	79	Ang MITM interception/pagsusuri ng trapiko sa pagitan ng coding-assistant ↔ LLM ang nagbigay-hugis sa mga paunang kinakailangan ng Traffic Inspector. Apat na dating hinangong module — SSE merging, conversation normalization, secret masking at header sanitization — ang napalitan na ng mga independiyenteng clean-room implementation batay sa mga pampublikong pamantayan ng protocol. Ang dalawang host-passthrough surface (`passthrough.ts` at `_internal/bypass.cjs`) ay nananatiling mga panloob na implementation ng OmniRoute na hiwalay na inuri; hindi muling isinulat ang mga ito bilang bahagi ng pagpapalit na iyon.
ProxyBridge	6,814	Transparent na per-process proxy routing — nagbigay-inspirasyon sa aming crash-safe na MITM teardown, mga socket idle-timeout, `/proc` process attribution at TPROXY capture.

### 📚 Data ng modelo, observability at UI

Proyekto	⭐	Paano nito binigyang-inspirasyon ang OmniRoute
models.dev	7,286	Bukas na database ng mga detalye, presyo at kakayahan ng AI model — katutubong naka-sync sa aming katalogo ng modelo.
React Flow / xyflow	38,705	Ang node-based graph library na nagpapatakbo sa aming real-time na Compression Studio at Combo/Routing Studio.
LangGraph	43,443	Ang live na visualization ng workflow graph ng LangGraph Studio ang nagbigay-inspirasyon sa real-time na cascade view ng aming mga Studio.
Langfuse	35,990	Hinubog ng trace → span → generation na modelo nito para sa observability ang waterfall ng aming Compression Studio.
Kiali	3,645	Observability para sa Istio service mesh — nagbigay-inspirasyon sa aming mga circuit-breaker badge at error-edge visual sa Routing/Combo Studio.
lobe-icons	2,615	Mga logo ng AI/LLM brand na nagre-render ng mga icon ng provider sa kabuuan ng aming dashboard.
flag-icons	12,473	Nagbibigay ng mga SVG flag na lisensiyado sa ilalim ng MIT at ginagamit ng tagapili ng wika sa README.

### 🛡️ Seguridad

Proyekto	⭐	Paano nito binigyang-inspirasyon ang OmniRoute
awesome-secure-defaults	722	Isang piniling listahan ng mga secure-by-default na library na gumagabay sa aming mga pasya sa seguridad (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).

### 🧭 Mga komplementaryong tool

Proyekto	⭐	Paano nito binigyang-inspirasyon ang OmniRoute
ClawRouter	6,628	Nagbigay-inspirasyon sa request deduplication, emergency na fallback na walang gastos, mga pluggable na estratehiya ng Auto-Combo at multilingual na pag-uuri ng layunin.
Antigravity-Manager	32,333	Ang account-aware na model remapping, validation ng executable path at gawi ng plan label nito ang nagbigay-hugis sa Antigravity runtime ng OmniRoute.
vscode-antigravity-cockpit	4,850	Ang compact na format nito para sa countdown ng pag-reset ng quota ang nagbigay-inspirasyon sa kaukulang pagpapakita ng limitasyon ng provider sa OmniRoute.
AionUi	33,611	Ang mga ACP integration nito ang nagbigay-inspirasyon sa awtomatikong pagtukoy ng OmniRoute sa mga naka-install na CLI agent.
CodexBar	22,616	Tinukoy nito ang Grok Build quota surface; pagkatapos ay independiyenteng bineberipika at itinama ng OmniRoute ang live wire format.

## 📄 Lisensya MIT License - tingnan ang [LICENSE](LICENSE) para sa mga detalye. ---

**[⬆ Bumalik sa itaas](#-omniroute)** · Ginawa nang may ❤️ para sa komunidad ng open-source AI. _{OmniRoute v3.8.53 · Node ≥22.22.2 · MIT License · omniroute.online}