# README (Hrvatski) 🌐 **Languages:** 🇺🇸 [English](../../../README.md) · 🇪🇹 [am](../am/README.md) · 🇸🇦 [ar](../ar/README.md) · 🇦🇿 [az](../az/README.md) · 🇧🇬 [bg](../bg/README.md) · 🇧🇩 [bn](../bn/README.md) · 🇧🇦 [bs](../bs/README.md) · 🇨🇿 [cs](../cs/README.md) · 🇩🇰 [da](../da/README.md) · 🇩🇪 [de](../de/README.md) · 🇬🇷 [el](../el/README.md) · 🇪🇸 [es](../es/README.md) · 🇪🇪 [et](../et/README.md) · 🇮🇷 [fa](../fa/README.md) · 🇫🇮 [fi](../fi/README.md) · 🇫🇷 [fr](../fr/README.md) · 🇮🇪 [ga](../ga/README.md) · 🇮🇳 [gu](../gu/README.md) · 🇳🇬 [ha](../ha/README.md) · 🇮🇱 [he](../he/README.md) · 🇮🇳 [hi](../hi/README.md) · 🇭🇺 [hu](../hu/README.md) · 🇦🇲 [hy](../hy/README.md) · 🇮🇩 [id](../id/README.md) · 🇳🇬 [ig](../ig/README.md) · 🇮🇹 [it](../it/README.md) · 🇯🇵 [ja](../ja/README.md) · 🇬🇪 [ka](../ka/README.md) · 🇰🇭 [km](../km/README.md) · 🇮🇳 [kn](../kn/README.md) · 🇰🇷 [ko](../ko/README.md) · 🇱🇹 [lt](../lt/README.md) · 🇱🇻 [lv](../lv/README.md) · 🇮🇳 [ml](../ml/README.md) · 🇮🇳 [mr](../mr/README.md) · 🇲🇾 [ms](../ms/README.md) · 🇲🇹 [mt](../mt/README.md) · 🇲🇲 [my](../my/README.md) · 🇳🇵 [ne](../ne/README.md) · 🇳🇱 [nl](../nl/README.md) · 🇳🇴 [no](../no/README.md) · 🇮🇳 [or](../or/README.md) · 🇮🇳 [pa](../pa/README.md) · 🇵🇭 [phi](../phi/README.md) · 🇵🇱 [pl](../pl/README.md) · 🇵🇹 [pt](../pt/README.md) · 🇧🇷 [pt-BR](../pt-BR/README.md) · 🇷🇴 [ro](../ro/README.md) · 🇷🇺 [ru](../ru/README.md) · 🇱🇰 [si](../si/README.md) · 🇸🇰 [sk](../sk/README.md) · 🇸🇮 [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) · 🇺🇿 [uz](../uz/README.md) · 🇻🇳 [vi](../vi/README.md) · 🇳🇬 [yo](../yo/README.md) · 🇨🇳 [zh-CN](../zh-CN/README.md) · 🇹🇼 [zh-TW](../zh-TW/README.md) ---

# 🚀 OmniRoute — Besplatni AI pristupnik

OmniRoute — Nikad ne prestajte programirati. Svaki AI alat → 372 pružatelja — više od 150 besplatnih — putem jedne krajnje točke. Claude Code, Codex, Cursor, Cline, Copilot i Antigravity povezuje s BESPLATNIM modelima Claude / GPT / Gemini uz automatsko prebacivanje. Kombinirana kompresija RTK + Caveman štedi 15–95 % tokena (prosječno ~89 %) — nikad ne dosegnite ograničenja. 372 pružatelja AI usluga · više od 150 besplatnih razina · ~1,62 mlrd. besplatnih tokena mjesečno · 19 strategija usmjeravanja · početak uz $0.

## 💰 ~1,62 mlrd tokena mjesečno putem besplatnih paketa trećih strana

> **Povežite vlastite račune pružatelja usluga.** Ovo je procijenjeni zbroj zasebno dostupnih besplatnih paketa trećih strana, a ne dodjela tokena od OmniRoutea. Registrirajte se, pribavite pristupne podatke gdje je to potrebno i povežite pružatelje usluga koje možete koristiti; svaki pružatelj kontrolira vlastita ograničenja, dostupnost i uvjete. > > Ručno kombiniranje besplatnih paketa naporno 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 ponavljajućih ključeva skupova** i izračunava istaknuti broj tokena na temelju **17 skupova s objavljenim pozitivnim mjesečnim budžetom te 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, +~6M iza regionalne provjere identiteta, i nikada se ne pribrajaju istaknutom iznosu. Rezultat ostaje vidljiv na nadzornoj ploči (`/dashboard/free-tiers`).

Kartica budžeta besplatnih paketa OmniRoutea: stabilnih ~1,62 mlrd besplatnih tokena mjesečno, do ~2,22 mlrd u prvom mjesecu uz kredite za registraciju, iz 35 dokumentiranih ponavljajućih ključeva skupova koji obuhvaćaju 489 katalogiziranih stavki besplatnih paketa iza jedne krajnje točke. Transparentan izračun s uklanjanjem duplikata po skupovima — svaki zajednički skup broji se jednom, uključujući 17 ponavljajućih skupova s objavljenim pozitivnim mjesečnim budžetom tokena te pet Groq ograničenja po modelu; 13 pružatelja označeno je kao pružatelji koje treba izbjegavati u katalogu rizika uvjeta korištenja, pa odluku donosite sami. Traka budžeta uključuje Mistral 1B, Nara 210M, LLM7 150M, xKiro 150M, Groq 30M (pet ograničenja po modelu) i manje skupove, uz kredite za registraciju u prvom mjesecu i trajno besplatne pružatelje bez ograničenja broja tokena, koji su prikazani zasebno kako nikada ne bi umjetno povećavali istaknuti iznos. Trenutačno iskorišteno/preostalo na /dashboard/free-tiers.

> Animirani sažetak aktivne stranice `/dashboard/free-tiers`. Potpuna metodologija (uklanjanje duplikata skupova, razine kredita, uvjeti pružatelja): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**. > > _{Te se brojke ponovno provjeravaju svaka dva tjedna prema aktivnom katalogu i **mijenjaju se u oba smjera** — kada pružatelj ukine besplatni paket, broj se smanjuje; kada se pojavi novi, broj raste. Objavljujemo ono što katalog doista izračuna, a nikada zaokruženi najbolji mogući scenarij.}

⭐ Dodajte zvjezdicu repozitoriju ako vam je OMNIROUTE pomogao uštedjeti novac i olakšati rad.

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

