Batch 1 of the locale expansion: Greek, Croatian, Serbian, Lithuanian, Estonian, Latvian, Slovenian, Maltese and Irish across the dashboard catalog, docs mirrors, CLI catalog, README, locale index and the site. 42 → 51 locales. Also fixes the ICU literal escape the translation backend dropped around angle placeholders, four translations that invented or renamed a placeholder, the language bars that linked to mirrors that do not exist, and the migration count drift (171 → 172). ⚠️ base-red inherited: #12732 — the four unit shards and Fast Quality Gates fail identically on unrelated PRs cut from the same base.
149 KiB
README (Српски)
🌐 Languages: 🇺🇸 English · 🇸🇦 ar · 🇦🇿 az · 🇧🇬 bg · 🇧🇩 bn · 🇨🇿 cs · 🇩🇰 da · 🇩🇪 de · 🇬🇷 el · 🇪🇸 es · 🇪🇪 et · 🇮🇷 fa · 🇫🇮 fi · 🇫🇷 fr · 🇮🇪 ga · 🇮🇳 gu · 🇮🇱 he · 🇮🇳 hi · 🇭🇷 hr · 🇭🇺 hu · 🇮🇩 id · 🇮🇹 it · 🇯🇵 ja · 🇰🇷 ko · 🇱🇹 lt · 🇱🇻 lv · 🇮🇳 mr · 🇲🇾 ms · 🇲🇹 mt · 🇳🇱 nl · 🇳🇴 no · 🇵🇭 phi · 🇵🇱 pl · 🇵🇹 pt · 🇧🇷 pt-BR · 🇷🇴 ro · 🇷🇺 ru · 🇸🇰 sk · 🇸🇮 sl · 🇸🇪 sv · 🇰🇪 sw · 🇮🇳 ta · 🇮🇳 te · 🇹🇭 th · 🇹🇷 tr · 🇺🇦 uk-UA · 🇵🇰 ur · 🇻🇳 vi · 🇨🇳 zh-CN · 🇹🇼 zh-TW
💰 ~1,51 milijardu besplatnih tokena / mesečno
Ručno slaganje besplatnih planova je bolno — desetine SDK-ova, desetine ograničenja brzine i bez ikakve ideje koliko zaista imate. OmniRoute katalogizuje 446 unosa besplatnog nivoa u okviru 38 obnavljajućih pool ključeva i računa naslovni broj tokena iz 20 pool-ova sa objavljenim pozitivnim mesečnim budžetom, deduplikovanih po zajedničkom pool-u. Rezultat ostaje vidljiv na dashboard-u (
/dashboard/free-tiers).
Animirani prikaz live stranice
/dashboard/free-tiers. Kompletna metodologija (deduplikacija pool-ova, kreditni nivoi, uslovi provajdera): docs/reference/FREE_TIERS.md.Ovi podaci se ponovo revidiraju svake dve nedelje na osnovu živog kataloga i mogu se menjati u oba smera — provajder ukine besplatni nivo i broj opadne; stigne novi i broj poraste. Objavljujemo ono što katalog stvarno izračuna, nikada zaokruženi optimistički scenario.
⭐ Zvezdicom (star) obeležite repo ako vam je OMNIROUTE pomogao da uštedite novac i olakšate posao.
💬 Priključite se zajednici
👋 Zapratite održavatelja projekta — budite prvi koji saznaje za nove provajdere, izdanja i savete:
Pitanja, savete o provajderima, plan razvoja i podrška → Discord · Telegram · WhatsApp 🌍 Globalno / 🇧🇷 Brasil / Portal
📈 Gateway Nastavlja da Raste
| v3.8.49 | v3.8.50 | v3.8.51+ |
|
|---|---|---|---|
| 🌐 Provajderi | 290 | 352 | još u redu za čekanje |
| 🧠 Jedinstveni ID-jevi chat modela | 1185 | 1312 | — |
| 🖼️ Modality Bridge | — | 🆕 vizija + audio + video | — |
| 📡 Radar besplatni katalog | — | 🆕 opciono (opt-in) | — |
| ⚖️ Raspoređivanje svesno kvota | — | 🆕 Quota-Share | — |
| 📊 Telemetrija kvota | — | 🆕 uživo | — |
→ Mapa puta — jurimo ka v3.9.0 LTS
🧩 Dostupno
| 🚀 Početak | 🚀 Brzi Početak | 📦 Instalacija | 🆓 Bez konfiguracije |
| 💡 Naučite | 💥 Obećanje | 🤔 Zašto OmniRoute | 🏆 Šta Ga Izdvaja |
| ⚙️ Funkcije | 🎯 Kombinacije | 🌐 Provajderi | 🔌 CLI i MCP |
| 🗜️ Kompresija | 🖥️ Gde Radi | 🔒 Privatno | |
| 👀 Pogledajte | 🎬 U Akciji | ✨ Šta Je Novo | 🤖 Kompatibilni CLI-jevi |
| 💚 Podrška | 💚 Podrška / Donacija | 💬 Zajednica | 💖 Sponzori |
| 📦 Projekat | 🛠️ Tehnologije | 📖 Dokumentacija | 👥 Saradnici |
🆓 Радите одмах након инсталације — без кључева, без конфигурације
# Свежа инсталација, без креденцијала — `auto` већ функционише:
curl http://localhost:20128/v1/chat/completions \
-H "Content-Type: application/json" \
-d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}'
Више волите одређени бесплатни бекенд? Позовите директно oc/… (OpenCode Free). Затим прейдите на auto и оставите да OmniRoute бира.
📦 Скрипте за брз почетак спремне за копирање и лепљење за Python, Node.js, PHP и cURL → examples/quickstart/
💥 Обећање
🤔 Зашто OmniRoute?
🤝 Уз подршку наших пријатеља отвореног кода
Желите да се придружите као пријатељ отвореног кода? То су компаније које подржавају отворени код и помажу да OmniRoute напредује — и јавно наводимо где иде сваки токен који нам дају. Јавите нам се: diegosouza.pw@outlook.com
|
Kimi Moonshot AI |
Захваљујемо се Kimi (Moonshot AI), нашем оснивачком пријатељу отвореног кода, на подршци овом проjekту! Kimi je AI лабораторија иза породица модела отворене тежине K2 и K3 — Kimi K3 нуди контекстни прозор од 1M токена, native визуелну подршку и програмирање на нивоу врхунских модела по знатно нижој цени, и ради без икаквих подешавања са Claude Code, Codex и сваким алатом за програмирање који OmniRoute опслужује.
Шта подршка Kimi-ja омогућава: Kimi-jevi API кредити покрeћу OmniRoute-ов процес издавања верзија валидиран помоћу AI-a — фазу merge validation powered by Kimi K3 која прегледа сваки pull request прије него што се објави — као и свакодневни развој функционалности. Подршка првог реда за Kimi доступна је на оба пута: директно преко Kimi API ( kimi-k3) и преко Kimi Code плана за програмирање (OAuth и API кључ). OmniRoute je такође први бразилски пројекат отвореног кода у Kimi-jevom програму подршке. Набавите Kimi API кључ са 15% додатних кредита →
|
|
Cheaper Inference cheaperinference.com |
Захваљујемо се Cheaper Inference, пријатељу OmniRoute-a у отвореном коду, на подршци овом проjekту! Cheaper Inference је улазна тачка рангирана по трошковима која препродаjе 42 врхунска модела — Claude, GPT-5.x, Gemini, Kimi K3, GLM, DeepSeek, Grok и MiniMax — иза jedne крajне тачке компатибилне са OpenAI, усмјеравајући свaki захтев ka најjeftинijem погодном добавaчу без наплаћивања преко цене коju je odredio произвођач модела.
Подршка првог реда у OmniRoute: Chat Completions, native крajnja tačka /v1/responses, визуелна подршка, позивање алата (tool calling) и 3 модела за слике (grok-imagine, nano-banana-pro, nano-banana-2, доступни kao cheaperinference/<model>). Набавите API кључ →
|
Линкови означени са aff=omniroute су партнерски линкови. Они финансирају проjekat без додатних трошкова за вас.
🎟️ Промоције партнерских програма — купони за бесплатну регистрацију од провajдерa које не спонзоришемо (кликните да проширите)
Овaj одeljak je намењен искључиво кодовима за препоруку/купоне. Спонзорисана партнерства налазе се у одeljku 🤝 Уз подршку наших пријатеља отвореног кода изнад. OmniRoute нема спонзорство ни партнерство са провajderima наведеним овде — ovo su jавни купони које свако може искористити.
|
AgentRouter agentrouter.org |
AgentRouter — партнерска регистрација · 100 $ бесплатних кредита приликом регистрације (бесплатан сервер, очекујте већу латенцију — најбоље за тестирање, а не за производно окружење). Подршка првог реда у OmniRoute од верзије v3.8.50: Chat Completions, Anthropic-компатибилни формат преноса и OpenAI-компатибилна путања. Доступни модели укључују claude-opus-4-8, claude-opus-5, gpt-5.6-sol и друге. Преузмите свojих 100 $ →
⚠️ Партнерски линк — OmniRoute нема спонзорство ни партнерство са овим провajderom. |
Знате за неког другог провajdera са издашним купоном за бесплатну регистрацију који би користио корисницима OmniRoute-a? Отворите issue и додаћемо га овде.
🎯 Комбо — Флагман
Комбо је ланац модела кроз које OmniRoute рутира аутоматски. Ако квота истекне, провајдер откаже или трошкови скоче, комбо може прећи на следећи погодан здрав модел. 🛡️
⚡ Без конфигурације — само користите auto
Нема потребе да правите комбо. Поставите модел на auto (или неку варијанту) и OmniRoute гради виртуелни комбо од ваших повезаних провајдера, оцењен у реалном времену:
| ID модела | За шта је оптимизован |
|---|---|
auto | 🎯 Уравнотежени подразумевани режим (LKGP — придржава се вашег последњег добро функционалног провајдера) |
auto/coding | 🧑💻 Тежине усмерене ка квалитету за генерисање кода |
auto/fast | ⚡ Најмања латенција прво |
auto/cheap | 💰 Најјефтиније по токену прво |
auto/offline | 🔋 Највише преостале квоте / простора до ограничења прво |
auto/smart | 🔭 Приоритет квалитета + 10% истраживања ради откривања бољих модела |
auto/lkgp | 📌 Изричито придржавање последњег добро функционалног провајдера |
auto/chaos | 🧪 Тежине за симулацију грешака ради тестирања отпорности (chaos engineering) |
🔀 Или направите сопствену — 19 стратегија рутирања
Свих 19 стратегија — комбинујте по кораку у комбоу:
| # | Стратегија | Шта ради |
|---|---|---|
| 1 | priority |
Уређена листа приоритетних мета — испразни сваку пре прелаза на следећу 🥇 |
| 2 | fill-first |
Потпуно попуни квоту сваке мете пре него што настави даље |
| 3 | weighted |
Пондерисан случајан избор по тежини сваке мете |
| 4 | round-robin |
Циклично пролажење кроз мете по редоследу |
| 5 | p2c |
Балансирање оптерећења методом „power-of-two-choices" |
| 6 | least-used |
Бира мету са тренутно најмањим оптерећењем |
| 7 | random |
Равномеран случајан избор (без дупликата) |
| 8 | strict-random |
Случајан избор без уклањања поновљених мета 🎲 |
| 9 | cost-optimized |
Минимизира трошак ($) по захтеву на основу актуелних цена из каталога 💸 |
| 10 | headroom |
Бира мету са највише преостале квоте |
| 11 | reset-window |
Даје приоритет мети чији се прозор квоте најскорије ресетује |
| 12 | reset-aware |
Рангира према времену ресетовања квоте — кратки прозори прво 📊 |
| 13 | context-relay |
Предаје контекст између мета за дуге конверзације 🧠 |
| 14 | context-optimized |
Бира најбоље решење за тренутну величину контекста |
| 15 | cache-optimized |
Фиксира сваки поновно употребив префикс промпта за исти налог — максимизује погодине у кешу промпта 🎯 |
| 16 | lkgp |
Last-Known-Good Path (последња позната добра путања) — фиксира се на последњи успешан провајдер, затим прелази на резервна правила |
| 17 | auto |
Оцењивање у реалном времену на основу 16 фактора за сваку везу 🤖 |
| 18 | fusion |
Дистрибуира упит на панел модела + судија синтетизује један одговор 🧬 |
| 19 | pipeline |
Ланчани кораци — излаз сваке мете се прослеђује следећој 🔗 |
Механизам Auto-Combo оцењује сваког кандидата по 16 фактора (здравље, квота, трошак, латенција, погодност за задатак, квалитет, доступност сесије…) — погледајте docs/routing/AUTO-COMBO.md.
🧱 Отпорност је уграђена (3 независна слоја)
<img src="./docs/diagrams/resilience-layers.svg" width="100%" alt="Отпорност OmniRoute — 3 независна самообновљива слоја, прави слој за прави тип отказивања. Слој 1: прекидач кола провајдера (цео провајдер): активира се само на 408/5xx, прагови OAuth 8× / API-key 12× / локално 2×, ресетовање 60s/30s/15s у HALF-OPEN пробу, лења обнова; док је OPEN, комбо преусмерава на следећег провајдера. Слој 2: пауза везе (један кључ/налог): основа 5s OAuth / 3s API-key, експоненцијално ×2 повлачење уз заштиту од „anti-thundering-herd" ефекта, 429 поштује Retry-After, успех чисти сво стање грешке; један кључ у паузи се прескаче док остали кључеви настављају да опслужују. Слој 3: закључавање модела (један модел): грешке 429 по моделу, локалне 404 или одбијања режима закључавају само тај модел — никада целу везу. Терминалне стања (забрана, истек, потрошени кредити) су намењене оператору, а не паузи."/>
📖 Auto-Combo Engine · Водич за отпорност
🏆 Шта издваја OmniRoute од конкуренције
📊 Потпуна методологија и детаљи по функцијама у односу на 9router, OpenRouter, CLIProxyAPI и LiteLLM → docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md
💚 Подржите OmniRoute
OmniRoute је лиценциран под MIT лиценцом и одржаван је отворено. Ако вам штеди време или новац, ево како можете помоћи да остане независан — изаберите оно што вама одговара. Спонзорство никада не утиче на приоритет рутирања; купује видљивост, а не рангирање.
| ⭐ Означите репозиторијум звездицом | Бесплатно — заиста помаже видљивости | Star OmniRoute |
| 🐙 GitHub Sponsors | Једнократно или месечно · без провизије платформе | github.com/sponsors/diegosouzapw |
| ☕ Ko-fi | Брз једнократни напитак, без пријаве за донатора | ko-fi.com/diegosouzapw |
| 🧋 Buy Me a Coffee | Мали, неформалан гест | buymeacoffee.com/diegosouzapw |
| 🖐 Liberapay | Периодично · непрофитно · отвореног кода | liberapay.com/diegosouzapw |
| 🇧🇷 PIX (Бразил) | Тренутно, без накнада | кључ и QR испод |
| ₿ Криптовалуте | BTC · ETH · USDT-TRC20 · USDC-Solana | адресе испод |
🇧🇷 PIX — тренутно, без накнада (Бразил)
Кључ (насумичан): 5d865059-bc44-483a-962d-43ceb80126eb
Pix copia-e-cola:
00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD
₿ Криптовалуте — BTC · ETH · USDT-TRC20 · USDC-Solana (кликните за приказ)
| ₿ BTC | Bitcoin (SegWit) | bc1qh00smz004sy85wyl28v77tenkt3ckl6eaep7fd |
| Ξ ETH | Ethereum (ERC20) | 0x64Cf6B68A6Ff34288e89172950a2d00102337a84 |
| ₮ USDT | Tron (TRC20) | TKAF41JpuQrHbKTnsQa9svJE2T192Hvsc2 |
| $ USDC | Solana | 2emNNZzVVWQc3FQ2wk9M6qXUQmW8AKdjjL174fXR28Tu |
⚠️ Сваку валуту слати само на мрежи која је приказана — слање на погрешну мрежу може довести до губитка средства.
🐛 Пронашли сте грешку или имате повратну информацију? Отворите Discussion.
Напомене за развојне тимове: Пројекат може генерисати локалну .env датотеку током npm install/postinstall процеса ради лакшег рада развојних тимова. Ова датотека је намерно игнорисана путем .gitignore (погледајте .gitignore) и никада не сме бити комитована — уколико се случајно комитује, ротирајте све изложене тајне податке и уклоните датотеку из историје. Погледајте docs/DEVELOPER-ENVIRONMENT.md за упутства о управљању локалним датотекама окружења и тајним подацима.
📡 OmniRoute Radar
Glavni naslovni podatak za besplatni nivo i dalje je ~1,51 milijardi tokena/mesečno iz dokumentovanog, deduplikovanog kataloga pool-a prikazanog iznad. Privremeni krediti za prijavu kod provajdera mogu odvojeno podići prvi mesec na ~2,13 milijardi. Radar je opcioni, potpisani preklop kataloga za one koji žele svežiju dostupnost besplatnih modela između izdanja OmniRoute-a; katalog zajednice i svaka postojeća besplatna funkcija ostaju besplatni.
Podržavajući korisnici (Supporters) mogu dobiti pristup živom katalogu i dodatnim mogućnostima kod provajdera. Njegov odvojeni, promenljivi limit je maksimalno oko 3 milijarde tokena/mesečno, u zavisnosti od dostupnosti provajdera. Taj limit nije garancija: provajderi mogu u svakom trenutku promeniti kvote, uslove prihvatljivosti, modele ili regione.
Radar je opcioni i koristi samo GET zahteve. OmniRoute klijent ne otprema prompt-ove, saobraćaj, konfiguraciju provajdera, telemetriju korišćenja ili lokalni status odbacivanja obaveštenja. Saznajte više o uslovima prihvatljivosti i trenutnom katalogu na radar.omniroute.online/planos.
✨ Šta je novo
Skorašnji istaknuti detalji iz verzija v3.8.20 → v3.8.50. Kompletna istorija se nalazi u
CHANGELOG.md.
- 🎛️ OmniConductor — dolazna A2A delegacija ka vašoj floti agenata, Conductor vештине (skills) na Agent Card-u, i panel na kontrolnoj tabli sa Faro push-to-talk glasovnim ćaskanjem. → A2A Server
- 🛂 Adaptivni prijem i zaštita od preopterećenja — teški chat zahtevi se stavljaju u red čekanja umesto da vraćaju 503 grešku, uz atomske RPM rotirajuće zakupe (leases) po konekciji. → Resilience Guide
- 🗂️ Kanonsko
/v1/modelsuređivanje — jedan kontinuirani blok grupisan po provajderu za svakog provajdera (kombinacije su prve fiksirane), stabilno kroz svaki izvor kataloga. → API Reference - 🗜️ Poboljšanje kompresije — podrazumevano uključena zaštita od inflacije, Caveman paketi za DE / FR / JA + kineski (wényán), RTK filteri za Gradle i .NET. → Compression
- 💸 Iskrena fiksna cena — provajderi sa pretplatom / coding-plan pokazuju $0 u analitici troškova; budžet, kvota i rutiranje nastavljaju sa procenom. → API Reference
- ⚖️ Quota-Share rutiranje — pravedna podela kvote deljenog naloga preko udruženih ključeva, sa mehanizmom koji ne rasipa resurse tako što se neaktivni delovi pozajmljuju. → Resilience Guide
- 🤖 Podešavanje CLI/agenta jednom komandom — 13 registrovanih
setup-*komandi;omniroute runpokreće 7 CLI alata (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI);omniroute configurepodržava 10 ciljeva sa interaktivnim izborom provajdera+modela i omiljenim postavkama po kontekstu. → CLI Integrations - 🛰️ Udaljeni režim (Remote mode) — upravljajte udaljenim OmniRoute-om preko tokena sa ograničenim opsegom (
connect/contexts/tokens) +antigravityOAuth pomoćnik za VPS instalacije. → Remote Mode - 🧭 Pametnije auto-rutiranje —
auto/<category>:<tier>kombinacije, Fusion (panel modela + sudija), rutiranje svesno zadatka, izmene po zahtevu za model / mod / USD-budžet. → Auto-Combo - 🗜️ Kompresija sa priključcima (Pluggable compression) — 12 kombinujućih motora + Compression Studios: LLMLingua-2, dvoslojni Ultra, omniglyph, kapija verodostojnosti po koraku, GCF v3.2, editor sa prevlačenjem za promenu redosleda. → Compression
- 🕵️ Transparentna MITM dekripcija (TPROXY) — hvatanje CLI alata koji ignorišu proxy env varijable, uz CA po SNI + instalater za trust-store. → MITM/TPROXY
- 💸 Telemetrija troškova svuda —
X-OmniRoute-*zaglavlja troškova/korišćenja na svakom endpointu, zaglavlje uštede za cache-HIT, kvote USD potrošnje po ključu. → API Reference - 🧠 Memorija koju kontrolišete — podrazumevano isključena, opciona int8 vektorska kvantizacija + tipizovano opadanje (decay), po-zahtevni
x-omniroute-no-memory. → Memory - 🛡️ Bezbednost — zaštita od prompt-injekcije na svakoj LLM ruti (red-team paket), opciona zaštita za maskiranje kredencijala (redaktuje procurele API ključeve/tajne u oba smera), besplatna DuckDuckGo pretraga weba kao poslednje sredstvo, i opciona OIDC prijavna kapija za kontrolnu tablu (prijava lozinkom je uvek dostupna). → Guardrails
- 🖼️ Novi endpointi —
/v1/ocr(Mistral OCR) i/v1/audio/translations(u stilu Whisper-a) upotpunjuju 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 govorni provajderi kao ElevenLabs. → API Reference
- 🌍 Postavljanje i operacije — reverse-proxy
basePath, automatsko otkrivanje jezika pretraživača, praćenje uređaja po ključu, MITM poverenje bez root prava, zh-TW lokalizacija. → Environment - 🤝 Više provajdera i agenata — cloud agenti (Codex Cloud, Cursor, Devin, Jules), Grok Build (xAI) sa prijavom preko browsera i OAuth-a, Ollama kartica prvog reda, Claude Opus 5 i Sonnet 5, zvanično Kimi partnerstvo (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… i osvežen katalog od 352 provajdera. → Providers
- 📡 Transparentnost rutiranja — svaki odgovor nosi zaglavlje
X-OmniRoute-Decisionkoje navodi strategiju/provajdera/kašnjenje koje je opsluživalo zahtev, novacache-optimizedstrategija kombinacije + Auto-Combo faktorcacheAffinityusmerava ponovljene zahteve nazad na konekciju koja sadrži keširani prefiks, a endpoint samo za čitanje/v1/auto-combo/{channel}/candidatesizlaže živi bazen kandidata zaauto/*kanal. → Auto-Combo - ⚡ Lokalne performanse i infrastruktura — lokalni Redis jednim klikom, deployeri za Cloudflare Workers / Deno Deploy relej, Bifrost i Mux kao nadgledani ugrađeni servisi. → Embedded Services
- 🧩 Takođe u paketu — okvir za priključke (plugin framework) + marketplace, okviri vештина za Omni/Agent/GitHub, integracija Obsidian vault-a (22 MCP alata), OpenAI-kompatibilni Batch i Files API-jevi, semantička keš memorija odgovora, gamifikacija sa tabelama najboljih (leaderboards), ACP otkrivanje agenata (15 ugrađenih agenata), zakazani izvoz logova u BigQuery,
auto/chaosubacivanje grešaka (fault injection), Telegram bot most, ugrađeni menadžer verzija u aplikaciji i LMArena-ELO rangiranje besplatnih provajdera. → Docs
🤖 Компатибилни CLI алати и агенти за кодирање
Једна конфигурација —
http://localhost:20128/v1— и сваки AI IDE или CLI ради на бесплатним и јефтиним моделима.
Claude Code |
Codex CLI |
Cline |
Kilo Code |
Zoo Code |
Continue |
Aider |
ForgeCode |
jcode |
DeepSeek TUI |
CodeWhale |
OpenCode |
Factory Droid |
Copilot CLI |
Cursor CLI |
Smelt |
Pi |
Grok Build |
Hermes Agent |
OpenClaw |
Goose |
Open Interpreter |
Warp AI |
Agent Deck |
📖 Подешавање по алату за свих 36 алата (26 CLI Code-а + 10 CLI агената) → docs/reference/CLI-TOOLS.md · 🧩 OpenCode додатак → @omniroute/opencode-provider
Покрените било који подржани CLI кроз OmniRoute једном командом — без писања конфигурационих фајлова, креденцијали се убацују по процесу, а Qwen/Gemini добијају одвојив изолован home:
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"
# Или изаберите провајдера+модел интерактивно и запишите сопствену конфигурацију алата:
omniroute configure codex # такође: claude opencode qwen aider goose gemini cline continue kilo
Свака команда поштује активни удаљени контекст (omniroute connect <host>), --dry-run
приказује тачан env/args пре извршавања, а --api-key-env NAME чува тајне подаље
од историје ваше конзоле. → CLI интеграције
🌐 352 AI провајдера — 152 означено у каталогу као бесплатно
352 регистрована провајдера у оквиру канонских колекција за ћаскање, медије, претрагу, локалне, cloud-agent и системске сврхе, укључујући 152 која носе метаподатке за откривање
hasFree: true. Регистар модела за ћаскање обухвата 229 провајдера / 2.554 различитих парова провајдер-модел / 1.283 сирова ID-а модела; посебан каталог бесплатних буџета има 446 редова по моделу, 38 понављајућих пулова и 53 понављајућа/бескључна провајдера који су заувек бесплатни. Ово су намерно различити бројитељи; дефиниције и прорачуни без дуплирања пулова налазе се у документима Provider Reference и Free Tiers.
🏢 Свака значајна лабораторија — преко једне крајње тачке
OpenAI |
Anthropic |
Gemini |
xAI Grok |
DeepSeek |
Mistral |
Qwen |
Meta Llama |
Groq |
NVIDIA |
MiniMax |
Cohere |
Perplexity |
HuggingFace |
Together |
Fireworks |
Cloudflare |
Baidu |
…и još преко 330 — свака икона се учитава уживо из провајдер каталога на контролној табли. 📖 Provider Reference
🆓 Заувек бесплатно — 0 динара, без картице
📖 Потпуни машински читљив каталог → docs/reference/PROVIDER_REFERENCE.md
🖥️ Где OmniRoute радi — Свуда
Иста апликација, ваш уређај, ваша правила. Од глобалне npm инсталације до вашег телефона преко Termux-а.
| Платформа | Инсталација | Истицане карактеристике |
|---|---|---|
| 📦 npm (глобално) | npm install -g omniroute | Једна команда, било који ОС |
| 🐳 Docker | docker run … diegosouzapw/omniroute | Multi-arch AMD64 + ARM64 |
| 🖥️ Desktop (Electron) | npm run electron:build | Native прозор + системска трака — Windows / macOS / Linux |
| 💪 ARM | native arm64 | Raspberry Pi, ARM сервери, Apple Silicon |
| 📱 Android (Termux) | pkg install nodejs && npx -y omniroute | Ради на вашем телефону, 24/7, без root-а |
| 📲 PWA | "Додај на почетни екран" | Целоекранско, offline, инсталабилно из прегледача |
| 🧩 OpenCode plugin | @omniroute/opencode-provider | Native OpenCode интеграција |
| 🤖 VS Code Copilot Chat | инсталирајте OmniCopilot екстензију | Сваки OmniRoute модел у native Copilot Chat бирачу — stable & Insiders |
| 🛠️ Из извора | npm install && npm run dev | Хакујте, допринесите |
📖 Docker водич · Desktop · Termux · PWA · OpenCode
🧩 Ново: OmniRoute унутар VS Code-овог native Copilot Chat-а
Нема нове бочне траке, нема новог chat интерфејса — сваки модел који OmniRoute сервира појављује се директно у Copilot Chat бирачу модела који већ користите. Од VS Code 1.122, provider модели раде без GitHub пријаве или Copilot претплате — agent режим, позивање алата и vision, потпуно бесплатно.
Инсталирајте OmniCopilot екстензију, усмерите је
на ваш OmniRoute сервер (подразумевано localhost:20128), затим отворите Copilot Chat → бирач модела
→ Manage Models… → OmniRoute.
| Продавница | Линк | Ради са |
|---|---|---|
| 🧩 VS Code Marketplace | Инсталирај → | VS Code — stable & Insiders |
| 🔓 Open VSX Registry | Инсталирај → | Cursor, Windsurf, VSCodium, Theia, code-server, Gitpod, Antigravity, Kiro… |
Из самог уређивача: отворите преглед Extensions, потражите "OmniRoute", кликните Install — ради на исти начин у обе продавнице. Извор, проблеми и упутство за објављивање налазе се на diegosouzapw/OmniCopilot.
📖 VS Code Copilot Chat водич — подешавање, шта бирач приказује, dashboard-in-a-tab, решавање проблема
🔒 Privatnost i lokalno prvo
📖 Autorizacija · Ograde (Guardrails) · Usklađenost
🔌 Potpuni CLI + A2A i MCP
Osim kao server, OmniRoute je i potpuna kontrolna komandna linija sa preko 80 komandi, plus otvoreni protokoli za agente, tako da AI agent može da ga upravlja samostalno.
⌨️ Prava komandna linija (ne samo start)
omniroute # pokreni gateway + kontrolnu tablu (port 20128)
omniroute chat # interaktivni TUI chat klijent (kose crte: /model /combo /skill /memory)
omniroute setup # vođeni čarobnjak za prvo pokretanje
omniroute doctor # dijagnostika provajdera, portova, nativnih zavisnosti
🛰️ Udaljeni režim — pokrenite CLI ovde, OmniRoute na VPS-u
OmniRoute na serveru? Upravljajte njime sa svog laptopa koristeći istu komandnu liniju. Prijavite se jednom sa ograničenim pristupnim tokenom; svaka naredna komanda tada cilja udaljeni server.
omniroute connect 192.168.0.15 # lozinka → ograničeni token, sačuvan kao kontekst
omniroute models list # ← izvršava se na UDALJENOM serveru
omniroute configure codex # ← bira udaljeni model, upisuje lokalni Codex profil
omniroute tokens create --name ci --scope read # kreirajte uže ograničene tokene za druge mašine
omniroute contexts use default # ← vratite se na lokalni server
Tokeni imaju ograničen opseg read / write / admin; rute koje pokreću procese ostaju dostupne samo lokalno (loopback-only).
📖 Udaljeni režim
🤝 Povežite agenta — i on sam upravlja OmniRoute-om
Izložite OmniRoute preko MCP, A2A, REST API-ja, webhook-ova ili udaljene komandne linije — bilo koji sposoban agent (ili vaš vlastiti kod) dobija ključeve za ceo gateway: rutiranje, provajdere, kombinacije, keš, kompresiju, memoriju — samostalno. HTTP krajnje tačke ispod se opslužuju na http://localhost:20128.
| Interfejs | Krajnja tačka / komanda | Koristite za |
|---|---|---|
| 🧰 MCP (stdio) | omniroute --mcp | Povezivanje sa Claude Desktop, Cursor, bilo kojim MCP klijentom |
| 🌊 MCP (HTTP) | /api/mcp/stream | Udaljeni MCP — 110 alata, 33 opsega (primena po izboru), potpuni trag revizije |
| 📡 MCP (SSE) | /api/mcp/sse | Strimovani MCP transport |
| 🤝 A2A | /.well-known/agent.json | Komunikacija agent-agent, JSON-RPC 2.0 + SSE, 6 sposobnosti |
| 🌐 REST API | /v1/* | Kompatibilan sa OpenAI — chat, embedovanja, slike, audio, OCR |
| 🔔 Webhook-ovi | /api/webhooks | Slanje događaja zahteva / kvota na Slack, Discord, Telegram ili bilo koji URL |
| 🛰️ Udaljena CLI | omniroute connect | Upravljanje udaljenom instancom pomoću ograničenih pristupnih tokena |
# Dajte Claude Code-u kompletan skup OmniRoute alata preko MCP-a:
claude mcp add-server omniroute --type http --url http://localhost:20128/api/mcp/stream
📖 MCP Server · A2A Server · Protokoli agenata
🗜️ Уштедите 15–95% токена — аутоматски
📖 Како то функционише — pipeline, архитектура и математика уштеде
Podrazumevana naslagana kombinacija radi RTK → Caveman. Kada oba deluju na isti tool/kontekst payload, uštede se kombinuju:
combined = 1 − (1 − RTK) × (1 − Caveman_input)
average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range = 78.4 – 94.6%
Blokovi kôda, URL-ovi, JSON i strukturirani podaci su uvek zaštićeni od strane engine-a za očuvanje.
Zašto koristiti mnogo tokena kada malo tokena obavi posao? Svaki zahtev prolazi kroz OmniRoute-ov pipeline za kompresiju transparentno — bez izmena na strani klijenta. Sada je to stek od 12 kompozabilnih engine-a koji se izvršavaju po redosledu i kombinuju u zavisnosti od routing kombinacije — nadograđujući ideje iz RTK, Caveman (⭐ 90K+), LLMLingua-2 i Troglodita (PT-BR).
🧱 Stek od 12 engine-a
Engine-i se izvršavaju po redosledu pipeline-a; svaki se nezavisno može uključiti/isključiti i podesiti po kombinaciji:
| # | Engine | Šta radi |
|---|---|---|
| 1 | Session-Dedup | Uklanja sadržaj koji se ponavlja kroz ture (content-addressed, cross-turn) |
| 2 | CCR | Arhivira velike blokove iza retrieve markera, preuzima se na zahtev |
| 3 | Lite | Skraćivanje razmaka + image-URL (osnova sa niskom latencijom) |
| 4 | RTK | Pametno filtriranje rezultata alata, dedup i truncation (svesno komandi) |
| 5 | Responses Tool Output | JSON kompresija bez gubitka podataka kao prioritet + ograničena kompresija dijagnostike za shell/patch/search/build izlaze (Responses API) |
| 6 | Headroom | Bezgubitna tabelarna kompakcija JSON nizova (~30%) putem prilagođenog GCF kodeka |
| 7 | Relevance | Ekstraktivno ocenjivanje rečenica u odnosu na poslednji upit korisnika |
| 8 | Caveman | Kompresija proze zasnovana na pravilima (~65–75% na izlazu) |
| 9 | Aggressive | Sumarizacija + progresivno „starenje" starijih tura |
| 10 | LLMLingua-2 | ML semantičko skraćivanje putem MobileBERT ONNX — bezbedno za kôd, asinhrono |
| 11 | Ultra | Heurističko skraćivanje tokena sa opcionim slojem malog modela (SLM) |
| 12 | OmniGlyph | Eksperimentalno kodiranje konteksta kao slike, mereno na Claude Fable 5 direktno preko Anthropic linka; GPT 5.6 transformeri ostaju fail-closed do potvrde provajdera. Četiri profila kompresije (agresivan podrazumevani, balansiran, safe-for-coding, passthrough) (najagresivniji; opt-in) |
Blokovi kôda, URL-ovi i strukturirani podaci su uvek očuvani bajt po bajt. Presetovi jednim klikom kombinuju engine-e:
| Mod | Ušteda | Najbolje za |
|---|---|---|
| 🪶 Lite | ~15% | Uvek uključena bezbedna podrazumevana opcija |
| 🪨 Standard (Caveman) | ~30% | Svakodnevno programiranje |
| ⚡ Aggressive | ~50% | Duge sesije sa intenzivnim korišćenjem alata |
| 🔥 Ultra | ~75% | Maksimalna ušteda |
| 🧰 RTK | 60–90% | Izlaz shell/test/build/git |
| 🔗 Naslagano (RTK → Caveman) | 78–95% | Mešoviti promptovi + logovi alata |
Realan primer — Standard mod:
Pre (69 tokena): "The reason your React component is re-rendering is likely because you're creating a new object reference on each render cycle. When you pass an inline object as a prop, React's shallow comparison sees it as a different object every time, which triggers a re-render. I would recommend using useMemo to memoize the object."
Posle (19 tokena): "New object ref each render. Inline object prop = new ref = re-render. Wrap in useMemo."
Isti odgovor. 72% manje tokena. Nula gubitka tačnosti. ✅
PT-BR primer — Troglodita mod:
Antes (42 tokena): "O problema é que o componente está re-renderizando porque uma nova referência de objeto está sendo criada em cada ciclo de renderização. Eu recomendaria usar useMemo."
Depois (12 tokena): "Re-render: ref nova cada ciclo (objeto inline recriado). Usar
useMemo."Mesma resposta. ~70% menos tokens. Precisão técnica intacta. ✅
🎚️ Dalje od engine-a — stilovi izlaza, adaptivni regulator i kontrola po zahtevu
12 engine-a iznad smanjuju šta ide unutra. Još tri sloja oblikuju kako, kada i šta izlazi napolje:
- 🪄 Output Styles (usmeravanje po osi izlaza) — ubacuju deterministička, cache-bezbedna uputstva za oblikovanje odgovora; kombinovana, svako na nivou intenziteta
lite/full/ultra. Dodavanje stila je jednolinijski unos u registar:- Terse prose — izbacuje suvišne reči / članove / izbegavajuće izraze; čuva tehničku suštinu netaknuto.
- Less code — "lazy senior dev" YAGNI pristup: najmanja funkcionalna izmena, bez neželjenog skele-koda.
- Ponytail (lazy senior dev) — penje se na YAGNI ljestvici, otklanja suštinski uzrok, najmanji funkcionalni diff.
- I have ADHD (action-first) — sledeća radnja na čelu, koraci numerisani, jedan konkretan sledeći korak, bez preambule.
- Terse CJK (文言) — ultra-koncizni stil u duhu klasičnog kineskog jezika (dostupan samo za lokal
zh).
- 🎯 Adaptivni budžet konteksta (regulator) — umesto jednog on/off praga tokena, postepeno se pojačavaju najjeftiniji, najbezgubitniji engine-i samo koliko je potrebno da se stane u kontekstni prozor modela. Politika:
reserve-output(podrazumevano, svesno modela) ·percentage·absolute. Mod:floor(garantuje uklapanje) ·replace-autotrigger(vaš eksplicitni izbor ima prioritet) ·off(klasični prag). - 🎛️ Gde se odlučuje o kompresiji (prioritet, od višeg ka nižem) — zaglavlje
x-omniroute-compressionpo zahtevu › override po routing kombinaciji › aktivni imenovani profil › adaptivno / auto-trigger › podrazumevano iz panela › off. Primenjeni plan se vraća u zaglavlju odgovoraX-OmniRoute-Compression: <mode>; source=<source>.
Auto-trigger po pragu tokena, uključite adaptivni regulator, fiksirajte imenovani profil, postavite jednokratnu opciju po zahtevu, ili dodelite pipeline po routing kombinaciji — šta god odgovara opterećenju. Opciona offline eval alatka (npm run eval:compression) ocenjuje tačnost u odnosu na uštedu na fiksiranom korpusu prije nego što primenite izmenu.
📖 COMPRESSION_GUIDE.md · RTK_COMPRESSION.md · COMPRESSION_ENGINES.md
⚡ Brzi početak
1) Instalirajte i pokrenite
npm install -g omniroute
omniroute
💡 Vidite
npm warn ERESOLVEili upozorenja o peer-dep? To je bezopasno.
Dashboard na http://localhost:20128 · API na http://localhost:20128/v1.
2) Povežite BESPLATAN provajder (bez registracije)
Dashboard → Providers → povežite Kiro AI (besplatan Claude, ~50 kredita/mesec po nalogu) ili OpenCode Free (bez autentikacije) → готово.
3) Usmerite svoj alat za programiranje
Base URL: http://localhost:20128/v1
API Key: [kopirajte iz Dashboard → Endpoints]
Model: auto (pametno rutiranje bez podešavanja — ili bilo koji provajder/model)
4) Provjerite da li radi
curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY"
Trebalo bi da vidite izlistane povezane modele. 🎉 To je to — počnite da programirate, a OmniRoute automatski rutira i prebacuje se na rezervne opcije za vas.
Ako vaš klijent ne može da šalje prilagođena zaglavlja, OmniRoute takođe izlaže tokenizovane alijase za kompatibilnost:
OpenAI catalog: http://localhost:20128/vscode/YOUR_KEY/
OpenAI models: http://localhost:20128/vscode/YOUR_KEY/models
OpenAI chat: http://localhost:20128/vscode/YOUR_KEY/chat/completions
OpenAI responses: http://localhost:20128/vscode/YOUR_KEY/responses
Ollama chat: http://localhost:20128/vscode/YOUR_KEY/api/chat
Ollama tags: http://localhost:20128/vscode/YOUR_KEY/api/tags
Koristite ove samo za klijente koji ne mogu da prilože Authorization: Bearer .... Autentikacija putem zaglavlja ostaje preporučeni mod.
📦 Још начина инсталације — Docker, извор, 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 пратi највишу објављену стабилну SemVer верзију. Не прати git main грану. Закачите :X.Y.Z за GitOps. Погледајте Docker Release Channels. Image фиксира OMNIROUTE_MEMORY_MB=1024. То је довољно за контролну таблу и лаган чет. Агентима за кодирање (POST /v1/responses из Claude Code, Codex, Grok, ...) потребна је много већа V8 гомила (heap), иначе процес доживљава FATAL ERROR на приближно 12 GiB код два преклапајућа дугa контекста. Одредите величину контејнера изнад heap-a (native баферi се налазе изван V8):
| Оптерећење | Heap (-e OMNIROUTE_MEMORY_MB) |
Контејнер (--memory) |
|---|---|---|
| Контролна табла / лаган чет | 1024 (подразумевано у image-у) |
≥2 g |
| Један агент за кодирање | 8192 |
≥10 g |
Два истовремена дуга /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
Комплетна табела: Docker Guide — runtime RAM.
Docker канал за пре-издања:
diegosouzapw/omniroute:nextиdiegosouzapw/omniroute:next-webпрате тренутну подразумевануrelease/v*грану. Ове променљиве ознаке су намењене само за тестирање необјављених исправки и нису подржане за производно окружење. Погледајте Docker Release Channels.
🥟 Bun
Стандардна bun install и глобална инсталација (bun install -g omniroute) су подржане путем детекције Bun runtime-a:
- Уграђени
bun:sqlite: OmniRoute користи Bun-ов уграђениbun:sqliteдрајвер када се извршава под Bun-ом, уз пребацивање наbetter-sqlite3на Node.js илиsql.js. - Аутоматски избор Webpack бандлера у dev режиму: Развојни режим (
bun run dev) аутоматски детектује Bun и искључује Turbopack у корист Webpack-a да би се спречиле некомпатибилности native V8 везивања. Производне градње (bun run build) пратеOMNIROUTE_USE_TURBOPACKтачно као на Node-у: Turbopack по подразумеваном,OMNIROUTE_USE_TURBOPACK=0за градњу са Webpack-ом (Dockerfile.bunто излаже као--build-arg). - Наменски Bun Dockerfile: Вишестепени
Dockerfile.bunза native Bun производна постављања (docker build -f Dockerfile.bun -t omniroute:bun .).
# Инсталирај и покрени са Bun-ом
bun install
bun run dev
🛠️ Из извора
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)
# Коришћење Nix flakes
nix develop
npm run dev
# Или коришћење devbox
devbox run npm run dev
📖 Docker Guide — Compose профили, Caddy HTTPS, Cloudflare тунели.
🦭 Podman
# 1. Припремите директоријум за податке који се bind-монтира
mkdir -p data
# 2. Само за Linux + локални rootless Podman (никад за удаљени Podman Machine клијент):
podman unshare chown 1000:1000 ./data
# 3. Подесите runtime hint, изградите локални Compose image, и покрените
echo "CONTAINER_HOST=podman" >> .env
podman compose --profile base up -d --build
На macOS или Windows-у, Podman користи удаљени Podman Machine: прескочите podman unshare и
пратите упутства за директоријум података специфична за топологију.
📖 Podman Guide — Compose градње, Podman Machine, и Linux/systemd Quadlet постављање.
⚡ Бржа / лакша инсталација (заобиђите native градњу)
Native SQLite мотор (better-sqlite3) је опциона зависност, тако да глобална
инсталација никада не блокира на компилацији из извора: користи преизграђену binary датотеку када постоји подударање
за вашу платформу/Node, а иначе транспарентно прелази на чисто JS мотор
(node:sqlite на Node 22+, у супротном приложени sql.js WASM) — нису потребни алати за градњу.
Да бисте потпуно прескочили native загревање након инсталације (CI, headless, или спори рачунари):
OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute # CI=1 такође то прескаче
За најбрже инсталације преферирајте pnpm (складиште адресирано по садржају + hard link-ови — погледајте изнад).
За headless окружење без контролне табле користите Docker base профил (изнад) или
Termux упутство. CLI и веб контролна табла се сервирају истим
процесом на једном порту, тако да тренутно не постоји засебан CLI-only пакет.
🎬 OmniRoute у акцији
📹 Video Guides
Snapshot do painel u 2026-08-24 · Sirovi katalog: YT 809 | TT 137 | IG 124 · Svežina (dani): YT 1 | TT 21 | IG 22
Kompletan rang (kanonski deduplicirani URL-ovi, v > 0, najveći domet):
| #1 | #2 | #3 | #4 | #5 |
|---|---|---|---|---|
| nick_saraev — Instagram — 3,042,474 | theopenstack — Instagram — 692,419 | milesreevesai — TikTok — 620,400 | Vaibhav Sisinty — YouTube — 391,109 | buildwithai.club — Instagram — 347,652 |
| #6 | #7 | #8 | #9 | #10 |
|---|---|---|---|---|
| nivedan.ai — Instagram — 331,973 | vaibhavsisinty — Instagram — 263,744 | Nick Automates — YouTube Shorts — 218,174 | theroshankrishna — Instagram — 186,786 | midudev — TikTok — 177,800 |
Kanonske metrike na 2026-08-24: 1.029 jedinstvenih videa · 11.132.922 poznatih pregleda (v > 0) · 639 kanala/profila po mreži. Sirova tabela sadrži 1.070 redova; 41 duplikat sa Instagrama je normalizovan prema kanonskom URL-u, uz zadržavanje najveće brojke po videu.
🎬 Napravili ste video o OmniRoute? Otvorite issue ili discussion sa linkom — istaknućemo ga ovde.
📧 Community & Help
Sve na jednom mestu — pratite održavatelja, ćaskajte sa zajednicom ili otvorite issue.
| Channel | Where / how |
|---|---|
| 💼 LinkedIn — pratite održavatelja | linkedin.com/in/diegosouzapw |
| 🐙 GitHub — pratite za izdanja i savete | @diegosouzapw |
| 💬 Discord | discord.gg/U47eFqAXCn |
| ✈️ Telegram | t.me/omnirouteOficial |
| 🟢 WhatsApp — 🌍 Globalno | pridružite se grupi |
| 🟢 WhatsApp — 🇧🇷 Brazil | pridružite se grupi |
| 🌍 Website | omniroute.online |
| 🌍 🌍StHub OmniRoute Community (free) | portal sthub |
| 📦 Source code | github.com/diegosouzapw/OmniRoute |
| 🐛 Prijavite grešku | otvorite issue — priložite izlaz npm run system-info |
| 🤝 Doprinesite | CONTRIBUTING.md · Branching & Release Model · odaberite good first issue |
| 💚 Podržite projekat | Načini podrške ↑ · GitHub Sponsors |
🛠️ Tehnički stek
| Sloj | Tehnologija |
|---|---|
| Runtime | Node.js 22.x / 24.x LTS — >=22.22.2 <23 || >=24.0.0 <27 |
| Jezik | TypeScript 6.0 — 100% TypeScript u okviru src/ i open-sse/ (nula any u jezgru od verzije v2.0) |
| Framework | Next.js 16 + React 19 + Tailwind CSS 4 |
| Baza podataka | better-sqlite3 (SQLite, WAL journaling) + LowDB (JSON legacy) — 122 domenska modula, 168 migracija |
| Memorija | SQLite FTS5 pretraga celog teksta + int8-kvantizovani vektorski embeddinzi, tipizirano opadanje (decay) |
| Šeme | Zod 4 — validacija MCP alata za ulaz/izlaz + API ugovori |
| Protokoli | MCP (stdio / HTTP / SSE) + A2A v0.3 (JSON-RPC 2.0 + SSE) |
| Striming | Server-Sent Events (SSE) + WebSocket mostovi (/v1/ws) |
| Kompresija | pipeline sa 12 mehanizama — RTK, Caveman, LLMLingua-2 (MobileBERT ONNX), GCF, OmniGlyph |
| Autentikacija i bezbednost | OAuth 2.0 (PKCE) + JWT + API ključevi + MCP autentikacija sa opsegom prava · AES-256-GCM u stanju mirovanja · DOMPurify |
| Prikrivanje (Stealth) | wreq-js — imitacija JA3 / JA4 TLS otiska, 3-nivoski proxy |
| Otpornost | Circuit breaker, eksponencijalno odlaganje, zaštita od „thundering herd“ efekta, auto-combo samoisceljenje |
| Logovanje | pino — strukturisani JSON logovi sa kontekstom zahteva |
| Testiranje | Node.js test runner + Vitest — preko 39.000 statičkih test deklaracija u okviru preko 5.100 praćenih test fajlova (unit, integracioni, E2E, bezbednosni, ekosistemski) |
| Platforme | Desktop (Electron) · Android (Termux) · PWA (bilo koji pretraživač) |
| CI/CD | GitHub Actions — automatsko objavljivanje na npm + Docker Hub prilikom izdanja |
| Linkovi | Sajt · npm · Docker Hub |
📖 Dokumentacija
📘 Prvi koraci
| Dokument | Opis |
|---|---|
| Korisnički vodič | Provajderi, kombinacije, CLI integracija, deployment |
| Vodič za podešavanje | Kompletne metode instalacije, konfiguracije CLI alata, podešavanje protokola, podešavanje timeout-a |
| Vodič za CLI alate | Podešavanje po alatu za Claude Code, Codex, Cursor, Cline, OpenClaw, Kilo, Copilot |
| Udaljeni mod | Upravljanje udaljenim OmniRoute-om (VPS) sa vašeg laptop CLI-a putem pristupnih tokena sa opsegom prava |
| Konfiguracija Claude Code | Usmerite Claude Code na OmniRoute (lokalno/udaljeno) uz launch + profile po modelu |
| Brzi start | Instalacija u 3 koraka → povezivanje → konfigurisanje |
🔧 Operacije i deployment
| Dokument | Opis |
|---|---|
| Docker vodič | Docker run, Compose profili, Caddy HTTPS, tuneli, tagovi imidža |
| Podman vodič | Quadlet systemd integracija, podman-compose, SELinux |
| VM deployment | Kompletan vodič: VM + nginx + Cloudflare podešavanje |
| Fly.io deployment | Deployment na Fly.io sa trajnim skladištem |
| Termux vodič | Pokretanje OmniRoute-a na Android-u putem Termux-a |
| PWA vodič | Instalacija Progressive Web App-a, keširanje, arhitektura |
| Vodič za deinstalaciju | Čisto uklanjanje za sve metode instalacije |
| Konfiguracija okruženja | Kompletne .env promenljive i referencе |
🧠 Funkcionalnosti i arhitektura
| Dokument | Opis |
|---|---|
| Arhitektura | Arhitektura sistema, protok podataka i unutrašnji mehanizmi |
| Vodič za kompresiju | Pipeline sa 7 opcija: off / lite / standard / aggressive / ultra / RTK / stacked |
| RTK kompresija | Kompresija izlaza komandi, filteri, poverenje, verifikacija, oporavak sirovog izlaza |
| Mehanizmi kompresije | Caveman, RTK, stacked pipeline-ovi, dashboard/API/MCP površine |
| Format pravila kompresije | JSON šeme paketa pravila za Caveman i RTK filtere |
| Jezički paketi za kompresiju | Detekcija jezika i pisanje Caveman paketa pravila |
| Vodič za otpornost | Circuit breaker-i, cooldown-ovi, red čekanja, zaštita od „thundering herd“ efekta, TLS spoofing |
| Auto-Combo mehanizam | Bodovanje sa 16 faktora, paketi režima, samoisceljenje |
| Proxy vodič | 3-nivoski proxy sistem, 1proxy marketplace, CRUD registra |
| Besplatni nivoi | Konsolidovani direktorijum: 38 dokumentovanih ponavljajućih poolova / 446 katalogizovanih unosa besplatnog nivoa |
| Galerija funkcionalnosti | Vizuelni pregled dashboard-a sa snimcima ekrana |
| Dokumentacija kodne baze | Vodič kroz kodnu bazu pogodan za početnike |
🤖 Protokoli i API-ji
| Dokument | Opis |
|---|---|
| API referenca | Svi endpointi sa primerima |
| OpenAPI specifikacija | OpenAPI 3.0 specifikacija |
| MCP server | 110 MCP alata, IDE konfiguracije, Python/TS/Go klijenti |
| Vodič za MCP server | Instalacija MCP-a, transportni protokoli i referenca alata |
| A2A server | JSON-RPC 2.0 protokol, sposobnosti (skills), streaming, upravljanje zadacima |
| Vodič za A2A server | A2A kartica agenta, zadaci, sposobnosti i streaming |
📋 Projekat i kvalitet
| Dokument | Opis |
|---|---|
| Doprinošenje | Podešavanje razvojnog okruženja i smernice |
| Model grananja i izdanja | Gde su usmereni PR-ovi (release/*), šta znače main i tagovi |
| Changelog | Kompletna istorija izdanja po verzijama |
| Bezbednosna politika | Prijavljivanje ranjivosti i bezbednosne praksе |
| Vodič za i18n | Podrška za 42 jezika, tok rada prevoda, RTL |
| Kontrolna lista za izdanje | Koraci validacije pre izdanja |
| Plan pokrivenosti testovima | Strategija test pokrivenosti za preko 39.000 statičkih test deklaracija u okviru preko 5.100 praćenih test fajlova |
⭐ Najistaknutiji doprinosioci
OmniRoute oblikuje strastvena open-source zajednica. Ovi pojedinci su dali izuzetne doprinose koji direktno utiču na kvalitet, stabilnost i domet projekta. Hvala vam.
Spoljni doprinosioci prema izvršenim (merged) pull request-ovima
| Rang | Doprinosilac | Izvršeni PR-ovi | ~Izmenjenih linija |
|---|---|---|---|
| 1 | backryun | 190 | 227.977 |
| 2 | oyi77 | 180 | 407.678 |
| 3 | rdself | 145 | 80.663 |
| 4 | JxnLexn | 128 | 387.049 |
| 5 | KooshaPari | 101 | 125.747 |
| 6 | herjarsa | 88 | 230.872 |
| 7 | RaviTharuma | 79 | 55.106 |
| 8 | maxmad64bis | 69 | 394.715 |
| 9 | artickc | 59 | 33.260 |
| 10 | HouMinXi | 51 | 47.334 |
| 10 | chirag127 | 51 | 5.153 |
| 12 | xz-dev | 50 | 245.976 |
| 13 | hartmark | 47 | 52.185 |
| 14 | rqzbeh | 39 | 143.181 |
| 15 | dhaern | 34 | 19.559 |
| 16 | Dingding-leo | 33 | 1.986 |
| 17 | NomenAK | 32 | 13.854 |
| 18 | MumuTW | 30 | 16.953 |
| 19 | benzntech | 29 | 11.641 |
| 20 | pacocartones | 24 | 9.331 |
| 20 | Prudhvivuda | 24 | 6.312 |
Zamrznuto na trenutnom vrhu granе release/v3.8.50, commit dafb4ae808, sa spajanjima do 2026-08-24 05:26:03 UTC. Paginirani GitHub GraphQL popis sadrži 5.911 spojenih PR-ova: 2.707 od vlasnika repozitorijuma, 179 od Dependabot-a, i 3.025 spoljnih PR-ova od 535 različitih doprinosilaca. „Izmenjene linije“ predstavljaju GitHub dodavanja + brisanja i uključuju generisane fajlove, lockfile-ove, kataloge, prevode i dokumentaciju; to je churn, a ne autorske linije koda (LOC). Nerešeni izjednačeni rezultati na graničnoj vrednosti su zadržani.
GitHub-pripisani commit-ovi
|
backryun 🥇 220 GitHub-pripisanih commit-ova |
Paijo 🥈 219 GitHub-pripisanih commit-ova |
Randi 🥉 108 GitHub-pripisanih commit-ova |
Ravi Tharuma 🏅 81 GitHub-pripisanih commit-ova |
Chris 🏅 70 GitHub-pripisanih commit-ova |
Markus Hartung 🏅 69 GitHub-pripisanih commit-ova · izjednačen na #6 |
|
Dizzle 🏅 69 GitHub-pripisanih commit-ova · izjednačen na #6 |
Jan Leon 🏅 64 GitHub-pripisanih commit-ova |
zenobit 🏅 62 GitHub-pripisanih commit-ova |
Bob.Hou 🏅 51 GitHub-pripisanih commit-ova · izjednačen na #10 |
Xiangzhe 🏅 51 GitHub-pripisanih commit-ova · izjednačen na #10 |
Ponovo provereno 2026-08-24 06:14:31 UTC: GitHub-pripisani commit-ovi koje prijavljuje Contributors API repozitorijuma za podrazumevanu granu release/v3.8.50. API je vratio 525 identiteta (415 korisnika, 2 bota, 108 anonimnih); ova tabela isključuje održavatelja, botove i anonimne identitete i zadržava izjednačene rezultate u konkurenciji. Ovo se razlikuje i od rangiranja po spojenim PR-ovima iznad, i od popisa Git metapodataka sa 639 osoba u nastavku.
🙏 Funkcionalnosti, ispravke grešaka i unapređenja infrastrukture ovih doprinosilaca su suštinski deo onoga što OmniRoute čini pouzdanim i bogatim funkcionalnostima. Svaki pull request, svaki test slučaj i svaki fajl prevoda za i18n je važan. Open source se izgrađuje od strane ljudi kao što su oni.
💖 Спонзори
Искрена захвалност људима који финансирају OmniRoute из свог џепа — сваки допринос чини да пројекат остане бесплатан, независан и да се даље развија.
![]() Andrew 💛 Активни месечни спонзор |
![]() Vlad I 💛 Активни месечни спонзор |
![]() Paco Cartones 💛 Активни једнократни спонзор |
![]() Проф. Igor Morais 💛 Ранији једнократни подржавалац |
![]() longtao 💛 Ранији једнократни подржавалац |
… и остали који желе да остану анонимни 💛
Јавни GitHub Sponsors поново проверени 2026-08-24. GitHub-ов статус activeOnly одређује горње ознаке активности; претходно обелодањени јавни једнократни подржаваоци и даље добијају захвалност, док приватни спонзори остају анонимни.
💖 Постани спонзор → — сваки долар помаже да OmniRoute остане бесплатан и независан.
👥 600+ Сарадника
Проверено 2026-08-24. на замрзнутој основи ac02c5b42f и поново проверено на живом врху release/v3.8.50 dafb4ae808: 639 нормализованих људских Git идентитета — 407 се појављује као аутори комита (укључујући одржаватеља) и 232 само у експлицитним Co-authored-by ознакама. Пописом се нормализују GitHub noreply надимци, искључује се 26 бот/агент/сервис/заменских идентитета, и обичне е-адресе се не спајају само зато што им се приказана имена подударају.
Како допринети
- Форкујте репозиторијум
- Направите грану од активног врха
release/vX.Y.Z(неmain) — погледајте Модел гранања и издавања - Направите вашу feature грану (
git checkout -b feat/amazing-feature) - Урадите commit ваших измена (
git commit -m 'feat: add amazing feature') - Гурните (push) грану (
git push origin feat/amazing-feature) - Отворите Pull Request са base = та
release/vX.Y.Zграна
Погледајте CONTRIBUTING.md за детаљна упутства.
Издавање нове верзије
# Направите издање — npm publish се дешава аутоматски
VERSION=x.y.z
gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes
📊 Статистика звездица
🙏 Захвалнице
OmniRoute стоји на плећима гигантâ. Настао је као форк 9router пројекта и TypeScript порт Go пројекта CLIProxyAPI — а од тог тренутка, сваки поднивоу описан испод инспирисан је отвореним пројектом који је стигао до тог решења пре нас. Сваки од њих је обликовао конкретан део OmniRoute-а. Ово је наше „хвала" свима њима. 🙏
⭐ број звездица провераван преко GitHub REST API-ја 24. августа 2026. — идите и дајте звездицу овим пројектима. Бројеви су снимак стања на одређени датум и природно ће се мењати.
🧬 Порекло и мрежни улаз (gateway)
| Пројекат | ⭐ | Како је инспирисао OmniRoute |
|---|---|---|
| 9router | 26,161 | Оригинални пројекат на коме је овај форк изграђен — овде проширен вишемедијалним API-јима и потпуном TypeScript преправком. |
| CLIProxyAPI | 48,497 | Go имплементација која је инспирисала овај JavaScript / TypeScript порт. |
| LiteLLM | 57,100 | AI мрежни улаз чији јавни скуп података о ценама храни нашу синхронизацију праћења трошкова и чији модел нормализације провајдера је обликовао наше рутирање. |
| codex-chatgpt-web | 1,410 | MIT изворни код прилагођен у уграђени мост ChatGPT Web → Codex Responses, укључујући адаптере за сесије прегледача, обликовање одговора, коришћење и веб-претрагу. |
| free-claude-code | 48,112 | Шаблони пренесени у опоравак стрима, алиасе без размишљања, резервну веб-претрагу, ограничења клизног прозора, редакцију логова и учврршене процесе покретања. |
| composer-api | 322 | Шаблони избора алата, ограничења излаза и потврде алата за Cursor Composer прилагођени у нативни Cursor извршитеља. |
| codex-multi-auth | 457 | Шаблони свежих пријава и ротације refresh токена пренесени у Codex OAuth поновну аутентикацију. |
| opencode-anthropic-auth | 510 | Подразумевани обрасци трансформације компатибилни са Claude Code и понашање наплатних заглавља генерализовани у OmniRoute-ов мост конфигуришан подешавањима. |
| grok2api-merged | 2 | Његова мапирања Grok модела, генератор лажног TypeError Statsig-а, подразумеваности захтева и уређаја, и NDJSON обрада одговора значајно су прилагођени у OmniRoute-ов Grok Web извршитеља. |
| TQZHR/grok2api | 705 | Главни транзитивни извор кода иза grok2api-merged; његове имплементације модела, заглавља, товара, Statsig-а и обраде задржане су у Grok Web лозивидности. |
| chenyme/grok2api | 7,520 | Основни MIT извор за подразумеваности Grok товара и уређаја, генератор Statsig-а, и обрада result.response пренете кроз TQZHR и grok2api-merged. |
| grok2api-pro | 27 | Транзитивни извор који grok2api-merged признаје за свој слој прокси базена; OmniRoute чува ту напомену о пореклу, али не тврди порт прокси базена у свом ограниченом Grok Web извршитељу. |
| GrokProxy | 50 | Његов колачићима-аутентификован Grok прокси и result.response.token образац стримовања обликовали су OmniRoute-ов Grok Web транспорт. |
| GrokBridge | 5 | Оригинална имплементација Grok Web-а консултовала се са његовим HTTP/browser upstream дизајном; њен директан HTTP пут потиче из GrokProxy, тако да се не тврди самостални порт кода. |
| grok-web-api | 14 | Његови Rust ChatOptions и шеме омотача одговора обликовали су OmniRoute-ове TypeScript типове захтева и стрим-одговора за Grok. |
🗜️ Компресија контекста и токена — механизми
| Пројекат | ⭐ | Како је инспирисао OmniRoute |
|---|---|---|
| Caveman | 100,538 | Виралан пројекат „зашто користити много токена када мало токена ради трик" — његова пећинско-говорна филозофија покреће наш стандардни режим компресије и 30+ правила за попуну/сажимање. |
| RTK – Rust Token Killer | 77,185 | Високоперформансна компресија излаза командне линије — инспирисала наш RTK механизам, DSL за JSON филтере, опоравак сировог излаза и наслаган RTK → Caveman канал. |
| headroom | 67,310 | Реверзибилна компресија контекста (SmartCrusher) — инспирисала наш механизам headroom и образац маркера за преузимање ccr. |
| LLMLingua | 6,598 | Истраживање компресије упита (LLMLingua / LLMLingua-2) — инспирисало наш асинхрони, безбедан за код, отвор ка неуспеху механизам llmlingua. |
| llmlingua-2-js | 31 | JS/ONNX порт (MobileBERT / XLM-RoBERTa) коришћен као позадина у worker нити за наш LLMLingua механизам. |
| Troglodita | 40 | Компресија токена за pt-BR — покреће наш пакет за pt-BR језик: редукцију плеоназама и уклањање попуна прилагођено граматици бразилског португалског. |
| ponytail | 108,957 | Виралан YAGNI-програмерски вештина „лењог сениор девелопера" — инспирисала наш излазни стил less-code: усмеравање ка најмањим радним изменама које смањује _генерисани_ код (излазни-осни близанац Caveman-ове сажете прозе). |
| i-have-adhd | 23,526 | Његов стил одговора усмерен на акцију, прилагођен за ADHD, прилагођен је у OmniRoute-ов концизни излазни стил на пет језика. |
🧩 Компактни формати, истраживање токена и алати свесни кода
| Пројекат | ⭐ | Како је инспирисао OmniRoute |
|---|---|---|
| TOON | 25,233 | Token-Oriented Object Notation — његов колонски модел заглавља-плюс-редова обликовао нашу фазу табеларне компакције. |
| GCF – Graph Compact Format | 41 | Његов компактан графички формат и дизајн генеричког профила обликовали OmniRoute-ову табеларну компакцију и формат кодека за Headroom. |
| gcf-typescript | 4 | MIT TypeScript имплементација директно уграђена и проширена као кодек генеричког профила за Headroom. |
| token-optimizer-mcp | 494 | Brotli/SQLite кеш + делта контекста по сесији — инспирисала наш механизам session-dedup. |
| token-savior | 1,122 | Компакција Bash излаза + MCP профили — инспирисала нашу дисциплину избацивања компресије и смањење MCP манифеста алата. |
| token-saver | 138 | Компресија излаза свесна садржаја, по типу фајла, са избацивањем свесним грешака — потврдила наше распоређивање по типу и прескок минималне добити. |
| token-optimizer | 1,951 | „Пронађи духове токене" — његов образац растовара + опоравив дршка инспирисао наше CCR размишљање о растовару. |
| TokenMizer | 28 | Нацрт графа сесије + дедупликације линија кроз обрте који је обликовао наш дизајн session-dedup. |
| OmniCompress | 3 | Rust колонски JSON + преузимање по адреси садржаја + дедупликација порука — потврдила дизајн наших механизама headroom/ccr/session-dedup и инваријанту „компримирани облик је независан од позиције" стабилну за кеш. |
| mcp-compressor | 113 | Компресија шеме/описа MCP алата — обликовала смањење кардиналности нашег MCP манифеста алата. |
| RepoMapper | 197 | Рангирање мапе репозиторијума у стилу Aider-а — обликовало наше истраживање мапе репозиторијума / рангирања за преузимање. |
| quiet-shell-mcp | 4 | Декларативна редукција излаза шкољке преко MCP — потврдила нашу декларативну компакцију bash излаза. |
| ts-morph | 6,162 | Комплет алата TypeScript Compiler API-ја — инспирисао наше уклањање коментара засновано на парсеру које чува string, template и regex литерале. |
🧠 Памћење и RAG
| Пројекат | ⭐ | Како је инспирисао OmniRoute |
|---|---|---|
| Mem0 | 63,902 | Универзалан слој памћења — његов модел прокси-као-граница-писања/читања обликовао нашу архитектуру памћења. |
| Letta (MemGPT) | 24,382 | Агенти са стањем и вишеслојним памћењем — инспирисали наш вишеслојни модел Context Control & Recovery (CCR). |
| WFGY | 1,781 | Таксономија ProblemMap 16 понављајућих RAG/LLM режима отказивања — заједнички вокабулар у нашем водичу за решавање проблема. |
🛰️ Инспекција саобраћаја, MITM и транспарентни прокси
| Пројекат | ⭐ | Како је инспирисао OmniRoute |
|---|---|---|
| llm-interceptor | 66 | MITM пресретање/анализа саобраћаја помоћник-за-кодирање ↔ LLM обликовала је ране захтеве за Traffic Inspector. Четири претходно изведена модула — спајање SSE, нормализација конверзација, маскирање тајних података и санитизација заглавља — замењена су независним имплементацијама изграђеним од нуле на основу јавних протокол стандарда. Две површине host-passthrough (passthrough.ts и _internal/bypass.cjs) остају OmniRoute-ове интерне имплементације класификоване независно; нису препрограмиране као део те замене. |
| ProxyBridge | 5,995 | Транспарентно рутирање прокси-ја по процесу — инспирисало наше сигурно-против-пада MITM растурање, време-мировања socket-а, атрибуцију процеса преко /proc и TPROXY захват. |
📚 Подаци о моделима, опсервабилност и кориснички интерфејс
| Пројекат | ⭐ | Како је инспирисао OmniRoute |
|---|---|---|
| models.dev | 6,555 | Отворена база података о спецификацијама, ценама и могућностима AI модела — синхронизована директно у наш каталог модела. |
| React Flow / xyflow | 38,108 | Библиотека графова засноване на чворовима која покреће наш Compression Studio у реалном времену и Combo/Routing Studio. |
| LangGraph | 40,314 | Визуализација живог графа радног тока из LangGraph Studio-а инспирисала наш приказ каскаде у реалном времену у Studios-у. |
| Langfuse | 33,592 | Његов модел опсервабилности трага → распона → генерисања обликовао наш водопад у Compression Studio-у. |
| Kiali | 3,631 | Опсервабилност Istio service-mesh-а — инспирисала наше значке прекидача струјног кола и визуале ивица грешака у Routing/Combo Studio-у. |
| lobe-icons | 2,428 | Логотипи AI/LLM брендова који приказују иконе провајдера на нашој контролној табли. |
| flag-icons | 12,354 | Обезбеђује MIT лицензиране SVG заставе које се користе у бирачу језика у README-у. |
🛡️ Безбедност
| Пројекат | ⭐ | Како је инспирисао OmniRoute |
|---|---|---|
| awesome-secure-defaults | 721 | Кустодисана листа безбедних по подразумеваности библиотека која усмерава наше безбедносне одлуке (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink). |
🧭 Комплементарни алати
| Пројекат | ⭐ | Како је инспирисао OmniRoute |
|---|---|---|
| ClawRouter | 6,564 | Инспирисало дедупликацију захтева, резервну реакцију нулте цене у хитним случајевима, укључиве Auto-Combo стратегије и вишејезичну класификацију намере. |
| Antigravity-Manager | 30,652 | Његово преусмеравање модела свесно налога, валидација путање извршне датотеке и понашање ознака плана обликовали OmniRoute-ов Antigravity runtime. |
| vscode-antigravity-cockpit | 4,817 | Његов компактан формат одбројавања ресета квоте инспирисао одговарајући приказ ограничења провајдера у OmniRoute-у. |
| AionUi | 32,230 | Његове ACP интеграције инспирисале OmniRoute-ово аутоматско откривање инсталираних CLI агента. |
| CodexBar | 20,507 | Идентификовало површину квоте за Grok Build; OmniRoute је затим независно провериo и исправио живи формат преноса. |
📄 Лиценца
MIT лиценца - погледајте LICENSE за детаље.
⬆ Назад на почетак · Направљено са ❤️ за заједницу отвореног кода у области вештачке интелигенције.
OmniRoute v3.8.51 · Node ≥22.22.2 · MIT License · omniroute.online





