# README (Eesti) 🌐 **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) · 🇮🇷 [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) · 🇵🇭 [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) · 🇱🇰 [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 — Tasuta tehisintellekti lüüs

OmniRoute — Ära kunagi lõpeta kodeerimist. Iga tehisintellekti tööriist → 358 pakkujat — 150+ tasuta — ühe lõpp-punkti kaudu. Claude Code, Codex, Cursor, Cline, Copilot & Antigravity TASUTA Claude / GPT / Gemini-sse automaatse tagavaraga. RTK + Caveman virnastatud tihendus säästab 15–95% tokeneid (~89% keskmiselt) — ei ületa kunagi piire. 358 tehisintellekti pakkujat · 150+ tasuta tasandit · ~1.62B tasuta tokenit/kuus · 19 marsruutimisstrateegiat · $0 alustamiseks.

## 💰 ~1,62 mld tasuta tokenit kuus

> Tasuta tasemete käsitsi kombineerimine on vaevarikas — kümned SDK-d, kümned kiiruspiirangud ja puudub ülevaade sellest, kui palju sul tegelikult kasutada on. OmniRoute kataloog sisaldab **489 tasuta taseme kirjet 35 korduva kogumi võtme lõikes** ning arvutab tokenite koondnäitaja **17 kogumi põhjal, millel on avaldatud positiivne kuueelarve, ning lisaks viie mudelipõhise Groqi ülempiiri põhjal**, eemaldades jagatud kogumite duplikaadid. Kvoodid, mis avanevad alles pärast piirkondliku isikusamasuse kontrolli (praegu ModelScope), kuvatakse eraldi — +~6 mln pärast piirkondliku isikusamasuse kinnitamist — ning neid ei liideta kunagi koondnäitajale. Tulemus on alati nähtav töölaual (`/dashboard/free-tiers`).

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

