# README (Slovenščina) 🌐 **Languages:** 🇺🇸 [English](../../../README.md) · 🇸🇦 [ar](../ar/README.md) · 🇦🇿 [az](../az/README.md) · 🇧🇬 [bg](../bg/README.md) · 🇧🇩 [bn](../bn/README.md) · 🇨🇿 [cs](../cs/README.md) · 🇩🇰 [da](../da/README.md) · 🇩🇪 [de](../de/README.md) · 🇬🇷 [el](../el/README.md) · 🇪🇸 [es](../es/README.md) · 🇪🇪 [et](../et/README.md) · 🇮🇷 [fa](../fa/README.md) · 🇫🇮 [fi](../fi/README.md) · 🇫🇷 [fr](../fr/README.md) · 🇮🇪 [ga](../ga/README.md) · 🇮🇳 [gu](../gu/README.md) · 🇮🇱 [he](../he/README.md) · 🇮🇳 [hi](../hi/README.md) · 🇭🇷 [hr](../hr/README.md) · 🇭🇺 [hu](../hu/README.md) · 🇮🇩 [id](../id/README.md) · 🇮🇹 [it](../it/README.md) · 🇯🇵 [ja](../ja/README.md) · 🇰🇷 [ko](../ko/README.md) · 🇱🇹 [lt](../lt/README.md) · 🇱🇻 [lv](../lv/README.md) · 🇮🇳 [mr](../mr/README.md) · 🇲🇾 [ms](../ms/README.md) · 🇲🇹 [mt](../mt/README.md) · 🇳🇱 [nl](../nl/README.md) · 🇳🇴 [no](../no/README.md) · 🇵🇭 [phi](../phi/README.md) · 🇵🇱 [pl](../pl/README.md) · 🇵🇹 [pt](../pt/README.md) · 🇧🇷 [pt-BR](../pt-BR/README.md) · 🇷🇴 [ro](../ro/README.md) · 🇷🇺 [ru](../ru/README.md) · 🇸🇰 [sk](../sk/README.md) · 🇷🇸 [sr](../sr/README.md) · 🇸🇪 [sv](../sv/README.md) · 🇰🇪 [sw](../sw/README.md) · 🇮🇳 [ta](../ta/README.md) · 🇮🇳 [te](../te/README.md) · 🇹🇭 [th](../th/README.md) · 🇹🇷 [tr](../tr/README.md) · 🇺🇦 [uk-UA](../uk-UA/README.md) · 🇵🇰 [ur](../ur/README.md) · 🇻🇳 [vi](../vi/README.md) · 🇨🇳 [zh-CN](../zh-CN/README.md) · 🇹🇼 [zh-TW](../zh-TW/README.md) ---

# 🚀 OmniRoute — brezplačni prehod za umetno inteligenco

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

## 💰 Približno 1,51 milijarde brezplačnih žetonov / mesec

> Ročno združevanje brezplačnih paketov je zahtevno — na ducate SDK-jev, na ducate omejitev hitrosti in nobenega pregleda nad tem, koliko dejansko imate na voljo. OmniRoute katalogizira **446 vnosov brezplačnih paketov v 38 ponavljajočih se ključih skupin** in izračuna skupno število žetonov iz **20 skupin z objavljenim pozitivnim mesečnim proračunom**, pri čemer odstrani podvojitve skupnih skupin. Rezultat je vedno prikazan na nadzorni plošči (`/dashboard/free-tiers`).

Kartica proračuna brezplačnih paketov OmniRoute: približno 1,51 milijarde brezplačnih žetonov na mesec, v prvem mesecu pa do približno 2,13 milijarde z dobroimetjem ob registraciji, iz 38 dokumentiranih ključev ponavljajočih se skupin, ki zajemajo 446 katalogiziranih vnosov brezplačnih paketov za eno samo končno točko. Pošten izračun z odstranitvijo podvojitev skupin — vsaka skupna skupina se upošteva samo enkrat, vključno z 20 ponavljajočimi se skupinami z objavljenim pozitivnim mesečnim proračunom žetonov; 13 ponudnikov je v katalogu tveganj pogojev označenih za izogibanje, da se lahko odločite sami. Vrstica proračuna vključuje Mistral 1B, LLM7 150M, Nara 150M, Gemini 60M 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, tako da nikoli ne napihnejo skupnega števila. Trenutna poraba in preostanek sta na voljo 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 trenutni katalog in se **spreminjajo v obe smeri** — če ponudnik ukine brezplačni paket, številka pade; če se pojavi nov, se zviša. Objavljamo dejanski izračun kataloga, nikoli navzgor zaokroženega najboljšega možnega scenarija.}

