# README (Eesti) 🌐 **Languages:** 🇺🇸 [English](../../../README.md) · 🇸🇦 [ar](../ar/README.md) · 🇦🇿 [az](../az/README.md) · 🇧🇬 [bg](../bg/README.md) · 🇧🇩 [bn](../bn/README.md) · 🇨🇿 [cs](../cs/README.md) · 🇩🇰 [da](../da/README.md) · 🇩🇪 [de](../de/README.md) · 🇬🇷 [el](../el/README.md) · 🇪🇸 [es](../es/README.md) · 🇮🇷 [fa](../fa/README.md) · 🇫🇮 [fi](../fi/README.md) · 🇫🇷 [fr](../fr/README.md) · 🇮🇪 [ga](../ga/README.md) · 🇮🇳 [gu](../gu/README.md) · 🇮🇱 [he](../he/README.md) · 🇮🇳 [hi](../hi/README.md) · 🇭🇷 [hr](../hr/README.md) · 🇭🇺 [hu](../hu/README.md) · 🇮🇩 [id](../id/README.md) · 🇮🇹 [it](../it/README.md) · 🇯🇵 [ja](../ja/README.md) · 🇰🇷 [ko](../ko/README.md) · 🇱🇹 [lt](../lt/README.md) · 🇱🇻 [lv](../lv/README.md) · 🇮🇳 [mr](../mr/README.md) · 🇲🇾 [ms](../ms/README.md) · 🇲🇹 [mt](../mt/README.md) · 🇳🇱 [nl](../nl/README.md) · 🇳🇴 [no](../no/README.md) · 🇵🇭 [phi](../phi/README.md) · 🇵🇱 [pl](../pl/README.md) · 🇵🇹 [pt](../pt/README.md) · 🇧🇷 [pt-BR](../pt-BR/README.md) · 🇷🇴 [ro](../ro/README.md) · 🇷🇺 [ru](../ru/README.md) · 🇸🇰 [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) · 🇻🇳 [vi](../vi/README.md) · 🇨🇳 [zh-CN](../zh-CN/README.md) · 🇹🇼 [zh-TW](../zh-TW/README.md) ---

# 🚀 OmniRoute — tasuta tehisintellekti lüüs

OmniRoute — ära kunagi lõpeta programmeerimist. Iga tehisintellekti tööriist → 355 teenusepakkujat — 150+ tasuta — ühe lõpp-punkti kaudu. Claude Code, Codex, Cursor, Cline, Copilot ja Antigravity TASUTA Claude'i / GPT / Gemini kasutamiseks automaatse ümberlülitusega. RTK + Caveman virnastatud tihendus säästab 15–95% tokeneid (keskmiselt ~89%) — limiidid ei saa kunagi täis. 355 tehisintellekti teenusepakkujat · 150+ tasuta paketti · ~1.51B tasuta tokenit kuus · 19 marsruutimisstrateegiat · alustamine maksab $0.

## 💰 ~1.51B tasuta tokenit kuus

> Tasuta pakettide käsitsi virnastamine on vaevaline — kümned SDK-d, kümned kiiruspiirangud ja puudub ülevaade sellest, kui palju sul tegelikult kasutada on. OmniRoute kataloogib **446 tasuta paketi kirjet 38 korduva kogumivõtme lõikes** ning arvutab tokenite põhinäitaja **20 kogumi põhjal, mille kohta on avaldatud positiivne kuueelarve**, eemaldades jagatud kogumite duplikaadid. Tulemus on alati nähtav juhtpaneelil (`/dashboard/free-tiers`).

> Reaalajas `/dashboard/free-tiers` lehe animeeritud kokkuvõte. Täielik metoodika (kogumite duplikaatide eemaldamine, krediiditasemed, teenusepakkujate tingimused): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**. > > _{Neid arve auditeeritakse iga kahe nädala järel uuesti reaalajas kataloogi põhjal ning need **liiguvad mõlemas suunas** — kui teenusepakkuja lõpetab tasuta paketi, siis arv väheneb; uue lisandumisel see suureneb. Avaldame alati kataloogi tegeliku arvutustulemuse, mitte kunagi ülespoole ümardatud parimat võimalikku tulemust.}

⭐ Anna hoidlale täht, kui OMNIROUTE aitas sul raha säästa ja tööd lihtsamaks muuta.

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

