README (Bosanski)

🌐 Languages: 🇺🇸 English · 🇪🇹 am · 🇸🇦 ar · 🇦🇿 az · 🇧🇬 bg · 🇧🇩 bn · 🇨🇿 cs · 🇩🇰 da · 🇩🇪 de · 🇬🇷 el · 🇪🇸 es · 🇪🇪 et · 🇮🇷 fa · 🇫🇮 fi · 🇫🇷 fr · 🇮🇪 ga · 🇮🇳 gu · 🇳🇬 ha · 🇮🇱 he · 🇮🇳 hi · 🇭🇷 hr · 🇭🇺 hu · 🇦🇲 hy · 🇮🇩 id · 🇳🇬 ig · 🇮🇹 it · 🇯🇵 ja · 🇬🇪 ka · 🇰🇭 km · 🇮🇳 kn · 🇰🇷 ko · 🇱🇹 lt · 🇱🇻 lv · 🇮🇳 ml · 🇮🇳 mr · 🇲🇾 ms · 🇲🇹 mt · 🇲🇲 my · 🇳🇵 ne · 🇳🇱 nl · 🇳🇴 no · 🇮🇳 or · 🇮🇳 pa · 🇵🇭 phi · 🇵🇱 pl · 🇵🇹 pt · 🇧🇷 pt-BR · 🇷🇴 ro · 🇷🇺 ru · 🇱🇰 si · 🇸🇰 sk · 🇸🇮 sl · 🇷🇸 sr · 🇸🇪 sv · 🇰🇪 sw · 🇮🇳 ta · 🇮🇳 te · 🇹🇭 th · 🇹🇷 tr · 🇺🇦 uk-UA · 🇵🇰 ur · 🇺🇿 uz · 🇻🇳 vi · 🇳🇬 yo · 🇨🇳 zh-CN · 🇹🇼 zh-TW

🚀 OmniRoute — Besplatni AI pristupnik

OmniRoute — Nikada ne prestajte programirati. Svaki AI alat → 380 pružalaca usluga — više od 150 besplatnih — putem jedne krajnje tačke. Claude Code, Codex, Cursor, Cline, Copilot i Antigravity povezuju se s BESPLATNIM modelima Claude / GPT / Gemini uz automatsko prebacivanje na rezervnu opciju. Kombinovana RTK + Caveman kompresija štedi 15–95% tokena (prosječno ~89%) — nikada ne dosegnite ograničenja. 380 AI pružalaca usluga · više od 150 besplatnih nivoa · ~1,62 milijarde besplatnih tokena mjesečno · 20 strategija usmjeravanja · početak uz trošak od $0.

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

Koristite vlastite račune kod pružalaca usluga. Ovo je procijenjeni zbir zasebno dostupnih besplatnih nivoa trećih strana, a ne dodjela tokena od OmniRoutea. Registrujte se, pribavite pristupne podatke gdje su potrebni i povežite pružaoce usluga koje možete koristiti; svaki pružalac kontroliše svoja ograničenja, dostupnost i uslove.

Ručno objedinjavanje besplatnih nivoa je mukotrpno — desetine SDK-ova, desetine ograničenja brzine i nikakva predstava o tome koliko zapravo imate. OmniRoute katalogizira 484 stavku besplatnih nivoa raspoređenu u 34 ključa periodičnih skupova i izračunava istaknuti broj tokena na osnovu 17 skupova s objavljenim pozitivnim mjesečnim budžetom i pet Groq ograničenja po modelu, uz uklanjanje duplikata prema zajedničkom skupu. Kvote koje postaju dostupne tek nakon regionalne provjere identiteta (trenutno: ModelScope) prikazane su zasebno, +~6M iza regionalne provjere identiteta, i nikada se ne uračunavaju u istaknuti broj. Rezultat ostaje vidljiv na kontrolnoj ploči (/dashboard/free-tiers).

Animirani sažetak aktivne stranice /dashboard/free-tiers. Potpuna metodologija (uklanjanje duplikata skupova, nivoi kredita, uslovi pružalaca): docs/reference/FREE_TIERS.md.

_{Ove brojke se ponovo provjeravaju svake dvije sedmice prema aktivnom katalogu i mijenjaju se u oba smjera — ako pružalac ukine besplatni nivo, broj se smanjuje; ako se pojavi novi, broj raste. Objavljujemo ono što katalog zaista izračuna, nikada zaokruženi najbolji mogući slučaj.}

⭐ Označite repozitorij zvjezdicom ako vam je OMNIROUTE pomogao uštedjeti novac i olakšati rad.

💬 Pridružite se zajednici

👋 Pratite održavaoca — prvi saznajte za nove pružaoce, izdanja i savjete:

Pitanja, savjeti o pružaocima, plan razvoja i podrška → Discord · Telegram · WhatsApp 🌍 Globalno / 🇧🇷 Brazil / Portal

📈 Gateway nastavlja da raste

	v3.8.50	v3.8.51	`v3.8.53+`
🌐 Providers	352	358	380
🧠 Jedinstveni model chata IDs	1320	1374	1475
🖼️ Modality Bridge	🆕 vision + audio + video	✓	✓
📡 Radar besplatni katalog	🆕 opt-in	✓	✓
⚖️ Zakazivanje s obzirom na kvote	🆕 Quota-Share	✓	✓
📊 Quota telemetrija	🆕 live	✓	✓
🧰 Režim bez glave	—	—	🆕 `serve --headless`
🛤️ LTS rail infra	—	—	kanali za oslobađanje 🆕
🔎 Otkrivanje modela API	—	—	🆕 `/v1/models/query`

→ Mapa puta — vožnja prugom do v3.9.0 LTS

🧩 Dostupno

🚀 Početak	🚀 Brzi početak	📦 Instalacija	🆓 Povežite pružaoca usluge
💡 Saznajte više	💥 Obećanje	🤔 Zašto OmniRoute	🏆 Po čemu se izdvaja
⚙️ Funkcije	🎯 Kombinacije	🌐 Pružaoci usluga	🔌 CLI i MCP
	🗜️ Kompresija	🖥️ Gdje se pokreće	🔒 Privatno
👀 Pogledajte	🎬 Na djelu	✨ Šta je novo	🤖 Kompatibilni CLI-jevi
💚 Podrška	💚 Podrška / Donacije	💬 Zajednica	💖 Sponzori
📦 Projekat	🛠️ Tehnološki skup	📖 Dokumentacija	👥 Doprinositelji

🌐 Na 67 jezika

🆓 Instalirajte, povežite pružatelja usluga, a zatim usmjeravajte putem jedne krajnje tačke

# Nakon povezivanja pružatelja usluga, kopirajte svoj OmniRoute ključ iz Kontrolna ploča → Krajnje tač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!"}]}'

_{Za auto je potrebna podržana ruta. Svježa instalacija možda nema nijedno podržano odredište bez ključa, a pružatelj usluga bez ključa može odbiti klijente trećih strana. Pružatelji usluga označeni sa tos: avoid, uključujući Kiro, podrazumijevano su isključeni iz automatskog usmjeravanja; povezivanje računa ne mijenja tu postavku. Prije odabira pružatelja usluga pogledajte Vodič za besplatne nivoe.}