⭐ Dodajte repozitoriju zvezdico, č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 po zgodovini 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 — bodite prvi obveščeni o novih ponudnikih, izdajah in nasvetih:** [![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 nenehno raste

| | v3.8.49 | **v3.8.50** | `v3.8.51+` | | ----------------------------------- | :-----: | :-------------------: | :----------: | | 🌐 Ponudniki | 290 | **352** | več jih čaka | | 🧠 Enolični ID-ji modelov za klepet | 1185 | **1312** | — | | 🖼️ Most med modalnostmi | — | 🆕 vid + zvok + video | — | | 📡 Brezplačni katalog Radar | — | 🆕 po izbiri | — | | ⚖️ Razporejanje z upoštevanjem kvot | — | 🆕 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čno na 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	🚀 Hiter začetek	📦 Namestitev	🆓 Brez konfiguracije
💡 Spoznajte	💥 Obljuba	🤔 Zakaj OmniRoute	🏆 Kaj ga odlikuje
⚙️ Funkcije	🎯 Kombinacije	🌐 Ponudniki	🔌 CLI in MCP
	🗜️ Stiskanje	🖥️ Kje deluje	🔒 Zasebno
👀 Oglejte si	🎬 V delovanju	✨ Novosti	🤖 Združljivi vmesniki CLI
💚 Podpora	💚 Podprite / donirajte	💬 Skupnost	💖 Sponzorji
📦 Projekt	🛠️ Tehnološki sklad	📖 Dokumentacija	👥 Sodelujoči

🌐 V 48 jezikih

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

Deluje takoj po namestitvi — brez konfiguracije. Trije koraki: 1. Namestite — npm i -g omniroute, strežnik se zažene na localhost:20128. 2. Svoje orodje usmerite na http://localhost:20128/v1 — katero koli orodje, združljivo z OpenAI (Claude Code, Cursor, Cline). 3. Odgovori — za takojšen odgovor pokličite model auto, brez ključa API, registracije ali konfiguracije. Ponudnik brez ključev OpenCode Free je vnaprej povezan s kombinacijo auto, zato sveža namestitev deluje 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!"}]}' ``` _{Želite določen brezplačen zaledni sistem? Neposredno pokličite `oc/…` (OpenCode Free). Nato preidite na `auto` in prepustite izbiro OmniRoute.} _{📦 Skripti za hiter začetek za **Python, Node.js, PHP in cURL**, pripravljeni za kopiranje in lepljenje → [`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 (stiskanje RTK + Caveman, 19 strategij usmerjanja, odklopniki, prikrivanje TLS, MCP, A2A, zaščitne omejitve) lahko izvede preklop ob napaki med 4 ravnmi ponudnikov, dokler je na voljo primeren in delujoč cilj — 1. raven: naročnina, 2. raven: ključ API, 3. raven: poceni in 4. raven: brezplačno.

## 🤝 Podpirajo nas naši prijatelji odprte kode

> **Želite postati prijatelj odprte kode?** To so podjetja, ki podpirajo odprto kodo in pomagajo pri nadaljnjem razvoju 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 prijatelju odprte kode, za podporo temu projektu! Kimi je laboratorij za umetno inteligenco, ki stoji za družinama modelov K2 in K3 z odprtimi utežmi — Kimi K3 ponuja kontekstno okno z 1 milijonom žetonov, izvorno podporo za vid in vrhunske sposobnosti programiranja za delček cene zaprtih modelov, poleg tega pa že takoj deluje s Claude Code, Codex in vsemi programerskimi orodji, ki jih podpira OmniRoute.

Kaj omogoča Kimijeva podpora: Dobropisi za Kimijev API poganjajo cevovod za izdaje OmniRoute, preverjene z umetno inteligenco — stopnjo preverjanja združitev, ki jo poganja Kimi K3, v kateri je vsak zahtevek za vključitev pregledan pred izdajo — ter vsakodnevni razvoj funkcij. Prvorazredna podpora za Kimi je na voljo po obeh poteh: prek neposrednega vmesnika Kimi API (kimi-k3) in programerskega paketa Kimi Code (OAuth in ključ API). OmniRoute je tudi prvi brazilski odprtokodni projekt v Kimijevem programu podpore. Pridobite ključ za Kimi API s 15 % dodatnega dobroimetja →

Cheaper Inference
_{cheaperinference.com} Hvala podjetju Cheaper Inference, prijatelju odprte kode projekta OmniRoute, za podporo temu projektu! Cheaper Inference je prehod, ki ponudnike razvršča po stroških in preprodaja dostop do 42 vrhunskih 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 maloprodajne cene izdelovalca modela.

Prvorazredna podpora v OmniRoute: dokončevanje klepeta, 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 z oznako aff=omniroute so partnerske povezave. Financirajo projekt brez dodatnih stroškov za vas.}

_{🎟️ Promocije pridruženih ponudnikov — brezplačni kuponi ob registraciji pri ponudnikih, ki nas ne sponzorirajo (kliknite za razširitev)}

_{Ta razdelek je namenjen samo napotitvenim kodam in kodam kuponov. Sponzorirana partnerstva so navedena v zgornjem razdelku 🤝 Podpirajo nas naši prijatelji odprte kode. 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 USD brezplačnega dobroimetja ob registraciji (brezplačni strežnik, zato pričakujte večjo zakasnitev — najprimernejši je za preizkušanje, ne za produkcijo). Prvorazredna podpora v OmniRoute od različice v3.8.50: dokončevanje klepeta, ž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 druge. Prevzemite svojih 100 USD →}

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

_{Poznate drugega ponudnika z velikodušnim brezplačnim kuponom ob registraciji, ki bi koristil 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)}