[![Täheajaloo edetabelikoht](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) ### 💬 Liitu kogukonnaga **👋 Jälgi hooldajat — saa uutest teenusepakkujatest, väljalasetest ja näpunäidetest teada esimesena:** [![Jälgi Diegot LinkedInis](https://img.shields.io/badge/Follow_Diego_on-LinkedIn-0A66C2?style=for-the-badge&logo=linkedin&logoColor=white)](https://www.linkedin.com/in/diegosouzapw/) [![Jälgi kasutajat @diegosouzapw GitHubis](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 ülemaailmne](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 Brasiilia](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) [![Veebisait](https://img.shields.io/badge/Website-omniroute.online-blue?logo=google-chrome&logoColor=white)](https://omniroute.online) **Küsimused, teenusepakkujate näpunäited, tegevuskava ja tugi → [Discord](https://discord.gg/U47eFqAXCn) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 ülemaailmne](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) / [🇧🇷 Brasiilia](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) / [portaal](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK)**
## 📈 Lüüs kasvab aina edasi

| | v3.8.49 | **v3.8.50** | `v3.8.51+` | | -------------------------------- | :-----: | :------------------------: | :--------: | | 🌐 Teenusepakkujad | 290 | **352** | veel ootel | | 🧠 Unikaalsed vestlusmudeli ID-d | 1185 | **1312** | — | | 🖼️ Modaalsuste sild | — | 🆕 nägemine + heli + video | — | | 📡 Radari tasuta kataloog | — | 🆕 valikuline | — | | ⚖️ Kvooditeadlik ajastamine | — | 🆕 Quota-Share | — | | 📊 Kvooditelemeetria | — | 🆕 reaalajas | — | **→ [Tegevuskava](ROADMAP.md) — mööda rööpaid `v3.9.0 LTS` poole**

## 🧩 Saadaval [![npm-i versioon](https://img.shields.io/npm/v/omniroute?color=cb3837&logo=npm)](https://www.npmjs.com/package/omniroute) ![NPM-i igakuised allalaadimised](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) [![Litsents: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](LICENSE) ![Dockeri tõmbamised](https://img.shields.io/docker/pulls/diegosouzapw/omniroute?label=docker%20pulls&logo=docker&color=2496ED) ![Electroni allalaadimised](https://img.shields.io/github/downloads/diegosouzapw/omniroute/total?style=flat&label=electron%20downloads&logo=electron&color=47848F)

🚀 Alustamine	🚀 Kiirstart	📦 Installimine	🆓 Seadistamiseta
💡 Õppimine	💥 Lubadus	🤔 Miks OmniRoute	🏆 Mis seda eristab
⚙️ Funktsioonid	🎯 Kombod	🌐 Teenusepakkujad	🔌 CLI & MCP
	🗜️ Tihendamine	🖥️ Kus see töötab	🔒 Privaatne
👀 Vaata	🎬 Töös	✨ Mis on uut	🤖 Ühilduvad CLI-d
💚 Toetus	💚 Toeta / anneta	💬 Kogukond	💖 Sponsorid
📦 Projekt	🛠️ Tehnoloogiapinu	📖 Dokumentatsioon	👥 Kaastöötajad

🌐 46 keeles

## 🆓 Töötab kohe pärast installi — võtmeid pole, konfiguratsiooni pole

Töötab kohe pärast installi — null konfiguratsiooni. Kolm sammu: 1. Installi — npm i -g omniroute, server käivitub aadressil localhost:20128. 2. Suuna oma tööriist aadressile http://localhost:20128/v1 — ükskõik milline OpenAI-ühilduv tööriist (Claude Code, Cursor, Cline). 3. See vastab — kutsu mudelit auto kohese vastuse saamiseks, ilma API võtme, registreerumise või seadistuseta. Võtmeta pakkuja OpenCode Free on auto kombosse eelühendatud, nii et värske install vastab kohe.

```bash # Värske install, null volitusi — `auto` juba töötab: curl http://localhost:20128/v1/chat/completions \ -H "Content-Type: application/json" \ -d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}' ``` _{Eelistad kindlat tasuta taustsüsteemi? Kutsu `oc/…` (OpenCode Free) otse. Seejärel liigu `auto` peale ja lase OmniRoute’il valida.} _{📦 Kopeeri-kleebi kiirstardi skriptid **Pythonile, Node.js-ile, PHP-le ja cURL-ile** → [`examples/quickstart/`](examples/quickstart/)}

# 💥 Lubadus

# 🤔 Miks OmniRoute?

OmniRoute’i päringuvoog: sinu IDE või CLI (Claude Code, Cursor, Cline…) kutsub üht lokaalset lõpp-punkti (http://localhost:20128/v1); OmniRoute’i nutikas ruuter (RTK + Caveman kompressioon, 19 suunamisstrateegiat, circuit breaker’id, TLS-varjamine, MCP, A2A, guardrail’id) saab langeda tagasi üle 4 pakkuja taseme, kuni on saadaval sobiv terve sihtmärk — Tase 1 Subscription, Tase 2 API Key, Tase 3 Cheap ja Tase 4 Free.

## 🤝 Meie avatud lähtekoodi sõprade toel

> **Soovid liituda avatud lähtekoodi sõbrana?** Need on ettevõtted, kes toetavad avatud lähtekoodi ja aitavad OmniRoute'i liikuma hoida — ja me avaldame avalikult, kuhu iga neilt saadud toke läheb. Võta ühendust: [diegosouza.pw@outlook.com](mailto:diegosouza.pw@outlook.com)

Kimi
_{Moonshot AI} Tänud Kimile (Moonshot AI), meie esimesele avatud lähtekoodi sõbrale, selle projekti toetamise eest! Kimi on AI-labor, mis on avatud kaaludega K2 ja K3 mudeliperede loojad — Kimi K3 pakub 1M-tokenilist kontekstiakent, sisseehitatud nägemisvõimet ja tipptasemel koodikirjutamist murdosa hinnaga suletud mudelitest, ning töötab kohe kastist välja koos Claude Code'i, Codexi ja kõigi teiste koodivahenditega, mida OmniRoute teenindab.

Mida Kimi toetus võimaldab: Kimi API krediidid toidavad OmniRoute'i AI-valideeritud väljalaskeprotsessi — Kimi K3 toega ühendamise valideerimist, mis vaatab läbi iga pull request'i enne selle avaldamist — lisaks igapäevasele funktsioonide arendusele. Esmaklassiline Kimi tugi on olemas mõlemal teel: otsene Kimi API (kimi-k3) ja Kimi Code koodiplaan (OAuth ja API võti). OmniRoute on ka esimene brasiillik avatud lähtekoodi projekt Kimi toetusprogrammis. Hangi Kimi API võti, millega saad 15% lisakrediiti →

Cheaper Inference
_{cheaperinference.com} Tänud Cheaper Inference'ile, OmniRoute'i avatud lähtekoodi sõbrale, selle projekti toetamise eest! Cheaper Inference on hinna järgi järjestatud vahendussüsteem, mis vahendab 42 tipptasemel mudelit — Claude, GPT-5.x, Gemini, Kimi K3, GLM, DeepSeek, Grok ja MiniMax — ühe OpenAI-ga ühilduva otspunkti tagant, suunates iga päringu odavaimale sobivale pakkujale, ilma et hind ületaks kunagi mudeli looja avaldatud hinnakirja.

Esmaklassiline tugi OmniRoute'is: Chat Completions, natiivne /v1/responses otspunkt, nägemine, tööriistade kutsumine ja 3 pildimudelit (grok-imagine, nano-banana-pro, nano-banana-2, kättesaadavad kui cheaperinference/<model>). Hangi API võti →

_{Lingid tähisega aff=omniroute on partnerlingid. Need rahastavad projekti, ilma et see sulle lisakulu tooks.}

_{🎟️ Partnerprogrammi soodustused — pakkujate tasuta registreerimiskupongid, keda me ei sponsoreeri (klõpsa avamiseks)}

_{See jaotis on mõeldud ainult soovitus-/kupongikoodidele. Sponsoreeritud partnerlused on toodud eespool jaotises 🤝 Meie avatud lähtekoodi sõprade toel. OmniRoute'il ei ole sponsorlust ega partnerlust siin loetletud pakkujatega — need on avalikud kupongid, mida igaüks saab kasutada.}

_AgentRouter
_{agentrouter.org} _{AgentRouter — partnerregistreerimine · $100 tasuta krediiti registreerumisel (tasuta server, arvesta suurema latentsusega — sobib parimini testimiseks, mitte tootmiseks). Esmaklassiline tugi OmniRoute'is alates versioonist v3.8.50: Chat Completions, Anthropicuga ühilduv edastusvorming ja OpenAI-ga ühilduv tee. Saadaval mudelite hulgas on claude-opus-4-8, claude-opus-5, gpt-5.6-sol ja teised. Hangi oma $100 →}

_{⚠️ Partnerlink — OmniRoute'il ei ole sponsorlust ega partnerlust selle pakkujaga.}

_{Tead veel pakkujat, kellel on helde tasuta registreerimiskupong, mis oleks OmniRoute'i kasutajatele kasulik? Ava probleem (issue) ja me lisame selle siia.}

## 🎯 Combos — lipulaev

All 19 combo routing strategies animated — one tile per strategy: priority, fill-first, weighted, round-robin, p2c, least-used, random, strict-random, cost-optimized, headroom, reset-window, reset-aware, context-relay, context-optimized, cache-optimized, lkgp, auto, fusion, pipeline. See the table above for what each one does.

> **Combo** on mudelite ahel, mille vahel OmniRoute suunab liiklust **automaatselt**. Kui kvoot saab otsa, teenusepakkuja tõrgub või kulud tõusevad hüppeliselt, saab combo liikuda järgmise sobiva ja töökorras mudeli juurde. 🛡️ ### ⚡ Nullkonfiguratsiooniga — kasuta lihtsalt `auto` Combo't ei pea looma. Sea mudeliks `auto` (või selle variant) ja OmniRoute loob sinu ühendatud teenusepakkujatest virtuaalse combo, mida hinnatakse jooksvalt:

Mudeli ID	Mille jaoks see on optimeeritud
`auto`	🎯 Tasakaalustatud vaikeseade (LKGP — jääb kinni sinu viimasest töökorras teenusepakkujast)
`auto/coding`	🧑💻 Kvaliteedile suunatud kaalud koodi genereerimiseks
`auto/fast`	⚡ Väikseim latentsus esikohal
`auto/cheap`	💰 Odavaim tunnihind esikohal
`auto/offline`	🔋 Suurim kvoodi- / määramäära reserv esikohal
`auto/smart`	🔭 Kvaliteedile suunatud + 10% avastamist parema mudeli leidmiseks
`auto/lkgp`	📌 Selgesõnaline viimase-töötanud-teenusepakkuja kinnihoidmine
`auto/chaos`	🧪 Veainjektsiooni kaalud vastupidavuse testimiseks (kaosetehnika)

## ### 🔀 Või loo endale sobiv — 19 suunamisstrateegiat Kõik **19** strateegiat — segunda ja kombineeri iga combo etapi kaupa:

#	Strateegia	Mida see tähendab
1	`priority`	Esmase sihtmärgi järjestatud loend — kasutab ühe ammendumiseni enne järgmise juurde liikumist 🥇
2	`fill-first`	Täidab igas sihtmärgis kvoodi täielikult, enne kui liigub edasi
3	`weighted`	Kaalutud juhuslikkus vastavalt igale sihtmärgile määratud kaalule
4	`round-robin`	Käib sihtmärgid järjekorras läbi tsükliliselt
5	`p2c`	Kahe-juhusliku-valiku (power-of-two-choices) koormuse jaotus
6	`least-used`	Valib sihtmärgi, mille koormus on hetkel väikseim
7	`random`	Ühtlane juhuslik valik (duplikaadid eemaldatud)
8	`strict-random`	Juhuslik valik korduste eemaldamiseta 🎲
9	`cost-optimized`	Minimeerib $ päringu kohta, kasutades reaalajas hinnakataloogi 💸
10	`headroom`	Valib sihtmärgi, kus on jäänud kvooti kõige rohkem
11	`reset-window`	Eelistab sihtmärki, mille kvoodiaken lähtestub kõige varem
12	`reset-aware`	Järjestab kvoodi lähtestamise aja järgi — lühimad aknad esikohal 📊
13	`context-relay`	Annab konteksti üle sihtmärkide vahel pikkade vestluste jaoks 🧠
14	`context-optimized`	Valib parima sobivuse hetke konteksti suuruse jaoks
15	`cache-optimized`	Kinnitab igasse taaskasutatava viipe eesliite sama konto juurde — maksimeerib viipe vahemälu tabamusi 🎯
16	`lkgp`	Last-Known-Good Path — kinnitub viimasele õnnestunud teenusepakkujale, seejärel langeb tagasi reeglitele
17	`auto`	16-teguriline reaalajas hindamine igal ühenduse üle 🤖
18	`fusion`	Jagab päringu mudelite paneelile + kohtunik sünteesib ühe vastuse 🧬
19	`pipeline`	Ahelastatud etapid — igas etapis on väljund sisendiks järgmisele 🔗

_{Auto-Combo mootor hindab igat kandidaati **16 teguri** alusel (töökindlus, kvoot, kulu, latentsus, ülesande sobivus, kvaliteet, sessiooni saadavus…) — vaata [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md).} ## ### 🧱 Vastupidavus on sisse ehitatud (3 sõltumatut kihti)

OmniRoute resilience — 3 independent self-healing layers, the right layer for the right failure. Layer 1 provider circuit breaker (whole provider): trips only on 408/5xx, thresholds OAuth 8× / API-key 12× / local 2×, resets 60s/30s/15s into a HALF-OPEN probe, lazy recovery; while OPEN the combo reroutes to the next provider. Layer 2 connection cooldown (one key/account): base 5s OAuth / 3s API-key, exponential ×2 backoff with anti-thundering-herd guard, 429 honors Retry-After, success clears all error state; one cooling key is skipped while sibling keys keep serving. Layer 3 model lockout (one model): per-model 429, local 404 or mode denials lock just that model — never the whole connection. Terminal states (banned, expired, credits exhausted) are for the operator, not cooldowns.

_{📖 [Auto-Combo mootor](docs/routing/AUTO-COMBO.md) · [Vastupidavuse juhend](docs/architecture/RESILIENCE_GUIDE.md)}

## 🏆 Mis teeb OmniRoute'i eriliseks

_{📊 Täielik metoodika ja funktsioonide detailne võrdlus vs 9router, OpenRouter, CLIProxyAPI ja LiteLLM → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)}
## 💚 Toeta OmniRoute'i OmniRoute on MIT-litsentsi all ja hooldatakse avatult. Kui see säästab teie aega või raha, siis siin on võimalused, kuidas hoida projekt iseseisvana — valige see, mis teile sobib. Sponsorlus ei mõjuta kunagi ruutimise prioriteeti; see ostab nähtavust, mitte paremusjärjestust.

⭐ Andke repole täht	Tasuta — aitab tegelikult nähtavust suurendada	Andke OmniRoute'ile täht
🐙 GitHub Sponsors	Ühekordne või igakuine · null platvormitasu	github.com/sponsors/diegosouzapw
☕ Ko-fi	Kiire ühekordne annetus, annetaja ei pea registreeruma	ko-fi.com/diegosouzapw
🧋 Buy Me a Coffee	Väike, mitteformaalne žest	buymeacoffee.com/diegosouzapw
🖐 Liberapay	Korduv · mittetulunduslik · avatud lähtekood	liberapay.com/diegosouzapw
🇧🇷 PIX (Brasiilia)	Koheselt, tasuta	võti ja QR-kood allpool
₿ Krüpto	BTC · ETH · USDT-TRC20 · USDC-Solana	aadressid allpool

**🇧🇷 PIX** — koheselt, tasuta (Brasiilia) OmniRoute PIX QR-kood

Võti (juhuslik): `5d865059-bc44-483a-962d-43ceb80126eb` Pix copia-e-cola: ``` 00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD ```

₿ Krüpto — BTC · ETH · USDT-TRC20 · USDC-Solana (klõpsa, et avada)

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

_{⚠️ Saatke igat mündi ainult näidatud võrgus — vale võrgu kasutamine võib raha kaotada.}

🐛 Leidsid vea või on tagasisidet? Avage [arutelu (Discussion)](https://github.com/diegosouzapw/OmniRoute/discussions).

Arendaja märkused: Projekt võib npm install/postinstall käigus genereerida kohaliku .env faili arendaja mugavuse jaoks. See fail on tahtlikult ignoreeritud .gitignore kaudu (vaata .gitignore) ja seda ei tohi kunagi commit'ida — kui see kogemata commit'itakse, tuleb kõik avalikustatud saladused rotate'ida ja fail ajaloost eemaldada. Vaata docs/DEVELOPER-ENVIRONMENT.md juhiseid kohalike keskkonnafailide ja saladuste haldamiseks.

## 📡 OmniRoute Radar Peamine tasuta paketi pealkirjanumber on jätkuvalt **~1,51 miljardit tokenit kuus**, mis pärineb dokumenteeritud, poolide kaupa dubleerimisest puhastatud kataloogist ülal. Ajutised tootja registreerimiskrediidid võivad esimesel kuul seda eraldi tõsta kuni **~2,13 miljardini**. Radar on valikuline, allkirjastatud kataloogi ülekate neile, kes soovivad OmniRoute väljalaskete vahel värskemat tasuta mudelite kättesaadavust; kogukonna kataloog ja kõik olemasolevad tasuta funktsioonid jäävad tasuta. Toetajad saavad ligipääsu reaalajas kataloogile ja täiendavatele tootjapõhistele võimalustele. Selle eraldi, muutuv ülempiir on **maksimaalselt umbes 3 miljardit tokenit kuus**, sõltuvalt tootjate saadavusest. See ülempiir ei ole garantii: tootjad võivad igal ajal muuta kvoote, õigustatust, mudeleid või regioone. Radar on vabatahtlik ja kasutab ainult GET-päringuid. OmniRoute klient ei laadi üles päringuid, liiklust, tootja seadistust, kasutustelemeetriat ega kohalikku teavituste-suletud olekut. Loe õigustatuse ja praeguse kataloogi kohta lähemalt aadressil **[radar.omniroute.online/planos](https://radar.omniroute.online/planos)**.

## ✨ Mis on uut

> Viimased esiletõstetud uuendused vahemikus **v3.8.20 → v3.8.50**. Täielik ajalugu failis [`CHANGELOG.md`](CHANGELOG.md). - **🎛️ OmniConductor** — sissetulev A2A delegeerimine sinu agentide flotillile, Conductor'i oskused Agent Card'il ning armatuurlaua paneel Faro push-to-talk häälvestlusega. → [A2A Server](docs/frameworks/A2A-SERVER.md) - **🛂 Adaptiivne lubamine ja ülekoormuskaitse** — raske vestluspäringud jäävad järjekorda selle asemel, et tagastada 503, koos atomaarsete RPM-i rullivate rendilepingutega iga ühenduse kohta. → [Vastupidavuse juhend](docs/architecture/RESILIENCE_GUIDE.md) - **🗂️ Kanooniline `/v1/models` järjestus** — üks sidus tootja kaupa grupeeritud plokk igale tootjale (kombinatsioonid kinnitatud esimesena), stabiilne kõikide kataloogiallikate lõikes. → [API viitedokumentatsioon](docs/reference/API_REFERENCE.md) - **🗜️ Tihendamise tugevdamine** — vaikimisi sisselülitatud paisumiskaitse, Caveman'i paketid DE / FR / JA + hiina keele (wényán) jaoks, RTK filtrid Gradle'i ja .NET-i jaoks. → [Tihendamine](docs/compression/COMPRESSION_ENGINES.md) - **💸 Aus fikseeritud hinnaga maksumus** — tellimuse / koodimisplaani tootjad näitavad kuluanalüütikas **0 $**; eelarve, kvoot ja ruutimine jätkavad hindamist. → [API viitedokumentatsioon](docs/reference/API_REFERENCE.md) - **⚖️ Kvoodijaotuse ruutimine** — ühiskonto kvoodi õiglane jagamine kogutud võtmete vahel, töökonserveeriv, nii et jõude olevad tükid laenatakse edasi. → [Vastupidavuse juhend](docs/architecture/RESILIENCE_GUIDE.md) - **🤖 Ühe käsuga CLI/agendi seadistus** — 13 registreeritud `setup-*` käsku; `omniroute run` käivitab 7 CLI-d (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); `omniroute configure` toetab 10 sihtmärki interaktiivse tootja- ja mudelivalija ning kontekstipõhiste lemmikutega. → [CLI integratsioonid](docs/guides/CLI-INTEGRATIONS.md) - **🛰️ Kaugrežiim** — juhi kaugjuhtimisega OmniRoute't piiratud õigustega tokenitega (`connect` / `contexts` / `tokens`) + `antigravity` OAuth abivahend VPS-i paigaldustele. → [Kaugrežiim](docs/guides/REMOTE-MODE.md) - **🧭 Nutikam automaatne ruutimine** — `auto/:` kombinatsioonid, **Fusion** (mudelipaneel + kohtunik), ülesandeteadlik ruutimine, päringupõhised mudeli / režiimi / USD-eelarve ülekirjutused. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🗜️ Ühendatavad tihendusmoodulid** — 12 kombineeritavat mootorit + tihendusstuudioid: LLMLingua-2, kaheastmeline Ultra, omniglyph, sammupõhine täpsuskontroll, GCF v3.2, lohista-ümberjärjestamise redaktor. → [Tihendamine](docs/compression/COMPRESSION_ENGINES.md) - **🕵️ Läbipaistev MITM-dekrüpteerimine (TPROXY)** — jäädvustab CLI-d, mis ignoreerivad puhverserveri keskkonnamuutujaid, koos SNI-põhise CA-ga ja usaldushoidla installeerijaga. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md) - **💸 Kuludelemeetria kõikjal** — `X-OmniRoute-*` kulu/kasutuse päised igal lõpp-punktil, vahemälu-HIT-i säästupäis, võtmepõhised USD-kulude kvoodid. → [API viitedokumentatsioon](docs/reference/API_REFERENCE.md) - **🧠 Sinu kontrolli all mälu** — vaikimisi väljas, valikuline int8 vektorkvantimine + tüübipõhine vähenemine, päringupõhine `x-omniroute-no-memory`. → [Mälu](docs/frameworks/MEMORY.md) - **🛡️ Turvalisus** — süstesõna-süstimise kaitse igal LLM-marsruudil (red-team komplekt), valikuline mandaadi-varjamise kaitsemeede (peidab lekkinud API-võtmed/saladused mõlemas suunas), tasuta DuckDuckGo viimase abinõu veebiotsing ja valikuline OIDC sisselogimislävi armatuurlauale (parooliga sisselogimine on alati saadaval). → [Kaitsemeetmed](docs/security/GUARDRAILS.md) - **🖼️ Uued lõpp-punktid** — `/v1/ocr` (Mistral OCR) ja `/v1/audio/translations` (Whisper-stiilis) täiendavad meediapinda. → [API viitedokumentatsioon](docs/reference/API_REFERENCE.md) - **🎨 Pildi/video/audio genereerimine** — üks API meedia jaoks: xAI Grok Imagine ja Novita AI video, ComfyUI, Magnific, Adobe Firefly, Segmind ja kõnetootjad nagu ElevenLabs. → [API viitedokumentatsioon](docs/reference/API_REFERENCE.md) - **🌍 Juurutamine ja käitamine** — pöördpuhverserveri `basePath`, brauseri keele automaatne tuvastamine, võtmepõhine seadmejälgimine, juurõigusteta MITM-usaldus, zh-TW lokaliseerimine. → [Keskkond](docs/reference/ENVIRONMENT.md) - **🤝 Rohkem tootjaid ja agente** — pilveagendid (Codex Cloud, Cursor, Devin, Jules), Grok Build (xAI) brauseri- ja OAuth-sisselogimisega, Ollama esmaklassilise kaardiga, Claude Opus 5 ja Sonnet 5, Kimi ametlik partnerlus (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… ning uuendatud **352 tootjaga kataloog**. → [Tootjad](docs/reference/PROVIDER_REFERENCE.md) - **📡 Ruutimise läbipaistvus** — igas vastuses on `X-OmniRoute-Decision` päis, mis nimetab strateegia/tootja/latentsuse, mis päringu teenindas; uus `cache-optimized` kombinatsioonistrateegia + Auto-Combo `cacheAffinity` tegur suunavad kordunud päringud tagasi ühendusele, mille käes on vahemällu salvestatud eesliide; ning kirjutuskaitstud `/v1/auto-combo/{channel}/candidates` lõpp-punkt näitab `auto/*` kanali reaalajas kandidaatide kogumit. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **⚡ Kohalik jõudlus ja infrastruktuur** — ühe klõpsuga kohalik Redis, Cloudflare Workers / Deno Deploy edastuse juurutajad, Bifrost ja Mux hallatud manustatud teenustena. → [Manustatud teenused](docs/frameworks/EMBEDDED-SERVICES.md) - **🧩 Karbis on veel** — pluginate raamistik + turuplats, Omni/Agent/GitHub oskuste raamistikud, Obsidian vault'i integratsioon (22 MCP tööriista), OpenAI-ga ühilduvad Batch ja Files API-d, semantiline vastuste vahemälu, gamifikatsioon edetabelitega, ACP agentide avastamine (15 sisseehitatud agenti), ajastatud logide eksport BigQuery-sse, `auto/chaos` veasüstimine, Telegrami boti sild, rakendusesisene versioonihaldur ja LMArena-ELO tasuta tootjate edetabelid. → [Dokumentatsioon](docs/README.md)

## 🤖 Ühilduvad CLI-d ja koodiagendid > Üks konfiguratsioon — `http://localhost:20128/v1` — ja **kõik** AI IDE-d või CLI-d töötavad tasuta ja odavate mudelitega.

_{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}	_{Agent Deck}

＋ töötab ka koos · Kiro · Command Code · Antigravity · Windsurf · AMP · iga OpenAI-ühilduva tööriistaga

_{📖 Iga tööriista jaoks eraldi seadistusjuhis kõigi 36 tööriista kohta (26 CLI koodiagenti + 10 CLI agenti) → [`docs/reference/CLI-TOOLS.md`](docs/reference/CLI-TOOLS.md) · 🧩 OpenCode plugin → [`@omniroute/opencode-provider`](https://www.npmjs.com/package/@omniroute/opencode-provider)}

**Käivita iga toetatud CLI OmniRoute kaudu ühe käsuga** — konfiguratsioonifaile ei kirjutata, volitused süstitakse protsessi kaupa, Qwen/Gemini saavad ühekordse eraldatud kodukataloogi: ```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" # Või vali provider+mudel interaktiivselt ja kirjuta tööriista oma konfiguratsioon: omniroute configure codex # samuti: claude opencode qwen aider goose gemini cline continue kilo ``` Kõik käsud austavad aktiivset kaugkontekst (`omniroute connect `), `--dry-run` näitab ette täpsed env/argumendid ilma käivitamata, ja `--api-key-env NAME` hoiab saladused eemal sinu shelli ajaloost. → [CLI integratsioonid](docs/guides/CLI-INTEGRATIONS.md)

## 🌐 352 AI pakkujat — 152 kataloogis märgitud tasuta

> **352 registreeritud pakkujat** kanoonilistes vestluse, meedia, otsingu, kohalike, pilve-agentide ja süsteemi kogudes, sealhulgas **152, mille juures on `hasFree: true` avastamismetaandmed**. Vestlusmudelite register hõlmab **229 pakkujat / 2554 unikaalset pakkuja-mudeli paari / 1283 töötlemata mudeli ID-d**; eraldiseisvas tasuta-eelarve kataloogis on **446 mudelipõhist rida**, **38 korduvat pooli** ja **53 korduvat/võtmevaba tasuta-igavesti pakkujat**. Need on erinevad nimetajad kavatsuslikult; definitsioonid ja pooli-dedupleeritud arvutused leiad [Pakkujate viitest](docs/reference/PROVIDER_REFERENCE.md) ja [Tasuta tasemetest](docs/reference/FREE_TIERS.md).

### 🏢 Igast suuremast laborist — läbi ühe otspunkti

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

_{…ja veel 330+ — iga ikoon laaditakse otse armatuurlaua pakkujate kataloogist. 📖 [Pakkujate viide](docs/reference/PROVIDER_REFERENCE.md)}
### 🆓 Tasuta igavesti — $0, kaarti ei vaja

OpenCode Zen _{DeepSeek V4, Nemotron 3 Ilma tokenite piiranguta}	Kilo Code _{Automaatne ruuter, Tencent Hy3 Tasuta igavesti}	Requesty _{GPT-OSS 120B, Nemotron Tasuta igavesti}	SiliconFlow _{DeepSeek V3.2 / R1 Tasuta tase}	Z.AI GLM _{GLM-4.7 / 4.5-Flash Tasuta igavesti}	Baidu ERNIE _{ERNIE 4.0 Tasuta igavesti}
Qoder AI _{Qwen3-Max, Kimi-K2 Piiramatult TASUTA}	Pollinations _{GPT, Llama, Claude Võtit ei vaja}	Cloudflare AI _{50+ mudelit 10K neuronit päevas}	NVIDIA NIM _{GLM, MiniMax ~40 RPM tasuta}	Cerebras _{GLM 4.7, GPT-OSS 1M tokenit päevas}	OpenRouter _{:free mudelid +$10 → kõrgem RPM}

📖 Täielik masinloetav kataloog → [`docs/reference/PROVIDER_REFERENCE.md`](docs/reference/PROVIDER_REFERENCE.md)

## 🖥️ Kus OmniRoute töötab — kõikjal

> Sama rakendus, sinu masin, sinu reeglid. Globaalsest npm-installist kuni **sinu telefonini** Termuxi vahendusel.

Platvorm	Paigaldamine	Eripärad
📦 npm (globaalne)	`npm install -g omniroute`	Üks käsklus, suvaline OS
🐳 Docker	`docker run … diegosouzapw/omniroute`	Multi-arhitektuurne AMD64 + ARM64
🖥️ Töölaud (Electron)	`npm run electron:build`	Native aken + süsteemisalv — Windows / macOS / Linux
💪 ARM	native `arm64`	Raspberry Pi, ARM-serverid, Apple Silicon
📱 Android (Termux)	`pkg install nodejs && npx -y omniroute`	Töötab sinu telefonis, 24/7, ilma root-õigusteta
📲 PWA	"Lisa avakuvale"	Täisekraan, võrguühenduseta, paigaldatav brauserist
🧩 OpenCode plugin	`@omniroute/opencode-provider`	Native OpenCode integratsioon
🤖 VS Code Copilot Chat	paigalda OmniCopilot laiendus	Iga OmniRoute'i mudel native Copilot Chati valikumenüüs — stabiilne & Insiders
🛠️ Lähtekoodist	`npm install && npm run dev`	Nokitse selle kallal, panusta

_{📖 [Docker'i juhend](docs/guides/DOCKER_GUIDE.md) · [Töölaud](electron/README.md) · [Termux](docs/guides/TERMUX_GUIDE.md) · [PWA](docs/guides/PWA_GUIDE.md) · [OpenCode](docs/frameworks/OPENCODE.md)}

### 🧩 Uus: OmniRoute VS Code'i native Copilot Chati sees

> Ei ühtegi uut kõrvalpaneeli, ei ühtegi uut vestlusliidest — iga mudel, mida OmniRoute pakub, > ilmub otse **Copilot Chati mudelivalijasse, mida sa juba kasutad**. Alates VS Code 1.122-st > töötavad pakkuja mudelid ilma GitHubi sisselogimiseta või Copiloti tellimuseta — agendirežiim, > tööriistade väljakutsumine ja visioon, tasuta. Paigalda laiendus **[OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)**, suuna see oma OmniRoute serverile (vaikimisi `localhost:20128`), ning ava seejärel Copilot Chat → mudelivalija → **Manage Models…** → **OmniRoute**.

Pood	Link	Töötab koos
🧩 VS Code Marketplace	Paigalda →	VS Code — stabiilne & Insiders
🔓 Open VSX Registry	Paigalda →	Cursor, Windsurf, VSCodium, Theia, code-server, Gitpod, Antigravity, Kiro…

Redaktori sees: ava vaade **Extensions**, otsi **"OmniRoute"**, klõpsa **Install** — töötab samamoodi mõlemas poes. Lähtekood, probleemid ja avaldamise juhend asuvad aadressil [diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot). _{📖 [VS Code Copilot Chati juhend](docs/guides/VSCODE-COPILOT.md) — seadistamine, mida valija näitab, armatuurlaud vahekaardil, veaotsing}

## 🔒 Privaatne ja kohalik ennekõike

_{📖 [Autoriseerimine](docs/architecture/AUTHZ_GUIDE.md) · [Turvapiirded](docs/security/GUARDRAILS.md) · [Vastavus](docs/security/COMPLIANCE.md)}

## 🔌 Täielik CLI + A2A & MCP

> Lisaks serverile on OmniRoute **täielik käsurea juhtpult** koos **80+ käsuga**, ning avatud agendiprotokollid, mis võimaldavad AI-agendil seda **iseseisvalt** juhtida. ### ⌨️ Tõeline CLI (mitte ainult `start`) ```bash omniroute # käivitab lüüsi + juhtpaneeli (port 20128) omniroute chat # interaktiivne TUI vestlusklient (kaldkriips: /model /combo /skill /memory) omniroute setup # juhendatud esmakäivituse viisard omniroute doctor # diagnoosib teenusepakkujaid, porte, natiivseid sõltuvusi ``` ### 🛰️ Kaugrežiim — käivita CLI siin, OmniRoute VPS-il OmniRoute serveris? Juhi seda oma sülearvutist **samaga CLI-ga**. Logi sisse ühe korra piiratud õigustega pöörduslubaga; iga järgnev käsk suunatakse siis kaugserverisse. ```bash omniroute connect 192.168.0.15 # parool → piiratud õigustega luba, salvestatakse kontekstina omniroute models list # ← töötab KAUGSERVERI vastu omniroute configure codex # ← valib kaugmudeli, kirjutab kohaliku Codexi profiili omniroute tokens create --name ci --scope read # loob kitsamad load teistele masinatele omniroute contexts use default # ← lülitub tagasi kohalikule serverile ``` Load on piiritletud õigustega `read` / `write` / `admin`; protsesse käivitavad rajad jäävad ainult loopback-ile. _{📖 [Kaugrežiim](docs/guides/REMOTE-MODE.md)}

Animated terminal demoing the OmniRoute CLI — omniroute providers list, omniroute combo list and omniroute health — cycling over the 86-command 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 …

### 🤝 Ühenda agent — ja see juhib OmniRoute'i ennast Ava OmniRoute üle **MCP**, **A2A**, **REST API**, **veebihaagiste (webhooks)** või **kaug-CLI** kaudu — iga võimekas agent (või oma kood) saab võtmed kogu lüüsi juurde: ruutimine, teenusepakkujad, kombinatsioonid, vahemälu, tihendus, mälu — kõik iseseisvalt. Allolevad HTTP lõpp-punktid on teenindatud aadressilt `http://localhost:20128`.

Liides	Lõpp-punkt / käsk	Kasutus
🧰 MCP (stdio)	`omniroute --mcp`	Ühenda Claude Desktopiga, Cursoriga, iga MCP kliendiga
🌊 MCP (HTTP)	`/api/mcp/stream`	Kauge MCP — 110 tööriista, 33 ulatust (jõustamine valikuline), täielik auditijälg
📡 MCP (SSE)	`/api/mcp/sse`	Voogesitatav MCP transport
🤝 A2A	`/.well-known/agent.json`	Agent-agent, JSON-RPC 2.0 + SSE, 6 oskust
🌐 REST API	`/v1/*`	OpenAI-ühilduv — vestlus, manustused, pildid, audio, OCR
🔔 Veebihaagised	`/api/webhooks`	Suunab päringu / kvoodi sündmusi Slacki, Discordi, Telegrami või mistahes URL-ile
🛰️ Kaug-CLI	`omniroute connect`	Juhi kaugeksemplari piiratud õigustega pöörduslubadega

```bash # Anna Claude Code'ile täielik OmniRoute'i tööriistastik MCP kaudu: 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) · [Agendiprotokollid](docs/frameworks/AGENT_PROTOCOLS_GUIDE.md)}

## 🗜️ Säästa 15–95% tokeneid — Automaatselt

### 📖 Kuidas see töötab — pipeline, arhitektuur ja säästuarvutus

OmniRoute'i tihendamise pipeline: illustratiivne 10 000-tokenine kliendipäring läbib 12 kombineeritavat mootorit — Session-Dedup, CCR, Lite, RTK, Responses Tool Output, Headroom, Relevance, Caveman, Aggressive, LLMLingua-2, Ultra ja OmniGlyph — ja jõuab pakkujani dokumenteeritud pinutatud näites umbes 1080 tokeniga. Struktureeritud sisu on kaitstud säilitusvalvurite ja iga etapi täpsusväravatega; selgesõnalised kahjustavad või eksperimentaalsed režiimid võivad sobivat sisu muundada.

Vaikimisi pinutatud kombo käivitab `RTK → Caveman`. Kui mõlemad mõjutavad sama tööriista/konteksti sisu, säästud kumuleeruvad: ```txt combined = 1 − (1 − RTK) × (1 − Caveman_input) average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2% range = 78.4 – 94.6% ``` Koodiplokid, URL-id, JSON ja struktureeritud andmed on **alati kaitstud** säilitusmootori poolt. > **Milleks kasutada palju tokeneid, kui vähestest piisab?** Iga päring läbib OmniRoute'i tihendamise pipeline'i **läbipaistvalt** — kliendipoolseid muudatusi ei vaja. See on nüüd **12 kombineeritava mootori pakett**, mis töötavad järjekorras ja segunevad vastavalt marsruutimiskombole — tuginedes ideedele projektidest [RTK](https://github.com/rtk-ai/rtk), [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ 90K+), [LLMLingua-2](https://github.com/microsoft/LLMLingua) ja [Troglodita](https://github.com/leninejunior/troglodita) (PT-BR). ### 🧱 12-mootoriline pakett Mootorid töötavad pipeline-järjekorras; igaüht saab iseseisvalt sisse/välja lülitada ja konfigureerida vastavalt kombole:

#	Mootor	Mida see teeb
1	Session-Dedup	Eemaldab vooru vältel korduva sisu (sisu-aadresseeritud, voorude vaheline)
2	CCR	Arhiveerib suured plokid otsingumarkerite taha, tuuakse vajadusel
3	Lite	Tühikute ja pildi-URL-ide kärpimine (kerge latentsusega baastase)
4	RTK	Nutikas tööriistatulemuste filtreerimine, dubleerimise vältimine ja kärpimine (käsu-teadlik)
5	Responses Tool Output	Esmajärjekorras kadudeta JSON + piiratud diagnostiline tihendamine shell/patch/otsing/build väljundite jaoks (Responses API)
6	Headroom	Kadudeta tabelikujuline JSON-massiivide tihendamine (~30%) integreeritud GCF koodeki abil
7	Relevance	Ekstraktiivne lausete hindamine viimase kasutajapäringu suhtes
8	Caveman	Reeglipõhine proosa tihendamine (~65–75% väljundist)
9	Aggressive	Kokkuvõtete tegemine + vanade voorude järkjärguline "vananemine"
10	LLMLingua-2	ML-põhine semantiline kärpimine MobileBERT ONNX kaudu — koodiohutu, asünkroonne
11	Ultra	Heuristiline tokenite kärpimine valikulise väikese mudeli (SLM) tasemega
12	OmniGlyph	Eksperimentaalne konteksti-kui-pildi kodeerimine, mõõdetud Claude Fable 5 peal otsesel Anthropic liinil; GPT 5.6 transformerid jäävad turvalisuse mõttes suletuks, kuni pakkuja kinnitused saabuvad. Neli tihendusprofiili (agressiivne vaikimisi, tasakaalustatud, koodiohutu, läbilaskev) (agressiivseim; opt-in)

Koodiplokid, URL-id ja struktureeritud andmed on **alati säilitatud** täpselt bait-täpselt. **Ühe klikiga eelseaded** kombineerivad mootoreid:

Režiim	Sääst	Sobib kõige paremini
🪶 Lite	~15%	Alati sisse lülitatud ohutu vaikeväärtus
🪨 Standard (Caveman)	~30%	Igapäevane kodeerimine
⚡ Aggressive	~50%	Pikad tööriistarohked sessioonid
🔥 Ultra	~75%	Maksimaalne sääst
🧰 RTK	60–90%	Shell/test/build/git väljund
🔗 Pinutatud (RTK → Caveman)	78–95%	Segatud päringud + tööriistalogid

**Reaalne näide — Standard režiim:** > **Enne (69 tokenit):** _"The reason your React component is re-rendering is likely because you're creating a new object reference on each render cycle. When you pass an inline object as a prop, React's shallow comparison sees it as a different object every time, which triggers a re-render. I would recommend using useMemo to memoize the object."_ > > **Pärast (19 tokenit):** _"New object ref each render. Inline object prop = new ref = re-render. Wrap in useMemo."_ > > **Sama vastus. 72% vähem tokeneid. Täpsust ei kaotatud.** ✅ **PT-BR näide — [Troglodita](https://github.com/leninejunior/troglodita) režiim:** > **Antes (42 tokens):** _"O problema é que o componente está re-renderizando porque uma nova referência de objeto está sendo criada em cada ciclo de renderização. Eu recomendaria usar useMemo."_ > > **Depois (12 tokens):** _"Re-render: ref nova cada ciclo (objeto inline recriado). Usar `useMemo`."_ > > **Mesma resposta. ~70% menos tokens. Precisão técnica intacta.** ✅
### 🎚️ Rohkem kui mootorid — väljundistiilid, adaptiivne regulaator ja päringupõhine juhtimine Ülalpool kirjeldatud 12 mootorit vähendavad seda, mis läheb **sisse**. Veel kolm kihti kujundavad **kuidas**, **millal**, ja mis tuleb **välja**: - **🪄 Väljundistiilid** _(väljundi-teljel juhtimine)_ — süstivad deterministlikke, vahemällu-ohutuid vastuse-kujundamise juhiseid; kombineeritavad, igaüks intensiivsusega `lite` / `full` / `ultra`. Uue stiili lisamine on üherealine registrikirje: - **Napp proosa** — jäta ära täitesõnad / artiklid / vahtimine; hoia tehniline sisu täpsena. - **Vähem koodi** — "laisk vanem arendaja" YAGNI: väikseim toimiv muudatus, ei mingit tellimata skafoldi. - **Ponytail (laisk vanem arendaja)** — tõuse YAGNI-redelil, kõrvalda algpõhjus, väikseim toimiv diff. - **I have ADHD (action-first)** — järgmine tegevus ees, sammud nummerdatud, üks konkreetne järgmine samm, ei mingit sissejuhatust. - **Napp CJK (文言)** — klassikaline hiina ultra-napp stiil (lokaadipõhiselt lubatud vaid `zh`). - **🎯 Adaptiivne konteksti-eelarve** _(regulaator)_ — ühe sisse/välja tokenipiiri asemel eskaleeritakse ainult kõige odavamaid, kõige kadudeta mootoreid vajaduse korras, et **mahutada mudeli kontekstiaknasse**. Poliitika: `reserve-output` (vaikimisi, mudeli-teadlik) · `percentage` · `absolute`. Režiim: `floor` (garanteerib mahtumise) · `replace-autotrigger` (sinu selgesõnaline valik võidab) · `off` (pärandi künnisväärtus). - **🎛️ Kus tihendamine otsustatakse** _(prioriteetsus, kõrgeimast madalaimani)_ — päringupõhine `x-omniroute-compression` päis › marsruutimiskombo ülekirjutus › aktiivne nimeline profiil › adaptiivne / automaatpäästik › paneeli vaikeväärtus › väljas. Rakendatud plaan kajastub `X-OmniRoute-Compression: ; source=` vastuse päises. Käivita automaatselt tokenipiiri järgi, lülita sisse adaptiivne regulaator, kinnita nimeline profiil, sea ühekordne väärtus konkreetseks päringuks või määra pipeline marsruutimiskombo kohta — vastavalt sellele, mis tööks sobib. Opt-in võrguühenduseta **hindamisraamistik** (`npm run eval:compression`) hindab täpsust vs säästu fikseeritud korpusel enne muudatuse rakendamist. 📖 [`COMPRESSION_GUIDE.md`](docs/compression/COMPRESSION_GUIDE.md) · [`RTK_COMPRESSION.md`](docs/compression/RTK_COMPRESSION.md) · [`COMPRESSION_ENGINES.md`](docs/compression/COMPRESSION_ENGINES.md)

# ⚡ Kiirstart

**1) Paigalda ja käivita** ```bash npm install -g omniroute omniroute ``` > 💡 Nägid `npm warn ERESOLVE` või sõltuvuste (peer-dep) hoiatusi? [Need on ohutud](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated). Töölaud aadressil `http://localhost:20128` · API aadressil `http://localhost:20128/v1`. **2) Ühenda TASUTA pakkuja (registreerumist ei vaja)** Töölaud → **Providers** → ühenda **Kiro AI** (tasuta Claude, ~50 krediiti/kuu konto kohta) või **OpenCode Free** (autentimist ei vaja) → valmis. **3) Suuna oma kodeerimistööriist** ```txt Base URL: http://localhost:20128/v1 API Key: [kopeeri Töölaud → Endpoints] Model: auto (nullkonfiguratsiooniga nutikas marsruutimine — või mis tahes pakkuja/mudel) ``` **4) Kontrolli, kas see töötab** ```bash curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY" ``` Peaksid näha saama oma ühendatud mudelite loetelu. 🎉 See on kõik — alusta kodeerimist, OmniRoute marsruutib ja teeb tagavaravariante sinu eest automaatselt. Kui sinu klient ei saa saata kohandatud päiseid, pakub OmniRoute ka tokenistatud ühilduvusaliaseid: ```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 ``` Kasuta neid vaid klientide jaoks, mis ei saa lisada `Authorization: Bearer ...` päist. Päisega autentimine on jätkuvalt soositud viis.
## 📦 Rohkem paigaldusviise — Docker, lähtekood, 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` järgib kõrgeimat **avaldatud** stabiilset SemVer versiooni. See ei jälgi git `main` haru. Kasuta GitOps'i jaoks fikseeritud `:X.Y.Z` versiooni. Vaata [Docker Release Channels](docs/guides/DOCKER_GUIDE.md#release-channels).Image fikseerib **`OMNIROUTE_MEMORY_MB=1024`**. Sellest jätkub töölaua ja kerge vestluse jaoks. **Koodiagentidele** (`POST /v1/responses` Claude Code'ist, Codex'ist, Grok'ist jt) on vaja märkimisväärselt suuremat V8 heap'i, vastasel juhul protsess lõpetab tööga **FATAL ERROR** ~12 GiB juures kahe kattuva pika konteksti korral. Määra konteinerile heap'ist suurem maht (natiivpuhvrid asuvad V8-st väljas): | Töökoormus | Heap (`-e OMNIROUTE_MEMORY_MB`) | Konteiner (`--memory`) | | ------------------------------------------------ | ------------------------------- | ---------------------- | | Töölaud / kerge vestlus | `1024` (image'i vaikeväärtus) | ≥2 g | | Üks koodiagent | `8192` | ≥10 g | | Kaks paralleelset pikka `/v1/responses` päringut | `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äielik tabel: [Docker Guide — runtime RAM](docs/guides/DOCKER_GUIDE.md#runtime-ram-for-coding-agents). > **Docker'i eelväljalaske kanal:** `diegosouzapw/omniroute:next` ja > `diegosouzapw/omniroute:next-web` järgivad praegust vaikimisi `release/v*` > haru. Need muutuvad tagid on mõeldud ainult avaldamata parandustega > testimiseks ega ole toetatud tootmiskeskkonnas. Vaata > [Docker Release Channels](docs/guides/DOCKER_GUIDE.md#release-channels). **🥟 Bun** Standardne `bun install` ja globaalne paigaldus (`bun install -g omniroute`) on toetatud Bun runtime'i tuvastamise abil: - **Sisseehitatud `bun:sqlite`**: OmniRoute kasutab Buni sisseehitatud `bun:sqlite` draiverit, kui töötab Buni all, ning langeb tagasi `better-sqlite3` peale Node.js-il või `sql.js` peale. - **Automaatne Webpack bundleri valik dev-režiimis**: Arendusrežiim (`bun run dev`) tuvastab automaatselt Buni ja lülitab Turbopacki välja, kasutades selle asemel Webpacki, et vältida natiivsete V8 seoste ühilduvusprobleeme. Tootmisbuildid (`bun run build`) järgivad `OMNIROUTE_USE_TURBOPACK` täpselt nagu Node'iga: vaikimisi Turbopack, `OMNIROUTE_USE_TURBOPACK=0` build'imiseks Webpackiga (`Dockerfile.bun` teeb selle kättesaadavaks `--build-arg`-na). - **Eraldi Bun Dockerfile**: Mitmeetapiline `Dockerfile.bun` natiivsete Buni tootmiskeskkonna juurutuste jaoks (`docker build -f Dockerfile.bun -t omniroute:bun .`). ```bash # Paigalda ja käivita Bun'iga bun install bun run dev ``` **🛠️ Lähtekoodist** ```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 # Kasutades Nix flake'e nix develop npm run dev # Või kasutades devbox'i devbox run npm run dev ``` 📖 [Docker Guide](docs/guides/DOCKER_GUIDE.md) — Compose profiilid, Caddy HTTPS, Cloudflare tunnelid. **🦭 Podman** ```bash # 1. Valmista ette bind-mount'itud andmekataloog mkdir -p data # 2. Ainult Linux + kohalik rootless Podman (ei kunagi kaugjuhitav Podman Machine klient): podman unshare chown 1000:1000 ./data # 3. Määra runtime vihje, koosta kohalik Compose image ja käivita echo "CONTAINER_HOST=podman" >> .env podman compose --profile base up -d --build ``` macOS'is või Windowsis kasutab Podman kaugjuhitavat Podman Machine't: jäta `podman unshare` vahele ja järgi [topoloogiaspetsiifilisi andmekataloogi juhiseid](contrib/podman/README.md#data-directory-permissions-by-topology). 📖 [Podman Guide](contrib/podman/README.md) — Compose buildid, Podman Machine ja Linux/systemd Quadlet seadistus. **⚡ Kiirem / kergem paigaldus (jäta natiivehitus vahele)** Natiivne SQLite mootor (`better-sqlite3`) on **valikuline** sõltuvus, seega globaalne paigaldus ei jää kunagi lähtekoodist kompileerimise taha ootama: see kasutab eelehitatud binaari, kui üks vastab sinu platvormile/Node'ile, ja vastasel juhul langeb sujuvalt tagasi puhta JS mootori peale (`node:sqlite` Node 22+ puhul, muidu kaasasolev `sql.js` WASM) — ehitustööriistu ei ole vaja. Et jätta paigaldusjärgne natiivne soojenduskäivitus täielikult vahele (CI, ekraanivaba või aeglane masin): ```bash OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute # CI=1 jätab selle samuti vahele ``` Kiireima paigalduse jaoks eelista **pnpm** (sisu-aadressitud pood + hard linkid — vaata eespool). Töölauavaba, ekraanivaba runtime'i jaoks kasuta Dockeri `base` profiili (eespool) või [Termux'i juhendit](docs/guides/TERMUX_GUIDE.md). CLI ja veebipõhine töölaud teenindatakse samast protsessist ühel pordil, seega eraldi CLI-ainult paketti praegu ei ole.

# 🎬 OmniRoute tegevuses

## 📹 Videojuhendid

_{Paneeli hetktõmmis 2026-08-24 seisuga · Toorkataloog: YT 809 | TT 137 | IG 124 · Värskus (päevades): YT 1 | TT 21 | IG 22}

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

🎬 #2 — Instagram
_{theopenstack — 692 419 vaatamist}

🎬 #3 — TikTok
_{milesreevesai — 620 400 vaatamist}

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

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

**Täielik edetabel (deduplitseeritud kanoonilised URL-id, `v > 0`, suurima haardega):** | #1 | #2 | #3 | #4 | #5 | | -------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | | [nick_saraev — Instagram](https://www.instagram.com/reel/Da8ZthUPK98/) — **3 042 474** | [theopenstack — Instagram](https://www.instagram.com/reel/DaSs65mMrHk/) — **692 419** | [milesreevesai — TikTok](https://www.tiktok.com/@milesreevesai/video/7667980059189366019) — **620 400** | [Vaibhav Sisinty — YouTube](https://www.youtube.com/watch?v=QucgvbO5gsM) — **391 109** | [buildwithai.club — Instagram](https://www.instagram.com/reel/DbIt9AjK7-U/) — **347 652** | | #6 | #7 | #8 | #9 | #10 | | ----------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | | [nivedan.ai — Instagram](https://www.instagram.com/reel/DbIrCksJiqq/) — **331 973** | [vaibhavsisinty — Instagram](https://www.instagram.com/reel/Dae05TSAK1l/) — **263 744** | [Nick Automates — YouTube Shorts](https://www.youtube.com/shorts/fZIBK_4fKq8) — **218 174** | [theroshankrishna — Instagram](https://www.instagram.com/reel/Dapjs58z0P0/) — **186 786** | [midudev — TikTok](https://www.tiktok.com/@midudev/video/7664636453544152342) — **177 800** | Kanoonilised näitajad 2026-08-24 seisuga: **1029 unikaalset videot** · **11 132 922 teadaolevat vaatamist** (`v > 0`) · **639 kanalit/profiili võrgustiku kohta**. Toorpaneel sisaldab 1070 rida; 41 Instagrami duplikaati normaliseeriti kanoonilise URL-i alusel, säilitades igale videole suurima loenduse. > 🎬 **Tegid OmniRoute'ist video?** Ava [issue](https://github.com/diegosouzapw/OmniRoute/issues/new) või [arutelu](https://github.com/diegosouzapw/OmniRoute/discussions), lisades lingi — toome selle siin esile.

# 📧 Kogukond ja abi > Kõik ühes kohas — jälgi haldajat, vestle kogukonnaga või ava issue. | Kanal | Kus / kuidas | | ----------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- | | 💼 **LinkedIn** — jälgi haldajat | [linkedin.com/in/diegosouzapw](https://www.linkedin.com/in/diegosouzapw/) | | 🐙 **GitHub** — jälgi väljalaskeid ja nõuandeid | [@diegosouzapw](https://github.com/diegosouzapw) | | 💬 **Discord** | [discord.gg/U47eFqAXCn](https://discord.gg/U47eFqAXCn) | | ✈️ **Telegram** | [t.me/omnirouteOficial](https://t.me/omnirouteOficial) | | 🟢 **WhatsApp — 🌍 Globaalne** | [liitu grupiga](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) | | 🟢 **WhatsApp — 🇧🇷 Brasiilia** | [liitu grupiga](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) | | 🌍 **Veebisait** | [omniroute.online](https://omniroute.online) | | 🌍 **🌍StHub OmniRoute kogukond (tasuta)** | [portal sthub](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK) | | 📦 **Lähtekood** | [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute) | | 🐛 **Teata veast** | [ava issue](https://github.com/diegosouzapw/OmniRoute/issues) — lisa `npm run system-info` väljund | | 🤝 **Panusta projekti** | [CONTRIBUTING.md](CONTRIBUTING.md) · [Hargnemis- ja väljalaskemudel](docs/ops/BRANCHING_MODEL.md) · vali `good first issue` | | 💚 **Toeta projekti** | [Toetamise võimalused ↑](#-support-omniroute) · [GitHub Sponsors](https://github.com/sponsors/diegosouzapw) |

---

## 🛠️ Tehnoloogiapakett

Kiht	Tehnoloogia
Käitusaeg	Node.js 22.x / 24.x LTS — `>=22.22.2 <23 \|\| >=24.0.0 <27`
Keel	TypeScript 6.0 — 100% TypeScript kataloogides `src/` ja `open-sse/` (alates versioonist v2.0 puudub tuumas `any`)
Raamistik	Next.js 16 + React 19 + Tailwind CSS 4
Andmebaas	better-sqlite3 (SQLite, WAL päevikupidamine) + LowDB (JSON, pärandlahendus) — 122 valdkonnamoodulit, 168 migratsiooni
Mälu	SQLite FTS5 täistekstiotsing + int8-kvantitud vektorkoodingud, tüübitundlik hääbumine
Skeemid	Zod 4 — MCP tööriistade sisend-/väljundvalideerimine + API lepingud
Protokollid	MCP (stdio / HTTP / SSE) + A2A v0.3 (JSON-RPC 2.0 + SSE)
Voogesitus	Server-Sent Events (SSE) + WebSocket-ühenduslüli (`/v1/ws`)
Pakkimine	12-mootoriline torustik — RTK, Caveman, LLMLingua-2 (MobileBERT ONNX), GCF, OmniGlyph
Autentimine ja turve	OAuth 2.0 (PKCE) + JWT + API võtmed + MCP piiratud õigustega autentimine · AES-256-GCM salvestamisel · DOMPurify
Varjamine	wreq-js — JA3 / JA4 TLS-jäljendite matkimine, 3-tasandiline proksisüsteem
Vastupidavus	Vooluahela katkestaja, eksponentsiaalne tagasilangus, "thundering herd" efekti vältimine, automaatne enesetervenemine (auto-combo)
Logimine	pino — struktureeritud JSON-logid koos päringu kontekstiga
Testimine	Node.js testijooksutaja + Vitest — üle 39 000 staatilise testideklaratsiooni enam kui 5100 jälgitavas testifailis (üksus-, integratsiooni-, E2E-, turva- ja ekosüsteemitestid)
Platvormid	Töölaud (Electron) · Android (Termux) · PWA (mis tahes brauser)
CI/CD	GitHub Actions — automaatne npm-avaldamine + Docker Hub väljalaskmisel
Lingid	Veebisait · npm · Docker Hub

## 📖 Dokumentatsioon

### 📘 Alustamine

Dokument	Kirjeldus
Kasutusjuhend	Pakkujad, kombod, käsurea liidesed, juurutamine
Seadistusjuhend	Kõik paigaldusmeetodid, käsurea tööriistade seadistused, protokolli seadistus, ajapiirangute häälestus
Käsurea tööriistade juhend	Iga tööriista seadistus: Claude Code, Codex, Cursor, Cline, OpenClaw, Kilo, Copilot
Kaugrežiim	Halda kaugsuse OmniRoute't (VPS) sülearvuti käsurealt piiratud pöörduslubadega
Claude Code seadistus	Suuna Claude Code OmniRoute'ile (kohalik/kauge) kasutades `launch` käsku ja mudelipõhiseid profiile
Kiirjuhend	3-astmeline paigaldus → ühendamine → seadistamine

### 🔧 Haldus ja juurutamine

Dokument	Kirjeldus
Docker juhend	Docker run, Compose profiilid, Caddy HTTPS, tunnelid, kujutiste sildid
Podman juhend	Quadlet systemd integratsioon, podman-compose, SELinux
Virtuaalmasina juurutus	Täielik juhend: virtuaalmasin + nginx + Cloudflare seadistus
Fly.io juurutus	Juuruta Fly.io platvormile püsivate andmesalvestuslahendustega
Termux juhend	Käivita OmniRoute Androidil Termuxi kaudu
PWA juhend	Progressiivse veebirakenduse paigaldus, vahemällu salvestamine, arhitektuur
Eemaldamise juhend	Puhas eemaldamine kõikide paigaldusmeetodite jaoks
Keskkonna seadistus	Kõik `.env` muutujad ja viited

### 🧠 Funktsioonid ja arhitektuur

Dokument	Kirjeldus
Arhitektuur	Süsteemi arhitektuur, andmevoog ja sisemine ülesehitus
Pakkimisjuhend	7 valikuvõimalusega torustik: off / lite / standard / aggressive / ultra / RTK / stacked
RTK pakkimine	Käsu väljundi pakkimine, filtrid, usaldus, kinnitamine, algse väljundi taastamine
Pakkimismootorid	Caveman, RTK, kihilised torustikud, juhtpaneeli/API/MCP liidesed
Pakkimisreeglite vorming	JSON-reeglipakettide skeemid Caveman ja RTK filtrite jaoks
Pakkimise keelepaketid	Keele tuvastamine ja Caveman'i reeglipakettide loomine
Vastupidavuse juhend	Vooluahela katkestajad, jahutumisajad, järjekord, "thundering herd" efekti vältimine, TLS-jäljendite matkimine
Auto-Combo mootor	16-teguriline hindamine, režiimipaketid, enesetervenemine
Proksijuhend	3-tasandiline proksisüsteem, 1proxy turg, registri CRUD-toimingud
Tasuta tasandid	Koondkataloog: 38 dokumenteeritud korduvat pakkumist / 446 kataloogitud tasuta tasandi kannet
Funktsioonide galerii	Visuaalne juhtpaneeli tuur koos ekraanipiltidega
Lähtekoodi dokumentatsioon	Algajasõbralik lähtekoodi ülevaade

### 🤖 Protokollid ja API-d

Dokument	Kirjeldus
API viide	Kõik lõpp-punktid koos näidetega
OpenAPI spetsifikatsioon	OpenAPI 3.0 spetsifikatsioon
MCP server	110 MCP tööriista, IDE seadistused, Python/TS/Go kliendid
MCP serveri juhend	MCP paigaldus, transpordimeetodid ja tööriistade viited
A2A server	JSON-RPC 2.0 protokoll, oskused, voogesitus, ülesannete haldus
A2A serveri juhend	A2A agendikaart, ülesanded, oskused ja voogesitus

### 📋 Projekt ja kvaliteet

Dokument	Kirjeldus
Panustamine	Arenduskeskkonna seadistus ja juhised
Hargnemis- ja väljalaskemudel	Kuhu PR-id suunatakse (`release/*`), mida tähendavad `main` haru ja märgistused (tags)
Muudatuste logi	Täielik iga versiooni väljalaske ajalugu
Turvapoliitika	Turvaaukudest teatamine ja turvatavad
i18n juhend	42 keele tugi, tõlkeprotsess, RTL-tugi
Väljalaske kontrollnimekiri	Väljalaske-eelse valideerimise etapid
Katvusplaan	Testikatvuse strateegia enam kui 39 000 staatilise testideklaratsiooni jaoks enam kui 5100 jälgitavas testifailis

# ⭐ Parimad panustajad > OmniRoute'i kujundab kirglik avatud lähtekoodi kogukond. Need inimesed on andnud erakordse panuse, mis mõjutab otseselt projekti kvaliteeti, stabiilsust ja haardeulatust. **Suur tänu.** ### Väliste panustajate liitmispõhised pull request'id

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

_{Fikseeritud haru release/v3.8.50 tipus dafb4ae808, liitmistega kuni 2026-08-24 05:26:03 UTC. Lehitatav GitHubi GraphQL kokkuvõte hõlmab 5911 liidetud PR-i: 2707 hoidla omanikult, 179 Dependabotilt ja 3025 väliselt PR-i 535 erineva panustajalt. "Muudetud ridu" tähendab GitHubi lisatud + eemaldatud ridade summat ja sisaldab genereeritud faile, lukustusfaile (lockfiles), katalooge, tõlkeid ja dokumentatsiooni; see on koodi ringlus, mitte autorlusega loodud koodiridade arv (LOC). Piirdaeg viigid on säilitatud.} ### GitHubile omistatud commitid

backryun _{🥇 220 GitHubile omistatud commitit}	Paijo _{🥈 219 GitHubile omistatud commitit}	Randi _{🥉 108 GitHubile omistatud commitit}	Ravi Tharuma _{🏅 81 GitHubile omistatud commitit}	Chris _{🏅 70 GitHubile omistatud commitit}	Markus Hartung _{🏅 69 GitHubile omistatud commitit · jagab 6. kohta}
Dizzle _{🏅 69 GitHubile omistatud commitit · jagab 6. kohta}	Jan Leon _{🏅 64 GitHubile omistatud commitit}	zenobit _{🏅 62 GitHubile omistatud commitit}	Bob.Hou _{🏅 51 GitHubile omistatud commitit · jagab 10. kohta}	Xiangzhe _{🏅 51 GitHubile omistatud commitit · jagab 10. kohta}

_{Uuesti kontrollitud 2026-08-24 06:14:31 UTC seisuga: GitHubile omistatud commitid, mis on saadud hoidla Contributors API-st haru release/v3.8.50 vaikeharu kohta. API tagastas 525 identiteeti (415 kasutajat, 2 robotit, 108 anonüümset); see tabel jätab välja hooldaja, robotid ja anonüümsed identiteedid, kuid säilitab viigid. See erineb nii ülaltoodud liidetud PR-ide edetabelist kui ka allpool olevast 639-liikmelisest Git-metaandmete kokkuvõttest.} > 🙏 Nende panustajate funktsioonid, veaparandused ja infrastruktuuri täiendused on **oluline osa** sellest, mis teeb OmniRoute'i usaldusväärseks ja funktsioonirikkaks. Iga pull request, iga testjuhtum ja iga i18n tõlkefail on tähtis. Avatud lähtekood on ehitatud selliste inimeste poolt.

---
## 💖 Sponsorid

Südamlik tänu inimestele, kes rahastavad OmniRoute't oma taskust — igaüks nendest panustustest hoiab projekti tasuta, sõltumatuna ja liikumas.

Andrew
_{💛 Aktiivne igakuine sponsor}

Vlad I
_{💛 Aktiivne igakuine sponsor}

Paco Cartones
_{💛 Aktiivne ühekordne sponsor}

Prof. Igor Morais
_{💛 Endine ühekordne toetaja}

longtao
_{💛 Endine ühekordne toetaja}

_{… ja teised, kes soovivad jääda anonüümseks 💛} _{Avalikud GitHub Sponsorid kinnitati uuesti 24.08.2026. GitHubi activeOnly olek määrab ülaltoodud aktiivsed märgised; varem avalikustatud avalikud ühekordsed toetajad on jätkuvalt ära tänatud, ja erasponsorid jäävad anonüümseks.} 💖 Hakka sponsoriks → — igaüks dollarist hoiab OmniRoute'i tasuta ja sõltumatuna.

## 👥 600+ Kaastöölist

[![Contributors](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=639&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors) _{Auditeeritud 24.08.2026 külmutatud baasil ac02c5b42f ja korduskontroll live release/v3.8.50 tipuga dafb4ae808: 639 normaliseeritud inimlikku Git-identiteeti — 407 esineb commitide autoritena (kaasa arvatud haldaja) ja 232 vaid otsestes Co-authored-by järgmärgetes. Loendus normaliseerib GitHubi noreply-aadressid, jätab välja 26 boti/agendi/teenuse/asendusidentiteeti ning ei liida tavalisi e-posti aadresse ainuüksi seetõttu, et nende kuvatavad nimed ühtivad.} ### Kuidas kaasa aidata 1. Fork'i repositoorium 2. Loo hargnemine **aktiivse** `release/vX.Y.Z` tipu põhjal (mitte `main`-ist) — vaata [Hargnemise ja väljalaske mudel](docs/ops/BRANCHING_MODEL.md) 3. Loo oma funktsioonide haru (`git checkout -b feat/amazing-feature`) 4. Kinnita oma muudatused (`git commit -m 'feat: add amazing feature'`) 5. Lükka haru serverisse (`git push origin feat/amazing-feature`) 6. Ava Pull Request, kus **base = see `release/vX.Y.Z` haru** Vaata [CONTRIBUTING.md](CONTRIBUTING.md) üksikasjalikke juhiseid. ### Uue versiooni väljalaskmine ```bash # Loo väljalase — npm publish toimub automaatselt VERSION=x.y.z gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes ```

## 📊 Tähed

## 🌍 StarMapper

## 🙏 Tänuavaldused

OmniRoute toetub hiiglaste õlgadele. See sai alguse **[9router](https://github.com/decolua/9router)** hargnemisena ja Go projekti **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** TypeScript-porditisena — ja sealt edasi on iga allpool nimetatud allsüsteem saanud inspiratsiooni avatud lähtekoodiga projektist, mis jõudis sinna esimesena. Igaüks neist kujundas OmniRoute'i konkreetse osa. See on meie tänu kõigile neile. 🙏 > ⭐ tähtede arv on kontrollitud GitHubi REST API-st 24. augustil 2026 — käige neile projektidele tärn andmas. Arvud on täpne dateeritud hetktõmmis ja muutuvad loomulikult ajas. ### 🧬 Päritolu ja lüüs (gateway)

Projekt	⭐	Kuidas see OmniRoute'i inspireeris
9router	26 161	Algne projekt, millel see hargnemine põhineb — siin laiendatud multimodaalsete API-de ja täieliku TypeScript-ümberkirjutusega.
CLIProxyAPI	48 497	Go-implementatsioon, mis inspireeris seda JavaScript / TypeScript porti.
LiteLLM	57 100	AI-lüüs, mille avaliku hinnaandmestiku andmed toidavad meie kulujälgimise sünkroonimist ja mille teenusepakkuja-normaliseerimise mudel mõjutas meie ruutimist.
codex-chatgpt-web	1 410	MIT-lähtekood, mis on kohandatud sisseehitatud ChatGPT Web → Codex Responses sillaks, sealhulgas brauseri-seansi, vastuse-vormistuse, kasutuse ja veebiotsingu adapterid.
free-claude-code	48 112	Mustrid, mis on porditud voo taastamisse, "no-thinking" pseudonüümidesse, varuveebiotsingusse, liuguraakna piirangutesse, logide varjamisse ja tugevdatud käivitusvoogudesse.
composer-api	322	Cursor Composer'i tööriistavaliku, väljundipiirangute ja tööriista-kinnituse mustrid, mis on kohandatud pärisliku Cursor-täitja jaoks.
codex-multi-auth	457	Värske sisselogimise ja värskendustoken'i rotatsiooni mustrid, porditud Codex OAuth taastautentimisse.
opencode-anthropic-auth	510	Claude Code-ga ühilduvad teisendusvaikeväärtused ja arveldus-päise käitumine, üldistatud OmniRoute'i konfiguratsioonipõhisesse sillasse.
grok2api-merged	2	Selle Grok mudeli kaardistused, võlts-TypeError Statsig generaator, päringu- ja seadme vaikeväärtused ning NDJSON vastuse töötleja on sisuliselt kohandatud OmniRoute'i Grok Web täitja jaoks.
TQZHR/grok2api	705	grok2api-merged'i peamine transitiivne lähtekoodi allikas; selle mudeli, päise, koorma, Statsigi ja töötleja implementatsioonid on säilinud Grok Web pärandliinis.
chenyme/grok2api	7 520	Aluseks olev MIT-lähtekood Grok koorma ja seadme vaikeväärtuste, Statsig generaatori ning `result.response` töötleja jaoks, mis on kantud üle TQZHR ja grok2api-merged kaudu.
grok2api-pro	27	Transitiivne allikas, mille grok2api-merged tunnustab proksi-puuli kihi eest; OmniRoute säilitab selle pärandimärke, kuid ei väida oma piiratud Grok Web täitjas proksi-puuli porti.
GrokProxy	50	Selle küpsise-autentimisega Grok proksi ja `result.response.token` voogesitusmuster mõjutasid OmniRoute'i Grok Web transporti.
GrokBridge	5	Algne Grok Web implementatsioon konsulteeris selle HTTP/brauseri-põhise ülemvoo disainiga; selle otsene HTTP tee tuleneb GrokProxy'st, seega ei väidetaks siin sõltumatut koodiporti.
grok-web-api	14	Selle Rust `ChatOptions` ja vastuse-ümbriku skeemid mõjutasid OmniRoute'i TypeScript Grok päringu- ja voogesitus-vastuse tüüpe.

### 🗜️ Kontekst ja tokenite tihendamine — mootorid

Projekt	⭐	Kuidas see OmniRoute'i inspireeris
Caveman	100 538	Viraalne "miks kasutada palju tokenit, kui vähe tokenit teeb ka trikki" projekt — selle koopamehe-kõne filosoofia toidab meie standardset tihendusrežiimi ja 30+ täite-/kondenseerimisreeglit.
RTK – Rust Token Killer	77 185	Kõrge jõudlusega käsurea-väljundi tihendamine — inspireeris meie RTK mootorit, JSON-filtri DSL-i, töötlemata väljundi taastamist ja pinnatud RTK → Caveman torustikku.
headroom	67 310	Pööratav kontekstitihendus (SmartCrusher) — inspireeris meie `headroom` mootorit ja `ccr` taastemarkeri mustrit.
LLMLingua	6 598	Promptide tihendamise teadusuuringud (LLMLingua / LLMLingua-2) — inspireeris meie asünkroonset, koodiohutut ja tõrkeohutut `llmlingua` mootorit.
llmlingua-2-js	31	JS/ONNX port (MobileBERT / XLM-RoBERTa), mida kasutatakse meie LLMLingua mootori tööniidi (worker-thread) taustsüsteemina.
Troglodita	40	PT-BR tokenite tihendus — toidab meie pt-BR keelepaketti: pleonasmide vähendamine ja täitesõnade eemaldamine, häälestatud Brasiilia portugali grammatikale.
ponytail	108 957	Viraalne "laisa senior-arendaja" YAGNI-oskus — inspireeris meie less-code väljundistiili: väikseima toimiva muudatuse juhtimist, mis kärbib _genereeritud_ koodi (väljundi-telje vaste Caveman'i lühikesele proosale).
i-have-adhd	23 526	Selle tegevuseelistav, ADHD-sõbralik vastusestiil on kohandatud OmniRoute'i kompaktseks väljundistiiliks viies keeles.

### 🧩 Kompaktsed vormingud, tokenite uuringud ja koodile teadlik tööriistastik

Projekt	⭐	Kuidas see OmniRoute'i inspireeris
TOON	25 233	Token-Oriented Object Notation — selle veerulise, päis-pluss-ridade mudel kujundas meie tabelikuju tihendusetappi.
GCF – Graph Compact Format	41	Selle kompaktne graafivorming ja generic-profiili disain mõjutasid OmniRoute'i tabelikuju tihendust ja Headroom koodeki vormingut.
gcf-typescript	4	MIT-litsentsiga TypeScript-implementatsioon, mis on otse sisse võetud ja laiendatud Headroom generic-profiili koodekiks.
token-optimizer-mcp	494	Brotli/SQLite vahemälu + seansipõhine konteksti-delta — inspireeris meie `session-dedup` mootorit.
token-savior	1 122	Bash-väljundi tihendamine + MCP profiilid — inspireeris meie tihendamise katkestusdistsipliini ja MCP tööriista-manifesti vähendamist.
token-saver	138	Sisu-teadlik, failitüübipõhine väljundi tihendamine tõrke-teadliku katkestusega — kinnitas meie tüübipõhist dispatchimist ja miinimumkasu vahelejättu.
token-optimizer	1 951	"Leia kummitus-tokenid" — selle mahalaadimise + taasleitava käepideme muster mõjutas meie CCR mahalaadimise mõtlemist.
TokenMizer	28	Seansigraafi + käikudevahelise rea-dubleerimise vähendamise mudel, mis mõjutas meie session-dedup disaini.
OmniCompress	3	Rust veeruline JSON + sisupõhine taastemine + sõnumitevaheline dubleerimise vähendamine — kinnitas meie `headroom`/`ccr`/`session-dedup` mootorite disaini ja vahemälu-stabiilset invarianti "tihendatud vorm on positsioonist sõltumatu".
mcp-compressor	113	MCP tööriista-skeemi/kirjelduse tihendamine — mõjutas meie MCP tööriista-manifesti kardinaalsuse vähendamist.
RepoMapper	197	Aider-stiilis repo-kaardi hindamine — mõjutas meie repo-kaardi / otsingu-hindamise uurimist.
quiet-shell-mcp	4	Deklaratiivne shell-väljundi vähendamine MCP kaudu — kinnitas meie deklaratiivset bash-väljundi tihendamist.
ts-morph	6 162	TypeScript Compiler API tööriistakomplekt — inspireeris meie parseripõhist kommentaaride eemaldamist, mis säilitab string-, mall- ja regulaaravaldise literaale.

### 🧠 Mälu ja RAG

Projekt	⭐	Kuidas see OmniRoute'i inspireeris
Mem0	63 902	Universaalne mälukiht — selle proksina-kirjutamise/lugemispiiri mudel kujundas meie mäluarhitektuuri.
Letta (MemGPT)	24 382	Olekulised agendid kihilise mäluga — inspireeris meie Context Control & Recovery (CCR) kihilist mudelit.
WFGY	1 781	ProblemMap taksonoomia 16 korduvast RAG/LLM tõrkemustrist — jagatud sõnavara meie tõrkeotsingu juhendis.

### 🛰️ Liikluse jälgimine, MITM ja läbipaistev proksi

Projekt	⭐	Kuidas see OmniRoute'i inspireeris
llm-interceptor	66	Kodeerimisassistendi ↔ LLM liikluse MITM-vahepealtkuulamine/analüüs mõjutas Traffic Inspectori algseid nõudeid. Neli varem tuletatud moodulit — SSE liitmine, vestluse normaliseerimine, saladuste maskimine ja päiste sanitiseerimine — on asendatud sõltumatute puhta-toa implementatsioonidega, mis põhinevad avalikel protokollistandarditel. Kaks host-läbilaskepinda (`passthrough.ts` ja `_internal/bypass.cjs`) jäävad OmniRoute-sisemisteks implementatsioonideks, mis on klassifitseeritud sõltumatult; neid selle asendamise käigus ümber ei kirjutatud.
ProxyBridge	5 995	Läbipaistev protsessipõhine proksi-ruutimine — inspireeris meie krahhikindlat MITM-lammutamist, pesade tegevusetuse ajapiiranguid, `/proc` protsessiomistamist ja TPROXY püüdmist.

### 📚 Mudeliandmed, jälgitavus ja kasutajaliides

Projekt	⭐	Kuidas see OmniRoute'i inspireeris
models.dev	6 555	Avatud andmebaas AI-mudelite spetsifikatsioonide, hindade ja võimaluste kohta — sünkroonitud natiivselt meie mudelikataloogi.
React Flow / xyflow	38 108	Sõlmedel põhinev graafikaraamatukogu, mis toidab meie reaalajas Compression Studiot ja Combo/Routing Studiot.
LangGraph	40 314	LangGraph Studio'i elava töövoo-graafi visualiseerimine inspireeris meie Studiote reaalajas kaskaadivaadet.
Langfuse	33 592	Selle trace → span → generation jälgitavuse mudel kujundas meie Compression Studio kärestikuvaate (waterfall).
Kiali	3 631	Istio teenusevõrgu jälgitavus — inspireeris meie ahelakatkestaja märgiseid ja tõrkeäärte visuaale Routing/Combo Studios.
lobe-icons	2 428	AI/LLM kaubamärkide logod, mis kuvavad teenusepakkuja ikoone üle meie juhtpaneeli.
flag-icons	12 354	Pakub MIT-litsentsiga SVG-lippe, mida kasutab README keelevalija.

### 🛡️ Turvalisus

Projekt	⭐	Kuidas see OmniRoute'i inspireeris
awesome-secure-defaults	721	Kureeritud nimekiri turvalise-vaikeseadega teekidest, mis juhib meie turvavalikuid (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).

### 🧭 Täiendavad tööriistad

Projekt	⭐	Kuidas see OmniRoute'i inspireeris
ClawRouter	6 564	Inspireeris päringute dubleerimise vähendamist, hädaolukorra nullkuluga varulahendust, ühendatavaid Auto-Combo strateegiaid ja mitmekeelset kavatsuse klassifitseerimist.
Antigravity-Manager	30 652	Selle konto-teadlik mudeli ümberkaardistamine, käivitatava faili tee valideerimine ja plaanimärgise käitumine mõjutasid OmniRoute'i Antigravity käitusaega.
vscode-antigravity-cockpit	4 817	Selle kompaktne kvoodi-taastamise loenduri vorming inspireeris OmniRoute'i vastavat teenusepakkuja-piirangu kuvamist.
AionUi	32 230	Selle ACP integratsioonid inspireerisid OmniRoute'i installitud CLI-agentide automaatset tuvastamist.
CodexBar	20 507	Tuvastas Grok Build kvoodipinna; OmniRoute kontrollis ja korrigeeris seejärel elava juhtmevormingu iseseisvalt.

## 📄 Litsents MIT litsents - vaata täpsemalt [LICENSE](LICENSE). ---

**[⬆ Tagasi üles](#-omniroute)** · Loodud ❤️-ga avatud lähtekoodiga AI kogukonna jaoks. _{OmniRoute v3.8.51 · Node ≥22.22.2 · MIT License · omniroute.online}