⭐ Lisa repositoorium lemmikuks, 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 koht](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 pakkujatest, väljalasetest ja nõuannetest 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, pakkujatega seotud nõuanded, 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 jätkuvalt

| | v3.8.49 | **v3.8.50** | `v3.8.51+` | | ---------------------------------- | :-----: | :------------------------: | :--------: | | 🌐 Pakkujad | 290 | **357** | veel ootel | | 🧠 Unikaalsed vestlusmudelite ID-d | 1185 | **1312** | — | | 🖼️ Modaalsuste sild | — | 🆕 nägemine + heli + video | — | | 📡 Radari tasuta kataloog | — | 🆕 valikuline liitumine | — | | ⚖️ Kvooditeadlik ajastamine | — | 🆕 Quota-Share | — | | 📊 Kvooditelemeetria | — | 🆕 reaalajas | — | **→ [Teekaart](ROADMAP.md) — mööda rööpaid versiooni `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 allalaadimised kuus](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	🚀 Kiire alustamine	📦 Paigaldamine	🆓 Seadistamisvaba
💡 Tutvumine	💥 Lubadus	🤔 Miks OmniRoute	🏆 Mille poolest see eristub
⚙️ Funktsioonid	🎯 Kombod	🌐 Pakkujad	🔌 CLI ja 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

🌐 66 keeles

## 🆓 Töötab kohe pärast installimist — pole võtmeid, pole seadistust

Töötab kohe pärast installimist — null seadistust. Kolm sammu: 1. Installi — npm i -g omniroute, server käivitub aadressil localhost:20128. 2. Suuna oma tööriist aadressile http://localhost:20128/v1 — mis tahes OpenAI-ga ühilduv tööriist (Claude Code, Cursor, Cline). 3. See vastab — kutsu mudelit auto kohese vastuse saamiseks, ilma API võtmeta, registreerimiseta, seadistuseta. Võtmeta pakkuja OpenCode Free on eelnevalt ühendatud auto komboga, nii et värske install vastab kohe karbist välja võttes.

```bash # Värske install, null mandaati — `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 spetsiifilist tasuta taustaprogrammi? Kutsu `oc/…` (OpenCode Free) otse. Seejärel mine üle `auto` peale ja lase OmniRoute'il valida.} _{📦 Kopeeri-kleebi kiirkäivitusstsenaariumid **Pythoni, Node.js, PHP ja cURLi** jaoks → [`examples/quickstart/`](examples/quickstart/)}

# 💥 Lubadus

# 🤔 Miks OmniRoute?

OmniRoute'i päringuvoog: teie IDE või CLI (Claude Code, Cursor, Cline…) kutsub ühte kohalikku lõpp-punkti (http://localhost:20128/v1); OmniRoute'i nutikas ruuter (RTK + Caveman tihendus, 19 marsruutimisstrateegiat, kaitselülitid, TLS stealth, MCP, A2A, piirangud) saab varuühenduse luua üle 4 pakkuja taseme, kuni on saadaval sobiv terve sihtmärk — Tase 1 Tellimus, Tase 2 API võti, Tase 3 Odav ja Tase 4 Tasuta.

## 🤝 Meie avatud lähtekoodiga sõprade toetusel

> **Kas soovite liituda avatud lähtekoodiga sõbrana?** Need on ettevõtted, mis toetavad avatud lähtekoodi ja aitavad OmniRoute'il edasi liikuda – ja me ütleme avalikult, kuhu iga nende antud token läheb. Võtke ühendust: [diegosouza.pw@outlook.com](mailto:diegosouza.pw@outlook.com)

Kimi
_{Moonshot AI} Tänu Kimile (Moonshot AI), meie asutavale avatud lähtekoodiga sõbrale, selle projekti toetamise eest! Kimi on AI labor avatud kaaluga K2 ja K3 mudeliperekondade taga — Kimi K3 pakub 1M-tokeni kontekstiakent, natiivset nägemist ja piiritasemel kodeerimist murdosa suletud mudelite hindadest ning töötab koheselt Claude Code, Codexi ja iga kodeerimistööriistaga, mida OmniRoute pakub.

Mida Kimi toetus võimaldab: Kimi API krediidid toetavad OmniRoute'i AI-ga valideeritud väljalaskeprotsessi — Kimi K3 poolt valideeritud ühendamise etappi, mis vaatab läbi iga tõmbepäringu enne selle avaldamist — pluss igapäevast funktsioonide arendust. Esimese klassi Kimi tugi on saadaval mõlemal viisil: otse Kimi API (kimi-k3) ja Kimi Code kodeerimisplaan (OAuth ja API võti). OmniRoute on ka esimene Brasiilia avatud lähtekoodiga projekt Kimi tugiprogrammis. Hankige Kimi API võti 15% lisakrediidiga →

Odavam järeldus
_{cheaperinference.com} Tänu Cheaper Inference'ile, OmniRoute'i avatud lähtekoodiga sõbrale, selle projekti toetamise eest! Cheaper Inference on kulupõhine lüüs, mis edasimüüb 42 piirimudelit — Claude, GPT-5.x, Gemini, Kimi K3, GLM, DeepSeek, Grok ja MiniMax — ühe OpenAI-ga ühilduva lõpp-punkti taga, suunates iga päringu odavaimale sobivale pakkujale, ilma et kunagi küsiks mudeli tootja nimekirjahinnast kõrgemat hinda.

Esimese klassi tugi OmniRoute'is: Vestluse lõpetamised, natiivne /v1/responses lõpp-punkt, nägemine, tööriistakõned ja 3 pildimudelit (grok-imagine, nano-banana-pro, nano-banana-2, kättesaadav kui cheaperinference/<model>). Hankige API võti →

_{Lingid, millel on märge aff=omniroute, on partnerlingid. Need rahastavad projekti teile lisakuludeta.}

_{🎟️ Sidusettevõtete pakkumine — tasuta registreerimiskupongid pakkujatelt, keda me ei sponsoreeri (laiendamiseks klõpsake)}

_{See jaotis on ainult viite-/kupongikoodide jaoks. Sponsorluspartnerlused asuvad ülal jaotises 🤝 Meie avatud lähtekoodiga sõprade toetusel. OmniRoute'il puudub sponsorlus või partnerlus siin loetletud pakkujatega – need on avalikud kupongid, mida igaüks saab kasutada.}

_AgentRouter
_{agentrouter.org} _{AgentRouter — sidusettevõtte registreerimine · $100 tasuta krediiti registreerimisel (tasuta server, oodata suuremat latentsust — parim testimiseks, mitte tootmiseks). Esimese klassi tugi OmniRoute'is alates v3.8.50: vestluse lõpetamised, Anthropic-ühilduv traadiformaat ja OpenAI-ühilduv tee. Saadaval olevad mudelid hõlmavad claude-opus-4-8, claude-opus-5, gpt-5.6-sol ja palju muud. Haara oma $100 →}

_{⚠️ Sidusettevõtte link — OmniRoute'il puudub sponsorlus või partnerlus selle pakkujaga.}

_{Kas teate mõnda teist pakkujat, kellel on helde tasuta registreerimiskupong, mis toob kasu OmniRoute'i kasutajatele? Avage probleem 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 eristab OmniRoute'i

_{📊 Täielik metoodika & funktsioonide detailid võrreldes 9routeri, OpenRouteri, CLIProxyAPI & LiteLLM-iga → [`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 taseme näitaja on endiselt **~1.62B tokenit kuus**, tuginedes eespool dokumenteeritud kataloogile, millest on kogumite kattuvused eemaldatud. Teenusepakkujate ajutised registreerumiskrediidid võivad esimesel kuul seda mahtu eraldi suurendada kuni **~2.22B** tokenini. Radar on valikuline, allkirjastatud kataloogikiht kasutajatele, kes soovivad OmniRoute'i väljalasete vahel ajakohasemat teavet tasuta mudelite saadavuse kohta; kogukonna kataloog ja kõik olemasolevad tasuta funktsioonid jäävad tasuta kättesaadavaks. Toetajad võivad saada juurdepääsu reaalajas kataloogile ja teenusepakkujate lisavõimalustele. Selle eraldiseisev ja muutuv ülempiir on **maksimaalselt ligikaudu 3B tokenit kuus**, olenevalt teenusepakkujate saadavusest. See ülempiir ei ole garantii: teenusepakkujad võivad igal ajal muuta kvoote, sobivuskriteeriume, mudeleid või piirkondi. Radar on vabatahtlik ja kasutab ainult GET-päringuid. OmniRoute'i klient ei laadi üles viipasid, liiklusandmeid, teenusepakkujate konfiguratsiooni, kasutustelemeetriat ega teadaannete kohalikku eiramise olekut. Lisateavet sobivuskriteeriumide ja praeguse kataloogi kohta leiate aadressilt **[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 kodeerimisagendid > Üks konfiguratsioon — `http://localhost:20128/v1` — ja **iga** tehisintellektil põhinev IDE või CLI töötab tasuta ja soodsate 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}	_deyin.ai

＋ töötab ka nendega · Agent Deck · Kiro · Command Code · Antigravity · Windsurf · AMP · mis tahes OpenAI-ga ühilduv tööriist

_{📖 Tööriistapõhine seadistus kõigile 36 tööriistale (26 CLI-kooditööriista + 10 CLI-agenti) → [`docs/reference/CLI-TOOLS.md`](docs/reference/CLI-TOOLS.md) · 🧩 OpenCode'i pistikprogramm → [`@omniroute/opencode-provider`](https://www.npmjs.com/package/@omniroute/opencode-provider)}

**Käivitage OmniRoute'i kaudu mis tahes toetatud CLI ühe käsuga** — konfiguratsioonifaile ei kirjutata, mandaadid lisatakse igale protsessile eraldi ning Qwen/Gemini saavad ajutise isoleeritud 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 valige pakkuja ja mudel interaktiivselt ning kirjutage tööriista enda konfiguratsioon: omniroute configure codex # samuti: claude opencode qwen aider goose gemini cline continue kilo ``` Iga käsk arvestab aktiivset kaugkonteksti (`omniroute connect `), `--dry-run` näitab enne käivitamist täpseid keskkonnamuutujaid ja argumente ning `--api-key-env NAME` hoiab saladused teie shelli ajaloost eemal. → [CLI-integratsioonid](docs/guides/CLI-INTEGRATIONS.md)

## 🌐 357 AI-teenusepakkujat — 152 kataloogis tasuta kasutatavaks märgitud

> **357 registreeritud teenusepakkujat** kanoonilistes vestluse, meedia, otsingu, kohalikes, pilveagentide ja süsteemi kogumites, sealhulgas **152 teenusepakkujat, mille tuvastusmetaandmetes on `hasFree: true`**. Vestlusmudelite register hõlmab **229 teenusepakkujat / 2 554 eraldiseisvat teenusepakkuja ja mudeli paari / 1 283 töötlemata mudeli ID-d**; eraldi tasuta kasutuseelarve kataloogis on **491 mudelipõhist rida**, **35 korduvat kogumit** ning **54 korduvat/võtmeta igavesti tasuta teenusepakkujat**. Need nimetajad on taotluslikult erinevad; definitsioonid ja kogumite dubleerimist välistavad arvutused leiate jaotistest [Teenusepakkujate teatmik](docs/reference/PROVIDER_REFERENCE.md) ja [Tasuta paketid](docs/reference/FREE_TIERS.md).

### 🏢 Kõik suuremad laborid — ühe lõpp-punkti kaudu

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

_{…ja veel üle 330 — kõik ikoonid laaditakse reaalajas juhtpaneeli teenusepakkujate kataloogist. 📖 [Teenusepakkujate teatmik](docs/reference/PROVIDER_REFERENCE.md)}
### 🆓 Igavesti tasuta — $0, kaarti pole vaja

OpenCode Zen _{DeepSeek V4, Nemotron 3 Tokenipiiranguta}	Kilo Code _{Automaatne ruuter, Tencent Hy3 Alati tasuta}	Requesty _{GPT-OSS 120B, Nemotron Alati tasuta}	SiliconFlow _{DeepSeek V3.2 / R1 Tasuta pakett}	Z.AI GLM _{GLM-4.7 / 4.5-Flash Alati tasuta}	Baidu ERNIE _{ERNIE 4.0 Alati tasuta}
Qoder AI _{Qwen3-Max, Kimi-K2 Piiramatult TASUTA}	Pollinations _{GPT, Llama, Claude Võtit pole vaja}	Cloudflare AI _{Üle 50 mudeli 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 → suurem 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) |

---

## 🛠️ Tehniline virn

Kiht	Tehnoloogia
Töökeskkond	Node.js 22.x / 24.x LTS — `>=22.22.2 <23 \|\| >=24.0.0 <27`
Keel	TypeScript 6.0 — 100% TypeScript üle `src/` ja `open-sse/` (null `any` südamikus alates v2.0)
Raamistik	Next.js 16 + React 19 + Tailwind CSS 4
Andmebaas	better-sqlite3 (SQLite, WAL journaling) + LowDB (JSON legacy) — 122 domeenimoodulit, 183 migratsiooni
Mälu	SQLite FTS5 täistekst + int8-kvantiseeritud vektor-manused, tüübitud lagunemine
Skeemid	Zod 4 — MCP tööriista sisend/väljund valideerimine + API lepingud
Protokollid	MCP (stdio / HTTP / SSE) + A2A v0.3 (JSON-RPC 2.0 + SSE)
Voogedastus	Server-Sent Events (SSE) + WebSocket sild (`/v1/ws`)
Pakkimine	12-mootoriline torujuhe — RTK, Caveman, LLMLingua-2 (MobileBERT ONNX), GCF, OmniGlyph
Autentimine ja turvalisus	OAuth 2.0 (PKCE) + JWT + API võtmed + MCP ulatuslik autentimine · AES-256-GCM puhkeolekus · DOMPurify
Varjamine	wreq-js — JA3 / JA4 TLS sõrmejälje jäljendamine, 3-tasemeline puhverserver
Vastupidavus	Kaitselüliti, eksponentsiaalne tagasipöördumine, anti-thundering-herd, automaatne kombineeritud iseparandamine
Logimine	pino — struktureeritud JSON logid päringu kontekstiga
Testimine	Node.js testijooksutaja + Vitest — 39 000+ staatilist testideklaratsiooni üle 5100+ jälgitava testifaili (üksus, integratsioon, E2E, turvalisus, ökosüsteem)
Platvormid	Töölaud (Electron) · Android (Termux) · PWA (mis tahes brauser)
CI/CD	GitHub Actions — automaatne npm avaldamine + Docker Hub väljalaskel
Lingid	Veebisait · npm · Docker Hub

## 📖 Dokumentatsioon

### 📘 Alustamine

Dokument	Kirjeldus
Kasutusjuhend	Pakkujad, kombinatsioonid, CLI-integratsioon, juurutamine
Seadistusjuhend	Kõik paigaldusmeetodid, CLI-tööriistade konfiguratsioonid, protokollide seadistamine, ajalõppude häälestamine
CLI-tööriistade juhend	Tööriistapõhine seadistamine Claude Code'i, Codexi, Cursori, Cline'i, OpenClaw', Kilo ja Copiloti jaoks
Kaugrežiim	Kaug-OmniRoute'i (VPS) juhtimine sülearvuti CLI-st piiratud ulatusega juurdepääsutõendite abil
Claude Code'i konfiguratsioon	Claude Code'i ühendamine OmniRoute'iga (kohalik/kaugühendus), kasutades käsku `launch` ja mudelipõhiseid profiile
Kiiralustus	Kolm sammu: paigalda → ühenda → konfigureeri

### 🔧 Käitamine ja juurutamine

Dokument	Kirjeldus
Dockeri juhend	Docker run, Compose'i profiilid, Caddy HTTPS, tunnelid, tõmmisesildid
Podmani juhend	Quadleti systemd-integratsioon, podman-compose, SELinux
Virtuaalmasinasse juurutamine	Täielik juhend: virtuaalmasina, nginxi ja Cloudflare'i seadistamine
Fly.io-sse juurutamine	Juurutamine Fly.io-sse püsiva salvestusruumiga
Termuxi juhend	OmniRoute'i käitamine Androidis Termuxi kaudu
PWA juhend	Progressiivse veebirakenduse paigaldamine, vahemällu salvestamine ja arhitektuur
Desinstallimisjuhend	Puhas eemaldamine kõigi paigaldusmeetodite korral
Keskkonna konfiguratsioon	Kõik `.env` muutujad ja viited

### 🧠 Funktsioonid ja arhitektuur

Dokument	Kirjeldus
Arhitektuur	Süsteemi arhitektuur, andmevoog ja sisemine toimimine
Tihendusjuhend	Seitsme valikuga konveier: väljas / kerge / standardne / agressiivne / ultra / RTK / virnastatud
RTK-tihendus	Käsuväljundi tihendamine, filtrid, usaldus, kontrollimine, toorväljundi taastamine
Tihendusmootorid	Caveman, RTK, virnastatud konveierid, töölaua/API/MCP liidesed
Tihendusreeglite vorming	JSON-reeglipakettide skeemid Cavemani ja RTK filtrite jaoks
Tihenduse keelepaketid	Keeletuvastus ja Cavemani reeglipakettide koostamine
Tõrkekindluse juhend	Kaitselülitid, ooteajad, järjekord, päringutulva vältimine, TLS-i võltsimine
Automaatsete kombinatsioonide mootor	16 teguriga hindamine, režiimipaketid, isetaastumine
Puhverserveri juhend	Kolmetasemeline puhverserverisüsteem, 1proxy turg, registri CRUD-toimingud
Tasuta paketid	Koondkataloog: 35 dokumenteeritud korduvkasutatavat kogumit / 489 kataloogitud tasuta paketi kirjet
Funktsioonide galerii	Visuaalne töölaua tutvustus ekraanipiltidega
Koodibaasi dokumentatsioon	Algajasõbralik koodibaasi ülevaade

### 🤖 Protokollid ja API-d

Dokument	Kirjeldus
API-teatmik	Kõik lõpp-punktid koos näidetega
OpenAPI spetsifikatsioon	OpenAPI 3.0 spetsifikatsioon
MCP-server	110 MCP-tööriista, IDE konfiguratsioonid, Pythoni/TS-i/Go kliendid
MCP-serveri juhend	MCP paigaldamine, transpordid ja tööriistade teatmik
A2A-server	JSON-RPC 2.0 protokoll, oskused, voogedastus, ülesannete haldus
A2A-serveri juhend	A2A agendikaart, ülesanded, oskused ja voogedastus

### 📋 Projekt ja kvaliteet

Dokument	Kirjeldus
Kaastöö tegemine	Arenduskeskkonna seadistamine ja juhised
Harude ja väljalasete mudel	Millistele harudele PR-id suunatakse (`release/*`) ning mida tähendavad `main` ja sildid
Muudatuste logi	Täielik versioonipõhine väljalasete ajalugu
Turbepoliitika	Turvanõrkustest teatamine ja turbepraktikad
i18n-juhend	42 keele tugi, tõlkimise töövoog, RTL
Väljalaske kontrollnimekiri	Väljalaske-eelse valideerimise etapid
Testikatvuse plaan	Testikatvuse strateegia enam kui 39 000 staatilise testideklaratsiooni jaoks enam kui 5 100 jälgitavas testifailis

# ⭐ Parimad kaasautorid > OmniRoute'i kujundab pühendunud avatud lähtekoodiga kogukond. Need inimesed on andnud erakordse panuse, mis mõjutab otseselt projekti kvaliteeti, stabiilsust ja haaret. **Aitäh teile.** ### Välised kaasautorid ühendatud tõmbetaotluste arvu järgi

Koht	Kaasautor	Ühendatud 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 aktiivse haru release/v3.8.50 tipus dafb4ae808, hõlmates ühendamisi kuni 2026-08-24 05:26:03 UTC. Lehekülgedeks jaotatud GitHub GraphQL-i loendus sisaldab 5 911 ühendatud PR-i: 2 707 repositooriumi omanikult, 179 Dependabotilt ja 3 025 välist PR-i 535 erinevalt kaasautorilt. „Muudetud read” tähendab GitHubi lisamiste ja kustutamiste summat ning hõlmab genereeritud faile, lukufaile, katalooge, tõlkeid ja dokumentatsiooni; see näitab muudatuste mahtu, mitte autori kirjutatud koodiridade arvu. Piirile jäänud viigiseisud on säilitatud.} ### GitHubi omistatud sissekanded

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

_{Kontrollitud uuesti 2026-08-24 06:14:31 UTC: hoidla Contributors API teatatud GitHubile omistatud kinnitused vaikeharus release/v3.8.50. API tagastas 525 identiteeti (415 kasutajat, 2 robotit, 108 anonüümset); sellest tabelist on välja jäetud hooldaja, robotid ja anonüümsed identiteedid ning võrdsete tulemuste korral on kohad säilitatud. See erineb nii ülaltoodud ühendatud PR-ide edetabelist kui ka alltoodud 639 inimesega Git-metaandmete loendusest.} > 🙏 Nende kaastöötajate loodud funktsioonid, veaparandused ja taristu täiustused on **põhiosa** sellest, mis teeb OmniRoute'i töökindlaks ja funktsioonirohkeks. Iga tõmbetaotlus, iga testjuhtum ja iga i18n-tõlkefail on oluline. Avatud lähtekood sünnib tänu sellistele inimestele nagu nemad.

---
## 💖 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ärnid

## 🌍 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}