# 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 kodirati. Vsako orodje AI → 358 ponudnikov — 150+ brezplačnih — prek ene končne točke. Claude Code, Codex, Cursor, Cline, Copilot & Antigravity v BREZPLAČNI Claude / GPT / Gemini s samodejnim preklopom. RTK + Caveman zložena kompresija prihrani 15–95% žetonov (~89% povprečno) — nikoli ne dosežete omejitev. 358 ponudnikov AI · 150+ brezplačnih nivojev · ~1.62B brezplačnih žetonov/mesec · 19 strategij usmerjanja · $0 za začetek.

## 💰 ~1,62 mrd. brezplačnih žetonov / mesec

> Ročno združevanje brezplačnih paketov je naporno — na desetine SDK-jev, na desetine omejitev hitrosti in nobene predstave o tem, koliko dejansko imate. OmniRoute katalogizira **489 vnosov brezplačnih paketov v 35 ključih ponavljajočih se skupin** in izračuna skupno število žetonov na podlagi **17 skupin z objavljenim pozitivnim mesečnim proračunom ter petih omejitev Groq za posamezne modele**, pri čemer odstrani podvojitve skupnih skupin. Kvote, ki se odprejo šele po regionalnem preverjanju identitete (trenutno: ModelScope), so prikazane ločeno, +~6 mio. za regionalnim preverjanjem identitete, in niso nikoli vključene v skupni prikaz. Rezultat ostaja viden na nadzorni plošči (`/dashboard/free-tiers`).

Kartica proračuna brezplačnega paketa OmniRoute: stalno ~1,62 mrd. brezplačnih žetonov na mesec, do ~2,22 mrd. v prvem mesecu z dobroimetjem ob registraciji, iz 35 dokumentiranih ključev ponavljajočih se skupin, ki pokrivajo 489 katalogiziranih vnosov brezplačnih paketov za eno končno točko. Pošten izračun z odstranjevanjem podvojitev skupin — vsaka skupna skupina je upoštevana enkrat, vključno s 17 ponavljajočimi se skupinami z objavljenim pozitivnim mesečnim proračunom žetonov ter petimi omejitvami Groq za posamezne modele; 13 ponudnikov je v katalogu tveganj glede pogojev označenih za izogibanje, odločitev pa je vaša. Vrstica proračuna vključuje Mistral 1 mrd., Nara 210 mio., LLM7 150 mio., xKiro 150 mio., Groq 30 mio. (pet omejitev za posamezne modele) in manjše skupine, poleg tega pa so dobroimetja ob registraciji za prvi mesec in trajno brezplačni ponudniki brez omejitve žetonov prikazani ločeno, zato nikoli ne napihujejo skupnega prikaza. Trenutna poraba/preostanek na /dashboard/free-tiers.

> Animirani povzetek strani `/dashboard/free-tiers` v živo. Celotna metodologija (odstranjevanje podvojitev skupin, ravni dobroimetja, pogoji ponudnikov): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**. > > _{Te številke vsaka dva tedna znova preverimo glede na katalog v živo in se **spreminjajo v obe smeri** — ko ponudnik ukine brezplačni paket, številka pade; ko se pojavi nov, se poveča. Objavljamo tisto, kar katalog dejansko izračuna, nikoli navzgor zaokroženega najboljšega možnega scenarija.}

⭐ Dodajte zvezdico repozitoriju, če vam je OMNIROUTE pomagal prihraniti denar in olajšal delo.

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

