# README (Hrvatski) 🌐 **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) · 🇭🇺 [hu](../hu/README.md) · 🇮🇩 [id](../id/README.md) · 🇮🇹 [it](../it/README.md) · 🇯🇵 [ja](../ja/README.md) · 🇰🇷 [ko](../ko/README.md) · 🇱🇹 [lt](../lt/README.md) · 🇱🇻 [lv](../lv/README.md) · 🇮🇳 [mr](../mr/README.md) · 🇲🇾 [ms](../ms/README.md) · 🇲🇹 [mt](../mt/README.md) · 🇳🇱 [nl](../nl/README.md) · 🇳🇴 [no](../no/README.md) · 🇵🇭 [phi](../phi/README.md) · 🇵🇱 [pl](../pl/README.md) · 🇵🇹 [pt](../pt/README.md) · 🇧🇷 [pt-BR](../pt-BR/README.md) · 🇷🇴 [ro](../ro/README.md) · 🇷🇺 [ru](../ru/README.md) · 🇸🇰 [sk](../sk/README.md) · 🇸🇮 [sl](../sl/README.md) · 🇷🇸 [sr](../sr/README.md) · 🇸🇪 [sv](../sv/README.md) · 🇰🇪 [sw](../sw/README.md) · 🇮🇳 [ta](../ta/README.md) · 🇮🇳 [te](../te/README.md) · 🇹🇭 [th](../th/README.md) · 🇹🇷 [tr](../tr/README.md) · 🇺🇦 [uk-UA](../uk-UA/README.md) · 🇵🇰 [ur](../ur/README.md) · 🇻🇳 [vi](../vi/README.md) · 🇨🇳 [zh-CN](../zh-CN/README.md) · 🇹🇼 [zh-TW](../zh-TW/README.md) ---

# 🚀 OmniRoute — Besplatni AI Gateway OmniRoute — Never stop coding. Every AI tool → 355 providers — 150+ free — through one endpoint. Claude Code, Codex, Cursor, Cline, Copilot & Antigravity into FREE Claude / GPT / Gemini with auto-fallback. RTK + Caveman stacked compression saves 15–95% tokens (~89% avg) — never hit limits. 355 AI providers · 150+ free tiers · ~1.51B free tokens/mo · 19 routing strategies · $0 to start.

OmniRoute — Never stop coding. Every AI tool → 355 providers — 150+ free — through one endpoint. Claude Code, Codex, Cursor, Cline, Copilot & Antigravity into FREE Claude / GPT / Gemini with auto-fallback. RTK + Caveman stacked compression saves 15–95% tokens (~89% avg) — never hit limits. 355 AI providers · 150+ free tiers · ~1.51B free tokens/mo · 19 routing strategies · $0 to start.

## 💰 ~1,51 milijardi besplatnih tokena / mjesečno

> Ručno slaganje besplatnih paketa je bolno — desetci SDK-ova, desetci ograničenja brzine, i nemate pojma koliko zapravo imate na raspolaganju. OmniRoute katalogizira **446 unosa besplatnih paketa u 38 ponavljajućih pool ključeva** i računa naslovni broj tokena iz **20 poolova s objavljenim pozitivnim mjesečnim budžetom**, deduplicirano po zajedničkom poolu. Rezultat ostaje vidljiv na dashboardu (`/dashboard/free-tiers`).

> Animirani sažetak žive stranice `/dashboard/free-tiers`. Potpuna metodologija (deduplikacija poolova, kreditni paketi, uvjeti pružatelja usluga): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**. > > _{Ovi podaci se ponovno provjeravaju svaka dva tjedna prema živom katalogu i **mijenjaju se u oba smjera** — pružatelj usluge ukine besplatni paket i broj pada; novi se pojavi i broj raste. Objavljujemo ono što katalog stvarno izračuna, nikad zaokruženi najbolji mogući scenarij.}

⭐ Zvjezdicom (star) označite repozitorij ako vam je OMNIROUTE pomogao uštedjeti novac i olakšati posao.

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

