> Ručno kombiniranje besplatnih paketa mukotrpno je — deseci SDK-ova, deseci ograničenja brzine i nikakva predodžba o tome koliko zapravo imate na raspolaganju. OmniRoute katalogizira **489 stavki besplatnih paketa unutar 35 ključeva periodičnih skupova** i izračunava istaknuti broj tokena na temelju **17 skupova s objavljenim pozitivnim mjesečnim budžetom i pet Groq ograničenja po modelu**, uz uklanjanje duplikata prema zajedničkom skupu. Kvote koje postaju dostupne tek nakon regionalne provjere identiteta (trenutačno: ModelScope) prikazuju se zasebno, +~6 mil. iza regionalne provjere identiteta, i nikada se ne pribrajaju istaknutom ukupnom iznosu. Rezultat ostaje vidljiv na nadzornoj ploči (`/dashboard/free-tiers`).
> Animirani sažetak aktualne stranice `/dashboard/free-tiers`. Potpuna metodologija (uklanjanje duplikata skupova, razine kredita, uvjeti pružatelja): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**.
>
> Ove se brojke ponovno provjeravaju svaka dva tjedna prema aktualnom katalogu i **mijenjaju se u oba smjera** — ako pružatelj ukine besplatni paket, broj se smanjuje; ako se pojavi novi, broj raste. Objavljujemo ono što katalog stvarno izračuna, a nikada zaokruženi najpovoljniji scenarij.
⭐ Označite repozitorij zvjezdicom ako vam je OMNIROUTE pomogao uštedjeti novac i olakšati rad.
[](https://github.com/diegosouzapw/OmniRoute)
[](https://www.star-history.com/diegosouzapw/omniroute)
[](https://olud.ai/project/diegosouzapw-omniroute.html)
### 💬 Pridružite se zajednici
**👋 Pratite održavatelja — prvi saznajte za nove pružatelje, izdanja i savjete:**
[](https://www.linkedin.com/in/diegosouzapw/)
[](https://github.com/diegosouzapw)
[](https://discord.gg/U47eFqAXCn)
[](https://t.me/omnirouteOficial)
[](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4)
[](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4)
[](https://omniroute.online)
**Pitanja, savjeti o pružateljima, 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)**
## 📈 Pristupnik nastavlja rasti
| | v3.8.49 | **v3.8.50** | `v3.8.51+` |
| ----------------------------------------- | :-----: | :---------------------: | :--------------: |
| 🌐 Pružatelji usluga | 290 | **357** | još ih je u redu |
| 🧠 Jedinstveni ID-ovi modela za razgovor | 1185 | **1312** | — |
| 🖼️ Most modaliteta | — | 🆕 slika + zvuk + video | — |
| 📡 Besplatni katalog Radara | — | 🆕 uz prijavu | — |
| ⚖️ Raspoređivanje uzimajući u obzir kvote | — | 🆕 Quota-Share | — |
| 📊 Telemetrija kvota | — | 🆕 uživo | — |
**→ [Plan razvoja](ROADMAP.md) — na tračnicama prema `v3.9.0 LTS`**
## 🧩 Dostupno
[](https://www.npmjs.com/package/omniroute)
[](https://hub.docker.com/r/diegosouzapw/omniroute)
[](LICENSE)
## 🆓 Radi čim ga instalirate — bez ključeva, bez konfiguracije
```bash
# Svježa 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) izravno. Zatim prijeđite na `auto` i pustite OmniRoute da odabere.📦 Skripte za brzi početak kopiraj-zalijepi za **Python, Node.js, PHP i cURL** → [`examples/quickstart/`](examples/quickstart/)
# 💥 Obećanje
# 🤔 Zašto OmniRoute?
## 🤝 Podržavaju nas naši prijatelji otvorenog koda
> **Želite se pridružiti kao prijatelj otvorenog koda?** To su tvrtke koje podržavaju otvoreni kod i pomažu OmniRouteu da nastavi s radom — a mi javno objavljujemo gdje ide svaki token koji nam daju. Javite nam se: [diegosouza.pw@outlook.com](mailto:diegosouza.pw@outlook.com)
Kimi Moonshot AI
Hvala Kimiju (Moonshot AI), našem osnivačkom prijatelju otvorenog koda, na podršci ovom projektu! Kimi je AI laboratorij iza obitelji modela otvorenog koda K2 i K3 — Kimi K3 pruža kontekstni prozor od 1M tokena, izvornu viziju i kodiranje na graničnoj razini po djeliću cijene zatvorenih modela, i radi odmah s Claude Codeom, Codexom i svakim alatom za kodiranje koji OmniRoute poslužuje.
Što Kimi podržava: Kimijevi API krediti pokreću OmniRouteov AI-validirani cjevovod izdavanja — fazu validacije spajanja koju pokreće Kimi K3 koja pregledava svaki pull zahtjev prije nego što se objavi — plus svakodnevni razvoj značajki. Prvoklasna Kimi podrška isporučuje se na obje tračnice: izravni Kimi API (kimi-k3) i Kimi Code plan kodiranja (OAuth i API ključ). OmniRoute je također prvi brazilski projekt otvorenog koda u Kimijevom programu podrške. Nabavite Kimi API ključ s 15% dodatnih kredita →
Jeftinije zaključivanje cheaperinference.com
Hvala Cheaper Inferenceu, prijatelju otvorenog koda OmniRoutea, na podršci ovom projektu! Cheaper Inference je cjenovno rangirani pristupnik koji preprodaje 42 granična modela — Claude, GPT-5.x, Gemini, Kimi K3, GLM, DeepSeek, Grok i MiniMax — iza jedne OpenAI-kompatibilne krajnje točke, usmjeravajući svaki zahtjev najjeftinijem prihvatljivom pružatelju bez naplate iznad cjenika proizvođača modela.
Prvoklasna podrška u OmniRouteu: Chat Completions, izvorni /v1/responses krajnja točka, vizija, pozivanje alata i 3 modela slika (grok-imagine, nano-banana-pro, nano-banana-2, dostupni kao cheaperinference/<model>). Nabavite API ključ →
Veze označene s aff=omniroute su partnerske veze. One financiraju projekt bez dodatnih troškova za vas. 🎟️ Promocija partnera — besplatni kuponi za prijavu od pružatelja koje ne sponzoriramo (kliknite za proširenje)Ovaj odjeljak je samo za referalne/kuponske kodove. Sponzorirana partnerstva nalaze se u 🤝 Podržavaju nas naši prijatelji otvorenog koda iznad. OmniRoute nema sponzorstvo niti partnerstvo s pružateljima navedenim ovdje — to su javni kuponi koje svatko može koristiti.
AgentRouter agentrouter.org
AgentRouter — partnerska prijava · 100 USD besplatnih kredita pri prijavi (besplatni poslužitelj, očekujte veću latenciju — najbolje za testiranje, ne za proizvodnju). Prvoklasna podrška u OmniRouteu od v3.8.50: Chat Completions, Anthropic-kompatibilni format žice i OpenAI-kompatibilna putanja. Dostupni modeli uključuju claude-opus-4-8, claude-opus-5, gpt-5.6-sol i više. Zgrabite svojih 100 USD →
⚠️ Partnerska veza — OmniRoute nema sponzorstvo niti partnerstvo s ovim pružateljem.
Znate li za drugog pružatelja s izdašnim besplatnim kuponom za prijavu koji koristi korisnicima OmniRoutea? Otvorite problem i dodati ćemo ga ovdje.
## 🎯 Combosi — Zastavni brod
> **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
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)
📖 [Auto-Combo Engine](docs/routing/AUTO-COMBO.md) · [Vodič za otpornost](docs/architecture/RESILIENCE_GUIDE.md)
## 🏆 Po čemu se OmniRoute ističe
📊 Potpuna metodologija & detalji po značajkama u usporedbi s 9router, OpenRouter, CLIProxyAPI & 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.
**🇧🇷 PIX** — trenutno, bez naknada (Brazil)
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 brojka za besplatnu razinu i dalje iznosi **~1.62B tokena/mjesečno** iz prethodno dokumentiranog kataloga iz kojeg su uklonjeni duplikati među skupovima. Privremeni krediti za registraciju kod pružatelja mogu zasebno povećati količinu u prvom mjesecu na **~2.22B**. Radar je neobavezan, potpisan kataloški sloj za korisnike koji žele ažurnije informacije o dostupnosti besplatnih modela između izdanja OmniRoutea; katalog zajednice i sve postojeće besplatne značajke ostaju besplatni.
Podržavatelji mogu dobiti aktualni katalog i dodatne mogućnosti pružatelja usluga. Njegova zasebna, promjenjiva gornja granica iznosi **najviše približno 3B tokena/mjesečno**, ovisno o dostupnosti pružatelja. Ta gornja granica nije zajamčena: pružatelji mogu u bilo kojem trenutku promijeniti kvote, uvjete prihvatljivosti, modele ili regije.
Radar se uključuje po želji i upotrebljava isključivo GET zahtjeve. Klijent OmniRoute ne prenosi upite, promet, konfiguraciju pružatelja, telemetriju upotrebe ni lokalno stanje odbacivanja obavijesti. Saznajte više o uvjetima prihvatljivosti i trenutačnom katalogu na adresi **[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 alati i agenti za programiranje
> Jedna konfiguracija — `http://localhost:20128/v1` — i **svaki** AI IDE ili CLI radi na besplatnim i povoljnim modelima.
＋ radi i s · Agent Deck · Kiro · Command Code · Antigravity · Windsurf · AMP · bilo kojim alatom kompatibilnim s OpenAI-jem
📖 Postavljanje za svaki alat za svih 36 alata (26 CLI alata za kodiranje + 10 CLI agenata) → [`docs/reference/CLI-TOOLS.md`](docs/reference/CLI-TOOLS.md) · 🧩 Dodatak za OpenCode → [`@omniroute/opencode-provider`](https://www.npmjs.com/package/@omniroute/opencode-provider)
**Pokrenite bilo koji podržani CLI putem OmniRoutea jednom naredbom** — bez zapisivanja konfiguracijskih datoteka,
vjerodajnice se umeću zasebno za svaki proces, a Qwen/Gemini dobivaju privremeni izolirani matični 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 vlastitu konfiguraciju 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 točne varijable okruženja i argumente bez izvršavanja, a `--api-key-env NAME` čuva tajne izvan
povijesti vaše ljuske. → [CLI integracije](docs/guides/CLI-INTEGRATIONS.md)
## 🌐 357 pružatelja AI usluga — 152 označena u katalogu kao besplatna
> **357 registriranih pružatelja usluga** u kanonskim kolekcijama za razgovor, medije, pretraživanje, lokalne modele, agente u oblaku i sustave, uključujući **152 pružatelja s metapodacima za otkrivanje `hasFree: true`**. Registar modela za razgovor obuhvaća **229 pružatelja / 2.554 različita para pružatelj-model / 1.283 neobrađena ID-a modela**; zasebni katalog besplatnih kvota sadrži **491 redak po modelu**, **35 ponavljajućih skupova kvota** i **54 pružatelja s ponavljajućim ili trajno besplatnim pristupom bez ključa**. Nazivnici su namjerno različiti; definicije i izračuni s dedupliciranim skupovima dostupni su u dokumentima [Referenca pružatelja](docs/reference/PROVIDER_REFERENCE.md) i [Besplatne razine](docs/reference/FREE_TIERS.md).
### 🏢 Svaki veliki laboratorij — putem jedne krajnje točke
OpenAI
Anthropic
Gemini
xAI Grok
DeepSeek
Mistral
Qwen
Meta Llama
Groq
NVIDIA
MiniMax
Cohere
Perplexity
HuggingFace
Together
Fireworks
Cloudflare
Baidu
…i više od 330 drugih — svaka se ikona učitava uživo iz kataloga pružatelja na nadzornoj ploči. 📖 [Referenca pružatelja](docs/reference/PROVIDER_REFERENCE.md)
### 🆓 Zauvijek besplatno — 0 USD, bez kartice
OpenCode Zen DeepSeek V4, Nemotron 3 Bez ograničenja tokena
Kilo Code Automatsko usmjeravanje, Tencent Hy3 Zauvijek besplatno
### 🧩 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**.
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
> 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)
### 🤝 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
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
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.
Strategija pokrivenosti testovima za više od 39.000 statičkih deklaracija testova u više od 5.100 praćenih datoteka testova
# ⭐ Najistaknutiji doprinositelji
> OmniRoute oblikuje strastvena zajednica otvorenog koda. Ovi su pojedinci dali iznimne doprinose koji izravno utječu na kvalitetu, stabilnost i doseg projekta. **Hvala vam.**
### Vanjski doprinositelji prema spojenim zahtjevima za povlačenje
Zamrznuto na trenutačnom vrhu grane release/v3.8.50, na reviziji dafb4ae808, sa spajanjima do 2026-08-24 05:26:03 UTC. Straničeni popis iz GitHub GraphQL-a sadržava 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 retci” zbroj su dodavanja i brisanja na GitHubu te uključuju generirane datoteke, datoteke zaključavanja, kataloge, prijevode i dokumentaciju; predstavljaju količinu promjena, a ne broj autorski napisanih redaka koda. Izjednačeni rezultati na graničnoj vrijednosti zadržani su.
### Commitovi pripisani na GitHubu
Bob.Hou 🏅 51 doprinos pripisan na GitHubu · dijeli 10. mjesto
Xiangzhe 🏅 51 doprinos pripisan na GitHubu · dijeli 10. mjesto
Ponovno provjereno 2026-08-24 06:14:31 UTC: doprinosi pripisani na GitHubu koje je API repozitorija Contributors prijavio 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 plasmane. Razlikuje se i od gornjeg poretka spojenih PR-ova i od donjeg popisa 639 osoba iz Git metapodataka.
> 🙏 Značajke, ispravci pogrešaka i poboljšanja infrastrukture ovih suradnika **ključni su dio** onoga što OmniRoute čini pouzdanim i bogatim značajkama. Svaki zahtjev za spajanje, svaki testni slučaj i svaka i18n datoteka prijevoda važni su. Otvoreni kod grade ljudi poput njih.
---
## 💖 Sponzori
Iskrena zahvala ljudima koji financiraju OmniRoute iz svog vlastitog džepa — svaki doprinos održava projekt besplatnim, neovisnim i u kretanju.
… 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
[](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.50dafb4ae808: 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
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.
MIT izvorni kod prilagođen u vendored ChatGPT Web → Codex Responses bridge, uključujući browser-session, response-framing, usage i web-search adaptere.
Zadane vrijednosti transformacije kompatibilne s Claude Code i ponašanje billing-headera generalizirani u OmniRouteov konfiguracijski upravljan bridge.
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.
Glavni tranzitivni izvor koda iza grok2api-merged; njegove implementacije modela, headera, payloada, Statsig i procesora sačuvane su u Grok Web liniji.
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.
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.
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.
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).
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".
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.
Transparentno usmjeravanje proxya po procesu — inspiriralo naš crash-safe MITM teardown, socket idle-timeouts, atribuciju procesa putem /proc i TPROXY hvatanje.
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
> Animirani sažetak aktualne stranice `/dashboard/free-tiers`. Potpuna metodologija (uklanjanje duplikata skupova, razine kredita, uvjeti pružatelja): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**.
>
> Ove se brojke ponovno provjeravaju svaka dva tjedna prema aktualnom katalogu i **mijenjaju se u oba smjera** — ako pružatelj ukine besplatni paket, broj se smanjuje; ako se pojavi novi, broj raste. Objavljujemo ono što katalog stvarno izračuna, a nikada zaokruženi najpovoljniji scenarij.
```bash
# Svježa 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) izravno. Zatim prijeđite na `auto` i pustite OmniRoute da odabere.
📦 Skripte za brzi početak kopiraj-zalijepi za **Python, Node.js, PHP i cURL** → [`examples/quickstart/`](examples/quickstart/)
> **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:
📖 [Auto-Combo Engine](docs/routing/AUTO-COMBO.md) · [Vodič za otpornost](docs/architecture/RESILIENCE_GUIDE.md)
📊 Potpuna metodologija & detalji po značajkama u usporedbi s 9router, OpenRouter, CLIProxyAPI & LiteLLM → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)
Ključ (nasumičan): `5d865059-bc44-483a-962d-43ceb80126eb`
Pix copia-e-cola:
```
00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD
```
📖 [Ovlaštenje](docs/architecture/AUTHZ_GUIDE.md) · [Zaštitne ograde](docs/security/GUARDRAILS.md) · [Usklađenost](docs/security/COMPLIANCE.md)
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:
