# README (Српски) 🌐 **Languages:** 🇺🇸 [English](../../../README.md) · 🇸🇦 [ar](../ar/README.md) · 🇦🇿 [az](../az/README.md) · 🇧🇬 [bg](../bg/README.md) · 🇧🇩 [bn](../bn/README.md) · 🇨🇿 [cs](../cs/README.md) · 🇩🇰 [da](../da/README.md) · 🇩🇪 [de](../de/README.md) · 🇬🇷 [el](../el/README.md) · 🇪🇸 [es](../es/README.md) · 🇪🇪 [et](../et/README.md) · 🇮🇷 [fa](../fa/README.md) · 🇫🇮 [fi](../fi/README.md) · 🇫🇷 [fr](../fr/README.md) · 🇮🇪 [ga](../ga/README.md) · 🇮🇳 [gu](../gu/README.md) · 🇮🇱 [he](../he/README.md) · 🇮🇳 [hi](../hi/README.md) · 🇭🇷 [hr](../hr/README.md) · 🇭🇺 [hu](../hu/README.md) · 🇮🇩 [id](../id/README.md) · 🇮🇹 [it](../it/README.md) · 🇯🇵 [ja](../ja/README.md) · 🇰🇷 [ko](../ko/README.md) · 🇱🇹 [lt](../lt/README.md) · 🇱🇻 [lv](../lv/README.md) · 🇮🇳 [mr](../mr/README.md) · 🇲🇾 [ms](../ms/README.md) · 🇲🇹 [mt](../mt/README.md) · 🇳🇱 [nl](../nl/README.md) · 🇳🇴 [no](../no/README.md) · 🇵🇭 [phi](../phi/README.md) · 🇵🇱 [pl](../pl/README.md) · 🇵🇹 [pt](../pt/README.md) · 🇧🇷 [pt-BR](../pt-BR/README.md) · 🇷🇴 [ro](../ro/README.md) · 🇷🇺 [ru](../ru/README.md) · 🇸🇰 [sk](../sk/README.md) · 🇸🇮 [sl](../sl/README.md) · 🇸🇪 [sv](../sv/README.md) · 🇰🇪 [sw](../sw/README.md) · 🇮🇳 [ta](../ta/README.md) · 🇮🇳 [te](../te/README.md) · 🇹🇭 [th](../th/README.md) · 🇹🇷 [tr](../tr/README.md) · 🇺🇦 [uk-UA](../uk-UA/README.md) · 🇵🇰 [ur](../ur/README.md) · 🇻🇳 [vi](../vi/README.md) · 🇨🇳 [zh-CN](../zh-CN/README.md) · 🇹🇼 [zh-TW](../zh-TW/README.md) ---

# 🚀 OmniRoute — Besplatni AI Gateway OmniRoute — Never stop coding. Every AI tool → 355 providers — 150+ free — through one endpoint. Claude Code, Codex, Cursor, Cline, Copilot & Antigravity into FREE Claude / GPT / Gemini with auto-fallback. RTK + Caveman stacked compression saves 15–95% tokens (~89% avg) — never hit limits. 355 AI providers · 150+ free tiers · ~1.51B free tokens/mo · 19 routing strategies · $0 to start.

OmniRoute — Never stop coding. Every AI tool → 355 providers — 150+ free — through one endpoint. Claude Code, Codex, Cursor, Cline, Copilot & Antigravity into FREE Claude / GPT / Gemini with auto-fallback. RTK + Caveman stacked compression saves 15–95% tokens (~89% avg) — never hit limits. 355 AI providers · 150+ free tiers · ~1.51B free tokens/mo · 19 routing strategies · $0 to start.

## 💰 ~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](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.

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

[![Star History Rank](https://api.star-history.com/badge?repo=diegosouzapw/OmniRoute&theme=dark)](https://www.star-history.com/diegosouzapw/omniroute) [![olud.ai](https://olud.ai/badge.php?tool=diegosouzapw-omniroute)](https://olud.ai/project/diegosouzapw-omniroute.html) ### 💬 Priključite se zajednici **👋 Zapratite održavatelja projekta — budite prvi koji saznaje za nove provajdere, izdanja i savete:** [![Follow Diego on LinkedIn](https://img.shields.io/badge/Follow_Diego_on-LinkedIn-0A66C2?style=for-the-badge&logo=linkedin&logoColor=white)](https://www.linkedin.com/in/diegosouzapw/) [![Follow @diegosouzapw on GitHub](https://img.shields.io/github/followers/diegosouzapw?style=for-the-badge&logo=github&logoColor=white&label=Follow%20on%20GitHub&color=181717)](https://github.com/diegosouzapw) [![Discord](https://img.shields.io/badge/Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/U47eFqAXCn) [![Telegram](https://img.shields.io/badge/Telegram-26A5E4?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/omnirouteOficial) [![WhatsApp Global](https://img.shields.io/badge/WhatsApp_Global-25D366?style=for-the-badge&logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) [![WhatsApp Brasil](https://img.shields.io/badge/WhatsApp_Brasil-25D366?style=for-the-badge&logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) [![Website](https://img.shields.io/badge/Website-omniroute.online-blue?logo=google-chrome&logoColor=white)](https://omniroute.online) **Pitanja, savete o provajderima, plan razvoja i podrška → [Discord](https://discord.gg/U47eFqAXCn) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 Globalno](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) / [🇧🇷 Brasil](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) / [Portal](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK)**
## 📈 Gateway Nastavlja 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](ROADMAP.md) — jurimo ka `v3.9.0 LTS`**

## 🧩 Dostupno [![npm version](https://img.shields.io/npm/v/omniroute?color=cb3837&logo=npm)](https://www.npmjs.com/package/omniroute) ![NPM Monthly](https://img.shields.io/npm/dm/omniroute?label=npm/month&color=cb3837&logo=npm) [![Docker Hub](https://img.shields.io/docker/v/diegosouzapw/omniroute?label=Docker%20Hub&logo=docker&color=2496ED)](https://hub.docker.com/r/diegosouzapw/omniroute) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](LICENSE) ![Docker Pulls](https://img.shields.io/docker/pulls/diegosouzapw/omniroute?label=docker%20pulls&logo=docker&color=2496ED) ![Electron Downloads](https://img.shields.io/github/downloads/diegosouzapw/omniroute/total?style=flat&label=electron%20downloads&logo=electron&color=47848F)

🚀 Početak	🚀 Brzi Početak	📦 Instalacija	🆓 Bez konfiguracije
💡 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

🌐 Na 44 jezika

## 🆓 Радите одмах након инсталације — без кључева, без конфигурације

```bash # Свежа инсталација, без креденцијала — `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/`](examples/quickstart/)}

# 💥 Обећање

The Promise — One endpoint and 355 providers. Automatic fallback keeps routing while another healthy target is available. Six pillars: resilient fallback across 355 providers · up to 95% token savings on eligible workloads · $0 to start with 150+ free tiers and 53 recurring/keyless free-forever providers · 36 CLI/agent integrations through one config · OpenAI, Claude, Gemini and Responses API compatibility at /v1 · production controls including circuit breakers, TLS stealth, MCP 110 tools, A2A, memory, guardrails, evals and 39,000+ static test declarations across 5,100+ tracked test files.

# 🤔 Зашто OmniRoute?

OmniRoute request flow: your IDE or CLI (Claude Code, Cursor, Cline…) calls one local endpoint (http://localhost:20128/v1); the OmniRoute Smart Router (RTK + Caveman compression, 19 routing strategies, circuit breakers, TLS stealth, MCP, A2A, guardrails) can fall back across 4 provider tiers while an eligible healthy target remains — Tier 1 Subscription, Tier 2 API Key, Tier 3 Cheap and Tier 4 Free.

## 🤝 Уз подршку наших пријатеља отвореног кода

> **Желите да се придружите као пријатељ отвореног кода?** То су компаније које подржавају отворени код и помажу да OmniRoute напредује — и јавно наводимо где иде сваки токен који нам дају. Јавите нам се: [diegosouza.pw@outlook.com](mailto: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 и додаћемо га овде.}

## 🎯 Комбо — Флагман

Свих 19 стратегија рутирања комбо анимирано — по једна плочица за сваку стратегију: priority, fill-first, weighted, round-robin, p2c, least-used, random, strict-random, cost-optimized, headroom, reset-window, reset-aware, context-relay, context-optimized, cache-optimized, lkgp, auto, fusion, pipeline. Погледајте табелу изнад за детаље шта свака од њих ради.

> **Комбо** је ланац модела кроз које 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 независна слоја)

Отпорност 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

_{📖 [Auto-Combo Engine](docs/routing/AUTO-COMBO.md) · [Водич за отпорност](docs/architecture/RESILIENCE_GUIDE.md)}

## 🏆 Шта издваја OmniRoute од конкуренције

What sets OmniRoute apart — a dated feature snapshot vs 9router, OpenRouter, CLIProxyAPI and LiteLLM across 13 capabilities. OmniRoute: 355 providers, 150+ free tiers built in, 19 routing strategies, 12-engine token compression, built-in MCP server with 110 tools, A2A agent protocol, persistent memory, guardrails, cloud agents, TLS fingerprint stealth, Desktop/Termux/PWA and 42 i18n UI locales. OmniRoute is MIT-licensed and self-hostable. Competitor capabilities and counts may change; see the linked methodology.

_{📊 Потпуна методологија и детаљи по функцијама у односу на 9router, OpenRouter, CLIProxyAPI и LiteLLM → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](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** — тренутно, без накнада (Бразил) OmniRoute PIX QR code

Кључ (насумичан): `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 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](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 ради на бесплатним и јефтиним моделима.

_{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}

＋ такође радi са · Kiro · Command Code · Antigravity · Windsurf · AMP · било којим OpenAI-компатибилним алатом

_{📖 Подешавање по алату за свих 36 алата (26 CLI Code-а + 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 добијају одвојив изолован home: ```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` приказује тачан env/args пре извршавања, а `--api-key-env NAME` чува тајне подаље од историје ваше конзоле. → [CLI интеграције](docs/guides/CLI-INTEGRATIONS.md)

## 🌐 352 AI провајдера — 152 означено у каталогу као бесплатно

> **352 регистрована провајдера** у оквиру канонских колекција за ћаскање, медије, претрагу, локалне, cloud-agent и системске сврхе, укључујући **152 која носе метаподатке за откривање `hasFree: true`**. Регистар модела за ћаскање обухвата **229 провајдера / 2.554 различитих парова провајдер-модел / 1.283 сирова ID-а модела**; посебан каталог бесплатних буџета има **446 редова по моделу**, **38 понављајућих пулова** и **53 понављајућа/бескључна провајдера који су заувек бесплатни**. Ово су намерно различити бројитељи; дефиниције и прорачуни без дуплирања пулова налазе се у документима [Provider Reference](docs/reference/PROVIDER_REFERENCE.md) и [Free Tiers](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

_{…и još преко 330 — свака икона се учитава уживо из провајдер каталога на контролној табли. 📖 [Provider Reference](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 Кључ није потребан}	Cloudflare AI _{50+ модела 10K neurons/day}	NVIDIA NIM _{GLM, MiniMax ~40 RPM бесплатно}	Cerebras _{GLM 4.7, GPT-OSS 1M токена/дан}	OpenRouter _{:free модели +$10 → већи RPM}

📖 Потпуни машински читљив каталог → [`docs/reference/PROVIDER_REFERENCE.md`](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 водич](docs/guides/DOCKER_GUIDE.md) · [Desktop](electron/README.md) · [Termux](docs/guides/TERMUX_GUIDE.md) · [PWA](docs/guides/PWA_GUIDE.md) · [OpenCode](docs/frameworks/OPENCODE.md)}

### 🧩 Ново: 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**.

Продавница	Линк	Ради са
🧩 VS Code Marketplace	Инсталирај →	VS Code — stable & Insiders
🔓 Open VSX Registry	Инсталирај →	Cursor, Windsurf, VSCodium, Theia, code-server, Gitpod, Antigravity, Kiro…

Из самог уређивача: отворите преглед **Extensions**, потражите **"OmniRoute"**, кликните **Install** — ради на исти начин у обе продавнице. Извор, проблеми и упутство за објављивање налазе се на [diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot). _{📖 [VS Code Copilot Chat водич](docs/guides/VSCODE-COPILOT.md) — подешавање, шта бирач приказује, dashboard-in-a-tab, решавање проблема}

## 🔒 Privatnost i lokalno prvo

_{📖 [Autorizacija](docs/architecture/AUTHZ_GUIDE.md) · [Ograde (Guardrails)](docs/security/GUARDRAILS.md) · [Usklađenost](docs/security/COMPLIANCE.md)}

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

Animated terminal demoing the OmniRoute CLI — omniroute providers list, omniroute combo list and omniroute health — cycling over the 86-command top-level surface: providers · oauth · keys · combo · nodes · models · cache · compression · cost · usage · quota · health · resilience · telemetry · logs · audit · mcp · a2a · cloud · memory · skills · eval · tunnel · backup · sync · webhooks · policy · pricing · translator · simulate …

### 🤝 Povežite agenta — i on sam upravlja 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

```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, архитектура и математика уштеде

OmniRoute pipeline za kompresiju: ilustrativni zahtev klijenta od 10.000 tokena prolazi kroz 12 kompozabilnih engine-a — Session-Dedup, CCR, Lite, RTK, Responses Tool Output, Headroom, Relevance, Caveman, Aggressive, LLMLingua-2, Ultra i OmniGlyph — i može stići do provajdera na oko 1.080 tokena u dokumentovanom primeru sa naslaganim redosledom. Strukturirani sadržaj je zaštićen mehanizmima za očuvanje i validacijom tačnosti po koraku; eksplicitni gubitljivi ili eksperimentalni modovi mogu transformisati podobni sadržaj.

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)
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](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 пакет.

# 🎬 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}

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

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

🎬 #3 — TikTok
_{milesreevesai — 620,400 pregleda}

🎬 #4 — YouTube
_{Vaibhav Sisinty — 391,109 pregleda}

🎬 #5 — Instagram
_{buildwithai.club — 347,652 pregleda}

**Kompletan rang (kanonski deduplicirani URL-ovi, `v > 0`, najveći domet):** | #1 | #2 | #3 | #4 | #5 | | -------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | | [nick_saraev — Instagram](https://www.instagram.com/reel/Da8ZthUPK98/) — **3,042,474** | [theopenstack — Instagram](https://www.instagram.com/reel/DaSs65mMrHk/) — **692,419** | [milesreevesai — TikTok](https://www.tiktok.com/@milesreevesai/video/7667980059189366019) — **620,400** | [Vaibhav Sisinty — YouTube](https://www.youtube.com/watch?v=QucgvbO5gsM) — **391,109** | [buildwithai.club — Instagram](https://www.instagram.com/reel/DbIt9AjK7-U/) — **347,652** | | #6 | #7 | #8 | #9 | #10 | | ----------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | | [nivedan.ai — Instagram](https://www.instagram.com/reel/DbIrCksJiqq/) — **331,973** | [vaibhavsisinty — Instagram](https://www.instagram.com/reel/Dae05TSAK1l/) — **263,744** | [Nick Automates — YouTube Shorts](https://www.youtube.com/shorts/fZIBK_4fKq8) — **218,174** | [theroshankrishna — Instagram](https://www.instagram.com/reel/Dapjs58z0P0/) — **186,786** | [midudev — TikTok](https://www.tiktok.com/@midudev/video/7664636453544152342) — **177,800** | Kanonske metrike na 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](https://github.com/diegosouzapw/OmniRoute/issues/new) ili [discussion](https://github.com/diegosouzapw/OmniRoute/discussions) 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](https://www.linkedin.com/in/diegosouzapw/) | | 🐙 **GitHub** — pratite za izdanja i savete | [@diegosouzapw](https://github.com/diegosouzapw) | | 💬 **Discord** | [discord.gg/U47eFqAXCn](https://discord.gg/U47eFqAXCn) | | ✈️ **Telegram** | [t.me/omnirouteOficial](https://t.me/omnirouteOficial) | | 🟢 **WhatsApp — 🌍 Globalno** | [pridružite se grupi](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) | | 🟢 **WhatsApp — 🇧🇷 Brazil** | [pridružite se grupi](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) | | 🌍 **Website** | [omniroute.online](https://omniroute.online) | | 🌍 **🌍StHub OmniRoute Community (free)** | [portal sthub](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK) | | 📦 **Source code** | [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute) | | 🐛 **Prijavite grešku** | [otvorite issue](https://github.com/diegosouzapw/OmniRoute/issues) — priložite izlaz `npm run system-info` | | 🤝 **Doprinesite** | [CONTRIBUTING.md](CONTRIBUTING.md) · [Branching & Release Model](docs/ops/BRANCHING_MODEL.md) · odaberite `good first issue` | | 💚 **Podržite projekat** | [Načini podrške ↑](#-support-omniroute) · [GitHub Sponsors](https://github.com/sponsors/diegosouzapw) |

---

## 🛠️ 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+ Сарадника

[![Contributors](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=639&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors) _{Проверено 2026-08-24. на замрзнутој основи ac02c5b42f и поново проверено на живом врху release/v3.8.50 dafb4ae808: 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)

Пројекат	⭐	Како је инспирисао 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](LICENSE) за детаље. ---

**[⬆ Назад на почетак](#-omniroute)** · Направљено са ❤️ за заједницу отвореног кода у области вештачке интелигенције. _{OmniRoute v3.8.51 · Node ≥22.22.2 · MIT License · omniroute.online}