[![Uvrstitev zgodovine zvezdic](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 — prvi izvedite za 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, načrt razvoja 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)**
## 📈 Prehod še naprej raste

| | v3.8.49 | **v3.8.50** | `v3.8.51+` | | --------------------------------- | :-----: | :---------------------------: | :---------: | | 🌐 Ponudniki | 290 | **357** | več v vrsti | | 🧠 Enolični ID-ji modelov klepeta | 1185 | **1312** | — | | 🖼️ Most med modalnostmi | — | 🆕 vid + zvok + videoposnetki | — | | 📡 Brezplačni katalog Radar | — | 🆕 prostovoljna vključitev | — | | ⚖️ Razporejanje glede na kvote | — | 🆕 Quota-Share | — | | 📊 Telemetrija kvot | — | 🆕 v živo | — | **→ [Načrt razvoja](ROADMAP.md) — po tirnicah 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	🆓 Brez konfiguracije
💡 Spoznajte	💥 Obljuba	🤔 Zakaj OmniRoute	🏆 Kaj ga odlikuje
⚙️ Funkcije	🎯 Kombinacije	🌐 Ponudniki	🔌 CLI in MCP
	🗜️ Stiskanje	🖥️ Kje deluje	🔒 Zasebnost
👀 Oglejte si	🎬 V delovanju	✨ Novosti	🤖 Združljivi vmesniki CLI
💚 Podpora	💚 Podpora / Donacije	💬 Skupnost	💖 Sponzorji
📦 Projekt	🛠️ Tehnološki sklad	📖 Dokumentacija	👥 Sodelujoči

🌐 V 66 jezikih

## 🆓 Deluje takoj po namestitvi — brez ključev, brez konfiguracije

Deluje takoj po namestitvi — brez konfiguracije. Trije koraki: 1. Namestitev — npm i -g omniroute, strežnik se zažene na localhost:20128. 2. Usmerite svoje orodje na http://localhost:20128/v1 — katero koli orodje, združljivo z OpenAI (Claude Code, Cursor, Cline). 3. Odgovori — pokličite model auto za takojšen odgovor, brez API ključa, brez prijave, brez konfiguracije. Brezključen ponudnik OpenCode Free je vnaprej povezan v kombinacijo auto, tako da sveža namestitev odgovori takoj.

```bash # Sveža namestitev, brez poverilnic — `auto` že deluje: curl http://localhost:20128/v1/chat/completions \ -H "Content-Type: application/json" \ -d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}' ``` _{Raje imate specifično brezplačno zaledje? Pokličite `oc/…` (OpenCode Free) neposredno. Nato preidite na `auto` in pustite, da OmniRoute izbere.} _{📦 Kopiraj-prilepi hitre zagonske skripte za **Python, Node.js, PHP in cURL** → [`examples/quickstart/`](examples/quickstart/)}

# 💥 Obljuba

# 🤔 Zakaj OmniRoute?

Potek 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 (RTK + Caveman kompresija, 19 strategij usmerjanja, odklopniki, prikriti TLS, MCP, A2A, varovala) se lahko preklopi med 4 nivoji ponudnikov, dokler je na voljo ustrezna zdrava tarča — Nivo 1 Naročnina, Nivo 2 API ključ, Nivo 3 Poceni in Nivo 4 Brezplačno.

## 🤝 Podpirajo nas naši prijatelji odprte kode

> **Želite se pridružiti kot prijatelj odprte kode?** To so podjetja, ki podpirajo odprto kodo in pomagajo ohranjati OmniRoute v gibanju — in javno povemo, kam gre vsak žeton, ki nam ga dajo. Pišite nam: [diegosouza.pw@outlook.com](mailto:diegosouza.pw@outlook.com)

Kimi
_{Moonshot AI} Hvala Kimi (Moonshot AI), našemu ustanovnemu prijatelju odprte kode, za podporo temu projektu! Kimi je laboratorij za umetno inteligenco, ki stoji za družinami modelov K2 in K3 z odprto težo — Kimi K3 ponuja 1M-token kontekstno okno, izvorno vizijo in kodiranje na mejni ravni po delčku cen zaprtih modelov ter deluje takoj po namestitvi s Claude Code, Codex in vsemi orodji za kodiranje, ki jih OmniRoute podpira.

Kaj omogoča Kimijeva podpora: Kimijevi API krediti poganjajo OmniRouteov AI-potrjen postopek izdaje — faza *potrditve združitve, ki jo poganja Kimi K3*, ki pregleda vsak zahtevek za združitev, preden se objavi — ter vsakodnevni razvoj funkcij. Prvovrstna Kimijeva podpora je na voljo na obeh tirih: neposredni Kimi API (kimi-k3) in Kimi Code načrt kodiranja (OAuth in API ključ). OmniRoute je tudi prvi brazilski projekt odprte kode v Kimijevem podpornem programu. Pridobite Kimi API ključ s 15 % dodatnimi krediti →

Cheaper Inference
_{cheaperinference.com} Hvala Cheaper Inference, prijatelju odprte kode OmniRoute, za podporo temu projektu! Cheaper Inference je cenovno razvrščen prehod, ki preprodaja 42 mejnih modelov — Claude, GPT-5.x, Gemini, Kimi K3, GLM, DeepSeek, Grok in MiniMax — za eno končno točko, združljivo z OpenAI, in vsako zahtevo usmerja k najcenejšemu upravičenemu ponudniku, ne da bi kdaj zaračunal več od cenika izdelovalca modela.

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

_{Povezave z oznako aff=omniroute so partnerske povezave. Financirajo projekt brez dodatnih stroškov za vas.}

_{🎟️ Promocija partnerjev — brezplačni kuponi za prijavo od ponudnikov, ki jih ne sponzoriramo (kliknite za razširitev)}

_{Ta razdelek je samo za referenčne/kuponske kode. Sponzorirana partnerstva so navedena zgoraj v razdelku **🤝 Podpirajo nas naši prijatelji odprte kode**. OmniRoute nima sponzorstva ali partnerstva s ponudniki, navedenimi tukaj — to so javni kuponi, ki jih lahko uporabi vsak.}

_AgentRouter
_{agentrouter.org} _{AgentRouter — partnerska prijava · 100 $ brezplačnih kreditov ob prijavi (brezplačen strežnik, pričakujte višjo latenco — najboljše za testiranje, ne za produkcijo). Prvovrstna podpora v OmniRoute od v3.8.50: Chat Completions, žični 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 več. Zgrabite svojih 100 $ →}

_{⚠️ Partnerska povezava — OmniRoute nima sponzorstva ali partnerstva s tem ponudnikom.}

_{Poznate drugega ponudnika z izdatnim brezplačnim kuponom za prijavo, ki koristi uporabnikom OmniRoute? Odprite težavo in dodali ga bomo sem.}

## 🎯 Kombinacije — paradni konj

Animiranih je vseh 19 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, cache-optimized, lkgp, auto, fusion, pipeline. Kaj počne posamezna strategija, si oglejte v zgornji tabeli.

> **Kombinacija** je veriga modelov, med katerimi OmniRoute usmerja **samodejno**. Če zmanjka kvote, ponudnik odpove ali stroški skokovito narastejo, lahko kombinacija preklopi na naslednji ustrezni zdrav model. 🛡️ ### ⚡ Brez konfiguracije — preprosto uporabite `auto` Kombinacije ni treba ustvariti. Nastavite model na `auto` (ali eno od 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 uspešnem ponudniku)
`auto/coding`	🧑💻 Uteži, osredotočene na kakovost ustvarjanja kode
`auto/fast`	⚡ Najprej najnižja zakasnitev
`auto/cheap`	💰 Najprej najnižja cena na žeton
`auto/offline`	🔋 Najprej največ preostale kvote oziroma rezerve omejitve hitrosti
`auto/smart`	🔭 Kakovost na prvem mestu + 10-% raziskovanje za odkrivanje boljših modelov
`auto/lkgp`	📌 Izrecno vztrajanje pri zadnjem znanem uspešnem ponudniku
`auto/chaos`	🧪 Uteži za vbrizgavanje napak pri preizkušanju odpornosti (inženirstvo kaosa)

## ### 🔀 Ali pa ustvarite svojo — 19 strategij usmerjanja Vseh **19** strategij — poljubno jih kombinirajte v posameznih korakih kombinacije:

#	Strategija	Kaj počne
1	`priority`	Urejen seznam s prvim ciljem — vsakega izčrpa, preden preide na naslednjega 🥇
2	`fill-first`	V celoti zapolni 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 po načelu izbire med dvema možnostma
6	`least-used`	Izbere cilj z najmanjšo trenutno obremenitvijo
7	`random`	Enakomerna naključna izbira (brez dvojnikov)
8	`strict-random`	Naključno brez odstranjevanja ponovitev 🎲
9	`cost-optimized`	Zmanjša strošek v $ na zahtevo glede na trenutne cene v katalogu 💸
10	`headroom`	Izbere cilj z največ preostale kvote
11	`reset-window`	Prednost da cilju, katerega obdobje kvote se bo najprej ponastavilo
12	`reset-aware`	Razvrsti glede na čas ponastavitve kvote — najprej kratka obdobja 📊
13	`context-relay`	Za dolge pogovore predaja kontekst med cilji 🧠
14	`context-optimized`	Izbere cilj, ki najbolje ustreza trenutni velikosti konteksta
15	`cache-optimized`	Vsako ponovno uporabljivo predpono poziva pripne istemu računu — za čim več zadetkov v predpomnilniku pozivov 🎯
16	`lkgp`	Zadnja znana uspešna pot — pripne se na zadnjega uspešnega ponudnika, nato pa uporabi nadomestna pravila
17	`auto`	Sprotno ocenjevanje vsake povezave na podlagi 16 dejavnikov 🤖
18	`fusion`	Zahtevo razpošlje skupini modelov, ocenjevalni model pa njihove odgovore združi v enega 🧬
19	`pipeline`	Veriži korake — izhod vsakega cilja postane vhod naslednjega 🔗

_{Mehanizem Auto-Combo vsakega kandidata ocenjuje na podlagi **16 dejavnikov** (zdravje, 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 plasti samodejnega okrevanja, pri čemer se za posamezno napako uporabi ustrezna plast. Plast 1, varovalka ponudnika (celoten ponudnik): sproži se samo ob 408/5xx, pragovi so OAuth 8× / ključ API 12× / lokalno 2×, po 60s/30s/15s se ponastavi v stanje HALF-OPEN za preizkus, okrevanje ob naslednji uporabi; ko je stanje OPEN, kombinacija preusmeri promet k naslednjemu ponudniku. Plast 2, premor povezave (en ključ/račun): osnovno 5s za OAuth / 3s za ključ API, eksponentno podaljševanje ×2 z zaščito pred hkratnim navalom zahtev, pri 429 upošteva Retry-After, uspeh izbriše celotno stanje napake; ključ v premoru se preskoči, sorodni ključi pa še naprej obdelujejo zahteve. Plast 3, zaklep modela (en model): omejitev 429 za posamezni model, lokalni 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 premori.

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

## 🏆 Kaj ločuje OmniRoute

_{📊 Celotna metodologija & podrobnosti o posameznih funkcijah v primerjavi z 9router, OpenRouter, CLIProxyAPI & LiteLLM → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)}
## 💚 Podprite OmniRoute OmniRoute je licenciran z licenco MIT in se vzdržuje odprto. Če vam prihrani čas ali denar, ga lahko pomagate ohraniti neodvisnega na katerega koli od spodnjih načinov. Sponzorstvo nikoli ne vpliva na prednost pri usmerjanju; omogoča prepoznavnost, ne višje uvrstitve.

⭐ Dodajte repozitorij med priljubljene	Brezplačno — resnično pomaga pri prepoznavnosti	Dodajte OmniRoute med priljubljene
🐙 GitHub Sponsors	Enkratno ali mesečno · brez provizije platforme	github.com/sponsors/diegosouzapw
☕ Ko-fi	Hitra enkratna donacija, 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, brez provizij	ključ & koda QR spodaj
₿ Kriptovalute	BTC · ETH · USDT-TRC20 · USDC-Solana	naslovi spodaj

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

Ključ (naključen): `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`

_{⚠️ Vsako valuto 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 postopkom 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 objavo — če jo pomotoma vključite, zamenjajte vse razkrite skrivnosti in odstranite datoteko iz zgodovine. Navodila za upravljanje lokalnih datotek okolja in skrivnosti so na voljo v docs/DEVELOPER-ENVIRONMENT.md.

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

## ✨ Kaj je novega

> Nedavni poudarki iz različic **v3.8.20 → v3.8.50**. Celotna zgodovina je v datoteki [`CHANGELOG.md`](CHANGELOG.md). - **🎛️ OmniConductor** — vhodno delegiranje A2A vaši floti agentov, veščine Conductor na kartici Agent Card in nadzorna plošča z glasovnim klepetom Faro s funkcijo »pritisni za govor«. → [Strežnik A2A](docs/frameworks/A2A-SERVER.md) - **🛂 Prilagodljivo sprejemanje in zaščita pred preobremenitvijo** — zahtevne zahteve za klepet se namesto vračanja napake 503 postavijo v čakalno vrsto, z atomskimi drsečimi rezervacijami RPM za posamezno povezavo. → [Vodnik za odpornost](docs/architecture/RESILIENCE_GUIDE.md) - **🗂️ Kanonično razvrščanje `/v1/models`** — en neprekinjen blok na ponudnika, združen po ponudnikih (kombinacije so pripete na začetek), ki je stabilen v vseh virih kataloga. → [Referenca API-ja](docs/reference/API_REFERENCE.md) - **🗜️ Okrepljeno stiskanje** — privzeto omogočena zaščita pred čezmernim razširjanjem, paketi Caveman za DE / FR / JA + kitajščino (wényán) ter filtri RTK za Gradle in .NET. → [Stiskanje](docs/compression/COMPRESSION_ENGINES.md) - **💸 Pošten prikaz pavšalnih stroškov** — ponudniki z naročnino oziroma paketom za programiranje v analitiki stroškov prikazujejo **$0**; ocenjevanje proračuna, kvot in usmerjanja se nadaljuje. → [Referenca API-ja](docs/reference/API_REFERENCE.md) - **⚖️ Usmerjanje Quota-Share** — pravično razdeli kvoto skupnega računa med združene ključe in neizkoriščene dele posodi drugim. → [Vodnik za odpornost](docs/architecture/RESILIENCE_GUIDE.md) - **🤖 Nastavitev CLI-ja/agenta z enim ukazom** — 13 registriranih ukazov `setup-*`; `omniroute run` zažene 7 CLI-jev (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); `omniroute configure` podpira 10 ciljev z interaktivnim izbirnikom ponudnika in modela ter priljubljenimi možnostmi za posamezni kontekst. → [Integracije CLI-ja](docs/guides/CLI-INTEGRATIONS.md) - **🛰️ Oddaljeni način** — upravljajte oddaljeno instanco OmniRoute z žetoni z omejenim obsegom (`connect` / `contexts` / `tokens`) in pomočnikom OAuth `antigravity` za namestitve na VPS. → [Oddaljeni način](docs/guides/REMOTE-MODE.md) - **🧭 Pametnejše samodejno usmerjanje** — kombinacije `auto/:`, **Fusion** (skupina modelov + ocenjevalec), usmerjanje glede na nalogo ter preglasitve modela, načina in proračuna v USD za posamezno zahtevo. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🗜️ Modularno stiskanje** — 12 sestavljivih pogonov + Compression Studios: LLMLingua-2, dvonivojski Ultra, omniglyph, preverjanje zvestobe pri vsakem koraku, GCF v3.2 in urejevalnik za spreminjanje vrstnega reda z vlečenjem. → [Stiskanje](docs/compression/COMPRESSION_ENGINES.md) - **🕵️ Transparentno dešifriranje MITM (TPROXY)** — prestrezanje CLI-jev, ki prezrejo okoljske spremenljivke posredniškega strežnika, z overiteljem potrdil za posamezni SNI in namestitvenikom shrambe zaupanja. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md) - **💸 Telemetrija stroškov povsod** — glave `X-OmniRoute-*` s stroški in uporabo na vsaki končni točki, glava s prihranki ob zadetku predpomnilnika in kvote porabe v USD za posamezni ključ. → [Referenca API-ja](docs/reference/API_REFERENCE.md) - **🧠 Pomnilnik pod vašim nadzorom** — privzeto izklopljen, izbirna kvantizacija vektorjev int8 in tipsko določeno pojemanje ter `x-omniroute-no-memory` za posamezno zahtevo. → [Pomnilnik](docs/frameworks/MEMORY.md) - **🛡️ Varnost** — zaščita pred vbrizgavanjem pozivov na vsaki poti LLM (zbirka preizkusov red-team), izbirna zaščita z maskiranjem poverilnic (v obeh smereh zakrije razkrite ključe API in skrivnosti), brezplačno spletno iskanje DuckDuckGo kot skrajna možnost in izbirna prijavna zapora OIDC za nadzorno ploščo (prijava z geslom je vedno na voljo). → [Zaščitni ukrepi](docs/security/GUARDRAILS.md) - **🖼️ Nove končne točke** — `/v1/ocr` (Mistral OCR) in `/v1/audio/translations` (v slogu Whisper) dopolnjujeta nabor medijskih vmesnikov. → [Referenca API-ja](docs/reference/API_REFERENCE.md) - **🎨 Ustvarjanje slik, videoposnetkov in zvoka** — en API za predstavnostne vsebine: videoposnetki xAI Grok Imagine in Novita AI, ComfyUI, Magnific, Adobe Firefly, Segmind ter ponudniki govora, kot je ElevenLabs. → [Referenca API-ja](docs/reference/API_REFERENCE.md) - **🌍 Uvajanje in delovanje** — `basePath` za obratni posredniški strežnik, samodejno zaznavanje jezika brskalnika, sledenje napravam za posamezni ključ, zaupanje MITM brez pravic root in lokalizacija zh-TW. → [Okolje](docs/reference/ENVIRONMENT.md) - **🤝 Več ponudnikov in agentov** — agenti v oblaku (Codex Cloud, Cursor, Devin, Jules), Grok Build (xAI) z brskalnikom in prijavo OAuth, prvovrstna kartica Ollama, Claude Opus 5 in Sonnet 5, uradno partnerstvo s Kimi (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI … ter osvežen **katalog 352 ponudnikov**. → [Ponudniki](docs/reference/PROVIDER_REFERENCE.md) - **📡 Preglednost usmerjanja** — vsak odgovor vsebuje glavo `X-OmniRoute-Decision`, ki navede strategijo, ponudnika in zakasnitev obdelave; nova kombinirana strategija `cache-optimized` in dejavnik Auto-Combo `cacheAffinity` ponavljajoče se zahteve usmerita nazaj k povezavi s predpomnjeno predpono, končna točka samo za branje `/v1/auto-combo/{channel}/candidates` pa razkrije trenutno zbirko kandidatov kanala `auto/*`. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **⚡ Lokalna zmogljivost in infrastruktura** — lokalni Redis z enim klikom, orodja za uvajanje relejev Cloudflare Workers / Deno Deploy ter Bifrost in Mux kot nadzorovani vdelani storitvi. → [Vdelane storitve](docs/frameworks/EMBEDDED-SERVICES.md) - **🧩 Vključeno je tudi** — ogrodje za vtičnike in tržnica, ogrodja veščin Omni/Agent/GitHub, integracija s trezorjem Obsidian (22 orodij MCP), API-ji Batch in Files, združljivi z OpenAI, semantični predpomnilnik odgovorov, igrifikacija z lestvicami najboljših, odkrivanje agentov ACP (15 vgrajenih agentov), načrtovani izvoz dnevnikov v BigQuery, vbrizgavanje napak `auto/chaos`, most do bota Telegram, upravljalnik različic v aplikaciji in lestvice brezplačnih ponudnikov LMArena-ELO. → [Dokumentacija](docs/README.md)

## 🤖 Združljivi CLI-ji in programski agenti > Ena konfiguracija — `http://localhost:20128/v1` — in **vsako** razvojno okolje 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 za posamezno orodje za vseh 36 orodij (26 CLI Code + 10 CLI Agents) → [`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časno izolirano domačo mapo: ```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 # tudi: claude opencode qwen aider goose gemini cline continue kilo ``` Vsak ukaz upošteva aktivni oddaljeni kontekst (`omniroute connect `), možnost `--dry-run` prikaže natančne spremenljivke okolja/argumente brez izvajanja, možnost `--api-key-env NAME` pa prepreči zapis skrivnosti v zgodovino vaše lupine. → [Integracije CLI](docs/guides/CLI-INTEGRATIONS.md)

## 🌐 357 ponudnikov umetne inteligence — 152 označenih kot brezplačnih v katalogu

> **357 registriranih ponudnikov** v kanoničnih zbirkah za klepet, predstavnostne vsebine, iskanje, lokalne storitve, agente v oblaku in sistemske storitve, vključno s **152 ponudniki z metapodatkom za odkrivanje `hasFree: true`**. Register modelov za klepet zajema **229 ponudnikov / 2.554 različnih parov ponudnik–model / 1.283 neobdelanih ID-jev modelov**; ločeni katalog brezplačnih kvot vsebuje **491 vrstic za posamezne modele**, **35 ponavljajočih se skupnih kvot** in **54 ponudnikov s ponavljajočo se oziroma trajno brezplačno ponudbo brez ključa**. Ti imenovalci se načrtno razlikujejo; definicije in izračuni z odstranjenimi podvojenimi skupnimi kvotami so v dokumentih [Referenca ponudnikov](docs/reference/PROVIDER_REFERENCE.md) in [Brezplačne ravni](docs/reference/FREE_TIERS.md).

### 🏢 Vsi večji laboratoriji — 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 330 drugih — vsaka ikona se sproti pridobi 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 Brezplačno za vedno}	Requesty _{GPT-OSS 120B, Nemotron Brezplačno za vedno}	SiliconFlow _{DeepSeek V3.2 / R1 Brezplačna stopnja}	Z.AI GLM _{GLM-4.7 / 4.5-Flash Brezplačno za vedno}	Baidu ERNIE _{ERNIE 4.0 Brezplačno za vedno}
Qoder AI _{Qwen3-Max, Kimi-K2 NEOMEJENO in BREZPLAČNO}	Pollinations _{GPT, Llama, Claude Ključ ni potreben}	Cloudflare AI _{Več kot 50 modelov 10K nevronov/dan}	NVIDIA NIM _{GLM, MiniMax ~40 RPM brezplačno}	Cerebras _{GLM 4.7, GPT-OSS 1M žetonov/dan}	OpenRouter _{Modeli :free +$10 → višji RPM}

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

## 🖥️ Kje deluje OmniRoute — povsod

> Ista aplikacija, vaš računalnik, vaša pravila. Od globalne namestitve npm do **vašega telefona** prek okolja Termux.

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

_{📖 [Vodnik za Docker](docs/guides/DOCKER_GUIDE.md) · [Namizna različica](electron/README.md) · [Termux](docs/guides/TERMUX_GUIDE.md) · [PWA](docs/guides/PWA_GUIDE.md) · [OpenCode](docs/frameworks/OPENCODE.md)}

### 🧩 Novo: OmniRoute v izvornem klepetu Copilot Chat urejevalnika VS Code

> Brez nove stranske vrstice in 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)** in jo usmerite 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 in 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, prijave težav in navodila za objavo so na voljo na [diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot). _{📖 [Vodnik za VS Code Copilot Chat](docs/guides/VSCODE-COPILOT.md) — nastavitev, kaj prikazuje izbirnik, nadzorna plošča v zavihku, odpravljanje težav}

## 🔒 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, zato 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 # voden čarovnik za prvi zagon omniroute doctor # diagnosticiraj ponudnike, vrata in izvorne odvisnosti ``` ### 🛰️ Oddaljeni način — CLI izvajajte tukaj, OmniRoute pa na VPS-u Je OmniRoute na strežniku? Upravljajte ga iz prenosnika z **istim CLI-jem**. Enkrat se prijavite z dostopnim žetonom z omejenim obsegom; nato vsak ukaz cilja oddaljeni strežnik. ```bash omniroute connect 192.168.0.15 # geslo → žeton z omejenim obsegom, shranjen kot kontekst omniroute models list # ← 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 omejene na povratno zanko. _{📖 [Oddaljeni način](docs/guides/REMOTE-MODE.md)}

Animiran terminalski prikaz CLI-ja OmniRoute — omniroute providers list, omniroute combo list in omniroute health — ki se pomika skozi nabor 86 ukazov najvišje 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 ta bo sam upravljal OmniRoute OmniRoute izpostavite prek **MCP-ja**, **A2A-ja**, **API-ja REST**, **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 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 spretnosti
🌐 API REST	`/v1/*`	Združljivo 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 dostopnimi žetoni z omejenim obsegom

```bash # Omogočite Claude Code dostop do celotnega nabora 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 izračun prihrankov

Cevovod stiskanja OmniRoute: ponazorjena zahteva odjemalca z 10.000 žetoni gre skozi 12 sestavljivih mehanizmov — Session-Dedup, CCR, Lite, RTK, Responses Tool Output, Headroom, Relevance, Caveman, Aggressive, LLMLingua-2, Ultra in OmniGlyph — ter lahko v dokumentiranem primeru zloženega načina doseže ponudnika s približno 1.080 žetoni. Strukturirano vsebino ščitijo varovala za ohranjanje in preverjanja zvestobe pri vsakem koraku; izrecno izbrani izgubni ali poskusni načini lahko preoblikujejo primerno vsebino.

Privzeta zložena kombinacija izvaja `RTK → Caveman`. Ko oba delujeta na istem koristnem tovoru orodja/konteksta, se prihranki množijo: ```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** z mehanizmom za ohranjanje. > **Zakaj uporabljati veliko žetonov, ko zadostuje le nekaj?** Vsaka zahteva gre skozi cevovod stiskanja OmniRoute **pregledno** — brez sprememb odjemalca. Zdaj je to **sklad 12 sestavljivih mehanizmov**, ki se izvajajo po vrsti ter jih je mogoče poljubno kombinirati za vsako usmerjevalno kombinacijo — temelji pa na zamislih projektov [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 mehanizmov Mehanizmi se izvajajo po vrstnem redu cevovoda; vsakega je mogoče neodvisno vklopiti in nastaviti za posamezno kombinacijo:

#	Mehanizem	Kaj počne
1	Session-Dedup	Odstrani vsebino, ki se ponavlja med izmenjavami (vsebinsko naslovljeno, med izmenjavami)
2	CCR	Arhivira velike bloke za označevalniki za pridobivanje, ki se naložijo na zahtevo
3	Lite	Odstranjevanje odvečnih presledkov in krajšanje URL-jev slik (osnovna možnost z nizko zakasnitvijo)
4	RTK	Pametno filtriranje, odstranjevanje podvojitev in krajšanje rezultatov orodij (z upoštevanjem ukazov)
5	Responses Tool Output	Prednostno brezizgubni JSON in omejeno diagnostično stiskanje za izhode lupine/popravkov/iskanja/gradnje (Responses API)
6	Headroom	Brezizgubno tabelarično zgoščevanje polj JSON (~30 %) prek vključene kode kodeka GCF
7	Relevance	Ekstraktivno ocenjevanje povedi glede na zadnjo uporabnikovo poizvedbo
8	Caveman	Stiskanje proze na podlagi pravil (~65–75 % na izhodu)
9	Aggressive	Povzemanje in postopno staranje starih izmenjav
10	LLMLingua-2	Semantično obrezovanje s strojnim učenjem 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 pri neposredni povezavi z Anthropic; transformatorji GPT 5.6 ostanejo varno onemogočeni do prejema potrdil ponudnika. Štirje profili stiskanja (privzeto agresivni, uravnoteženi, varni za kodiranje, brez obdelave) (najagresivnejše; zahteva izrecni vklop)

Bloki kode, URL-ji in strukturirani podatki se **vedno ohranijo** do bajta natančno. **Prednastavitve z enim klikom** združujejo mehanizme:

Način	Prihranek	Najprimernejše za
🪶 Lite	~15 %	Varna privzeta možnost, ki je vedno vklopljena
🪨 Standardni (Caveman)	~30 %	Vsakodnevno programiranje
⚡ Agresivni	~50 %	Dolge seje z intenzivno uporabo orodij
🔥 Ultra	~75 %	Največji prihranek
🧰 RTK	60–90 %	Izhod lupine/preizkusov/gradnje/git
🔗 Zloženi (RTK → Caveman)	78–95 %	Mešani pozivi in dnevniki orodij

**Resnični primer — standardni način:** > **Prej (69 žetonov):** _"Razlog, da se vaša komponenta React znova izrisuje, je verjetno ustvarjanje nove reference objekta pri vsakem ciklu izrisovanja. Ko kot lastnost podate objekt v vrstici, ga Reactova plitva primerjava vsakič zazna kot drug objekt, kar sproži ponovno izrisovanje. Priporočam uporabo useMemo za pomnjenje objekta."_ > > **Potem (19 žetonov):** _"Nova referenca objekta pri vsakem izrisu. Objektna lastnost v vrstici = nova referenca = ponovni izris. Ovijte v useMemo."_ > > **Enak odgovor. 72 % manj žetonov. Brez izgube natančnosti.** ✅ **Primer PT-BR — način [Troglodita](https://github.com/leninejunior/troglodita):** > **Prej (42 žetonov):** _"Težava je v tem, da se komponenta znova izrisuje, ker se pri vsakem ciklu izrisovanja ustvari nova referenca objekta. Priporočam uporabo useMemo."_ > > **Potem (12 žetonov):** _"Ponovni izris: nova referenca pri vsakem ciklu (objekt v vrstici je znova ustvarjen). Uporabite `useMemo`."_ > > **Enak odgovor. ~70 % manj žetonov. Tehnična natančnost ostaja nespremenjena.** ✅
### 🎚️ Onkraj mehanizmov — slogi izhoda, prilagodljivi gumb in nadzor posameznih zahtev Zgornjih 12 mehanizmov zmanjša količino vsebine, ki gre **noter**. Tri dodatne plasti določajo, **kako**, **kdaj** in kaj pride **ven**: - **🪄 Slogi izhoda** _(usmerjanje izhodne osi)_ — vstavijo deterministična navodila za oblikovanje odgovorov, varna za predpomnjenje; mogoče jih je kombinirati, vsakega z intenzivnostjo `lite` / `full` / `ultra`. Dodajanje sloga zahteva eno samo vrstico v registru: - **Jedrnata proza** — odstrani mašila/člene/omejevanje trditev; natančno ohrani tehnično vsebino. - **Manj kode** — YAGNI »lenega izkušenega razvijalca«: najmanjša delujoča sprememba brez nezahtevane podporne kode. - **Čop (leni izkušeni razvijalec)** — povzpnite se po lestvici YAGNI, odpravite temeljni vzrok, ustvarite najmanjšo delujočo razliko. - **Imam ADHD (najprej dejanje)** — začnite z naslednjim dejanjem, oštevilčite korake, navedite en konkreten naslednji korak, brez uvoda. - **Jedrnati CJK (文言)** — izjemno jedrnat slog klasične kitajščine (omejeno na področno nastavitev `zh`). - **🎯 Prilagodljivi proračun konteksta** _(gumb)_ — namesto enega praga za vklop/izklop glede na število žetonov stopnjuje najcenejše in najbolj brezizgubne mehanizme samo toliko, kolikor je potrebno, da se vsebina **prilega kontekstnemu oknu modela**. Pravilnik: `reserve-output` (privzeto, upošteva model) · `percentage` · `absolute`. Način: `floor` (zagotovi prileganje) · `replace-autotrigger` (vaša izrecna izbira ima prednost) · `off` (starejši prag). - **🎛️ Kje se določi stiskanje** _(prednost, visoka → nizka)_ — glava `x-omniroute-compression` posamezne zahteve › preglasitev usmerjevalne kombinacije › aktivni poimenovani profil › prilagodljivi/samodejni sprožilec › privzeta nastavitev nadzorne plošče › izklopljeno. Uporabljeni načrt se vrne v glavi odgovora `X-OmniRoute-Compression: ; source=`. Uporabite samodejni sprožilec glede na prag žetonov, vklopite prilagodljivi gumb, pripnite poimenovani profil, določite enkratno nastavitev za posamezno zahtevo ali dodelite cevovod posamezni usmerjevalni kombinaciji — kar koli najbolj ustreza delovni obremenitvi. Izbirno lokalno **ogrodje za vrednotenje** (`npm run eval:compression`) na pripetem korpusu oceni zvestobo glede na prihranek, preden uveljavite spremembo. 📖 [`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) Namestite in zaženite** ```bash npm install -g omniroute omniroute ``` > 💡 Vidite `npm warn ERESOLVE` ali opozorila o enakovrednih odvisnostih? [So neškodljiva](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated). Nadzorna plošča je na `http://localhost:20128` · API je na `http://localhost:20128/v1`. **2) Povežite BREZPLAČNEGA ponudnika (brez registracije)** Nadzorna plošča → **Ponudniki** → povežite **Kiro AI** (brezplačni Claude, ~50 dobroimetij/mesec na račun) ali **OpenCode Free** (brez preverjanja pristnosti) → končano. **3) Usmerite svoje programsko orodje** ```txt Osnovni URL: http://localhost:20128/v1 Ključ API: [kopirajte iz Nadzorna plošča → Končne točke] Model: auto (pametno usmerjanje brez nastavljanja — ali kateri koli ponudnik/model) ``` **4) Preverite, ali deluje** ```bash curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY" ``` Prikazan bi moral biti seznam povezanih modelov. 🎉 To je vse — začnite programirati, OmniRoute pa bo za vas samodejno usmerjal zahteve in po potrebi preklapljal na nadomestne možnosti. Če vaš odjemalec ne more pošiljati glav po meri, OmniRoute ponuja tudi tokenizirane združljivostne vzdevke: ```txt Katalog OpenAI: http://localhost:20128/vscode/YOUR_KEY/ Modeli OpenAI: http://localhost:20128/vscode/YOUR_KEY/models Klepet OpenAI: http://localhost:20128/vscode/YOUR_KEY/chat/completions Odzivi OpenAI: http://localhost:20128/vscode/YOUR_KEY/responses Klepet Ollama: http://localhost:20128/vscode/YOUR_KEY/api/chat Oznake Ollama: http://localhost:20128/vscode/YOUR_KEY/api/tags ``` Uporabite jih samo za odjemalce, ki ne morejo dodati `Authorization: Bearer ...`. Preverjanje pristnosti z glavo ostaja 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 fiksno nastavljeno vrednost **`OMNIROUTE_MEMORY_MB=1024`**. To zadostuje za nadzorno ploščo in lahek klepet. **Agenti za programiranje** (`POST /v1/responses` iz Claude Code, Codex, Grok, …) potrebujejo veliko večji kopičeni pomnilnik V8, sicer se proces zaključi z napako `FATAL ERROR` pri približno 12 GiB ob dveh prekrivajočih se dolgih kontekstih. Velikost vsebnika nastavite nad velikostjo kopice (izvorni medpomnilniki so zunaj V8): | Delovna obremenitev | Kopica (`-e OMNIROUTE_MEMORY_MB`) | Vsebnik (`--memory`) | | --------------------------------- | --------------------------------- | -------------------- | | Nadzorna plošča / lahek 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 Docker za predizdaje:** `diegosouzapw/omniroute:next` in > `diegosouzapw/omniroute:next-web` sledita trenutni privzeti veji `release/v*`. > Ti spremenljivi oznaki sta namenjeni samo preizkušanju neobjavljenih popravkov in > **nista podprti za produkcijsko uporabo**. Glejte > [Kanali izdaj Docker](docs/guides/DOCKER_GUIDE.md#release-channels). **🥟 Bun** Standardna namestitev z `bun install` in globalna namestitev (`bun install -g omniroute`) sta podprti prek zaznavanja izvajalnega okolja Bun: - **Vgrajeni `bun:sqlite`**: OmniRoute med izvajanjem v okolju Bun uporablja Bunov vgrajeni gonilnik `bun:sqlite`, v okolju Node.js pa preklopi na `better-sqlite3` ali `sql.js`. - **Samodejna izbira povezovalnika Webpack med razvojem**: Razvojno okolje (`bun run dev`) samodejno zazna Bun in onemogoči Turbopack ter namesto njega uporabi Webpack, da prepreči nezdružljivosti izvornih vezav V8. Produkcijske gradnje (`bun run build`) natančno upoštevajo `OMNIROUTE_USE_TURBOPACK`, enako kot v okolju Node: privzeto se uporablja Turbopack, za gradnjo z Webpackom pa nastavite `OMNIROUTE_USE_TURBOPACK=0` (`Dockerfile.bun` to omogoča kot `--build-arg`). - **Namenski Dockerfile za Bun**: Večstopenjski `Dockerfile.bun` za izvorne produkcijske uvedbe Bun (`docker build -f Dockerfile.bun -t omniroute:bun .`). ```bash # Namestitev in zagon z 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 Nix flakes nix develop npm run dev # Ali uporaba devbox devbox run npm run dev ``` 📖 [Vodnik za Docker](docs/guides/DOCKER_GUIDE.md) — Profili Compose, Caddy HTTPS, tuneli Cloudflare. **🦭 Podman** ```bash # 1. Pripravite podatkovni imenik, priklopljen z vezavno priklopno točko mkdir -p data # 2. Samo za Linux in lokalni brezkoreninski Podman (nikoli za oddaljenega odjemalca 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 sistemu macOS ali Windows Podman uporablja 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 (preskočite izvorno gradnjo)** Izvorni pogon SQLite (`better-sqlite3`) je **izbirna** odvisnost, zato globalna namestitev nikoli ne čaka na prevajanje iz izvorne kode: uporabi vnaprej prevedeno binarno datoteko, če je ta na voljo za vašo platformo/Node, sicer pa neopazno preklopi na pogon 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 (CI, okolja brez grafičnega vmesnika ali počasni računalniki): ```bash OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute # Tudi CI=1 ga preskoči ``` Za najhitrejše namestitve izberite **pnpm** (shramba z vsebinskim naslavljanjem + 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). CLI in spletno nadzorno ploščo zagotavlja isti proces prek enih vrat, zato trenutno ni ločenega paketa samo za CLI.

# 🎬 OmniRoute v akciji

## 📹 Video vodniki

_{Posnetek nadzorne plošče z dne 2026-08-24 · Neobdelani katalog: YT 809 | TT 137 | IG 124 · Svežina (v dnevih): YT 1 | TT 21 | IG 22}

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

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

🎬 #3 — TikTok
_{milesreevesai — 620,400 ogledov}

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

🎬 #5 — Instagram
_{buildwithai.club — 347,652 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** | [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** | Kanonične metrike na dan 2026-08-24: **1.029 edinstvenih videoposnetkov** · **11.132.922 znanih ogledov** (`v > 0`) · **639 kanalov/profilov po omrežjih**. Neobdelana nadzorna plošča vsebuje 1.070 vrstic; 41 podvojenih vnosov z Instagrama je bilo normaliziranih glede na kanonični URL, pri čemer je bilo ohranjeno največje število ogledov na videoposnetek. > 🎬 **Ste posneli videoposnetek o OmniRoute?** Odprite [težavo](https://github.com/diegosouzapw/OmniRoute/issues/new) ali [razpravo](https://github.com/diegosouzapw/OmniRoute/discussions) s povezavo — predstavili jo bomo tukaj.

# 📧 Skupnost in pomoč > Vse na enem mestu — sledite vzdrževalcu, klepetajte s skupnostjo ali odprite težavo. | 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 v2.0)
Okvir	Next.js 16 + React 19 + Tailwind CSS 4
Baza podatkov	better-sqlite3 (SQLite, WAL journaling) + LowDB (JSON zapuščina) — 122 domenskih modulov, 183 migracij
Pomnilnik	SQLite FTS5 celotno besedilo + int8-kvantizirane vektorske vdelave, tipiziran razpad
Sheme	Zod 4 — MCP orodje za validacijo V/I + API pogodbe
Protokoli	MCP (stdio / HTTP / SSE) + A2A v0.3 (JSON-RPC 2.0 + SSE)
Pretakanje	Dogodki, poslani s strežnika (SSE) + WebSocket most (`/v1/ws`)
Kompresija	12-motorna cevovod — RTK, Caveman, LLMLingua-2 (MobileBERT ONNX), GCF, OmniGlyph
Avtentikacija & varnost	OAuth 2.0 (PKCE) + JWT + API ključi + MCP obseg avtentikacije · AES-256-GCM v mirovanju · DOMPurify
Prikrivanje	wreq-js — JA3 / JA4 TLS ponarejanje prstnih odtisov, 3-nivojski proxy
Odpornost	Odklopnik, eksponentni umik, preprečevanje preobremenitve, samodejno kombinirano samozdravljenje
Beleženje	pino — strukturirani JSON dnevniki s kontekstom zahteve
Testiranje	Node.js test runner + Vitest — 39.000+ statičnih deklaracij testov v več kot 5.100 sledenih testnih datotekah (enota, integracija, E2E, varnost, ekosistem)
Platforme	Namizje (Electron) · Android (Termux) · PWA (kateri koli brskalnik)
CI/CD	GitHub Actions — samodejna objava npm + Docker Hub ob izdaji
Povezave	Spletna stran · npm · Docker Hub

## 📖 Dokumentacija

### 📘 Kako začeti

Dokument	Opis
Uporabniški priročnik	Ponudniki, kombinacije, integracija s CLI-jem, uvajanje
Priročnik za nastavitev	Vsi načini namestitve, konfiguracije orodij CLI, nastavitev protokolov, prilagajanje časovnih omejitev
Priročnik za orodja CLI	Nastavitev posameznih orodij Claude Code, Codex, Cursor, Cline, OpenClaw, Kilo in Copilot
Oddaljeni način	Upravljanje oddaljenega sistema OmniRoute (VPS) iz CLI-ja prenosnika z dostopnimi žetoni z omejenim obsegom
Konfiguracija Claude Code	Usmerjanje Claude Code v OmniRoute (lokalno/oddaljeno) z ukazom `launch` in profili za posamezne modele
Hitri začetek	Namestitev v 3 korakih → povezava → konfiguracija

### 🔧 Upravljanje in uvajanje

Dokument	Opis
Priročnik za Docker	Docker run, profili Compose, Caddy HTTPS, tuneli, oznake slik
Priročnik za Podman	Integracija Quadlet s systemd, podman-compose, SELinux
Uvajanje v navidezni stroj	Celoten priročnik: nastavitev navideznega stroja + nginx + Cloudflare
Uvajanje v Fly.io	Uvajanje v Fly.io s trajnim pomnilnikom
Priročnik za Termux	Zagon OmniRoute v sistemu Android prek Termuxa
Priročnik za PWA	Namestitev progresivne spletne aplikacije, predpomnjenje, arhitektura
Priročnik za odstranitev	Čista odstranitev za vse načine namestitve
Konfiguracija okolja	Celoten seznam spremenljivk `.env` in sklicev

### 🧠 Funkcije in arhitektura

Dokument	Opis
Arhitektura	Sistemska arhitektura, pretok podatkov in notranje delovanje
Priročnik za stiskanje	Cevovod s 7 možnostmi: izklopljeno / lahko / standardno / agresivno / ultra / RTK / zloženo
Stiskanje RTK	Stiskanje izhoda ukazov, filtri, zaupanje, preverjanje, obnovitev neobdelanega izhoda
Pogoni za stiskanje	Caveman, RTK, zloženi cevovodi, vmesniki nadzorne plošče/API-ja/MCP-ja
Oblika pravil za stiskanje	Sheme paketov pravil JSON za filtre Caveman in RTK
Jezikovni paketi za stiskanje	Zaznavanje jezika in ustvarjanje paketov pravil Caveman
Priročnik za odpornost	Odklopniki, obdobja ohlajanja, čakalna vrsta, preprečevanje množičnih sočasnih zahtev, lažno predstavljanje TLS
Mehanizem Auto-Combo	Ocenjevanje s 16 dejavniki, paketi načinov, samozdravljenje
Priročnik za posredniške strežnike	Tristopenjski sistem posredniških strežnikov, tržnica 1proxy, operacije CRUD za register
Brezplačne ravni	Združeni imenik: 35 dokumentiranih ponavljajočih se naborov / 489 katalogiziranih vnosov brezplačnih ravni
Galerija funkcij	Vizualni ogled nadzorne plošče s posnetki zaslona
Dokumentacija kodne zbirke	Začetnikom prijazen pregled kodne zbirke

### 🤖 Protokoli in API-ji

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

### 📋 Projekt in kakovost

Dokument	Opis
Prispevanje	Nastavitev razvojnega okolja in smernice
Model vej in izdaj	Kam so usmerjene zahteve PR (`release/*`) ter kaj pomenijo `main` in oznake
Dnevnik sprememb	Celotna zgodovina izdaj po različicah
Varnostna politika	Prijavljanje ranljivosti in varnostne prakse
Vodnik za i18n	Podpora za 42 jezikov, potek prevajanja, RTL
Kontrolni seznam za izdajo	Koraki preverjanja pred izdajo
Načrt pokritosti	Strategija pokritosti testov za več kot 39.000 statičnih deklaracij testov v več kot 5.100 spremljanih testnih datotekah

# ⭐ Najboljši sodelujoči > OmniRoute oblikuje zavzeta odprtokodna skupnost. Ti posamezniki so izjemno prispevali ter neposredno vplivajo na kakovost, stabilnost in doseg projekta. **Hvala.** ### Zunanji sodelujoči po združenih zahtevah za vključitev

Mesto	Sodelujoči	Združene zahteve PR	~Spremenjene vrstice
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

_{Zamrznjeno pri trenutnem vrhu veje release/v3.8.50, dafb4ae808, z združitvami do 2026-08-24 05:26:03 UTC. Popis GitHub GraphQL z oštevilčenimi stranmi vsebuje 5.911 združenih zahtev PR: 2.707 jih je ustvaril lastnik repozitorija, 179 Dependabot, 3.025 zunanjih zahtev PR pa 535 različnih sodelujočih. »Spremenjene vrstice« so vsota dodatkov in izbrisov na GitHubu ter vključujejo ustvarjene datoteke, zaklepne datoteke, kataloge, prevode in dokumentacijo; to je obseg sprememb, ne število avtorsko napisanih vrstic kode. Izenačeni sodelujoči na meji so ohranjeni.} ### Potrditve, pripisane na GitHubu

backryun _{🥇 220 GitHubu pripisanih commitov}	Paijo _{🥈 219 GitHubu pripisanih commitov}	Randi _{🥉 108 GitHubu pripisanih commitov}	Ravi Tharuma _{🏅 81 GitHubu pripisanih commitov}	Chris _{🏅 70 GitHubu pripisanih commitov}	Markus Hartung _{🏅 69 GitHubu pripisanih commitov · izenačen na 6. mestu}
Dizzle _{🏅 69 GitHubu pripisanih commitov · izenačen na 6. mestu}	Jan Leon _{🏅 64 GitHubu pripisanih commitov}	zenobit _{🏅 62 GitHubu pripisanih commitov}	Bob.Hou _{🏅 51 GitHubu pripisanih commitov · izenačen na 10. mestu}	Xiangzhe _{🏅 51 GitHubu pripisanih commitov · izenačen na 10. mestu}

_{Ponovno preverjeno 2026-08-24 06:14:31 UTC: commiti, pripisani GitHubu, kot jih je za privzeto vejo release/v3.8.50 sporočil API sodelujočih v repozitoriju. API je vrnil 525 identitet (415 uporabnikov, 2 bota, 108 anonimnih); ta tabela izključuje vzdrževalca, bote in anonimne identitete ter ohranja izenačenja na lestvici. Razlikuje se tako od zgornje lestvice združenih zahtevkov za vključitev sprememb kot tudi od spodnjega popisa 639 oseb na podlagi metapodatkov Git.} > 🙏 Funkcionalnosti, popravki napak in izboljšave infrastrukture teh sodelujočih so **ključni del** tega, zaradi česar je OmniRoute zanesljiv in bogat s funkcionalnostmi. Pomembni so vsak zahtevek za vključitev sprememb, vsak testni primer in vsaka prevodna datoteka i18n. Odprtokodne projekte 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}

Paco Cartones
_{💛 Aktivni enkratni sponzor}

Prof. Igor Morais
_{💛 Nekdanji enkratni podpornik}

longtao
_{💛 Nekdanji enkratni podpornik}

_{… in drugi, ki želijo ostati zasebni 💛} _{Javni sponzorji na GitHub Sponsors so bili znova preverjeni 2026-08-24. GitHubovo stanje activeOnly določa zgornje oznake aktivnosti; javno razkritim nekdanjim enkratnim podpornikom se še vedno zahvaljujemo, zasebni sponzorji pa ostajajo anonimni.} 💖 Postanite sponzor → — vsak dolar pomaga, da OmniRoute ostaja brezplačen in neodvisen.

## 👥 Več kot 600 prispevalcev

[![Prispevalci](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=639&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors) _{Pregledano 2026-08-24 na zamrznjeni osnovi ac02c5b42f in znova preverjeno na trenutnem vrhu dafb4ae808 veje release/v3.8.50: 639 normaliziranih človeških identitet Git — 407 jih je navedenih kot avtorjev commitov (vključno z vzdrževalcem), 232 pa samo v izrecnih priklopnikih Co-authored-by. Popis normalizira uporabniška imena GitHub noreply, izključuje 26 identitet botov/agentov/storitev/oznak mest in običajnih e-poštnih naslovov ne združuje zgolj zato, ker se njihova prikazna imena ujemajo.} ### Kako prispevati 1. Razvejite repozitorij 2. Ustvarite vejo iz vrha **aktivne** veje `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 Pull Request z nastavitvijo **base = ta veja `release/vX.Y.Z`** Za podrobne smernice glejte [CONTRIBUTING.md](CONTRIBUTING.md). ### Izdaja nove različice ```bash # Ustvarite izdajo — npm publish 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 TypeScriptova predelava projekta **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)**, napisanega v jeziku Go — od tam naprej pa je vsak spodaj navedeni podsistem navdihnil odprtokodni projekt, ki je to storil že prej. Vsak od njih je oblikoval konkreten del sistema OmniRoute. To je naša zahvala vsem. 🙏 > ⭐ število zvezdic je bilo preverjeno prek GitHubovega vmesnika REST API 24. avgusta 2026 — podarite tem projektom zvezdico. Števila so natančen posnetek na navedeni datum in se bodo seveda spreminjala. ### 🧬 Izvor in prehod

Projekt	⭐	Kako je navdihnil OmniRoute
9router	26,161	Izvirni projekt, na katerem temelji ta razcep — tukaj razširjen z večmodalnimi API-ji in popolnoma na novo napisan v jeziku TypeScript.
CLIProxyAPI	48,497	Implementacija v jeziku Go, ki je navdihnila to predelavo v jezikih JavaScript / TypeScript.
LiteLLM	57,100	Prehod za umetno inteligenco, katerega javni nabor podatkov o cenah napaja našo sinhronizacijo spremljanja stroškov, njegov model normalizacije ponudnikov pa je vplival na naše usmerjanje.
codex-chatgpt-web	1,410	Izvorna koda pod licenco MIT, prilagojena v vključeni most ChatGPT Web → Codex Responses, vključno s prilagojevalniki sej brskalnika, okvirjanja odgovorov, porabe in spletnega iskanja.
free-claude-code	48,112	Vzorci, preneseni v obnovitev toka, vzdevke brez razmišljanja, nadomestno spletno iskanje, omejitve drsečega okna, redigiranje dnevnikov in utrjene zagonske poteke.
composer-api	322	Vzorci izbire orodja, omejitev izhoda in potrditve orodja iz sistema Cursor Composer, prilagojeni izvornemu izvajalniku Cursor.
codex-multi-auth	457	Vzorci sveže prijave in izmenjevanja žetonov za osveževanje, preneseni v ponovno overjanje Codex OAuth.
opencode-anthropic-auth	510	Privzete nastavitve preoblikovanja, združljive s Claude Code, in vedenje glav za obračunavanje, posplošeni v konfiguracijsko voden most sistema OmniRoute.
grok2api-merged	2	Njegove preslikave modelov Grok, generator Statsig z lažnim TypeError, privzete nastavitve zahtev in naprav ter obdelovalnik odgovorov NDJSON so bili vsebinsko prilagojeni izvajalniku Grok Web sistema OmniRoute.
TQZHR/grok2api	705	Glavni posredni vir kode za grok2api-merged; njegove implementacije modelov, glav, koristnih vsebin, sistema Statsig in obdelovalnikov so ohranjene v izvorni liniji Grok Web.
chenyme/grok2api	7,520	Temeljni vir pod licenco MIT za koristne vsebine Grok in privzete nastavitve naprav, generator Statsig ter obdelovalnik `result.response`, prenesen prek projektov TQZHR in grok2api-merged.
grok2api-pro	27	Posredni vir, ki ga grok2api-merged navaja za svojo plast skupine posredniških strežnikov; OmniRoute ohranja navedbo tega izvora, vendar ne trdi, da je v svoj omejeni izvajalnik Grok Web prenesel skupino posredniških strežnikov.
GrokProxy	50	Njegov posredniški strežnik Grok z overjanjem prek piškotkov in vzorec pretočnega prenosa `result.response.token` sta vplivala na transport Grok Web sistema OmniRoute.
GrokBridge	5	Izvirna implementacija Grok Web se je zgledovala po njegovi zasnovi nadrejene povezave HTTP/brskalnik; njena neposredna pot HTTP izhaja iz projekta GrokProxy, zato ne trdimo, da gre za neodvisen prenos kode.
grok-web-api	14	Njegove sheme Rust `ChatOptions` in ovojnic odgovorov so vplivale na tipe zahtev Grok in pretočnih odgovorov v jeziku TypeScript sistema OmniRoute.

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

Projekt	⭐	Kako je navdihnil OmniRoute
Caveman	100,538	Viralni projekt »zakaj uporabljati veliko žetonov, ko malo žetonov zadostuje« — njegova filozofija jamskega govora poganja naš standardni način stiskanja in več kot 30 pravil za odstranjevanje mašil ter zgoščevanje.
RTK – Rust Token Killer	77,185	Visokozmogljivo stiskanje izhoda ukazov — navdihnilo je naš pogon RTK, DSL za filtriranje JSON, obnovitev neobdelanega izhoda in zloženi cevovod RTK → Caveman.
headroom	67,310	Povratno stiskanje konteksta (SmartCrusher) — navdihnilo je naš pogon `headroom` in vzorec označevalnika za pridobivanje `ccr`.
LLMLingua	6,598	Raziskave stiskanja pozivov (LLMLingua / LLMLingua-2) — navdihnile so naš asinhroni pogon `llmlingua`, varen za kodo in odporen proti napakam.
llmlingua-2-js	31	Predelava JS/ONNX (MobileBERT / XLM-RoBERTa), uporabljena kot zaledje v delovni niti za naš pogon LLMLingua.
Troglodita	40	Stiskanje žetonov za pt-BR — poganja naš jezikovni paket pt-BR: zmanjševanje pleonazmov in odstranjevanje mašil, prilagojeno brazilsko-portugalski slovnici.
ponytail	108,957	Viralna veščina »lenega višjega razvijalca«, ki programira po načelu YAGNI — navdihnila je naš izhodni slog less-code: usmerjanje k najmanjši delujoči spremembi, ki zmanjša količino _ustvarjene_ kode (ustreznik jedrnati prozi projekta Caveman na izhodni osi).
i-have-adhd	23,526	Njegov akcijsko usmerjen in osebam z ADHD prijazen slog odgovorov je bil prilagojen v jedrnati izhodni slog sistema OmniRoute v petih jezikih.

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

Projekt	⭐	Kako je navdihnil OmniRoute
TOON	25,233	Objektni zapis, usmerjen v žetone — njegov stolpčni model z glavo in vrsticami je oblikoval našo stopnjo tabelarnega zgoščevanja.
GCF – Graph Compact Format	41	Njegova kompaktna oblika grafov in zasnova splošnega profila sta vplivali na tabelarno zgoščevanje sistema OmniRoute in 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	494	Predpomnilnik Brotli/SQLite in delta konteksta za posamezno sejo — navdihnila sta naš pogon `session-dedup`.
token-savior	1,122	Zgoščevanje izhoda Bash in profili MCP — navdihnili so našo načelnost pri prekinitvi stiskanja in zmanjševanje manifestov orodij MCP.
token-saver	138	Stiskanje izhoda glede na vsebino in vrsto datoteke z opustitvijo ob napaki — potrdilo je naše razvrščanje po vrstah in preskok ob premajhnem prihranku.
token-optimizer	1,951	»Poiščite žetone duhove« — njegov vzorec odlaganja in obnovljivega ročaja je vplival na naš pristop k odlaganju CCR.
TokenMizer	28	Načrt grafa sej in odstranjevanja podvojenih vrstic med izmenjavami, ki je vplival na našo zasnovo session-dedup.
OmniCompress	3	Stolpčni JSON v jeziku Rust, pridobivanje z naslavljanjem po vsebini in odstranjevanje podvojitev med sporočili — potrdili so zasnovo naših pogonov `headroom`/`ccr`/`session-dedup` ter predpomnilniško stabilno invarianto »stisnjena oblika je neodvisna od položaja«.
mcp-compressor	113	Stiskanje shem in opisov orodij MCP — vplivalo je na zmanjšanje kardinalnosti manifestov orodij MCP.
RepoMapper	197	Razvrščanje zemljevidov repozitorijev v slogu Aider — vplivalo je na naše raziskovanje zemljevidov repozitorijev in razvrščanja pridobivanja.
quiet-shell-mcp	4	Deklarativno zmanjševanje lupinskega izhoda prek MCP — potrdilo je naše deklarativno zgoščevanje izhoda Bash.
ts-morph	6,162	Zbirka orodij TypeScript Compiler API — navdihnila je naše odstranjevanje komentarjev z razčlenjevalnikom, ki ohranja nize, predloge in literale regularnih izrazov.

### 🧠 Pomnilnik in RAG

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

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

Projekt	⭐	Kako je navdihnil OmniRoute
llm-interceptor	66	Prestrezanje/analiza prometa med pomočnikom za programiranje ↔ LLM z metodo MITM je vplivala na zgodnje zahteve za Traffic Inspector. Štiri predhodno izpeljane module — združevanje SSE, normalizacijo pogovorov, prikrivanje skrivnosti in čiščenje glav — so nadomestile neodvisne implementacije iz čiste sobe, ki temeljijo na javnih standardih protokolov. Površini za neposredno posredovanje gostitelju (`passthrough.ts` in `_internal/bypass.cjs`) ostajata interni implementaciji sistema OmniRoute, razvrščeni neodvisno; v okviru te zamenjave nista bili napisani na novo.
ProxyBridge	5,995	Transparentno usmerjanje prek posredniškega strežnika za posamezen proces — navdihnilo je naše varno zaustavljanje MITM ob sesutju, časovne omejitve nedejavnosti vtičnic, pripisovanje procesov prek `/proc` in zajemanje TPROXY.

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

Projekt	⭐	Kako je navdihnil OmniRoute
models.dev	6,555	Odprta podatkovna zbirka specifikacij, cen in zmogljivosti modelov umetne inteligence — izvorno sinhronizirana v naš katalog modelov.
React Flow / xyflow	38,108	Knjižnica grafov na podlagi vozlišč, ki poganja naša sprotna okolja Compression Studio in Combo/Routing Studio.
LangGraph	40,314	Prikaz grafa delovnega toka v živo v okolju LangGraph Studio je navdihnil sprotni kaskadni pogled v naših okoljih Studio.
Langfuse	33,592	Njegov model opazljivosti sled → razpon → ustvarjanje je oblikoval slapovni prikaz v našem okolju Compression Studio.
Kiali	3,631	Opazljivost storitvene mreže Istio — navdihnila je naše značke odklopnikov in vizualizacije povezav z napakami v okolju Routing/Combo Studio.
lobe-icons	2,428	Logotipi blagovnih znamk AI/LLM, ki prikazujejo ikone ponudnikov na naši nadzorni plošči.
flag-icons	12,354	Zagotavlja zastave SVG pod licenco MIT, ki jih uporablja izbirnik jezika v datoteki README.

### 🛡️ Varnost

Projekt	⭐	Kako je navdihnil OmniRoute
awesome-secure-defaults	721	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,564	Navdihnil je odstranjevanje podvojenih zahtev, zasilni brezplačni nadomestni način, priključljive strategije Auto-Combo in večjezično razvrščanje namenov.
Antigravity-Manager	30,652	Njegovo preslikavanje modelov glede na račun, preverjanje poti do izvedljivih datotek in vedenje oznak paketov so vplivali na izvajalno okolje Antigravity sistema OmniRoute.
vscode-antigravity-cockpit	4,817	Njegova kompaktna oblika odštevanja do ponastavitve kvote je navdihnila ustrezni prikaz omejitev ponudnika v sistemu OmniRoute.
AionUi	32,230	Njegove integracije ACP so navdihnile samodejno zaznavanje nameščenih agentov CLI v sistemu OmniRoute.
CodexBar	20,507	Prepoznal je mesto kvote Grok Build; OmniRoute je nato neodvisno preveril in popravil dejansko obliko prenosa po povezavi.

## 📄 Licenca Licenca MIT – za podrobnosti glejte [LICENSE](LICENSE). ---

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