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

# 🚀 OmniRoute — Besplatni AI gateway **Kreirao [Diego Souza](https://github.com/diegosouzapw)** OmniRoute — Nikada ne prestajte programirati. Svaki AI alat → 388 pružalac — više od 150 besplatnih — putem jedne krajnje tačke. Claude Code, Codex, Cursor, Cline, Copilot i Antigravity prema BESPLATNIM modelima Claude / GPT / Gemini uz automatski povratak na alternativu. RTK + Caveman složena kompresija štedi 15–95% tokena (~89% u prosjeku) — nikada nećete dosegnuti ograničenja. 388 AI pružalac · više od 150 besplatnih nivoa · ~1,62 milijarde besplatnih tokena mjesečno · 20 strategija rutiranja · $0 za početak.
## 💰 ~1.62B tokena / mjesečno kroz besplatne nivoe trećih strana
> **Koristite vlastite naloge kod provajdera.** Ovo je procijenjeni zbir kroz zasebno podobne besplatne nivoe trećih strana, a ne dodjela tokena od strane OmniRoutea. Registrujte se, pribavite akreditive gdje je potrebno i povežite provajdere koje možete koristiti; svaki provajder određuje svoja ograničenja, dostupnost i uslove. > > Ručno kombinovanje besplatnih nivoa je naporno — deseci SDK-ova, deseci ograničenja brzine i bez jasne predstave o tome koliko zapravo imate. OmniRoute katalogizira **465 stavki besplatnog nivoa kroz 34 ključa ponavljajućih skupova** i izračunava glavni podatak o tokenima iz **17 skupova s objavljenim pozitivnim mjesečnim budžetom, uz pet Groq ograničenja po modelu**, dedupliciranih prema zajedničkom skupu. Kvote koje se otvaraju tek nakon provjere regionalnog identiteta (danas: ModelScope) prikazane su odvojeno, +~6M nakon verifikacije regionalnog identiteta, i nikada se ne sabiraju u glavni podatak. Rezultat ostaje vidljiv na kontrolnoj ploči (`/dashboard/free-tiers`). Kartica budžeta besplatnog nivoa OmniRoutea: ~1.62B besplatnih tokena mjesečno stabilno, do ~2.22B u prvom mjesecu uz kredite za registraciju, iz 34 dokumentovana ključa ponavljajućih skupova koji obuhvataju 465 katalogiziranih stavki besplatnog nivoa iza jedne krajnje tačke. Poštena matematika s deduplikacijom skupova — svaki zajednički skup uračunat je jednom, uključujući 17 ponavljajućih skupova s objavljenim pozitivnim mjesečnim budžetom tokena, uz pet Groq ograničenja po modelu; 12 provajdera označeno je kao izbjegavati u katalogu rizika uslova, pa vi odlučujete. 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 provajdere koji su trajno besplatni bez ograničenja broja tokena, a koji su prikazani odvojeno kako nikada ne bi uvećali glavni podatak. Trenutno iskorišteno/preostalo na /dashboard/free-tiers. > Animirani sažetak aktivne stranice `/dashboard/free-tiers`. Potpuna metodologija (deduplikacija skupova, nivoi kredita, uslovi provajdera): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**. > > Ove brojke se ponovo provjeravaju svake dvije sedmice u odnosu na aktivni katalog i **mijenjaju se u oba smjera** — provajder ukine besplatni nivo i broj opadne; pojavi se novi i broj poraste. Objavljujemo ono što katalog zaista izračuna, nikada naviše zaokružen najbolji slučaj.

⭐ Označite repozitorij zvjezdicom ako vam je OMNIROUTE pomogao da uštedite novac i olakšate posao.

