# README (Slovenščina) 🌐 **Languages:** 🇺🇸 [English](../../../README.md) · 🇪🇹 [am](../am/README.md) · 🇸🇦 [ar](../ar/README.md) · 🇦🇿 [az](../az/README.md) · 🇧🇬 [bg](../bg/README.md) · 🇧🇩 [bn](../bn/README.md) · 🇧🇦 [bs](../bs/README.md) · 🇨🇿 [cs](../cs/README.md) · 🇩🇰 [da](../da/README.md) · 🇩🇪 [de](../de/README.md) · 🇬🇷 [el](../el/README.md) · 🇪🇸 [es](../es/README.md) · 🇪🇪 [et](../et/README.md) · 🇮🇷 [fa](../fa/README.md) · 🇫🇮 [fi](../fi/README.md) · 🇫🇷 [fr](../fr/README.md) · 🇮🇪 [ga](../ga/README.md) · 🇮🇳 [gu](../gu/README.md) · 🇳🇬 [ha](../ha/README.md) · 🇮🇱 [he](../he/README.md) · 🇮🇳 [hi](../hi/README.md) · 🇭🇷 [hr](../hr/README.md) · 🇭🇺 [hu](../hu/README.md) · 🇦🇲 [hy](../hy/README.md) · 🇮🇩 [id](../id/README.md) · 🇳🇬 [ig](../ig/README.md) · 🇮🇹 [it](../it/README.md) · 🇯🇵 [ja](../ja/README.md) · 🇬🇪 [ka](../ka/README.md) · 🇰🇭 [km](../km/README.md) · 🇮🇳 [kn](../kn/README.md) · 🇰🇷 [ko](../ko/README.md) · 🇱🇹 [lt](../lt/README.md) · 🇱🇻 [lv](../lv/README.md) · 🇮🇳 [ml](../ml/README.md) · 🇮🇳 [mr](../mr/README.md) · 🇲🇾 [ms](../ms/README.md) · 🇲🇹 [mt](../mt/README.md) · 🇲🇲 [my](../my/README.md) · 🇳🇵 [ne](../ne/README.md) · 🇳🇱 [nl](../nl/README.md) · 🇳🇴 [no](../no/README.md) · 🇮🇳 [or](../or/README.md) · 🇮🇳 [pa](../pa/README.md) · 🇵🇭 [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) · 🇷🇸 [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 — brezplačni prehod za umetno inteligenco

OmniRoute — Nikoli ne prenehajte programirati. Vsako orodje umetne inteligence → 375 ponudnikov — več kot 150 brezplačnih — prek ene končne točke. Claude Code, Codex, Cursor, Cline, Copilot in Antigravity poveže z BREZPLAČNIMI modeli Claude / GPT / Gemini s samodejnim preklopom ob napaki. Kombinirano stiskanje RTK + Caveman prihrani 15–95 % žetonov (povprečno ~89 %) — nikoli ne dosezite omejitev. 375 ponudnikov umetne inteligence · več kot 150 brezplačnih paketov · ~1,62 mrd. brezplačnih žetonov/mesec · 20 strategij usmerjanja · začnite z 0 $.

## 💰 ~1.62B žetonov / mesec v brezplačnih paketih tretjih ponudnikov

> **Prinesite svoje račune ponudnikov.** To je ocenjen skupni seštevek ločeno upravičenih brezplačnih paketov tretjih ponudnikov, ne pa dodelitev žetonov s strani OmniRoute. Registrirajte se, kjer je zahtevano pridobite poverilnice, in povežite ponudnike, ki jih lahko uporabljate; vsak ponudnik sam določa svoje omejitve, razpoložljivost in pogoje. > > Ročno združevanje brezplačnih paketov je naporno — na desetine SDK-jev, na desetine omejitev hitrosti in brez predstave, koliko dejansko imate na voljo. OmniRoute katalogizira **467 vnosov brezplačnih paketov v 34 ponavljajočih se ključih skupin**, glavno številko žetonov pa izračuna iz **17 skupin z objavljenim pozitivnim mesečnim proračunom ter petih omejitev Groq po posameznih modelih**, pri čemer vsako skupno skupino šteje samo enkrat. Kvote, ki se odprejo šele po regionalnem preverjanju identitete (danes: ModelScope), so prikazane ločeno — +~6M za regionalnim preverjanjem identitete — in nikoli niso prištete v glavno številko. Rezultat ostane viden na nadzorni plošči (`/dashboard/free-tiers`).

Kartica proračuna brezplačnih paketov OmniRoute: ~1.62B brezplačnih žetonov na mesec stalno, do ~2.22B v prvem mesecu s krediti ob registraciji, iz 34 dokumentiranih ponavljajočih se ključev skupin, ki pokrivajo 467 katalogiziranih vnosov brezplačnih paketov za eno samo končno točko. Pošteno računanje brez podvajanja skupin — vsaka skupna skupina je šteta enkrat, vključno s 17 ponavljajočimi se skupinami z objavljenim pozitivnim mesečnim proračunom žetonov ter petimi omejitvami Groq po posameznih modelih; 12 ponudnikov je v katalogu tveganj pogojev označenih z »avoid«, da se odločite sami. Proračunska vrstica vključuje Mistral 1B, Nara 210M, LLM7 150M, xKiro 150M, Groq 30M (pet omejitev po posameznih modelih) in manjše skupine, poleg tega pa kredite ob registraciji v prvem mesecu in trajno brezplačne ponudnike brez omejitev žetonov, ki so prikazani ločeno, da nikoli ne napihujejo glavne številke. Porabljeno/preostalo v živo na /dashboard/free-tiers.

> Animiran povzetek žive strani `/dashboard/free-tiers`. Celotna metodologija (deduplikacija skupin, kreditni nivoji, pogoji ponudnikov): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**. > > _{Te številke vsaka dva tedna ponovno preverjamo proti živemu katalogu in **se gibljejo v obe smeri** — ponudnik ukine brezplačni paket in številka pade; pojavi se nov in naraste. Objavljamo tisto, kar katalog dejansko izračuna, nikoli navzgor zaokroženega najboljšega scenarija.}

⭐ Dajte repozitoriju zvezdico, če vam je OMNIROUTE pomagal prihraniti denar in si olajšati delo.

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