## 🏆 Po čem OmniRoute izstopa

_{📊 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 ponudba brezplačne ravni ostaja **~1.51B žetonov/mesec** iz zgoraj dokumentiranega kataloga z odstranjenimi podvojitvami med skupnimi bazeni. Začasni dobropisi ob registraciji pri ponudnikih lahko prvi mesec ločeno povečajo na **~2.13B**. 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 3B žetonov/mesec**, odvisno od razpoložljivosti ponudnikov. Ta meja ni zajamčena: ponudniki lahko kadar koli spremenijo kvote, pogoje upravičenosti, modele ali regije. Radar je treba izrecno omogočiti in uporablja samo zahteve GET. Odjemalec OmniRoute ne nalaga pozivov, prometa, konfiguracije ponudnikov, telemetrije uporabe ali lokalnega stanja opuščenih obvestil. Več o upravičenosti in trenutnem katalogu je na voljo 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žljiva orodja CLI in agenti za programiranje > 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}	_{Agent Deck}

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

_{📖 Navodila za nastavitev vseh 36 orodij (26 orodij CLI za programiranje + 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, 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 # tudi: claude opencode qwen aider goose gemini cline continue kilo ``` Vsak ukaz upošteva aktivni oddaljeni kontekst (`omniroute connect `), `--dry-run` prikaže natančne spremenljivke okolja in argumente brez izvajanja, možnost `--api-key-env NAME` pa prepreči, da bi se skrivnosti zapisale v zgodovino lupine. → [Integracije CLI](docs/guides/CLI-INTEGRATIONS.md)

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

> **352 registriranih ponudnikov** v kanoničnih zbirkah za klepet, predstavnost, iskanje, lokalno izvajanje, 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 **446 vrstic za posamezne modele**, **38 ponavljajočih se kvot** in **53 ponudnikov z brezplačnim trajnim dostopom, ki se obnavlja oziroma ne zahteva ključa**. Imenovalci se namensko razlikujejo; definicije in izračuni z odstranjenimi podvojenimi kvotami so na voljo 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 še več kot 330 drugih — vsaka ikona se v živo naloži iz kataloga ponudnikov na nadzorni plošči. 📖 [Referenca ponudnikov](docs/reference/PROVIDER_REFERENCE.md)}
### 🆓 Brezplačno za vedno — 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 raven}	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 10 tisoč nevronov/dan}	NVIDIA NIM _{GLM, MiniMax ~40 RPM brezplačno}	Cerebras _{GLM 4.7, GPT-OSS 1 mio. ž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 uporabe `any` v jedru od v2.0)
Ogrodje	Next.js 16 + React 19 + Tailwind CSS 4
Podatkovna zbirka	better-sqlite3 (SQLite, beleženje WAL) + LowDB (podedovani JSON) — 122 domenskih modulov, 168 migracij
Pomnilnik	Polno besedilo SQLite FTS5 + vektorske vložitve, kvantizirane na int8, tipizirano pojemanje
Sheme	Zod 4 — preverjanje V/I orodij MCP + pogodbe API
Protokoli	MCP (stdio / HTTP / SSE) + A2A v0.3 (JSON-RPC 2.0 + SSE)
Pretočno pošiljanje	Server-Sent Events (SSE) + most WebSocket (`/v1/ws`)
Stiskanje	12-mehanizemski cevovod — RTK, Caveman, LLMLingua-2 (MobileBERT ONNX), GCF, OmniGlyph
Preverjanje pristnosti in varnost	OAuth 2.0 (PKCE) + JWT + ključi API + preverjanje pristnosti MCP z omejenim obsegom · AES-256-GCM za mirujoče podatke · DOMPurify
Prikritost	wreq-js — posnemanje prstnih odtisov TLS JA3 / JA4, 3-stopenjski posredniški strežnik
Odpornost	Odklopnik, eksponentno podaljševanje čakanja, preprečevanje navalnega učinka, samodejno samozdravljenje kombinacij
Beleženje	pino — strukturirani dnevniki JSON s kontekstom zahteve
Preizkušanje	Izvajalnik preizkusov Node.js + Vitest — 39.000+ statičnih deklaracij preizkusov v 5.100+ spremljanih preizkusnih datotekah (enotski, integracijski, E2E, varnostni, ekosistemski preizkusi)
Platforme	Namizje (Electron) · Android (Termux) · PWA (kateri koli brskalnik)
CI/CD	GitHub Actions — samodejna objava v npm in Docker Hub ob izdaji
Povezave	Spletno mesto · npm · Docker Hub

## 📖 Dokumentacija

### 📘 Prvi koraki

Dokument	Opis
Uporabniški priročnik	Ponudniki, kombinacije, integracija CLI-ja, 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, Copilot
Oddaljeni način	Upravljajte oddaljeni OmniRoute (VPS) iz CLI-ja na prenosniku z žetoni za dostop z omejenim obsegom
Konfiguracija Claude Code	Usmerite Claude Code na OmniRoute (lokalno/oddaljeno) z `launch` in profili za posamezne modele
Hitri začetek	Namestitev v 3 korakih → povezava → konfiguracija

### 🔧 Delovanje in uvajanje

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
Uvajanje navideznega stroja	Celovit priročnik: nastavitev navideznega stroja + nginx + Cloudflare
Uvajanje v Fly.io	Uvedite v Fly.io s trajno shrambo
Priročnik za Termux	Zaženite OmniRoute v Androidu 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 referenc

### 🧠 Funkcije in arhitektura

Dokument	Opis
Arhitektura	Arhitektura sistema, 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
Mehanizmi za stiskanje	Caveman, RTK, zloženi cevovodi, vmesniki nadzorne plošče/API-ja/MCP-ja
Oblika pravil stiskanja	Sheme paketov pravil JSON za filtra Caveman in RTK
Jezikovni paketi za stiskanje	Zaznavanje jezika in priprava paketov pravil Caveman
Priročnik za odpornost	Odklopniki, obdobja ohlajanja, čakalna vrsta, preprečevanje navalnega učinka, potvarjanje TLS
Mehanizem samodejnih kombinacij	16-faktorsko točkovanje, paketi načinov, samozdravljenje
Priročnik za posredniške strežnike	3-stopenjski sistem posredniških strežnikov, tržnica 1proxy, operacije CRUD registra
Brezplačne ravni	Združeni imenik: 38 dokumentiranih ponavljajočih se naborov / 446 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, odjemalci Python/TS/Go
Priročnik za strežnik MCP	Namestitev MCP-ja, prenosi in referenca orodij
Strežnik A2A	Protokol JSON-RPC 2.0, veščine, pretočno pošiljanje, upravljanje opravil
Priročnik za strežnik A2A	Kartica agenta A2A, opravila, veščine in pretočno pošiljanje

### 📋 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
Priročnik za i18n	Podpora za 42 jezikov, potek prevajanja, RTL
Kontrolni seznam za izdajo	Koraki preverjanja pred izdajo
Načrt pokritosti	Strategija pokritosti preizkusov za 39.000+ statičnih deklaracij preizkusov v 5.100+ spremljanih preizkusnih datotekah

# ⭐ Najpomembnejši sodelujoči > OmniRoute oblikuje zavzeta odprtokodna skupnost. Ti posamezniki so izjemno prispevali ter neposredno vplivali 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

_{Posneto na aktivnem vrhu release/v3.8.50 dafb4ae808, z združitvami do 2026-08-24 05:26:03 UTC. Oštevilčeni popis GitHub GraphQL vsebuje 5.911 združenih zahtev PR: 2.707 jih je prispeval lastnik repozitorija, 179 Dependabot in 3.025 zunanjih zahtev PR 535 različnih sodelujočih. »Spremenjene vrstice« so vsota dodatkov in izbrisov v GitHubu ter vključujejo ustvarjene datoteke, datoteke zaklepanja, kataloge, prevode in dokumentacijo; predstavljajo obseg sprememb, ne števila avtorskih vrstic kode. Izenačeni sodelujoči na meji so ohranjeni.} ### Potrditve, pripisane uporabnikom GitHuba

backryun _{🥇 220 potrditev, pripisanih uporabniku GitHuba}	Paijo _{🥈 219 potrditev, pripisanih uporabniku GitHuba}	Randi _{🥉 108 potrditev, pripisanih uporabniku GitHuba}	Ravi Tharuma _{🏅 81 potrditev, pripisanih uporabniku GitHuba}	Chris _{🏅 70 potrditev, pripisanih uporabniku GitHuba}	Markus Hartung _{🏅 69 potrditev, pripisanih uporabniku GitHuba · izenačeno na #6}
Dizzle _{🏅 69 potrditev, pripisanih uporabniku GitHuba · izenačeno na #6}	Jan Leon _{🏅 64 potrditev, pripisanih uporabniku GitHuba}	zenobit _{🏅 62 potrditev, pripisanih uporabniku GitHuba}	Bob.Hou _{🏅 51 potrditev, pripisanih uporabniku GitHuba · izenačeno na #10}	Xiangzhe _{🏅 51 potrditev, pripisanih uporabniku GitHuba · izenačeno na #10}

_{Ponovno preverjeno ob 2026-08-24 06:14:31 UTC: potrditve, pripisane uporabnikom GitHuba, kot jih je sporočil API sodelujočih repozitorija za privzeto vejo release/v3.8.50. 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 razvrstitve združenih zahtev PR kot od spodnjega popisa metapodatkov Git za 639 oseb.} > 🙏 Funkcije, popravki napak in izboljšave infrastrukture teh sodelujočih so **temeljni del** tega, zaradi česar je OmniRoute zanesljiv in bogat s funkcijami. Pomembna je vsaka zahteva za vključitev, vsak preizkusni primer in vsaka prevodna datoteka i18n. 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}

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}