[![Zvjezdice](https://img.shields.io/github/stars/diegosouzapw/OmniRoute?style=social)](https://github.com/diegosouzapw/OmniRoute) diegosouzapw%2FOmniRoute | Trendshift [![Rang historije 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žavaoca — prvi saznajte za nove provajdere, 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 Global](https://img.shields.io/badge/WhatsApp_Global-25D366?style=for-the-badge&logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) [![WhatsApp 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 provajderima, plan razvoja i podrška → [Discord](https://discord.gg/U47eFqAXCn) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 Global](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.54+` | | --------------------------------- | :-------------------------: | :---------: | :-------------------: | | 🌐 Pružatelji | 352 | **358** | 388 | | 🧠 Jedinstveni ID-ovi chat modela | 1320 | **1374** | 1491 | | 🖼️ Most modaliteta | 🆕 vizija + zvuk + video | ✓ | ✓ | | 📡 Besplatni katalog radara | 🆕 dobrovoljno uključivanje | ✓ | ✓ | | ⚖️ Planiranje svjesno kvota | 🆕 Quota-Share | ✓ | ✓ | | 📊 Telemetrija kvota | 🆕 uživo | ✓ | ✓ | | 🧰 Režim bez grafičkog interfejsa | — | — | 🆕 `serve --headless` | | 🛤️ LTS infrastruktura pruge | — | — | 🆕 kanali izdanja | | 🔎 API za otkrivanje modela | — | — | 🆕 `/v1/models/query` | **→ [Plan razvoja](ROADMAP.md) — vožnja prugom do `v3.9.0 LTS`**

## 🧩 Dostupno [![npm verzija](https://img.shields.io/npm/v/omniroute?color=cb3837&logo=npm)](https://www.npmjs.com/package/omniroute) ![Mjesečni NPM](https://img.shields.io/npm/dm/omniroute?label=npm/month&color=cb3837&logo=npm) [![Docker Hub](https://img.shields.io/docker/v/diegosouzapw/omniroute?label=Docker%20Hub&logo=docker&color=2496ED)](https://hub.docker.com/r/diegosouzapw/omniroute) [![Licenca: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](LICENSE) ![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)
🚀 Započnite 🚀 Brzi početak 📦 Instalacija 🆓 Povežite dobavljača
💡 Naučite 💥 Obećanje 🤔 Zašto OmniRoute 🏆 Po čemu se izdvaja
⚙️ Funkcije 🎯 Kombinacije 🌐 Dobavljači 🔌 CLI i MCP
🗜️ Kompresija 🖥️ Gdje se izvršava 🔒 Privatno
👀 Pogledajte 🎬 U akciji ✨ Šta je novo 🤖 Kompatibilni CLI-ji
💚 Podržite 💚 Podrška / Donirajte 💬 Zajednica 💖 Sponzori
📦 Projekat 🛠️ Tehnološki stek 📖 Dokumentacija 👥 Doprinosioci
🌐 Na 67 jezika

Engleski (en) Portugalski — Brazil (pt-BR) Portugalski (pt) Španski (es) Francuski (fr) Italijanski (it) Njemački (de) Nizozemski (nl) Ruski (ru) Ukrajinski (uk-UA) Poljski (pl) Češki (cs) Slovački (sk) Rumunski (ro) Mađarski (hu) Bugarski (bg) Danski (da) Finski (fi) Norveški (no) Švedski (sv) Kineski — pojednostavljeni (zh-CN) Kineski — tradicionalni (zh-TW) Japanski (ja) Korejski (ko) Tajlandski (th) Vijetnamski (vi) Indonezijski (id) Malajski (ms) Filipinski (phi) Hindski (hi) Gudžarati (gu) Marati (mr) Tamilski (ta) Telugu (te) Bengalski (bn) Urdu (ur) Perzijski (fa) Arapski (ar) Hebrejski (he) Turski (tr) Azerbejdžanski (az) Svahili (sw) Grčki (el) Hrvatski (hr) Srpski (sr) Litvanski (lt) Estonski (et) Letonski (lv) Slovenački (sl) Malteški (mt) Irski (ga) Kanada (kn) Malajalamski (ml) Odija (or) Pandžapski (pa) Nepalski (ne) Sinhalski (si) Burmanski (my) Kmerski (km) Hausa (ha) Joruba (yo) Igbo (ig) Amharski (am) Uzbečki (uz) Gruzijski (ka) Armenski (hy) Bosanski (bs)


## 🆓 Instalirajte, povežite dobavljača, zatim usmjeravajte kroz jednu krajnju tačku
Tri koraka: instalirajte i pokrenite OmniRoute, povežite podržanog dobavljača koristeći vlastiti nalog ili API ključ, zatim usmjerite svoj alat na localhost:20128/v1 koristeći OmniRoute API ključ i model auto. Usmjeravanje zavisi od dostupnih podržanih veza i ograničenja dobavljača. ```bash # Nakon povezivanja dobavljača, kopirajte svoj OmniRoute ključ iz odjeljka Dashboard → Endpoints: 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 podržanu rutu. Nova instalacija možda neće imati nijedno podržano odredište bez ključa, a dobavljač bez ključa može odbiti klijente trećih strana. Dobavljači označeni sa `tos: avoid`, uključujući Kiro, prema zadanim postavkama izuzeti su iz automatskog usmjeravanja; povezivanje naloga ne poništava tu postavku. Pogledajte [Vodič kroz besplatne nivoe](docs/getting-started/FREE-TIERS-GUIDE.md) prije nego što odaberete dobavljača. 📦 Skripte za brzi početak koje možete kopirati i zalijepiti za **Python, Node.js, PHP i cURL** → [`examples/quickstart/`](examples/quickstart/)
# 💥 Obećanje
Obećanje — Jedna krajnja tačka i 388 dobavljač. Automatski rezervni odabir održava usmjeravanje dok je dostupno drugo zdravo odredište. Šest stubova: otporno rezervno usmjeravanje kroz 388 dobavljača · do 95% uštede tokena na podržanim radnim opterećenjima · $0 za početak uz više od 150 besplatnih nivoa i 52 dobavljača koji su besplatni zauvijek uz periodičnu obnovu ili bez ključa · 39 CLI/agentskih integracija kroz jednu konfiguraciju · kompatibilnost s OpenAI, Claude, Gemini i Responses API na /v1 · produkcijske kontrole koje uključuju prekidače strujnog kola, TLS prikrivanje, MCP sa 110 alata, A2A, memoriju, zaštitne mehanizme, evaluacije i više od 56.000 statičkih deklaracija testova kroz više od 7.800 praćenih datoteka testova.

# 🤔 Zašto OmniRoute?
Zašto OmniRoute — prestanite upravljati s 10 kontrolnih tabli, nevažećim API ključevima i neočekivanim računima. Deset svakodnevnih problema naspram rješenja: kvota ističe neiskorištena → maksimalno iskoristite pretplate; ograničenja brzine usred programiranja → automatski rezervni odabir kroz 4 nivoa (Pretplata → API → Jeftino → Besplatno); izlazi alata troše tokene → RTK + Caveman kompresija (15–95%); skupi API-ji → usmjeravanje optimizirano prema troškovima; svaki alat ima vlastito podešavanje → jedna krajnja tačka, jedna kontrolna tabla; AI je blokiran → proxy na 3 nivoa + TLS prikrivanje; nevažeći ključevi → otpornost na 3 nivoa (prekidači strujnog kola, hlađenje ključa, blokiranje modela); tim dijeli jednu pretplatu → skupovi ključeva s kvotama za pravednu raspodjelu; upiti prolaze kroz nečiji oblak → lokalni pristup kao prioritet uz ključeve šifrovane pomoću AES-256-GCM; nema uvida u potrošnju → analitika uživo (korištenje, kvota, ušteda, p95 latencija).
Tok OmniRoute zahtjeva: vaš IDE ili CLI (Claude Code, Cursor, Cline…) poziva jednu lokalnu krajnju tačku (http://localhost:20128/v1); OmniRoute pametni usmjerivač (RTK + Caveman kompresija, 20 strategija usmjeravanja, prekidači strujnog kola, TLS prikrivanje, MCP, A2A, zaštitni mehanizmi) može preći na rezervnu opciju kroz 4 nivoa dobavljača dok je dostupno podržano zdravo odredište — Nivo 1 Pretplata, Nivo 2 API ključ, Nivo 3 Jeftino i Nivo 4 Besplatno.

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

Kimi K3 — Vrhunska otvorena inteligencija · 2,8 biliona parametara · kontekst od 1M tokena

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

Osnivački prijatelj otvorenog koda
Hvala kompaniji Kimi (Moonshot AI), našem osnivačkom prijatelju otvorenog koda, na podršci ovom projektu! Kimi je AI laboratorija koja stoji iza porodica modela s otvorenim težinama K2 i K3 — Kimi K3 pruža kontekstni prozor od 1M tokena, nativnu podršku za vid i programiranje na najvišem nivou po djeliću cijene zatvorenih modela te odmah radi s alatima Claude Code, Codex i svim alatima za programiranje koje OmniRoute podržava.

Šta omogućava podrška kompanije Kimi: Kimi API krediti pokreću OmniRouteov proces izdanja potvrđen pomoću AI-ja — fazu provjere spajanja koju pokreće Kimi K3, a koja pregleda svaki zahtjev za povlačenje prije objave — kao i svakodnevni razvoj funkcionalnosti. Prvorazredna podrška za Kimi dostupna je putem oba kanala: direktnog Kimi API-ja (kimi-k3) i Kimi Code plana za programiranje (OAuth i API ključ). OmniRoute je također prvi brazilski projekat otvorenog koda u programu podrške kompanije Kimi. Nabavite Kimi API ključ uz 15% dodatnih kredita →
Cheaper Inference
Cheaper Inference
cheaperinference.com

Prijatelj otvorenog koda
Hvala kompaniji Cheaper Inference, OmniRouteovom prijatelju otvorenog koda, na podršci ovom projektu! Cheaper Inference je pristupnik rangiran prema troškovima koji preprodaje 42 vrhunska modela — Claude, GPT-5.x, Gemini, Kimi K3, GLM, DeepSeek, Grok i MiniMax — putem jedne krajnje tačke kompatibilne s OpenAI-jem, usmjeravajući svaki zahtjev prema najjeftinijem odgovarajućem pružaocu usluga, a da pritom nikada ne naplaćuje više od cijene koju je odredio proizvođač modela.

Prvorazredna podrška u OmniRouteu: Chat Completions, nativna krajnja tačka /v1/responses, vid, pozivanje alata i 3 modela za slike (grok-imagine, nano-banana-pro, nano-banana-2, dostupni kao cheaperinference/<model>). Nabavite API ključ →
Linkovi označeni s aff=omniroute partnerski su linkovi. Oni finansiraju projekat bez dodatnih troškova za vas.
🎟️ Promocije partnera — besplatni kuponi za registraciju od pružalaca usluga koje ne sponzorišemo (kliknite za proširenje) Ovaj odjeljak namijenjen je isključivo kodovima za preporuke/kupone. Sponzorisana partnerstva nalaze se u gornjem odjeljku 🤝 Uz podršku naših prijatelja otvorenog koda. OmniRoute nema sponzorski ni partnerski odnos s ovdje navedenim pružaocima usluga — ovo su javni kuponi koje svako može koristiti.
AgentRouter
AgentRouter
agentrouter.org
AgentRouter — partnerska registracija · $100 besplatnih kredita nakon registracije (besplatan server, očekujte veće kašnjenje — najbolje za testiranje, ne za produkciju). Prvorazredna podrška u OmniRouteu od verzije v3.8.50: Chat Completions, format komunikacije kompatibilan s Anthropicem i putanja kompatibilna s OpenAI-jem. Dostupni modeli uključuju claude-opus-4-8, claude-opus-5, gpt-5.6-sol i druge. Preuzmite svojih $100 →

⚠️ Partnerski link — OmniRoute nema sponzorski ni partnerski odnos s ovim pružaocem usluga.
Znate li za drugog pružaoca usluga s velikodušnim besplatnim kuponom za registraciju koji koristi korisnicima OmniRoutea? Otvorite prijavu problema i dodat ćemo ga ovdje.

## 🎯 Kombinacije — Vodeća funkcija
Animirani primjeri za 18 od 20 strategija usmjeravanja kombinacija — po jedna pločica za svaku strategiju: priority, fill-first, weighted, round-robin, p2c, least-used, random, strict-random, cost-optimized, headroom, reset-window, reset-aware, context-relay, context-optimized, lkgp, auto, fusion, pipeline. Strategije cache-optimized i quota-weighted nisu animirane; tabela u nastavku opisuje svih 20. > **Kombinacija** je lanac modela kroz koje OmniRoute usmjerava **automatski**. Ako se kvota potroši, pružalac usluge zakaže ili troškovi naglo porastu, kombinacija može preći na sljedeći odgovarajući model koji ispravno radi. 🛡️ ### ⚡ Bez konfiguracije — samo koristite `auto` Nije potrebno kreirati kombinaciju. Postavite svoj model na `auto` (ili neku varijantu) i OmniRoute će izgraditi virtuelnu kombinaciju od vaših povezanih pružalaca usluga, ocijenjenu u stvarnom vremenu:
ID modelaZa šta je optimiziran
auto🎯 Uravnotežena zadana opcija (LKGP — zadržava vašeg posljednjeg pouzdanog pružaoca usluge)
auto/coding🧑💻 Ponderi koji daju prednost kvalitetu pri generiranju koda
auto/fast⚡ Najprije najmanja latencija
auto/cheap💰 Najprije najniža cijena po tokenu
auto/subscription🎟️ Samo pretplatnička kvota koju već plaćate — zatvara se u slučaju neuspjeha, bez prelaska na naplativu rezervnu opciju (vodič)
auto/thrifty🪜 Najprije kvota paketa, zatim stepenicu po stepenicu do najjeftinijih plaćenih opcija — povratak na paket nakon što se njegova kvota obnovi (vodič)
auto/offline🔋 Najprije najveća rezerva kvote / ograničenja brzine
auto/smart🔭 Prednost kvalitetu + 10% istraživanja radi otkrivanja boljih modela
auto/lkgp📌 Izričito zadržavanje posljednjeg pouzdanog pružaoca usluge
auto/chaos🧪 Paralelno slanje panelu modela (po jedan za svakog pružaoca usluge, zadano 5), uz vraćanje jednog odgovora; jedan uzvodni poziv po modelu panela, bez ubrizgavanja grešaka
## ### 🔀 Ili napravite vlastitu — 20 strategija usmjeravanja Svih **20** strategija — kombinirajte ih po želji za svaki korak kombinacije:
# Strategija Šta radi
1 priority Uređena lista s prvim odredištem — iscrpite svako prije prelaska na sljedeće 🥇
2 fill-first Potpuno iskoristite kvotu svakog odredišta prije prelaska na sljedeće
3 weighted Ponderirani nasumični odabir prema ponderu svakog odredišta
4 round-robin Kružno prolazi kroz odredišta redom
5 p2c Nasumično balansiranje opterećenja metodom izbora između dvije opcije
6 least-used Odabire odredište s najmanjim trenutnim opterećenjem
7 random Ravnomjeran nasumični odabir (bez duplikata)
8 strict-random Nasumični odabir bez uklanjanja ponavljanja 🎲
9 cost-optimized Minimizira cijenu u $ po zahtjevu na osnovu aktuelnih cijena iz kataloga 💸
10 headroom Odabire odredište s najvećom preostalom kvotom
11 quota-weighted Preskače iscrpljene račune, a zatim bira proporcionalno preostaloj kvoti ÷ trenutnom aktivnom opterećenju — postojeći razgovori ostaju prikvačeni ⚖️
12 reset-window Daje prednost odredištu čiji se period kvote najranije obnavlja
13 reset-aware Rangira prema vremenu obnove kvote — najprije kratki periodi 📊
14 context-relay Prosljeđuje kontekst između odredišta za duge razgovore 🧠
15 context-optimized Odabire opciju koja najbolje odgovara trenutnoj veličini konteksta
16 cache-optimized Prikvačuje svaki ponovo upotrebljivi prefiks upita za isti račun — maksimizira pogotke u predmemoriji upita 🎯
17 lkgp Posljednja poznata pouzdana putanja — prikvačuje za posljednjeg uspješnog pružaoca usluge, a zatim prelazi na rezervna pravila
18 auto Ocjenjivanje u stvarnom vremenu prema 16 faktora za svaku vezu 🤖
19 fusion Šalje upit panelu modela, a sudija sintetizira jedan odgovor 🧬
20 pipeline Povezuje korake u lanac — izlaz svakog odredišta prosljeđuje se sljedećem 🔗
Auto-Combo mehanizam ocjenjuje svakog kandidata na osnovu **16 faktora** (stanje, kvota, trošak, latencija, prikladnost za zadatak, kvalitet, dostupnost sesije…) — pogledajte [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md). ## ### 🧱 Otpornost je ugrađena (3 nezavisna sloja) Otpornost OmniRoutea — 3 nezavisna sloja samooporavka, odgovarajući sloj za odgovarajući kvar. Sloj 1: prekidač strujnog kola pružaoca usluge (cijeli pružalac): aktivira se samo pri greškama 408/5xx, pragovi su OAuth 8× / API ključ 12× / lokalno 2×, nakon 60 s/30 s/15 s prelazi u stanje HALF-OPEN radi provjere, oporavak po potrebi; dok je u stanju OPEN, kombinacija preusmjerava na sljedećeg pružaoca. Sloj 2: period čekanja veze (jedan ključ/račun): osnovno 5 s za OAuth / 3 s za API ključ, eksponencijalno povlačenje ×2 sa zaštitom od naglog istovremenog priliva zahtjeva, 429 poštuje Retry-After, uspjeh briše sva stanja greške; ključ u periodu čekanja se preskače dok povezani ključevi nastavljaju posluživati. Sloj 3: zaključavanje modela (jedan model): 429 po modelu, lokalni 404 ili odbijanja režima zaključavaju samo taj model — nikada cijelu vezu. Završna stanja (zabranjen, istekao, krediti iscrpljeni) namijenjena su operateru, a ne periodima čekanja. 📖 [Auto-Combo mehanizam](docs/routing/AUTO-COMBO.md) · [Vodič za otpornost](docs/architecture/RESILIENCE_GUIDE.md)
## 🏆 Po čemu se OmniRoute izdvaja
Po čemu se OmniRoute izdvaja — datirani pregled funkcionalnosti u odnosu na 9router, OpenRouter, CLIProxyAPI i LiteLLM kroz 13 mogućnosti. OmniRoute: 388 pružalac, više od 150 besplatnih nivoa ugrađenih, 20 strategija rutiranja, kompresija tokena pomoću 12 mašina, ugrađeni MCP server sa 110 alata, A2A protokol agenata, trajna memorija, zaštitne mjere, agenti u oblaku, prikrivanje TLS otiska, Desktop/Termux/PWA i 67 i18n lokalizacija korisničkog interfejsa. OmniRoute je licenciran pod MIT licencom i može se samostalno hostovati. Mogućnosti i brojke konkurenata mogu se promijeniti; pogledajte povezanu metodologiju. 📊 Kompletna metodologija i detalji po funkcionalnostima u odnosu na 9router, OpenRouter, CLIProxyAPI i LiteLLM → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)
## 💚 Podržite OmniRoute OmniRoute je licenciran MIT licencom i održava se javno. Ako vam štedi vrijeme ili novac, evo kako možete pomoći da ostane nezavisan — odaberite ono što vam odgovara. Sponzorstvo nikada ne utječe na prioritet usmjeravanja; njime se kupuje vidljivost, a ne rangiranje.
⭐ Dodajte zvjezdicu repozitorijuBesplatno — zaista pomaže vidljivostiDodajte zvjezdicu projektu OmniRoute
🐙 GitHub SponsorsJednokratno ili mjesečno · bez platformske naknadegithub.com/sponsors/diegosouzapw
☕ Ko-fiBrza jednokratna donacija, bez registracije donatorako-fi.com/diegosouzapw
🧋 Buy Me a CoffeeMala, neformalna gestabuymeacoffee.com/diegosouzapw
🖐 LiberapayPeriodično · neprofitno · otvorenog kodaliberapay.com/diegosouzapw
🇧🇷 PIX (Brazil)Trenutno, bez naknadaključ i QR kod ispod
₿ KriptovaluteBTC · ETH · USDT-TRC20 · USDC-Solanaadrese ispod
**🇧🇷 PIX** — trenutno, bez naknada (Brazil) OmniRoute PIX QR kod 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)
₿ BTCBitcoin (SegWit)bc1qh00smz004sy85wyl28v77tenkt3ckl6eaep7fd
Ξ ETHEthereum (ERC20)0x64Cf6B68A6Ff34288e89172950a2d00102337a84
₮ USDTTron (TRC20)TKAF41JpuQrHbKTnsQa9svJE2T192Hvsc2
$ USDCSolana2emNNZzVVWQc3FQ2wk9M6qXUQmW8AKdjjL174fXR28Tu
⚠️ Svaku valutu šaljite samo putem prikazane mreže — slanje putem pogrešne mreže može dovesti do gubitka sredstava.
🐛 Pronašli ste grešku ili imate povratne informacije? Otvorite [diskusiju](https://github.com/diegosouzapw/OmniRoute/discussions).

Napomene za programere: Projekat može generisati lokalnu datoteku .env tokom npm instalacije/postinstalacije radi praktičnosti programera. Ova datoteka se namjerno ignoriše putem .gitignore (pogledajte .gitignore) i nikada se ne smije predati u repozitorij — ako je slučajno predate, promijenite sve otkrivene tajne i uklonite datoteku iz historije. Smjernice za upravljanje lokalnim datotekama okruženja i tajnama potražite u dokumentu docs/DEVELOPER-ENVIRONMENT.md.

## 📡 OmniRoute Radar Glavna brojka za besplatni nivo ostaje **~1,62 mlrd. tokena/mjesečno** iz gore navedenog dokumentovanog kataloga, iz kojeg su uklonjeni duplikati među zajedničkim kvotama. Privremeni krediti pri registraciji kod pružalaca usluga mogu zasebno povećati prvi mjesec na **~2,22 mlrd.** Radar je opcionalni, potpisani sloj kataloga za korisnike koji žele ažurniju dostupnost besplatnih modela između OmniRoute izdanja; katalog zajednice i svaka postojeća besplatna funkcija ostaju besplatni. Podržavaoci mogu dobiti aktivni katalog i dodatne mogućnosti kod pružalaca usluga. Njegova zasebna, promjenjiva gornja granica iznosi **najviše približno 3 mlrd. tokena/mjesečno**, zavisno od dostupnosti pružalaca usluga. Ta gornja granica nije zagarantovana: pružaoci usluga mogu u bilo kojem trenutku promijeniti kvote, uslove ispunjavanja, modele ili regije. Radar se koristi samo uz izričit pristanak i podržava isključivo GET zahtjeve. OmniRoute klijent ne prenosi upite, saobraćaj, konfiguraciju pružalaca usluga, telemetriju korištenja niti lokalno stanje odbacivanja obavještenja. Saznajte više o uslovima ispunjavanja i trenutnom katalogu na **[radar.omniroute.online/planos](https://radar.omniroute.online/planos)**.
## ✨ Šta je novo
> Najnovije istaknute novosti od **v3.8.20 → v3.8.54**. Kompletna historija nalazi se u [`CHANGELOG.md`](CHANGELOG.md). - **⚖️ `quota-weighted` usmjeravanje** — 20. strategija kombinovanja preskače iscrpljene naloge, a zatim među preostalim bira proporcionalno odnosu preostale kvote ÷ opterećenja zahtjevima u toku, pri čemu postojeći razgovori ostaju vezani za isti nalog. → [Automatsko kombinovanje](docs/routing/AUTO-COMBO.md) - **🧰 Način rada bez korisničkog interfejsa** — `omniroute serve --headless` (ili `OMNIROUTE_HEADLESS=1`) pokreće samo `/v1/*` proxy mehanizam, dok su nadzorna ploča i podsistemi namijenjeni samo nadzornoj ploči isključeni. → [Način rada bez korisničkog interfejsa](docs/guides/HEADLESS.md) - **🔎 Otkrivanje modela** — `/v1/models` filtrira prema mogućnostima, kontekstu, vrsti i tekstu, a `POST /v1/models/query` vraća kratak deterministički uži izbor s istom vidljivošću po ključu. → [API referenca](docs/reference/API_REFERENCE.md) - **🔑 Usmjeravanje po ključu** — API ključ se može vezati za jedan model ili kombinaciju pomoću `forcedModel`, a modeli i kombinacije ključa mogu se atomski dodati ili ukloniti (`/api/keys/{id}/access`). → [API referenca](docs/reference/API_REFERENCE.md) · [OpenAPI](docs/openapi.yaml) - **🛡️ Preciznije kontrole PII podataka** — izbor po vrsti, do 20 provjerenih prilagođenih obrazaca maskiranja i brojači detekcije po vrsti; samo maskiranje i dalje se mora izričito uključiti. → [Zaštitne mjere](docs/security/GUARDRAILS.md) - **🌍 67 jezika** — nadzorna ploča, preslike dokumentacije i CLI, pri čemu `npm run i18n:add-locale` dodaje jezik svuda jednom naredbom. → [Vodič za i18n](docs/guides/I18N.md) - **🎛️ OmniConductor** — ulazno A2A delegiranje vašoj floti agenata, Conductor vještine na Agent Card kartici i panel nadzorne ploče s Faro glasovnim razgovorom putem funkcije „pritisni za govor“. → [A2A server](docs/frameworks/A2A-SERVER.md) - **🛂 Prilagodljivi prijem i zaštita od preopterećenja** — zahtjevi za zahtjevne razgovore stavljaju se u red čekanja umjesto da vraćaju grešku 503, uz atomske RPM klizne najmove po konekciji. → [Vodič za otpornost](docs/architecture/RESILIENCE_GUIDE.md) - **🗂️ Kanonski redoslijed `/v1/models`** — jedan neprekinuti blok grupisan po pružaocu za svakog pružaoca (kombinacije su prve), stabilan u svim izvorima kataloga. → [API referenca](docs/reference/API_REFERENCE.md) - **🗜️ Ojačana kompresija** — zaštita od prekomjernog napuhavanja uključena je prema zadanim postavkama, Caveman paketi za DE / FR / JA + kineski (wényán), RTK filteri za Gradle i .NET. → [Kompresija](docs/compression/COMPRESSION_ENGINES.md) - **💸 Iskreni trošak s fiksnom cijenom** — pružaoci pretplata / coding-plan usluga u analitici troškova prikazuju **$0**; budžet, kvota i usmjeravanje i dalje daju procjene. → [API referenca](docs/reference/API_REFERENCE.md) - **⚖️ Quota-Share usmjeravanje** — zajednička kvota naloga pravedno se dijeli između udruženih ključeva, uz iskorištavanje resursa tako da se neaktivni dijelovi posuđuju. → [Vodič za otpornost](docs/architecture/RESILIENCE_GUIDE.md) - **🤖 Postavljanje CLI-ja/agenata jednom naredbom** — 15 registrovanih naredbi `setup-*`; `omniroute run` pokreće 7 CLI alata (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); `omniroute configure` podržava 11 odredišta s interaktivnim biračem pružaoca i modela te favoritima po kontekstu. → [CLI integracije](docs/guides/CLI-INTEGRATIONS.md) - **🛰️ Udaljeni način rada** — upravljajte udaljenim OmniRouteom pomoću tokena ograničenih opsegom (`connect` / `contexts` / `tokens`) + `antigravity` OAuth pomoćnik za VPS instalacije. → [Udaljeni način rada](docs/guides/REMOTE-MODE.md) - **🧭 Pametnije automatsko usmjeravanje** — kombinacije `auto/:`, **Fusion** (panel modela + sudija), usmjeravanje svjesno zadatka, nadjačavanja modela / načina rada / USD budžeta po zahtjevu. → [Automatsko kombinovanje](docs/routing/AUTO-COMBO.md) - **🗜️ Modularna kompresija** — 12 kombinabilnih mehanizama + Compression Studios: LLMLingua-2, Ultra u dva nivoa, omniglyph, provjera vjernosti po koraku, GCF v3.2, uređivač za promjenu redoslijeda prevlačenjem. → [Kompresija](docs/compression/COMPRESSION_ENGINES.md) - **🕵️ Transparentno MITM dešifrovanje (TPROXY)** — CLI alati za hvatanje saobraćaja koji zanemaruju proxy varijable okruženja, uz instalacijski program CA certifikata + skladišta povjerenja po SNI-ju. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md) - **💸 Telemetrija troškova svuda** — zaglavlja troška/upotrebe `X-OmniRoute-*` na svakoj krajnjoj tački, zaglavlje uštede od pogodaka keša i kvote potrošnje u USD po ključu. → [API referenca](docs/reference/API_REFERENCE.md) - **🧠 Memorija pod vašom kontrolom** — prema zadanim postavkama isključena, kvantizacija vektora int8 i opadanje po tipu uz izričito uključivanje, `x-omniroute-no-memory` po zahtjevu. → [Memorija](docs/frameworks/MEMORY.md) - **🛡️ Sigurnost** — zaštita od prompt-injekcija na svakoj LLM ruti (red-team paket), zaštita za maskiranje vjerodajnica uz izričito uključivanje (uklanja otkrivene API ključeve/tajne u oba smjera), besplatna web pretraga DuckDuckGo kao krajnja opcija i opcionalna OIDC prijava za nadzornu ploču (prijava lozinkom uvijek ostaje dostupna). → [Zaštitne mjere](docs/security/GUARDRAILS.md) - **🖼️ Nove krajnje tačke** — `/v1/ocr` (Mistral OCR) i `/v1/audio/translations` (u stilu Whispera) upotpunjuju medijski interfejs. → [API referenca](docs/reference/API_REFERENCE.md) - **🎨 Generisanje slika / videa / zvuka** — jedan API za medije: xAI Grok Imagine i Novita AI video, ComfyUI, Magnific, Adobe Firefly, Segmind i pružaoci govora poput ElevenLabs. → [API referenca](docs/reference/API_REFERENCE.md) - **🌍 Implementacija i operacije** — `basePath` obrnutog proxyja, automatsko prepoznavanje jezika preglednika, praćenje uređaja po ključu, MITM povjerenje bez root ovlasti, lokalizacija zh-TW. → [Okruženje](docs/reference/ENVIRONMENT.md) - **🤝 Više pružalaca i agenata** — agenti u oblaku (Codex Cloud, Cursor, Devin, Jules), Grok Build (xAI) s prijavom putem preglednika + OAuth, prvoklasna kartica za Ollama, 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 388 pružaocem**. → [Pružaoci](docs/reference/PROVIDER_REFERENCE.md) - **📡 Transparentnost usmjeravanja** — svaki odgovor sadrži zaglavlje `X-OmniRoute-Decision` koje navodi strategiju/pružaoca/latenciju koji su ga poslužili, nova strategija kombinovanja `cache-optimized` + faktor `cacheAffinity` automatskog kombinovanja usmjerava ponovljene zahtjeve nazad na konekciju koja sadrži keširani prefiks, a krajnja tačka samo za čitanje `/v1/auto-combo/{channel}/candidates` izlaže aktivni skup kandidata `auto/*` kanala. → [Automatsko kombinovanje](docs/routing/AUTO-COMBO.md) - **⚡ Lokalne performanse i infrastruktura** — lokalni Redis jednim klikom, deployeri za Cloudflare Workers / Deno Deploy relay, Bifrost i Mux kao nadzirane ugrađene usluge. → [Ugrađene usluge](docs/frameworks/EMBEDDED-SERVICES.md) - **🧩 Također uključeno** — okvir za dodatke + marketplace, Omni/Agent/GitHub okviri vještina, integracija s Obsidian trezorom (22 MCP alata), OpenAI-kompatibilni Batch i Files API-ji, semantička predmemorija odgovora, gamifikacija s rang-listama, ACP otkrivanje agenata (15 ugrađenih agenata), zakazani izvoz logova u BigQuery, `auto/chaos` paralelno prosljeđivanje prema više modela, most za Telegram bot, upravljač verzijama unutar aplikacije i rang-liste besplatnih pružalaca usluga LMArena-ELO. → [Dokumentacija](docs/README.md)
## 🤖 Kompatibilni CLI-ji i Koderski AgentI > Jedna konfiguracija — `http://localhost:20128/v1` — i **svaki** AI IDE ili CLI radi na besplatnim i niskobudžetnim modelima.
Claude Code
Claude Code
                           
Codex CLI
Codex CLI
                           
Cline
Cline
                           
Kilo Code
Kilo Code
Zoo Code
Zoo Code
Continue
Continue
                           
Aider
Aider
                           
ForgeCode
ForgeCode
                           
jcode
jcode
                           
DeepSeek TUI
DeepSeek TUI
                           
CodeWhale
CodeWhale
                           
OpenCode
OpenCode
                           
Factory Droid
Factory Droid
                           
GitHub Copilot CLI
Copilot CLI
                           
Cursor CLI
Cursor CLI
                           
Smelt
Smelt
                           
Pi (pi-coding-agent)
Pi
                           
Grok Build (xAI)
Grok Build
                           
Hermes Agent (Nous Research)
Hermes Agent
                           
OpenClaw
OpenClaw
                           
Goose
Goose
                           
Open Interpreter
Open Interpreter
                           
Warp AI
Warp AI
                           
deyin.ai
deyin.ai
                           
+ radi i sa · Agent Deck · Kiro · Command Code · Antigravity · Windsurf · AMP · bilo kojim alatom kompatibilnim sa OpenAI
📖 Postavljanje za svaki alat pojedinačno za svih 39 alata (28 CLI Code + 11 CLI Agenti) → [`docs/reference/CLI-TOOLS.md`](docs/reference/CLI-TOOLS.md) · 🧩 OpenCode dodatak → [`@omniroute/opencode-provider`](https://www.npmjs.com/package/@omniroute/opencode-provider)

**Pokrenite bilo koji podržani CLI putem OmniRoute jednom komandom** — bez pisanih konfiguracijskih fajlova, povjerljive informacije se ubrizgavaju po procesu, Qwen/Gemini dobijaju izolirani privremeni home direktorij: ```bash omniroute run claude --model openai/gpt-5.4 # Claude Code omniroute run codex --model glm/glm-5.2 # OpenAI Codex CLI omniroute run aider --model glm/glm-5.2 -- --message "reply OK" omniroute run goose --model glm/glm-5.2 omniroute run opencode --model glm/glm-5.2 -- run "reply OK" omniroute run qwen --model glm/glm-5.2 -- -p "reply OK" omniroute run gemini --model glm/glm-5.2 -- --skip-trust -p "reply OK" # Ili izaberite provider+model interaktivno i napišite vlastitu konfiguraciju alata: omniroute configure codex # također: claude opencode qwen aider goose gemini cline continue kilo 5dive ``` Svaka komanda poštuje aktivni udaljeni kontekst (`omniroute connect `), `--dry-run` prikazuje tačno okruženje/argumente bez izvršavanja, a `--api-key-env NAME` čuva tajne izvan vaše shell historije. → [CLI Integracije](docs/guides/CLI-INTEGRATIONS.md)
## 🌐 388 AI provajder — 153 označena kao besplatna u katalogu
> **388 registrovani provajder** u kanonskim kolekcijama za chat, medije, pretragu, lokalne i cloud agente te sistemske kolekcije, uključujući **153 provajdera s metapodacima za otkrivanje `hasFree: true`**. Registar chat modela obuhvata **239 provajdera / 3,059 različitih parova provajder-model / 1,475 sirovih ID-jeva modela**; zasebni katalog besplatnog budžeta sadrži **471 red po modelu**, **34 periodična fonda** i **52 periodična/beskonačno besplatna provajdera bez ključa**. Ovo su različiti nazivnici po dizajnu; definicije i izračuni s uklonjenim duplikatima fondova dostupni su u dokumentima [Referenca provajdera](docs/reference/PROVIDER_REFERENCE.md) i [Besplatni nivoi](docs/reference/FREE_TIERS.md).
### 🏢 Svaka velika laboratorija — putem jedne krajnje tačke
OpenAI
OpenAI
                           
Anthropic
Anthropic
                           
Gemini
Gemini
                           
xAI Grok
xAI Grok
                           
DeepSeek
DeepSeek
                           
Mistral
Mistral
                           
Qwen
Qwen
                           
Meta Llama
Meta Llama
                           
Groq
Groq
                           
NVIDIA
NVIDIA
                           
MiniMax
MiniMax
                           
Cohere
Cohere
                           
Perplexity
Perplexity
                           
Hugging Face
HuggingFace
                           
Together
Together
                           
Fireworks
Fireworks
                           
Cloudflare
Cloudflare
                           
Baidu
Baidu
                           
…i još više od 350 — svaka ikona se učitava uživo iz kataloga provajdera na kontrolnoj tabli. 📖 [Referenca provajdera](docs/reference/PROVIDER_REFERENCE.md)
### 🆓 Zauvijek besplatno — $0, bez kartice
OpenCode Zen
OpenCode Zen
DeepSeek V4, Nemotron 3
Bez ograničenja broja tokena
Kilo Code
Kilo Code
Automatsko usmjeravanje, Tencent Hy3
Zauvijek besplatno
Requesty
Requesty
GPT-OSS 120B, Nemotron
Zauvijek besplatno
SiliconFlow
SiliconFlow
DeepSeek V3.2 / R1
Besplatni nivo
Z.AI GLM
Z.AI GLM
GLM-4.7 / 4.5-Flash
Zauvijek besplatno
Baidu ERNIE
Baidu ERNIE
ERNIE 4.0
Zauvijek besplatno
Qoder AI
Qoder AI
Qwen3-Max, Kimi-K2
NEOGRANIČENO BESPLATNO
Pollinations
Pollinations
GPT, Llama, Claude
Ključ nije potreban
Cloudflare AI
Cloudflare AI
50+ modela
10K neurona/dan
NVIDIA NIM
NVIDIA NIM
GLM, MiniMax
~40 RPM besplatno
Cerebras
Cerebras
GLM 4.7, GPT-OSS
Jednokratni kredit od $5; kartica je obavezna
OpenRouter
OpenRouter
:free modeli
+$10 → veći RPM
📖 Potpuni mašinski čitljiv katalog → [`docs/reference/PROVIDER_REFERENCE.md`](docs/reference/PROVIDER_REFERENCE.md)
## 🖥️ Gdje OmniRoute radi — bilo gdje
> Ista aplikacija, vaša mašina, vaša pravila. Od globalne npm instalacije do** vaš telefon** preko Termuxa. OmniRoute
Platforma Instaliraj Istaknuto
📦 npm (globalno) npm install -g omniroute Jedna naredba, bilo koja OS
⚡ Bun (globalno) bun add -g omniroute Isti arhiv registra, brža instalacija
🐳 Docker docker run … diegosouzapw/omniroute Multi-arch AMD64 + ARM64
🖥️ Desktop (Electron) npm run electron:build Izvorni prozor + sistemska traka — Windows / macOS / Linux
🎩 menija (OmniRouteTray) brew install --cask zoispag/tap/omniroute-tray Nadzire & automatski ažurira server — macOS
💪 ARM native arm64 Raspberry Pi, ARM serveri, Apple Silicon
📱 Android (Termux) pkg install nodejs && npx -y omniroute Pokreće na vašem telefonu , 24/7, bez root
📲 PWA"Dodaj na početni ekran" Cijeli ekran, van mreže, može se instalirati iz preglednika
🧩 OpenCode @omniroute/opencode-provider Izvorna OpenCode integracija
🤖 VS Code Copilot Chat instaliraj OmniCopilot ekstenziju model u izvornom Copilot Chat biraču — stabilan & Insiders
🛠️ Iz izvora npm instalirajte && npm pokrenite dev Hakirajte to, doprinijete
📖 [Docker Vodič](docs/guides/DOCKER_GUIDE.md) · [Radna površina](electron/README.md) · [Traka menija](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 VS -ovog izvornog Copilot chata
> Nema nove bočne trake, nema novog chata UI — svaki model OmniRoute služi pojavljuje se upravo u**Copilot Chat birač modela koji već koristite** . Od VS koda 1.122, modeli provajdera rade bez GitHub prijave ili Copilot pretplate — režim agenta, pozivanje alata i vizija, besplatno. Instalirajte** [OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)** ekstenziju, usmerite je na vaš OmniRoute server (podrazumevano na `localhost:20128`), zatim otvorite Copilot Chat → birač modela →** Upravljajte modelima…** →**OmniRoute** . < td poravnaj ="lijevo">VS Kod — stabilan & Insajderi < td poravnaj ="lijevo">Cursor, Windsurf, VSCodium, Theia code-server, Gitpod, Antigravity, Kiro
Store Link Radi sa
🧩 VS Code Marketplace Instaliraj →
🔓 Otvori VSX registar Instaliraj →
Iz uređivača: otvorite** Ekstenzije** pogledajte, pretražite** "OmniRoute"** , kliknite** Instaliraj** — radi na isti način u obje trgovine. Izvor, izdanja i priručnik za objavljivanje uživo na [diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot). 📖 [VS Code Copilot Vodič za ćaskanje](docs/guides/VSCODE-COPILOT.md) — podešavanje, šta prikazuje birač, kontrolna tabla-u-kartici, rešavanje problema
### 🎩 Novo: OmniRouteTray — vaš gateway koji živi u traci menija
> `omniroute serve` je najsrećnija kada je stalno uključena.** [OmniRouteTray](https://github.com/zoispag/omniroute-tray)** pretvara to u aplikaciju za postavljanje i zaboravljanje menija za macOS: pokreće server, održava ga na životu nakon ponovnog pokretanja, ažurira ga na mjestu i stavlja vaš živi token budžet na jedan klik -** nema otvoren prozor terminala, nema `npm install -g omniroute` za čuvanje djece.** Napravljen sa [Tauri v2](https://v2.tauri.app/) (Rust jezgro veličine greške zaokruživanja), isporučuje vlastito potpisano Node 24 runtime i upravlja OmniRoute instalacijom u vlasništvu aplikacije, tako da se nikada ne bori protiv vašeg globalnog `node`/`bun`. To** dijeli vašu postojeću `~/.omniroute/` konfiguraciju i bazu podataka** — znači to je isti OmniRoute koji već trčiš, samo sa šeširom. 🎩
Šta radi Kako
🟢 Nadzire server Pojavljuje omniroute serve , usvaja već pokrenutu instancu umjesto da je duplicira
📊 Kratak pregled upotrebe uživo Trake kvota dobavljača, Claude session/weekly ograničenja s poništavanjem odbrojavanja, 30-dnevna analiza troškova
🔄 Automatska ažuriranja na mjestu Postepena instalacija, atomska zamjena, vraćanje na neuspjeh — uvijek na najnovijem izdanju
🚀 Pokreni pri prijavi Opciono pokretanje pri prijavi; samo za ladicu, bez ikone priključne stanice
🩺 Doctor & logira Dijagnostika jednim klikom i pristup zapisniku servera
```sh brew install --cask zoispag/tap/omniroute-tray ``` Želite li preuzimanje? Preuzmite najnoviji .dmg sa Izdaje . Izvor, problemi i izrada dokumenti uživo na zoispag/omniroute-tray.
💛 Projekt zajednice od @zoispag — nije službeno izdanje OmniRoute.

## 🔒 Privatno i lokalno po dizajnu
Privatno i lokalno po dizajnu — OmniRouteov pristupnik i kontrolna ravan rade na vašem računaru. Upiti se šalju nadređenom pružaocu usluge odabranom za svaki zahtjev; OmniRoute ne dodaje posredni hostovani korak za obradu upita, a telemetrija je podrazumijevano onemogućena. Vjerodajnice su šifrirane u stanju mirovanja pomoću AES-256-GCM; kontrole uključuju ograničavanje opsega API ključeva, filtriranje IP adresa, ograničenja brzine, zaštitu od ubrizgavanja u upite, uklanjanje zaglavlja nadređenog pružaoca, opcionalno uklanjanje ličnih podataka, pročišćene greške i lokalni SQLite revizijski trag. OmniRoute je licenciran pod MIT licencom i može se samostalno hostovati. 📖 [Autorizacija](docs/architecture/AUTHZ_GUIDE.md) · [Zaštitne mjere](docs/security/GUARDRAILS.md) · [Usklađenost](docs/security/COMPLIANCE.md)
## 🔌 Potpuni CLI + A2A i MCP
> Pored servera, OmniRoute je **potpuna komandna konzola** sa **više od 80 komandi**, kao i otvorenim protokolima za agente, tako da AI agent može njime upravljati **samostalno**. ### ⌨️ Pravi CLI (ne samo `start`) ```bash omniroute # pokreni pristupnik + kontrolnu ploču (port 20128) omniroute chat # interaktivni TUI klijent za razgovor (komande: /model /combo /skill /memory) omniroute setup # vođeni čarobnjak za prvo pokretanje omniroute doctor # dijagnosticiraj pružaoce usluga, portove i izvorne zavisnosti ``` ### 🛰️ Udaljeni način rada — pokrenite CLI ovdje, a OmniRoute na VPS-u OmniRoute je na serveru? Upravljajte njime sa svog laptopa koristeći **isti CLI**. Prijavite se jednom pomoću pristupnog tokena ograničenog opsega; svaka komanda će se zatim izvršavati na udaljenom serveru. ```bash omniroute connect 192.168.0.15 # lozinka → token ograničenog opsega, sačuvan kao kontekst omniroute models # ← izvršava se na UDALJENOM serveru omniroute configure codex # ← bira udaljeni model, zapisuje lokalni Codex profil omniroute tokens create --name ci --scope read # kreiraj tokene užeg opsega za druge uređaje omniroute contexts use default # ← prebaci se nazad na lokalni server ``` Tokeni imaju opseg `read` / `write` / `admin`; rute koje pokreću procese ostaju dostupne samo putem 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 — kružeći kroz površinu najvišeg nivoa sa 89 komandi: 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 kod) dobija pristup cijelom pristupniku: usmjeravanju, pružaocima usluga, kombinacijama, predmemoriji, kompresiji i memoriji — potpuno samostalno. HTTP krajnje tačke ispod dostupne su putem `http://localhost:20128`.
InterfejsKrajnja tačka / komandaKoristite za
🧰 MCP (stdio)omniroute --mcpPovezivanje s Claude Desktopom, Cursorom ili bilo kojim MCP klijentom
🌊 MCP (HTTP)/api/mcp/streamUdaljeni MCP — 110 alata, 33 opsega (primjena po izboru), potpuni revizijski trag
📡 MCP (SSE)/api/mcp/sseMCP prijenos kontinuiranim tokom
🤝 A2A/.well-known/agent.jsonKomunikacija između agenata, JSON-RPC 2.0 + SSE, 6 vještina
🌐 REST API/v1/*Kompatibilan s OpenAI-jem — razgovor, ugrađivanja, slike, zvuk, OCR
🔔 Webhookovi/api/webhooksŠaljite događaje zahtjeva / kvota na Slack, Discord, Telegram ili bilo koji URL
🛰️ Udaljeni CLIomniroute connect Upravljajte udaljenom instancom pomoću pristupnih tokena ograničenog opsega
```bash # Omogućite Claude Codeu potpuni 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) · [Protokoli za agente](docs/frameworks/AGENT_PROTOCOLS_GUIDE.md)
## 🗜️ Automatski uštedite 15–95% tokena
### 📖 Kako funkcioniše — cjevovod, arhitektura i računica uštede OmniRouteov cjevovod kompresije: ilustrativni klijentski zahtjev od 10.000 tokena prolazi kroz 12 kompozabilnih mehanizama — Session-Dedup, CCR, Lite, RTK, Responses Tool Output, Headroom, Relevance, Caveman, Aggressive, LLMLingua-2, Ultra i OmniGlyph — i u dokumentovanom složenom primjeru može stići do pružaoca sa približno 1.080 tokena. Strukturirani sadržaj zaštićen je zaštitnim mehanizmima za očuvanje i provjerama vjernosti po koracima; eksplicitni gubitnički ili eksperimentalni režimi mogu transformisati sadržaj koji ispunjava uslove. Podrazumijevana složena kombinacija pokreće `RTK → Caveman`. Kada oba djeluju na istom alatu/kontekstualnom sadržaju, uštede se kumuliraju: ```txt combined = 1 − (1 − RTK) × (1 − Caveman_input) average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2% range = 78.4 – 94.6% ``` Blokovi koda, URL-ovi, JSON i strukturirani podaci su **uvijek zaštićeni** mehanizmom za očuvanje. > **Zašto koristiti mnogo tokena kada nekoliko tokena završava posao?** Svaki zahtjev prolazi kroz OmniRouteov cjevovod kompresije **transparentno** — bez izmjena na klijentu. Sada je to **skup od 12 kompozabilnih mehanizama** koji se pokreću redom i mogu se kombinovati za svaku kombinaciju rutiranja — nadovezujući se na 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). ### 🧱 Složeni sistem od 12 mehanizama Mehanizmi se pokreću redoslijedom cjevovoda; svaki se može nezavisno uključiti ili isključiti i konfigurisati za svaku kombinaciju:
#MehanizamŠta radi
1Session-DedupUklanja sadržaj koji se ponavlja kroz različite poruke (adresirano sadržajem, kroz više poruka)
2CCRArhivira velike blokove iza oznaka za preuzimanje, koji se dohvataju na zahtjev
3LiteUklanjanje razmaka i skraćivanje URL-ova slika (osnovna opcija s malim kašnjenjem)
4RTKPametno filtriranje rezultata alata, uklanjanje duplikata i skraćivanje (svjestan komandi)
5Responses Tool OutputKompresija JSON-a koja prvo čuva sadržaj, uz ograničenu dijagnostičku kompresiju izlaza ljuske/zakrpe/pretrage/izgradnje (Responses API)
6HeadroomKompaktiranje JSON nizova u tabelarnom obliku bez gubitaka (~30%) pomoću ugrađenog GCF kodeka
7RelevanceEkstraktivno rangiranje rečenica u odnosu na posljednji korisnički upit
8CavemanKompresija proze zasnovana na pravilima (~65–75% izlaza)
9AggressiveSažimanje i progresivno starenje starih poruka
10LLMLingua-2Semantičko uklanjanje pomoću ML-a putem MobileBERT ONNX — sigurno za kod, asinhrono
11UltraHeurističko uklanjanje tokena uz opcioni nivo malog modela (SLM)
12OmniGlyphEksperimentalno kodiranje konteksta kao slike za izmjereni Claude Fable 5 na direktnoj Anthropic vezi; GPT 5.6 transformatori ostaju zatvoreni u slučaju neuspjeha dok se ne dobiju potvrde pružaoca. Četiri profila kompresije (podrazumijevano agresivni, uravnoteženi, sigurni za kodiranje, prolazni) (najagresivniji; uključuje se po izboru)
Blokovi koda, URL-ovi i strukturirani podaci su **uvijek očuvani bajt po bajt**. **Unaprijed podešene opcije jednim klikom** kombinuju mehanizme:
RežimUštedaNajbolje za
🪶 Lite~15%Sigurna podrazumijevana opcija koja je uvijek uključena
🪨 Standard (Caveman)~30%Svakodnevno programiranje
⚡ Aggressive~50%Duge sesije s mnogo alata
🔥 Ultra~75%Maksimalna ušteda
🧰 RTK60–90%Izlaz ljuske/testiranja/izgradnje/git-a
🔗 Stacked (RTK → Caveman)78–95%Kombinovani upiti i dnevnici alata
**Stvarni primjer — standardni režim:** > **Prije (69 tokena):** _"Razlog zbog kojeg se vaša React komponenta ponovo iscrtava vjerovatno je to što pri svakom ciklusu iscrtavanja kreirate novu referencu objekta. Kada proslijedite ugrađeni objekat kao svojstvo, Reactovo plitko poređenje ga svaki put vidi kao drugi objekat, što pokreće ponovno iscrtavanje. Preporučio bih upotrebu useMemo za memorisanje objekta."_ > > **Poslije (19 tokena):** _"Nova referenca objekta pri svakom iscrtavanju. Ugrađeno svojstvo objekta = nova referenca = ponovno iscrtavanje. Umotajte u useMemo."_ > > **Isti odgovor. 72% manje tokena. Bez gubitka preciznosti.** ✅ **PT-BR primjer — režim [Troglodita](https://github.com/leninejunior/troglodita):** > **Prije (42 tokena):** _"Problem je u tome što se komponenta ponovo renderuje jer se u svakom ciklusu renderovanja kreira nova referenca objekta. Preporučio bih korištenje useMemo."_ > > **Poslije (12 tokena):** _"Ponovno renderovanje: nova referenca u svakom ciklusu (inline objekat ponovo kreiran). Koristiti `useMemo`."_ > > **Isti odgovor. ~70% manje tokena. Tehnička preciznost očuvana.** ✅
### 🎚️ Iza mehanizama — stilovi izlaza, adaptivni regulator i kontrola po zahtjevu Navedenih 12 mehanizama smanjuje ono što **ulazi**. Još tri sloja oblikuju **kako**, **kada** i šta **izlazi**: - **🪄 Stilovi izlaza** _(usmjeravanje ose izlaza)_ — ubacuju determinističke instrukcije za oblikovanje odgovora, sigurne za keširanje; mogu se kombinovati, a svaki je dostupan na intenzitetima `lite` / `full` / `ultra`. Dodavanje stila je unos u registar u jednom redu: - **Sažeta proza** — ukloniti popunjavanje / članove / ograđivanje; zadržati tehnički sadržaj potpuno preciznim. - **Manje koda** — YAGNI pristup „lijenog senior developera“: najmanja funkcionalna izmjena, bez nepotražene infrastrukture. - **Konjski rep (lijeni senior developer)** — popeti se YAGNI ljestvicom, otkloniti osnovni uzrok, najmanji funkcionalni diff. - **Imam ADHD (akcija na prvom mjestu)** — sljedeća akcija je na početku, koraci su numerisani, jedan konkretan sljedeći korak, bez uvoda. - **Sažeti CJK (文言)** — ultrasažeti stil klasičnog kineskog jezika (ograničen na lokalizaciju `zh`). - **🎯 Adaptivni budžet konteksta** _(regulator)_ — umjesto jednog praga tokena koji je uključen ili isključen, eskaliraju se najjeftiniji mehanizmi s najmanjim gubitkom samo onoliko koliko je potrebno da se sadržaj **uklopi u prozor konteksta modela**. Pravila: `reserve-output` (podrazumijevano, prilagođeno modelu) · `percentage` · `absolute`. Režim: `floor` (garantuje uklapanje) · `replace-autotrigger` (vaš izričiti izbor ima prednost) · `off` (naslijeđeni prag). - **🎛️ Gdje se odlučuje kompresija** _(prioritet, od višeg ka nižem)_ — zaglavlje po zahtjevu `x-omniroute-compression` › premošćavanje kombinacije rutiranja › aktivni imenovani profil › adaptivni / automatski okidač › podrazumijevana vrijednost panela › isključeno. Primijenjeni plan se vraća u zaglavlju odgovora `X-OmniRoute-Compression: ; source=`. Pokrenite automatski okidač prema pragu tokena, uključite adaptivni regulator, zakačite imenovani profil, postavite jednokratnu vrijednost po zahtjevu ili dodijelite cjevovod svakoj kombinaciji rutiranja — šta god najbolje odgovara radnom opterećenju. Opcionalni offline **okvir za evaluaciju** (`npm run eval:compression`) procjenjuje vjernost u odnosu na uštedu na fiksiranom korpusu prije nego što promovišete izmjenu. 📖 [`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 zavisnostima? [Bezopasna su](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated). > **Koristite npm 11 ili noviji?** npm može blokirati skripte životnog ciklusa paketa dok im ne dozvolite izvršavanje. OmniRouteov `postinstall` (`node scripts/build/postinstall.mjs`) potreban je za pripremu izvornih datoteka runtime okruženja. Prilikom globalne instalacije dozvolite pakete navedene u npm upozorenju. Za skup paketa koji prijavljuje OmniRoute 3.8.54: > > ```bash > npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute > ``` > > Da biste ovu listu dozvola ponovo koristili pri budućim globalnim instalacijama, jednom je konfigurišite, a zatim instalirajte uobičajeno: > > ```bash > npm config set allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild --location=user > npm install -g omniroute > ``` > > Lista zavisnosti može se promijeniti između izdanja; ako npm prijavi drugačiju listu, koristite nazive paketa iz tog upozorenja. Dozvoljavanje paketa omogućava izvršavanje njegovih instalacijskih skripti. > **Koristite Gemini Web ili drugog pružaoca koji koristi web kolačiće?** npm paket uključuje > Playwright, ali ne i njegov Chromium binarni fajl. Pogledajte bilješku > [Postavljanje Playwright Chromiuma](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium) > prije slanja prvog zahtjeva web-pružaocu. Kontrolna tabla na `http://localhost:20128` · API na `http://localhost:20128/v1`. **2) Povežite podržanog pružaoca koristeći vlastiti račun** Kontrolna tabla → **Pružaoci** → odaberite pružaoca čiji trenutni uslovi i kvota odgovaraju vašem slučaju upotrebe → dodajte njegov API ključ ili dovršite postupak za račun. Besplatni nivoi mogu zahtijevati registraciju, odobrenje ili način plaćanja. Pregledajte [Vodič kroz besplatne nivoe](docs/getting-started/FREE-TIERS-GUIDE.md); dostupnost bez ključa nije zagarantovana, a pružaoci označeni sa `tos: avoid` podrazumijevano su isključeni iz `auto`. **3) Usmjerite svoj alat za programiranje** ```txt Base URL: http://localhost:20128/v1 API Key: [copy from Dashboard → Endpoints] Model: auto (routes among eligible connections — or choose provider/model) ``` **4) Provjerite da li radi** ```bash curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY" ``` Trebalo bi da vidite navedene povezane modele. 🎉 To je sve — počnite programirati, a OmniRoute će automatski usmjeravati zahtjeve i prebacivati se na rezervne opcije umjesto vas. Ako vaš klijent ne može slati prilagođena zaglavlja, OmniRoute takođe nudi tokenizirane pseudonime 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 ih samo za klijente koji ne mogu dodati `Authorization: Bearer ...`. Autentifikacija putem zaglavlja ostaje preporučeni režim.
## 📦 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 `main`. Fiksirajte `:X.Y.Z` za GitOps. Pogledajte [Docker kanale izdanja](docs/guides/DOCKER_GUIDE.md#release-channels). Slika postavlja **`OMNIROUTE_MEMORY_MB=1024`**. To je dovoljno za kontrolnu ploču i lagani razgovor. **Agenti za programiranje** (`POST /v1/responses` iz Claude Codea, Codexa, Groka, …) zahtijevaju znatno veću V8 gomilu ili će proces prijaviti `FATAL ERROR` na približno 12 GiB pri dva preklapajuća duga konteksta. Dodijelite kontejneru više memorije od veličine gomile (izvorni međuspremnici nalaze se izvan V8): | Radno opterećenje | Gomila (`-e OMNIROUTE_MEMORY_MB`) | Kontejner (`--memory`) | | ------------------------------------ | --------------------------------- | ---------------------- | | Kontrolna ploča / lagani razgovor | `1024` (zadana vrijednost slike) | ≥2 g | | Jedan agent za programiranje | `8192` | ≥10 g | | Dva istovremena 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 ``` Kompletna tabela: [Docker vodič — RAM za vrijeme izvođenja](docs/guides/DOCKER_GUIDE.md#runtime-ram-for-coding-agents). > **Docker kanal za predizdanja:** `diegosouzapw/omniroute:next` i > `diegosouzapw/omniroute:next-web` prate trenutnu zadanu `release/v*` > granu. Ove promjenjive oznake namijenjene su samo za testiranje neobjavljenih ispravki i > **nisu podržane za produkciju**. Pogledajte > [Docker 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 Bun izvršnog okruženja: - **Ugrađeni `bun:sqlite`**: OmniRoute koristi Bunov ugrađeni upravljački program `bun:sqlite` kada se izvršava u Bunu, uz rezervni prelazak na `better-sqlite3` u Node.js-u ili na `sql.js`. - **Automatski odabir Webpack alata za objedinjavanje u razvojnom okruženju**: Razvoj (`bun run dev`) automatski otkriva Bun i onemogućava Turbopack u korist Webpacka kako bi spriječio nekompatibilnosti izvornih V8 povezivanja. Produkcijske izgradnje (`bun run build`) tačno slijede `OMNIROUTE_USE_TURBOPACK`, kao i na Nodeu: Turbopack je zadan, a `OMNIROUTE_USE_TURBOPACK=0` omogućava izgradnju pomoću Webpacka (`Dockerfile.bun` ga izlaže kao `--build-arg`). - **Namjenski Bun Dockerfile**: Višefazni `Dockerfile.bun` za izvorne Bun produkcijske implementacije (`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 # Korištenje Nix flakesa nix develop npm run dev # Ili korištenje devboxa devbox run npm run dev ``` 📖 [Docker vodič](docs/guides/DOCKER_GUIDE.md) — Compose profili, Caddy HTTPS, Cloudflare tuneli. **🦭 Podman** ```bash # 1. Pripremite direktorij podataka montiran povezivanjem mkdir -p data # 2. Samo Linux + lokalni rootless Podman (nikada udaljeni klijent za Podman Machine): 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 macOS-u ili Windowsu Podman koristi 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 izgradnje, Podman Machine i postavljanje Linux/systemd Quadleta. **⚡ Brža / jednostavnija instalacija (preskočite izvornu izgradnju)** Izvorni SQLite mehanizam (`better-sqlite3`) **neobavezna** je zavisnost, pa globalna instalacija nikada ne čeka kompiliranje iz izvornog koda: koristi unaprijed izgrađenu binarnu datoteku kada ona odgovara vašoj platformi/Nodeu, a u suprotnom neprimjetno prelazi na čisti JS mehanizam (`node:sqlite` na Nodeu 22+, inače na uključeni `sql.js` WASM) — nisu potrebni alati za izgradnju. Da biste u potpunosti preskočili **izvorno zagrijavanje** nakon instalacije (CI, sistemi bez grafičkog sučelja ili spori računari). Napomena: ovime se preskače samo korak zagrijavanja izvornog SQLitea (`scripts/postinstall.mjs`); skripta za kopiranje/popravku binarne datoteke (`scripts/build/postinstall.mjs`) i dalje se normalno izvršava: ```bash OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute # CI=1 ga također preskače ``` Za najbrže instalacije koristite **pnpm** (spremište adresirano sadržajem + tvrde veze — pogledajte iznad). Za izvršno okruženje bez kontrolne ploče i grafičkog sučelja koristite Docker profil `base` (iznad) ili [Termux vodič](docs/guides/TERMUX_GUIDE.md). CLI i web-kontrolnu ploču poslužuje isti proces na jednom portu, pa trenutno ne postoji zaseban paket samo za CLI.
# 🎬 OmniRoute na djelu
## 📹 Video vodiči
Snimak kontrolne ploče od 2026-10-18 · Sirovi katalog: YT 1.352 | TT 334 | IG 290 · Svježina (dani): YT 5 | TT 48 | IG 49
Instagram Reel — nick_saraev
🎬 #1 — Instagram
nick_saraev — 3,042,474 pregleda
Instagram Reel — nnapier7
🎬 #2 — Instagram
nnapier7 — 1,454,535 pregleda
YouTube — Amidia AI & Tech
🎬 #3 — YouTube
Amidia AI & Tech — 794,974 pregleda
Instagram Reel — theopenstack
🎬 #4 — Instagram
theopenstack — 692,419 pregleda
TikTok — migue.baena
🎬 #5 — TikTok
migue.baena — 685,788 pregleda
**Potpuna rang-lista (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** | [nnapier7 — Instagram](https://www.instagram.com/reel/Dbp7wv_CIO0/) — **1,454,535** | [Amidia AI & Tech — YouTube](https://www.youtube.com/watch?v=NJ0TQ-pyMDY) — **794,974** | [theopenstack — Instagram](https://www.instagram.com/reel/DaSs65mMrHk/) — **692,419** | [migue.baena — TikTok](https://www.tiktok.com/@migue.baena/video/7670919268216622358) — **685,788** | | #6 | #7 | #8 | #9 | #10 | | ------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | | [milesreevesai — TikTok](https://www.tiktok.com/@milesreevesai/video/7667980059189366019) — **620,400** | [nikothetech — TikTok](https://www.tiktok.com/@nikothetech/video/7671890769665477918) — **610,803** | [Vaibhav Sisinty — YouTube](https://www.youtube.com/watch?v=QucgvbO5gsM) — **509,281** | [buildwithai.club — Instagram](https://www.instagram.com/reel/DbIt9AjK7-U/) — **347,652** | [nivedan.ai — Instagram](https://www.instagram.com/reel/DbIrCksJiqq/) — **331,973** | Kanonske metrike na dan 2026-10-18: **1.976 jedinstvenih videozapisa** · **20.220.289 poznatih pregleda** (`v > 0`) · **1.210 kanala/profila po mreži**. Sirova kontrolna ploča sadrži 1.976 redova (YouTube 1.352 = 740 dugih videozapisa + 612 Shorts videozapisa · TikTok 334 · Instagram 290); nakon normalizacije prema kanonskom URL-u, koja zadržava najveći broj pregleda po videozapisu, nisu preostali duplikati. Prikupljanje podataka s YouTubea zamrznuto je na 2026-10-13 (API kvota je iscrpljena od 14. do 18.10.), a s TikToka/Instagrama od 2026-09-02 (nema kredita za prikupljanje); 76 videozapisa još nema podatak o broju pregleda. > 🎬 **Napravili ste video o OmniRouteu?** Otvorite [prijavu problema](https://github.com/diegosouzapw/OmniRoute/issues/new) ili [diskusiju](https://github.com/diegosouzapw/OmniRoute/discussions) s poveznicom — predstavit ćemo ga ovdje.
# 📧 Zajednica i pomoć > Sve na jednom mjestu — pratite održavaoca, razgovarajte sa zajednicom ili otvorite prijavu problema. | Kanal | Gdje / kako | | ---------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- | | 💼 **LinkedIn** — pratite održavaoca | [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 greš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 projekat** | [Načini podrške ↑](#-support-omniroute) · [GitHub Sponsors](https://github.com/sponsors/diegosouzapw) |
---
## 🛠️ Tehnološki skup
SlojTehnologija
Izvršno okruženjeNode.js 22.x / 24.x LTS — >=22.22.2 <23 || >=24.0.0 <27
JezikTypeScript 6.0 — 100% TypeScript kroz src/ i open-sse/ (nula any u jezgri od v2.0)
OkvirNext.js 16 + React 19 + Tailwind CSS 4
Baza podatakabetter-sqlite3 (SQLite, WAL evidentiranje) + LowDB (naslijeđeni JSON) — 147 domenskih modula, 233 migracija
MemorijaSQLite FTS5 pretraga punog teksta + vektorska ugrađivanja kvantizovana na int8, tipizirano opadanje
ŠemeZod 4 — validacija I/O MCP alata + API ugovori
ProtokoliMCP (stdio / HTTP / SSE) + A2A v0.3 (JSON-RPC 2.0 + SSE)
StrimanjeServer-Sent Events (SSE) + WebSocket most (/v1/ws)
Kompresija12 mehanizama — RTK, Caveman, LLMLingua-2 (MobileBERT ONNX), GCF, OmniGlyph
Autentikacija i sigurnostOAuth 2.0 (PKCE) + JWT + API ključevi + MCP autentikacija s opsegom · AES-256-GCM u mirovanju · DOMPurify
Prikrivanjewreq-js — oponašanje JA3 / JA4 TLS otiska, proxy s 3 nivoa
OtpornostPrekidač strujnog kola, eksponencijalno povratno čekanje, zaštita od stampeda, samopopravljanje automatskih kombinacija
Evidentiranjepino — strukturirani JSON dnevnici s kontekstom zahtjeva
TestiranjeNode.js pokretač testova + Vitest — 60.000+ statičkih deklaracija testova kroz 8.400+ evidentiranih datoteka testova (jedinični, integracijski, E2E, sigurnosni, ekosistemski)
PlatformeDesktop (Electron) · Android (Termux) · PWA (bilo koji preglednik)
CI/CDGitHub Actions — automatsko objavljivanje na npm + Docker Hub pri izdanju
VezeWeb-stranica · npm · Docker Hub

## 📖 Dokumentacija
### 📘 Početak rada
DokumentOpis
Korisnički vodičProvajderi, kombinacije, CLI integracija, implementacija
Vodič za podešavanjePotpune metode instalacije, konfiguracije CLI alata, podešavanje protokola, podešavanje vremenskog ograničenja
Vodič za CLI alatePodešavanje po alatu za Claude Code, Codex, Cursor, Cline, OpenClaw, Kilo, Copilot
Udaljeni režimUpravljanje udaljenim OmniRoute-om (VPS) iz CLI-ja na vašem laptopu putem tokena za pristup ograničenog opsega
Konfiguracija Claude Code-aUsmjerite Claude Code na OmniRoute (lokalni/udaljeni) pomoću launch + profila po modelu
Brzi početakInstalirajte → povežite → konfigurišite u 3 koraka
### 🔧 Operacije i implementacija
DokumentOpis
Docker vodičDocker pokretanje, Compose profili, Caddy HTTPS, tuneli, oznake slika
Podman vodičQuadlet systemd integracija, podman-compose, SELinux
Implementacija na VM-uKompletan vodič: podešavanje VM-a + nginx-a + Cloudflare-a
Implementacija na Fly.ioImplementacija na Fly.io uz trajnu pohranu
Termux vodičPokretanje OmniRoute-a na Androidu putem Termuxa
PWA vodičInstalacija progresivne web-aplikacije, keširanje, arhitektura
Vodič za deinstalacijuPotpuno uklanjanje za sve metode instalacije
Konfiguracija okruženjaKompletne .env varijable i reference
### 🧠 Funkcije i arhitektura
DokumentOpis
ArhitekturaArhitektura sistema, tok podataka i interne komponente
Vodič za kompresijuCjevovod sa 7 opcija: off / lite / standard / aggressive / ultra / RTK / stacked
RTK kompresijaKompresija izlaza komandi, filteri, povjerenje, verifikacija, oporavak sirovog izlaza
Mehanizmi kompresijeCaveman, RTK, naslagani cjevovodi, dashboard/API/MCP površine
Format pravila kompresijeJSON sheme paketa pravila za Caveman i RTK filtere
Jezički paketi kompresijeDetekcija jezika i izrada Caveman paketa pravila
Vodič za otpornostPrekidači, periodi hlađenja, red čekanja, zaštita od istovremenog naleta zahtjeva, TLS spoofing
Mehanizam automatskih kombinacijaBodovanje na osnovu 16 faktora, paketi režima, samostalno otklanjanje problema
Vodič za proxyProxy sistem na 3 nivoa, 1proxy tržište, CRUD registra
Besplatni nivoiKonsolidovani direktorij: 34 dokumentovana periodična skupa / 465 katalogizovanih stavki besplatnog nivoa
Galerija funkcijaVizuelni obilazak dashboarda sa snimcima ekrana
Dokumentacija baze kodaVodič kroz bazu koda prilagođen početnicima
### 🤖 Protokoli i API-ji
DokumentOpis
API referencaSve krajnje tačke sa primjerima
OpenAPI specifikacijaOpenAPI 3.0 specifikacija
MCP server110 MCP alata, IDE konfiguracije, Python/TS/Go klijenti
Vodič za MCP serverMCP instalacija, transporti i referenca alata
A2A serverJSON-RPC 2.0 protokol, vještine, strimovanje, upravljanje zadacima
Vodič za A2A serverA2A kartica agenta, zadaci, vještine i strimovanje
### 📋 Projekat i kvalitet
DokumentOpis
DoprinosiPostavljanje razvojnog okruženja i smjernice
Model grananja i izdanjaGdje PR-ovi ciljaju (release/*), šta znače main i oznake
Dnevnik promjenaPotpuna historija izdanja po verzijama
Sigurnosna politikaPrijavljivanje ranjivosti i sigurnosne prakse
Vodič za i18nPodrška za 67 jezika, tok prevođenja, RTL
Kontrolna lista za izdanjeKoraci provjere prije izdanja
Plan pokrivenostiStrategija pokrivenosti testovima za više od 60,000 statičkih deklaracija testova kroz više od 8,400 praćenih datoteka testova

# ⭐ Najvažniji doprinosioci > OmniRoute oblikuje strastvena zajednica otvorenog koda. Ove osobe dale su izuzetne doprinose koji direktno utiču na kvalitet, stabilnost i doseg projekta. **Hvala vam.** ### Vanjski doprinosioci prema spojenim pull requestovima
RangDoprinosilacSpojeni PR-ovi~Izmijenjeni redovi
1maxmad64bis41825,367,739
2HouMinXi29513,557,796
3pacocartones22281,551
4backryun210270,562
5JxnLexn1983,570,623
6oyi77190411,243
7KooshaPari1515,972,314
8rdself14580,663
9RaviTharuma123500,065
10herjarsa88230,872
11hartmark852,849,623
12jonlwheat2-gif6869,097
13artickc6243,502
14xiaoyaner020159126,220
15chirag127526,661
16xz-dev50245,976
17woodsonl48811,771
18rqzbeh46151,229
19MumuTW4328,166
19QuangBlue4313,112
Popis je napravljen 2026-11-03 03:01:19 UTC, uz aktuelni vrh release/v3.8.53 grane 05bc048d6c. Paginirani GitHub GraphQL popis sadrži 9,947 spojenih PR-ova: 4,130 autora repozitorija, 240 servisa Dependabot, 6 drugih botova/aplikacija i 5,571 vanjski PR od 883 različita doprinosioca. „Izmijenjeni redovi“ predstavljaju GitHubove dodatke + brisanja i uključuju generisane datoteke, lockfileove, kataloge, prevode i dokumentaciju; to je količina izmjena, a ne autorski LOC. Za 53 PR-a GitHub prikazuje razlike veće od 500,000 redova (naprimjer, #13399, jedno dodavanje provajdera, navodi 2,347 izmijenjenih datoteka), što povećava nekoliko gornjih ukupnih vrijednosti. Jednaki rezultati rangirani su zajedno. ### Komitovi pripisani GitHubu
Dizzle
Dizzle

🥇 418 GitHubom pripisanih commitova
Bob.Hou
Bob.Hou

🥈 294 GitHubom pripisana commita
Paijo
Paijo

🥉 229 GitHubom pripisanih commitova
Paco Cartones
Paco Cartones

🏅 222 GitHubom pripisana commita
backryun
backryun

🏅 202 GitHubom pripisana commita
Jan Leon
Jan Leon

🏅 134 GitHubom pripisana commita
Ravi Tharuma
Ravi Tharuma

🏅 126 GitHubom pripisanih commitova
Markus Hartung
Markus Hartung

🏅 115 GitHubom pripisanih commitova
Randi
Randi

🏅 108 GitHubom pripisanih commitova
Chris
Chris

🏅 70 GitHubom pripisanih commitova
WebPerson
WebPerson

🏅 68 GitHubom pripisanih commitova
Koosha Paridehpour
Koosha Paridehpour

🏅 68 GitHubom pripisanih commitova
Ponovo provjereno 2026-11-03 02:09:16 UTC: commitovi koje je GitHub pripisao, a koje je prijavio Contributors API repozitorija za zadanu granu release/v3.8.53. API je vratio 903 identiteta (429 korisnika, 2 bota, 472 anonimna identiteta); ova tabela isključuje održavaoca, botove i anonimne identitete te zadržava izjednačene rezultate. Razlikuje se i od rangiranja iznad prema spojenim PR-ovima i od popisa u nastavku zasnovanog na Git metapodacima. > 🙏 Funkcionalnosti, ispravke grešaka i poboljšanja infrastrukture ovih saradnika **ključni su dio** onoga što OmniRoute čini pouzdanim i bogatim funkcionalnostima. Svaki pull request, svaki testni slučaj i svaka i18n datoteka za prevođenje su važni. Otvoreni kod stvaraju ljudi poput njih.
---
## 💖 Sponzori
Od srca hvala ljudima koji finansiraju OmniRoute iz vlastitog džepa — svaki doprinos pomaže da projekat ostane besplatan, nezavisan i da nastavi napredovati.
Andrew
Andrew

💛 Aktivni mjesečni sponzor
Vlad I
Vlad I

💛 Aktivni mjesečni sponzor
小妍儿
小妍儿

💛 Aktivni mjesečni sponzor
Guilherme Costa
Guilherme Costa

💛 Aktivni jednokratni sponzor
Henrique Triches Iurkiv
Henrique Iurkiv

💛 Aktivni jednokratni sponzor
Somesh Ghaturle
Somesh Ghaturle

💛 Aktivni jednokratni sponzor
Kolonie AI
Kolonie AI

💛 Raniji jednokratni podržavalac
Professor Igor Morais Vasconcelos
Prof. Igor Morais

💛 Raniji jednokratni podržavalac
Pixma
Pixma

💛 Raniji jednokratni podržavalac
Paco Cartones
Paco Cartones

💛 Raniji jednokratni podržavalac
longtao
longtao

💛 Raniji jednokratni podržavalac
… i ostali koji žele ostati privatni 💛 Javni GitHub sponzori ponovo su provjereni 2026-10-18 putem GitHub Sponsors GraphQL API-ja: 11 javnih sponzorstava (6 aktivnih, 5 ranijih) od ukupno 14. GitHubov status isActive određuje gornje oznake aktivnih sponzora; ranijim javnim jednokratnim podržavaocima i dalje se zahvaljujemo, dok privatni sponzori ostaju anonimni. Donacije putem servisa Ko-fi, Buy Me a Coffee, Liberapay, PIX i kriptovaluta nisu navedene jer za njih ne postoji javni zapis o sponzoru. 💖 Postanite sponzor → — svaki dolar pomaže da OmniRoute ostane besplatan i nezavisan.

## 👥 1.000+ Saradnika
[![Saradnici](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=1074&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors) Revidirano 2026-11-02. na aktivnom vrhu release/v3.8.53 grane 1c7135e0fb (7.972 commita): 1.074 normaliziranih ljudskih Git identiteta — 759 se pojavljuje kao autori commita (uključujući održavaoca), a 315 samo u eksplicitnim Co-authored-by dodacima. Popis primjenjuje .mailmap, poredi adrese e-pošte bez obzira na velika i mala slova, objedinjuje numeričke i obične GitHub noreply adrese samo kada kodiraju isto korisničko ime, isključuje 29 identiteta botova/agenta/servisa/rezerviranih vrijednosti i ne objedinjuje obične adrese e-pošte samo zato što im se prikazana imena podudaraju. Revizija od 2026-08-24. objavila je broj 639; ponovnim pokretanjem ove metode nad osnovom te revizije ac02c5b42f dobija se 619, tako da povećanje dolazi od novih saradnika, a ne od blaže metode. ### Kako doprinijeti 1. Napravite fork repozitorija 2. Kreirajte granu iz vrha **aktivne** grane `release/vX.Y.Z` (ne iz grane `main`) — pogledajte [Model grananja i izdanja](docs/ops/BRANCHING_MODEL.md) 3. Kreirajte svoju granu funkcionalnosti (`git checkout -b feat/amazing-feature`) 4. Commitujte promjene (`git commit -m 'feat: add amazing feature'`) 5. Pošaljite promjene na granu (`git push origin feat/amazing-feature`) 6. Otvorite Pull Request sa **osnovom = tom granom** `release/vX.Y.Z` Pogledajte [CONTRIBUTING.md](CONTRIBUTING.md) za detaljne smjernice. ### Objavljivanje 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 Grafikon historije zvjezdica
## 🌍 StarMapper 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 odatle je svaki podsistem u nastavku inspirisan open-source projektom koji je prvi stigao do tog rješenja. Svaki od njih oblikovao je konkretan dio OmniRoutea. Ovo je naša zahvala svima njima. 🙏 > ⭐ broj zvjezdica provjeren putem GitHub REST API-ja 3. novembra 2026. — dajte ovim projektima zvjezdicu. Brojevi predstavljaju tačan snimak stanja na navedeni datum i prirodno će se mijenjati. ### 🧬 Porijeklo i gateway
Projekat⭐Kako je inspirisao OmniRoute
9router31,861Originalni projekat na kojem je ovaj fork izgrađen — ovdje proširen multimodalnim API-jima i potpunim prepisivanjem u TypeScriptu.
CLIProxyAPI57,329Go implementacija koja je inspirisala ovaj JavaScript / TypeScript port.
LiteLLM62,580AI gateway čiji javni skup podataka o cijenama pokreće našu sinhronizaciju praćenja troškova i čiji je model normalizacije pružalaca usluga usmjerio naše rutiranje.
codex-chatgpt-web15,435MIT izvor prilagođen ugrađenom mostu ChatGPT Web → Codex Responses, uključujući adaptere za sesiju pregledača, uokvirivanje odgovora, korištenje i web-pretragu.
free-claude-code65,966Obrasci preneseni u oporavak toka, aliasе bez razmišljanja, rezervnu web-pretragu, ograničenja kliznog prozora, uklanjanje osjetljivih podataka iz zapisa i učvršćene tokove pokretača.
composer-api347Obrasci za izbor alata Cursor Composer, ograničenja izlaza i potvrđivanje alata prilagođeni izvornom izvršavaču Cursor.
codex-multi-auth561Obrasci za novu prijavu i rotaciju tokena za osvježavanje preneseni u OAuth ponovnu autentifikaciju Codexa.
opencode-anthropic-auth562Podrazumijevane vrijednosti transformacije kompatibilne s Claude Codeom i ponašanje zaglavlja za naplatu uopšteni su u OmniRouteov most zasnovan na konfiguraciji.
grok2api-merged2Njegova mapiranja Grok modela, Statsig generator lažnog TypeError-a, podrazumijevane vrijednosti zahtjeva i uređaja te procesor NDJSON odgovora materijalno su prilagođeni u OmniRouteov izvršavač Grok Web.
TQZHR/grok2api707Glavni tranzitivni izvor koda iza projekta grok2api-merged; njegove implementacije modela, zaglavlja, korisnog sadržaja, Statsiga i procesora sačuvane su u porijeklu Grok Weba.
chenyme/grok2api7,874Osnovni MIT izvor za podrazumijevane vrijednosti Grok korisnog sadržaja i uređaja, Statsig generator i procesor result.response prenesen kroz TQZHR i grok2api-merged.
grok2api-pro27Tranzitivni izvor koji grok2api-merged navodi za svoj sloj skupa proxy servera; OmniRoute čuva tu napomenu o porijeklu, ali ne tvrdi da je prenio skup proxy servera u svom ograničenom izvršavaču Grok Web.
GrokProxy52Njegov Grok proxy autentifikovan kolačićima i obrazac strimovanja result.response.token uticali su na transport OmniRoutea za Grok Web.
GrokBridge5Izvorna implementacija Grok Weba poslužila je kao referenca za dizajn HTTP/browser upstreama; njen direktni HTTP put izveden je iz GrokProxyja, pa se ne tvrdi da je kod nezavisno prenesen.
### 🗜️ Kompresija konteksta i tokena — mehanizmi
Projekat⭐Kako je inspirisao OmniRoute
Caveman116,957Viralni projekat „why use many token when few token do trick“ — njegova filozofija govora pećinskog čovjeka pokreće naš standardni režim kompresije i više od 30 pravila za uklanjanje/sažimanje popunskih riječi.
RTK – Rust Token Killer85,350Kompresija izlaza komandi visokih performansi — inspirisala je naš RTK engine, JSON filter DSL, oporavak sirovog izlaza i naslagani RTK → Caveman cjevovod.
headroom78,672Reverzibilna kompresija konteksta (SmartCrusher) — inspirisala je naš headroom engine i obrazac oznake za preuzimanje ccr.
LLMLingua6,797Istraživanje kompresije prompta (LLMLingua / LLMLingua-2) — inspirisalo je naš asinhroni, bezbjedan za kod i fail-open llmlingua engine.
llmlingua-2-js33JS/ONNX port (MobileBERT / XLM-RoBERTa) koji se koristi kao pozadina niti radnika za naš LLMLingua engine.
Troglodita50PT-BR kompresija tokena — pokreće naš jezički paket pt-BR: smanjenje pleonazama i uklanjanje popunskih riječi prilagođeno gramatiki brazilskog portugalskog.
ponytail182,929Vještina viralnog „lijenog senior developera“ koji piše YAGNI kod — inspirisala je naš stil izlaza less-code: usmjeravanje ka najmanjoj funkcionalnoj promjeni koja smanjuje _generisani_ kod (srodnik Cavemanovog sažetog proznog izraza na osi izlaza).
i-have-adhd59,838Njegov stil odgovora prilagođen ADHD-u, usmjeren na radnju, prilagođen je u sažeti stil izlaza OmniRoutea na pet jezika.
### 🧩 Kompaktni formati, istraživanje tokena i alati svjesni koda
Projekat⭐Kako je inspirisao OmniRoute
TOON25,602Token-Oriented Object Notation — njegov kolonarski model sa zaglavljem i redovima oblikovao je našu fazu tabelarne kompakcije.
GCF – Graph Compact Format61Njegov kompaktni format grafa i dizajn generičkog profila uticali su na tabelarnu kompakciju OmniRoutea i format Headroom kodeka.
gcf-typescript4MIT TypeScript implementacija direktno uključena i proširena kao Headroom kodek generičkog profila.
token-optimizer-mcp566Brotli/SQLite keš + kontekstualna delta po sesiji — inspirisali su naš session-dedup engine.
token-savior1,203Kompakcija Bash izlaza + MCP profili — inspirisali su našu disciplinu odustajanja od kompresije i smanjenje manifesta MCP alata.
token-saver162Kompresija izlaza svjesna sadržaja, po tipu datoteke, uz odustajanje u slučaju neuspjeha — potvrdila je naše usmjeravanje po tipu i preskakanje kada je dobitak minimalan.
token-optimizer2,853„Pronađi skrivene tokene“ — njegov obrazac izdvajanja i rukovanja koji se može ponovo preuzeti uticao je na naše razmišljanje o CCR izdvajanju.
TokenMizer34Nacrt sesijskog grafa + deduplikacija redova kroz uzastopne poteze koji je uticao na naš dizajn session-dedup.
OmniCompress3Kolonarski JSON u Rustu + preuzimanje adresirano sadržajem + deduplikacija kroz poruke — potvrdili su naš dizajn enginea headroom/ccr/session-dedup i invarijantu stabilnosti keša „kompresovani oblik nezavisan je od pozicije“.
mcp-compressor140Kompresija MCP šeme/alata i opisa — uticala je na smanjenje kardinalnosti manifesta MCP alata.
RepoMapper218Rangiranje mape repozitorija u Aider stilu — uticalo je na naše istraživanje mape repozitorija / rangiranja preuzimanja.
quiet-shell-mcp4Deklarativno smanjenje izlaza ljuske kroz MCP — potvrdilo je našu deklarativnu kompakciju Bash izlaza.
ts-morph6,222Alatni komplet TypeScript Compiler API-ja — inspirisao je naše uklanjanje komentara zasnovano na parseru, koje čuva stringovne, predloške i regex literale.
### 🧠 Memorija i RAG
Projekat⭐Kako je inspirisao OmniRoute
Mem068,294Univerzalni memorijski sloj — njegov model proksija kao granice za upis/čitanje oblikovao je našu memorijsku arhitekturu.
Letta (MemGPT)25,321Agenti sa stanjem i slojevitom memorijom — inspirisali su naš slojeviti model Context Control & Recovery (CCR).
WFGY1,804Taksonomija ProblemMap sa 16 ponavljajućih režima neuspjeha RAG/LLM sistema — zajednički rječnik u našem vodiču za rješavanje problema.
### 🛰️ Inspekcija saobraćaja, MITM i transparentni proksi
Projekat⭐Kako je inspirisao OmniRoute
llm-interceptor81MITM presretanje i analiza saobraćaja između pomoćnika za programiranje i LLM-a uticali su na rane zahtjeve za Traffic Inspector. Četiri prethodno izvedena modula — spajanje SSE tokova, normalizacija razgovora, maskiranje tajni i sanitizacija zaglavlja — zamijenjene su nezavisnim implementacijama iz čistog okruženja, zasnovanim na javnim standardima protokola. Dvije površine za prosljeđivanje hosta (passthrough.ts i _internal/bypass.cjs) ostaju interne implementacije OmniRoute-a, klasifikovane nezavisno; nisu ponovo napisane u okviru te zamjene.
ProxyBridge6,978Transparentno usmjeravanje proksija po procesu — inspirisalo je naše MITM gašenje otporno na pad sistema, vremenska ograničenja neaktivnosti utičnica, atribuciju procesa putem /proc i TPROXY hvatanje.
### 📚 Podaci o modelima, observabilnost i korisnički interfejs
Projekat⭐Kako je inspirisao OmniRoute
models.dev7,486Otvorena baza specifikacija, cijena i mogućnosti AI modela — izvorno sinhronizovana sa našim katalogom modela.
React Flow / xyflow38,874Biblioteka grafova zasnovanih na čvorovima koja pokreće naše Studio za kompresiju i Studio za kombinovanje/usmjeravanje u realnom vremenu.
LangGraph44,349Vizualizacija grafikona tokova rada uživo u LangGraph Studio inspirisala je prikaz kaskade u realnom vremenu u našim Studijima.
Langfuse36,907Njegov model observabilnosti trace → span → generation oblikovao je vodopad u našem Studiju za kompresiju.
Kiali3,647Observabilnost Istio servisne mreže — inspirisala je naše oznake prekidača kola i vizuelne prikaze ivica grešaka u Studiju za usmjeravanje/kombinovanje.
lobe-icons2,666Logotipi brendova AI/LLM koji prikazuju ikone provajdera na našoj kontrolnoj tabli.
flag-icons12,499Obezbjeđuje SVG zastave pod MIT licencom koje koristi birač jezika u README-u.
### 🛡️ Sigurnost
Projekat⭐Kako je inspirisao OmniRoute
awesome-secure-defaults723Odabrana lista biblioteka sigurnih prema podrazumijevanim postavkama koja usmjerava naše sigurnosne izbore (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).
### 🧭 Komplementarni alati
Projekat⭐Kako je inspirisao OmniRoute
ClawRouter6,649Inspirisao je deduplikaciju zahtjeva, hitni rezervni mehanizam bez troškova, priključive strategije Auto-Combo i višejezičnu klasifikaciju namjere.
Antigravity-Manager32,785Njegovo premapiranje modela svjesno naloga, validacija putanja izvršnih datoteka i ponašanje oznaka planova uticali su na OmniRoute-ovo Antigravity okruženje za izvršavanje.
vscode-antigravity-cockpit4,852Njegov kompaktni format odbrojavanja do resetovanja kvote inspirisao je odgovarajući prikaz ograničenja provajdera u OmniRoute-u.
AionUi33,996Njegove ACP integracije inspirisale su OmniRoute-ovo automatsko otkrivanje instaliranih CLI agenata.
CodexBar22,955Identifikovao je površinu kvote za Grok Build; OmniRoute je zatim nezavisno provjerio i ispravio aktivni format komunikacije.
## 📄 Licenca MIT licenca - pogledajte [LICENSE](LICENSE) za detalje. ---
**[⬆ Nazad na vrh](#-omniroute)** · Izrađeno s ❤️ za open-source AI zajednicu. Kreirao Diego Souza · OmniRoute v3.8.54 · Node ≥22.22.2 · MIT licenca · omniroute.online