_{📦 Skripte za brzi početak koje možete kopirati i zalijepiti za Python, Node.js, PHP i cURL → examples/quickstart/}

💥 Obećanje

🤔 Zašto OmniRoute?

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, automatski prekidači, TLS prikrivanje, MCP, A2A, zaštitni mehanizmi) može izvršiti rezervni prelazak kroz 4 nivoa pružatelja usluga sve dok postoji podržano i ispravno odredište — Nivo 1 Pretplata, Nivo 2 API ključ, Nivo 3 Jeftino i Nivo 4 Besplatno.

🤝 Uz podršku naših prijatelja otvorenog koda

Ž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

Kimi
_{Moonshot AI} 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
_{cheaperinference.com} 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.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

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 modela	Za š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.}

🧱 Otpornost je ugrađena (3 nezavisna sloja)

_{📖 Auto-Combo mehanizam · Vodič za otpornost}

🏆 Po čemu se OmniRoute izdvaja

_{📊 Potpuna metodologija i detalji po funkcionalnostima u poređenju sa 9router, OpenRouter, CLIProxyAPI i LiteLLM → 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 repozitoriju	Besplatno — zaista pomaže vidljivosti	Dodajte zvjezdicu projektu OmniRoute
🐙 GitHub Sponsors	Jednokratno ili mjesečno · bez platformske naknade	github.com/sponsors/diegosouzapw
☕ Ko-fi	Brza jednokratna donacija, bez registracije donatora	ko-fi.com/diegosouzapw
🧋 Buy Me a Coffee	Mala, neformalna gesta	buymeacoffee.com/diegosouzapw
🖐 Liberapay	Periodično · neprofitno · otvorenog koda	liberapay.com/diegosouzapw
🇧🇷 PIX (Brazil)	Trenutno, bez naknada	ključ i QR kod ispod
₿ Kriptovalute	BTC · ETH · USDT-TRC20 · USDC-Solana	adrese ispod

🇧🇷 PIX — trenutno, bez naknada (Brazil)

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 grešku ili imate povratne informacije? Otvorite diskusiju.

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.

✨ Šta je novo

Nedavni istaknuti detalji od v3.8.20 → v3.8.53. Kompletna historija u CHANGELOG.md.

⚖️ quota-weighted rutiranje — 20. combo strategija preskače iscrpljene račune, zatim bira među ostalima srazmjerno preostaloj kvoti ÷ trenutnom opterećenju, zadržavajući postojeće razgovore fiksiranim. → Auto-Combo
🧰 Bezglavi režim — omniroute serve --headless (ili OMNIROUTE_HEADLESS=1) pokreće samo /v1/* proxy engine, s isključenim dashboardom i podsistemima samo za dashboard. → Headless Mode
🔎 Otkrivanje modela — /v1/models filtrira po mogućnostima, kontekstu, vrsti i tekstu, a POST /v1/models/query vraća kratku determinističku užu listu s istom vidljivošću po ključu. → API Reference
🔑 Kontrola rutiranja po ključu — fiksirajte API ključ na jedan model ili combo pomoću forcedModel, i atomski dodajte ili uklonite modele i comboe za ključ (/api/keys/{id}/access). → API Reference · OpenAPI
🛡️ Finije PII kontrole — odabir po vrsti, do 20 validiranih prilagođenih obrazaca maskiranja i brojači detekcije po vrsti; samo maskiranje ostaje opt-in. → Guardrails
🌍 67 jezika — dashboard, dokumentacijski mirrori i CLI, s npm run i18n:add-locale koji dodaje jezik svuda jednom komandom. → i18n Guide
🎛️ OmniConductor — dolazna A2A delegacija na vašu flotu agenata, Conductor vještine na Agent Card, i dashboard panel sa Faro push-to-talk glasovnim chatom. → A2A Server
🛂 Adaptivno prihvatanje i zaštita od preopterećenja — zahtjevi za teškim chatom se stavljaju u red umjesto da vraćaju 503, s atomskim RPM rolling lease-ovima po konekciji. → Resilience Guide
🗂️ Kanonsko uređenje /v1/models — jedan neprekinuti blok grupisan po provajderu za svakog provajdera (comboi fiksirani prvi), stabilno kroz svaki izvor kataloga. → API Reference
🗜️ Jačanje kompresije — podrazumijevano uključena zaštita od inflacije, Caveman paketi za DE / FR / JA + kineski (wényán), RTK filteri za Gradle i .NET. → Compression
💸 Iskreni trošak fiksne stope — provajderi pretplata / coding planova prikazuju $0 u analitici troškova; budžet, kvota i rutiranje nastavljaju da procjenjuju. → API Reference
⚖️ Quota-Share rutiranje — pravedno podijelite kvotu dijeljenog računa po ključevima u bazenu, work-conserving tako da se neaktivni dijelovi posuđuju. → Resilience Guide
🤖 Postavljanje CLI/agenta jednom komandom — 15 registrovanih setup-* komandi; omniroute run pokreće 7 CLI-jeva (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); omniroute configure podržava 11 ciljeva s interaktivnim biračem provajdera+modela i omiljenim stavkama po kontekstu. → CLI Integrations
🛰️ Daljinski režim — upravljajte daljinskim OmniRoute-om s ograničenim tokenima (connect / contexts / tokens) + antigravity OAuth pomoćnik za VPS instalacije. → Remote Mode
🧭 Pametnije automatsko rutiranje — auto/<category>:<tier> comboi, Fusion (model panel + sudija), rutiranje svjesno zadatka, po zahtjevu nadjačavanja modela / režima / USD budžeta. → Auto-Combo
🗜️ Priključiva kompresija — 12 kompozabilnih engine-ova + Compression Studios: LLMLingua-2, dvoslojni Ultra, omniglyph, fidelity gate po koraku, GCF v3.2, editor za prevlačenje i promjenu reda. → Compression
🕵️ Transparentno MITM dešifrovanje (TPROXY) — hvatanje CLI-jeva koji ignorišu proxy env varijable, s CA po SNI-ju + instalaterom trust store-a. → MITM/TPROXY
💸 Telemetrija troškova svuda — X-OmniRoute-* zaglavlja troškova/korištenja na svakom endpointu, zaglavlje uštede kod cache-HIT-a, kvote potrošnje u USD po ključu. → API Reference
🧠 Memorija koju kontrolišete — isključena po defaultu, opt-in int8 vektorska kvantizacija + tipizirano opadanje, x-omniroute-no-memory po zahtjevu. → Memory
🛡️ Sigurnost — zaštita od prompt-injection na svakoj LLM ruti (red-team suite), opt-in guardrail za maskiranje kredencijala (rediguje procurele API ključeve/sekretе u oba smjera), besplatna DuckDuckGo web pretraga kao krajnja opcija, i opcionalna OIDC prijava za dashboard (prijava lozinkom uvijek ostaje dostupna). → Guardrails
🖼️ Novi endpointi — /v1/ocr (Mistral OCR) i /v1/audio/translations (Whisper-style) zaokružuju medijsku površinu. → API Reference
🎨 Generisanje slika / videa / zvuka — jedan API za medije: xAI Grok Imagine i Novita AI video, ComfyUI, Magnific, Adobe Firefly, Segmind, i provajderi govora kao što je ElevenLabs. → API Reference
🌍 Implementacija i operacije — reverse-proxy basePath, automatska detekcija jezika preglednika, praćenje uređaja po ključu, root-less MITM trust, zh-TW lokalizacija. → Environment
🤝 Više provajdera i agenata — cloud agenti (Codex Cloud, Cursor, Devin, Jules), Grok Build (xAI) s browser + OAuth prijavom, Ollama kao prvoklasna kartica, Claude Opus 5 i Sonnet 5, Kimi službeno partnerstvo (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… i osvježen katalog od 380 provajdera. → Providers
📡 Transparentnost rutiranja — svaki odgovor nosi X-OmniRoute-Decision zaglavlje koje navodi strategiju/provajdera/latenciju koji su ga poslužili, nova cache-optimized combo strategija + Auto-Combo cacheAffinity faktor vraćaju ponovljene zahtjeve nazad na konekciju koja drži keširani prefiks, a read-only endpoint /v1/auto-combo/{channel}/candidates izlaže trenutni bazen kandidata auto/* kanala. → Auto-Combo
⚡ Lokalne performanse i infrastruktura — lokalni Redis jednim klikom, alati za postavljanje Cloudflare Workers / Deno Deploy relay-a, Bifrost i Mux kao nadzirane ugrađene usluge. → Ugrađene usluge
🧩 Također u paketu — okvir za plugine + marketplace, Omni/Agent/GitHub okviri za vještine, integracija Obsidian vault-a (22 MCP alata), OpenAI-kompatibilni Batch & Files API-ji, semantički keš odgovora, gamifikacija s rang listama, otkrivanje ACP agenata (15 ugrađenih agenata), zakazani izvoz logova u BigQuery, auto/chaos paralelno razgranavanje na više modela, most za Telegram bot, menadžer verzija unutar aplikacije i LMArena-ELO rangiranja besplatnih provajdera. → Dokumentacija

🤖 Kompatibilni CLIs i agenti za kodiranje

Jedna konfiguracija — http://localhost:20128/v1 — i** svaki** AI IDE ili CLI radi na besplatnim i jeftinim modelima.

_{Claude Code}	_{Codex CLI}	_Cline	_{Kilo kod}	_{Zoo Code}	_Nastavi
_Aider	_ForgeCode	_jcode	_{DeepSeek TUI}	_CodeWhale	_OpenCode
_{Factory Droid}	_{Copilot CLI}	_{Cursor CLI}	_Smelt	_Pi	_{Grok Build}
_{Hermes Agent}	_OpenClaw	_guska	_{Open Interpreter}	_{Warp AI}	_deyin.ai

＋ također radi sa · Agent Deck · Kiro · Command Code · Antigravity · Windsurf · AMP · bilo koji OpenAI kompatibilan alat

_{📖 Postavljanje po alatu za svih 38 alata (27 CLI kodova + 11 CLI agenata) → docs/reference/CLI-TOOLS.md · 🧩 OpenCode → @omniroute/opencode-provider}

Pokrenite bilo koju podržanu CLI kroz OmniRoute jednom komandom — nema napisanih konfiguracijskih datoteka, akreditivi se ubacuju po procesu, Qwen/Gemini dobija izolovani dom za bacanje:

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"

# Or pick provider+model interactively and write the tool's own config:
omniroute configure codex          # also: claude opencode qwen aider goose gemini cline continue kilo 5dive

Svaka naredba poštuje aktivni udaljeni kontekst (omniroute connect <host>), --dry-run pregledava tačan env/args bez izvršavanja, a --api-key-env NAME čuva tajne izvan vaše povijesti ljuske. → CLI Integracije

🌐 380 AI pružalaca usluga — 153 označena u katalogu kao besplatna

380 registriranih pružalaca usluga u kanonskim kolekcijama za chat, medije, pretraživanje, lokalne modele, agente u oblaku i sistem, uključujući 153 s metapodacima za otkrivanje hasFree: true. Registar chat modela obuhvata 239 pružalaca usluga / 3.059 različitih parova pružalac-model / 1.475 sirovih ID-ova modela; zasebni katalog besplatnih kvota sadrži 471 red po modelu, 34 periodično obnavljana skupa i 52 pružaoca usluga s trajno besplatnim pristupom koji se periodično obnavlja ili ne zahtijeva ključ. Ovo su namjerno različiti nazivnici; definicije i izračuni s uklonjenim duplikatima skupova nalaze se u dokumentima Referenca pružalaca usluga i Besplatni paketi.

🏢 Svaka velika laboratorija — putem jedne krajnje tač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 350 — svaka ikona učitava se uživo iz kataloga pružalaca usluga kontrolne ploče. 📖 Referenca pružalaca usluga}

🆓 Zauvijek besplatno — $0, bez kartice

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

📖 Potpuni mašinski čitljiv katalog → 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č · Radna površina · Traka menija · Termux · PWA · OpenCode}

🧩 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 uCopilot 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** 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.

_{📖 VS Code Copilot Vodič za ćaskanje — 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** 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 (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

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

_{📖 Autorizacija · Zaštitne mjere · Usklađenost}

🔌 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`)

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.

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}

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.

Interfejs	Krajnja tačka / komanda	Koristite 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 opsega (primjena po izboru), potpuni revizijski trag
📡 MCP (SSE)	`/api/mcp/sse`	MCP prijenos kontinuiranim tokom
🤝 A2A	`/.well-known/agent.json`	Komunikacija 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 CLI	`omniroute connect`	Upravljajte udaljenom instancom pomoću pristupnih tokena ograničenog opsega

# 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 · A2A server · Protokoli za agente}

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

📖 Kako funkcioniše — pipeline, arhitektura i matematika uštede

Podrazumijevana složena kombinacija pokreće RTK → Caveman. Kada oba djeluju na isti tool/context payload, uštede se sabiraju:

combined = 1 − (1 − RTK) × (1 − Caveman_input)
average  = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range    = 78.4 – 94.6%

Kodni blokovi, URL-ovi, JSON i strukturirani podaci su uvijek zaštićeni pomoću engine-a za očuvanje.

Zašto koristiti mnogo tokena kada mali broj tokena radi posao? Svaki zahtjev prolazi kroz OmniRoute kompresijski pipeline transparentno — bez izmjena na klijentu. To je sada skup od 12 kompozabilnih engine-a koji se izvršavaju po redu i kombinuju po routing kombinaciji — nadograđujući ideje iz RTK, Caveman (⭐ 90K+), LLMLingua-2 i Troglodita (PT-BR).

🧱 Stack od 12 engine-a

Engine-i se izvršavaju po redoslijedu pipeline-a; svaki se može nezavisno uključiti/isključiti i konfigurisati po kombinaciji:

#	Engine	Šta radi
1	Session-Dedup	Uklanja sadržaj koji se ponavlja kroz turnove (content-addressed, cross-turn)
2	CCR	Arhivira velike blokove iza retrieve markera, dohvaća se na zahtjev
3	Lite	Trimming whitespace + image-URL (lagana osnova za latenciju)
4	RTK	Pametno filtriranje tool-rezultata, dedup i skraćivanje (svjesno komandi)
5	Responses Tool Output	Lossless-first JSON + ograničena dijagnostička kompresija za shell/patch/search/build izlaze (Responses API)
6	Headroom	Lossless tabelarna kompakcija JSON nizova (~30%) putem vendored GCF codec-a
7	Relevance	Ekstraktivno bodovanje rečenica u odnosu na posljednji korisnički upit
8	Caveman	Rule-based kompresija proze (~65–75% na izlazu)
9	Aggressive	Sažimanje + progresivno starenje starih turnova
10	LLMLingua-2	ML semantičko obrezivanje putem MobileBERT ONNX — sigurno za kod, async
11	Ultra	Heurističko obrezivanje tokena uz opcionalni sloj malog modela (SLM)
12	OmniGlyph	Eksperimentalno kodiranje konteksta kao slike za izmjereni Claude Fable 5 na direktnom Anthropic wire-u; GPT 5.6 transformeri ostaju fail-closed do potvrda od provajdera. Četiri kompresijska profila (aggressive default, balanced, coding-safe, passthrough) (najagresivnije; opt-in)

Kodni blokovi, URL-ovi i strukturirani podaci su uvijek očuvani byte-perfect. Preseti jednim klikom kombinuju engine-e:

Režim	Ušteda	Najbolje za
🪶 Lite	~15%	Uvijek uključen siguran default
🪨 Standard (Caveman)	~30%	Svakodnevno kodiranje
⚡ Aggressive	~50%	Duge sesije sa puno tool poziva
🔥 Ultra	~75%	Maksimalna ušteda
🧰 RTK	60–90%	Shell/test/build/git izlaz
🔗 Stacked (RTK → Caveman)	78–95%	Mješoviti promptovi + tool logovi

Stvarni primjer — Standard režim:

Prije (69 tokena): "Razlog zašto se vaša React komponenta ponovo renderuje je vjerovatno taj što stvarate novu referencu objekta u svakom ciklusu renderovanja. Kada proslijedite inline objekat kao prop, React-ovo plitko poređenje ga vidi kao drugačiji objekat svaki put, što pokreće ponovno renderovanje. Preporučio bih korištenje useMemo za memoizaciju objekta."

Poslije (19 tokena): "Nova object ref svaki render. Inline object prop = nova ref = re-render. Umotaj u useMemo."

Isti odgovor. 72% manje tokena. Nula gubitka tačnosti. ✅

PT-BR primjer — Troglodita režim:

Prije (42 tokena): "Problem je što se komponenta ponovo renderuje jer se nova referenca objekta kreira u svakom ciklusu renderovanja. Preporučio bih korištenje useMemo."

Poslije (12 tokena): "Ponovno renderovanje: nova referenca svaki ciklus (inline objekat se ponovo kreira). Koristiti useMemo."

Isti odgovor. ~70% manje tokena. Tehnička preciznost netaknuta. ✅

🎚️ Iza pogona — stilovi izlaza, adaptivni točkić i kontrola po zahtjevu

Gore navedenih 12 pogona smanjuje ono što ulazi. Još tri sloja oblikuju kako, kada i šta izlazi:

🪄 Stilovi izlaza (usmjeravanje na osi izlaza) — ubacuju determinističke, cache-safe instrukcije za oblikovanje odgovora; mogu se kombinovati, svaki na intenzitetu lite / full / ultra. Dodavanje stila je unos od jedne linije u registar:
- Sažeta proza — izbacite ispunu / članove / ograđivanje; zadržite tehničku suštinu tačnom.
- Manje koda — "lijeni senior dev" YAGNI: najmanja promjena koja radi, bez nezahtijevane skele.
- Ponytail (lijeni senior dev) — penjite se YAGNI ljestvicom, popravite osnovni uzrok, najmanji diff koji radi.
- Imam ADHD (akcija prvo) — sljedeća akcija je na čelu, koraci numerisani, jedan konkretan sljedeći korak, bez uvoda.
- Sažeti CJK (文言) — ultra-sažeti stil klasičnog kineskog (ograničeno na locale zh).
🎯 Adaptivni budžet konteksta (točkić) — umjesto jednog uključi/isključi token praga, eskalirajte najjeftinije, najbezgubitnije pogone samo koliko je potrebno da se uklopi u modelov kontekstni prozor. Politika: reserve-output (podrazumijevano, svjesno modela) · percentage · absolute. Režim: floor (garantuje uklapanje) · replace-autotrigger (vaš eksplicitni izbor pobjeđuje) · off (naslijeđeni prag).
🎛️ Gdje se odlučuje o kompresiji (prioritet, visok → nizak) — zaglavlje x-omniroute-compression po zahtjevu › nadjačavanje routing-kombinacije › aktivni imenovani profil › adaptivno / automatsko pokretanje › zadano u panelu › isključeno. Primijenjeni plan se vraća u zaglavlju odgovora X-OmniRoute-Compression: <mode>; source=<source>.

Automatsko pokretanje po token pragu, uključite adaptivni točkić, prikvačite imenovani profil, postavite jednokratno po zahtjevu ili dodijelite pipeline po routing-kombinaciji — šta god odgovara radnom opterećenju. Opcionalni offline eval harness (npm run eval:compression) ocjenjuje vjernost vs. uštede na prikvačenom korpusu prije nego što promovirate promjenu.

📖 COMPRESSION_GUIDE.md · RTK_COMPRESSION.md · COMPRESSION_ENGINES.md

⚡ Brzi početak

1) Instalirajte i pokrenite

npm install -g omniroute
omniroute

💡 Vidite npm warn ERESOLVE ili upozorenja o peer zavisnostima? Bezopasna su. Koristite npm 11 ili noviji? npm može blokirati lifecycle skripte paketa osim ako nisu dozvoljene. OmniRouteov postinstall (node scripts/build/postinstall.mjs) je neophodan za pripremu njegovih izvornih runtime datoteka. Dozvolite pakete navedene u npm upozorenju pri globalnoj instalaciji. Za skup paketa koji prijavljuje OmniRoute 3.8.53:
npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute
Da ponovo koristite ovu listu dozvola za buduće globalne instalacije, konfigurišite je jednom, a zatim instalirajte normalno:
npm config set allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild --location=user
npm install -g omniroute
Lista zavisnosti se može mijenjati između izdanja; ako npm prijavi drugačiju listu, koristite imena paketa iz tog upozorenja. Dozvoljavanje paketa omogućava pokretanje njegovih instalacijskih skripti. Koristite Gemini Web ili drugog web-cookie provajdera? npm paket uključuje Playwright, ali ne i njegov Chromium binarni fajl. Pogledajte napomenu o Playwright Chromium postavci prije prvog zahtjeva ka web provajderu.

Dashboard na http://localhost:20128 · API na http://localhost:20128/v1.

2) Povežite podobnog provajdera koristeći vlastiti račun

Dashboard → Providers → odaberite provajdera čiji trenutni uslovi i kvota odgovaraju vašem slučaju upotrebe → dodajte njegov API ključ ili završite tok povezivanja računa. Besplatni nivoi mogu zahtijevati registraciju, odobrenje ili način plaćanja. Pogledajte Vodič kroz besplatne nivoe; dostupnost bez ključa nije zagarantovana, a provajderi označeni sa tos: avoid su podrazumijevano isključeni iz auto.

3) Usmjerite svoj alat za kodiranje

Base URL: http://localhost:20128/v1
API Key:  [kopirajte sa Dashboard → Endpoints]
Model:    auto            (usmjerava među podobnim vezama — ili odaberite provider/model)

4) Provjerite da radi

curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY"

Trebali biste vidjeti svoje povezane modele na listi. 🎉 To je sve — počnite kodirati, a OmniRoute automatski usmjerava i pravi fallback za vas.

Ako vaš klijent ne može slati prilagođena zaglavlja, OmniRoute također izlaže tokenizovane aliasе za kompatibilnost:

OpenAI katalog:   http://localhost:20128/vscode/YOUR_KEY/
OpenAI modeli:    http://localhost:20128/vscode/YOUR_KEY/models
OpenAI chat:      http://localhost:20128/vscode/YOUR_KEY/chat/completions
OpenAI odgovori:  http://localhost:20128/vscode/YOUR_KEY/responses
Ollama chat:      http://localhost:20128/vscode/YOUR_KEY/api/chat
Ollama tagovi:    http://localhost:20128/vscode/YOUR_KEY/api/tags

Koristite ih samo za klijente koji ne mogu priložiti Authorization: Bearer .... Autentifikacija putem zaglavlja ostaje preferirani način.

📦 Više načina instalacije — Docker, izvorni kod, pnpm, Arch

🐳 Docker

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. 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

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.

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.

🥟 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 .).

# Instalirajte i pokrenite pomoću Buna
bun install
bun run dev

🛠️ Iz izvornog koda

cp .env.example .env && npm install
PORT=20128 npm run dev

📦 pnpm

pnpm add -g omniroute@latest --allow-build=better-sqlite3 --allow-build=@swc/core && omniroute

🐧 Arch Linux (AUR)

yay -S omniroute-bin && systemctl --user enable --now omniroute.service

🔧 Nix (Flake)

# Korištenje Nix flakesa
nix develop
npm run dev

# Ili korištenje devboxa
devbox run npm run dev

📖 Docker vodič — Compose profili, Caddy HTTPS, Cloudflare tuneli.

🦭 Podman

# 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.

📖 Podman vodič — 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:

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č. 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}

🎬 #1 — Instagram
_{nick_saraev — 3,042,474 pregleda}

🎬 #2 — Instagram
_{nnapier7 — 1,454,535 pregleda}

🎬 #3 — YouTube
_{Amidia AI & Tech — 794,974 pregleda}

🎬 #4 — Instagram
_{theopenstack — 692,419 pregleda}

🎬 #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 — 3,042,474	nnapier7 — Instagram — 1,454,535	Amidia AI & Tech — YouTube — 794,974	theopenstack — Instagram — 692,419	migue.baena — TikTok — 685,788

#6	#7	#8	#9	#10
milesreevesai — TikTok — 620,400	nikothetech — TikTok — 610,803	Vaibhav Sisinty — YouTube — 509,281	buildwithai.club — Instagram — 347,652	nivedan.ai — Instagram — 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 ili diskusiju 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
🐙 GitHub — pratite izdanja i savjete	@diegosouzapw
💬 Discord	discord.gg/U47eFqAXCn
✈️ Telegram	t.me/omnirouteOficial
🟢 WhatsApp — 🌍 Globalno	pridružite se grupi
🟢 WhatsApp — 🇧🇷 Brazil	pridružite se grupi
🌍 Web-stranica	omniroute.online
🌍 🌍StHub OmniRoute zajednica (besplatno)	StHub portal
📦 Izvorni kod	github.com/diegosouzapw/OmniRoute
🐛 Prijavite grešku	otvorite prijavu — priložite izlaz naredbe `npm run system-info`
🤝 Doprinesite	CONTRIBUTING.md · Model grananja i izdanja · odaberite `good first issue`
💚 Podržite projekat	Načini podrške ↑ · GitHub Sponsors

🛠️ Tehnološki stack

Sloj	Tehnologija
Okruženje	Node.js 22.x / 24.x LTS — `>=22.22.2 <23 \|\| >=24.0.0 <27`
Jezik	TypeScript 6.0 — 100% TypeScript kroz `src/` i `open-sse/` (nula `any` u jezgru od v2.0)
Framework	Next.js 16 + React 19 + Tailwind CSS 4
Baza podataka	better-sqlite3 (SQLite, WAL journaling) + LowDB (JSON legacy) — 147 domenskih modula, 219 migracija
Memorija	SQLite FTS5 full-text + int8-kvantizovani vektorski embeddings, tipizirano opadanje
Šeme	Zod 4 — MCP validacija ulaza/izlaza alata + API ugovori
Protokoli	MCP (stdio / HTTP / SSE) + A2A v0.3 (JSON-RPC 2.0 + SSE)
Streaming	Server-Sent Events (SSE) + WebSocket most (`/v1/ws`)
Kompresija	Pipeline od 12 mehanizama — RTK, Caveman, LLMLingua-2 (MobileBERT ONNX), GCF, OmniGlyph
Autentifikacija i sigurnost	OAuth 2.0 (PKCE) + JWT + API ključevi + MCP scoped auth · AES-256-GCM u mirovanju · DOMPurify
Stealth	wreq-js — JA3 / JA4 TLS fingerprint impersonacija, proxy na 3 nivoa
Otpornost	Circuit breaker, eksponencijalni backoff, anti-thundering-herd, auto-combo samoizlječenje
Logovanje	pino — strukturirani JSON logovi s kontekstom zahtjeva
Testiranje	Node.js test runner + Vitest — 56.000+ statičkih test deklaracija kroz 7.800+ praćenih test fajlova (unit, integracijski, E2E, sigurnosni, ekosistem)
Platforme	Desktop (Electron) · Android (Termux) · PWA (bilo koji preglednik)
CI/CD	GitHub Actions — automatsko npm objavljivanje + Docker Hub pri izdanju
Linkovi	Web stranica · npm · Docker Hub

📖 Dokumentacija

📘 Početak rada

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

🔧 Operacije i implementacija

Dokument	Opis
Vodič za Docker	Docker pokretanje, Compose profili, Caddy HTTPS, tuneli, oznake slika
Vodič za Podman	Quadlet systemd integracija, podman-compose, SELinux
Implementacija na VM-u	Potpuni vodič: postavljanje VM-a, nginx-a i Cloudflarea
Implementacija na Fly.io	Implementacija na Fly.io s trajnom pohranom
Vodič za Termux	Pokrenite OmniRoute na Androidu putem Termuxa
Vodič za PWA	Instalacija progresivne web-aplikacije, keširanje, arhitektura
Vodič za deinstalaciju	Čisto uklanjanje za sve metode instalacije
Konfiguracija okruženja	Kompletne varijable datoteke `.env` i reference

🧠 Funkcionalnosti i arhitektura

Dokument	Opis
Arhitektura	Arhitektura sistema, tok podataka i unutrašnji mehanizmi
Vodič za kompresiju	Proces sa 7 opcija: isključeno / lagano / standardno / agresivno / ultra / RTK / složeno
RTK kompresija	Kompresija izlaza naredbi, filteri, pouzdanost, provjera, oporavak neobrađenog izlaza
Mehanizmi kompresije	Caveman, RTK, složeni procesi, površine nadzorne ploče/API-ja/MCP-a
Format pravila kompresije	Sheme JSON paketa pravila za Caveman i RTK filtere
Jezički paketi za kompresiju	Prepoznavanje jezika i izrada Caveman paketa pravila
Vodič za otpornost	Prekidači strujnog kruga, periodi hlađenja, red čekanja, sprečavanje stampeda zahtjeva, TLS lažiranje
Auto-Combo mehanizam	Bodovanje na osnovu 16 faktora, paketi načina rada, samooporavak
Vodič za proxy	Proxy sistem s 3 nivoa, 1proxy tržište, CRUD registra
Besplatni nivoi	Objedinjeni direktorij: 34 dokumentovana ponavljajuća skupa / 484 katalogizirani unos besplatnog nivoa
Galerija funkcionalnosti	Vizuelni obilazak nadzorne ploče sa snimcima ekrana
Dokumentacija baze koda	Pregled baze koda prilagođen početnicima

🤖 Protokoli i API-ji

Dokument	Opis
API referenca	Sve krajnje tačke s primjerima
OpenAPI specifikacija	OpenAPI 3.0 specifikacija
MCP server	110 MCP alata, IDE konfiguracije, Python/TS/Go klijenti
Vodič za MCP server	MCP instalacija, transporti i referenca alata
A2A server	JSON-RPC 2.0 protokol, vještine, prijenos podataka, upravljanje zadacima
Vodič za A2A server	A2A kartica agenta, zadaci, vještine i prijenos podataka

📋 Projekt i kvalitet

Dokument	Opis
Doprinošenje	Postavljanje razvojnog okruženja i smjernice
Model grananja i izdanja	Na koje su grane usmjereni PR-ovi (`release/*`) te šta znače `main` i oznake
Dnevnik izmjena	Potpuna historija izdanja po verzijama
Sigurnosna politika	Prijavljivanje ranjivosti i sigurnosne prakse
Vodič za i18n	Podrška za 67 jezika, tok rada prevođenja, RTL
Kontrolna lista za izdavanje	Koraci provjere prije izdavanja
Plan pokrivenosti	Strategija pokrivenosti testovima za više od 56,000 statičkih deklaracija testova u više od 7,800 praćenih testnih datoteka

⭐ Najistaknutiji doprinositelji

OmniRoute oblikuje predana zajednica otvorenog koda. Ovi pojedinci dali su izuzetne doprinose koji direktno utječu na kvalitet, stabilnost i doseg projekta. Hvala vam.

Vanjski doprinositelji prema broju spojenih zahtjeva za izmjene

Rang	Doprinositelj	Spojeni PR-ovi	~Izmijenjenih linija
1	maxmad64bis	371	25,326,561
2	HouMinXi	269	13,456,272
3	backryun	210	270,562
4	oyi77	190	411,243
5	pacocartones	174	78,276
6	JxnLexn	151	3,562,936
6	KooshaPari	151	5,972,314
8	rdself	145	80,663
9	RaviTharuma	123	500,065
10	herjarsa	88	230,872
11	hartmark	84	2,849,554
12	jonlwheat2-gif	67	68,548
13	artickc	62	43,502
14	chirag127	52	6,661
15	xz-dev	50	245,976
16	xiaoyaner0201	47	33,626
17	woodsonl	46	809,391
18	rqzbeh	44	147,896
19	QuangBlue	43	13,112
20	MumuTW	40	26,093

_{Popis je napravljen 2026-10-18 15:09:09 UTC na osnovu trenutnog vrha grane release/v3.8.52, 656f01cb43. Straničeni GitHub GraphQL popis sadrži 9,191 spojeni PR: 3,834 od vlasnika repozitorija, 229 od Dependabota, 6 od drugih botova/aplikacija i 5,122 vanjska PR-a od 835 različitih doprinositelja. „Izmijenjene linije” predstavljaju zbir dodavanja i brisanja na GitHubu te uključuju generirane datoteke, datoteke zaključavanja, kataloge, prijevode i dokumentaciju; to je obim izmjena, a ne broj napisanih linija koda. Za 49 PR-ova GitHub navodi razlike veće od 500,000 linija (naprimjer, #13399, dodavanje jednog pružatelja usluga, navodi 2,347 izmijenjenih datoteka), što povećava nekoliko prethodno navedenih ukupnih vrijednosti. Jednaki rezultati dijele isti rang.}

Commitovi pripisani na GitHubu

Dizzle _{🥇 367 commitova pripisanih GitHubu}	Bob.Hou _{🥈 269 commitova pripisanih GitHubu}	Paijo _{🥉 229 commitova pripisanih GitHubu}	backryun _{🏅 202 commita pripisana GitHubu}	Paco Cartones _{🏅 174 commita pripisana GitHubu}	Ravi Tharuma _{🏅 126 commitova pripisanih GitHubu}
Markus Hartung _{🏅 114 commitova pripisanih GitHubu}	Randi _{🏅 108 commitova pripisanih GitHubu}	Jan Leon _{🏅 87 commitova pripisanih GitHubu}	Chris _{🏅 70 commitova pripisanih GitHubu}	Koosha Paridehpour _{🏅 68 commitova pripisanih GitHubu}

_{Ponovo provjereno 2026-10-18 14:44:45 UTC: commitovi pripisani GitHubu koje je prijavio API repozitorija za saradnike za zadanu granu release/v3.8.52. API je vratio 849 identiteta (429 korisnika, 2 bota, 418 anonimnih); ova tabela isključuje održavaoca, botove i anonimne identitete te zadržava izjednačene rezultate. Razlikuje se i od iznad navedenog rangiranja spojenih PR-ova i od popisa Git metapodataka u nastavku.}

🙏 Funkcionalnosti, ispravke grešaka i poboljšanja infrastrukture ovih saradnika predstavljaju ključni dio onoga što OmniRoute čini pouzdanim i bogatim funkcionalnostima. Svaki pull request, svaki testni slučaj i svaka i18n datoteka prijevoda su važni. Otvoreni kod grade 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 _{💛 Aktivni mjesečni sponzor}	Vlad I _{💛 Aktivni mjesečni sponzor}	小妍儿 _{💛 Aktivni mjesečni sponzor}	Guilherme Costa _{💛 Aktivni jednokratni sponzor}	Henrique Iurkiv _{💛 Aktivni jednokratni sponzor}	Somesh Ghaturle _{💛 Aktivni jednokratni sponzor}
Kolonie AI _{💛 Raniji jednokratni podržavalac}	Prof. Igor Morais _{💛 Raniji jednokratni podržavalac}	Pixma _{💛 Raniji jednokratni podržavalac}	Paco Cartones _{💛 Raniji jednokratni podržavalac}	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.

👥 900+ saradnika

_{Revidirano 2026-10-18 na aktuelnom vrhu grane release/v3.8.52, ad160ab2d1 (6.826 commitova): 993 normalizirana ljudska Git identiteta — 707 se pojavljuje kao autor commita (uključujući održavaoca), a 286 samo u eksplicitnim Co-authored-by završnim oznakama. Popis primjenjuje .mailmap, poredi adrese e-pošte bez obzira na velika i mala slova, spaja numeričke i obične GitHub noreply adrese samo kada kodiraju isti nadimak, isključuje 26 identiteta botova/agenata/servisa/rezerviranih oznaka i ne spaja obične adrese e-pošte samo zato što im se podudaraju prikazana imena. Revizija od 2026-08-24 objavila je broj 639; ponovna primjena ove metode na osnovu te revizije, ac02c5b42f, daje 619, tako da povećanje potiče od novih saradnika, a ne od blaže metode.}

Kako doprinijeti

Napravite fork repozitorija
Napravite granu od aktivnog vrha release/vX.Y.Z (ne od main) — pogledajte Model grananja i izdanja
Kreirajte svoju granu funkcionalnosti (git checkout -b feat/amazing-feature)
Commitujte svoje izmjene (git commit -m 'feat: add amazing feature')
Pošaljite izmjene na granu (git push origin feat/amazing-feature)
Otvorite Pull Request sa base = ta grana release/vX.Y.Z

Za detaljne smjernice pogledajte CONTRIBUTING.md.

Objavljivanje nove verzije

# Kreirajte izdanje — npm publish se izvršava automatski
VERSION=x.y.z
gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes

📊 Zvjezdice

🌍 StarMapper

🙏 Zahvale

OmniRoute stoji na ramenima divova. Nastao je kao fork projekta 9router i TypeScript port Go projekta CLIProxyAPI — a odatle je svaki podsistem naveden u nastavku inspirisan projektom otvorenog koda koji je prvi riješio taj problem. Svaki od njih oblikovao je konkretan dio OmniRoutea. Ovo je naša zahvala svima njima. 🙏

⭐ broj zvjezdica provjeren je putem GitHub REST API-ja 18. oktobra 2026. — podržite ove projekte zvjezdicom. Brojevi predstavljaju precizan snimak stanja na navedeni datum i prirodno će se mijenjati.

🧬 Porijeklo i pristupnik

Projekt	⭐	Kako je inspirisao OmniRoute
9router	31,004	Izvorni projekt na kojem je ovaj fork zasnovan — ovdje proširen multimodalnim API-jima i potpunim prepisivanjem u TypeScriptu.
CLIProxyAPI	55,591	Implementacija u jeziku Go koja je inspirisala ovaj JavaScript / TypeScript port.
LiteLLM	61,482	AI pristupnik čiji javni skup podataka o cijenama pokreće našu sinhronizaciju praćenja troškova i čiji je model normalizacije pružalaca usluga uticao na naše usmjeravanje.
codex-chatgpt-web	14,526	MIT izvorni kod prilagođen u ugrađeni most ChatGPT Web → Codex Responses, uključujući adaptere za sesije preglednika, uokviravanje odgovora, korištenje i web-pretragu.
free-claude-code	61,430	Obrasci preneseni u oporavak tokova, pseudonime bez razmišljanja, rezervnu web-pretragu, ograničenja kliznog prozora, redigovanje dnevnika i ojačane tokove pokretača.
composer-api	346	Obrasci za izbor alata, ograničenja izlaza i potvrđivanje alata iz Cursor Composera prilagođeni su izvornom Cursor izvršitelju.
codex-multi-auth	553	Obrasci nove prijave i rotacije tokena za osvježavanje preneseni su u ponovnu autentifikaciju putem Codex OAutha.
opencode-anthropic-auth	558	Zadane vrijednosti transformacije kompatibilne s Claude Codeom i ponašanje zaglavlja za naplatu generalizovani su u OmniRouteov most vođen konfiguracijom.
grok2api-merged	2	Njegova mapiranja Grok modela, Statsig generator koji oponaša TypeError, zadane vrijednosti zahtjeva i uređaja te NDJSON procesor odgovora značajno su prilagođeni za OmniRouteov Grok Web izvršitelj.
TQZHR/grok2api	706	Glavni posredni izvor koda iza projekta grok2api-merged; njegove implementacije modela, zaglavlja, korisnog sadržaja, Statsiga i procesora sačuvane su u porijeklu Grok Weba.
chenyme/grok2api	7,819	Temeljni MIT izvorni kod za Grok korisni sadržaj i zadane vrijednosti uređaja, Statsig generator i `result.response` procesor prenesen putem projekata TQZHR i grok2api-merged.
grok2api-pro	27	Posredni izvor kojem grok2api-merged pripisuje zasluge za svoj sloj skupa proxyja; OmniRoute zadržava tu napomenu o porijeklu, ali ne tvrdi da je portovao skup proxyja u svoj ograničeni Grok Web izvršitelj.
GrokProxy	51	Njegov Grok proxy autentifikovan kolačićima i obrazac strujanja `result.response.token` uticali su na OmniRouteov Grok Web transport.
GrokBridge	5	Izvorna implementacija Grok Weba koristila je njegov dizajn uzvodne HTTP/pregledničke komunikacije; njegova direktna HTTP putanja izvedena je iz GrokProxyja, pa se ne tvrdi da je izvršen nezavisan port koda.

🗜️ Kompresija konteksta i tokena — mehanizmi

Projekt	⭐	Kako je inspirisao OmniRoute
Caveman	113,396	Viralni projekt „zašto koristiti mnogo tokena kada malo tokena radi posao“ — njegova filozofija pećinskog govora pokreće naš standardni način kompresije i više od 30 pravila za uklanjanje suvišnih riječi i sažimanje.
RTK – Rust Token Killer	83,835	Kompresija izlaza naredbi visokih performansi — inspirisala je naš RTK pogon, DSL za filtriranje JSON-a, oporavak neobrađenog izlaza i složeni RTK → Caveman cjevovod.
headroom	75,741	Reverzibilna kompresija konteksta (SmartCrusher) — inspirisala je naš `headroom` pogon i obrazac markera za dohvaćanje `ccr`.
LLMLingua	6,757	Istraživanje kompresije upita (LLMLingua / LLMLingua-2) — inspirisalo je naš asinhroni, za kod siguran `llmlingua` pogon koji u slučaju greške nastavlja bez kompresije.
llmlingua-2-js	32	JS/ONNX port (MobileBERT / XLM-RoBERTa) koji se koristi kao pozadinski sistem radne niti za naš LLMLingua pogon.
Troglodita	50	Kompresija tokena za brazilski portugalski — pokreće naš jezički paket pt-BR: smanjenje pleonazama i uklanjanje suvišnih riječi prilagođeno gramatici brazilskog portugalskog.
ponytail	166,731	Viralna vještina YAGNI-programiranja „lijenog starijeg programera“ — inspirisala je naš less-code stil izlaza: usmjeravanje prema najmanjoj funkcionalnoj izmjeni koje smanjuje _generisani_ kod (pandana Cavemanovoj sažetoj prozi na osi izlaza).
i-have-adhd	57,628	Njegov stil odgovora usmjeren prvo na djelovanje i prilagođen osobama s ADHD-om prenesen je u sažeti stil izlaza OmniRoutea na pet jezika.

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

Projekt	⭐	Kako je inspirisao OmniRoute
TOON	25,509	Objektna notacija usmjerena na tokene — njen model zasnovan na kolonama, zaglavlju i redovima oblikovao je našu fazu tabelarnog sažimanja.
GCF – Graph Compact Format	59	Njegov kompaktni format grafa i dizajn generičkog profila utjecali su na OmniRouteovo tabelarno sažimanje i format Headroom kodeka.
gcf-typescript	4	MIT implementacija u TypeScriptu direktno ugrađena i proširena kao Headroom kodek generičkog profila.
token-optimizer-mcp	551	Brotli/SQLite predmemorija + razlika konteksta po sesiji — inspirisali su naš `session-dedup` pogon.
token-savior	1,182	Sažimanje Bash izlaza + MCP profili — inspirisali su našu disciplinu odustajanja od kompresije i smanjenje manifesta MCP alata.
token-saver	154	Kompresija izlaza svjesna sadržaja i prilagođena svakoj vrsti datoteke, uz odustajanje u slučaju greške — potvrdila je naše usmjeravanje prema vrsti i preskakanje kada je dobitak ispod minimuma.
token-optimizer	2,595	„Pronađite tokene duhove“ — njegov obrazac izmještanja i obnovljivih identifikatora utjecao je na naš pristup CCR izmještanju.
TokenMizer	33	Nacrt sesijskog grafa i deduplikacije redova između interakcija koji je utjecao na naš dizajn deduplikacije sesija.
OmniCompress	3	Kolonarni JSON u Rustu + dohvaćanje adresirano sadržajem + deduplikacija između poruka — potvrdili su dizajn naših pogona `headroom`/`ccr`/`session-dedup` i invarijantu stabilnu za predmemoriju „komprimirani oblik je nezavisan od položaja“.
mcp-compressor	133	Kompresija shema/opisa MCP alata — utjecala je na naše smanjenje kardinalnosti manifesta MCP alata.
RepoMapper	217	Rangiranje mape repozitorija u stilu Aidera — utjecalo je na naše istraživanje mapiranja repozitorija / rangiranja dohvaćanja.
quiet-shell-mcp	4	Deklarativno smanjenje izlaza ljuske putem MCP-a — potvrdilo je naše deklarativno sažimanje Bash izlaza.
ts-morph	6,205	Komplet alata za TypeScript Compiler API — inspirisao je naše uklanjanje komentara zasnovano na parseru, koje zadržava literale stringova, predložaka i regularnih izraza.

🧠 Memorija i RAG

Projekt	⭐	Kako je inspirisao OmniRoute
Mem0	67,385	Univerzalni memorijski sloj — njegov model proxyja kao granice za pisanje/čitanje oblikovao je našu memorijsku arhitekturu.
Letta (MemGPT)	25,179	Agenti sa stanjem i slojevitom memorijom — inspirisali su naš slojeviti model kontrole i oporavka konteksta (CCR).
WFGY	1,800	ProblemMap taksonomija 16 ponavljajućih načina otkaza RAG/LLM sistema — zajednički rječnik u našem vodiču za rješavanje problema.

🛰️ Inspekcija saobraćaja, MITM i transparentni proxy

Projekt	⭐	Kako je inspirisao OmniRoute
llm-interceptor	79	MITM presretanje/analiza saobraćaja između asistenta za programiranje ↔ LLM-a utjecali su na rane zahtjeve za Traffic Inspector. Četiri ranije izvedena modula — spajanje SSE-a, normalizacija razgovora, maskiranje tajni i saniranje zaglavlja — zamijenjena su nezavisnim implementacijama čistog dizajna zasnovanim na javnim standardima protokola. Dvije površine za izravni prolaz hosta (`passthrough.ts` i `_internal/bypass.cjs`) ostaju interne implementacije OmniRoutea koje su zasebno klasificirane; nisu ponovo napisane u sklopu te zamjene.
ProxyBridge	6,814	Transparentno proxy usmjeravanje po procesu — inspirisalo je naše rušenje MITM-a otporno na padove, vremenska ograničenja neaktivnosti socketa, pripisivanje procesa putem `/proc` i TPROXY hvatanje.

📚 Podaci o modelima, opservabilnost i korisničko sučelje

Projekt	⭐	Kako je inspirisao OmniRoute
models.dev	7,286	Otvorena baza podataka sa specifikacijama, cijenama i mogućnostima AI modela — izvorno sinhronizirana s našim katalogom modela.
React Flow / xyflow	38,705	Biblioteka grafova zasnovana na čvorovima koja pokreće naš Compression Studio i Combo/Routing Studio u stvarnom vremenu.
LangGraph	43,443	Vizualizacija grafa radnog toka uživo iz LangGraph Studija inspirisala je kaskadni prikaz naših Studija u stvarnom vremenu.
Langfuse	35,990	Njegov model opservabilnosti trag → raspon → generisanje oblikovao je naš kaskadni prikaz u Compression Studiju.
Kiali	3,645	Opservabilnost Istio servisne mreže — inspirisala je naše značke prekidača strujnog kruga i vizualne prikaze veza s greškama u Routing/Combo Studiju.
lobe-icons	2,615	Logotipi AI/LLM brendova koji prikazuju ikone pružalaca usluga na našoj kontrolnoj ploči.
flag-icons	12,473	Pruža SVG zastave s MIT licencom koje koristi birač jezika u README-u.

🛡️ Sigurnost

Projekt	⭐	Kako je inspirisao OmniRoute
awesome-secure-defaults	722	Kurirana lista biblioteka koje su sigurne prema zadanim postavkama i usmjeravaju naše sigurnosne izbore (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).

🧭 Komplementarni alati

Projekt	⭐	Kako je inspirisao OmniRoute
ClawRouter	6,628	Inspirisao je deduplikaciju zahtjeva, hitni rezervni izbor bez troškova, priključive Auto-Combo strategije i višejezičnu klasifikaciju namjere.
Antigravity-Manager	32,333	Njegovo ponovno mapiranje modela prilagođeno računu, provjera putanje izvršne datoteke i ponašanje oznaka plana utjecali su na Antigravity izvršno okruženje OmniRoutea.
vscode-antigravity-cockpit	4,850	Njegov kompaktni format odbrojavanja do poništavanja kvote inspirisao je odgovarajući prikaz ograničenja pružaoca usluga u OmniRouteu.
AionUi	33,611	Njegove ACP integracije inspirisale su OmniRouteovo automatsko otkrivanje instaliranih CLI agenata.
CodexBar	22,616	Identificirao je sučelje Grok Build kvote; OmniRoute je zatim nezavisno provjerio i ispravio aktivni format prijenosa podataka.

📄 Licenca

MIT licenca - pogledajte LICENSE za detalje.

⬆ Nazad na vrh · Napravljeno s ❤️ za open-source AI zajednicu.

_{OmniRoute v3.8.53 · Node ≥22.22.2 · MIT licenca · omniroute.online}

FilesExpand file tree

README.md

Latest commit

History