[![Poredak povijesti zvjezdica](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 — prvi saznajte za nove pružatelje, izdanja i savjete:** [![Pratite Diega na LinkedInu](https://img.shields.io/badge/Follow_Diego_on-LinkedIn-0A66C2?style=for-the-badge&logo=linkedin&logoColor=white)](https://www.linkedin.com/in/diegosouzapw/) [![Pratite @diegosouzapw na GitHubu](https://img.shields.io/github/followers/diegosouzapw?style=for-the-badge&logo=github&logoColor=white&label=Follow%20on%20GitHub&color=181717)](https://github.com/diegosouzapw) [![Discord](https://img.shields.io/badge/Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/U47eFqAXCn) [![Telegram](https://img.shields.io/badge/Telegram-26A5E4?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/omnirouteOficial) [![WhatsApp Globalno](https://img.shields.io/badge/WhatsApp_Global-25D366?style=for-the-badge&logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) [![WhatsApp Brazil](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) [![Web-stranica](https://img.shields.io/badge/Website-omniroute.online-blue?logo=google-chrome&logoColor=white)](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)**
## 📈 Gateway nastavlja rasti

| | v3.8.50 | **v3.8.51** | `v3.8.52+` | | ----------------------------------------- | :-------------------: | :---------: | :-------------------: | | 🌐 Pružatelji | 352 | **358** | 372 | | 🧠 Jedinstveni ID-jevi modela za razgovor | 1320 | **1374** | 1443 | | 🖼️ Most modaliteta | 🆕 vid + zvuk + video | ✓ | ✓ | | 📡 Besplatni katalog Radara | 🆕 uz prijavu | ✓ | ✓ | | ⚖️ Raspoređivanje prema kvoti | 🆕 Quota-Share | ✓ | ✓ | | 📊 Telemetrija kvota | 🆕 u stvarnom vremenu | ✓ | ✓ | | 🧰 Način bez sučelja | — | — | 🆕 `serve --headless` | | 🛤️ Infrastruktura LTS grane | — | — | 🆕 kanali izdanja | **→ [Plan razvoja](ROADMAP.md) — na tračnicama prema `v3.9.0 LTS`**

## 🧩 Dostupno [![verzija na npm-u](https://img.shields.io/npm/v/omniroute?color=cb3837&logo=npm)](https://www.npmjs.com/package/omniroute) ![Mjesečna preuzimanja s NPM-a](https://img.shields.io/npm/dm/omniroute?label=npm/month&color=cb3837&logo=npm) [![Docker Hub](https://img.shields.io/docker/v/diegosouzapw/omniroute?label=Docker%20Hub&logo=docker&color=2496ED)](https://hub.docker.com/r/diegosouzapw/omniroute) [![Licenca: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](LICENSE) ![Docker preuzimanja](https://img.shields.io/docker/pulls/diegosouzapw/omniroute?label=docker%20pulls&logo=docker&color=2496ED) ![Electron preuzimanja](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
💡 Saznajte više	💥 Obećanje	🤔 Zašto OmniRoute	🏆 Po čemu se ističe
⚙️ Značajke	🎯 Kombinacije	🌐 Davatelji usluga	🔌 CLI & MCP
	🗜️ Kompresija	🖥️ Gdje se izvodi	🔒 Privatno
👀 Pogledajte	🎬 Na djelu	✨ Novosti	🤖 Kompatibilni CLI-jevi
💚 Podrška	💚 Podržite / donirajte	💬 Zajednica	💖 Sponzori
📦 Projekt	🛠️ Tehnološki paket	📖 Dokumentacija	👥 Suradnici

🌐 Na 67 jezika

## 🆓 Instalirajte, povežite pružatelja usluge, a zatim usmjeravajte putem jedne krajnje točke

Tri koraka: instalirajte i pokrenite OmniRoute, povežite prihvatljivog pružatelja usluge pomoću vlastitog računa ili API ključa, a zatim usmjerite svoj alat na localhost:20128/v1 koristeći OmniRoute API ključ i model auto. Usmjeravanje ovisi o dostupnim prihvatljivim vezama i ograničenjima pružatelja usluge.

```bash # Nakon povezivanja pružatelja usluge kopirajte svoj OmniRoute ključ iz Nadzorne ploče → Krajnje točke: curl http://localhost:20128/v1/chat/completions \ -H "Authorization: Bearer YOUR_OMNIROUTE_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}' ``` _{`auto` zahtijeva prihvatljivu rutu. Nova instalacija možda neće imati nijedno prihvatljivo odredište bez ključa, a pružatelj usluge bez ključa može odbiti klijente trećih strana. Pružatelji usluga označeni s `tos: avoid`, uključujući OpenCode Free i Kiro, prema zadanim su postavkama isključeni iz automatskog usmjeravanja; povezivanje računa ne mijenja tu postavku. Prije odabira pružatelja usluge pogledajte [Vodič za besplatne razine](docs/getting-started/FREE-TIERS-GUIDE.md).} _{📦 Skripte za brzi početak koje možete kopirati i zalijepiti za **Python, Node.js, PHP i cURL** → [`examples/quickstart/`](examples/quickstart/)}

# 💥 Obećanje

# 🤔 Zašto OmniRoute?

Tijek zahtjeva u OmniRouteu: vaš IDE ili CLI (Claude Code, Cursor, Cline…) poziva jednu lokalnu krajnju točku (http://localhost:20128/v1); OmniRoute Smart Router (kompresija RTK + Caveman, 19 strategija usmjeravanja, prekidači strujnog kruga, prikrivanje TLS-a, MCP, A2A, zaštitni mehanizmi) može se prebacivati između 4 razine pružatelja usluga sve dok postoji prihvatljivo i ispravno odredište — 1. razina Pretplata, 2. razina API ključ, 3. razina Jeftino i 4. razina Besplatno.

## 🤝 Uz podršku naših prijatelja otvorenog koda

> **Želite li nam se pridružiti kao prijatelj otvorenog koda?** Ovo su tvrtke koje podržavaju otvoreni kod i pomažu da se OmniRoute nastavi razvijati — a mi javno objavljujemo kamo odlazi svaki token koji nam daju. Javite nam se: [diegosouza.pw@outlook.com](mailto:diegosouza.pw@outlook.com)

Kimi
_{Moonshot AI} Hvala Kimi (Moonshot AI), našem osnivačkom prijatelju otvorenog koda, na podršci ovom projektu! Kimi je AI laboratorij koji stoji iza obitelji modela otvorenih težina K2 i K3 — Kimi K3 pruža kontekstni prozor od 1M tokena, izvorne mogućnosti obrade slike i programiranje na razini vodećih modela uz djelić cijene zatvorenih modela te odmah radi s alatima Claude Code, Codex i svim alatima za programiranje koje OmniRoute podržava.

Što omogućuje Kimijeva podrška: Kimijevi API krediti pokreću OmniRouteov proces izdanja potvrđen umjetnom inteligencijom — fazu provjere spajanja koju pokreće Kimi K3, koja pregledava svaki zahtjev za povlačenje prije objave — kao i svakodnevni razvoj značajki. Prvorazredna podrška za Kimi dostupna je kroz oba kanala: izravni Kimi API (kimi-k3) i programerski plan Kimi Code (OAuth i API ključ). OmniRoute je također prvi brazilski projekt otvorenog koda u Kimijevu programu podrške. Nabavite Kimi API ključ uz 15% dodatnih kredita →

Cheaper Inference
_{cheaperinference.com} Hvala Cheaper Inference, OmniRouteovu prijatelju otvorenog koda, na podršci ovom projektu! Cheaper Inference pristupnik je rangiran prema troškovima koji preprodaje 42 vrhunska modela — Claude, GPT-5.x, Gemini, Kimi K3, GLM, DeepSeek, Grok i MiniMax — putem jedne krajnje točke kompatibilne s OpenAI-jem, usmjeravajući svaki zahtjev najjeftinijem prikladnom pružatelju bez naplate iznosa višeg od cjenika autora modela.

Prvorazredna podrška u OmniRouteu: dovršavanje razgovora, izvorna krajnja točka /v1/responses, obrada slike, pozivanje alata i 3 modela za slike (grok-imagine, nano-banana-pro, nano-banana-2, dostupna kao cheaperinference/<model>). Nabavite API ključ →

_{Veze označene s aff=omniroute partnerske su veze. Financiraju projekt bez dodatnih troškova za vas.}

_{🎟️ Partnerske promocije — besplatni kuponi pružatelja pri registraciji koje ne sponzoriramo (kliknite za proširenje)}

_{Ovaj je odjeljak namijenjen isključivo kodovima za preporuke/kupone. Sponzorirana partnerstva nalaze se u prethodnom odjeljku 🤝 Uz podršku naših prijatelja otvorenog koda. OmniRoute nema sponzorski ni partnerski odnos s ovdje navedenim pružateljima — ovo su javni kuponi koje svatko može upotrijebiti.}

_AgentRouter
_{agentrouter.org} _{AgentRouter — partnerska registracija · $100 besplatnih kredita pri registraciji (besplatan poslužitelj, očekujte veću latenciju — najbolje za testiranje, ne za produkciju). Prvorazredna podrška u OmniRouteu od verzije v3.8.50: dovršavanje razgovora, format prijenosa kompatibilan s Anthropicom i put kompatibilan s OpenAI-jem. Dostupni modeli uključuju claude-opus-4-8, claude-opus-5, gpt-5.6-sol i druge. Preuzmite svojih $100 →}

_{⚠️ Partnerska veza — OmniRoute nema sponzorski ni partnerski odnos s ovim pružateljem.}

_{Znate li drugog pružatelja s izdašnim besplatnim kuponom pri registraciji od kojeg bi korisnici OmniRoutea imali koristi? Otvorite prijavu problema i dodat ćemo ga ovdje.}

## 🎯 Kombinacije — Glavni adut

Animirano svih 19 strategija usmjeravanja kombinacija — 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 gornju tablicu za opis svake od njih.

> **Kombinacija** je lanac modela kroz koje OmniRoute usmjerava **automatski**. Ako se kvota potroši, pružatelj usluge zakaže ili troškovi naglo porastu, kombinacija može prijeći na sljedeći prihvatljivi ispravni model. 🛡️ ### ⚡ Bez konfiguracije — samo upotrijebite `auto` Nije potrebno stvarati kombinaciju. Postavite model na `auto` (ili neku varijantu) i OmniRoute će izraditi virtualnu kombinaciju od vaših povezanih pružatelja usluga, ocjenjujući ih u stvarnom vremenu:

ID modela	Što optimizira
`auto`	🎯 Uravnotežena zadana postavka (LKGP — ostaje uz vašeg posljednjeg pouzdanog pružatelja usluga)
`auto/coding`	🧑💻 Ponderi usmjereni prvenstveno na kvalitetu generiranja koda
`auto/fast`	⚡ Najprije najniža latencija
`auto/cheap`	💰 Najprije najniža cijena po tokenu
`auto/offline`	🔋 Najprije najveća rezerva kvote / ograničenja brzine
`auto/smart`	🔭 Kvaliteta na prvom mjestu + 10 % istraživanja radi otkrivanja boljih modela
`auto/lkgp`	📌 Izričito zadržavanje uz posljednjeg pouzdanog pružatelja usluga
`auto/chaos`	🧪 Paralelno raspoređivanje na skup modela (jedan po pružatelju usluga, zadano 5), vraća jedan odgovor; jedan poziv prema nadređenoj usluzi po modelu u skupu, bez umetanja kvarova

## ### 🔀 Ili izradite vlastitu — 19 strategija usmjeravanja Svih **19** strategija — kombinirajte ih po želji za svaki korak kombinacije:

#	Strategija	Što radi
1	`priority`	Uređeni popis s prvim ciljem kao prioritetom — iscrpljuje svaki prije prelaska na sljedeći 🥇
2	`fill-first`	Potpuno ispunjava kvotu svakog cilja prije prelaska na sljedeći
3	`weighted`	Ponderirani nasumični odabir prema ponderu svakog cilja
4	`round-robin`	Kružno prolazi kroz ciljeve redoslijedom
5	`p2c`	Nasumično uravnoteženje opterećenja metodom odabira između dvije mogućnosti
6	`least-used`	Odabire cilj s trenutačno najmanjim opterećenjem
7	`random`	Ujednačeni nasumični odabir (bez duplikata)
8	`strict-random`	Nasumični odabir bez uklanjanja ponavljanja 🎲
9	`cost-optimized`	Smanjuje trošak u $ po zahtjevu prema aktualnim cijenama iz kataloga 💸
10	`headroom`	Odabire cilj s najvećom preostalom kvotom
11	`reset-window`	Daje prednost cilju čiji se prozor kvote najranije poništava
12	`reset-aware`	Rangira prema vremenu poništavanja kvote — kraći prozori prvi 📊
13	`context-relay`	Predaje kontekst između ciljeva za duge razgovore 🧠
14	`context-optimized`	Odabire najbolji cilj za trenutačnu veličinu konteksta
15	`cache-optimized`	Veže svaki ponovno upotrebljivi prefiks upita uz isti račun — povećava pogotke predmemorije upita 🎯
16	`lkgp`	Posljednja poznata pouzdana putanja — veže se uz posljednjeg uspješnog pružatelja usluga, a zatim se vraća na pravila
17	`auto`	Ocjenjivanje uživo prema 16 čimbenika za svaku vezu 🤖
18	`fusion`	Raspoređuje zahtjev na skup modela, a model-sudac sintetizira jedan odgovor 🧬
19	`pipeline`	Povezuje korake u lanac — izlaz svakog cilja prosljeđuje se sljedećem 🔗

_{Mehanizam automatskih kombinacija ocjenjuje svakog kandidata prema **16 čimbenika** (stanje, kvota, trošak, latencija, prikladnost za zadatak, kvaliteta, dostupnost sesije…) — pogledajte [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md).} ## ### 🧱 Otpornost je ugrađena (3 neovisna sloja)

Otpornost sustava OmniRoute — 3 neovisna sloja samooporavka, odgovarajući sloj za odgovarajući kvar. Sloj 1: prekidač strujnog kruga pružatelja usluge (cijeli pružatelj): aktivira se samo pri 408/5xx, pragovi OAuth 8× / API ključ 12× / lokalno 2×, vraća se nakon 60s/30s/15s u HALF-OPEN probu, oporavak po potrebi; dok je OPEN, kombinacija preusmjerava na sljedećeg pružatelja. Sloj 2: hlađenje veze (jedan ključ/račun): osnovno 5s OAuth / 3s API ključ, eksponencijalna ×2 odgoda s zaštitom od stampeda, 429 poštuje Retry-After, uspjeh briše sva stanja pogreške; ključ na hlađenju preskače se dok ostali ključevi nastavljaju posluživati. Sloj 3: zaključavanje modela (jedan model): 429 po modelu, lokalni 404 ili odbijanja načina rada zaključavaju samo taj model — nikada cijelu vezu. Završna stanja (zabranjen, istekao, potrošeni krediti) namijenjena su operateru, a ne hlađenju.

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

## 🏆 Po čemu se OmniRoute izdvaja

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

⭐ Označite repozitorij zvjezdicom	Besplatno — uistinu pomaže vidljivosti	Označite OmniRoute zvjezdicom
🐙 GitHub Sponsors	Jednokratno ili mjesečno · bez naknade platforme	github.com/sponsors/diegosouzapw
☕ Ko-fi	Brza jednokratna napojnica, bez registracije za donatora	ko-fi.com/diegosouzapw
🧋 Buy Me a Coffee	Mala, neformalna gesta	buymeacoffee.com/diegosouzapw
🖐 Liberapay	Ponavljajuće · neprofitno · otvorenog koda	liberapay.com/diegosouzapw
🇧🇷 PIX (Brazil)	Trenutačno, bez naknada	ključ i QR u nastavku
₿ Kriptovalute	BTC · ETH · USDT-TRC20 · USDC-Solana	adrese u nastavku

**🇧🇷 PIX** — trenutačno, bez naknada (Brazil) QR kôd za OmniRoute PIX

Ključ (nasumični): `5d865059-bc44-483a-962d-43ceb80126eb` PIX za kopiranje i lijepljenje: ``` 00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD ```

₿ Kriptovalute — 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`

_{⚠️ Svaku valutu šaljite samo putem prikazane mreže — slanje putem pogrešne mreže može dovesti do gubitka sredstava.}

🐛 Pronašli ste pogrešku ili imate povratne informacije? Otvorite [raspravu](https://github.com/diegosouzapw/OmniRoute/discussions).

Napomene za razvojne programere: Projekt tijekom npm install/postinstall može generirati lokalnu datoteku .env radi praktičnosti razvojnih programera. Ta se datoteka namjerno ignorira putem .gitignore (pogledajte .gitignore) i nikada se ne smije predati u repozitorij — ako je slučajno predana, promijenite sve izložene tajne i uklonite datoteku iz povijesti. Smjernice za upravljanje datotekama lokalnog okruženja i tajnama potražite u docs/DEVELOPER-ENVIRONMENT.md.

## 📡 OmniRoute Radar Glavna brojka za besplatnu razinu ostaje **~1.62B tokena/mjesečno** iz gore dokumentiranog kataloga s uklonjenim duplikatima među skupovima. Privremeni krediti za registraciju kod pružatelja mogu zasebno povećati prvi mjesec na **~2.22B**. Radar je neobavezan, potpisan kataloški sloj za korisnike koji žele ažurniju dostupnost 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. 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 u bilo kojem trenutku mogu promijeniti kvote, uvjete prihvatljivosti, modele ili regije. Radar zahtijeva izričito uključivanje i koristi samo GET zahtjeve. Klijent OmniRoute ne prenosi upite, promet, konfiguraciju pružatelja, telemetriju korištenja ni lokalno stanje odbacivanja obavijesti. Saznajte više o uvjetima prihvatljivosti i trenutačnom katalogu na **[radar.omniroute.online/planos](https://radar.omniroute.online/planos)**.

## ✨ Što je novo

> Nedavne najvažnije promjene od **v3.8.20 → v3.8.50**. Cijela povijest nalazi se u [`CHANGELOG.md`](CHANGELOG.md). - **🎛️ OmniConductor** — ulazno A2A delegiranje vašoj floti agenata, vještine Conductora na kartici agenta i ploča nadzorne ploče s glasovnim razgovorom Faro „pritisni za govor”. → [A2A poslužitelj](docs/frameworks/A2A-SERVER.md) - **🛂 Prilagodljivi prihvat i zaštita od preopterećenja** — zahtjevni zahtjevi za razgovor stavljaju se u red umjesto da vraćaju 503, uz atomske klizne RPM zakupe po vezi. → [Vodič za otpornost](docs/architecture/RESILIENCE_GUIDE.md) - **🗂️ Kanonski redoslijed za `/v1/models`** — jedan neprekinuti blok grupiran po pružatelju za svakog pružatelja (kombinacije su prikvačene na početak), stabilan u svim izvorima kataloga. → [Referenca API-ja](docs/reference/API_REFERENCE.md) - **🗜️ Ojačavanje kompresije** — zaštita od prekomjerne dekompresije uključena prema zadanim postavkama, Caveman paketi za DE / FR / JA + kineski (wényán), RTK filtri za Gradle i .NET. → [Kompresija](docs/compression/COMPRESSION_ENGINES.md) - **💸 Transparentan paušalni trošak** — pružatelji s pretplatom / planom za programiranje u analitici troškova prikazuju **$0**; proračun, kvota i usmjeravanje i dalje se procjenjuju. → [Referenca API-ja](docs/reference/API_REFERENCE.md) - **⚖️ Usmjeravanje prema udjelu kvote** — pravedno dijeli kvotu zajedničkog računa među objedinjenim ključevima te iskorištava raspoloživi kapacitet tako da se neaktivni udjeli ustupaju drugima. → [Vodič za otpornost](docs/architecture/RESILIENCE_GUIDE.md) - **🤖 Postavljanje CLI-ja/agenta jednom naredbom** — 13 registriranih naredbi `setup-*`; `omniroute run` pokreće 7 CLI-jeva (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); `omniroute configure` podržava 10 odredišta uz interaktivni odabir pružatelja i modela te favorite za svaki kontekst. → [Integracije CLI-ja](docs/guides/CLI-INTEGRATIONS.md) - **🛰️ Udaljeni način rada** — upravljajte udaljenim OmniRouteom pomoću tokena ograničenog opsega (`connect` / `contexts` / `tokens`) i OAuth pomagača `antigravity` za instalacije na VPS-u. → [Udaljeni način rada](docs/guides/REMOTE-MODE.md) - **🧭 Pametnije automatsko usmjeravanje** — kombinacije `auto/:`, **Fusion** (panel modela + sudac), usmjeravanje prilagođeno zadatku te nadjačavanja modela / načina rada / proračuna u USD po zahtjevu. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🗜️ Proširiva kompresija** — 12 kombiniranih pogona + Compression Studios: LLMLingua-2, dvorazinski Ultra, omniglyph, kontrola vjernosti po koraku, GCF v3.2, uređivač s promjenom redoslijeda povlačenjem. → [Kompresija](docs/compression/COMPRESSION_ENGINES.md) - **🕵️ Transparentno MITM dešifriranje (TPROXY)** — presreće CLI-jeve koji zanemaruju varijable okruženja proxyja, uz CA za svaki SNI i instalacijski program za spremište pouzdanih certifikata. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md) - **💸 Telemetrija troškova posvuda** — zaglavlja troškova/upotrebe `X-OmniRoute-*` na svakoj krajnjoj točki, zaglavlje uštede za cache-HIT, kvote potrošnje u USD po ključu. → [Referenca API-ja](docs/reference/API_REFERENCE.md) - **🧠 Memorija pod vašom kontrolom** — prema zadanim je postavkama isključena, uz neobaveznu int8 kvantizaciju vektora + tipizirano slabljenje i `x-omniroute-no-memory` po zahtjevu. → [Memorija](docs/frameworks/MEMORY.md) - **🛡️ Sigurnost** — zaštita od ubacivanja upita na svakoj LLM ruti (paket testova crvenog tima), neobavezna zaštitna mjera za maskiranje vjerodajnica (redigira procurjele API ključeve/tajne u oba smjera), besplatno web-pretraživanje putem DuckDuckGoa kao posljednja opcija i neobavezna OIDC prijava za nadzornu ploču (prijava lozinkom uvijek ostaje dostupna). → [Zaštitne mjere](docs/security/GUARDRAILS.md) - **🖼️ Nove krajnje točke** — `/v1/ocr` (Mistral OCR) i `/v1/audio/translations` (u stilu Whispera) zaokružuju podršku za medije. → [Referenca API-ja](docs/reference/API_REFERENCE.md) - **🎨 Generiranje slika / videozapisa / zvuka** — jedan API za medije: xAI Grok Imagine i Novita AI video, ComfyUI, Magnific, Adobe Firefly, Segmind te pružatelji govora poput ElevenLabsa. → [Referenca API-ja](docs/reference/API_REFERENCE.md) - **🌍 Implementacija i operacije** — `basePath` za obrnuti proxy, automatsko otkrivanje jezika preglednika, praćenje uređaja po ključu, MITM pouzdani certifikati bez root ovlasti, lokalizacija zh-TW. → [Okruženje](docs/reference/ENVIRONMENT.md) - **🤝 Više pružatelja i agenata** — agenti u oblaku (Codex Cloud, Cursor, Devin, Jules), Grok Build (xAI) s preglednikom + OAuth prijavom, prvoklasna kartica za Ollamu, Claude Opus 5 i Sonnet 5, službeno partnerstvo s Kimijem (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… i osvježeni **katalog s 352 pružatelja**. → [Pružatelji](docs/reference/PROVIDER_REFERENCE.md) - **📡 Transparentnost usmjeravanja** — svaki odgovor sadrži zaglavlje `X-OmniRoute-Decision` koje navodi strategiju/pružatelja/latenciju zaslužne za odgovor, nova kombinirana strategija `cache-optimized` + faktor `cacheAffinity` za Auto-Combo usmjerava ponovljene zahtjeve natrag na vezu koja drži predmemorirani prefiks, a krajnja točka samo za čitanje `/v1/auto-combo/{channel}/candidates` izlaže aktivni skup kandidata kanala `auto/*`. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **⚡ Lokalne performanse i infrastruktura** — lokalni Redis jednim klikom, alati za implementaciju releja na Cloudflare Workers / Deno Deploy, Bifrost i Mux kao nadzirane ugrađene usluge. → [Ugrađene usluge](docs/frameworks/EMBEDDED-SERVICES.md) - **🧩 Također uključeno** — okvir za dodatke + trgovina, okviri za vještine Omni/Agent/GitHub, integracija s Obsidian trezorom (22 MCP alata), API-ji Batch i Files kompatibilni s OpenAI-jem, semantička predmemorija odgovora, gamifikacija s ljestvicama najboljih, ACP otkrivanje agenata (15 ugrađenih agenata), planirani izvoz zapisnika u BigQuery, paralelno slanje na više modela `auto/chaos`, most za Telegram bot, upravitelj verzija unutar aplikacije i LMArena-ELO ljestvice besplatnih pružatelja. → [Dokumentacija](docs/README.md)

## 🤖 Kompatibilni CLI alati i agenti za kodiranje > Jedna konfiguracija — `http://localhost:20128/v1` — i **svaki** AI IDE ili CLI radi na besplatnim i povoljnim 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}	_deyin.ai

＋ radi i s · Agent Deck · Kiro · Command Code · Antigravity · Windsurf · AMP · bilo kojim alatom kompatibilnim s OpenAI-jem

_{📖 Postavljanje za svaki od 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, uz vjerodajnice umetnute zasebno za svaki proces te privremeni izolirani početni direktorij za Qwen/Gemini: ```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/argumente bez izvršavanja, a `--api-key-env NAME` sprječava pohranu tajni u povijesti vaše ljuske. → [CLI integracije](docs/guides/CLI-INTEGRATIONS.md)

## 🌐 372 pružatelja umjetne inteligencije — 154 označena kao besplatna u katalogu

> **372 registrirana pružatelja** u kanonskim kolekcijama za razgovor, medije, pretraživanje, lokalne modele, agente u oblaku i sustav, uključujući **154 pružatelja s metapodatkom otkrivanja `hasFree: true`**. Registar modela za razgovor obuhvaća **237 pružatelja / 3.009 različitih parova pružatelj-model / 1.443 neobrađena ID-a modela**; zasebni katalog besplatnih kvota ima **491 redak po modelu**, **35 obnavljajućih skupova kvota** i **54 obnavljajuća pružatelja ili pružatelja koji su trajno besplatni bez ključa**. Nazivnici se namjerno razlikuju; definicije i izračuni s uklonjenim duplikatima skupova kvota nalaze se 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 još više od 330 — svaka se ikona učitava uživo iz kataloga pružatelja na nadzornoj ploči. 📖 [Referenca pružatelja](docs/reference/PROVIDER_REFERENCE.md)}
### 🆓 Besplatno zauvijek — 0 USD, bez kartice

OpenCode Zen _{DeepSeek V4, Nemotron 3 Bez ograničenja tokena}	Kilo Code _{Automatsko usmjeravanje, Tencent Hy3 Zauvijek besplatno}	Requesty _{GPT-OSS 120B, Nemotron Zauvijek besplatno}	SiliconFlow _{DeepSeek V3.2 / R1 Besplatna razina}	Z.AI GLM _{GLM-4.7 / 4.5-Flash Zauvijek besplatno}	Baidu ERNIE _{ERNIE 4.0 Zauvijek besplatno}
Qoder AI _{Qwen3-Max, Kimi-K2 Neograničeno i BESPLATNO}	Pollinations _{GPT, Llama, Claude Ključ nije potreban}	Cloudflare AI _{Više od 50 modela 10 tisuća neurona dnevno}	NVIDIA NIM _{GLM, MiniMax ~40 RPM besplatno}	Cerebras _{GLM 4.7, GPT-OSS Jednokratni kredit od 5 USD; potrebna je kartica}	OpenRouter _{:free modeli +10 USD → viši RPM}

📖 Potpuni strojno čitljivi katalog → [`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	Glavne značajke
📦 npm (globalno)	`npm install -g omniroute`	Jedna naredba, bilo koji OS
🐳 Docker	`docker run … diegosouzapw/omniroute`	Više arhitektura: AMD64 + ARM64
🖥️ Radna površina (Electron)	`npm run electron:build`	Izvorni prozor + sistemska traka — Windows / macOS / Linux
🎩 Traka izbornika (OmniRouteTray)	`brew install --cask zoispag/tap/omniroute-tray`	Nadzire i automatski ažurira poslužitelj — macOS
💪 ARM	izvorni `arm64`	Raspberry Pi, ARM poslužitelji, Apple Silicon
📱 Android (Termux)	`pkg install nodejs && npx -y omniroute`	Radi na vašem telefonu, neprekidno, bez root pristupa
📲 PWA	"Dodaj na početni zaslon"	Cijeli zaslon, izvanmrežni rad, instalacija iz preglednika
🧩 Dodatak za OpenCode	`@omniroute/opencode-provider`	Izvorna integracija s OpenCodeom
🤖 VS Code Copilot Chat	instalirajte proširenje OmniCopilot	Svaki OmniRoute model u izvornom izborniku modela aplikacije Copilot Chat — stabilna inačica i Insiders
🛠️ Iz izvornog koda	`npm install && npm run dev`	Prilagođavajte ga i doprinosite razvoju

_{📖 [Vodič za Docker](docs/guides/DOCKER_GUIDE.md) · [Radna površina](electron/README.md) · [Traka izbornika](https://github.com/zoispag/omniroute-tray) · [Termux](docs/guides/TERMUX_GUIDE.md) · [PWA](docs/guides/PWA_GUIDE.md) · [OpenCode](docs/frameworks/OPENCODE.md)}

### 🧩 Novo: OmniRoute unutar izvornog sučelja Copilot Chat u VS Codeu

> Nema nove bočne trake ni novog sučelja za razgovor — svaki model koji OmniRoute poslužuje prikazuje se izravno u > **izborniku modela aplikacije Copilot Chat koji već upotrebljavate**. Od verzije VS Code 1.122 modeli pružatelja rade > bez prijave na GitHub ili pretplate na Copilot — agentski način rada, pozivanje alata i obrada slika, > besplatno. Instalirajte proširenje **[OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)**, usmjerite ga na svoj OmniRoute poslužitelj (zadano je `localhost:20128`), a zatim otvorite Copilot Chat → izbornik modela → **Upravljanje modelima…** → **OmniRoute**.

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

Iz uređivača: otvorite prikaz **Proširenja**, potražite **"OmniRoute"** i kliknite **Instaliraj** — postupak je jednak u objema trgovinama. Izvorni kod, prijave problema i upute 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}

### 🎩 Novo: OmniRouteTray — vaš pristupnik koji živi u traci izbornika

> `omniroute serve` najbolje radi kada je uvijek uključen. **[OmniRouteTray](https://github.com/zoispag/omniroute-tray)** > pretvara ga u macOS aplikaciju u traci izbornika koju možete postaviti i zaboraviti: pokreće poslužitelj, održava ga aktivnim > nakon ponovnih pokretanja, ažurira ga na mjestu i omogućuje pristup vašem trenutačnom budžetu tokena jednim klikom — **bez > otvorenog prozora terminala i bez potrebe za održavanjem naredbe `npm install -g omniroute`.** Izrađen s pomoću alata [Tauri v2](https://v2.tauri.app/) (Rust jezgra zanemarive veličine), isporučuje se s vlastitim potpisanim izvođenjem Node 24 i upravlja instalacijom OmniRoutea u vlasništvu aplikacije, pa nikada nije u sukobu s vašim globalnim `node`/`bun` okruženjem. **Dijeli vašu postojeću konfiguraciju i bazu podataka u `~/.omniroute/`** — dakle, to je isti OmniRoute koji već upotrebljavate, samo sa šeširom. 🎩

Što radi	Kako
🟢 Nadzire poslužitelj	Pokreće `omniroute serve` i preuzima već pokrenutu instancu umjesto da je duplicira
📊 Trenutačna potrošnja na prvi pogled	Trake kvota pružatelja, ograničenja Claude sesije i tjedna ograničenja s odbrojavanjem do poništavanja te pregled troškova za 30 dana
🔄 Automatski se ažurira na mjestu	Postupna instalacija, atomska zamjena i vraćanje u slučaju neuspjeha — uvijek na najnovijem izdanju
🚀 Pokretanje pri prijavi	Neobavezno pokretanje pri prijavi; samo u traci izbornika, bez ikone u Docku
🩺 Dijagnostika i zapisnici	Dijagnostika jednim klikom i pristup zapisnicima poslužitelja

```sh brew install --cask zoispag/tap/omniroute-tray ``` _{Radije biste preuzeli aplikaciju? Nabavite najnoviju datoteku .dmg u odjeljku
Izdanja. Izvorni kod, prijave problema i dokumentacija za međuverziju
nalaze se na zoispag/omniroute-tray.

💛 Projekt zajednice autora @zoispag — nije službeno izdanje OmniRoutea.}

## 🔒 Privatno i prvenstveno lokalno

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

## 🔌 Cjelovit CLI + A2A i MCP

> Osim poslužitelja, OmniRoute je **cjelovito upravljačko okruženje naredbenog retka** s **više od 80 naredbi**, uz otvorene protokole za agente kako bi AI agent mogao njime upravljati **samostalno**. ### ⌨️ Pravi CLI (ne samo `start`) ```bash omniroute # pokreni pristupnik i nadzornu ploču (port 20128) omniroute chat # interaktivni TUI klijent za razgovor (kosa crta: /model /combo /skill /memory) omniroute setup # vođeni čarobnjak za prvo pokretanje omniroute doctor # dijagnosticiraj pružatelje, portove i izvorne ovisnosti ``` ### 🛰️ Udaljeni način rada — pokrenite CLI ovdje, a OmniRoute na VPS-u OmniRoute je na poslužitelju? Upravljajte njime s prijenosnog računala pomoću **istog CLI-ja**. Prijavite se jednom pomoću pristupnog tokena ograničenog dosega; svaka će naredba zatim ciljati udaljeni poslužitelj. ```bash omniroute connect 192.168.0.15 # lozinka → token ograničenog dosega, spremljen kao kontekst omniroute models # ← izvršava se na UDALJENOM poslužitelju omniroute configure codex # ← odabire udaljeni model, zapisuje lokalni Codex profil omniroute tokens create --name ci --scope read # izradi tokene užeg dosega za druga računala omniroute contexts use default # ← vrati se na lokalni poslužitelj ``` Tokeni imaju dosege `read` / `write` / `admin`; rute koje pokreću procese ostaju dostupne samo preko povratne petlje. _{📖 [Udaljeni način rada](docs/guides/REMOTE-MODE.md)}

Animirani terminal koji demonstrira OmniRoute CLI — omniroute providers list, omniroute combo list i omniroute health — prolazeći kroz skup od 86 naredbi najviše razine: 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 sam upravlja OmniRouteom Izložite OmniRoute putem **MCP-a**, **A2A-a**, **REST API-ja**, **webhookova** ili **udaljenog CLI-ja** — svaki sposoban agent (ili vaš vlastiti kôd) dobiva ključeve cijelog pristupnika: usmjeravanje, pružatelje, kombinacije, predmemoriju, kompresiju i memoriju — potpuno autonomno. HTTP krajnje točke u nastavku poslužuju se pod `http://localhost:20128`.

Sučelje	Krajnja točka / naredba	Upotrijebite za
🧰 MCP (stdio)	`omniroute --mcp`	Povezivanje s Claude Desktopom, Cursorom ili bilo kojim MCP klijentom
🌊 MCP (HTTP)	`/api/mcp/stream`	Udaljeni MCP — 110 alata, 33 dosega (primjena po izboru), cjelovit revizijski trag
📡 MCP (SSE)	`/api/mcp/sse`	MCP prijenos strujanjem
🤝 A2A	`/.well-known/agent.json`	Od agenta do agenta, JSON-RPC 2.0 + SSE, 6 vještina
🌐 REST API	`/v1/*`	Kompatibilno s OpenAI-jem — razgovor, ugrađivanja, slike, zvuk, OCR
🔔 Webhookovi	`/api/webhooks`	Slanje događaja zahtjeva / kvota u Slack, Discord, Telegram ili na bilo koji URL
🛰️ Udaljeni CLI	`omniroute connect`	Upravljanje udaljenom instancom pomoću pristupnih tokena ograničenog dosega

```bash # Omogućite alatu Claude Code cjelovit skup OmniRouteovih alata putem MCP-a: claude mcp add-server omniroute --type http --url http://localhost:20128/api/mcp/stream ``` _{📖 [MCP poslužitelj](docs/frameworks/MCP-SERVER.md) · [A2A poslužitelj](docs/frameworks/A2A-SERVER.md) · [Protokoli za agente](docs/frameworks/AGENT_PROTOCOLS_GUIDE.md)}

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

### 📖 Kako funkcionira — tijek obrade, arhitektura i izračun uštede

OmniRouteov tijek kompresije: ilustrativni klijentski zahtjev od 10.000 tokena prolazi kroz 12 kombinirajućih mehanizama — Session-Dedup, CCR, Lite, RTK, Responses Tool Output, Headroom, Relevance, Caveman, Aggressive, LLMLingua-2, Ultra i OmniGlyph — te u dokumentiranom složenom primjeru može doći do pružatelja s približno 1.080 tokena. Strukturirani sadržaj zaštićen je zaštitnim mehanizmima za očuvanje i provjerama vjernosti u svakom koraku; eksplicitni načini rada s gubicima ili eksperimentalni načini mogu transformirati prikladan sadržaj.

Zadana složena kombinacija izvodi `RTK → Caveman`. Kada oba djeluju na isti sadržaj alata/konteksta, uštede se umnožavaju: ```txt kombinirano = 1 − (1 − RTK) × (1 − Caveman_ulaz) prosjek = 1 − (1 − 0.80) × (1 − 0.46) = 89.2% raspon = 78.4 – 94.6% ``` Blokovi koda, URL-ovi, JSON i strukturirani podaci **uvijek su zaštićeni** mehanizmom za očuvanje. > **Zašto upotrebljavati mnogo tokena kada je nekoliko dovoljno?** Svaki zahtjev prolazi kroz OmniRouteov tijek kompresije **transparentno** — bez promjena na klijentu. Sada je to **skup od 12 kombinirajućih mehanizama** koji se izvršavaju redom te se mogu proizvoljno kombinirati za svaku kombinaciju usmjeravanja — nadograđujući ideje iz projekata [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). ### 🧱 Skup od 12 mehanizama Mehanizmi se izvršavaju redoslijedom tijeka obrade; svaki se može zasebno uključiti ili isključiti te konfigurirati za svaku kombinaciju:

#	Mehanizam	Što radi
1	Session-Dedup	Uklanja sadržaj koji se ponavlja kroz više poteza (adresiran sadržajem, između poteza)
2	CCR	Arhivira velike blokove iza oznaka za dohvaćanje, a dohvaća ih na zahtjev
3	Lite	Uklanjanje suvišnih razmaka i skraćivanje URL-ova slika (osnovna opcija s malom latencijom)
4	RTK	Pametno filtriranje, deduplikacija i skraćivanje rezultata alata (uz razumijevanje naredbi)
5	Responses Tool Output	JSON prvenstveno bez gubitaka i ograničena dijagnostička kompresija izlaza ljuske/zakrpa/pretraživanja/izgradnje (Responses API)
6	Headroom	Tablično sažimanje JSON nizova bez gubitaka (~30%) putem ugrađenog kodeka GCF
7	Relevance	Ekstraktivno ocjenjivanje rečenica u odnosu na posljednji korisnički upit
8	Caveman	Kompresija proze temeljena na pravilima (~65–75% na izlazu)
9	Aggressive	Sažimanje i progresivno starenje starih poteza
10	LLMLingua-2	Semantičko obrezivanje strojnim učenjem putem MobileBERT ONNX-a — sigurno za kod, asinkrono
11	Ultra	Heurističko obrezivanje tokena s opcionalnim slojem malog modela (SLM)
12	OmniGlyph	Eksperimentalno kodiranje konteksta kao slike za izmjereni Claude Fable 5 putem izravne veze s Anthropicem; transformatori GPT 5.6 ostaju zatvoreni u slučaju pogreške dok se ne zaprime potvrde pružatelja. Četiri profila kompresije (zadani agresivni, uravnoteženi, siguran za kod, bez obrade) (najagresivniji; zahtijeva izričito uključivanje)

Blokovi koda, URL-ovi i strukturirani podaci **uvijek se očuvaju** identično na razini bajtova. **Unaprijed postavljene opcije jednim klikom** kombiniraju mehanizme:

Način rada	Ušteda	Najbolje za
🪶 Lite	~15%	Sigurna zadana opcija koja je uvijek uključena
🪨 Standard (Caveman)	~30%	Svakodnevno programiranje
⚡ Aggressive	~50%	Duge sesije s intenzivnom upotrebom alata
🔥 Ultra	~75%	Maksimalna ušteda
🧰 RTK	60–90%	Izlaz ljuske/testiranja/izgradnje/gita
🔗 Složeno (RTK → Caveman)	78–95%	Mješoviti upiti i zapisnici alata

**Stvarni primjer — način rada Standard:** > **Prije (69 tokena):** _"Razlog zbog kojeg se vaša React komponenta ponovno iscrtava vjerojatno je taj što stvarate novu referencu na objekt u svakom ciklusu iscrtavanja. Kada proslijedite objekt definiran u retku kao prop, Reactova plitka usporedba svaki ga put prepoznaje kao drukčiji objekt, što pokreće ponovno iscrtavanje. Preporučujem upotrebu useMemo za memoizaciju objekta."_ > > **Poslije (19 tokena):** _"Nova referenca objekta pri svakom iscrtavanju. Objektni prop u retku = nova referenca = ponovno iscrtavanje. Omotajte u useMemo."_ > > **Isti odgovor. 72% manje tokena. Bez gubitka točnosti.** ✅ **Primjer na PT-BR-u — način rada [Troglodita](https://github.com/leninejunior/troglodita):** > **Prije (42 tokena):** _"Problem je u tome što se komponenta ponovno iscrtava jer se u svakom ciklusu iscrtavanja stvara nova referenca na objekt. Preporučio bih upotrebu useMemo."_ > > **Poslije (12 tokena):** _"Ponovno iscrtavanje: nova ref. u svakom ciklusu (ponovno stvoren inline objekt). Upotrijebiti `useMemo`."_ > > **Isti odgovor. ~70% manje tokena. Tehnička preciznost netaknuta.** ✅
### 🎚️ Više od pogonskih mehanizama — stilovi izlaza, prilagodljivi regulator i kontrola po zahtjevu Navedenih 12 pogonskih mehanizama sažimaju ono što ulazi **unutra**. Tri dodatna sloja oblikuju **kako**, **kada** i što izlazi **van**: - **🪄 Stilovi izlaza** _(usmjeravanje osi izlaza)_ — umeću determinističke upute za oblikovanje odgovora, sigurne za predmemoriranje; mogu se kombinirati, svaki s intenzitetom `lite` / `full` / `ultra`. Dodavanje stila zahtijeva jedan redak u registru: - **Sažeta proza** — uklanja poštapalice / članove / ograđivanje; tehnički sadržaj ostaje precizan. - **Manje koda** — YAGNI „lijenog starijeg programera”: najmanja funkcionalna izmjena, bez nezatražene infrastrukture. - **Konjski rep (lijeni stariji programer)** — uspinje se YAGNI ljestvicom, uklanja temeljni uzrok, najmanji funkcionalni diff. - **Imam ADHD (prvo radnja)** — započinje sljedećom radnjom, koraci su numerirani, jedan konkretan sljedeći korak, bez uvoda. - **Sažeti CJK (文言)** — iznimno sažet stil klasičnog kineskog (ograničen na lokalitet `zh`). - **🎯 Prilagodljivi budžet konteksta** _(regulator)_ — umjesto jednog praga tokena za uključivanje/isključivanje, aktivira najjeftinije pogonske mehanizme s najmanjim gubitkom samo koliko je potrebno da sadržaj **stane u kontekstni prozor modela**. Pravilo: `reserve-output` (zadano, prilagođeno modelu) · `percentage` · `absolute`. Način rada: `floor` (jamči da sadržaj stane) · `replace-autotrigger` (vaš izričiti odabir ima prednost) · `off` (naslijeđeni prag). - **🎛️ Gdje se odlučuje o kompresiji** _(prioritet, od višeg prema nižem)_ — zaglavlje `x-omniroute-compression` po zahtjevu › nadjačavanje kombinacije usmjeravanja › aktivni imenovani profil › prilagodljiva opcija / automatsko aktiviranje › zadana postavka ploče › isključeno. Primijenjeni plan vraća se u zaglavlju odgovora `X-OmniRoute-Compression: ; source=`. Automatski aktivirajte kompresiju prema pragu tokena, uključite prilagodljivi regulator, prikvačite imenovani profil, postavite jednokratnu opciju po zahtjevu ili dodijelite procesni slijed svakoj kombinaciji usmjeravanja — što god odgovara radnom opterećenju. Izborni izvanmrežni **evaluacijski alat** (`npm run eval:compression`) ocjenjuje vjernost u odnosu na uštedu na fiksiranom korpusu prije nego što uvedete 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 li `npm warn ERESOLVE` ili upozorenja o peer ovisnostima? [Bezopasna su](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated). > **Upotrebljavate npm 11 ili noviji?** npm može blokirati skripte životnog ciklusa paketa ako nisu dopuštene. OmniRouteova skripta `postinstall` (`node scripts/build/postinstall.mjs`) potrebna je za pripremu njegovih izvornih izvršnih datoteka. Pri globalnoj instalaciji dopustite pakete navedene u npm upozorenju. Za skup paketa koji prijavljuje OmniRoute 3.8.51: > > ```bash > npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute > ``` > > Kako biste ponovno upotrijebili ovaj popis dopuštenih paketa za buduće globalne instalacije, konfigurirajte ga jednom, a zatim instalirajte na uobičajen način: > > ```bash > npm config set allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild --location=user > npm install -g omniroute > ``` > > Popis ovisnosti može se mijenjati između izdanja; ako npm prijavi drukčiji popis, upotrijebite nazive paketa iz tog upozorenja. Dopuštanje paketa omogućuje izvršavanje njegovih instalacijskih skripti. > **Upotrebljavate Gemini Web ili drugog pružatelja koji se služi web-kolačićima?** npm paket uključuje > Playwright, ali ne i njegovu binarnu datoteku Chromiuma. Prije prvog zahtjeva web-pružatelju pogledajte > napomenu o [postavljanju Playwright Chromiuma](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium). Nadzorna ploča dostupna je na `http://localhost:20128` · API na `http://localhost:20128/v1`. **2) Povežite prihvatljivog pružatelja vlastitim računom** Nadzorna ploča → **Pružatelji** → odaberite pružatelja čiji trenutačni uvjeti i kvota odgovaraju vašem slučaju upotrebe → dodajte njegov API ključ ili dovršite postupak povezivanja računa. Besplatne razine mogu zahtijevati registraciju, odobrenje ili način plaćanja. Pregledajte [Vodič za besplatne razine](docs/getting-started/FREE-TIERS-GUIDE.md); dostupnost bez ključa nije zajamčena, a pružatelji označeni s `tos: avoid` prema zadanim su postavkama isključeni iz `auto`. **3) Usmjerite svoj alat za programiranje** ```txt Osnovni URL: http://localhost:20128/v1 API ključ: [kopirajte iz Nadzorna ploča → Krajnje točke] Model: auto (usmjerava između prihvatljivih veza — ili odaberite pružatelja/model) ``` **4) Provjerite radi li** ```bash curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY" ``` Trebali biste vidjeti popis povezanih modela. 🎉 To je sve — počnite programirati, a OmniRoute će automatski usmjeravati zahtjeve i prebacivati se na pričuvne opcije. Ako vaš klijent ne može slati prilagođena zaglavlja, OmniRoute nudi i kompatibilne pseudonime s tokenima: ```txt OpenAI katalog: http://localhost:20128/vscode/YOUR_KEY/ OpenAI modeli: http://localhost:20128/vscode/YOUR_KEY/models OpenAI razgovor: http://localhost:20128/vscode/YOUR_KEY/chat/completions OpenAI odgovori: http://localhost:20128/vscode/YOUR_KEY/responses Ollama razgovor: http://localhost:20128/vscode/YOUR_KEY/api/chat Ollama oznake: http://localhost:20128/vscode/YOUR_KEY/api/tags ``` Upotrebljavajte ih samo za klijente koji ne mogu dodati `Authorization: Bearer ...`. Autentikacija zaglavljem i dalje je preporučeni način.
## 📦 Više načina 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 najvišu **objavljenu** stabilnu SemVer verziju. Ne prati git granu `main`. Za GitOps fiksirajte `:X.Y.Z`. Pogledajte [Dockerove kanale izdanja](docs/guides/DOCKER_GUIDE.md#release-channels).Slika fiksira **`OMNIROUTE_MEMORY_MB=1024`**. To je dovoljno za nadzornu ploču i lagani razgovor. **Agenti za programiranje** (`POST /v1/responses` iz Claude Codea, Codexa, Groka, …) trebaju znatno veću V8 memorijsku hrpu ili će proces završiti porukom `FATAL ERROR` pri približno 12 GiB tijekom dvaju preklapajućih dugih konteksta. Dodijelite spremniku više memorije od veličine hrpe (izvorni međuspremnici nalaze se izvan V8): | Radno opterećenje | Hrpa (`-e OMNIROUTE_MEMORY_MB`) | Spremnik (`--memory`) | | ---------------------------------- | ------------------------------- | --------------------- | | Nadzorna ploča / lagani razgovor | `1024` (zadano u slici) | ≥2 g | | Jedan agent za programiranje | `8192` | ≥10 g | | Dva istodobna duga `/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 vodič — RAM tijekom izvođenja](docs/guides/DOCKER_GUIDE.md#runtime-ram-for-coding-agents). > **Dockerov kanal predizdanja:** `diegosouzapw/omniroute:next` i > `diegosouzapw/omniroute:next-web` prate trenutačnu zadanu granu `release/v*`. > Te promjenjive oznake namijenjene su isključivo testiranju još neobjavljenih ispravaka i > **nisu podržane za produkciju**. Pogledajte > [Dockerove kanale izdanja](docs/guides/DOCKER_GUIDE.md#release-channels). **🥟 Bun** Standardni `bun install` i globalna instalacija (`bun install -g omniroute`) podržani su putem otkrivanja Bunovog izvršnog okruženja: - **Ugrađeni `bun:sqlite`**: OmniRoute tijekom izvođenja pod Bunom upotrebljava Bunov ugrađeni upravljački program `bun:sqlite`, uz povratak na `better-sqlite3` u okruženju Node.js ili na `sql.js`. - **Automatski odabir Webpack alata za objedinjavanje u razvoju**: Razvojno okruženje (`bun run dev`) automatski otkriva Bun i onemogućuje Turbopack u korist Webpacka kako bi spriječilo nekompatibilnosti s izvornim V8 vezama. Produkcijske međuverzije (`bun run build`) slijede `OMNIROUTE_USE_TURBOPACK` potpuno jednako kao na Nodeu: Turbopack je zadan, a `OMNIROUTE_USE_TURBOPACK=0` služi za izgradnju pomoću Webpacka (`Dockerfile.bun` izlaže ga kao `--build-arg`). - **Namjenski Bun Dockerfile**: Višefazni `Dockerfile.bun` za izvorne produkcijske implementacije Buna (`docker build -f Dockerfile.bun -t omniroute:bun .`). ```bash # Instalirajte i pokrenite pomoću Buna 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 # Upotreba Nix flakesa nix develop npm run dev # Ili upotreba devboxa devbox run npm run dev ``` 📖 [Docker vodič](docs/guides/DOCKER_GUIDE.md) — Compose profili, Caddy HTTPS, Cloudflare tuneli. **🦭 Podman** ```bash # 1. Pripremite vezano montirani direktorij podataka mkdir -p data # 2. Samo Linux + lokalni rootless Podman (nikada udaljeni klijent Podman Machinea): podman unshare chown 1000:1000 ./data # 3. Postavite naznaku izvršnog okruženja, izgradite lokalnu Compose sliku i pokrenite echo "CONTAINER_HOST=podman" >> .env podman compose --profile base up -d --build ``` Na sustavima macOS ili Windows Podman upotrebljava udaljeni Podman Machine: preskočite `podman unshare` i slijedite [upute za direktorij podataka specifične za topologiju](contrib/podman/README.md#data-directory-permissions-by-topology). 📖 [Podman vodič](contrib/podman/README.md) — Compose međuverzije, Podman Machine i postavljanje Quadleta za Linux/systemd. **⚡ Brža / jednostavnija instalacija (preskočite izvornu izgradnju)** Izvorni SQLite pogon (`better-sqlite3`) **neobavezna** je ovisnost, pa globalna instalacija nikada ne čeka prevođenje iz izvornog koda: upotrebljava unaprijed izgrađenu binarnu datoteku kada odgovara vašoj platformi/Nodeu, a u suprotnom se neprimjetno prebacuje na čisti JS pogon (`node:sqlite` na Nodeu 22+, inače priloženi `sql.js` WASM) — alati za izgradnju nisu potrebni. Za potpuno preskakanje **zagrijavanja izvornog modula** nakon instalacije (CI, sustavi bez grafičkog sučelja ili spora računala). Napomena: time se preskače samo korak zagrijavanja izvornog SQLitea (`scripts/postinstall.mjs`); skripta za kopiranje/popravak binarne datoteke (`scripts/build/postinstall.mjs`) i dalje se izvršava uobičajeno: ```bash OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute # CI=1 također ga preskače ``` Za najbrže instalacije odaberite **pnpm** (pohrana adresirana sadržajem + čvrste poveznice — pogledajte iznad). Za izvršno okruženje bez nadzorne ploče i grafičkog sučelja upotrijebite Dockerov profil `base` (iznad) ili [Termux vodič](docs/guides/TERMUX_GUIDE.md). CLI i web-nadzornu ploču poslužuje isti proces na jednom priključku, pa trenutačno ne postoji zaseban paket samo za CLI.

# 🎬 OmniRoute na djelu

## 📹 Videovodiči

_{Snimka nadzorne ploče na dan 2026-08-24 · Neobrađeni katalog: YT 809 | TT 137 | IG 124 · Svježina (dani): 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}

**Cjeloviti 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** | Kanonske metrike na dan 2026-08-24: **1.029 jedinstvenih videozapisa** · **11.132.922 poznata pregleda** (`v > 0`) · **639 kanala/profila po mreži**. Neobrađena nadzorna ploča sadrži 1.070 redaka; 41 duplikat s Instagrama normaliziran je prema kanonskom URL-u, uz zadržavanje najvećeg broja pregleda po videozapisu. > 🎬 **Snimili ste videozapis o OmniRouteu?** Otvorite [prijavu problema](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 prijavu problema. | Kanal | Gdje / kako | | ---------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- | | 💼 **LinkedIn** — pratite održavatelja | [linkedin.com/in/diegosouzapw](https://www.linkedin.com/in/diegosouzapw/) | | 🐙 **GitHub** — pratite 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)** | [StHub portal](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 pogrešku** | [otvorite prijavu](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 skup

Sloj	Tehnologija
Izvršno okruženje	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/` (bez ijednog `any` u jezgri od verzije v2.0)
Radni okvir	Next.js 16 + React 19 + Tailwind CSS 4
Baza podataka	better-sqlite3 (SQLite, WAL vođenje dnevnika) + LowDB (naslijeđeni JSON) — 137 domenskih modula, 202 migracije
Memorija	SQLite FTS5 pretraživanje punog teksta + int8-kvantizirane vektorske ugradnje, tipizirano slabljenje
Sheme	Zod 4 — validacija ulaza/izlaza MCP alata + API ugovori
Protokoli	MCP (stdio / HTTP / SSE) + A2A v0.3 (JSON-RPC 2.0 + SSE)
Strujanje	Server-Sent Events (SSE) + WebSocket most (`/v1/ws`)
Kompresija	Cjevovod s 12 mehanizama — RTK, Caveman, LLMLingua-2 (MobileBERT ONNX), GCF, OmniGlyph
Autentifikacija i sigurnost	OAuth 2.0 (PKCE) + JWT + API ključevi + MCP autentifikacija ograničena opsegom · AES-256-GCM za pohranjene podatke · DOMPurify
Prikrivenost	wreq-js — oponašanje JA3 / JA4 TLS otiska, proxy u 3 razine
Otpornost	Prekidač strujnog kruga, eksponencijalno odgađanje, zaštita od stampeda zahtjeva, samoispravljanje automatskih kombinacija
Bilježenje	pino — strukturirani JSON zapisi s kontekstom zahtjeva
Testiranje	Node.js pokretač testova + Vitest — više od 39.000 statičkih deklaracija testova u više od 5.100 praćenih testnih datoteka (jedinični, integracijski, E2E, sigurnosni i ekosustavski testovi)
Platforme	Stolna računala (Electron) · Android (Termux) · PWA (bilo koji preglednik)
CI/CD	GitHub Actions — automatska objava na npm i Docker Hub pri izdanju
Poveznice	Web-stranica · npm · Docker Hub

## 📖 Dokumentacija

### 📘 Početak rada

Dokument	Opis
Korisnički vodič	Pružatelji usluga, kombinacije, integracija s CLI-jem, postavljanje
Vodič za postavljanje	Svi načini instalacije, konfiguracije CLI alata, postavljanje protokola, podešavanje vremenskih ograničenja
Vodič za CLI alate	Postavljanje pojedinačnih alata Claude Code, Codex, Cursor, Cline, OpenClaw, Kilo i Copilot
Udaljeni način rada	Upravljajte udaljenim OmniRouteom (VPS) iz CLI-ja na prijenosnom računalu putem pristupnih tokena ograničenog opsega
Konfiguracija za Claude Code	Usmjerite Claude Code na OmniRoute (lokalni/udaljeni) pomoću `launch` i zasebnih profila za svaki model
Brzi početak	Instalacija u 3 koraka → povezivanje → konfiguriranje

### 🔧 Operacije i postavljanje

Dokument	Opis
Vodič za Docker	Docker run, Compose profili, Caddy HTTPS, tuneli, oznake slika
Vodič za Podman	Integracija Quadleta sa systemd, podman-compose, SELinux
Postavljanje na VM	Potpuni vodič: postavljanje VM-a, nginx-a i Cloudflarea
Postavljanje na Fly.io	Postavite na Fly.io s trajnom pohranom
Vodič za Termux	Pokrenite OmniRoute na Androidu putem Termuxa
Vodič za PWA	Instalacija progresivne web-aplikacije, predmemoriranje, arhitektura
Vodič za deinstalaciju	Potpuno uklanjanje za sve načine instalacije
Konfiguracija okruženja	Potpun popis varijabli u `.env` i referenci

### 🧠 Značajke i arhitektura

Dokument	Opis
Arhitektura	Arhitektura sustava, tok podataka i unutarnji mehanizmi
Vodič za kompresiju	Proces sa 7 opcija: off / lite / standard / aggressive / ultra / RTK / stacked
RTK kompresija	Kompresija izlaza naredbi, filtri, pouzdanost, provjera i oporavak neobrađenog izlaza
Mehanizmi za kompresiju	Caveman, RTK, složeni procesi te sučelja nadzorne ploče/API-ja/MCP-a
Format pravila kompresije	Sheme JSON paketa pravila za filtre Caveman i RTK
Jezični paketi za kompresiju	Prepoznavanje jezika i izrada Caveman paketa pravila
Vodič za otpornost	Prekidači strujnog kruga, razdoblja hlađenja, red čekanja, sprječavanje stampeda zahtjeva i lažiranje TLS-a
Mehanizam Auto-Combo	Bodovanje na temelju 16 čimbenika, paketi načina rada i samooporavak
Vodič za proxy	Proxy sustav s 3 razine, tržište 1proxy i CRUD registra
Besplatne razine	Objedinjeni imenik: 35 dokumentiranih skupova s ponavljajućom dostupnošću / 489 katalogiziranih stavki besplatne razine
Galerija značajki	Vizualni obilazak nadzorne ploče sa snimkama zaslona
Dokumentacija baze koda	Vodič kroz bazu koda prilagođen početnicima

### 🤖 Protokoli i API-ji

Dokument	Opis
Referenca API-ja	Sve krajnje točke s primjerima
Specifikacija OpenAPI	Specifikacija OpenAPI 3.0
MCP poslužitelj	110 MCP alata, IDE konfiguracije i klijenti za Python/TS/Go
Vodič za MCP poslužitelj	Instalacija MCP-a, prijenosi i referenca alata
A2A poslužitelj	Protokol JSON-RPC 2.0, vještine, strujanje i upravljanje zadacima
Vodič za A2A poslužitelj	Kartica A2A agenta, zadaci, vještine i strujanje

### 📋 Projekt i kvaliteta

Dokument	Opis
Doprinošenje	Postavljanje razvojnog okruženja i smjernice
Model grananja i izdanja	Na koje se grane usmjeravaju PR-ovi (`release/*`) te što znače `main` i oznake
Dnevnik promjena	Potpuna povijest izdanja po verzijama
Sigurnosna pravila	Prijavljivanje ranjivosti i sigurnosne prakse
Vodič za i18n	Podrška za 42 jezika, tijek prevođenja i RTL
Kontrolni popis za izdanje	Koraci provjere prije izdanja
Plan pokrivenosti	Strategija pokrivenosti testovima za više od 39.000 statičkih deklaracija testova u više od 5.100 praćenih testnih datoteka

# ⭐ 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 broju spojenih zahtjeva za povlačenje

Poredak	Suradnik	Spojeni PR-ovi	~Promijenjeni redci
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

_{Zamrznuto na aktualnom vrhu grane release/v3.8.50, dafb4ae808, sa spajanjima zaključno s 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 suradnika. „Promijenjeni redci” zbroj su dodavanja i brisanja na GitHubu te uključuju generirane datoteke, datoteke zaključavanja, kataloge, prijevode i dokumentaciju; to je količina izmjena, a ne autorski LOC. Izjednačenja na granici uključena su.} ### Commitovi koje je pripisao GitHub

backryun _{🥇 220 commitova koje je pripisao GitHub}	Paijo _{🥈 219 commitova koje je pripisao GitHub}	Randi _{🥉 108 commitova koje je pripisao GitHub}	Ravi Tharuma _{🏅 81 commit koje je pripisao GitHub}	Chris _{🏅 70 commitova koje je pripisao GitHub}	Markus Hartung _{🏅 69 commitova koje je pripisao GitHub · dijeli 6. mjesto}
Dizzle _{🏅 69 commitova koje je pripisao GitHub · dijeli 6. mjesto}	Jan Leon _{🏅 64 commita koje je pripisao GitHub}	zenobit _{🏅 62 commita koje je pripisao GitHub}	Bob.Hou _{🏅 51 commit koji je pripisao GitHub · dijeli 10. mjesto}	Xiangzhe _{🏅 51 commit koji je pripisao GitHub · dijeli 10. mjesto}

_{Ponovno provjereno 2026-08-24 06:14:31 UTC: commitovi koje je pripisao GitHub prema API-ju Contributors repozitorija za zadanu granu release/v3.8.50. API je vratio 525 identiteta (415 korisnika, 2 bota, 108 anonimnih); ova tablica ne uključuje održavatelja, botove ni anonimne identitete te zadržava izjednačena mjesta. Razlikuje se i od prethodno navedenog poretka prema spojenim PR-ovima i od popisa 639 osoba prema Git metapodacima u nastavku.} > 🙏 Funkcionalnosti, ispravci pogrešaka i poboljšanja infrastrukture ovih doprinositelja **ključan su dio** onoga što OmniRoute čini pouzdanim i bogatim funkcionalnostima. Svaki zahtjev za spajanje, svaki testni slučaj i svaka i18n datoteka prijevoda važni su. Otvoreni kod izgrađuju ljudi poput njih.

---
## 💖 Sponzori

Od srca zahvaljujemo ljudima koji financiraju OmniRoute iz vlastitog džepa — svaki doprinos pomaže projektu da ostane besplatan, neovisan i nastavi napredovati.

Andrew
_{💛 Aktivni mjesečni sponzor}

Vlad I
_{💛 Aktivni mjesečni sponzor}

Paco Cartones
_{💛 Aktivni jednokratni sponzor}

Prof. Igor Morais
_{💛 Prijašnji jednokratni podržavatelj}

longtao
_{💛 Prijašnji jednokratni podržavatelj}

_{… i ostali koji žele ostati anonimni 💛} _{Javni sponzori na GitHub Sponsors ponovno su provjereni 2026-08-24. GitHubov status activeOnly određuje gore navedene oznake aktivnosti; i dalje zahvaljujemo prethodno objavljenim javnim jednokratnim podržavateljima, dok privatni sponzori ostaju anonimni.} 💖 Postanite sponzor → — svaki dolar pomaže da OmniRoute ostane besplatan i neovisan.

## 👥 Više od 600 suradnika

[![Suradnici](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 aktualnom vrhu grane release/v3.8.50, dafb4ae808: 639 normaliziranih ljudskih Git identiteta — 407 pojavljuje se kao autor commitova (uključujući održavatelja), a 232 samo u izričitim završnim oznakama Co-authored-by. Popis normalizira GitHubove noreply identifikatore, isključuje 26 identiteta botova, agenata, servisa i rezerviranih oznaka te ne spaja obične adrese e-pošte samo zato što imaju ista prikazana imena.} ### Kako doprinijeti 1. Napravite fork repozitorija 2. Izradite granu iz **aktivnog** vrha grane `release/vX.Y.Z` (ne iz `main`) — pogledajte [Model grananja i izdanja](docs/ops/BRANCHING_MODEL.md) 3. Izradite svoju granu značajke (`git checkout -b feat/amazing-feature`) 4. Commitajte svoje promjene (`git commit -m 'feat: add amazing feature'`) 5. Pošaljite promjene na granu (`git push origin feat/amazing-feature`) 6. Otvorite Pull Request s postavkom **base = ta grana `release/vX.Y.Z`** Detaljne smjernice potražite u datoteci [CONTRIBUTING.md](CONTRIBUTING.md). ### Objavljivanje nove verzije ```bash # Izradite izdanje — npm publish izvršava se automatski VERSION=x.y.z gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes ```

## 📊 Zvjezdice

## 🌍 StarMapper

## 🙏 Zahvale

OmniRoute stoji na ramenima divova. Započeo je kao fork projekta **[9router](https://github.com/decolua/9router)** i TypeScript port Go projekta **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** — a otad je svaki podsustav naveden u nastavku nadahnut projektom otvorenog koda koji je to učinio prvi. Svaki od njih oblikovao je konkretan dio sustava OmniRoute. Ovo je naša zahvala svima njima. 🙏 > ⭐ broj zvjezdica provjeren je putem GitHubova REST API-ja 24. kolovoza 2026. — podržite ove projekte zvjezdicom. Brojevi predstavljaju točan snimak stanja na navedeni datum i prirodno će se mijenjati. ### 🧬 Podrijetlo i pristupnik

Projekt	⭐	Kako je nadahnuo OmniRoute
9router	26,161	Izvorni projekt na kojem se temelji ovaj fork — ovdje proširen multimodalnim API-jima i u potpunosti ponovno napisan u TypeScriptu.
CLIProxyAPI	48,497	Implementacija u jeziku Go koja je nadahnula ovaj prijenos na JavaScript / TypeScript.
LiteLLM	57,100	AI pristupnik čiji javni skup podataka o cijenama opskrbljuje našu sinkronizaciju praćenja troškova i čiji je model normalizacije pružatelja utjecao na naše usmjeravanje.
codex-chatgpt-web	1,410	MIT izvorni kod prilagođen u ugrađeni most ChatGPT Web → Codex Responses, uključujući prilagodnike za sesije preglednika, oblikovanje odgovora, potrošnju i web-pretraživanje.
free-claude-code	48,112	Obrasci preneseni u oporavak streama, pseudonime bez razmišljanja, pričuvno web-pretraživanje, ograničenja kliznog prozora, redigiranje zapisnika i ojačane tijekove pokretača.
composer-api	322	Obrasci odabira alata, ograničenja izlaza i potvrđivanja alata za Cursor Composer prilagođeni u izvorni Cursor izvršitelj.
codex-multi-auth	457	Obrasci nove prijave i rotacije tokena za osvježavanje preneseni u ponovnu autentifikaciju za Codex OAuth.
opencode-anthropic-auth	510	Zadane postavke transformacije kompatibilne s Claude Codeom i ponašanje zaglavlja za naplatu generalizirani su u OmniRouteov most vođen konfiguracijom.
grok2api-merged	2	Njegova mapiranja modela Grok, Statsig generator lažnog TypeErrora, zadane postavke zahtjeva i uređaja te procesor NDJSON odgovora značajno su prilagođeni u OmniRouteov izvršitelj za Grok Web.
TQZHR/grok2api	705	Glavni tranzitivni izvor koda na kojem se temelji grok2api-merged; njegove implementacije modela, zaglavlja, korisnog sadržaja, Statsiga i procesora očuvane su u razvojnoj liniji Grok Weba.
chenyme/grok2api	7,520	Temeljni MIT izvorni kod za zadane postavke korisnog sadržaja i uređaja za Grok, Statsig generator i procesor `result.response` prenesen preko projekata TQZHR i grok2api-merged.
grok2api-pro	27	Tranzitivni izvor koji grok2api-merged navodi za svoj sloj skupa proxyja; OmniRoute zadržava tu napomenu o podrijetlu, ali ne tvrdi da je prenio skup proxyja u svoj ograničeni izvršitelj za Grok Web.
GrokProxy	50	Njegov Grok proxy autentificiran kolačićima i obrazac streaminga `result.response.token` utjecali su na OmniRouteov prijenosni sloj za Grok Web.
GrokBridge	5	Izvorna implementacija Grok Weba oslanjala se na njegov dizajn uzvodne HTTP/pregledničke komunikacije; njezin izravni HTTP put izveden je iz projekta GrokProxy, stoga se ne tvrdi da je riječ o neovisnom prijenosu koda.
grok-web-api	14	Njegove Rust sheme `ChatOptions` i omotnice odgovora utjecale su na OmniRouteove TypeScript tipove Grok zahtjeva i streaming odgovora.

### 🗜️ Kompresija konteksta i tokena — mehanizmi

Projekt	⭐	Kako je nadahnuo OmniRoute
Caveman	100,538	Viralni projekt „zašto koristiti mnogo tokena kad malo tokena postiže isto” — njegova filozofija pećinskog govora pokreće naš standardni način kompresije i više od 30 pravila za uklanjanje poštapalica i sažimanje.
RTK – Rust Token Killer	77,185	Kompresija izlaza naredbi visokih performansi — nadahnula je naš RTK mehanizam, DSL za filtriranje JSON-a, oporavak neobrađenog izlaza i ulančani proces RTK → Caveman.
headroom	67,310	Reverzibilna kompresija konteksta (SmartCrusher) — nadahnula je naš mehanizam `headroom` i obrazac oznake za dohvaćanje `ccr`.
LLMLingua	6,598	Istraživanje kompresije upita (LLMLingua / LLMLingua-2) — nadahnulo je naš asinkroni mehanizam `llmlingua`, siguran za kôd i otporan na pogreške.
llmlingua-2-js	31	JS/ONNX prilagodba (MobileBERT / XLM-RoBERTa) koja se upotrebljava kao pozadinski sustav radne dretve za naš LLMLingua mehanizam.
Troglodita	40	Kompresija tokena za pt-BR — pokreće naš jezični paket za pt-BR: smanjivanje pleonazama i uklanjanje poštapalica prilagođeno gramatici brazilskog portugalskog.
ponytail	108,957	Viralna vještina kodiranja „lijenog starijeg programera” u skladu s načelom YAGNI — nadahnula je naš izlazni stil less-code: usmjeravanje prema najmanjoj funkcionalnoj promjeni koje smanjuje _generirani_ kôd (izlazni pandan Cavemanovoj sažetoj prozi).
i-have-adhd	23,526	Njegov stil odgovora prilagođen osobama s ADHD-om, koji daje prednost konkretnim radnjama, prilagođen je u sažeti izlazni stil OmniRoutea na pet jezika.

### 🧩 Kompaktni formati, istraživanje tokena i alati svjesni kôda

Projekt	⭐	Kako je nadahnuo OmniRoute
TOON	25,233	Objektna notacija usmjerena na tokene — njezin stupčasti model zaglavlja i redaka oblikovao je našu fazu tabličnog sažimanja.
GCF – Graph Compact Format	41	Njegov kompaktni format grafa i dizajn generičkog profila utjecali su na tablično sažimanje OmniRoutea i format kodeka Headroom.
gcf-typescript	4	Implementacija za TypeScript pod licencom MIT, izravno ugrađena i proširena kao Headroomov kodek generičkog profila.
token-optimizer-mcp	494	Predmemorija Brotli/SQLite i delta konteksta po sesiji — nadahnuli su naš mehanizam `session-dedup`.
token-savior	1,122	Sažimanje Bash izlaza i MCP profili — nadahnuli su našu disciplinu odustajanja od kompresije i smanjivanje manifesta MCP alata.
token-saver	138	Kompresija izlaza svjesna sadržaja i prilagođena pojedinoj vrsti datoteke, uz odustajanje u slučaju pogreške — potvrdila je naše usmjeravanje prema vrsti i preskakanje pri nedovoljnoj uštedi.
token-optimizer	1,951	„Pronađite nevidljive tokene” — njegov obrazac izdvajanja i obnovljive reference utjecao je na naš pristup izdvajanju CCR-a.
TokenMizer	28	Predložak grafa sesije i uklanjanja dupliciranih redaka između poteza koji je utjecao na dizajn našeg mehanizma session-dedup.
OmniCompress	3	Stupčasti JSON u Rustu, dohvaćanje prema sadržaju i uklanjanje duplikata između poruka — potvrdili su dizajn naših mehanizama `headroom`/`ccr`/`session-dedup` i invarijantu stabilnu za predmemoriju „komprimirani oblik neovisan je o položaju”.
mcp-compressor	113	Kompresija shema i opisa MCP alata — utjecala je na naše smanjivanje kardinalnosti manifesta MCP alata.
RepoMapper	197	Rangiranje mape repozitorija u stilu Aidera — utjecalo je na naše istraživanje mapa repozitorija i rangiranja dohvaćanja.
quiet-shell-mcp	4	Deklarativno smanjivanje izlaza ljuske putem MCP-a — potvrdilo je naše deklarativno sažimanje Bash izlaza.
ts-morph	6,162	Komplet alata za TypeScript Compiler API — nadahnuo je naše uklanjanje komentara temeljeno na parseru koje čuva literale nizova, predložaka i regularnih izraza.

### 🧠 Memorija i RAG

Projekt	⭐	Kako je nadahnuo OmniRoute
Mem0	63,902	Univerzalni memorijski sloj — njegov model proxyja kao granice za pisanje i čitanje oblikovao je našu memorijsku arhitekturu.
Letta (MemGPT)	24,382	Agenti sa stanjem i višerazinskom memorijom — nadahnuli su naš višerazinski model za upravljanje kontekstom i oporavak (CCR).
WFGY	1,781	Taksonomija ProblemMap sa 16 ponavljajućih načina otkazivanja sustava RAG/LLM — zajednički rječnik u našem vodiču za otklanjanje poteškoća.

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

Projekt	⭐	Kako je nadahnuo OmniRoute
llm-interceptor	66	MITM presretanje i analiza prometa između pomoćnika za programiranje i LLM-a utjecali su na rane zahtjeve za Traffic Inspector. Četiri prethodno izvedena modula — spajanje SSE-a, normalizacija razgovora, maskiranje tajni i pročišćavanje zaglavlja — zamijenjena su neovisnim implementacijama čistog dizajna temeljenima na javnim standardima protokola. Dvije površine za izravno prosljeđivanje na glavno računalo (`passthrough.ts` i `_internal/bypass.cjs`) ostaju interne implementacije sustava OmniRoute koje su neovisno klasificirane; nisu ponovno napisane u sklopu te zamjene.
ProxyBridge	5,995	Transparentno usmjeravanje proxyja po procesu — nadahnulo je naše sigurno prekidanje MITM-a u slučaju rušenja, vremenska ograničenja neaktivnosti utičnica, pripisivanje procesa putem `/proc` i TPROXY presretanje.

### 📚 Podaci o modelima, opažljivost i korisničko sučelje

Projekt	⭐	Kako je nadahnuo OmniRoute
models.dev	6,555	Otvorena baza podataka sa specifikacijama, cijenama i mogućnostima AI modela — izvorno sinkronizirana s našim katalogom modela.
React Flow / xyflow	38,108	Biblioteka grafova temeljena na čvorovima koja pokreće naše studije Compression Studio i Combo/Routing Studio u stvarnom vremenu.
LangGraph	40,314	Vizualizacija grafa tijeka rada uživo u alatu LangGraph Studio nadahnula je kaskadni prikaz u stvarnom vremenu u našim studijima.
Langfuse	33,592	Njegov model opažljivosti trag → raspon → generiranje oblikovao je slapni prikaz u našem studiju Compression Studio.
Kiali	3,631	Opažljivost Istio uslužne mreže — nadahnula je naše značke prekidača strujnog kruga i vizualne prikaze bridova s pogreškama u studiju Routing/Combo Studio.
lobe-icons	2,428	Logotipi marki AI/LLM koji prikazuju ikone pružatelja usluga na našoj nadzornoj ploči.
flag-icons	12,354	Pruža SVG zastave licencirane MIT licencom koje se upotrebljavaju u izborniku jezika datoteke README.

### 🛡️ Sigurnost

Projekt	⭐	Kako je nadahnuo OmniRoute
awesome-secure-defaults	721	Pomno odabran popis biblioteka koje su prema zadanim postavkama sigurne i koje usmjeravaju naše sigurnosne odabire (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).

### 🧭 Komplementarni alati

Projekt	⭐	Kako je nadahnuo OmniRoute
ClawRouter	6,564	Nadahnuo je uklanjanje dupliciranih zahtjeva, pričuvnu opciju bez troškova za hitne slučajeve, zamjenjive strategije Auto-Combo i višejezičnu klasifikaciju namjere.
Antigravity-Manager	30,652	Njegovo ponovno mapiranje modela s obzirom na račun, provjera putanje izvršne datoteke i ponašanje oznaka plana utjecali su na Antigravity okruženje za izvršavanje sustava OmniRoute.
vscode-antigravity-cockpit	4,817	Njegov sažeti format odbrojavanja do poništavanja kvote nadahnuo je odgovarajući prikaz ograničenja pružatelja usluga u sustavu OmniRoute.
AionUi	32,230	Njegove ACP integracije nadahnule su automatsko otkrivanje instaliranih CLI agenata u sustavu OmniRoute.
CodexBar	20,507	Identificirao je sučelje kvote Grok Build; OmniRoute je zatim neovisno provjerio i ispravio aktivni format podataka na žici.

## 📄 Licenca Licenca MIT – pojedinosti potražite u datoteci [LICENSE](LICENSE). ---

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