[![Uvrstitev Star History](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) ### 💬 Pridružite se skupnosti **👋 Sledite vzdrževalcu — med prvimi prejmite nove ponudnike, izdaje in nasvete:** [![Sledite Diegu na LinkedInu](https://img.shields.io/badge/Follow_Diego_on-LinkedIn-0A66C2?style=for-the-badge&logo=linkedin&logoColor=white)](https://www.linkedin.com/in/diegosouzapw/) [![Sledite @diegosouzapw na GitHubu](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 Globalno](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 Brazilija](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) [![Spletno mesto](https://img.shields.io/badge/Website-omniroute.online-blue?logo=google-chrome&logoColor=white)](https://omniroute.online) **Vprašanja, nasveti o ponudnikih, razvojni načrt in podpora → [Discord](https://discord.gg/U47eFqAXCn) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 Globalno](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) / [🇧🇷 Brazilija](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) / [Portal](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK)**
## 📈 Gateway kar naprej raste

| | v3.8.50 | **v3.8.51** | `v3.8.53+` | | --------------------------------------- | :-------------------: | :---------: | :-------------------: | | 🌐 Ponudniki | 352 | **358** | 375 | | 🧠 Edinstveni ID-ji klepetalnih modelov | 1320 | **1374** | 1475 | | 🖼️ Most med modalnostmi | 🆕 vid + zvok + video | ✓ | ✓ | | 📡 Brezplačni katalog Radar | 🆕 po izbiri | ✓ | ✓ | | ⚖️ Razporejanje ob upoštevanju kvot | 🆕 Quota-Share | ✓ | ✓ | | 📊 Telemetrija kvot | 🆕 v živo | ✓ | ✓ | | 🧰 Način headless | — | — | 🆕 `serve --headless` | | 🛤️ Infrastruktura tira LTS | — | — | 🆕 kanali izdaj | | 🔎 API za odkrivanje modelov | — | — | 🆕 `/v1/models/query` | **→ [Načrt razvoja](ROADMAP.md) — po tiru proti `v3.9.0 LTS`**

## 🧩 Na voljo [![različica npm](https://img.shields.io/npm/v/omniroute?color=cb3837&logo=npm)](https://www.npmjs.com/package/omniroute) ![Mesečni prenosi NPM](https://img.shields.io/npm/dm/omniroute?label=npm/month&color=cb3837&logo=npm) [![Docker Hub](https://img.shields.io/docker/v/diegosouzapw/omniroute?label=Docker%20Hub&logo=docker&color=2496ED)](https://hub.docker.com/r/diegosouzapw/omniroute) [![Licenca: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](LICENSE) ![Prenosi Docker](https://img.shields.io/docker/pulls/diegosouzapw/omniroute?label=docker%20pulls&logo=docker&color=2496ED) ![Prenosi Electron](https://img.shields.io/github/downloads/diegosouzapw/omniroute/total?style=flat&label=electron%20downloads&logo=electron&color=47848F)

🚀 Začetek	🚀 Hitri začetek	📦 Namestitev	🆓 Povežite ponudnika
💡 Spoznajte	💥 Obljuba	🤔 Zakaj OmniRoute	🏆 Kaj ga loči od drugih
⚙️ Funkcije	🎯 Kombinacije	🌐 Ponudniki	🔌 CLI in MCP
	🗜️ Stiskanje	🖥️ Kje deluje	🔒 Zasebnost
👀 Oglejte si	🎬 V delovanju	✨ Novosti	🤖 Združljivi vmesniki CLI
💚 Podpora	💚 Podprite / donirajte	💬 Skupnost	💖 Sponzorji
📦 Projekt	🛠️ Tehnološki sklad	📖 Dokumentacija	👥 Sodelujoči

🌐 V 67 jezikih

## 🆓 Namestite, povežite ponudnika, nato usmerjajte skozi eno končno točko

Trije koraki: namestite in zaženite OmniRoute, povežite upravičenega ponudnika s svojim računom ali API ključem, nato usmerite svoje orodje na localhost:20128/v1 z API ključem OmniRoute in modelom auto. Usmerjanje je odvisno od razpoložljivih upravičenih povezav in omejitev ponudnika.

```bash # Po povezavi ponudnika kopirajte svoj ključ OmniRoute iz Nadzorna plošča → Končne točke: curl http://localhost:20128/v1/chat/completions \ -H "Authorization: Bearer YOUR_OMNIROUTE_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}' ``` _{`auto` potrebuje upravičeno pot. Sveža namestitev lahko nima nobenih upravičenih ciljev brez ključa, ponudnik brez ključa pa lahko zavrne odjemalce tretjih oseb. Ponudniki, označeni s `tos: avoid`, vključno s Kirom, so privzeto izključeni iz samodejnega usmerjanja; povezava računa te nastavitve ne preglasi. Pred izbiro ponudnika si oglejte [Vodnik po brezplačnih paketih](docs/getting-started/FREE-TIERS-GUIDE.md).} _{📦 Skripte za hiter začetek s kopiranjem in lepljenjem za **Python, Node.js, PHP in cURL** → [`examples/quickstart/`](examples/quickstart/)}

# 💥 Obljuba

Oljuba — Ena končna točka in 375 ponudnikov. Samodejna preklopitev ohranja usmerjanje, dokler je na voljo drug zdrav cilj. Šest stebrov: odporna preklopitev med 375 ponudniki · do 95 % prihranka žetonov pri upravičenih obremenitvah · 0 $ za začetek z več kot 150 brezplačnimi paketi in 51 ponudniki s ponavljajočim/brezključnim brezplačnim dostopom za vedno · 37 integracij CLI/agentov skozi eno konfiguracijo · združljivost z OpenAI, Claude, Gemini in Responses API na /v1 · produkcijski nadzori, vključno z odklopniki, TLS stealth, MCP 110 orodji, A2A, pomnilnikom, varovali, ocenami in več kot 56.000 statičnimi deklaracijami testov v več kot 7.800 sledenih testnih datotekah.

# 🤔 Zakaj OmniRoute?

Tok zahteve OmniRoute: vaš IDE ali CLI (Claude Code, Cursor, Cline …) pokliče eno lokalno končno točko (http://localhost:20128/v1); pametni usmerjevalnik OmniRoute (stiskanje RTK + Caveman, 20 strategij usmerjanja, odklopniki, TLS stealth, MCP, A2A, varovala) se lahko preklopi čez 4 ravni ponudnikov, dokler ostane upravičen zdrav cilj — raven 1 Naročnina, raven 2 API ključ, raven 3 Poceni in raven 4 Brezplačno.

## 🤝 Podpirajo nas naši odprtokodni prijatelji

> **Želite postati odprtokodni prijatelj?** To so podjetja, ki podpirajo odprto kodo in pomagajo ohranjati razvoj projekta OmniRoute — mi pa javno objavimo, za kaj porabimo vsak žeton, ki nam ga namenijo. Pišite nam: [diegosouza.pw@outlook.com](mailto:diegosouza.pw@outlook.com)

Kimi
_{Moonshot AI} Hvala podjetju Kimi (Moonshot AI), našemu ustanovnemu odprtokodnemu prijatelju, za podporo temu projektu! Kimi je laboratorij za umetno inteligenco, ki stoji za družinama modelov z odprtimi utežmi K2 in K3 — Kimi K3 zagotavlja kontekstno okno z 1 milijonom žetonov, izvorno podporo za vid in programiranje na pionirski ravni za delček cene zaprtih modelov, poleg tega pa brez dodatnih nastavitev deluje s Claude Code, Codex in vsakim programerskim orodjem, ki ga podpira OmniRoute.

Kaj omogoča podpora podjetja Kimi: Dobroimetje za Kimi API poganja z umetno inteligenco podprt postopek preverjanja izdaj projekta OmniRoute — fazo preverjanja združitev, ki jo poganja Kimi K3, v kateri je vsak zahtevek za vključitev sprememb pregledan pred izdajo — ter vsakodnevni razvoj funkcionalnosti. Prvorazredna podpora za Kimi je na voljo po obeh poteh: neposredno prek Kimi API (kimi-k3) in prek programerskega paketa Kimi Code (OAuth in ključ API). OmniRoute je tudi prvi brazilski odprtokodni projekt v podpornem programu podjetja Kimi. Pridobite ključ za Kimi API s 15 % dodatnega dobroimetja →

Cheaper Inference
_{cheaperinference.com} Hvala podjetju Cheaper Inference, odprtokodnemu prijatelju projekta OmniRoute, za podporo temu projektu! Cheaper Inference je prehod, razvrščen po stroških, ki preprodaja 42 pionirskih modelov — Claude, GPT-5.x, Gemini, Kimi K3, GLM, DeepSeek, Grok in MiniMax — prek ene končne točke, združljive z OpenAI, pri čemer vsako zahtevo usmeri k najcenejšemu ustreznemu ponudniku in nikoli ne zaračuna več od prodajne cene izdelovalca modela.

Prvorazredna podpora v projektu OmniRoute: Chat Completions, izvorna končna točka /v1/responses, vid, klicanje orodij in 3 slikovni modeli (grok-imagine, nano-banana-pro, nano-banana-2, dostopni kot cheaperinference/<model>). Pridobite ključ API →

_{Povezave, označene z aff=omniroute, so partnerske povezave. Projekt financirajo brez dodatnih stroškov za vas.}

_{🎟️ Partnerske promocije — brezplačni kuponi ponudnikov ob registraciji, ki jih ne sponzoriramo (kliknite za razširitev)}

_{Ta razdelek je namenjen samo referenčnim kodam in kodam kuponov. Sponzorirana partnerstva so navedena v zgornjem razdelku 🤝 Podpirajo nas naši odprtokodni prijatelji. OmniRoute nima sponzorskega ali partnerskega odnosa s tukaj navedenimi ponudniki — to so javni kuponi, ki jih lahko uporabi vsakdo.}

_AgentRouter
_{agentrouter.org} _{AgentRouter — registracija prek partnerske povezave · 100 $ brezplačnega dobroimetja ob registraciji (brezplačen strežnik, zato pričakujte večjo zakasnitev — najbolje za preizkušanje, ne za produkcijo). Prvorazredna podpora v projektu OmniRoute od različice v3.8.50: Chat Completions, prenosni format, združljiv z Anthropic, in pot, združljiva z OpenAI. Razpoložljivi modeli vključujejo claude-opus-4-8, claude-opus-5, gpt-5.6-sol in druge. Prevzemite svojih 100 $ →}

_{⚠️ Partnerska povezava — OmniRoute nima sponzorskega ali partnerskega odnosa s tem ponudnikom.}

_{Poznate še kakšnega ponudnika z velikodušnim brezplačnim kuponom ob registraciji, ki bi koristil uporabnikom projekta OmniRoute? Odprite prijavo težave in dodali ga bomo sem.}

## 🎯 Kombinacije — paradni konj

Animirani primeri za 18 od 20 strategij usmerjanja kombinacij — ena ploščica na strategijo: priority, fill-first, weighted, round-robin, p2c, least-used, random, strict-random, cost-optimized, headroom, reset-window, reset-aware, context-relay, context-optimized, lkgp, auto, fusion, pipeline. Strategiji cache-optimized in quota-weighted nista animirani; spodnja tabela opisuje vseh 20.

> **Kombinacija** je veriga modelov, med katerimi OmniRoute usmerja **samodejno**. Če zmanjka kvote, ponudnik odpove ali stroški skokovito narastejo, lahko kombinacija preklopi na naslednji primeren in delujoč model. 🛡️ ### ⚡ Brez konfiguracije — preprosto uporabite `auto` Kombinacije vam ni treba ustvariti. Nastavite model na `auto` (ali eno od njegovih različic) in OmniRoute iz vaših povezanih ponudnikov sestavi navidezno kombinacijo, ki jo sproti ocenjuje:

ID modela	Kaj optimizira
`auto`	🎯 Uravnotežena privzeta možnost (LKGP — ostane pri zadnjem delujočem ponudniku)
`auto/coding`	🧑💻 Uteži s prednostjo kakovosti za ustvarjanje kode
`auto/fast`	⚡ Najprej najnižja zakasnitev
`auto/cheap`	💰 Najprej najnižja cena na žeton
`auto/subscription`	🎟️ Samo naročniška kvota, ki jo že plačujete — ob neuspehu se varno ustavi in nikoli ne preklopi na plačljivo nadomestno možnost (vodnik)
`auto/thrifty`	🪜 Najprej kvota paketa, nato po eno stopničko do najcenejših plačljivih možnosti — po ponastavitvi se vrne na paket (vodnik)
`auto/offline`	🔋 Najprej največja rezerva kvote oziroma omejitve hitrosti
`auto/smart`	🔭 Najprej kakovost + 10 % raziskovanja za odkrivanje boljših modelov
`auto/lkgp`	📌 Izrecno vztrajanje pri zadnjem znanem delujočem ponudniku
`auto/chaos`	🧪 Vzporedno razprševanje na skupino modelov (eden na ponudnika, privzeto 5), ki vrne en odgovor; en nadrejeni klic na model v skupini, ne vbrizgavanje napak

## ### 🔀 Ali pa sestavite svojo — 20 strategij usmerjanja Vseh **20** strategij — poljubno jih kombinirajte pri vsakem koraku kombinacije:

#	Strategija	Kaj počne
1	`priority`	Urejen seznam s prvim ciljem — vsakega izčrpa, preden nadaljuje z naslednjim 🥇
2	`fill-first`	V celoti porabi kvoto vsakega cilja, preden nadaljuje
3	`weighted`	Utežena naključna izbira glede na utež posameznega cilja
4	`round-robin`	Zaporedno kroži med cilji
5	`p2c`	Naključno uravnoteženje obremenitve z izbiro boljšega od dveh ciljev
6	`least-used`	Izbere cilj z najnižjo trenutno obremenitvijo
7	`random`	Enakomerna naključna izbira (brez podvojitev)
8	`strict-random`	Naključna izbira brez odstranjevanja ponovitev 🎲
9	`cost-optimized`	Zmanjša strošek $ na zahtevo glede na trenutne cene v katalogu 💸
10	`headroom`	Izbere cilj z največ preostale kvote
11	`quota-weighted`	Preskoči račune z izčrpano kvoto, nato izbira sorazmerno s preostalo kvoto ÷ trenutno obremenitvijo — obstoječi pogovori ostanejo pripeti ⚖️
12	`reset-window`	Prednost da cilju, katerega obdobje kvote se bo ponastavilo najprej
13	`reset-aware`	Razvrsti glede na čas ponastavitve kvote — najprej krajša obdobja 📊
14	`context-relay`	Za dolge pogovore predaja kontekst med cilji 🧠
15	`context-optimized`	Izbere cilj, ki najbolje ustreza trenutni velikosti konteksta
16	`cache-optimized`	Vsako ponovno uporabljivo predpono poziva pripne na isti račun — kar najbolj poveča število zadetkov v predpomnilniku pozivov 🎯
17	`lkgp`	Zadnja znana delujoča pot — pripne se na zadnjega uspešnega ponudnika, nato pa uporabi nadomestna pravila
18	`auto`	Sprotno ocenjevanje vseh povezav na podlagi 16 dejavnikov 🤖
19	`fusion`	Razprši zahtevo na skupino modelov, ocenjevalnik pa njihove rezultate združi v en odgovor 🧬
20	`pipeline`	Veriži korake — izhod vsakega cilja se posreduje naslednjemu 🔗

_{Mehanizem Auto-Combo vsakega kandidata oceni glede na **16 dejavnikov** (stanje, kvota, stroški, zakasnitev, primernost za nalogo, kakovost, razpoložljivost seje …) — glejte [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md).} ## ### 🧱 Odpornost je vgrajena (3 neodvisne plasti)

Odpornost sistema OmniRoute — 3 neodvisne samodejno obnovljive plasti, prava plast za pravo napako. 1. plast: odklopnik ponudnika (celoten ponudnik): sproži se samo pri 408/5xx, pragovi OAuth 8× / ključ API 12× / lokalno 2×, ponastavi se po 60 s/30 s/15 s v poskusno stanje HALF-OPEN, postopna obnovitev; ko je stanje OPEN, kombinacija preusmeri zahteve k naslednjemu ponudniku. 2. plast: obdobje mirovanja povezave (en ključ/račun): osnovno trajanje 5 s za OAuth / 3 s za ključ API, eksponentno podaljševanje ×2 z zaščito pred stampedom zahtev, pri 429 upošteva Retry-After, uspeh počisti vsa stanja napak; ključ v obdobju mirovanja se preskoči, medtem ko sorodni ključi še naprej obdelujejo zahteve. 3. plast: zaklep modela (en model): omejitev 429 za posamezni model, lokalna napaka 404 ali zavrnitve načina zaklenejo samo ta model — nikoli celotne povezave. Končna stanja (prepovedan, potekel, dobroimetje izčrpano) mora obravnavati upravljavec in niso obdobja mirovanja.

_{📖 [Mehanizem Auto-Combo](docs/routing/AUTO-COMBO.md) · [Vodnik po odpornosti](docs/architecture/RESILIENCE_GUIDE.md)}

## 🏆 Po čem OmniRoute izstopa

_{📊 Celotna metodologija in podrobnosti posameznih funkcij v primerjavi s 9router, OpenRouter, CLIProxyAPI in LiteLLM → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)}
## 💚 Podprite OmniRoute OmniRoute ima licenco MIT in se vzdržuje odprto. Če vam prihrani čas ali denar, ga lahko pomagate ohraniti neodvisnega na način, ki vam najbolj ustreza. Sponzorstvo nikoli ne vpliva na prednost pri usmerjanju; kupi prepoznavnost, ne pa uvrstitve.

⭐ Dodajte zvezdico repozitoriju	Brezplačno — resnično pripomore k prepoznavnosti	Dodajte zvezdico projektu OmniRoute
🐙 GitHub Sponsors	Enkratno ali mesečno · brez provizije platforme	github.com/sponsors/diegosouzapw
☕ Ko-fi	Hitra enkratna napitnina, brez registracije donatorja	ko-fi.com/diegosouzapw
🧋 Buy Me a Coffee	Majhna, neformalna gesta	buymeacoffee.com/diegosouzapw
🖐 Liberapay	Ponavljajoče se · neprofitno · odprtokodno	liberapay.com/diegosouzapw
🇧🇷 PIX (Brazilija)	Takojšnje, brez provizij	ključ in koda QR spodaj
₿ Kriptovalute	BTC · ETH · USDT-TRC20 · USDC-Solana	naslovi spodaj

**🇧🇷 PIX** — takojšnje, brez provizij (Brazilija) Koda QR za OmniRoute PIX

Ključ (naključni): `5d865059-bc44-483a-962d-43ceb80126eb` Pix za kopiranje in lepljenje: ``` 00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD ```

₿ Kriptovalute — BTC · ETH · USDT-TRC20 · USDC-Solana (kliknite za razširitev)

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

_{⚠️ Vsak kovanec pošljite samo prek prikazanega omrežja — pošiljanje prek napačnega omrežja lahko povzroči izgubo sredstev.}

🐛 Ste našli napako ali imate povratne informacije? Odprite [razpravo](https://github.com/diegosouzapw/OmniRoute/discussions).

Opombe za razvijalce: Projekt lahko med npm install/postinstall zaradi priročnosti za razvijalce ustvari lokalno datoteko .env. Ta datoteka je namenoma prezrta prek .gitignore (glejte .gitignore) in ne sme biti nikoli vključena v commit — če jo pomotoma vključite, zamenjajte vse razkrite skrivnosti in odstranite datoteko iz zgodovine. Navodila za upravljanje lokalnih datotek okolja in skrivnosti najdete v docs/DEVELOPER-ENVIRONMENT.md.

## 📡 OmniRoute Radar Glavna navedba za brezplačno raven ostaja **~1,62 mrd. žetonov/mesec** iz zgoraj dokumentiranega kataloga z odstranjenimi podvojitvami med nabori. Začasna dobroimetja ponudnikov ob registraciji lahko prvi mesec ločeno povečajo na **~2,22 mrd.** Radar je izbirna, podpisana kataloška prekrivna plast za uporabnike, ki želijo ažurnejšo razpoložljivost brezplačnih modelov med izdajami OmniRoute; skupnostni katalog in vse obstoječe brezplačne funkcije ostajajo brezplačni. Podporniki lahko prejemajo katalog v živo in dodatne možnosti ponudnikov. Njegova ločena, spremenljiva zgornja meja je **največ približno 3 mrd. žetonov/mesec**, odvisno od razpoložljivosti ponudnikov. Ta zgornja meja ni zagotovilo: ponudniki lahko kadar koli spremenijo kvote, pogoje upravičenosti, modele ali regije. Radar je omogočen le po izbiri uporabnika in uporablja samo zahteve GET. Odjemalec OmniRoute ne nalaga pozivov, prometa, konfiguracije ponudnikov, telemetrije uporabe ali lokalnega stanja opuščenih obvestil. Več o pogojih upravičenosti in trenutnem katalogu najdete na **[radar.omniroute.online/planos](https://radar.omniroute.online/planos)**.

## ✨ Kaj je novega

> Nedavni poudarki različic **v3.8.20 → v3.8.53**. Celotna zgodovina v [`CHANGELOG.md`](CHANGELOG.md). - **⚖️ Usmerjanje `quota-weighted`** — dvajseta kombinirana strategija preskoči izčrpane račune, nato med preostalimi izbira sorazmerno s preostalo kvoto ÷ obremenitvijo v teku, pri čemer obstoječi pogovori ostanejo pripeti. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🧰 Način brez glave (headless)** — `omniroute serve --headless` (ali `OMNIROUTE_HEADLESS=1`) zažene samo proxy mehanizem `/v1/*`, nadzorna plošča in podsistemi, namenjeni izključno nadzorni plošči, pa so izklopljeni. → [Način brez glave](docs/guides/HEADLESS.md) - **🔎 Odkrivanje modelov** — `/v1/models` filtrira po zmožnosti, kontekstu, vrsti in besedilu, `POST /v1/models/query` pa vrne kratek determinističen izbor z enako vidnostjo po ključih. → [Referenca API](docs/reference/API_REFERENCE.md) - **🔑 Nadzor usmerjanja po ključih** — pripnite API ključ na en model ali kombinacijo s `forcedModel` ter atomarno dodajte ali odstranite modele in kombinacije ključa (`/api/keys/{id}/access`). → [Referenca API](docs/reference/API_REFERENCE.md) · [OpenAPI](docs/openapi.yaml) - **🛡️ Natančnejši nadzori PII** — izbira po vrstah, do 20 validiranih vzorcev maskiranja po meri in števci zaznavanja po vrstah; samo maskiranje ostaja opcijsko. → [Zaščitni mehanizmi](docs/security/GUARDRAILS.md) - **🌍 67 jezikov** — nadzorna plošča, ogledala dokumentacije in CLI, pri čemer `npm run i18n:add-locale` doda jezik povsod z enim samim ukazom. → [Vodnik i18n](docs/guides/I18N.md) - **🎛️ OmniConductor** — dohodna A2A delegacija vaši floti agentov, veščine Conductor na kartici agenta (Agent Card) in plošča na nadzorni plošči z Faro push-to-talk glasovnim klepetom. → [A2A strežnik](docs/frameworks/A2A-SERVER.md) - **🛂 Prilagodljiv sprejem in zaščita pred preobremenitvijo** — težke chat zahteve se uvrstijo v čakalno vrsto namesto da bi vrnejo napako 503, z atomarnimi drsečimi RPM zakupi na povezavo. → [Vodnik odpornosti](docs/architecture/RESILIENCE_GUIDE.md) - **🗂️ Kanoničen vrstni red `/v1/models`** — en neprekinjen, po ponudniku združen blok na ponudnika (kombinacije pripete najprej), stabilen v vseh virih kataloga. → [Referenca API](docs/reference/API_REFERENCE.md) - **🗜️ Utrditev kompresije** — privzeto vklopljena zaščita pred napihovanjem, paketi Caveman za DE / FR / JA + kitajščino (wényán), RTK filtri za Gradle & .NET. → [Kompresija](docs/compression/COMPRESSION_ENGINES.md) - **💸 Pošten strošek pavšalne tarife** — ponudniki z naročnino / paketom za kodiranje se v analitiki stroškov prikažejo kot **$0**; proračun, kvota in usmerjanje še naprej ocenjujejo. → [Referenca API](docs/reference/API_REFERENCE.md) - **⚖️ Usmerjanje Quota-Share** — pošteno razdelite kvoto skupnega računa med združene ključe, z ohranjanjem dela, tako da se nedejavni deleži izposojajo. → [Vodnik odpornosti](docs/architecture/RESILIENCE_GUIDE.md) - **🤖 Nastavitev CLI/agenta z enim ukazom** — 15 registriranih ukazov `setup-*`; `omniroute run` zažene 7 CLI-jev (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); `omniroute configure` podpira 11 ciljev z interaktivnim izbirnikom ponudnika+modela in priljubljenimi po kontekstu. → [CLI integracije](docs/guides/CLI-INTEGRATIONS.md) - **🛰️ Oddaljeni način** — upravljajte oddaljeni OmniRoute z žetoni z omejenim obsegom (`connect` / `contexts` / `tokens`) + `antigravity` OAuth pomočnikom za namestitve na VPS. → [Oddaljeni način](docs/guides/REMOTE-MODE.md) - **🧭 Pametnejše samodejno usmerjanje** — kombinacije `auto/:`, **Fusion** (panel modelov + sodnik), usmerjanje glede na nalogo, preglasitve modela / načina / USD proračuna po zahtevi. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🗜️ Kompresija z vtičniki** — 12 sestavljivih mehanizmov + Compression Studios: LLMLingua-2, dvostopenjski Ultra, omniglyph, vrata zvestobe po korakih, GCF v3.2, urejevalnik s povleci in spremeni vrstni red. → [Kompresija](docs/compression/COMPRESSION_ENGINES.md) - **🕵️ Transparentno MITM dešifriranje (TPROXY)** — zajemite CLI-je, ki prezirajo okoljske spremenljivke proxyja, s CA po SNI + namestitvenim programom za shrambo zaupanja. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md) - **💸 Telemetrija stroškov povsod** — glave `X-OmniRoute-*` o stroških/uporabi na vsaki končni točki, glava prihrankov ob zadetku predpomnilnika (cache-HIT), kvote porabe v USD po ključih. → [Referenca API](docs/reference/API_REFERENCE.md) - **🧠 Spomin, ki ga nadzirate** — privzeto izklopljen, opcijska int8 vektorska kvantizacija + tipizirano propadanje, po zahtevi `x-omniroute-no-memory`. → [Spomin](docs/frameworks/MEMORY.md) - **🛡️ Varnost** — zaščita pred vbrizgavanjem pozivov na vsaki LLM poti (red-team paket), opcijski varnostni mehanizem maskiranja poverilnic (prikrije ušle API ključe/skrivnosti v obe smeri), brezplačno spletno iskanje DuckDuckGo kot zadnja možnost in opcijska OIDC prijavna vrata za nadzorno ploščo (prijava z geslom ostaja vedno na voljo). → [Zaščitni mehanizmi](docs/security/GUARDRAILS.md) - **🖼️ Nove končne točke** — `/v1/ocr` (Mistral OCR) in `/v1/audio/translations` (v slogu Whisper) zaokrožujeta medijsko ponudbo. → [Referenca API](docs/reference/API_REFERENCE.md) - **🎨 Generiranje slik / videa / zvoka** — en API za medije: xAI Grok Imagine & Novita AI video, ComfyUI, Magnific, Adobe Firefly, Segmind in ponudniki govora, kot je ElevenLabs. → [Referenca API](docs/reference/API_REFERENCE.md) - **🌍 Namestitev in operacije** — `basePath` za povratni proxy, samodejno zaznavanje jezika brskalnika, sledenje naprav po ključih, MITM zaupanje brez roota, lokalizacija zh-TW. → [Okolje](docs/reference/ENVIRONMENT.md) - **🤝 Več ponudnikov in agentov** — oblak agenti (Codex Cloud, Cursor, Devin, Jules), Grok Build (xAI) z brskalnikom + OAuth prijavo, prvovrstna kartica Ollama, Claude Opus 5 & Sonnet 5, uradno partnerstvo Kimi (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… in osvežen **katalog 375 ponudnikov**. → [Ponudniki](docs/reference/PROVIDER_REFERENCE.md) - **📡 Preglednost usmerjanja** — vsak odgovor nosi glavo `X-OmniRoute-Decision`, ki imenuje strategijo/ponudnika/zakasnitev, ki ga je postregla, nova kombinirana strategija `cache-optimized` + faktor `cacheAffinity` v Auto-Combo usmerjata ponovne zahteve nazaj na povezavo, ki hrani predpomnjeno predpono, končna točka samo za branje `/v1/auto-combo/{channel}/candidates` pa razkriva živi nabor kandidatov kanala `auto/*`. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **⚡ Lokalna zmogljivost in infrastruktura** — lokalni Redis z enim klikom, namestitelji posrednikov za Cloudflare Workers / Deno Deploy, Bifrost in Mux kot nadzorovani vdelani storitvi. → [Vdelane storitve](docs/frameworks/EMBEDDED-SERVICES.md) - **🧩 Prav tako v paketu** — ogrodje vtičnikov + tržnica, ogrodja znanj Omni/Agent/GitHub, integracija z Obsidian sefom (22 orodij MCP), z OpenAI združljiva API-ja Batch & Files, semantični predpomnilnik odzivov, gamifikacija z lestvicami, odkrivanje agentov ACP (15 vgrajenih agentov), načrtovani izvoz dnevnikov v BigQuery, `auto/chaos` vzporedno razvejanje med več modeli, most za Telegramove bote, upravitelj različic znotraj aplikacije in lestvice brezplačnih ponudnikov LMArena-ELO. → [Dokumentacija](docs/README.md)

## 🤖 Združljivi vmesniki CLI in programski agenti > Ena konfiguracija — `http://localhost:20128/v1` — in **vsak** IDE ali CLI z umetno inteligenco deluje z brezplačnimi in cenovno ugodnimi modeli.

_{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

＋ deluje tudi z · Agent Deck · Kiro · Command Code · Antigravity · Windsurf · AMP · katerim koli orodjem, združljivim z OpenAI

_{📖 Nastavitev posameznega orodja za vseh 37 orodij (27 orodij CLI Code + 10 agentov CLI) → [`docs/reference/CLI-TOOLS.md`](docs/reference/CLI-TOOLS.md) · 🧩 Vtičnik OpenCode → [`@omniroute/opencode-provider`](https://www.npmjs.com/package/@omniroute/opencode-provider)}

**Zaženite kateri koli podprti CLI prek OmniRoute z enim ukazom** — brez zapisovanja konfiguracijskih datotek, poverilnice se vstavijo za vsak proces posebej, Qwen/Gemini pa dobita začasen izoliran domači imenik: ```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" # Ali interaktivno izberite ponudnika in model ter zapišite lastno konfiguracijo orodja: omniroute configure codex # na voljo tudi: claude opencode qwen aider goose gemini cline continue kilo 5dive ``` Vsak ukaz upošteva aktivni oddaljeni kontekst (`omniroute connect `), `--dry-run` prikaže predogled točnih spremenljivk okolja/argumentov brez izvajanja, `--api-key-env NAME` pa prepreči, da bi skrivnosti končale v zgodovini vaše lupine. → [Integracije CLI](docs/guides/CLI-INTEGRATIONS.md)

## 🌐 375 ponudnikov AI — 153 jih je v katalogu označenih kot brezplačni

> **375 registriranih ponudnikov** v kanoničnih zbirkah za klepet, medije, iskanje, lokalno uporabo, oblak-agente in sistem, vključno s **153, ki nosijo odkrivne metapodatke `hasFree: true`**. Register modelov klepeta zajema **239 ponudnikov / 3.059 različnih parov ponudnik–model / 1.475 surovih ID-jev modelov**; ločen katalog brezplačnega proračuna ima **467 vrstic na model**, **34 ponavljajočih se bazenov** in **51 ponavljajočih/brezključnih ponudnikov, ki so za vedno brezplačni**. To so po zasnovi različni imenovalci; definicije in izračuni z odstranjenimi podvojitvami bazenov so na voljo v [Referenci ponudnikov](docs/reference/PROVIDER_REFERENCE.md) in [Brezplačnih nivojih](docs/reference/FREE_TIERS.md).

### 🏢 Vsak večji laboratorij — prek ene končne točke

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

_{…in več kot 350 drugih — vsaka ikona se v živo razreši iz kataloga ponudnikov na nadzorni plošči. 📖 [Referenca ponudnikov](docs/reference/PROVIDER_REFERENCE.md)}
### 🆓 Za vedno brezplačno — 0 $, brez kartice

OpenCode Zen _{DeepSeek V4, Nemotron 3 Brez omejitve žetonov}	Kilo Code _{Samodejni usmerjevalnik, Tencent Hy3 Za vedno brezplačno}	Requesty _{GPT-OSS 120B, Nemotron Za vedno brezplačno}	SiliconFlow _{DeepSeek V3.2 / R1 Brezplačni paket}	Z.AI GLM _{GLM-4.7 / 4.5-Flash Za vedno brezplačno}	Baidu ERNIE _{ERNIE 4.0 Za vedno brezplačno}
Qoder AI _{Qwen3-Max, Kimi-K2 Neomejeno BREZPLAČNO}	Pollinations _{GPT, Llama, Claude Ključ ni potreben}	Cloudflare AI _{50+ modelov 10K nevronov/dan}	NVIDIA NIM _{GLM, MiniMax ~40 RPM brezplačno}	Cerebras _{GLM 4.7, GPT-OSS Enkratni kredit $5; potrebna kartica}	OpenRouter _{modeli :free +$10 → višji RPM}

📖 Celoten strojno berljiv katalog → [`docs/reference/PROVIDER_REFERENCE.md`](docs/reference/PROVIDER_REFERENCE.md)

## 🖥️ Kje deluje OmniRoute — kjer koli

> Ista aplikacija, vaša naprava, vaša pravila. Od globalne namestitve npm do **vašega telefona** prek Termuxa.

Platforma	Namestitev	Prednosti
📦 npm (globalno)	`npm install -g omniroute`	En ukaz, kateri koli OS
🐳 Docker	`docker run … diegosouzapw/omniroute`	Več arhitektur: AMD64 + ARM64
🖥️ Namizje (Electron)	`npm run electron:build`	Izvorno okno + sistemski pladenj — Windows / macOS / Linux
🎩 Menijska vrstica (OmniRouteTray)	`brew install --cask zoispag/tap/omniroute-tray`	Nadzira & samodejno posodablja strežnik — macOS
💪 ARM	izvorni `arm64`	Raspberry Pi, strežniki ARM, Apple Silicon
📱 Android (Termux)	`pkg install nodejs && npx -y omniroute`	Deluje na vašem telefonu, 24/7, brez korenskega dostopa
📲 PWA	"Dodaj na začetni zaslon"	Celozaslonsko delovanje, delovanje brez povezave in namestitev iz brskalnika
🧩 Vtičnik OpenCode	`@omniroute/opencode-provider`	Izvorna integracija z OpenCode
🤖 VS Code Copilot Chat	namestite razširitev OmniCopilot	Vsi modeli OmniRoute v izvornem izbirniku Copilot Chat — stabilna različica & Insiders
🛠️ Iz izvorne kode	`npm install && npm run dev`	Prilagajajte ga in prispevajte

_{📖 [Vodnik za Docker](docs/guides/DOCKER_GUIDE.md) · [Namizje](electron/README.md) · [Pladenj v menijski vrstici](https://github.com/zoispag/omniroute-tray) · [Termux](docs/guides/TERMUX_GUIDE.md) · [PWA](docs/guides/PWA_GUIDE.md) · [OpenCode](docs/frameworks/OPENCODE.md)}

### 🧩 Novo: OmniRoute znotraj izvornega vmesnika Copilot Chat v VS Code

> Brez nove stranske vrstice in brez novega uporabniškega vmesnika za klepet — vsak model, ki ga ponuja OmniRoute, se prikaže neposredno v > **izbirniku modelov Copilot Chat, ki ga že uporabljate**. Od različice VS Code 1.122 modeli ponudnikov delujejo > brez prijave v GitHub ali naročnine na Copilot — agentski način, klicanje orodij in vid, vse > brezplačno. Namestite razširitev **[OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)**, usmerite jo na svoj strežnik OmniRoute (privzeto `localhost:20128`), nato odprite Copilot Chat → izbirnik modelov → **Upravljanje modelov …** → **OmniRoute**.

Trgovina	Povezava	Deluje z
🧩 VS Code Marketplace	Namesti →	VS Code — stabilna različica & Insiders
🔓 Open VSX Registry	Namesti →	Cursor, Windsurf, VSCodium, Theia, code-server, Gitpod, Antigravity, Kiro …

V urejevalniku odprite pogled **Razširitve**, poiščite **"OmniRoute"** in kliknite **Namesti** — v obeh trgovinah deluje enako. Izvorna koda, težave in navodila za objavljanje so na voljo na [diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot). _{📖 [Vodnik za VS Code Copilot Chat](docs/guides/VSCODE-COPILOT.md) — nastavitev, vsebina izbirnika, nadzorna plošča v zavihku, odpravljanje težav}

### 🎩 Novo: OmniRouteTray — vaš prehod v menijski vrstici

> `omniroute serve` najbolje deluje, ko je vedno vklopljen. **[OmniRouteTray](https://github.com/zoispag/omniroute-tray)** > ga spremeni v aplikacijo za menijsko vrstico sistema macOS, ki jo nastavite in nanjo pozabite: zažene strežnik, ga ohranja pri delovanju > med ponovnimi zagoni, ga sproti posodablja in omogoča dostop do trenutne omejitve žetonov z enim klikom — **brez > odprtega terminalskega okna in brez potrebe po nadzorovanju ukaza `npm install -g omniroute`.** Zgrajen je s [Tauri v2](https://v2.tauri.app/) (jedrom Rust, majhnim kot zaokrožitvena napaka) ter vključuje lastno podpisano izvajalno okolje Node 24 in upravlja namestitev OmniRoute v lasti aplikacije, zato nikoli ne prihaja v spor z vašim globalnim okoljem `node`/`bun`. **Souporablja vašo obstoječo konfiguracijo in podatkovno zbirko v `~/.omniroute/`** — zato je to isti OmniRoute, ki ga že uporabljate, le da zdaj nosi klobuk. 🎩

Kaj počne	Kako
🟢 Nadzira strežnik	Zažene `omniroute serve` in prevzame že delujoči primerek, namesto da bi ga podvojil
📊 Sprotni pregled uporabe	Vrstice kvot ponudnikov, omejitve seje/tedna za Claude z odštevanjem do ponastavitve in 30-dnevna razčlenitev stroškov
🔄 Samodejno sprotno posodabljanje	Postopna namestitev, atomska zamenjava in povrnitev ob napaki — vedno uporablja najnovejšo izdajo
🚀 Zagon ob prijavi	Izbirni zagon ob prijavi; samo v pladnju, brez ikone v vrstici Dock
🩺 Diagnostika & dnevniki	Diagnostika in dostop do dnevnika strežnika z enim klikom

```sh brew install --cask zoispag/tap/omniroute-tray ``` _{Imate raje prenos? Prenesite najnovejšo datoteko .dmg iz razdelka
Izdaje. Izvorna koda, težave in dokumentacija za gradnjo
so na voljo v repozitoriju zoispag/omniroute-tray.

💛 Skupnostni projekt avtorja @zoispag — ni uradna izdaja OmniRoute.}

## 🔒 Zasebno in lokalno zasnovano

_{📖 [Avtorizacija](docs/architecture/AUTHZ_GUIDE.md) · [Zaščitni mehanizmi](docs/security/GUARDRAILS.md) · [Skladnost](docs/security/COMPLIANCE.md)}

## 🔌 Celovit CLI + A2A in MCP

> Poleg strežnika je OmniRoute **celovito ukaznovrstično nadzorno središče** z **več kot 80 ukazi** in odprtimi protokoli za agente, tako da ga lahko agent umetne inteligence upravlja **samostojno**. ### ⌨️ Pravi CLI (ne le `start`) ```bash omniroute # zaženi prehod in nadzorno ploščo (vrata 20128) omniroute chat # interaktivni odjemalec za klepet TUI (poševni ukazi: /model /combo /skill /memory) omniroute setup # vodeni čarovnik za prvi zagon omniroute doctor # diagnosticiraj ponudnike, vrata in izvorne odvisnosti ``` ### 🛰️ Oddaljeni način — CLI zaženite tukaj, OmniRoute pa na VPS-u Je OmniRoute na strežniku? Upravljajte ga s prenosnika z **istim CLI-jem**. Enkrat se prijavite z žetonom za dostop z omejenim obsegom; vsak ukaz bo nato usmerjen v oddaljeni strežnik. ```bash omniroute connect 192.168.0.15 # geslo → žeton z omejenim obsegom, shranjen kot kontekst omniroute models # ← izvede se na ODDALJENEM strežniku omniroute configure codex # ← izbere oddaljeni model in zapiše lokalni profil Codex omniroute tokens create --name ci --scope read # ustvari žetone z ožjim obsegom za druge naprave omniroute contexts use default # ← preklopi nazaj na lokalni strežnik ``` Žetoni imajo obseg `read` / `write` / `admin`; poti, ki zaganjajo procese, ostanejo dostopne le prek povratne zanke. _{📖 [Oddaljeni način](docs/guides/REMOTE-MODE.md)}

Animirani terminalski prikaz CLI-ja OmniRoute — omniroute providers list, omniroute combo list in omniroute health — s kroženjem po 89 ukazih na najvišji ravni: 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 …

### 🤝 Povežite agenta — in OmniRoute bo upravljal sam OmniRoute izpostavite prek **MCP-ja**, **A2A-ja**, **REST API-ja**, **spletnih kavljev** ali **oddaljenega CLI-ja** — vsak zmogljiv agent (ali vaša lastna koda) dobi ključe do celotnega prehoda: usmerjanja, ponudnikov, kombinacij, predpomnilnika, stiskanja in pomnilnika — vse to avtonomno. Spodnje končne točke HTTP so na voljo pod `http://localhost:20128`.

Vmesnik	Končna točka/ukaz	Namen uporabe
🧰 MCP (stdio)	`omniroute --mcp`	Povežite s Claude Desktop, Cursorjem ali katerim koli odjemalcem MCP
🌊 MCP (HTTP)	`/api/mcp/stream`	Oddaljeni MCP — 110 orodij, 33 obsegov (uveljavljanje je izbirno), popolna revizijska sled
📡 MCP (SSE)	`/api/mcp/sse`	Pretočni prenos MCP
🤝 A2A	`/.well-known/agent.json`	Komunikacija med agenti, JSON-RPC 2.0 + SSE, 6 veščin
🌐 REST API	`/v1/*`	Združljiv z OpenAI — klepet, vdelave, slike, zvok, OCR
🔔 Spletni kavlji	`/api/webhooks`	Pošiljajte dogodke zahtev/kvot v Slack, Discord, Telegram ali na kateri koli URL
🛰️ Oddaljeni CLI	`omniroute connect`	Upravljajte oddaljeni primerek z žetoni za dostop z omejenim obsegom

```bash # Omogočite Claude Code celoten nabor orodij OmniRoute prek MCP-ja: claude mcp add-server omniroute --type http --url http://localhost:20128/api/mcp/stream ``` _{📖 [Strežnik MCP](docs/frameworks/MCP-SERVER.md) · [Strežnik A2A](docs/frameworks/A2A-SERVER.md) · [Protokoli za agente](docs/frameworks/AGENT_PROTOCOLS_GUIDE.md)}

## 🗜️ Prihranite 15–95 % žetonov — samodejno

### 📖 Kako deluje — cevovod, arhitektura in računica prihrankov

Cevovod stiskanja OmniRoute: ponazoritvena odjemalska zahteva z 10.000 žetoni gre skozi 12 sestavljivih pogonov — Session-Dedup, CCR, Lite, RTK, Responses Tool Output, Headroom, Relevance, Caveman, Aggressive, LLMLingua-2, Ultra in OmniGlyph — in lahko pri ponudniku prispe s približno 1.080 žetoni v dokumentiranem zloženem primeru. Strukturirano vsebino ščitijo varovala ohranjanja in kontrolne točke zvestobe na vsakem koraku; izrecni načini z izgubami ali poskusni načini lahko preoblikujejo primerno vsebino.

Privzeta zložena kombinacija izvaja `RTK → Caveman`. Ko oba delujeta na isti vsebini orodja/konteksta, se prihranki stopnjujejo: ```txt combined = 1 − (1 − RTK) × (1 − Caveman_input) average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2% range = 78.4 – 94.6% ``` Bloki kode, URL-ji, JSON in strukturirani podatki so **vedno zaščiteni** s pogonom ohranjanja. > **Zakaj uporabljati veliko žetonov, ko jih malo zadostuje?** Vsaka zahteva gre skozi cevovod stiskanja OmniRoute **transparentno** — brez sprememb odjemalca. Zdaj je to **sklad 12 sestavljivih pogonov**, ki se izvajajo zaporedno in se mešajo ter kombinirajo glede na kombinacijo usmerjanja — gradijo na idejah iz [RTK](https://github.com/rtk-ai/rtk), [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ 90K+), [LLMLingua-2](https://github.com/microsoft/LLMLingua) in [Troglodita](https://github.com/leninejunior/troglodita) (PT-BR). ### 🧱 Sklad 12 pogonov Pogoni se izvajajo v vrstnem redu cevovoda; vsakega je mogoče neodvisno vklopiti/izklopiti in konfigurirati za vsako kombinacijo:

#	Pogon	Kaj počne
1	Session-Dedup	Odstrani vsebino, ki se ponavlja čez obrate (naslavljanje po vsebini, čez obrate)
2	CCR	Arhivira velike bloke za označevalci pridobitve; pridobijo se na zahtevo
3	Lite	Obrezovanje presledkov in URL-jev slik (osnovna raven z nizko zakasnitvijo)
4	RTK	Pametno filtriranje rezultatov orodij, deduplikacija in odrezovanje (zavedanje ukazov)
5	Responses Tool Output	Najprej brezizguben JSON + omejeno diagnostično stiskanje za izhode lupine, obližev, iskanja in gradnje (Responses API)
6	Headroom	Brezizgubno tabelarično zgoščanje polj JSON (~30 %) prek priloženega kodeka GCF
7	Relevance	Ekstraktivno ocenjevanje stavkov glede na zadnjo uporabnikovo poizvedbo
8	Caveman	Stiskanje proze na podlagi pravil (~65–75 % na izhodu)
9	Aggressive	Povzemanje + postopno staranje starih obratov
10	LLMLingua-2	Semantično obrezovanje z ML prek MobileBERT ONNX — varno za kodo, asinhrono
11	Ultra	Hevristično obrezovanje žetonov z izbirno ravnjo majhnega modela (SLM)
12	OmniGlyph	Poskusno kodiranje konteksta kot slike za izmerjeni Claude Fable 5 na neposredni povezavi Anthropic; transformerji GPT 5.6 ostajajo fail-closed, dokler ni potrdil ponudnika. Štirje profili stiskanja (privzeto agresivni, uravnoteženi, varni za kodo, passthrough) (najbolj agresivni; po izbiri)

Bloki kode, URL-ji in strukturirani podatki so **vedno ohranjeni** do bajta natančno. **Prednastavitve na en klik** združujejo pogone:

Način	Prihranki	Najboljše za
🪶 Lite	~15 %	Vedno vklopljena varna privzeta raven
🪨 Standard (Caveman)	~30 %	Vsakodnevno kodiranje
⚡ Aggressive	~50 %	Dolge seje z intenzivno uporabo orodij
🔥 Ultra	~75 %	Največji prihranki
🧰 RTK	60–90 %	Izhod shell/test/build/git
🔗 Stacked (RTK → Caveman)	78–95 %	Mešani pozivi + dnevniki orodij

**Resnični primer — način Standard:** > **Pred (69 žetonov):** _"Razlog, da se vaša komponenta React ponovno upodablja, je verjetno v tem, da v vsakem ciklu upodabljanja ustvarjate novo referenco na objekt. Ko kot lastnost (prop) posredujete inline objekt, ga Reactova plitva primerjava vsakič vidi kot drug objekt, kar sproži ponovno upodabljanje. Priporočal bi uporabo useMemo za memoizacijo objekta."_ > > **Po (19 žetonov):** _"Nova referenca objekta ob vsakem upodabljanju. Inline objekt kot prop = nova referenca = ponovno upodabljanje. Ovijte v useMemo."_ > > **Isti odgovor. 72 % manj žetonov. Nič izgube natančnosti.** ✅ **Primer PT-BR — način [Troglodita](https://github.com/leninejunior/troglodita):** > **Pred (42 žetonov):** _"Težava je v tem, da se komponenta ponovno upodablja, ker se v vsakem ciklu upodabljanja ustvari nova referenca objekta. Priporočal bi uporabo useMemo."_ > > **Po (12 žetonov):** _"Ponovno upodabljanje: nova ref. v vsakem ciklu (objekt inline ponovno ustvarjen). Uporabite `useMemo`."_ > > **Isti odgovor. ~70 % manj žetonov. Tehnična natančnost nedotaknjena.** ✅
### 🎚️ Poleg pogonov — izhodni slogi, prilagodljiv gumb in nadzor po zahtevku Zgornjih 12 pogonov skrči tisto, kar gre **noter**. Tri dodatne plasti oblikujejo, **kako**, **kdaj** in kaj pride **ven**: - **🪄 Izhodni slogi** _(usmerjanje po izhodni osi)_ — vstavijo deterministična, za predpomnilnik varna navodila za oblikovanje odgovorov; med seboj združljivi, vsak z intenzivnostjo `lite` / `full` / `ultra`. Dodajanje sloga je enovrstični vnos v register: - **Jedrnata proza** — opusti polnilne besede / členke / ovinkarjenje; ohrani natančno tehnično vsebino. - **Manj kode** — YAGNI "lenega senior razvijalca": najmanjša delujoča sprememba, brez nezahtevanega ogrodja. - **Ponytail (leni senior razvijalec)** — povzpne se po lestvici YAGNI, odpravi korenski vzrok, najmanjši delujoči diff. - **Imam ADHD (najprej dejanje)** — naslednje dejanje vodi, koraki so oštevilčeni, en konkreten naslednji korak, brez uvoda. - **Jedrnata CJK (文言)** — izjemno jedrnat slog klasične kitajščine (omejeno na področno nastavitev `zh`). - **🎯 Prilagodljiv kontekstni proračun** _(gumb)_ — namesto enega samega praga žetonov za vklop/izklop stopnjuje najcenejše, najbolj brezizgubne pogone le toliko, kolikor je potrebno, da se vsebina **prilega kontekstnemu oknu modela**. Politika: `reserve-output` (privzeto, glede na model) · `percentage` · `absolute`. Način: `floor` (zagotovljeno prileganje) · `replace-autotrigger` (vaša izrecna izbira ima prednost) · `off` (podedovan prag). - **🎛️ Kje se odloča o stiskanju** _(prednost, visoka → nizka)_ — glava `x-omniroute-compression` na zahtevo › preglasitev kombinacije usmerjanja › aktivni poimenovani profil › prilagodljivo / samodejni sprožilec › privzeta nastavitev plošče › izklopljeno. Uporabljeni načrt se odzove nazaj v glavi odgovora `X-OmniRoute-Compression: ; source=`. Samodejno sproženje po pragu žetonov, vklop prilagodljivega gumba, pripetje poimenovanega profila, enkratna nastavitev na zahtevo ali dodelitev cevovoda na kombinacijo usmerjanja — kar koli ustreza delovni obremenitvi. Izbirno brezpovezavno **ocenjevalno ogrodje** (`npm run eval:compression`) na pripetem korpusu oceni zvestobo glede na prihranke, preden spremembo uveljavite. 📖 [`COMPRESSION_GUIDE.md`](docs/compression/COMPRESSION_GUIDE.md) · [`RTK_COMPRESSION.md`](docs/compression/RTK_COMPRESSION.md) · [`COMPRESSION_ENGINES.md`](docs/compression/COMPRESSION_ENGINES.md)

# ⚡ Hitri začetek

**1) Namestitev in zagon** ```bash npm install -g omniroute omniroute ``` > 💡 Vidite `npm warn ERESOLVE` ali opozorila o peer-odvisnostih? [Nedolžna so](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated). > **Uporabljate npm 11 ali novejši?** npm lahko blokira skripte življenjskega cikla paketov, če niso dovoljene. OmniRoutov `postinstall` (`node scripts/build/postinstall.mjs`) je potreben za pripravo njegovih izvornih izvajalnih datotek. Pri globalni namestitvi dovolite pakete, navedene v opozorilu npm. Za nabor paketov, ki ga navaja OmniRoute 3.8.53: > > ```bash > npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute > ``` > > Če želite ta seznam dovoljenih ponovno uporabiti pri prihodnjih globalnih namestitvah, ga enkrat konfigurirajte, nato pa nameščajte običajno: > > ```bash > npm config set allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild --location=user > npm install -g omniroute > ``` > > Seznam odvisnosti se lahko med izdajami spremeni; če npm javi drugačen seznam, uporabite imena paketov iz tistega opozorila. Če paket dovolite, se lahko zaženejo njegove namestitvene skripte. > **Uporabljate Gemini Web ali drugega ponudnika prek spletnih piškotkov?** Paket npm vključuje > Playwright, ne pa njegove binarne datoteke Chromium. Pred prvo zahtevo do spletnega ponudnika si oglejte opombo > [Nastavitev Playwright Chromium](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium). Nadzorna plošča na `http://localhost:20128` · API na `http://localhost:20128/v1`. **2) Povežite primernega ponudnika s svojim računom** Nadzorna plošča → **Ponudniki** → izberite ponudnika, katerega trenutni pogoji in kvota ustrezajo vašemu primeru uporabe → dodajte njegov ključ API ali dokončajte postopek povezave računa. Brezplačne ravni lahko zahtevajo registracijo, odobritev ali plačilno sredstvo. Preglejte [Vodnik po brezplačnih ravneh](docs/getting-started/FREE-TIERS-GUIDE.md); razpoložljivost brez ključa ni zagotovljena, ponudniki z oznako `tos: avoid` pa so privzeto izključeni iz `auto`. **3) Usmerite svoje orodje za kodiranje** ```txt Base URL: http://localhost:20128/v1 API Key: [copy from Dashboard → Endpoints] Model: auto (routes among eligible connections — or choose provider/model) ``` **4) Preverite, ali deluje** ```bash curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY" ``` Videti bi morali navedene povezane modele. 🎉 To je vse — začnite kodirati, OmniRoute pa bo namesto vas samodejno usmerjal in preklapljal v rezervo. Če vaš odjemalec ne more pošiljati glav po meri, OmniRoute razkriva tudi žetonirane vzdevke za združljivost: ```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 ``` Te uporabite le za odjemalce, ki ne morejo priložiti `Authorization: Bearer ...`. Avtentikacija z glavo ostane prednostni način.
## 📦 Več načinov namestitve — Docker, izvorna koda, 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` sledi najvišji **objavljeni** stabilni različici SemVer. Ne sledi veji git `main`. Za GitOps pripnite `:X.Y.Z`. Glejte [Kanali izdaj Docker](docs/guides/DOCKER_GUIDE.md#release-channels). Slika ima nastavljeno **`OMNIROUTE_MEMORY_MB=1024`**. To zadostuje za nadzorno ploščo in lažji klepet. **Agenti za programiranje** (`POST /v1/responses` iz Claude Code, Codex, Grok, …) potrebujejo precej večjo kopico V8, sicer se proces pri približno 12 GiB in dveh prekrivajočih se dolgih kontekstih konča z napako `FATAL ERROR`. Velikost vsebnika nastavite nad velikostjo kopice (izvorni medpomnilniki so zunaj V8): | Delovna obremenitev | Kopica (`-e OMNIROUTE_MEMORY_MB`) | Vsebnik (`--memory`) | | --------------------------------- | --------------------------------- | -------------------- | | Nadzorna plošča / lažji klepet | `1024` (privzeto v sliki) | ≥2 g | | En agent za programiranje | `8192` | ≥10 g | | Dva sočasna dolga `/v1/responses` | `10240`–`12288` | ≥12–16 g | ```bash docker run -d --name omniroute --restart unless-stopped --stop-timeout 40 \ -e OMNIROUTE_MEMORY_MB=8192 --memory=10g \ -p 127.0.0.1:20128:20128 -v omniroute-data:/app/data diegosouzapw/omniroute:latest ``` Celotna tabela: [Vodnik za Docker — pomnilnik RAM med izvajanjem](docs/guides/DOCKER_GUIDE.md#runtime-ram-for-coding-agents). > **Kanal predizdaj Docker:** `diegosouzapw/omniroute:next` in > `diegosouzapw/omniroute:next-web` sledita trenutni privzeti veji `release/v*`. > Ti spremenljivi oznaki sta namenjeni samo preizkušanju še neobjavljenih popravkov in > **nista podprti za produkcijsko uporabo**. Glejte > [Kanali izdaj Docker](docs/guides/DOCKER_GUIDE.md#release-channels). **🥟 Bun** Standardna ukaza `bun install` in globalna namestitev (`bun install -g omniroute`) sta podprta prek zaznavanja izvajalnega okolja Bun: - **Vgrajeni `bun:sqlite`**: OmniRoute med izvajanjem v okolju Bun uporablja njegov vgrajeni gonilnik `bun:sqlite`, v okolju Node.js pa preklopi na `better-sqlite3` ali `sql.js`. - **Samodejna izbira pakirnika Webpack med razvojem**: Razvojno izvajanje (`bun run dev`) samodejno zazna Bun in onemogoči Turbopack v korist Webpacka, da prepreči nezdružljivosti izvornih vezav V8. Produkcijske gradnje (`bun run build`) upoštevajo `OMNIROUTE_USE_TURBOPACK` povsem enako kot v okolju Node: privzeto uporabljajo Turbopack, z `OMNIROUTE_USE_TURBOPACK=0` pa se gradijo z Webpackom (`Dockerfile.bun` to izpostavi kot `--build-arg`). - **Namenska datoteka Dockerfile za Bun**: Večstopenjska datoteka `Dockerfile.bun` za izvorne produkcijske uvedbe Bun (`docker build -f Dockerfile.bun -t omniroute:bun .`). ```bash # Namestitev in zagon z okoljem Bun bun install bun run dev ``` **🛠️ Iz izvorne kode** ```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 # Uporaba paketov Flake Nix nix develop npm run dev # Ali uporaba okolja devbox devbox run npm run dev ``` 📖 [Vodnik za Docker](docs/guides/DOCKER_GUIDE.md) — profili Compose, Caddy HTTPS in tuneli Cloudflare. **🦭 Podman** ```bash # 1. Pripravite priklopljeni podatkovni imenik mkdir -p data # 2. Samo Linux in lokalni brezkorenski Podman (nikoli oddaljeni odjemalec Podman Machine): podman unshare chown 1000:1000 ./data # 3. Nastavite namig izvajalnega okolja, zgradite lokalno sliko Compose in jo zaženite echo "CONTAINER_HOST=podman" >> .env podman compose --profile base up -d --build ``` V sistemih macOS ali Windows uporablja Podman oddaljeni Podman Machine: preskočite `podman unshare` in upoštevajte [navodila za podatkovni imenik glede na topologijo](contrib/podman/README.md#data-directory-permissions-by-topology). 📖 [Vodnik za Podman](contrib/podman/README.md) — gradnje Compose, Podman Machine in nastavitev Quadlet za Linux/systemd. **⚡ Hitrejša / varčnejša namestitev (brez izvorne gradnje)** Izvorni mehanizem SQLite (`better-sqlite3`) je **izbirna** odvisnost, zato globalna namestitev nikoli ne čaka na prevajanje iz izvorne kode: če je na voljo vnaprej prevedena binarna datoteka, ki ustreza vaši platformi/različici Node, jo uporabi, sicer pa neopazno preklopi na mehanizem v čistem JS (`node:sqlite` v Node 22+, sicer priloženi `sql.js` WASM) — orodja za gradnjo niso potrebna. Če želite v celoti preskočiti **izvorno ogrevanje** po namestitvi (v okoljih CI, brez grafičnega vmesnika ali na počasnih napravah). Opomba: s tem preskočite samo korak ogrevanja izvornega SQLite (`scripts/postinstall.mjs`); kavelj za kopiranje/popravilo binarne datoteke (`scripts/build/postinstall.mjs`) se še vedno izvede kot običajno: ```bash OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute # Preskoči ga tudi CI=1 ``` Za najhitrejše namestitve izberite **pnpm** (vsebinsko naslovljena shramba + trde povezave — glejte zgoraj). Za izvajalno okolje brez nadzorne plošče in grafičnega vmesnika uporabite profil Docker `base` (zgoraj) ali [vodnik za Termux](docs/guides/TERMUX_GUIDE.md). Vmesnik ukazne vrstice in spletno nadzorno ploščo zagotavlja isti proces na enih vratih, zato trenutno ni ločenega paketa samo za vmesnik ukazne vrstice.

# 🎬 OmniRoute v akciji

## 📹 Video vodniki

_{Posnetek nadzorne plošče z dne 2026-10-18 · Neobdelani katalog: YT 1.352 | TT 334 | IG 290 · Svežina (dni): YT 5 | TT 48 | IG 49}

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

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

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

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

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

**Celotna lestvica (podvojeni kanonični URL-ji odstranjeni, `v > 0`, največji doseg):** | #1 | #2 | #3 | #4 | #5 | | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | | [nick_saraev — Instagram](https://www.instagram.com/reel/Da8ZthUPK98/) — **3,042,474** | [nnapier7 — Instagram](https://www.instagram.com/reel/Dbp7wv_CIO0/) — **1,454,535** | [Amidia AI & Tech — YouTube](https://www.youtube.com/watch?v=NJ0TQ-pyMDY) — **794,974** | [theopenstack — Instagram](https://www.instagram.com/reel/DaSs65mMrHk/) — **692,419** | [migue.baena — TikTok](https://www.tiktok.com/@migue.baena/video/7670919268216622358) — **685,788** | | #6 | #7 | #8 | #9 | #10 | | ------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | | [milesreevesai — TikTok](https://www.tiktok.com/@milesreevesai/video/7667980059189366019) — **620,400** | [nikothetech — TikTok](https://www.tiktok.com/@nikothetech/video/7671890769665477918) — **610,803** | [Vaibhav Sisinty — YouTube](https://www.youtube.com/watch?v=QucgvbO5gsM) — **509,281** | [buildwithai.club — Instagram](https://www.instagram.com/reel/DbIt9AjK7-U/) — **347,652** | [nivedan.ai — Instagram](https://www.instagram.com/reel/DbIrCksJiqq/) — **331,973** | Kanonične metrike na dan 2026-10-18: **1.976 edinstvenih videoposnetkov** · **20.220.289 znanih ogledov** (`v > 0`) · **1.210 kanalov/profilov po omrežjih**. Neobdelana nadzorna plošča vsebuje 1.976 vrstic (YouTube 1.352 = 740 dolgih videoposnetkov + 612 Shorts · TikTok 334 · Instagram 290); po normalizaciji na podlagi kanoničnega URL-ja, ki za vsak videoposnetek ohrani največje število ogledov, ni ostal noben dvojnik. Zbiranje podatkov iz YouTuba je zamrznjeno pri datumu 2026-10-13 (kvota API-ja je bila izčrpana od 14. do 18. 10.), zbiranje podatkov iz TikToka/Instagrama pa pri datumu 2026-09-02 (ni dobroimetja za zbiranje podatkov); 76 videoposnetkov še vedno nima podatka o številu ogledov. > 🎬 **Ste ustvarili videoposnetek o OmniRoute?** Odprite [zahtevek](https://github.com/diegosouzapw/OmniRoute/issues/new) ali [razpravo](https://github.com/diegosouzapw/OmniRoute/discussions) s povezavo — predstavili ga bomo tukaj.

# 📧 Skupnost in pomoč > Vse na enem mestu — spremljajte vzdrževalca, klepetajte s skupnostjo ali odprite zahtevek. | Kanal | Kje / kako | | ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- | | 💼 **LinkedIn** — sledite vzdrževalcu | [linkedin.com/in/diegosouzapw](https://www.linkedin.com/in/diegosouzapw/) | | 🐙 **GitHub** — sledite za izdaje in nasvete | [@diegosouzapw](https://github.com/diegosouzapw) | | 💬 **Discord** | [discord.gg/U47eFqAXCn](https://discord.gg/U47eFqAXCn) | | ✈️ **Telegram** | [t.me/omnirouteOficial](https://t.me/omnirouteOficial) | | 🟢 **WhatsApp — 🌍 globalno** | [pridružite se skupini](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) | | 🟢 **WhatsApp — 🇧🇷 Brazilija** | [pridružite se skupini](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) | | 🌍 **Spletno mesto** | [omniroute.online](https://omniroute.online) | | 🌍 **🌍 Skupnost StHub OmniRoute (brezplačno)** | [portal StHub](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK) | | 📦 **Izvorna koda** | [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute) | | 🐛 **Prijavite napako** | [odprite težavo](https://github.com/diegosouzapw/OmniRoute/issues) — priložite izpis ukaza `npm run system-info` | | 🤝 **Prispevajte** | [CONTRIBUTING.md](CONTRIBUTING.md) · [Model vej in izdaj](docs/ops/BRANCHING_MODEL.md) · izberite `good first issue` | | 💚 **Podprite projekt** | [Načini podpore ↑](#-support-omniroute) · [GitHub Sponsors](https://github.com/sponsors/diegosouzapw) |

---

## 🛠️ Tehnološki sklad

Plast	Tehnologija
Izvajalno okolje	Node.js 22.x / 24.x LTS — `>=22.22.2 <23 \|\| >=24.0.0 <27`
Jezik	TypeScript 6.0 — 100 % TypeScript v `src/` in `open-sse/` (brez `any` v jedru od različice v2.0)
Ogrodje	Next.js 16 + React 19 + Tailwind CSS 4
Podatkovna baza	better-sqlite3 (SQLite, beleženje WAL) + LowDB (podedovani JSON) — 147 domenskih modulov, 209 migracij
Pomnilnik	SQLite FTS5 polnobesedilno iskanje + int8-kvantizirane vektorske vdelave, tipizirano propadanje
Sheme	Zod 4 — preverjanje veljavnosti V/I orodij MCP + pogodbe API
Protokoli	MCP (stdio / HTTP / SSE) + A2A v0.3 (JSON-RPC 2.0 + SSE)
Pretakanje	Server-Sent Events (SSE) + most WebSocket (`/v1/ws`)
Stiskanje	12-motorni cevovod — RTK, Caveman, LLMLingua-2 (MobileBERT ONNX), GCF, OmniGlyph
Avtentikacija in varnost	OAuth 2.0 (PKCE) + JWT + ključi API + avtentikacija MCP z obsegi · AES-256-GCM v mirovanju · DOMPurify
Prikritost	wreq-js — posnemanje TLS prstnih odtisov JA3 / JA4, 3-nivojski proxy
Odpornost	prekinjevalec tokokroga, eksponentni backoff, zaščita pred učinkom thundering herd, samozdravljenje z auto-combo
Beleženje	pino — strukturirani dnevniki JSON s kontekstom zahteve
Testiranje	Node.js test runner + Vitest — 56.000+ statičnih deklaracij testov v 7.800+ spremljanih testnih datotekah (enotski, integracijski, E2E, varnostni, ekosistemski)
Platforme	Namizje (Electron) · Android (Termux) · PWA (kateri koli brskalnik)
CI/CD	GitHub Actions — samodejna objava na npm + Docker Hub ob izdaji
Povezave	Spletno mesto · npm · Docker Hub

## 📖 Dokumentacija

### 📘 Prvi koraki

Dokument	Opis
Uporabniški priročnik	Ponudniki, kombinacije, integracija CLI, namestitev
Priročnik za namestitev	Vse metode namestitve, konfiguracije orodij CLI, nastavitev protokolov, prilagoditev časovnih omejitev
Priročnik za orodja CLI	Nastavitev za posamezna orodja: Claude Code, Codex, Cursor, Cline, OpenClaw, Kilo, Copilot
Oddaljeni način	Upravljajte oddaljeni OmniRoute (VPS) iz ukazne vrstice svojega prenosnika prek omejenih dostopnih žetonov
Konfiguracija Claude Code	Usmerite Claude Code na OmniRoute (lokalno/oddaljeno) z `launch` + profili za posamezne modele
Hiter začetek	Namestitev v 3 korakih → povezava → konfiguracija

### 🔧 Delovanje in nameščanje

Dokument	Opis
Priročnik za Docker	Docker run, profili Compose, Caddy HTTPS, tuneli, oznake slik
Priročnik za Podman	Integracija Quadlet systemd, podman-compose, SELinux
Namestitev na VM	Popoln vodnik: nastavitev VM + nginx + Cloudflare
Namestitev na Fly.io	Namestitev na Fly.io s trajnim shranjevanjem
Priročnik za Termux	Zaganjanje OmniRoute na Androidu prek Termuxa
Priročnik za PWA	Namestitev progresivne spletne aplikacije, predpomnjenje, arhitektura
Priročnik za odstranitev	Temeljita odstranitev za vse metode namestitve
Konfiguracija okolja	Popoln seznam spremenljivk `.env` in sklici

### 🧠 Funkcije in arhitektura

Dokument	Opis
Arhitektura	Sistemska arhitektura, pretok podatkov in notranje komponente
Priročnik za stiskanje	Cevovod s 7 možnostmi: off / lite / standard / aggressive / ultra / RTK / stacked
Stiskanje RTK	Stiskanje izhoda ukazov, filtri, zaupanje, preverjanje, obnovitev surovega izhoda
Mehanizmi stiskanja	Caveman, RTK, zloženi cevovodi, površine nadzorne plošče/API/MCP
Oblika pravil stiskanja	JSON sheme paketov pravil za filtre Caveman in RTK
Jezikovni paketi za stiskanje	Zaznavanje jezika in ustvarjanje paketov pravil Caveman
Priročnik za odpornost	Prekinjevalniki tokokrogov, ohlajitvena obdobja, čakalna vrsta, zaščita pred udarom črede, TLS spoofing
Mehanizem Auto-Combo	Ocenjevanje s 16 faktorji, paketi načinov, samozdravljenje
Priročnik za proxy	3-nivojski proxy sistem, tržnica 1proxy, register CRUD
Brezplačni nivoji	Združen imenik: 34 dokumentiranih ponavljajočih se bazenov / 467 katalogiziranih vnosov brezplačnih nivojev
Galerija funkcij	Vizualni ogled nadzorne plošče s posnetki zaslona
Dokumentacija kode	Spoznavanje kode, prijazno do začetnikov

### 🤖 Protokoli in API-ji

Dokument	Opis
Referenca API	Vse končne točke s primeri
Specifikacija OpenAPI	Specifikacija OpenAPI 3.0
Strežnik MCP	110 orodij MCP, konfiguracije IDE, odjemalci Python/TS/Go
Priročnik za strežnik MCP	Namestitev MCP, transporti in referenca orodij
Strežnik A2A	Protokol JSON-RPC 2.0, veščine, pretakanje, upravljanje opravil
Priročnik za strežnik A2A	Kartica agenta A2A, opravila, veščine in pretakanje

### 📋 Projekt in kakovost

Dokument	Opis
Prispevanje	Nastavitev razvojnega okolja in smernice
Model vejenja in izdaj	Kam ciljajo PR-ji (`release/*`), kaj pomenita `main` in oznake
Dnevnik sprememb	Celotna zgodovina izdaj po različicah
Varnostna politika	Prijavljanje ranljivosti in varnostne prakse
Vodnik za i18n	Podpora za 67 jezikov, potek prevajanja, RTL
Kontrolni seznam izdaje	Koraki preverjanja pred izdajo
Načrt pokritosti	Strategija testne pokritosti za več kot 56.000 statičnih testnih deklaracij v več kot 7.800 sledenih testnih datotekah

# ⭐ Najboljši prispevalci > OmniRoute oblikuje strastna skupnost odprte kode. Ti posamezniki so s svojimi izjemnimi prispevki neposredno vplivali na kakovost, stabilnost in doseg projekta. **Hvala.** ### Zunanji prispevalci po združenih PR-jih

Uvrstitev	Prispevalec	Združeni PR-ji	~Spremenjene vrstice
1	maxmad64bis	371	25.326.561
2	HouMinXi	269	13.456.272
3	backryun	210	270.562
4	oyi77	190	411.243
5	pacocartones	174	78.276
6	JxnLexn	151	3.562.936
6	KooshaPari	151	5.972.314
8	rdself	145	80.663
9	RaviTharuma	123	500.065
10	herjarsa	88	230.872
11	hartmark	84	2.849.554
12	jonlwheat2-gif	67	68.548
13	artickc	62	43.502
14	chirag127	52	6.661
15	xz-dev	50	245.976
16	xiaoyaner0201	47	33.626
17	woodsonl	46	809.391
18	rqzbeh	44	147.896
19	QuangBlue	43	13.112
20	MumuTW	40	26.093

_{Popis opravljen 2026-10-18 15:09:09 UTC na takratni živi konici release/v3.8.52 656f01cb43. Oštevilčeni popis GitHub GraphQL vsebuje 9.191 združenih PR-jev: 3.834 od lastnika repozitorija, 229 od Dependabota, 6 od drugih botov/aplikacij in 5.122 zunanjih PR-jev 835 različnih prispevalcev. »Spremenjene vrstice« so seštevek GitHubovih dodajanj in izbrisov ter vključujejo generirane datoteke, zaklepne datoteke, kataloge, prevode in dokumentacijo; gre za obseg sprememb, ne za avtorsko napisane vrstice kode (LOC). Pri 49 PR-jih GitHubove razlike presegajo 500.000 vrstic (na primer #13399, dodajanje enega samega ponudnika, navaja 2.347 spremenjenih datotek), kar napihuje več zgornjih skupnih vsot. Izenačeni si delijo isto uvrstitev.} ### GitHubu pripisani commiti

Dizzle _{🥇 367 GitHubu pripisanih commitov}	Bob.Hou _{🥈 269 GitHubu pripisanih commitov}	Paijo _{🥉 229 GitHubu pripisanih commitov}	backryun _{🏅 202 GitHubu pripisanih commitov}	Paco Cartones _{🏅 174 GitHubu pripisanih commitov}	Ravi Tharuma _{🏅 126 GitHubu pripisanih commitov}
Markus Hartung _{🏅 114 GitHubu pripisanih commitov}	Randi _{🏅 108 GitHubu pripisanih commitov}	Jan Leon _{🏅 87 GitHubu pripisanih commitov}	Chris _{🏅 70 GitHubu pripisanih commitov}	Koosha Paridehpour _{🏅 68 GitHubu pripisanih commitov}

_{Ponovno preverjeno 2026-10-18 14:44:45 UTC: GitHubu pripisani commiti, ki jih za privzeto vejo release/v3.8.52 poroča API za prispevajoče (Contributors API) repozitorija. API je vrnil 849 identitet (429 uporabnikov, 2 bota, 418 anonimnih); ta tabela izključuje vzdrževalca, bote in anonimne identitete ter ohranja izenačena mesta. Razlikuje se tako od zgornje lestvice združenih PR-jev kot od spodnjega popisa Git-metapodatkov.} > 🙏 Funkcije, popravki napak in izboljšave infrastrukture teh prispevajočih so **bistveni del** tega, kar dela OmniRoute zanesljiv in bogat z možnostmi. Vsak pull request, vsak testni primer in vsaka datoteka prevodov i18n šteje. Odprto kodo gradijo ljudje, kot so oni.

---
## 💖 Sponzorji

Iskrena hvala ljudem, ki OmniRoute financirajo iz lastnega žepa — vsak prispevek pomaga, da projekt ostaja brezplačen, neodvisen in se še naprej razvija.

Andrew _{💛 Aktivni mesečni sponzor}	Vlad I _{💛 Aktivni mesečni sponzor}	小妍儿 _{💛 Aktivni mesečni sponzor}	Guilherme Costa _{💛 Aktivni enkratni sponzor}	Henrique Iurkiv _{💛 Aktivni enkratni sponzor}	Somesh Ghaturle _{💛 Aktivni enkratni sponzor}
Kolonie AI _{💛 Nekdanji enkratni podpornik}	Prof. Igor Morais _{💛 Nekdanji enkratni podpornik}	Pixma _{💛 Nekdanji enkratni podpornik}	Paco Cartones _{💛 Nekdanji enkratni podpornik}	longtao _{💛 Nekdanji enkratni podpornik}

_{… in drugi, ki želijo ostati zasebni 💛} _{Javni sponzorji GitHub Sponsors so bili ponovno preverjeni 2026-10-18 prek vmesnika GitHub Sponsors GraphQL API: 11 javnih sponzorstev (6 aktivnih, 5 nekdanjih) od skupno 14. Stanje isActive v storitvi GitHub določa zgornje oznake aktivnosti; nekdanjim javnim enkratnim podpornikom se še vedno zahvaljujemo, zasebni sponzorji pa ostajajo anonimni. Donacije prek Ko-fi, Buy Me a Coffee, Liberapay, PIX in kriptovalut niso navedene, ker zanje ni javnega zapisa o sponzorju.} 💖 Postanite sponzor → — vsak dolar pomaga, da OmniRoute ostaja brezplačen in neodvisen.

## 👥 Več kot 900 sodelujočih

[![Sodelujoči](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=993&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors) _{Revizija je bila opravljena 2026-10-18 na aktualni konici veje release/v3.8.52, pri potrditvi ad160ab2d1 (6.826 potrditev): 993 normaliziranih človeških identitet Git — 707 jih je navedenih kot avtorjev potrditev (vključno z vzdrževalcem), 286 pa samo v izrecnih priklopnikih Co-authored-by. Popis uporablja .mailmap, e-poštne naslove primerja brez razlikovanja med velikimi in malimi črkami, številske in običajne GitHubove naslove noreply združi samo, kadar vsebujejo isti uporabniški vzdevek, izključuje 26 identitet botov/agentov/storitev/oznak mesta ter običajnih e-poštnih naslovov ne združuje zgolj zato, ker se njihova prikazna imena ujemajo. Revizija z dne 2026-08-24 je objavila število 639; ponovna izvedba te metode na osnovi navedene revizije ac02c5b42f da rezultat 619, zato povečanje izhaja iz novih sodelujočih in ne iz manj stroge metode.} ### Kako prispevati 1. Razvejite repozitorij 2. Ustvarite vejo iz **aktivne** konice `release/vX.Y.Z` (ne iz `main`) — glejte [Model vej in izdaj](docs/ops/BRANCHING_MODEL.md) 3. Ustvarite svojo funkcijsko vejo (`git checkout -b feat/amazing-feature`) 4. Potrdite svoje spremembe (`git commit -m 'feat: add amazing feature'`) 5. Potisnite spremembe v vejo (`git push origin feat/amazing-feature`) 6. Odprite zahtevo za spojitev z nastavitvijo **base = ta veja `release/vX.Y.Z`** Za podrobna navodila glejte [CONTRIBUTING.md](CONTRIBUTING.md). ### Izdaja nove različice ```bash # Ustvarite izdajo — objava v npm se izvede samodejno VERSION=x.y.z gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes ```

## 📊 Zvezdice

## 🌍 StarMapper

## 🙏 Zahvale

OmniRoute stoji na ramenih velikanov. Začel se je kot razcep projekta **[9router](https://github.com/decolua/9router)** in prenos projekta **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** iz jezika Go v TypeScript — od tam naprej pa je vsak spodaj navedeni podsistem navdihnil odprtokodni projekt, ki je to dosegel prvi. Vsak od njih je oblikoval konkreten del OmniRoute. S tem se zahvaljujemo vsem. 🙏 > ⭐ število zvezdic je bilo preverjeno prek GitHubovega API-ja REST 18. oktobra 2026 — podarite tem projektom zvezdico. Števila so natančen posnetek na navedeni datum in se bodo sčasoma seveda spremenila. ### 🧬 Izvor in prehod

Projekt	⭐	Kako je navdihnil OmniRoute
9router	31,004	Izvirni projekt, na katerem temelji ta razcep — tukaj razširjen z večmodalnimi API-ji in popolnim prepisom v TypeScriptu.
CLIProxyAPI	55,591	Implementacija v jeziku Go, ki je navdihnila ta prenos v JavaScript / TypeScript.
LiteLLM	61,482	Prehod za umetno inteligenco, katerega javni nabor podatkov o cenah napaja našo sinhronizacijo sledenja stroškom in katerega model normalizacije ponudnikov je sooblikoval naše usmerjanje.
codex-chatgpt-web	14,526	Izvorna koda z licenco MIT, prilagojena za vključeni most ChatGPT Web → Codex Responses, vključno z vmesniki za sejo brskalnika, oblikovanje odgovorov, beleženje uporabe in spletno iskanje.
free-claude-code	61,430	Vzorci, preneseni v obnovitev pretakanja, vzdevke brez razmišljanja, nadomestno spletno iskanje, omejitve drsečega okna, redigiranje dnevnikov in utrjene postopke zaganjalnika.
composer-api	346	Vzorci za izbiro orodij, omejitve izhodnih podatkov in potrditev orodij v Cursor Composerju, prilagojeni za izvorni izvajalnik Cursor.
codex-multi-auth	553	Vzorci za novo prijavo in rotacijo žetonov za osvežitev, preneseni v ponovno preverjanje pristnosti Codex OAuth.
opencode-anthropic-auth	558	Privzete pretvorbe, združljive s Claude Code, in vedenje glav za obračunavanje, posplošeni v OmniRoutov most, ki ga krmili konfiguracija.
grok2api-merged	2	Njegove preslikave modelov Grok, generator Statsig z lažnim TypeError, privzete nastavitve zahtev in naprav ter obdelovalnik odgovorov NDJSON so bili v znatni meri prilagojeni za OmniRoutov izvajalnik Grok Web.
TQZHR/grok2api	706	Glavni posredni vir kode za grok2api-merged; njegove implementacije modelov, glav, koristne vsebine, Statsig in obdelovalnikov so ohranjene v izvorni liniji Grok Web.
chenyme/grok2api	7,819	Temeljni vir z licenco MIT za koristno vsebino Grok in privzete nastavitve naprav, generator Statsig ter obdelovalnik `result.response`, prenesen prek TQZHR in grok2api-merged.
grok2api-pro	27	Posredni vir, ki ga grok2api-merged navaja za svojo plast skupine posredniških strežnikov; OmniRoute ohranja to navedbo izvora, vendar ne trdi, da je v njegov omejeni izvajalnik Grok Web prenesena skupina posredniških strežnikov.
GrokProxy	51	Njegov posredniški strežnik Grok s preverjanjem pristnosti s piškotki in vzorec pretakanja `result.response.token` sta sooblikovala OmniRoutov prenos Grok Web.
GrokBridge	5	Izvirna implementacija Grok Web se je zgledovala po njegovi zasnovi zaledja HTTP/brskalnika; njena neposredna pot HTTP izhaja iz GrokProxy, zato se ne uveljavlja neodvisen prenos kode.

### 🗜️ Stiskanje konteksta in žetonov — pogoni

Projekt	⭐	Kako je navdihnil OmniRoute
Caveman	113,396	Viralni projekt »zakaj uporabiti veliko žetonov, ko malo žetonov opravi nalogo« — njegova filozofija jamskega govora poganja naš standardni način stiskanja ter več kot 30 pravil za odstranjevanje mašil in zgoščevanje.
RTK – Rust Token Killer	83,835	Visokozmogljivo stiskanje izpisa ukazov — navdihnilo je naš mehanizem RTK, DSL za filtriranje JSON, obnovitev neobdelanega izpisa in zaporedni cevovod RTK → Caveman.
headroom	75,741	Reverzibilno stiskanje konteksta (SmartCrusher) — navdihnilo je naš mehanizem `headroom` in vzorec označevalnika za pridobivanje `ccr`.
LLMLingua	6,757	Raziskave stiskanja pozivov (LLMLingua / LLMLingua-2) — navdihnile so naš asinhroni, za kodo varen mehanizem `llmlingua`, ki ob napaki nadaljuje brez stiskanja.
llmlingua-2-js	32	Različica za JS/ONNX (MobileBERT / XLM-RoBERTa), ki se uporablja kot zaledje z delovnimi nitmi za naš mehanizem LLMLingua.
Troglodita	50	Stiskanje žetonov za brazilsko portugalščino — poganja naš jezikovni paket pt-BR: zmanjševanje pleonazmov in odstranjevanje mašil, prilagojeno slovnici brazilske portugalščine.
ponytail	166,731	Viralna spretnost kodiranja »lenega izkušenega razvijalca« po načelu YAGNI — navdihnila je naš izhodni slog less-code: usmerjanje k najmanjši delujoči spremembi, ki zmanjša _ustvarjeno_ kodo (ustreznik jedrnati prozi projekta Caveman na osi izhoda).
i-have-adhd	57,628	Njegov način odgovarjanja, ki daje prednost dejanjem in je prijazen osebam z ADHD, je bil prilagojen v jedrnat izhodni slog OmniRoute v petih jezikih.

### 🧩 Kompaktni formati, raziskave žetonov in orodja, ki upoštevajo kodo

Projekt	⭐	Kako je navdihnil OmniRoute
TOON	25,509	Objektni zapis, usmerjen v žetone — njegov stolpčni model z glavo in vrsticami je oblikoval našo fazo tabelaričnega zgoščevanja.
GCF – Graph Compact Format	59	Njegova kompaktna oblika grafa in zasnova splošnega profila sta vplivali na tabelarično zgoščevanje OmniRoute ter obliko kodeka Headroom.
gcf-typescript	4	Implementacija MIT za TypeScript, neposredno vključena in razširjena kot kodek splošnega profila Headroom.
token-optimizer-mcp	551	Predpomnilnik Brotli/SQLite in razlika konteksta za posamezno sejo — navdihnila sta naš mehanizem `session-dedup`.
token-savior	1,182	Zgoščevanje izpisa Bash in profili MCP — navdihnili so naš discipliniran odstop od stiskanja ter zmanjševanje manifestov orodij MCP.
token-saver	154	Stiskanje izpisa glede na vsebino in vrsto datoteke z odstopom ob napakah — potrdilo je naše usmerjanje glede na vrsto in preskok ob premajhnem prihranku.
token-optimizer	2,595	»Poiščite fantomske žetone« — njegov vzorec razbremenjevanja z obnovljivimi ročicami je vplival na naš pristop k razbremenjevanju CCR.
TokenMizer	33	Načrt grafa seje in odstranjevanja podvojenih vrstic med izmenjavami, ki je vplival na zasnovo našega mehanizma za odstranjevanje dvojnikov med sejami.
OmniCompress	3	Stolpčni JSON v jeziku Rust, vsebinsko naslovljeno pridobivanje in odstranjevanje dvojnikov med sporočili — potrdili so zasnovo naših mehanizmov `headroom`/`ccr`/`session-dedup` ter invarianto za stabilnost predpomnilnika »stisnjena oblika je neodvisna od položaja«.
mcp-compressor	133	Stiskanje shem in opisov orodij MCP — vplivalo je na naše zmanjševanje kardinalnosti manifestov orodij MCP.
RepoMapper	217	Razvrščanje zemljevidov repozitorijev v slogu Aider — vplivalo je na naše raziskovanje zemljevidov repozitorijev in razvrščanja pri pridobivanju.
quiet-shell-mcp	4	Deklarativno zmanjševanje lupinskega izpisa prek MCP — potrdilo je naše deklarativno zgoščevanje izpisa Bash.
ts-morph	6,205	Zbirka orodij za TypeScript Compiler API — navdihnila je naše odstranjevanje komentarjev na podlagi razčlenjevalnika, ki ohrani literale nizov, predlog in regularnih izrazov.

### 🧠 Pomnilnik in RAG

Projekt	⭐	Kako je navdihnil OmniRoute
Mem0	67,385	Univerzalna pomnilniška plast — njen model posredniškega strežnika kot meje za pisanje/branje je oblikoval našo pomnilniško arhitekturo.
Letta (MemGPT)	25,179	Agenti s stanjem in večnivojskim pomnilnikom — navdih za naš večnivojski model nadzora in obnovitve konteksta (CCR).
WFGY	1,800	Taksonomija ProblemMap s 16 ponavljajočimi se načini odpovedi RAG/LLM — skupno izrazje v našem vodniku za odpravljanje težav.

### 🛰️ Pregled prometa, MITM in transparentni posredniški strežnik

Projekt	⭐	Kako je navdihnil OmniRoute
llm-interceptor	79	Prestrezanje/analiza prometa med pomočnikom za programiranje ↔ LLM z uporabo MITM je vplivala na zgodnje zahteve za pregledovalnik prometa. Štiri predhodno izpeljane module — združevanje SSE, normalizacijo pogovorov, maskiranje skrivnosti in čiščenje glav — so nadomestile neodvisne implementacije iz čiste sobe, ki temeljijo na javnih protokolarnih standardih. Dve površini za neposreden prehod gostitelja (`passthrough.ts` in `_internal/bypass.cjs`) ostajata interni implementaciji OmniRoute, razvrščeni neodvisno; v okviru te zamenjave nista bili na novo napisani.
ProxyBridge	6,814	Transparentno usmerjanje prek posredniškega strežnika za vsak proces posebej — navdih za našo zaustavitev MITM, varno ob zrušitvah, časovne omejitve nedejavnosti vtičnic, pripisovanje procesov prek `/proc` in zajem TPROXY.

### 📚 Podatki o modelih, opazljivost in uporabniški vmesnik

Projekt	⭐	Kako je navdihnil OmniRoute
models.dev	7,286	Odprta zbirka podatkov s specifikacijami, cenami in zmogljivostmi modelov umetne inteligence — izvorno sinhronizirana z našim katalogom modelov.
React Flow / xyflow	38,705	Knjižnica grafov na osnovi vozlišč, ki poganja naš Compression Studio in Combo/Routing Studio v realnem času.
LangGraph	43,443	Vizualizacija grafa poteka dela v živo v LangGraph Studio je navdihnila prikaz kaskade v realnem času v naših studiih.
Langfuse	35,990	Njegov model opazljivosti sled → razpon → generiranje je oblikoval naš slapovni prikaz v Compression Studio.
Kiali	3,645	Opazljivost storitvenega omrežja Istio — navdih za naše značke prekinjevalnikov tokokroga in vizualne prikaze povezav z napakami v Routing/Combo Studio.
lobe-icons	2,615	Logotipi blagovnih znamk AI/LLM, ki prikazujejo ikone ponudnikov na naši nadzorni plošči.
flag-icons	12,473	Zagotavlja zastave SVG z licenco MIT, ki jih uporablja izbirnik jezika v README.

### 🛡️ Varnost

Projekt	⭐	Kako je navdihnil OmniRoute
awesome-secure-defaults	722	Kuriran seznam knjižnic, ki so privzeto varne in usmerjajo naše varnostne odločitve (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).

### 🧭 Dopolnilna orodja

Projekt	⭐	Kako je navdihnil OmniRoute
ClawRouter	6,628	Navdih za odpravljanje podvojenih zahtev, rezervno možnost brez stroškov za nujne primere, priklopljive strategije Auto-Combo in večjezično razvrščanje namenov.
Antigravity-Manager	32,333	Njegovo preslikovanje modelov glede na račun, preverjanje poti do izvedljive datoteke in vedenje oznak paketov so vplivali na izvajalno okolje Antigravity v OmniRoute.
vscode-antigravity-cockpit	4,850	Njegova kompaktna oblika odštevanja do ponastavitve kvote je navdihnila ustrezen prikaz omejitev ponudnika v OmniRoute.
AionUi	33,611	Njegove integracije ACP so navdihnile samodejno zaznavanje nameščenih agentov CLI v OmniRoute.
CodexBar	22,616	Prepoznal je vmesnik kvote Grok Build; OmniRoute je nato neodvisno preveril in popravil dejanski format podatkov na povezavi.

## 📄 Licenca Licenca MIT – podrobnosti si oglejte v datoteki [LICENSE](LICENSE). ---

**[⬆ Nazaj na vrh](#-omniroute)** · Zgrajeno z ❤️ za odprtokodno skupnost umetne inteligence. _{OmniRoute v3.8.53 · Node ≥22.22.2 · Licenca MIT · omniroute.online}