[![Star History Rank](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 zajednici **👋 Pratite održavatelja projekta — prvi saznajte za nove pružatelje usluga, izdanja i savjete:** [![Follow Diego on LinkedIn](https://img.shields.io/badge/Follow_Diego_on-LinkedIn-0A66C2?style=for-the-badge&logo=linkedin&logoColor=white)](https://www.linkedin.com/in/diegosouzapw/) [![Follow @diegosouzapw on GitHub](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 Global](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 Brasil](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) [![Website](https://img.shields.io/badge/Website-omniroute.online-blue?logo=google-chrome&logoColor=white)](https://omniroute.online) **Pitanja, savjeti o pružateljima usluga, plan razvoja i podrška → [Discord](https://discord.gg/U47eFqAXCn) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 Globalno](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) / [🇧🇷 Brazil](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) / [Portal](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK)**
## 📈 Gateway Neprestano Raste

| | v3.8.49 | **v3.8.50** | `v3.8.51+` | | --------------------------------- | :-----: | :-----------------------: | :-----------: | | 🌐 Provideri | 290 | **352** | još ih dolazi | | 🧠 Jedinstveni ID-ovi chat modela | 1185 | **1312** | — | | 🖼️ Modality Bridge | — | 🆕 vizija + audio + video | — | | 📡 Radar besplatni katalog | — | 🆕 opcionalno prijava | — | | ⚖️ Raspoređivanje svjesno kvota | — | 🆕 Quota-Share | — | | 📊 Telemetrija kvota | — | 🆕 uživo | — | **→ [Plan razvoja](ROADMAP.md) — put prema `v3.9.0 LTS`**

## 🧩 Dostupno [![npm version](https://img.shields.io/npm/v/omniroute?color=cb3837&logo=npm)](https://www.npmjs.com/package/omniroute) ![NPM Monthly](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) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](LICENSE) ![Docker Pulls](https://img.shields.io/docker/pulls/diegosouzapw/omniroute?label=docker%20pulls&logo=docker&color=2496ED) ![Electron Downloads](https://img.shields.io/github/downloads/diegosouzapw/omniroute/total?style=flat&label=electron%20downloads&logo=electron&color=47848F)

🚀 Početak	🚀 Brzi Početak	📦 Instalacija	🆓 Bez konfiguracije
💡 Naučite	💥 Obećanje	🤔 Zašto OmniRoute	🏆 Što Ga Izdvaja
⚙️ Značajke	🎯 Kombinacije	🌐 Provideri	🔌 CLI i MCP
	🗜️ Kompresija	🖥️ Gdje Radi	🔒 Privatnost
👀 Pogledajte	🎬 U Akciji	✨ Novosti	🤖 Kompatibilni CLI-jevi
💚 Podrška	💚 Podrška / Donacije	💬 Zajednica	💖 Sponzori
📦 Projekt	🛠️ Tehnologije	📖 Dokumentacija	👥 Suradnici

🌐 Na 44 jezika

## 🆓 Radi u trenutku instalacije — bez ključeva, bez konfiguracije

Radi u trenutku instalacije — nula konfiguracije. Tri koraka: 1. Instalacija — npm i -g omniroute, server se pokreće na localhost:20128. 2. Usmjerite svoj alat na http://localhost:20128/v1 — bilo koji alat kompatibilan s OpenAI-jem (Claude Code, Cursor, Cline). 3. Odgovara — pozovite model auto za trenutan odgovor, bez API ključa, bez registracije, bez konfiguracije. Pružatelj bez ključa OpenCode Free je unaprijed ožičen u auto kombinaciju, tako da nova instalacija odgovara odmah po pokretanju.

```bash # Nova instalacija, nula vjerodajnica — `auto` već radi: curl http://localhost:20128/v1/chat/completions \ -H "Content-Type: application/json" \ -d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}' ``` _{Preferirate određeni besplatni backend? Pozovite `oc/…` (OpenCode Free) direktno. Zatim prijeđite na `auto` i pustite OmniRoute da odabere.} _{📦 Skripte za brzi početak spremne za kopiranje-i-lijepljenje za **Python, Node.js, PHP i cURL** → [`examples/quickstart/`](examples/quickstart/)}

# 💥 Obećanje

# 🤔 Zašto OmniRoute?

Tok zahtjeva OmniRoute: vaš IDE ili CLI (Claude Code, Cursor, Cline…) poziva jednu lokalnu krajnju točku (http://localhost:20128/v1); OmniRoute Smart Router (RTK + Caveman kompresija, 19 strategija usmjeravanja, circuit breakeri, TLS stealth, MCP, A2A, guardrails) može prelaziti na rezervne opcije kroz 4 razine pružatelja dok postoji prihvatljiv zdrav cilj — Razina 1 Pretplata, Razina 2 API ključ, Razina 3 Jeftino i Razina 4 Besplatno.

## 🤝 Uz podršku naših Open Source prijatelja

> **Želite se pridružiti kao Open Source prijatelj?** To su tvrtke koje podržavaju otvoreni izvorni kod i pomažu da OmniRoute nastavi napredovati — i javno objavljujemo kamo ide svaki token koji nam daju. Javite se: [diegosouza.pw@outlook.com](mailto:diegosouza.pw@outlook.com)

Kimi
_{Moonshot AI} Hvala tvrtki Kimi (Moonshot AI), našem osnivačkom Open Source prijatelju, na podršci ovom projektu! Kimi je AI laboratorij iza obitelji modela otvorenih težina K2 i K3 — Kimi K3 donosi kontekstni prozor od 1M tokena, izvornu podršku za viziju i vrhunske mogućnosti programiranja po znatno nižoj cijeni od zatvorenih modela, te radi bez ikakvih dodatnih podešavanja s Claude Code, Codex i svim alatima za programiranje koje OmniRoute podržava.

Što pokreće Kimijeva podrška: Kimijevi API krediti pokreću OmniRouteov AI-validirani pipeline izdanja — fazu validacije spajanja pokrenutu Kimi K3 koja pregledava svaki pull request prije nego što se objavi — plus svakodnevni razvoj funkcionalnosti. Kimi podrška prve klase dostupna je na oba kanala: izravni Kimi API (kimi-k3) i Kimi Code plan za programiranje (OAuth i API ključ). OmniRoute je također prvi brazilski open-source projekt u Kimijevom programu podrške. Nabavite Kimi API ključ s 15% dodatnih kredita →

Cheaper Inference
_{cheaperinference.com} Hvala tvrtki Cheaper Inference, OmniRoute Open Source prijatelju, na podršci ovom projektu! Cheaper Inference je gateway rangiran po cijeni koji preprodaje 42 vrhunska modela — Claude, GPT-5.x, Gemini, Kimi K3, GLM, DeepSeek, Grok i MiniMax — iza jedne OpenAI-kompatibilne krajnje točke, usmjeravajući svaki zahtjev prema najjeftinijem prihvatljivom davatelju usluge, nikad ne naplaćujući iznad cijene s liste proizvođača modela.

Podrška prve klase u OmniRouteu: Chat Completions, izvorna /v1/responses krajnja točka, vizija, poziv alata i 3 modela za slike (grok-imagine, nano-banana-pro, nano-banana-2, dostupni kao cheaperinference/<model>). Nabavite API ključ →

_{Poveznice označene s aff=omniroute su partnerske poveznice. One financiraju projekt bez ikakvog dodatnog troška za vas.}

_{🎟️ Promocije partnera — besplatni kuponi za registraciju od davatelja usluga koje ne sponzoriramo (kliknite za proširivanje)}

_{Ovaj odjeljak je namijenjen samo za referalne/kuponske kodove. Sponzorirana partnerstva nalaze se u odjeljku 🤝 Uz podršku naših Open Source prijatelja iznad. OmniRoute nema sponzorstvo niti partnerstvo s davateljima usluga navedenima ovdje — ovo su javni kuponi koje svatko može koristiti.}

_AgentRouter
_{agentrouter.org} _{AgentRouter — partnerska registracija · 100 $ besplatnih kredita prilikom registracije (besplatni server, očekujte veću latenciju — najbolje za testiranje, ne za produkciju). Podrška prve klase u OmniRouteu od verzije v3.8.50: Chat Completions, Anthropic-kompatibilni format za razmjenu podataka i OpenAI-kompatibilni put. Dostupni modeli uključuju claude-opus-4-8, claude-opus-5, gpt-5.6-sol i druge. Preuzmite svojih 100 $ →}

_{⚠️ Partnerska poveznica — OmniRoute nema sponzorstvo niti partnerstvo s ovim davateljem usluge.}

_{Znate za drugog davatelja usluge s izdašnim besplatnim kuponom za registraciju koji koristi korisnicima OmniRoutea? Otvorite issue i mi ćemo ga dodati ovdje.}

## 🎯 Combosi — Zastavni brod

Svih 19 animiranih strategija usmjeravanja combo-a — jedna pločica po strategiji: 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. Pogledajte tablicu iznad za opis svake od njih.

> **Combo** je lanac modela kroz koje OmniRoute usmjerava **automatski**. Ako kvota istekne, davatelj usluge zapadne u kvar ili troškovi naglo skoče, combo se može prebaciti na sljedeći dostupan i ispravan model. 🛡️ ### ⚡ Bez podešavanja — jednostavno koristite `auto` Nema potrebe stvarati combo. Postavite svoj model na `auto` (ili neku varijantu) i OmniRoute će izgraditi virtualni combo od vaših povezanih davatelja usluga, uz ocjenjivanje u stvarnom vremenu:

ID modela	Za što je optimiziran
`auto`	🎯 Uravnoteženo zadano ponašanje (LKGP — ostaje uz vašeg posljednjeg dobrog davatelja usluge)
`auto/coding`	🧑💻 Ponderi usmjereni na kvalitetu za generiranje koda
`auto/fast`	⚡ Prvo najniža latencija
`auto/cheap`	💰 Prvo najjeftiniji po tokenu
`auto/offline`	🔋 Prvo najveća rezerva kvote / ograničenja brzine
`auto/smart`	🔭 Prioritet kvaliteti + 10% istraživanja za otkrivanje boljih modela
`auto/lkgp`	📌 Izričita privrženost posljednjem poznatom dobrom davatelju usluge
`auto/chaos`	🧪 Ponderi za ubrizgavanje kvarova radi testiranja otpornosti (chaos engineering)

## ### 🔀 Ili izgradite svoj vlastiti — 19 strategija usmjeravanja Svih **19** strategija — kombinirajte ih po volji za svaki korak combo-a:

#	Strategija	Što radi
1	`priority`	Popis uređen prema prvom cilju — iscrpi svaki prije prelaska na sljedeći 🥇
2	`fill-first`	Popuni kvotu svakog cilja u potpunosti prije prelaska dalje
3	`weighted`	Ponderirani nasumičan izbor prema pojedinačnoj težini cilja
4	`round-robin`	Redom prolazi kroz ciljeve
5	`p2c`	Nasumično uravnotežavanje opterećenja metodom "power-of-two-choices"
6	`least-used`	Odabire cilj s trenutno najmanjim opterećenjem
7	`random`	Jednoliko nasumičan izbor (bez dupliciranja)
8	`strict-random`	Nasumičan izbor bez uklanjanja ponavljanja 🎲
9	`cost-optimized`	Minimizira $ po zahtjevu prema cijenama iz aktualnog katalog 💸
10	`headroom`	Odabire cilj s najvećom preostalom kvotom
11	`reset-window`	Prioritet cilju čiji se prozor kvote najprije resetira
12	`reset-aware`	Rangiranje prema vremenu resetiranja kvote — kratki prozori prvi 📊
13	`context-relay`	Prosljeđuje kontekst između ciljeva za dugačke razgovore 🧠
14	`context-optimized`	Odabire najprikladniji cilj za trenutnu veličinu konteksta
15	`cache-optimized`	Fiksira svaki ponovno upotrebljivi prefiks upita na isti račun — maksimizira pogotke predmemorije upita 🎯
16	`lkgp`	Last-Known-Good Path — fiksira se na posljednjeg uspješnog davatelja usluge, a zatim pada na pravila
17	`auto`	Ocjenjivanje uživo prema 16 faktora za svaku vezu 🤖
18	`fusion`	Šalje upit skupu modela + sudac sintetizira jedan odgovor 🧬
19	`pipeline`	Lanac koraka — izlaz svakog cilja hrani sljedeći 🔗

_{Mehanizam Auto-Combo ocjenjuje svakog kandidata prema **16 faktora** (zdravstveni status, kvota, cijena, latencija, prikladnost za zadatak, kvaliteta, dostupnost sesije…) — pogledajte [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md).} ## ### 🧱 Otpornost je ugrađena (3 nezavisna sloja)

Otpornost OmniRoute — 3 nezavisna sloja koja se sama oporavljaju, pravi sloj za pravi kvar. Sloj 1 prekidač strujnog kruga davatelja usluge (cijeli davatelj usluge): aktivira se samo na 408/5xx, pragovi OAuth 8× / API ključ 12× / lokalno 2×, resetira se 60s/30s/15s u HALF-OPEN probu, lijeni oporavak; dok je OPEN, combo se preusmjerava na sljedećeg davatelja usluge. Sloj 2 hlađenje veze (jedan ključ/račun): osnova 5s OAuth / 3s API ključ, eksponencijalno ×2 povlačenje s zaštitom protiv 'thundering herd' učinka, 429 poštuje Retry-After, uspjeh briše sve stanje pogreške; jedan ključ koji se hladi biva zaobiđen dok susjedni ključevi nastavljaju posluživati. Sloj 3 zabrana modela (jedan model): 429 po modelu, lokalni 404 ili odbijanja moda zaključavaju samo taj model — nikad cijelu vezu. Terminalna stanja (zabranjen, istekao, kredit potrošen) su za operatora, a ne za hlađenje.

_{📖 [Auto-Combo Engine](docs/routing/AUTO-COMBO.md) · [Vodič za otpornost](docs/architecture/RESILIENCE_GUIDE.md)}

## 🏆 Što izdvaja OmniRoute

_{📊 Potpuna metodologija i detaljna usporedba po značajkama s 9router, OpenRouter, CLIProxyAPI i LiteLLM → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)}
## 💚 Podržite OmniRoute OmniRoute je licenciran pod MIT licencom i održava se otvoreno. Ako vam štedi vrijeme ili novac, evo kako ga možete pomoći da ostane neovisan — odaberite ono što vam odgovara. Sponzorstvo nikada ne utječe na prioritet usmjeravanja; kupuje vidljivost, a ne rang.

⭐ Dajte repozitoriju zvjezdicu	Besplatno — istinski pomaže vidljivosti	Star OmniRoute
🐙 GitHub Sponsors	Jednokratno ili mjesečno · bez naknade platforme	github.com/sponsors/diegosouzapw
☕ Ko-fi	Brzi jednokratni napojnica, bez potrebe za registracijom donatora	ko-fi.com/diegosouzapw
🧋 Buy Me a Coffee	Mali, neformalni gest	buymeacoffee.com/diegosouzapw
🖐 Liberapay	Redovito · neprofitno · otvoreni kod	liberapay.com/diegosouzapw
🇧🇷 PIX (Brazil)	Trenutno, bez naknada	ključ i QR ispod
₿ Kripto	BTC · ETH · USDT-TRC20 · USDC-Solana	adrese ispod

**🇧🇷 PIX** — trenutno, bez naknada (Brazil) OmniRoute PIX QR kod

Ključ (nasumičan): `5d865059-bc44-483a-962d-43ceb80126eb` Pix copia-e-cola: ``` 00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD ```

₿ Kripto — BTC · ETH · USDT-TRC20 · USDC-Solana (kliknite za proširenje)

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

_{⚠️ Svaki novčić šaljite samo na prikazanoj mreži — slanje na pogrešnu mrežu može uzrokovati gubitak sredstava.}

🐛 Pronašli ste bug ili imate povratnu informaciju? Otvorite [Discussion](https://github.com/diegosouzapw/OmniRoute/discussions).

Napomene za razvojne programere: Projekt može generirati lokalnu datoteku .env tijekom npm install/postinstall radi praktičnosti razvojnih programera. Ova datoteka je namjerno zanemarena putem .gitignore (pogledajte .gitignore) i nikada se ne smije predati (commit) — ako je slučajno predana, promijenite sve otkrivene tajne podatke i uklonite datoteku iz povijesti. Pogledajte docs/DEVELOPER-ENVIRONMENT.md za smjernice o upravljanju lokalnim datotekama okruženja i tajnim podacima.

## 📡 OmniRoute Radar Glavna ponuda u besplatnom paketu i dalje iznosi **~1,51 milijardu tokena/mjesec** iz gore navedenog dokumentiranog, deduplikiranog kataloga skupa. Privremeni krediti za prijavu kod pružatelja usluga mogu zasebno podići prvi mjesec na **~2,13 milijarde**. Radar je opcionalni, potpisani sloj preko kataloga za one koji žele svježiju dostupnost besplatnih modela između izdanja OmniRoute-a; zajednički katalog i sve postojeće besplatne značajke i dalje su besplatne. Podupiratelji mogu primati katalog u stvarnom vremenu i dodatne mogućnosti od pružatelja usluga. Njegov zaseban, promjenjiv gornji limit je **približno 3 milijarde tokena/mjesec, najviše**, ovisno o dostupnosti pružatelja usluga. Ta granica nije garancija: pružatelji usluga mogu u bilo kojem trenutku promijeniti kvote, uvjete prihvatljivosti, modele ili regije. Radar je opcionalan i koristi samo GET zahtjeve. OmniRoute klijent ne šalje upite (prompts), promet, konfiguraciju pružatelja usluga, telemetriju korištenja ni lokalno stanje odbačenih obavijesti. Saznajte više o uvjetima prihvatljivosti i trenutnom katalogu na **[radar.omniroute.online/planos](https://radar.omniroute.online/planos)**.

## ✨ Što je novo

> Nedavne istaknute promjene iz **v3.8.20 → v3.8.50**. Potpuna povijest u [`CHANGELOG.md`](CHANGELOG.md). - **🎛️ OmniConductor** — dolazna A2A delegacija vašoj floti agenata, Conductor vještine na Agent Card kartici, te dashboard panel s Faro push-to-talk glasovnim chatom. → [A2A Server](docs/frameworks/A2A-SERVER.md) - **🛂 Adaptivno prihvaćanje i zaštita od preopterećenja** — zahtjevni chat zahtjevi se stavljaju u red čekanja umjesto vraćanja 503 pogreške, uz atomske rotirajuće RPM zakupe po vezi. → [Vodič o otpornosti](docs/architecture/RESILIENCE_GUIDE.md) - **🗂️ Kanonsko `/v1/models` sortiranje** — jedan neprekinuti blok grupiran po pružatelju usluga za svakog pružatelja (kombinacije su prve prikvačene), stabilno kroz svaki izvor kataloga. → [API referenca](docs/reference/API_REFERENCE.md) - **🗜️ Poboljšana kompresija** — zaštita od inflacije uključena po zadanim postavkama, Caveman paketi za DE / FR / JA + kineski (wényán), RTK filtri za Gradle i .NET. → [Kompresija](docs/compression/COMPRESSION_ENGINES.md) - **💸 Iskrena fiksna cijena** — pružatelji usluga s pretplatom / planom za programiranje prikazuju **$0** u analitici troškova; budžet, kvota i usmjeravanje i dalje procjenjuju troškove. → [API referenca](docs/reference/API_REFERENCE.md) - **⚖️ Quota-Share usmjeravanje** — pravedno raspoređuje kvotu zajedničkog računa na skup ključeva, uz radno-konzervirajući princip po kojem se neiskorišteni dijelovi posuđuju drugima. → [Vodič o otpornosti](docs/architecture/RESILIENCE_GUIDE.md) - **🤖 Postavljanje CLI-a/agenta jednom naredbom** — 13 registriranih `setup-*` naredbi; `omniroute run` pokreće 7 CLI alata (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); `omniroute configure` podržava 10 ciljeva s interaktivnim odabirom pružatelja usluga i modela te favoritima po kontekstu. → [CLI integracije](docs/guides/CLI-INTEGRATIONS.md) - **🛰️ Udaljeni način rada** — upravljajte udaljenim OmniRoute-om putem tokena s ograničenim opsegom (`connect` / `contexts` / `tokens`) + `antigravity` OAuth pomoćnik za VPS instalacije. → [Udaljeni način rada](docs/guides/REMOTE-MODE.md) - **🧭 Pametnije automatsko usmjeravanje** — `auto/:` kombinacije, **Fusion** (panel modela + sudac), usmjeravanje ovisno o zadatku, prilagodbe modela / načina rada / USD budžeta po zahtjevu. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🗜️ Modularna kompresija** — 12 kombinirajućih mehanizama + Compression Studios: LLMLingua-2, dvorazinski Ultra, omniglyph, kontrolni prolaz vjernosti po koraku, GCF v3.2, uređivač s povlačenjem i ponovnim redoslijedom. → [Kompresija](docs/compression/COMPRESSION_ENGINES.md) - **🕵️ Transparentno MITM dekriptiranje (TPROXY)** — hvatanje CLI alata koji ignoriraju varijable okoline za proxy, uz CA po SNI-u i instalater za pohranu povjerenja. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md) - **💸 Telemetrija troškova posvuda** — zaglavlja `X-OmniRoute-*` za trošak/korištenje na svakom endpointu, zaglavlje ušteda za cache-HIT, USD kvote potrošnje po ključu. → [API referenca](docs/reference/API_REFERENCE.md) - **🧠 Memorija koju vi kontrolirate** — isključena po zadanim postavkama, opcionalna int8 vektorska kvantizacija + tipizirano opadanje, `x-omniroute-no-memory` po zahtjevu. → [Memorija](docs/frameworks/MEMORY.md) - **🛡️ Sigurnost** — zaštita od prompt-injekcije na svakoj LLM ruti (red-team paket), opcionalna zaštita maskiranja vjerodajnica (skriva otkrivene API ključeve/tajne u oba smjera), besplatna DuckDuckGo pretraga weba kao krajnja opcija, i opcionalni OIDC prijavni sustav za dashboard (prijava lozinkom uvijek ostaje dostupna). → [Sigurnosne mjere](docs/security/GUARDRAILS.md) - **🖼️ Novi endpointi** — `/v1/ocr` (Mistral OCR) i `/v1/audio/translations` (Whisper stil) proširuju mogućnosti obrade medija. → [API referenca](docs/reference/API_REFERENCE.md) - **🎨 Generiranje slika / videa / audia** — jedan API za medije: xAI Grok Imagine i Novita AI video, ComfyUI, Magnific, Adobe Firefly, Segmind, te pružatelji govora kao ElevenLabs. → [API referenca](docs/reference/API_REFERENCE.md) - **🌍 Postavljanje i operacije** — reverse-proxy `basePath`, automatsko prepoznavanje jezika preglednika, praćenje uređaja po ključu, MITM povjerenje bez root pristupa, zh-TW lokalizacija. → [Okolina](docs/reference/ENVIRONMENT.md) - **🤝 Više pružatelja usluga i agenata** — cloud agenti (Codex Cloud, Cursor, Devin, Jules), Grok Build (xAI) s prijavom putem preglednika i OAuth-a, Ollama kao potpuno integriran alat, Claude Opus 5 i Sonnet 5, službeno partnerstvo s Kimi (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… i osvježeni **katalog s 352 pružatelja usluga**. → [Pružatelji usluga](docs/reference/PROVIDER_REFERENCE.md) - **📡 Transparentnost usmjeravanja** — svaki odgovor nosi zaglavlje `X-OmniRoute-Decision` koje navodi strategiju/pružatelja usluga/latenciju koja je poslužila zahtjev, nova `cache-optimized` strategija kombinacija + Auto-Combo faktor `cacheAffinity` usmjerava ponovljene zahtjeve nazad na vezu koja sadrži predmemorirani prefiks, a read-only endpoint `/v1/auto-combo/{channel}/candidates` prikazuje aktivni skup kandidata za `auto/*` kanal. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **⚡ Lokalne performanse i infrastruktura** — lokalni Redis jednim klikom, alati za implementaciju na Cloudflare Workers / Deno Deploy relay, Bifrost i Mux kao nadzirane ugrađene usluge. → [Ugrađene usluge](docs/frameworks/EMBEDDED-SERVICES.md) - **🧩 Također u paketu** — okvir za dodatke (plugin framework) i tržnica, Omni/Agent/GitHub okviri vještina, integracija s Obsidian trezorom (22 MCP alata), OpenAI-kompatibilni Batch i Files API-jevi, semantička predmemorija odgovora, gamifikacija s ljestvicama najboljih, ACP otkrivanje agenata (15 ugrađenih agenata), planirani izvoz zapisa u BigQuery, `auto/chaos` ubrizgavanje kvarova, Telegram bot most, upravitelj verzija u aplikaciji te LMArena-ELO rangiranja besplatnih pružatelja usluga. → [Dokumentacija](docs/README.md)

## 🤖 Kompatibilni CLI-jevi i agenti za kodiranje > Jedna konfiguracija — `http://localhost:20128/v1` — i **svaki** AI IDE ili CLI radi na besplatnim i jeftinim modelima.

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

＋ također radi s · Kiro · Command Code · Antigravity · Windsurf · AMP · bilo kojim OpenAI-kompatibilnim alatom

_{📖 Postavljanje po alatu za svih 36 alata (26 CLI Code-ova + 10 CLI agenata) → [`docs/reference/CLI-TOOLS.md`](docs/reference/CLI-TOOLS.md) · 🧩 OpenCode dodatak → [`@omniroute/opencode-provider`](https://www.npmjs.com/package/@omniroute/opencode-provider)}

**Pokrenite bilo koji podržani CLI kroz OmniRoute jednom naredbom** — bez pisanja konfiguracijskih datoteka, vjerodajnice se ubacuju po procesu, Qwen/Gemini dobivaju jednokratni izolirani home direktorij: ```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" # Ili interaktivno odaberite pružatelja usluge i model te zapišite konfiguraciju samog alata: omniroute configure codex # također: claude opencode qwen aider goose gemini cline continue kilo ``` Svaka naredba poštuje aktivni udaljeni kontekst (`omniroute connect `), `--dry-run` prikazuje pregled točnog env/args bez izvršavanja, a `--api-key-env NAME` čuva tajne podatke izvan povijesti vaše ljuske (shell). → [CLI integracije](docs/guides/CLI-INTEGRATIONS.md)

## 🌐 352 AI davatelja usluga — 152 označena u katalogu kao besplatna

> **352 registrirana davatelja usluga** kroz kanonske kolekcije za chat, medije, pretraživanje, lokalne, cloud-agent i sustavske kolekcije, uključujući **152 koja nose metapodatke za otkrivanje `hasFree: true`**. Registar chat modela obuhvaća **229 davatelja usluga / 2.554 različita para davatelj-model / 1.283 sirova ID-a modela**; zaseban katalog besplatnih proračuna sadrži **446 redaka po modelu**, **38 ponavljajućih poolova** i **53 ponavljajuća/beskeyna besplatna davatelja usluga za stalno**. Ovo su namjerno različiti nazivnici; definicije i izračuni deduplicirani po poolovima nalaze se u [Referenci davatelja usluga](docs/reference/PROVIDER_REFERENCE.md) i [Besplatnim razinama](docs/reference/FREE_TIERS.md).

### 🏢 Svaki veći laboratorij — kroz jedan endpoint

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

_{…i još 330+ — svaka ikona se učitava uživo iz kataloga davatelja usluga na nadzornoj ploči. 📖 [Referenca davatelja usluga](docs/reference/PROVIDER_REFERENCE.md)}
### 🆓 Besplatno za stalno — 0 €, bez kartice

OpenCode Zen _{DeepSeek V4, Nemotron 3 Bez ograničenja tokena}	Kilo Code _{Auto-usmjerivač, Tencent Hy3 Besplatno za stalno}	Requesty _{GPT-OSS 120B, Nemotron Besplatno za stalno}	SiliconFlow _{DeepSeek V3.2 / R1 Besplatna razina}	Z.AI GLM _{GLM-4.7 / 4.5-Flash Besplatno za stalno}	Baidu ERNIE _{ERNIE 4.0 Besplatno za stalno}
Qoder AI _{Qwen3-Max, Kimi-K2 Neograničeno BESPLATNO}	Pollinations _{GPT, Llama, Claude Ključ nije potreban}	Cloudflare AI _{50+ modela 10K neurona/dan}	NVIDIA NIM _{GLM, MiniMax ~40 RPM besplatno}	Cerebras _{GLM 4.7, GPT-OSS 1M tokena/dan}	OpenRouter _{:free modeli +10 $ → veći RPM}

📖 Potpuni katalog u strojno čitljivom obliku → [`docs/reference/PROVIDER_REFERENCE.md`](docs/reference/PROVIDER_REFERENCE.md)

## 🖥️ Gdje OmniRoute radi — Bilo gdje

> Ista aplikacija, vaš uređaj, vaša pravila. Od globalne npm instalacije do **vašeg telefona** putem Termuxa.

Platforma	Instalacija	Istaknuto
📦 npm (globalno)	`npm install -g omniroute`	Jedna naredba, bilo koji OS
🐳 Docker	`docker run … diegosouzapw/omniroute`	Multi-arch AMD64 + ARM64
🖥️ Desktop (Electron)	`npm run electron:build`	Nativni prozor + sistemska traka — Windows / macOS / Linux
💪 ARM	nativno `arm64`	Raspberry Pi, ARM serveri, Apple Silicon
📱 Android (Termux)	`pkg install nodejs && npx -y omniroute`	Radi na vašem telefonu, 24/7, bez root pristupa
📲 PWA	"Dodaj na početni zaslon"	Cijeli zaslon, offline, instalira se iz preglednika
🧩 OpenCode dodatak	`@omniroute/opencode-provider`	Nativna OpenCode integracija
🤖 VS Code Copilot Chat	instalirajte proširenje OmniCopilot	Svaki OmniRoute model u nativnom Copilot Chat izborniku — stabilna verzija & Insiders
🛠️ Iz izvornog koda	`npm install && npm run dev`	Isprobajte, doprinesite

_{📖 [Docker vodič](docs/guides/DOCKER_GUIDE.md) · [Desktop](electron/README.md) · [Termux](docs/guides/TERMUX_GUIDE.md) · [PWA](docs/guides/PWA_GUIDE.md) · [OpenCode](docs/frameworks/OPENCODE.md)}

### 🧩 Novo: OmniRoute unutar VS Code-ovog nativnog Copilot Chata

> Nema nove bočne trake, nema novog chat sučelja — svaki model koji OmniRoute poslužuje pojavljuje se > izravno u **Copilot Chat izborniku modela koji već koristite**. Od VS Code 1.122, provider modeli > radi bez GitHub prijave ili Copilot pretplate — agent mode, tool calling i vision, > besplatno. Instalirajte proširenje **[OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)**, usmjerite ga na vaš OmniRoute server (zadano `localhost:20128`), zatim otvorite Copilot Chat → izbornik modela → **Manage Models…** → **OmniRoute**.

Trgovina	Poveznica	Radi s
🧩 VS Code Marketplace	Instaliraj →	VS Code — stabilna verzija & Insiders
🔓 Open VSX Registry	Instaliraj →	Cursor, Windsurf, VSCodium, Theia, code-server, Gitpod, Antigravity, Kiro…

Unutar editora: otvorite prikaz **Extensions**, pretražite **"OmniRoute"**, kliknite **Install** — radi na isti način u obje trgovine. Izvorni kod, prijave problema i vodič za objavljivanje nalaze se na [diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot). _{📖 [Vodič za VS Code Copilot Chat](docs/guides/VSCODE-COPILOT.md) — postavljanje, što izbornik prikazuje, nadzorna ploča u kartici, rješavanje problema}

## 🔒 Privatno i lokalno prvo

_{📖 [Ovlaštenje](docs/architecture/AUTHZ_GUIDE.md) · [Zaštitne ograde](docs/security/GUARDRAILS.md) · [Usklađenost](docs/security/COMPLIANCE.md)}

## 🔌 Potpuni CLI + A2A i MCP

> Osim servera, OmniRoute je **potpuna komandna kontrolna ploča** sa **80+ naredbi**, plus otvoreni agentski protokoli tako da AI agent može upravljati njime **samostalno**. ### ⌨️ Prava CLI alatka (ne samo `start`) ```bash omniroute # pokreće gateway + nadzornu ploču (port 20128) omniroute chat # interaktivni TUI chat klijent (kose crte: /model /combo /skill /memory) omniroute setup # vođeni čarobnjak za prvo pokretanje omniroute doctor # dijagnostika pružatelja, portova, izvornih ovisnosti (native deps) ``` ### 🛰️ Udaljeni način rada — pokrenite CLI ovdje, OmniRoute na VPS-u OmniRoute na serveru? Upravljajte njime s prijenosnog računala istim CLI-em. Prijavite se jednom pomoću opsegovanog pristupnog tokena; svaka sljedeća naredba tada cilja na udaljeni server. ```bash omniroute connect 192.168.0.15 # lozinka → opsegovani token, spremljen kao kontekst omniroute models list # ← pokreće se na UDALJENOM serveru omniroute configure codex # ← bira udaljeni model, piše lokalni Codex profil omniroute tokens create --name ci --scope read # generira uže opsegovane tokene za druge uređaje omniroute contexts use default # ← vraća se na lokalni server ``` Tokeni imaju opsege `read` / `write` / `admin`; rute koje pokreću procese ostaju ograničene samo na loopback. _{📖 [Udaljeni način rada](docs/guides/REMOTE-MODE.md)}

Animirani terminal koji demonstrira OmniRoute CLI — omniroute providers list, omniroute combo list i omniroute health — kroz prikaz površine od 86 naredbi na najvišoj razini: 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 — i on preuzima kontrolu nad samim OmniRoute-om Izložite OmniRoute putem **MCP**, **A2A**, **REST API**, **webhook**-ova ili **udaljenog CLI**-a — bilo koji sposoban agent (ili vaš vlastiti kod) dobiva ključeve cijelog gatewaya: usmjeravanje (routing), pružatelje, kombinacije, predmemoriju, kompresiju, memoriju — autonomno. Niže navedene HTTP krajnje točke poslužuju se na `http://localhost:20128`.

Sučelje	Krajnja točka / naredba	Koristi se za
🧰 MCP (stdio)	`omniroute --mcp`	Priključivanje na Claude Desktop, Cursor, bilo koji MCP klijent
🌊 MCP (HTTP)	`/api/mcp/stream`	Udaljeni MCP — 110 alata, 33 opsega (provedba opcionalna), potpuni trag revizije
📡 MCP (SSE)	`/api/mcp/sse`	MCP transport sa streamingom
🤝 A2A	`/.well-known/agent.json`	Komunikacija između agenata, JSON-RPC 2.0 + SSE, 6 vještina
🌐 REST API	`/v1/*`	Kompatibilan s OpenAI-em — chat, embeddingi, slike, audio, OCR
🔔 Webhookovi	`/api/webhooks`	Slanje događaja zahtjeva / kvota na Slack, Discord, Telegram ili bilo koji URL
🛰️ Udaljeni CLI	`omniroute connect`	Upravljanje udaljenom instancom pomoću opsegovanih pristupnih tokena

```bash # Dajte Claude Code cijeli OmniRoute skup alata putem MCP-a: claude mcp add-server omniroute --type http --url http://localhost:20128/api/mcp/stream ``` _{📖 [MCP server](docs/frameworks/MCP-SERVER.md) · [A2A server](docs/frameworks/A2A-SERVER.md) · [Vodič za agentske protokole](docs/frameworks/AGENT_PROTOCOLS_GUIDE.md)}

## 🗜️ Uštedite 15–95% tokena — automatski

### 📖 Kako radi — pipeline, arhitektura i matematika ušteda

OmniRoute pipeline za kompresiju: ilustrativni klijentski zahtjev od 10.000 tokena prolazi kroz 12 kompozitnih modula — Session-Dedup, CCR, Lite, RTK, Responses Tool Output, Headroom, Relevance, Caveman, Aggressive, LLMLingua-2, Ultra i OmniGlyph — i može doseći providera na oko 1.080 tokena u dokumentiranom slaganom primjeru. Strukturirani sadržaj štite mehanizmi za očuvanje i vrata vjernosti po koraku; eksplicitni lossy ili eksperimentalni modovi mogu transformirati prihvatljivi sadržaj.

Zadana slagana kombinacija pokreće `RTK → Caveman`. Kada oba djeluju na isti payload alata/konteksta, uštede se kombiniraju: ```txt combined = 1 − (1 − RTK) × (1 − Caveman_input) average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2% range = 78.4 – 94.6% ``` Blokovi kôda, URL-ovi, JSON i strukturirani podaci **su uvijek zaštićeni** mehanizmom za očuvanje. > **Zašto koristiti mnogo tokena kada nekoliko tokena obavi posao?** Svaki zahtjev prolazi kroz OmniRoute-ov pipeline za kompresiju **transparentno** — bez izmjena na strani klijenta. Sada je to **stog od 12 kompozitnih modula** koji se izvršavaju redom i mogu se mix & match po kombinaciji rutiranja — nadograđujući ideje iz [RTK](https://github.com/rtk-ai/rtk), [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ 90K+), [LLMLingua-2](https://github.com/microsoft/LLMLingua) i [Troglodita](https://github.com/leninejunior/troglodita) (PT-BR). ### 🧱 Stog od 12 modula Moduli se izvršavaju u redoslijedu pipeline-a; svaki se može zasebno uključiti/isključiti i konfigurirati po kombinaciji:

#	Modul	Što radi
1	Session-Dedup	Uklanja sadržaj koji se ponavlja kroz ture (adresirano po sadržaju, kroz ture)
2	CCR	Arhivira velike blokove iza markera za dohvat, dohvaćaju se po potrebi
3	Lite	Skraćivanje razmaka + URL-ova slika (osnovni sloj s malom latencijom)
4	RTK	Pametno filtriranje rezultata alata, dedup i skraćivanje (svjesno naredbi)
5	Responses Tool Output	Bezgubna JSON kompresija po prioritetu + ograničena dijagnostička kompresija za shell/patch/search/build izlaze (Responses API)
6	Headroom	Bezgubna tabularna kompakcija JSON polja (~30%) putem ugrađenog GCF kodeka
7	Relevance	Ekstraktivno bodovanje rečenica u odnosu na posljednji korisnički upit
8	Caveman	Kompresija proze temeljena na pravilima (~65–75% na izlazu)
9	Aggressive	Sažimanje + progresivno "starenje" starih tura
10	LLMLingua-2	ML semantičko obrezivanje putem MobileBERT ONNX — sigurno za kôd, asinkrono
11	Ultra	Heurističko obrezivanje tokena s opcionalnim malim modelom (SLM) razinom
12	OmniGlyph	Eksperimentalno kodiranje konteksta-kao-slike, mjereno na Claude Fable 5 preko direktne Anthropic veze; GPT 5.6 transformeri ostaju fail-closed do potvrde providera. Četiri profila kompresije (agresivan zadani, uravnotežen, sigurno za kodiranje, passthrough) (najagresivnije; opcionalno)

Blokovi kôda, URL-ovi i strukturirani podaci **uvijek se čuvaju** byte-precizno. **Prijednamještaji jednim klikom** kombiniraju module:

Mod	Ušteda	Najbolje za
🪶 Lite	~15%	Sigurna zadana postavka, uvijek uključena
🪨 Standard (Caveman)	~30%	Svakodnevno programiranje
⚡ Aggressive	~50%	Duge sesije intenzivne uporabe alata
🔥 Ultra	~75%	Maksimalna ušteda
🧰 RTK	60–90%	Shell/test/build/git izlaz
🔗 Stacked (RTK → Caveman)	78–95%	Mješoviti promptovi + logovi alata

**Stvarni primjer — Standard mod:** > **Prije (69 tokena):** _"The reason your React component is re-rendering is likely because you're creating a new object reference on each render cycle. When you pass an inline object as a prop, React's shallow comparison sees it as a different object every time, which triggers a re-render. I would recommend using useMemo to memoize the object."_ > > **Nakon (19 tokena):** _"New object ref each render. Inline object prop = new ref = re-render. Wrap in useMemo."_ > > **Isti odgovor. 72% manje tokena. Nula gubitka točnosti.** ✅ **PT-BR primjer — [Troglodita](https://github.com/leninejunior/troglodita) mod:** > **Antes (42 tokena):** _"O problema é que o componente está re-renderizando porque uma nova referência de objeto está sendo criada em cada ciclo de renderização. Eu recomendaria usar useMemo."_ > > **Depois (12 tokena):** _"Re-render: ref nova cada ciclo (objeto inline recriado). Usar `useMemo`."_ > > **Mesma resposta. ~70% menos tokens. Precisão técnica intacta.** ✅
### 🎚️ Iza modula — izlazni stilovi, adaptivna skala i kontrola po zahtjevu 12 modula iznad smanjuju ono što ulazi **u** sustav. Još tri sloja oblikuju **kako**, **kada** i što izlazi **iz** njega: - **🪄 Izlazni stilovi** _(oblikovanje na izlaznoj osi)_ — ubacuju deterministične, cache-safe upute za oblikovanje odgovora; kombinirajuće, svaka na intenzitetu `lite` / `full` / `ultra`. Dodavanje stila je unos u registar od jedne linije: - **Sažeta proza** — izbacuje suvišne riječi / članove / oklijevajuće izraze; tehnička srž ostaje netaknuta. - **Manje kôda** — "lijeni senior developer" YAGNI pristup: najmanja radna izmjena, bez nezatraženog skeletnog kôda. - **Ponytail (lijeni senior developer)** — penje se uz YAGNI ljestvicu, rješava temeljni uzrok, najmanja radna razlika. - **Imam ADHD (akcija na prvom mjestu)** — sljedeća akcija je na čelu, koraci numerirani, jedan konkretan sljedeći korak, bez uvoda. - **Sažeti CJK (文言)** — ultra-sažeti stil klasičnog kineskog (ograničen na lokal `zh`). - **🎯 Adaptivni proračun konteksta** _(skala)_ — umjesto jednog uklj./isklj. praga tokena, postupno se aktiviraju najjeftiniji, najviše bezgubni moduli samo do te mjere koliko je potrebno da se sadržaj **uklopi u kontekstualni prozor modela**. Politika: `reserve-output` (zadano, svjesno modela) · `percentage` · `absolute`. Mod: `floor` (osigurava uklapanje) · `replace-autotrigger` (vaš eksplicitni izbor pobjeđuje) · `off` (naslijeđeni prag). - **🎛️ Gdje se odlučuje o kompresiji** _(prioritet, viši → niži)_ — zaglavlje `x-omniroute-compression` po zahtjevu › nadglašavanje kombinacije rutiranja › aktivni imenovani profil › adaptivni / auto-trigger › zadana postavka panela › isključeno. Primijenjeni plan se odražava u zaglavlju odgovora `X-OmniRoute-Compression: ; source=`. Auto-trigger prema pragu tokena, uključite adaptivnu skalu, prikvačite imenovani profil, postavite jednokratnu opciju po zahtjevu ili dodijelite pipeline po kombinaciji rutiranja — što god odgovara opterećenju. Opcionalna offline **evaluacijska infrastruktura** (`npm run eval:compression`) bodovanjem procjenjuje vjernost u odnosu na uštedu na fiksiranom korpusu prije nego promovirate promjenu. 📖 [`COMPRESSION_GUIDE.md`](docs/compression/COMPRESSION_GUIDE.md) · [`RTK_COMPRESSION.md`](docs/compression/RTK_COMPRESSION.md) · [`COMPRESSION_ENGINES.md`](docs/compression/COMPRESSION_ENGINES.md)

# ⚡ Brzi početak

**1) Instalirajte i pokrenite** ```bash npm install -g omniroute omniroute ``` > 💡 Vidite `npm warn ERESOLVE` ili upozorenja o peer ovisnostima? [Bezopasna su](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated). Nadzorna ploča na `http://localhost:20128` · API na `http://localhost:20128/v1`. **2) Povežite BESPLATNOG providera (bez registracije)** Nadzorna ploča → **Providers** → povežite **Kiro AI** (besplatni Claude, ~50 kredita/mjesec po računu) ili **OpenCode Free** (bez autentifikacije) → gotovo. **3) Usmjerite svoj alat za kodiranje** ```txt Base URL: http://localhost:20128/v1 API Key: [kopirajte iz Dashboard → Endpoints] Model: auto (rutiranje bez konfiguracije — ili bilo koji provider/model) ``` **4) Provjerite radi li** ```bash curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY" ``` Trebali biste vidjeti popis svojih povezanih modela. 🎉 To je to — počnite programirati, a OmniRoute će automatski rutirati i preusmjeravati zahtjeve za vas. Ako vaš klijent ne može slati prilagođena zaglavlja, OmniRoute također izlaže tokenizirane alias-e za kompatibilnost: ```txt OpenAI catalog: http://localhost:20128/vscode/YOUR_KEY/ OpenAI models: http://localhost:20128/vscode/YOUR_KEY/models OpenAI chat: http://localhost:20128/vscode/YOUR_KEY/chat/completions OpenAI responses: http://localhost:20128/vscode/YOUR_KEY/responses Ollama chat: http://localhost:20128/vscode/YOUR_KEY/api/chat Ollama tags: http://localhost:20128/vscode/YOUR_KEY/api/tags ``` Koristite ove opcije samo za klijente koji ne mogu prikvačiti `Authorization: Bearer ...`. Autentifikacija putem zaglavlja ostaje preferirani mod.
## 📦 Više metoda instalacije — Docker, izvorni kod, 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` prati najnoviju **objavljenu** stabilnu SemVer verziju. Ne prati git `main`. Za GitOps koristite fiksnu verziju `:X.Y.Z`. Pogledajte [Docker Release Channels](docs/guides/DOCKER_GUIDE.md#release-channels). Slika ima fiksiranu vrijednost **`OMNIROUTE_MEMORY_MB=1024`**. To je dovoljno za nadzornu ploču i lagani chat. **Agenti za kodiranje** (`POST /v1/responses` iz Claude Code, Codex, Grok, …) trebaju znatno veći V8 heap, jer inače proces baca `FATAL ERROR` pri ~12 GiB kod dva preklapajuća dugačka konteksta. Kontejner postavite iznad veličine heapa (nativni bufferi se nalaze izvan V8): | Radno opterećenje | Heap (`-e OMNIROUTE_MEMORY_MB`) | Kontejner (`--memory`) | | --------------------------------------- | ------------------------------- | ---------------------- | | Nadzorna ploča / lagani chat | `1024` (zadano u slici) | ≥2 g | | Jedan agent za kodiranje | `8192` | ≥10 g | | Dva istovremena dugačka `/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 ``` Cijela tablica: [Docker Guide — runtime RAM](docs/guides/DOCKER_GUIDE.md#runtime-ram-for-coding-agents). > **Pre-release Docker kanal:** `diegosouzapw/omniroute:next` i > `diegosouzapw/omniroute:next-web` prate trenutnu zadanu granu > `release/v*`. Ove promjenjive oznake namijenjene su isključivo testiranju neobjavljenih > ispravaka i **nisu podržane za produkciju**. Pogledajte > [Docker Release Channels](docs/guides/DOCKER_GUIDE.md#release-channels). **🥟 Bun** Standardna `bun install` i globalna instalacija (`bun install -g omniroute`) podržane su putem detekcije Bun runtime-a: - **Ugrađeni `bun:sqlite`**: OmniRoute koristi ugrađeni Bun-ov `bun:sqlite` driver kada se pokreće pod Bun-om, s povratkom na `better-sqlite3` na Node.js ili `sql.js`. - **Automatski odabir Webpack bundlera u dev okruženju**: Razvojni način (`bun run dev`) automatski detektira Bun i isključuje Turbopack u korist Webpacka radi izbjegavanja nekompatibilnosti nativnih V8 povezivanja (bindings). Produkcijske izgradnje (`bun run build`) slijede `OMNIROUTE_USE_TURBOPACK` potpuno isto kao na Node-u: Turbopack je zadan, a `OMNIROUTE_USE_TURBOPACK=0` gradi s Webpackom (`Dockerfile.bun` to izlaže kao `--build-arg`). - **Namjenska Bun Dockerfile datoteka**: Višestupanjski `Dockerfile.bun` za nativna Bun produkcijska postavljanja (`docker build -f Dockerfile.bun -t omniroute:bun .`). ```bash # Instalacija i pokretanje s Bun-om bun install bun run dev ``` **🛠️ Iz izvornog koda** ```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 # Korištenje Nix flakes nix develop npm run dev # Ili korištenje devbox devbox run npm run dev ``` 📖 [Docker Guide](docs/guides/DOCKER_GUIDE.md) — Compose profili, Caddy HTTPS, Cloudflare tuneli. **🦭 Podman** ```bash # 1. Pripremite direktorij za podatke koji se povezuje bind mountom mkdir -p data # 2. Samo Linux + lokalni rootless Podman (nikada udaljeni Podman Machine klijent): podman unshare chown 1000:1000 ./data # 3. Postavite naznaku za runtime, izgradite lokalnu Compose sliku i pokrenite echo "CONTAINER_HOST=podman" >> .env podman compose --profile base up -d --build ``` Na macOS-u ili Windowsu, Podman koristi udaljeni Podman Machine: preskočite `podman unshare` i pratite [smjernice za direktorij podataka specifične za topologiju](contrib/podman/README.md#data-directory-permissions-by-topology). 📖 [Podman Guide](contrib/podman/README.md) — Compose izgradnje, Podman Machine i postavljanje Linux/systemd Quadlet. **⚡ Brža / lakša instalacija (bez nativne izgradnje)** Nativni SQLite engine (`better-sqlite3`) je **opcionalna** ovisnost, tako da globalna instalacija nikada ne čeka na kompilaciju iz izvornog koda: koristi predizgrađenu binarnu datoteku kada odgovara vašoj platformi/Node verziji, a inače se transparentno oslanja na čisti JS engine (`node:sqlite` na Node 22+, ili ugrađeni `sql.js` WASM) — nisu potrebni alati za izgradnju. Da biste u potpunosti preskočili nativno zagrijavanje nakon instalacije (CI, headless ili spori uređaji): ```bash OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute # CI=1 to također preskače ``` Za najbrže instalacije preporučujemo **pnpm** (spremište adresirano sadržajem + hard linkovi — vidi gore). Za headless runtime bez nadzorne ploče koristite Docker `base` profil (gore) ili [Termux vodič](docs/guides/TERMUX_GUIDE.md). CLI i web nadzorna ploča poslužuju se putem istog procesa na jednom portu, tako da danas ne postoji zaseban paket samo za CLI.

# 🎬 OmniRoute u akciji

## 📹 Videovodiči

_{Snapshot do painel em 2026-08-24 · Catálogo bruto: YT 809 | TT 137 | IG 124 · Frescor (dias): YT 1 | TT 21 | IG 22}

🎬 #1 — Instagram
_{nick_saraev — 3.042.474 pregleda}

🎬 #2 — Instagram
_{theopenstack — 692.419 pregleda}

🎬 #3 — TikTok
_{milesreevesai — 620.400 pregleda}

🎬 #4 — YouTube
_{Vaibhav Sisinty — 391.109 pregleda}

🎬 #5 — Instagram
_{buildwithai.club — 347.652 pregleda}

**Potpuni poredak (deduplicirani kanonski URL-ovi, `v > 0`, najveći 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** | Kanonski podaci na dan 2026-08-24: **1.029 jedinstvenih videa** · **11.132.922 poznatih pregleda** (`v > 0`) · **639 kanala/profila po mreži**. Sirovi pregled sadrži 1.070 redaka; 41 duplikat s Instagrama normaliziran je prema kanonskom URL-u, uz zadržavanje najvećeg broja pregleda po videu. > 🎬 **Snimili ste video o OmniRoute?** Otvorite [issue](https://github.com/diegosouzapw/OmniRoute/issues/new) ili [raspravu](https://github.com/diegosouzapw/OmniRoute/discussions) s poveznicom — istaknut ćemo ga ovdje.

# 📧 Zajednica i pomoć > Sve na jednom mjestu — pratite održavatelja, razgovarajte sa zajednicom ili otvorite issue. | Kanal | Gdje / kako | | ------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- | | 💼 **LinkedIn** — pratite održavatelja | [linkedin.com/in/diegosouzapw](https://www.linkedin.com/in/diegosouzapw/) | | 🐙 **GitHub** — pratite za nova izdanja i savjete | [@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 grupi](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) | | 🟢 **WhatsApp — 🇧🇷 Brazil** | [pridružite se grupi](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) | | 🌍 **Web stranica** | [omniroute.online](https://omniroute.online) | | 🌍 **🌍StHub OmniRoute zajednica (besplatno)** | [portal sthub](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK) | | 📦 **Izvorni kod** | [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute) | | 🐛 **Prijavite grešku** | [otvorite issue](https://github.com/diegosouzapw/OmniRoute/issues) — priložite izlaz naredbe `npm run system-info` | | 🤝 **Doprinesite** | [CONTRIBUTING.md](CONTRIBUTING.md) · [Model grananja i izdanja](docs/ops/BRANCHING_MODEL.md) · odaberite `good first issue` | | 💚 **Podržite projekt** | [Načini podrške ↑](#-support-omniroute) · [GitHub Sponsors](https://github.com/sponsors/diegosouzapw) |

---

## 🛠️ Tehnološki stog

Sloj	Tehnologija
Runtime	Node.js 22.x / 24.x LTS — `>=22.22.2 <23 \|\| >=24.0.0 <27`
Jezik	TypeScript 6.0 — 100% TypeScript u `src/` i `open-sse/` (nula `any` tipova u jezgri od verzije 2.0)
Okvir	Next.js 16 + React 19 + Tailwind CSS 4
Baza podataka	better-sqlite3 (SQLite, WAL journaling) + LowDB (JSON legacy) — 122 domenska modula, 168 migracija
Memorija	SQLite FTS5 potpuno tekstualno pretraživanje + int8-kvantizirani vektorski embeddingi, tipizirano opadanje (decay)
Sheme	Zod 4 — validacija MCP ulaza/izlaza alata + API ugovori
Protokoli	MCP (stdio / HTTP / SSE) + A2A v0.3 (JSON-RPC 2.0 + SSE)
Streaming	Server-Sent Events (SSE) + WebSocket premosnica (`/v1/ws`)
Kompresija	Cjevovod s 12 modula — RTK, Caveman, LLMLingua-2 (MobileBERT ONNX), GCF, OmniGlyph
Autentikacija i sigurnost	OAuth 2.0 (PKCE) + JWT + API ključevi + MCP opsegovna autentikacija · AES-256-GCM u mirovanju · DOMPurify
Prikrivenost	wreq-js — imitacija JA3 / JA4 TLS otiska, proxy na 3 razine
Otpornost	Prekidač kruga (circuit breaker), eksponencijalno odgađanje, zaštita od "thundering herd" efekta, automatsko samoiscjeljivanje kombinacija
Logiranje	pino — strukturirani JSON zapisi s kontekstom zahtjeva
Testiranje	Node.js test runner + Vitest — preko 39.000 statičkih deklaracija testova u više od 5.100 praćenih testnih datoteka (jedinični, integracijski, E2E, sigurnosni, ekosustavni testovi)
Platforme	Desktop (Electron) · Android (Termux) · PWA (bilo koji preglednik)
CI/CD	GitHub Actions — automatska npm objava + Docker Hub prilikom izdanja
Poveznice	Web stranica · npm · Docker Hub

## 📖 Dokumentacija

### 📘 Početak rada

Dokument	Opis
Korisnički vodič	Pružatelji usluga, kombinacije, CLI integracija, implementacija
Vodič za postavljanje	Sve metode instalacije, konfiguracije CLI alata, postavljanje protokola, prilagodba vremenskih ograničenja
Vodič za CLI alate	Postavljanje po alatu za Claude Code, Codex, Cursor, Cline, OpenClaw, Kilo, Copilot
Udaljeni način rada	Upravljajte udaljenim OmniRoute-om (VPS) s CLI-a na svom laptopu putem tokena s ograničenim pristupom
Konfiguracija Claude Code	Usmjerite Claude Code na OmniRoute (lokalno/udaljeno) uz `launch` + profile po modelu
Brzi početak	Instalacija u 3 koraka → povezivanje → konfiguracija

### 🔧 Operacije i implementacija

Dokument	Opis
Docker vodič	Docker run, Compose profili, Caddy HTTPS, tuneli, oznake slika
Podman vodič	Quadlet integracija sa systemd, podman-compose, SELinux
Implementacija na VM	Potpuni vodič: postavljanje VM + nginx + Cloudflare
Implementacija na Fly.io	Implementacija na Fly.io s trajnim pohranom
Termux vodič	Pokretanje OmniRoute-a na Androidu putem Termuxa
PWA vodič	Instalacija Progressive Web App aplikacije, predmemoriranje, arhitektura
Vodič za deinstalaciju	Potpuno uklanjanje za sve metode instalacije
Konfiguracija okoline	Potpuni popis varijabli i referenci za `.env`

### 🧠 Značajke i arhitektura

Dokument	Opis
Arhitektura	Arhitektura sustava, tok podataka i unutarnji rad
Vodič za kompresiju	Cjevovod sa 7 opcija: off / lite / standard / aggressive / ultra / RTK / stacked
RTK kompresija	Kompresija izlaza naredbi, filtri, povjerenje, provjera, oporavak sirovog izlaza
Moduli za kompresiju	Caveman, RTK, stacked cjevovodi, površine nadzorne ploče/API/MCP
Format pravila kompresije	JSON sheme paketa pravila za Caveman i RTK filtre
Jezični paketi kompresije	Prepoznavanje jezika i izrada Caveman paketa pravila
Vodič za otpornost	Prekidači kruga, razdoblja hlađenja, red čekanja, zaštita od "thundering herd" efekta, TLS spoofing
Modul automatskih kombinacija	Bodovanje s 16 faktora, paketi načina rada, samoiscjeljivanje
Proxy vodič	Proxy sustav na 3 razine, tržnica 1proxy, CRUD registra
Besplatni planovi	Objedinjeni direktorij: 38 dokumentiranih ponavljajućih skupova / 446 katalogiziranih unosa besplatnih planova
Galerija značajki	Vizualni pregled nadzorne ploče sa snimkama zaslona
Dokumentacija baze kôda	Vodič kroz bazu kôda prilagođen početnicima

### 🤖 Protokoli i API-i

Dokument	Opis
API referenca	Svi krajnji nizovi (endpoints) s primjerima
OpenAPI specifikacija	OpenAPI 3.0 specifikacija
MCP poslužitelj	110 MCP alata, konfiguracije IDE-a, Python/TS/Go klijenti
Vodič za MCP poslužitelj	Instalacija MCP-a, transporti i referenca alata
A2A poslužitelj	JSON-RPC 2.0 protokol, vještine, streaming, upravljanje zadacima
Vodič za A2A poslužitelj	A2A kartica agenta, zadaci, vještine i streaming

### 📋 Projekt i kvaliteta

Dokument	Opis
Doprinosi	Postavljanje razvojnog okruženja i smjernice
Model granjanja i izdavanja	Kamo su usmjereni PR-ovi (`release/*`), što znače `main` i oznake (tags)
Popis promjena	Potpuna povijest izdanja po verzijama
Sigurnosna politika	Prijavljivanje sigurnosnih propusta i sigurnosne praksе
Vodič za internacionalizaciju	Podrška za 42 jezika, tijek prevođenja, RTL
Kontrolni popis za izdanje	Koraci provjere prije izdavanja
Plan pokrivenosti	Strategija pokrivenosti testovima za preko 39.000 statičkih deklaracija testova u više od 5.100 praćenih testnih datoteka

# ⭐ Najbolji doprinositelji > OmniRoute je oblikovan strastvenom open-source zajednicom. Ovi pojedinci dali su izniman doprinos koji izravno utječe na kvalitetu, stabilnost i doseg projekta. **Hvala vam.** ### Vanjski doprinositelji po broju spojenih (merged) pull requestova

Rang	Doprinositelj	Spojeni PR-ovi	~Promijenjeni redovi
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

_{Zaključeno na vrhu uživo dostupne grane release/v3.8.50 dafb4ae808, uz spajanja zaključno do 2026-08-24 05:26:03 UTC. Paginirani GitHub GraphQL popis sadrži 5.911 spojenih PR-ova: 2.707 od vlasnika repozitorija, 179 od Dependabota i 3.025 vanjskih PR-ova od 535 različitih doprinositelja. „Promijenjeni redovi” predstavljaju GitHub dodavanja + brisanja i uključuju generirane datoteke, lockfile-ove, kataloge, prijevode i dokumentaciju; radi se o obujmu promjena (churn), a ne o autorskim linijama kôda (LOC). Izjednačeni rezultati na granici zadržani su.} ### GitHub-pripisani commitovi

backryun _{🥇 220 GitHub-pripisanih commitova}	Paijo _{🥈 219 GitHub-pripisanih commitova}	Randi _{🥉 108 GitHub-pripisanih commitova}	Ravi Tharuma _{🏅 81 GitHub-pripisan commit}	Chris _{🏅 70 GitHub-pripisanih commitova}	Markus Hartung _{🏅 69 GitHub-pripisanih commitova · izjednačeno #6}
Dizzle _{🏅 69 GitHub-pripisanih commitova · izjednačeno #6}	Jan Leon _{🏅 64 GitHub-pripisana commita}	zenobit _{🏅 62 GitHub-pripisana commita}	Bob.Hou _{🏅 51 GitHub-pripisan commit · izjednačeno #10}	Xiangzhe _{🏅 51 GitHub-pripisan commit · izjednačeno #10}

_{Ponovno provjereno 2026-08-24 06:14:31 UTC: GitHub-pripisani commitovi prijavljeni putem API-ja doprinositelja repozitorija za zadanu granu release/v3.8.50. API je vratio 525 identiteta (415 korisnika, 2 bota, 108 anonimnih); ova tablica isključuje održavatelja, botove i anonimne identitete te zadržava izjednačene rezultate u natjecanju. Razlikuje se i od rangiranja po spojenim PR-ovima iznad i od popisa od 639 osoba na temelju Git metapodataka ispod.} > 🙏 Značajke, ispravci grešaka i poboljšanja infrastrukture ovih doprinositelja **ključni su dio** onoga što OmniRoute čini pouzdanim i bogatim značajkama. Svaki pull request, svaki testni slučaj i svaka datoteka prijevoda za internacionalizaciju su važni. Open source izgrađuju ljudi kao što su oni.

---
## 💖 Sponzori

Iskrena zahvala ljudima koji financiraju OmniRoute iz svog vlastitog džepa — svaki doprinos održava projekt besplatnim, neovisnim i u kretanju.

Andrew
_{💛 Aktivan mjesečni sponzor}

Vlad I
_{💛 Aktivan mjesečni sponzor}

Paco Cartones
_{💛 Aktivan jednokratni sponzor}

Prof. Igor Morais
_{💛 Bivši jednokratni pomagač}

longtao
_{💛 Bivši jednokratni pomagač}

_{… i drugi koji preferiraju ostati privatni 💛} _{Javni GitHub Sponsors ponovno provjereni 2026-08-24. GitHub-ov status activeOnly određuje gore prikazane oznake aktivnosti; prethodno objavljeni javni jednokratni pomagači i dalje ostaju zahvaljeni, a privatni sponzori ostaju anonimni.} 💖 Postani sponzor → — svaki dolar održava OmniRoute besplatnim i neovisnim.

## 👥 600+ Suradnika

[![Contributors](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=639&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors) _{Provjereno 2026-08-24 na zamrznutoj osnovi ac02c5b42f i ponovno provjereno na uživo vrhu release/v3.8.50 dafb4ae808: 639 normaliziranih ljudskih Git identiteta — 407 se javlja kao autori commitova (uključujući održavatelja), a 232 samo u eksplicitnim Co-authored-by napomenama. Popis normalizira GitHub noreply nadimke, isključuje 26 bot/agent/servisnih/placeholder identiteta i ne spaja obične e-mail adrese samo zato što se njihova prikazana imena podudaraju.} ### Kako doprinijeti 1. Forkajte repozitorij 2. Kreirajte granu od **aktivnog** vrha `release/vX.Y.Z` (ne `main`) — pogledajte [Model grananja i izdavanja](docs/ops/BRANCHING_MODEL.md) 3. Kreirajte svoju feature granu (`git checkout -b feat/amazing-feature`) 4. Commitajte svoje promjene (`git commit -m 'feat: add amazing feature'`) 5. Pushajte granu (`git push origin feat/amazing-feature`) 6. Otvorite Pull Request s **base = ta `release/vX.Y.Z` grana** Pogledajte [CONTRIBUTING.md](CONTRIBUTING.md) za detaljne smjernice. ### Objava nove verzije ```bash # Kreirajte izdanje — npm publish se izvršava automatski VERSION=x.y.z gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes ```

## 📊 Zvjezdice

## 🌍 StarMapper

## 🙏 Zahvale

OmniRoute stoji na plećima divova. Počeo je kao fork projekta **[9router](https://github.com/decolua/9router)** i TypeScript port Go projekta **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** — i od tada je svaki podsustav u nastavku bio inspiriran open-source projektom koji je do toga došao prvi. Svaki od njih oblikovao je konkretan dio OmniRoutea. Ovo je naša zahvala svima njima. 🙏 > ⭐ broj zvjezdica provjeren putem GitHubovog REST API-ja 24. kolovoza 2026. — idite dati ovim projektima zvjezdicu. Brojevi su točan snapshot s datumom i naravno da će se mijenjati. ### 🧬 Podrijetlo i gateway

Projekt	⭐	Kako je inspirirao OmniRoute
9router	26,161	Izvorni projekt na kojem je ovaj fork izgrađen — ovdje proširen multi-modalnim API-jima i potpunim TypeScript prepisom.
CLIProxyAPI	48,497	Go implementacija koja je inspirirala ovaj JavaScript/TypeScript port.
LiteLLM	57,100	AI gateway čiji javni skup podataka o cijenama napaja našu sinkronizaciju praćenja troškova i čiji model normalizacije providera je informirao naše usmjeravanje.
codex-chatgpt-web	1,410	MIT izvorni kod prilagođen u vendored ChatGPT Web → Codex Responses bridge, uključujući browser-session, response-framing, usage i web-search adaptere.
free-claude-code	48,112	Obrasci preneseni u oporavak streama, no-thinking aliase, fallback web pretraživanje, ograničenja kliznog prozora, redakciju logova i pooštrene tijekove pokretanja.
composer-api	322	Cursor Composer obrasci tool-choice, output-constraint i tool-commit prilagođeni u nativni Cursor izvršitelj.
codex-multi-auth	457	Obrasci fresh-login i rotacije refresh tokena preneseni u Codex OAuth reautentikaciju.
opencode-anthropic-auth	510	Zadane vrijednosti transformacije kompatibilne s Claude Code i ponašanje billing-headera generalizirani u OmniRouteov konfiguracijski upravljan bridge.
grok2api-merged	2	Njegova mapiranja Grok modela, generator lažnog TypeError Statsig, zadane vrijednosti zahtjeva i uređaja, te NDJSON procesor odgovora bili su znatno prilagođeni u OmniRouteov Grok Web izvršitelj.
TQZHR/grok2api	705	Glavni tranzitivni izvor koda iza grok2api-merged; njegove implementacije modela, headera, payloada, Statsig i procesora sačuvane su u Grok Web liniji.
chenyme/grok2api	7,520	Temeljni MIT izvor za Grok payload i zadane vrijednosti uređaja, Statsig generator i `result.response` procesor prenesen kroz TQZHR i grok2api-merged.
grok2api-pro	27	Tranzitivni izvor koji grok2api-merged priznaje za svoj sloj proxy-pool; OmniRoute čuva tu napomenu o podrijetlu, ali ne tvrdi da je prenio proxy-pool u svoj ograničeni Grok Web izvršitelj.
GrokProxy	50	Njegov cookie-autentificirani Grok proxy i obrazac streaminga `result.response.token` informirali su OmniRouteov Grok Web transport.
GrokBridge	5	Izvorna Grok Web implementacija konzultirala je njegov HTTP/browser upstream dizajn; njegov direktni HTTP put potječe iz GrokProxy, tako da se ne tvrdi neovisan prijenos koda.
grok-web-api	14	Njegove Rust sheme `ChatOptions` i response-envelope informirale su OmniRouteove TypeScript tipove za Grok zahtjeve i streaming odgovore.

### 🗜️ Kompresija konteksta i tokena — motori

Projekt	⭐	Kako je inspirirao OmniRoute
Caveman	100,538	Viralni projekt "why use many token when few token do trick" — njegova pećinsko-govorna filozofija pokreće naš standardni način kompresije i 30+ pravila punjenja/kondenzacije.
RTK – Rust Token Killer	77,185	Visoko-performantna kompresija izlaza naredbi — inspirirala naš RTK motor, JSON filter DSL, oporavak sirovog izlaza i stack-anu RTK → Caveman cjevovoda.
headroom	67,310	Reverzibilna kompresija konteksta (SmartCrusher) — inspirirala naš `headroom` motor i obrazac oznake za dohvat `ccr`.
LLMLingua	6,598	Istraživanje kompresije promptova (LLMLingua / LLMLingua-2) — inspiriralo naš asinkroni, sigurni-za-kod, fail-open `llmlingua` motor.
llmlingua-2-js	31	JS/ONNX port (MobileBERT / XLM-RoBERTa) korišten kao worker-thread backend za naš LLMLingua motor.
Troglodita	40	Kompresija tokena za PT-BR — pokreće naš jezični paket za pt-BR: redukciju pleonazama i uklanjanje punjenja usklađeno s gramatikom brazilskog portugalskog.
ponytail	108,957	Viralna vještina "lazy senior dev" YAGNI-programera — inspirirala naš Output Style less-code: usmjeravanje na najmanju radnu promjenu koje smanjuje _generirani_ kod (sestrinski koncept na osi izlaza uz Cavemanovu sažetu prozu).
i-have-adhd	23,526	Njegov stil odgovora fokusiran na akciju, prilagođen ADHD-u, prilagođen je u sažeti stil izlaza OmniRoutea na pet jezika.

### 🧩 Kompaktni formati, istraživanje tokena i alati svjesni koda

Projekt	⭐	Kako je inspirirao OmniRoute
TOON	25,233	Token-Oriented Object Notation — njegov kolumnarni model header-plus-rows oblikovao je našu fazu tabelarne kompakcije.
GCF – Graph Compact Format	41	Njegov kompaktni graf format i generičko-profilni dizajn informirali su OmniRouteovu tabelarnu kompakciju i Headroom codec format.
gcf-typescript	4	MIT TypeScript implementacija direktno vendorirana i proširena kao Headroom generičko-profilni kodek.
token-optimizer-mcp	494	Brotli/SQLite cache + context-delta po sesiji — inspirirao naš `session-dedup` motor.
token-savior	1,122	Kompakcija bash izlaza + MCP profili — inspirirali disciplinu prekida kompresije i redukciju manifesta MCP alata.
token-saver	138	Kompresija izlaza svjesna sadržaja, po tipu datoteke, s prekidom svjesnim neuspjeha — potvrdila naš dispatch po tipu i preskakanje minimalne dobiti.
token-optimizer	1,951	"Find the ghost tokens" — njegov obrazac offload + oporabive handle informirao naše CCR offload razmišljanje.
TokenMizer	28	Nacrt session-graph + cross-turn deduplikacije linija koji je informirao naš dizajn session-dedup.
OmniCompress	3	Rust kolumnarni JSON + content-addressed retrieve + cross-message deduplikacija — potvrdili dizajn naših motora `headroom`/`ccr`/`session-dedup` i invarijantu stabilnu za cache "kompresirani oblik je nezavisan o poziciji".
mcp-compressor	113	Kompresija MCP tool-schema/description — informirala redukciju kardinalnosti manifesta MCP alata.
RepoMapper	197	Aider-style repo-map rangiranje — informiralo naše istraživanje repo-mape / rangiranja dohvaćanja.
quiet-shell-mcp	4	Deklarativna redukcija shell izlaza putem MCP — potvrdila našu deklarativnu kompakciju bash izlaza.
ts-morph	6,162	Alat TypeScript Compiler API — inspirirao naše uklanjanje komentara temeljeno na parseru koje čuva string, template i regex literale.

### 🧠 Memorija i RAG

Projekt	⭐	Kako je inspirirao OmniRoute
Mem0	63,902	Univerzalni sloj memorije — njegov model proxy-as-write/read-boundary oblikovao je našu arhitekturu memorije.
Letta (MemGPT)	24,382	Stateful agenti s podijeljenom memorijom — inspirirali naš stupnjeviti model Context Control & Recovery (CCR).
WFGY	1,781	Taksonomija ProblemMap od 16 ponavljajućih načina neuspjeha RAG/LLM — zajednički vokabular u našem vodiču za rješavanje problema.

### 🛰️ Inspekcija prometa, MITM i transparentni proxy

Projekt	⭐	Kako je inspirirao OmniRoute
llm-interceptor	66	MITM presretanje/analiza prometa asistenta za kodiranje ↔ LLM informiralo je rane zahtjeve za Traffic Inspector. Četiri prethodno derivirana modula — SSE spajanje, normalizacija konverzacije, maskiranje tajni i sanitizacija headera — zamijenjena su neovisnim clean-room implementacijama zasnovanim na javnim standardima protokola. Dvije host-passthrough površine (`passthrough.ts` i `_internal/bypass.cjs`) ostaju interne OmniRoute implementacije klasificirane neovisno; nisu ponovno napisane kao dio te zamjene.
ProxyBridge	5,995	Transparentno usmjeravanje proxya po procesu — inspiriralo naš crash-safe MITM teardown, socket idle-timeouts, atribuciju procesa putem `/proc` i TPROXY hvatanje.

### 📚 Podaci o modelima, opservabilnost i UI

Projekt	⭐	Kako je inspirirao OmniRoute
models.dev	6,555	Otvorena baza podataka o specifikacijama AI modela, cijenama i mogućnostima — natively sinkronizirana u naš katalog modela.
React Flow / xyflow	38,108	Biblioteka grafova temeljena na čvorovima koja pokreće naš Compression Studio u stvarnom vremenu i Combo/Routing Studio.
LangGraph	40,314	Vizualizacija radnog toka uživo u LangGraph Studiju inspirirala je pregled kaskade u stvarnom vremenu u našim Studios.
Langfuse	33,592	Njegov model opservabilnosti trace → span → generation oblikovao je vodeni pad našeg Compression Studia.
Kiali	3,631	Opservabilnost service-mesha za Istio — inspirirala naše circuit-breaker oznake i vizuale error-edge u Routing/Combo Studiju.
lobe-icons	2,428	Logotipi AI/LLM brendova koji prikazuju ikone providera na cijelom našem dashboardu.
flag-icons	12,354	Pruža MIT-licencirane SVG zastave koje koristi birač jezika u README-u.

### 🛡️ Sigurnost

Projekt	⭐	Kako je inspirirao OmniRoute
awesome-secure-defaults	721	Kurirani popis sigurnih-po-defaultu biblioteka koji usmjerava naše sigurnosne odluke (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).

### 🧭 Komplementarni alati

Projekt	⭐	Kako je inspirirao OmniRoute
ClawRouter	6,564	Inspirirao deduplikaciju zahtjeva, hitni fallback bez troška, priključive Auto-Combo strategije i višejezičnu klasifikaciju namjere.
Antigravity-Manager	30,652	Njegovo remapiranje modela svjesno računa, validacija izvršne putanje i ponašanje oznake plana informirali su OmniRouteov Antigravity runtime.
vscode-antigravity-cockpit	4,817	Njegov kompaktni format odbrojavanja resetiranja kvote inspirirao je odgovarajući prikaz limita providera u OmniRouteu.
AionUi	32,230	Njegove ACP integracije inspirirale su OmniRouteovo automatsko otkrivanje instaliranih CLI agenata.
CodexBar	20,507	Identificirao površinu kvote za Grok Build; OmniRoute je zatim neovisno provjerio i korigirao live wire format.

## 📄 Licenca MIT licenca - pogledajte [LICENSE](LICENSE) za detalje. ---

**[⬆ Povratak na vrh](#-omniroute)** · Izrađeno s ❤️ za zajednicu otvorenog koda za AI. _{OmniRoute v3.8.51 · Node ≥22.22.2 · MIT licenca · omniroute.online}