> Ручно комбиновање бесплатних пакета је мучно — десетине SDK-ова, десетине ограничења брзине и никаква представа о томе колико заправо имате. OmniRoute каталогизује **489 ставки бесплатних пакета у оквиру 35 кључева периодичних пулова** и израчунава истакнути број токена на основу **17 пулова са објављеним позитивним месечним буџетом, уз пет Groq ограничења по моделу**, уз уклањање дупликата који припадају заједничком пулу. Квоте које постају доступне тек након регионалне провере идентитета (тренутно: ModelScope) приказане су одвојено, +~6M иза регионалне провере идентитета, и никада се не сабирају у истакнути број. Резултат остаје видљив на контролној табли (`/dashboard/free-tiers`).
> Анимирани сажетак активне странице `/dashboard/free-tiers`. Комплетна методологија (уклањање дупликата по пуловима, нивои кредита, услови добављача): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**.
>
> Ове бројке се поново проверавају сваке две недеље у односу на активни каталог и **мењају се у оба смера** — када добављач укине бесплатни пакет, број опада; када се појави нови, број расте. Објављујемо оно што каталог заиста израчунава, а никада заокружену навише најбољу могућу вредност.
⭐ Означите репозиторијум звездицом ако вам је OMNIROUTE помогао да уштедите новац и олакшате рад.
[](https://github.com/diegosouzapw/OmniRoute)
[](https://www.star-history.com/diegosouzapw/omniroute)
[](https://olud.ai/project/diegosouzapw-omniroute.html)
### 💬 Придружите се заједници
**👋 Пратите одржаваоца — први сазнајте за нове добављаче, издања и савете:**
[](https://www.linkedin.com/in/diegosouzapw/)
[](https://github.com/diegosouzapw)
[](https://discord.gg/U47eFqAXCn)
[](https://t.me/omnirouteOficial)
[](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4)
[](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4)
[](https://omniroute.online)
**Питања, савети о добављачима, план развоја и подршка → [Discord](https://discord.gg/U47eFqAXCn) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 Глобално](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) / [🇧🇷 Бразил](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) / [Портал](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK)**
## 📈 Мрежни пролаз наставља да расте
| | v3.8.49 | **v3.8.50** | `v3.8.51+` |
| --------------------------------------- | :-----: | :---------------------: | :--------: |
| 🌐 Провајдери | 290 | **357** | још у реду |
| 🧠 Јединствени ID-ови модела за ћаскање | 1185 | **1312** | — |
| 🖼️ Мост модалитета | — | 🆕 слика + звук + видео | — |
| 📡 Бесплатни Radar каталог | — | 🆕 уз пријављивање | — |
| ⚖️ Планирање према квоти | — | 🆕 Quota-Share | — |
| 📊 Телеметрија квоте | — | 🆕 уживо | — |
**→ [План развоја](ROADMAP.md) — на путу ка `v3.9.0 LTS`**
## 🆓 Radi čim ga instalirate — bez ključeva, bez konfiguracije
```bash
# Svježa instalacija, nula akreditiva — `auto` već radi:
curl http://localhost:20128/v1/chat/completions \
-H "Content-Type: application/json" \
-d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}'
```
Preferirate specifičan besplatan backend? Pozovite `oc/…` (OpenCode Free) direktno. Zatim pređite na `auto` i pustite OmniRoute da odabere.📦 Skripte za brzo pokretanje kopiraj-nalepi za **Python, Node.js, PHP i cURL** → [`examples/quickstart/`](examples/quickstart/)
# 💥 Obećanje
# 🤔 Zašto OmniRoute?
## 🤝 Podržano od strane naših prijatelja otvorenog koda
> **Želite da se pridružite kao prijatelj otvorenog koda?** Ovo su kompanije koje podržavaju otvoreni kod i pomažu OmniRoute-u da nastavi sa radom — i javno objavljujemo gde ide svaki token koji nam daju. Javite nam se: [diegosouza.pw@outlook.com](mailto:diegosouza.pw@outlook.com)
Kimi Moonshot AI
Zahvaljujući Kimi (Moonshot AI), našem osnivačkom prijatelju otvorenog koda, na podršci ovom projektu! Kimi je AI laboratorija koja stoji iza porodica modela otvorenog koda K2 i K3 — Kimi K3 pruža kontekstni prozor od 1M tokena, nativni vid i kodiranje na graničnom nivou po deliću cena zatvorenih modela, i radi odmah po instalaciji sa Claude Code, Codex-om i svakim alatom za kodiranje koji OmniRoute podržava.
Šta Kimi podrška omogućava: Kimi API krediti pokreću OmniRoute-ov AI-validirani proces izdavanja — faza *validacije spajanja koju pokreće Kimi K3* koja pregleda svaki pull request pre nego što bude objavljen — plus svakodnevni razvoj funkcija. Prvoklasna Kimi podrška se isporučuje na oba načina: direktni Kimi API (`kimi-k3`) i Kimi Code plan kodiranja (OAuth i API ključ). OmniRoute je takođe prvi brazilski open-source projekat u Kimi programu podrške. Nabavite Kimi API ključ sa 15% dodatnih kredita →
Cheaper Inference cheaperinference.com
Zahvaljujući Cheaper Inference, prijatelju otvorenog koda OmniRoute-a, na podršci ovom projektu! Cheaper Inference je gateway rangiran po ceni koji preprodaje 42 granična modela — Claude, GPT-5.x, Gemini, Kimi K3, GLM, DeepSeek, Grok i MiniMax — iza jedne OpenAI-kompatibilne krajnje tačke, rutirajući svaki zahtev najjeftinijem kvalifikovanom provajderu bez naplate iznad cene proizvođača modela.
Prvoklasna podrška u OmniRoute-u: Chat Completions, nativna `/v1/responses` krajnja tačka, vizija, pozivanje alata i 3 modela slika (`grok-imagine`, `nano-banana-pro`, `nano-banana-2`, dostupni kao `cheaperinference/`). Nabavite API ključ →
Linkovi označeni sa `aff=omniroute` su partnerski linkovi. Oni finansiraju projekat bez dodatnih troškova za vas. 🎟️ Partnerska promocija — besplatni kuponi za registraciju od provajdera koje ne sponzorišemo (kliknite za proširenje)Ovaj odeljak je samo za referalne/kuponske kodove. Sponzorisana partnerstva se nalaze u odeljku **🤝 Podržano od strane naših prijatelja otvorenog koda** iznad. OmniRoute nema sponzorstvo niti partnerstvo sa provajderima navedenim ovde — ovo su javni kuponi koje svako može koristiti.
AgentRouter agentrouter.org
AgentRouter — partnerska registracija · $100 besplatnih kredita pri registraciji (besplatan server, očekujte veću latenciju — najbolje za testiranje, ne za produkciju). Prvoklasna podrška u OmniRoute-u od v3.8.50: Chat Completions, Anthropic-kompatibilni format žice i OpenAI-kompatibilna putanja. Dostupni modeli uključuju `claude-opus-4-8`, `claude-opus-5`, `gpt-5.6-sol` i više. Zgrabite svojih $100 →
⚠️ Partnerski link — OmniRoute nema sponzorstvo niti partnerstvo sa ovim provajderom.
Znate li drugog provajdera sa izdašnim besplatnim kuponom za registraciju koji koristi korisnicima OmniRoute-a? Otvorite problem i dodaćemo ga ovde.
## 🎯 Комбо — Флагман
> **Комбо** је ланац модела кроз које 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`](docs/routing/AUTO-COMBO.md).
##
### 🧱 Отпорност је уграђена (3 независна слоја)
📖 [Auto-Combo Engine](docs/routing/AUTO-COMBO.md) · [Водич за отпорност](docs/architecture/RESILIENCE_GUIDE.md)
## 🏆 Šta izdvaja OmniRoute
📊 Kompletna metodologija & detalji po funkciji u poređenju sa 9router, OpenRouter, CLIProxyAPI & LiteLLM → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)
## 💚 Подржите OmniRoute
OmniRoute је лиценциран под MIT лиценцом и одржаван је отворено. Ако вам штеди време или новац, ево како можете помоћи да остане независан — изаберите оно што вама одговара. Спонзорство никада не утиче на приоритет рутирања; купује видљивост, а не рангирање.
**🇧🇷 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](https://github.com/diegosouzapw/OmniRoute/discussions).
Напомене за развојне тимове: Пројекат може генерисати локалну .env датотеку током npm install/postinstall процеса ради лакшег рада развојних тимова. Ова датотека је намерно игнорисана путем .gitignore (погледајте .gitignore) и никада не сме бити комитована — уколико се случајно комитује, ротирајте све изложене тајне податке и уклоните датотеку из историје. Погледајте docs/DEVELOPER-ENVIRONMENT.md за упутства о управљању локалним датотекама окружења и тајним подацима.
## 📡 OmniRoute Radar
Главна процена за бесплатни ниво остаје **~1.62B токена месечно** на основу изнад документованог каталога из којег су уклоњена преклапања између обједињених квота. Привремени кредити за регистрацију код провајдера могу засебно повећати количину у првом месецу на **~2.22B**. Radar је опциони, потписани слој каталога за кориснике који желе ажурнију доступност бесплатних модела између OmniRoute издања; каталог заједнице и све постојеће бесплатне функције остају бесплатни.
Подржаваоци могу добити каталог уживо и додатне могућности код провајдера. Његов засебни, променљиви максимум износи **приближно највише 3B токена месечно**, у зависности од доступности провајдера. Тај максимум није загарантован: провајдери у сваком тренутку могу да промене квоте, услове подобности, моделе или регионе.
Radar се користи само уз изричиту сагласност и подржава искључиво GET захтеве. OmniRoute клијент не отпрема упите, саобраћај, конфигурацију провајдера, телеметрију коришћења нити локално стање одбачених обавештења. Сазнајте више о условима подобности и актуелном каталогу на **[radar.omniroute.online/planos](https://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`](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](docs/frameworks/A2A-SERVER.md)
- **🛂 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](docs/architecture/RESILIENCE_GUIDE.md)
- **🗂️ Kanonsko `/v1/models` uređivanje** — jedan kontinuirani blok grupisan po provajderu za svakog provajdera (kombinacije su prve fiksirane), stabilno kroz svaki izvor kataloga. → [API Reference](docs/reference/API_REFERENCE.md)
- **🗜️ 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](docs/compression/COMPRESSION_ENGINES.md)
- **💸 Iskrena fiksna cena** — provajderi sa pretplatom / coding-plan pokazuju **$0** u analitici troškova; budžet, kvota i rutiranje nastavljaju sa procenom. → [API Reference](docs/reference/API_REFERENCE.md)
- **⚖️ 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](docs/architecture/RESILIENCE_GUIDE.md)
- **🤖 Podešavanje CLI/agenta jednom komandom** — 13 registrovanih `setup-*` komandi; `omniroute run` pokreće 7 CLI alata (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); `omniroute configure` podržava 10 ciljeva sa interaktivnim izborom provajdera+modela i omiljenim postavkama po kontekstu. → [CLI Integrations](docs/guides/CLI-INTEGRATIONS.md)
- **🛰️ Udaljeni režim (Remote mode)** — upravljajte udaljenim OmniRoute-om preko tokena sa ograničenim opsegom (`connect` / `contexts` / `tokens`) + `antigravity` OAuth pomoćnik za VPS instalacije. → [Remote Mode](docs/guides/REMOTE-MODE.md)
- **🧭 Pametnije auto-rutiranje** — `auto/:` kombinacije, **Fusion** (panel modela + sudija), rutiranje svesno zadatka, izmene po zahtevu za model / mod / USD-budžet. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🗜️ 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](docs/compression/COMPRESSION_ENGINES.md)
- **🕵️ Transparentna MITM dekripcija (TPROXY)** — hvatanje CLI alata koji ignorišu proxy env varijable, uz CA po SNI + instalater za trust-store. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md)
- **💸 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](docs/reference/API_REFERENCE.md)
- **🧠 Memorija koju kontrolišete** — podrazumevano isključena, opciona int8 vektorska kvantizacija + tipizovano opadanje (decay), po-zahtevni `x-omniroute-no-memory`. → [Memory](docs/frameworks/MEMORY.md)
- **🛡️ 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](docs/security/GUARDRAILS.md)
- **🖼️ Novi endpointi** — `/v1/ocr` (Mistral OCR) i `/v1/audio/translations` (u stilu Whisper-a) upotpunjuju medijsku površinu. → [API Reference](docs/reference/API_REFERENCE.md)
- **🎨 Generisanje slika / videa / zvuka** — jedan API za medije: xAI Grok Imagine i Novita AI video, ComfyUI, Magnific, Adobe Firefly, Segmind, i govorni provajderi kao ElevenLabs. → [API Reference](docs/reference/API_REFERENCE.md)
- **🌍 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](docs/reference/ENVIRONMENT.md)
- **🤝 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](docs/reference/PROVIDER_REFERENCE.md)
- **📡 Transparentnost rutiranja** — svaki odgovor nosi zaglavlje `X-OmniRoute-Decision` koje navodi strategiju/provajdera/kašnjenje koje je opsluživalo zahtev, nova `cache-optimized` strategija kombinacije + Auto-Combo faktor `cacheAffinity` usmerava ponovljene zahteve nazad na konekciju koja sadrži keširani prefiks, a endpoint samo za čitanje `/v1/auto-combo/{channel}/candidates` izlaže živi bazen kandidata za `auto/*` kanal. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **⚡ 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](docs/frameworks/EMBEDDED-SERVICES.md)
- **🧩 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/chaos` ubacivanje grešaka (fault injection), Telegram bot most, ugrađeni menadžer verzija u aplikaciji i LMArena-ELO rangiranje besplatnih provajdera. → [Docs](docs/README.md)
## 🤖 Компатибилни CLI-јеви и агенти за програмирање
> Једна конфигурација — `http://localhost:20128/v1` — и **сваки** AI IDE или CLI ради на бесплатним и повољним моделима.
＋ такође ради са · Agent Deck · Kiro · Command Code · Antigravity · Windsurf · AMP · било којим алатом компатибилним са OpenAI-јем
📖 Подешавање по алату за свих 36 алата (26 CLI алата за кодирање + 10 CLI агената) → [`docs/reference/CLI-TOOLS.md`](docs/reference/CLI-TOOLS.md) · 🧩 OpenCode додатак → [`@omniroute/opencode-provider`](https://www.npmjs.com/package/@omniroute/opencode-provider)
**Покрените било који подржани CLI преко OmniRoute-а једном командом** — без уписивања конфигурационих датотека,
акредитиви се убацују засебно за сваки процес, а Qwen/Gemini добијају привремени изоловани матични директоријум:
```bash
omniroute run claude --model openai/gpt-5.4 # Claude Code
omniroute run codex --model glm/glm-5.2 # OpenAI Codex CLI
omniroute run aider --model glm/glm-5.2 -- --message "reply OK"
omniroute run goose --model glm/glm-5.2
omniroute run opencode --model glm/glm-5.2 -- run "reply OK"
omniroute run qwen --model glm/glm-5.2 -- -p "reply OK"
omniroute run gemini --model glm/glm-5.2 -- --skip-trust -p "reply OK"
# Или интерактивно изаберите добављача+модел и упишите сопствену конфигурацију алата:
omniroute configure codex # такође: claude opencode qwen aider goose gemini cline continue kilo
```
Свака команда поштује активни удаљени контекст (`omniroute connect `), `--dry-run`
приказује тачне променљиве окружења/аргументе без извршавања, а `--api-key-env NAME` спречава да тајне
доспеју у историју ваше љуске. → [CLI интеграције](docs/guides/CLI-INTEGRATIONS.md)
## 🌐 357 добављача AI услуга — 152 означена у каталогу као бесплатна
> **357 регистрованих добављача** у канонским колекцијама за ћаскање, медије, претрагу, локалне услуге, агенте у облаку и системске услуге, укључујући **152 са метаподацима за откривање `hasFree: true`**. Регистар модела за ћаскање обухвата **229 добављача / 2.554 различита пара добављач–модел / 1.283 необрађена ID-а модела**; засебни каталог бесплатних квота садржи **491 ред по моделу**, **35 периодично обновљивих скупова** и **54 периодично обновљива/трајно бесплатна добављача без кључа**. Ови имениоци се намерно разликују; дефиниције и прорачуни са уклоњеним дупликатима скупова налазе се у документима [Референца добављача](docs/reference/PROVIDER_REFERENCE.md) и [Бесплатни нивои](docs/reference/FREE_TIERS.md).
### 🏢 Свака велика лабораторија — преко једне приступне тачке
OpenAI
Anthropic
Gemini
xAI Grok
DeepSeek
Mistral
Qwen
Meta Llama
Groq
NVIDIA
MiniMax
Cohere
Perplexity
HuggingFace
Together
Fireworks
Cloudflare
Baidu
…и још преко 330 — свака икона се уживо учитава из каталога добављача на контролној табли. 📖 [Референца добављача](docs/reference/PROVIDER_REFERENCE.md)
### 🆓 Заувек бесплатно — $0, без картице
OpenCode Zen DeepSeek V4, Nemotron 3 Без ограничења броја токена
Kilo Code Аутоматско усмеравање, Tencent Hy3 Бесплатно заувек
Requesty GPT-OSS 120B, Nemotron Бесплатно заувек
SiliconFlow DeepSeek V3.2 / R1 Бесплатни ниво
Z.AI GLM GLM-4.7 / 4.5-Flash Бесплатно заувек
Baidu ERNIE ERNIE 4.0 Бесплатно заувек
Qoder AI Qwen3-Max, Kimi-K2 НЕОГРАНИЧЕНО БЕСПЛАТНО
Pollinations GPT, Llama, Claude Кључ није потребан
### 🧩 Ново: OmniRoute унутар VS Code-овог native Copilot Chat-а
> Нема нове бочне траке, нема новог chat интерфејса — сваки модел који OmniRoute сервира појављује се
> директно у **Copilot Chat бирачу модела који већ користите**. Од VS Code 1.122, provider модели раде
> без GitHub пријаве или Copilot претплате — agent режим, позивање алата и vision, потпуно
> бесплатно.
Инсталирајте **[OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)** екстензију, усмерите је
на ваш OmniRoute сервер (подразумевано `localhost:20128`), затим отворите Copilot Chat → бирач модела
→ **Manage Models…** → **OmniRoute**.
Из самог уређивача: отворите преглед **Extensions**, потражите **"OmniRoute"**, кликните **Install**
— ради на исти начин у обе продавнице. Извор, проблеми и упутство за објављивање налазе се на
[diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot).
📖 [VS Code Copilot Chat водич](docs/guides/VSCODE-COPILOT.md) — подешавање, шта бирач приказује, dashboard-in-a-tab, решавање проблема
> 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`)
```bash
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.
```bash
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](docs/guides/REMOTE-MODE.md)
### 🤝 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
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
```bash
# 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](docs/frameworks/MCP-SERVER.md) · [A2A Server](docs/frameworks/A2A-SERVER.md) · [Protokoli agenata](docs/frameworks/AGENT_PROTOCOLS_GUIDE.md)
## 🗜️ Уштедите 15–95% токена — аутоматски
### 📖 Како то функционише — pipeline, архитектура и математика уштеде
Podrazumevana naslagana kombinacija radi `RTK → Caveman`. Kada oba deluju na isti tool/kontekst payload, uštede se kombinuju:
```txt
combined = 1 − (1 − RTK) × (1 − Caveman_input)
average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range = 78.4 – 94.6%
```
Blokovi kôda, URL-ovi, JSON i strukturirani podaci su **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](https://github.com/rtk-ai/rtk), [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ 90K+), [LLMLingua-2](https://github.com/microsoft/LLMLingua) i [Troglodita](https://github.com/leninejunior/troglodita) (PT-BR).
### 🧱 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)
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](https://github.com/leninejunior/troglodita) mod:**
> **Antes (42 tokena):** _"O problema é que o componente está re-renderizando porque uma nova referência de objeto está sendo criada em cada ciclo de renderização. Eu recomendaria usar useMemo."_
>
> **Depois (12 tokena):** _"Re-render: ref nova cada ciclo (objeto inline recriado). Usar `useMemo`."_
>
> **Mesma resposta. ~70% menos tokens. Precisão técnica intacta.** ✅
### 🎚️ 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-compression` po zahtevu › override po routing kombinaciji › aktivni imenovani profil › adaptivno / auto-trigger › podrazumevano iz panela › off. Primenjeni plan se vraća u zaglavlju odgovora `X-OmniRoute-Compression: ; 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`](docs/compression/COMPRESSION_GUIDE.md) · [`RTK_COMPRESSION.md`](docs/compression/RTK_COMPRESSION.md) · [`COMPRESSION_ENGINES.md`](docs/compression/COMPRESSION_ENGINES.md)
# ⚡ Brzi početak
**1) Instalirajte i pokrenite**
```bash
npm install -g omniroute
omniroute
```
> 💡 Vidite `npm warn ERESOLVE` ili upozorenja o peer-dep? [To je bezopasno](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated).
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**
```txt
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**
```bash
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:
```txt
OpenAI catalog: http://localhost:20128/vscode/YOUR_KEY/
OpenAI models: http://localhost:20128/vscode/YOUR_KEY/models
OpenAI chat: http://localhost:20128/vscode/YOUR_KEY/chat/completions
OpenAI responses: http://localhost:20128/vscode/YOUR_KEY/responses
Ollama chat: http://localhost:20128/vscode/YOUR_KEY/api/chat
Ollama tags: http://localhost:20128/vscode/YOUR_KEY/api/tags
```
Koristite ove samo za klijente koji ne mogu da prilože `Authorization: Bearer ...`. Autentikacija putem zaglavlja ostaje preporučeni mod.
## 📦 Још начина инсталације — Docker, извор, pnpm, Arch
**🐳 Docker**
```bash
docker run -d --name omniroute --restart unless-stopped --stop-timeout 40 \
-p 127.0.0.1:20128:20128 -v omniroute-data:/app/data diegosouzapw/omniroute:latest
```
`:latest` пратi највишу **објављену** стабилну SemVer верзију. Не прати git `main` грану. Закачите `:X.Y.Z` за GitOps. Погледајте [Docker Release Channels](docs/guides/DOCKER_GUIDE.md#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 |
```bash
docker run -d --name omniroute --restart unless-stopped --stop-timeout 40 \
-e OMNIROUTE_MEMORY_MB=8192 --memory=10g \
-p 127.0.0.1:20128:20128 -v omniroute-data:/app/data diegosouzapw/omniroute:latest
```
Комплетна табела: [Docker Guide — runtime RAM](docs/guides/DOCKER_GUIDE.md#runtime-ram-for-coding-agents).
> **Docker канал за пре-издања:** `diegosouzapw/omniroute:next` и
> `diegosouzapw/omniroute:next-web` прате тренутну подразумевану `release/v*`
> грану. Ове променљиве ознаке су намењене само за тестирање необјављених исправки и
> **нису подржане за производно окружење**. Погледајте
> [Docker Release Channels](docs/guides/DOCKER_GUIDE.md#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 .`).
```bash
# Инсталирај и покрени са Bun-ом
bun install
bun run dev
```
**🛠️ Из извора**
```bash
cp .env.example .env && npm install
PORT=20128 npm run dev
```
**📦 pnpm**
```bash
pnpm add -g omniroute@latest --allow-build=better-sqlite3 --allow-build=@swc/core && omniroute
```
**🐧 Arch Linux (AUR)**
```bash
yay -S omniroute-bin && systemctl --user enable --now omniroute.service
```
**🔧 Nix (Flake)**
```bash
# Коришћење Nix flakes
nix develop
npm run dev
# Или коришћење devbox
devbox run npm run dev
```
📖 [Docker Guide](docs/guides/DOCKER_GUIDE.md) — Compose профили, Caddy HTTPS, Cloudflare тунели.
**🦭 Podman**
```bash
# 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` и
пратите [упутства за директоријум података специфична за топологију](contrib/podman/README.md#data-directory-permissions-by-topology).
📖 [Podman Guide](contrib/podman/README.md) — Compose градње, Podman Machine, и
Linux/systemd Quadlet постављање.
**⚡ Бржа / лакша инсталација (заобиђите native градњу)**
Native SQLite мотор (`better-sqlite3`) је **опциона** зависност, тако да глобална
инсталација никада не блокира на компилацији из извора: користи преизграђену binary датотеку када постоји подударање
за вашу платформу/Node, а иначе транспарентно прелази на чисто JS мотор
(`node:sqlite` на Node 22+, у супротном приложени `sql.js` WASM) — нису потребни алати за градњу.
Да бисте потпуно прескочили native загревање након инсталације (CI, headless, или спори рачунари):
```bash
OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute # CI=1 такође то прескаче
```
За најбрже инсталације преферирајте **pnpm** (складиште адресирано по садржају + hard link-ови — погледајте изнад).
За headless окружење без контролне табле користите Docker `base` профил (изнад) или
[Termux упутство](docs/guides/TERMUX_GUIDE.md). CLI и веб контролна табла се сервирају истим
процесом на једном порту, тако да тренутно не постоји засебан CLI-only пакет.
Стратегија покривености тестовима за више од 39.000 статичких декларација тестова у више од 5.100 праћених датотека тестова
# ⭐ Најбољи сарадници
> OmniRoute обликује посвећена заједница отвореног кода. Ови појединци су дали изузетне доприносе који непосредно утичу на квалитет, стабилност и досег пројекта. **Хвала вам.**
### Спољни сарадници према броју спојених захтева за измене
Стање је замрзнуто на врху активне гране release/v3.8.50, на комиту dafb4ae808, са спајањима закључно са 2026-08-24 05:26:03 UTC. Страничени GitHub GraphQL попис садржи 5.911 спојених PR-ова: 2.707 од власника репозиторијума, 179 од Dependabot-а и 3.025 спољних PR-ова од 535 различитих сарадника. „Измењени редови” представљају збир додавања и брисања на GitHub-у и обухватају генерисане датотеке, датотеке за закључавање верзија, каталоге, преводе и документацију; то је мера обима измена, а не број ауторских линија кода. Изједначења на граници су задржана.
### Комитови приписани на GitHub-у
Bob.Hou 🏅 51 комит приписан на GitHub-у · дели 10. место
Xiangzhe 🏅 51 комит приписан на GitHub-у · дели 10. место
Поново проверено 2026-08-24 06:14:31 UTC: комитови приписани на GitHub-у, које је API за сараднике репозиторијума пријавио за подразумевану грану release/v3.8.50. API је вратио 525 идентитета (415 корисника, 2 бота, 108 анонимних); ова табела изоставља одржаваоца, ботове и анонимне идентитете и задржава деобе места. Она се разликује и од горенаведеног рангирања спојених PR-ова и од доленаведеног пописа 639 особа на основу Git метаподатака.
> 🙏 Функционалности, исправке грешака и побољшања инфраструктуре ових сарадника представљају **суштински део** онога што OmniRoute чини поузданим и богатим функционалностима. Сваки захтев за спајање, сваки тестни случај и свака i18n преводна датотека су важни. Софтвер отвореног кода граде људи попут њих.
---
## 💖 Спонзори
Искрена захвалност људима који финансирају OmniRoute из свог џепа — сваки допринос чини да пројекат остане бесплатан, независан и да се даље развија.
… и остали који желе да остану анонимни 💛Јавни GitHub Sponsors поново проверени 2026-08-24. GitHub-ов статус activeOnly одређује горње ознаке активности; претходно обелодањени јавни једнократни подржаваоци и даље добијају захвалност, док приватни спонзори остају анонимни.💖 Постани спонзор → — сваки долар помаже да OmniRoute остане бесплатан и независан.
## 👥 600+ Сарадника
[](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
Проверено 2026-08-24. на замрзнутој основи ac02c5b42f и поново проверено на живом врху release/v3.8.50dafb4ae808: 639 нормализованих људских Git идентитета — 407 се појављује као аутори комита (укључујући одржаватеља) и 232 само у експлицитним Co-authored-by ознакама. Пописом се нормализују GitHub noreply надимци, искључује се 26 бот/агент/сервис/заменских идентитета, и обичне е-адресе се не спајају само зато што им се приказана имена подударају.
### Како допринети
1. Форкујте репозиторијум
2. Направите грану од **активног** врха `release/vX.Y.Z` (не `main`) — погледајте [Модел гранања и издавања](docs/ops/BRANCHING_MODEL.md)
3. Направите вашу feature грану (`git checkout -b feat/amazing-feature`)
4. Урадите commit ваших измена (`git commit -m 'feat: add amazing feature'`)
5. Гурните (push) грану (`git push origin feat/amazing-feature`)
6. Отворите Pull Request са **base = та `release/vX.Y.Z` грана**
Погледајте [CONTRIBUTING.md](CONTRIBUTING.md) за детаљна упутства.
### Издавање нове верзије
```bash
# Направите издање — npm publish се дешава аутоматски
VERSION=x.y.z
gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes
```
## 📊 Звездице
## 🌍 StarMapper
## 🙏 Захвалнице
OmniRoute стоји на плећима гигантâ. Настао је као форк **[9router](https://github.com/decolua/9router)** пројекта и TypeScript порт Go пројекта **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** — а од тог тренутка, сваки поднивоу описан испод инспирисан је отвореним пројектом који је стигао до тог решења пре нас. Сваки од њих је обликовао конкретан део OmniRoute-а. Ово је наше „хвала" свима њима. 🙏
> ⭐ број звездица провераван преко GitHub REST API-ја 24. августа 2026. — идите и дајте звездицу овим пројектима. Бројеви су снимак стања на одређени датум и природно ће се мењати.
### 🧬 Порекло и мрежни улаз (gateway)
AI мрежни улаз чији јавни скуп података о ценама храни нашу синхронизацију праћења трошкова и чији модел нормализације провајдера је обликовао наше рутирање.
MIT изворни код прилагођен у уграђени мост ChatGPT Web → Codex Responses, укључујући адаптере за сесије прегледача, обликовање одговора, коришћење и веб-претрагу.
Подразумевани обрасци трансформације компатибилни са Claude Code и понашање наплатних заглавља генерализовани у OmniRoute-ов мост конфигуришан подешавањима.
Његова мапирања Grok модела, генератор лажног TypeError Statsig-а, подразумеваности захтева и уређаја, и NDJSON обрада одговора значајно су прилагођени у OmniRoute-ов Grok Web извршитеља.
Главни транзитивни извор кода иза grok2api-merged; његове имплементације модела, заглавља, товара, Statsig-а и обраде задржане су у Grok Web лозивидности.
Транзитивни извор који grok2api-merged признаје за свој слој прокси базена; OmniRoute чува ту напомену о пореклу, али не тврди порт прокси базена у свом ограниченом Grok Web извршитељу.
Оригинална имплементација Grok Web-а консултовала се са његовим HTTP/browser upstream дизајном; њен директан HTTP пут потиче из GrokProxy, тако да се не тврди самостални порт кода.
Виралан пројекат „зашто користити много токена када мало токена ради трик" — његова пећинско-говорна филозофија покреће наш стандардни режим компресије и 30+ правила за попуну/сажимање.
Rust колонски JSON + преузимање по адреси садржаја + дедупликација порука — потврдила дизајн наших механизама headroom/ccr/session-dedup и инваријанту „компримирани облик је независан од позиције" стабилну за кеш.
MITM пресретање/анализа саобраћаја помоћник-за-кодирање ↔ LLM обликовала је ране захтеве за Traffic Inspector. Четири претходно изведена модула — спајање SSE, нормализација конверзација, маскирање тајних података и санитизација заглавља — замењена су независним имплементацијама изграђеним од нуле на основу јавних протокол стандарда. Две површине host-passthrough (passthrough.ts и _internal/bypass.cjs) остају OmniRoute-ове интерне имплементације класификоване независно; нису препрограмиране као део те замене.
Транспарентно рутирање прокси-ја по процесу — инспирисало наше сигурно-против-пада MITM растурање, време-мировања socket-а, атрибуцију процеса преко /proc и TPROXY захват.
### 📚 Подаци о моделима, опсервабилност и кориснички интерфејс
Кустодисана листа безбедних по подразумеваности библиотека која усмерава наше безбедносне одлуке (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).
Идентификовало површину квоте за Grok Build; OmniRoute је затим независно провериo и исправио живи формат преноса.
## 📄 Лиценца
MIT лиценца - погледајте [LICENSE](LICENSE) за детаље.
---
**[⬆ Назад на почетак](#-omniroute)** · Направљено са ❤️ за заједницу отвореног кода у области вештачке интелигенције.
OmniRoute v3.8.51 · Node ≥22.22.2 · MIT License · omniroute.online
> Анимирани сажетак активне странице `/dashboard/free-tiers`. Комплетна методологија (уклањање дупликата по пуловима, нивои кредита, услови добављача): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**.
>
> Ове бројке се поново проверавају сваке две недеље у односу на активни каталог и **мењају се у оба смера** — када добављач укине бесплатни пакет, број опада; када се појави нови, број расте. Објављујемо оно што каталог заиста израчунава, а никада заокружену навише најбољу могућу вредност.
```bash
# Svježa instalacija, nula akreditiva — `auto` već radi:
curl http://localhost:20128/v1/chat/completions \
-H "Content-Type: application/json" \
-d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}'
```
Preferirate specifičan besplatan backend? Pozovite `oc/…` (OpenCode Free) direktno. Zatim pređite na `auto` i pustite OmniRoute da odabere.
📦 Skripte za brzo pokretanje kopiraj-nalepi za **Python, Node.js, PHP i cURL** → [`examples/quickstart/`](examples/quickstart/)
> **Комбо** је ланац модела кроз које OmniRoute рутира **аутоматски**. Ако квота истекне, провајдер откаже или трошкови скоче, комбо може прећи на следећи погодан здрав модел. 🛡️
### ⚡ Без конфигурације — само користите `auto`
Нема потребе да правите комбо. Поставите модел на `auto` (или неку варијанту) и OmniRoute гради виртуелни комбо од ваших повезаних провајдера, оцењен у реалном времену:
📖 [Auto-Combo Engine](docs/routing/AUTO-COMBO.md) · [Водич за отпорност](docs/architecture/RESILIENCE_GUIDE.md)
📊 Kompletna metodologija & detalji po funkciji u poređenju sa 9router, OpenRouter, CLIProxyAPI & LiteLLM → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)
Кључ (насумичан): `5d865059-bc44-483a-962d-43ceb80126eb`
Pix copia-e-cola:
```
00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD
```
📖 [Autorizacija](docs/architecture/AUTHZ_GUIDE.md) · [Ograde (Guardrails)](docs/security/GUARDRAILS.md) · [Usklađenost](docs/security/COMPLIANCE.md)
Podrazumevana naslagana kombinacija radi `RTK → Caveman`. Kada oba deluju na isti tool/kontekst payload, uštede se kombinuju:
```txt
combined = 1 − (1 − RTK) × (1 − Caveman_input)
average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range = 78.4 – 94.6%
```
Blokovi kôda, URL-ovi, JSON i strukturirani podaci su **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](https://github.com/rtk-ai/rtk), [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ 90K+), [LLMLingua-2](https://github.com/microsoft/LLMLingua) i [Troglodita](https://github.com/leninejunior/troglodita) (PT-BR).
### 🧱 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:
