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

# 🚀 OmniRoute — Бесплатни AI мрежни пролаз

OmniRoute — Никада не престајте да програмирате. Сваки AI алат → 375 провајдера — 150+ бесплатних — преко једне приступне тачке. Claude Code, Codex, Cursor, Cline, Copilot и Antigravity повезани са БЕСПЛАТНИМ Claude / GPT / Gemini моделима уз аутоматско пребацивање. RTK + Caveman слојевита компресија штеди 15–95% токена (~89% у просеку) — никада не достижите ограничења. 375 AI провајдера · 150+ бесплатних нивоа · ~1,62 млрд. бесплатних токена месечно · 20 стратегија рутирања · почетак за $0.

## 💰 ~1,62 млрд токена месечно преко бесплатних пакета независних добављача

> **Користите сопствене налоге код добављача.** Ово је процењени збир засебно доступних бесплатних пакета независних добављача, а не додела токена од стране OmniRoute-а. Региструјте се, прибавите акредитиве тамо где су потребни и повежите добављаче које можете да користите; сваки добављач контролише своја ограничења, доступност и услове. > > Ручно комбиновање бесплатних пакета је напорно — десетине SDK-ова, десетине ограничења брзине и никаква представа о томе колико заправо имате. OmniRoute каталогизује **471 ставку бесплатних пакета у оквиру 34 кључа периодичних пулова** и израчунава истакнути број токена на основу **17 пулова са објављеним позитивним месечним буџетом, уз пет Groq ограничења по моделу**, уз уклањање дупликата који деле исти пул. Квоте које постају доступне тек након регионалне провере идентитета (тренутно: ModelScope) приказују се засебно, +~6M након регионалне провере идентитета, и никада се не сабирају у истакнути број. Резултат остаје видљив на контролној табли (`/dashboard/free-tiers`).

Картица буџета бесплатних пакета OmniRoute-а: стабилних ~1,62 млрд бесплатних токена месечно, до ~2,22 млрд током првог месеца са кредитима за регистрацију, из 34 документована кључа периодичних пулова који обухватају 471 каталогизовану ставку бесплатних пакета иза једне крајње тачке. Транспарентан прорачун са уклањањем дупликата по пуловима — сваки дељени пул рачуна се једном, укључујући 17 периодичних пулова са објављеним позитивним месечним буџетом токена и пет Groq ограничења по моделу; 12 добављача је означено као непожељно у каталогу ризика услова коришћења, тако да ви одлучујете. Трака буџета обухвата Mistral 1B, Nara 210M, LLM7 150M, xKiro 150M, Groq 30M (пет ограничења по моделу) и мање пулове, уз кредите за регистрацију током првог месеца и трајно бесплатне добављаче без ограничења токена, који су приказани засебно како никада не би увећавали истакнути број. Тренутна потрошња и преостали износ на /dashboard/free-tiers.

> Анимирани сажетак активне странице `/dashboard/free-tiers`. Потпуна методологија (уклањање дупликата по пуловима, нивои кредита, услови добављача): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**. > > _{Ове вредности се поново проверавају сваке две недеље у односу на активни каталог и **мењају се у оба смера** — када добављач укине бесплатни пакет, број се смањује; када се појави нови, број расте. Објављујемо оно што каталог заиста израчунава, никада заокружену најбољу могућу вредност.}

⭐ Дајте звездицу репозиторијуму ако вам је OMNIROUTE помогао да уштедите новац и олакшате рад.

[![Звездице](https://img.shields.io/github/stars/diegosouzapw/OmniRoute?style=social)](https://github.com/diegosouzapw/OmniRoute)

[![Позиција у историји звездица](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) ### 💬 Придружите се заједници **👋 Запратите одржаваоца — први сазнајте за нове добављаче, издања и савете:** [![Запратите Diego-а на 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/) [![Запратите @diegosouzapw на 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 глобално](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 Бразил](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) [![Веб-сајт](https://img.shields.io/badge/Website-omniroute.online-blue?logo=google-chrome&logoColor=white)](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.50 | **v3.8.51** | `v3.8.53+` | | --------------------------------------- | :---------------------: | :---------: | :-------------------: | | 🌐 Провајдери | 352 | **358** | 375 | | 🧠 Јединствени ID-ови модела за ћаскање | 1320 | **1374** | 1475 | | 🖼️ Мост модалитета | 🆕 слика + звук + видео | ✓ | ✓ | | 📡 Бесплатни Radar каталог | 🆕 уз пријаву | ✓ | ✓ | | ⚖️ Распоређивање према квоти | 🆕 дељење квоте | ✓ | ✓ | | 📊 Телеметрија квоте | 🆕 уживо | ✓ | ✓ | | 🧰 Режим без интерфејса | — | — | 🆕 `serve --headless` | | 🛤️ Инфраструктура LTS гране | — | — | 🆕 канали издања | | 🔎 API за откривање модела | — | — | 🆕 `/v1/models/query` | **→ [План развоја](ROADMAP.md) — путовање граном ка `v3.9.0 LTS`**

## 🧩 Доступно [![верзија на npm-у](https://img.shields.io/npm/v/omniroute?color=cb3837&logo=npm)](https://www.npmjs.com/package/omniroute) ![Месечна преузимања са NPM-а](https://img.shields.io/npm/dm/omniroute?label=npm/month&color=cb3837&logo=npm) [![Docker Hub](https://img.shields.io/docker/v/diegosouzapw/omniroute?label=Docker%20Hub&logo=docker&color=2496ED)](https://hub.docker.com/r/diegosouzapw/omniroute) [![Лиценца: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](LICENSE) ![Docker преузимања](https://img.shields.io/docker/pulls/diegosouzapw/omniroute?label=docker%20pulls&logo=docker&color=2496ED) ![Electron преузимања](https://img.shields.io/github/downloads/diegosouzapw/omniroute/total?style=flat&label=electron%20downloads&logo=electron&color=47848F)

🚀 Почетак	🚀 Брзи почетак	📦 Инсталација	🆓 Повежите добављача
💡 Сазнајте више	💥 Обећање	🤔 Зашто OmniRoute	🏆 По чему се издваја
⚙️ Функције	🎯 Комбинације	🌐 Добављачи	🔌 CLI и MCP
	🗜️ Компресија	🖥️ Где се покреће	🔒 Приватност
👀 Погледајте	🎬 На делу	✨ Шта је ново	🤖 Компатибилни CLI алати
💚 Подршка	💚 Подршка / Донације	💬 Заједница	💖 Спонзори
📦 Пројекат	🛠️ Технолошки стек	📖 Документација	👥 Сарадници

🌐 На 67 језика

## 🆓 Инсталирајте, повежите провајдера, а затим усмеравајте преко једне крајње тачке

Три корака: инсталирајте и покрените OmniRoute, повежите одговарајућег провајдера помоћу сопственог налога или API кључа, а затим усмерите свој алат на localhost:20128/v1 користећи OmniRoute API кључ и модел auto. Усмеравање зависи од доступних одговарајућих веза и ограничења провајдера.

```bash # Након повезивања провајдера, копирајте свој OmniRoute кључ са Контролна табла → Крајње тачке: curl http://localhost:20128/v1/chat/completions \ -H "Authorization: Bearer YOUR_OMNIROUTE_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}' ``` _{За `auto` је потребна одговарајућа рута. Нова инсталација можда нема ниједно одговарајуће одредиште без кључа, а провајдер без кључа може одбити клијенте трећих страна. Провајдери означени са `tos: avoid`, укључујући Kiro, подразумевано су искључени из аутоматског усмеравања; повезивање налога не мења ту поставку. Пре него што изаберете провајдера, погледајте [Водич за бесплатне пакете](docs/getting-started/FREE-TIERS-GUIDE.md).} _{📦 Скрипте за брзи почетак које можете копирати и налепити за **Python, Node.js, PHP и cURL** → [`examples/quickstart/`](examples/quickstart/)}

# 💥 Обећање

# 🤔 Зашто OmniRoute?

Ток OmniRoute захтева: ваш IDE или CLI (Claude Code, Cursor, Cline…) позива једну локалну крајњу тачку (http://localhost:20128/v1); OmniRoute паметни рутер (RTK + Caveman компресија, 20 стратегија усмеравања, прекидачи кола, TLS прикривање, MCP, A2A, заштитни механизми) може да се пребацује између 4 нивоа провајдера све док постоји одговарајуће исправно одредиште — Ниво 1 Претплата, Ниво 2 API кључ, Ниво 3 Јефтино и Ниво 4 Бесплатно.

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

> **Желите да нам се придружите као пријатељ отвореног кода?** Ово су компаније које подржавају отворени код и помажу да OmniRoute настави да напредује — а ми јавно објављујемо на шта одлази сваки токен који нам обезбеде. Јавите нам се: [diegosouza.pw@outlook.com](mailto:diegosouza.pw@outlook.com)

Kimi
_{Moonshot AI} Хвала компанији Kimi (Moonshot AI), нашем оснивачком пријатељу отвореног кода, што подржава овај пројекат! Kimi је AI лабораторија која стоји иза породица модела K2 и K3 са отвореним тежинама — Kimi K3 пружа контекстни прозор од 1 милиона токена, изворну подршку за визуелни садржај и програмирање на нивоу водећих модела, по делићу цене затворених модела, а одмах ради са алатима Claude Code, Codex и сваким алатом за програмирање који OmniRoute опслужује.

Шта омогућава подршка компаније Kimi: Kimi API кредити покрећу OmniRoute-ов процес издавања који проверава AI — фазу провере спајања коју покреће Kimi K3, а која прегледа сваки захтев за спајање пре објављивања — као и свакодневни развој функција. Првокласна подршка за Kimi испоручује се путем оба канала: директног Kimi API-ја (kimi-k3) и Kimi Code плана за програмирање (OAuth и API кључ). OmniRoute је такође први бразилски пројекат отвореног кода у Kimi програму подршке. Набавите Kimi API кључ са 15% додатних кредита →

Cheaper Inference
_{cheaperinference.com} Хвала компанији Cheaper Inference, OmniRoute-овом пријатељу отвореног кода, што подржава овај пројекат! Cheaper Inference је мрежни пролаз рангиран према трошковима који препродаје 42 водећа модела — Claude, GPT-5.x, Gemini, Kimi K3, GLM, DeepSeek, Grok и MiniMax — преко једне крајње тачке компатибилне са OpenAI-јем, усмеравајући сваки захтев најјефтинијем одговарајућем добављачу, а да никада не наплаћује више од каталошке цене произвођача модела.

Првокласна подршка у OmniRoute-у: довршавање ћаскања, изворна крајња тачка /v1/responses, визуелни садржај, позивање алата и 3 модела за слике (grok-imagine, nano-banana-pro, nano-banana-2, доступни као cheaperinference/<model>). Набавите API кључ →

_{Везе означене са aff=omniroute су партнерске везе. Оне финансирају пројекат без додатних трошкова за вас.}

_{🎟️ Промоције партнера — бесплатни купони за регистрацију од добављача које не спонзоришемо (кликните да проширите)}

_{Овај одељак је намењен искључиво кодовима за препоруке/купоне. Спонзорска партнерства налазе се у одељку 🤝 Подршка наших пријатеља отвореног кода изнад. OmniRoute нема спонзорски нити партнерски однос са добављачима наведеним овде — ово су јавни купони које свако може да користи.}

_AgentRouter
_{agentrouter.org} _{AgentRouter — партнерска регистрација · $100 бесплатних кредита при регистрацији (бесплатан сервер, очекујте веће кашњење — најбоље за тестирање, не за продукцију). Првокласна подршка у OmniRoute-у од верзије v3.8.50: довршавање ћаскања, формат преноса компатибилан са Anthropic-ом и путања компатибилна са OpenAI-јем. Доступни модели обухватају claude-opus-4-8, claude-opus-5, gpt-5.6-sol и друге. Преузмите својих $100 →}

_{⚠️ Партнерска веза — OmniRoute нема спонзорски нити партнерски однос са овим добављачем.}

_{Знате за још неког добављача са издашним бесплатним купоном за регистрацију који користи OmniRoute корисницима? Отворите пријаву проблема и додаћемо га овде.}

## 🎯 Комбинације — главна функционалност

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

> **Комбинација** је ланац модела између којих OmniRoute рутира **аутоматски**. Ако се квота потроши, добављач откаже или трошкови нагло порасту, комбинација може да пређе на следећи одговарајући исправан модел. 🛡️ ### ⚡ Без конфигурације — само користите `auto` Нема потребе да правите комбинацију. Подесите модел на `auto` (или неку варијанту) и OmniRoute ће направити виртуелну комбинацију од ваших повезаних добављача, уз оцењивање уживо:

ID модела	За шта је оптимизован
`auto`	🎯 Уравнотежена подразумевана опција (LKGP — задржава последњег исправног добављача)
`auto/coding`	🧑💻 Пондери који дају предност квалитету при генерисању кода
`auto/fast`	⚡ Најпре најмање кашњење
`auto/cheap`	💰 Најпре најнижа цена по токену
`auto/subscription`	🎟️ Само претплатничка квота коју већ плаћате — затвара се при неуспеху, без преласка на опцију која се наплаћује (водич)
`auto/thrifty`	🪜 Најпре квота пакета, затим корак по корак до најјефтинијих плаћених опција — повратак на пакет након ресетовања (водич)
`auto/offline`	🔋 Најпре највећа резерва квоте / ограничења брзине
`auto/smart`	🔭 Најпре квалитет + 10% истраживања ради проналажења бољих модела
`auto/lkgp`	📌 Изричито задржавање последњег познатог исправног добављача
`auto/chaos`	🧪 Паралелно прослеђивање панелу модела (по један за сваког добављача, подразумевано 5), уз враћање једног одговора; по један узводни позив за сваки модел у панелу, без убризгавања грешака

## ### 🔀 Или направите сопствену — 20 стратегија рутирања Свих **20** стратегија — комбинујте их по жељи у сваком кораку комбинације:

#	Стратегија	Шта ради
1	`priority`	Уређена листа с првим циљем — потпуно искористите сваки пре преласка на следећи 🥇
2	`fill-first`	У потпуности искористите квоту сваког циља пре него што пређете на следећи
3	`weighted`	Пондерисани случајни избор према пондеру сваког циља
4	`round-robin`	Кружно пролази кроз циљеве редом
5	`p2c`	Случајно балансирање оптерећења методом избора између две опције
6	`least-used`	Бира циљ са најмањим тренутним оптерећењем
7	`random`	Равномерни случајни избор (без дупликата)
8	`strict-random`	Случајни избор без уклањања поновљених вредности 🎲
9	`cost-optimized`	Смањује цену по захтеву на основу актуелних цена из каталога 💸
10	`headroom`	Бира циљ са највећом преосталом квотом
11	`quota-weighted`	Прескаче налоге са потрошеном квотом, а затим бира сразмерно преосталој квоти ÷ тренутном оптерећењу — постојећи разговори остају везани за исти циљ ⚖️
12	`reset-window`	Даје предност циљу чији се период квоте најраније ресетује
13	`reset-aware`	Рангира према времену ресетовања квоте — најпре кратки периоди 📊
14	`context-relay`	Преноси контекст између циљева током дугих разговора 🧠
15	`context-optimized`	Бира циљ који најбоље одговара тренутној величини контекста
16	`cache-optimized`	Везује сваки поново употребљиви префикс упита за исти налог — максимално повећава поготке кеша упита 🎯
17	`lkgp`	Последња позната исправна путања — везује се за последњег успешног добављача, а затим прелази на резервна правила
18	`auto`	Оцењивање уживо на основу 16 фактора за сваку везу 🤖
19	`fusion`	Прослеђује захтев панелу модела + модел-судија обједињује један одговор 🧬
20	`pipeline`	Повезује кораке — излаз сваког циља прослеђује се следећем 🔗

_{Механизам Auto-Combo оцењује сваког кандидата на основу **16 фактора** (стање, квота, цена, кашњење, прикладност за задатак, квалитет, доступност сесије…) — погледајте [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md).} ## ### 🧱 Отпорност је уграђена (3 независна слоја)

Отпорност OmniRoute-а — 3 независна слоја самосталног опоравка, прави слој за праву врсту отказа. Слој 1 — аутоматски прекидач добављача (цео добављач): активира се само при грешкама 408/5xx, прагови су OAuth 8× / API кључ 12× / локално 2×, ресетује се након 60s/30s/15s и прелази у HALF-OPEN пробу, опоравак по потреби; док је стање OPEN, комбинација преусмерава захтеве следећем добављачу. Слој 2 — период мировања везе (један кључ/налог): основно трајање је 5s за OAuth / 3s за API кључ, експоненцијално одлагање ×2 са заштитом од наглог истовременог навирања захтева, код 429 поштује Retry-After, успех брише целокупно стање грешке; један кључ у периоду мировања се прескаче док остали кључеви настављају да опслужују захтеве. Слој 3 — блокада модела (један модел): 429 за појединачни модел, локални 404 или одбијања режима блокирају само тај модел — никада целу везу. Крајња стања (забрањен, истекао, потрошени кредити) намењена су оператеру, а не периодима мировања.

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

## 🏆 По чему се OmniRoute издваја

_{📊 Комплетна методологија и детаљи за сваку функцију у поређењу са 9router, OpenRouter, CLIProxyAPI и LiteLLM → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)}
## 💚 Подржите OmniRoute OmniRoute је лиценциран под MIT лиценцом и одржава се јавно. Ако вам штеди време или новац, ево како можете помоћи да остане независан — изаберите оно што вам одговара. Спонзорство никада не утиче на приоритет рутирања; оно доноси видљивост, а не бољи ранг.

⭐ Означите репозиторијум звездицом	Бесплатно — заиста помаже видљивости	Означите 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 кôд

Кључ (насумични): `5d865059-bc44-483a-962d-43ceb80126eb` Pix за копирање и лепљење: ``` 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`

_{⚠️ Сваки новчић шаљите само преко приказане мреже — слање преко погрешне мреже може довести до губитка средстава.}

🐛 Пронашли сте грешку или имате повратне информације? Отворите [Дискусију](https://github.com/diegosouzapw/OmniRoute/discussions).

Напомене за програмере: Пројекат може да генерише локалну .env датотеку током npm install/postinstall ради погодности програмера. Ова датотека се намерно игнорише путем .gitignore (погледајте .gitignore) и никада не сме бити послата у репозиторијум — ако је случајно послата, промените све изложене тајне и уклоните датотеку из историје. Погледајте docs/DEVELOPER-ENVIRONMENT.md за смернице о управљању локалним датотекама окружења и тајнама.

## 📡 OmniRoute Radar Главна бројка за бесплатни ниво остаје **~1,62 млрд. токена месечно** из горе наведеног документованог каталога, из ког су уклоњена преклапања између група. Привремени кредити за регистрацију код добављача могу засебно повећати обим током првог месеца на **~2,22 млрд.** Radar је опционални, потписани слој каталога за кориснике који желе ажурнију доступност бесплатних модела између OmniRoute издања; каталог заједнице и све постојеће бесплатне функционалности остају бесплатни. Подржаваоци могу добити актуелни каталог и додатне могућности добављача. Његова засебна, променљива горња граница износи **највише приближно 3 млрд. токена месечно**, у зависности од доступности добављача. Та горња граница није загарантована: добављачи могу у било ком тренутку променити квоте, услове испуњавања, моделе или регионе. Radar се користи по избору и подржава само GET. OmniRoute клијент не отпрема упите, саобраћај, конфигурацију добављача, телеметрију коришћења нити локално стање одбацивања обавештења. Сазнајте више о условима испуњавања и актуелном каталогу на **[radar.omniroute.online/planos](https://radar.omniroute.online/planos)**.

## ✨ Шта је ново

> Недавни најважнији догађаји од **v3.8.20 → v3.8.53**. Комплетна историја у [`CHANGELOG.md`](CHANGELOG.md). - **⚖️ `quota-weighted` рутирање** — 20. combo стратегија прескаче исцрпљене налоге, а затим бира међу осталима сразмерно преосталој квоти ÷ тренутном оптерећењу, задржавајући постојеће разговоре прикованим. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🧰 Headless режим** — `omniroute serve --headless` (или `OMNIROUTE_HEADLESS=1`) покреће само `/v1/*` прокси механизам, са искљученим контролном таблом и подсистемима који постоје само за контролну таблу. → [Headless Mode](docs/guides/HEADLESS.md) - **🔎 Откривање модела** — `/v1/models` филтрира по могућностима, контексту, врсти и тексту, а `POST /v1/models/query` враћа кратак детерминистички списак са истом видљивошћу по кључу. → [API Reference](docs/reference/API_REFERENCE.md) - **🔑 Контрола рутирања по кључу** — приковите API кључ за један модел или combo помоћу `forcedModel`, и атомски додајте или уклоните моделе и combo-е неког кључа (`/api/keys/{id}/access`). → [API Reference](docs/reference/API_REFERENCE.md) · [OpenAPI](docs/openapi.yaml) - **🛡️ Прецизније PII контроле** — избор по врсти, до 20 валидираних прилагођених образаца маскирања и бројачи детекције по врсти; само маскирање остаје опционо. → [Guardrails](docs/security/GUARDRAILS.md) - **🌍 67 језика** — контролна табла, огледала документације и CLI, уз `npm run i18n:add-locale` који једном командом додаје језик свуда. → [i18n Guide](docs/guides/I18N.md) - **🎛️ OmniConductor** — долазно A2A делегирање ка вашој флоти агената, Conductor вештине на Agent Card-у и панел на контролној табли са Faro push-to-talk гласовним четом. → [A2A Server](docs/frameworks/A2A-SERVER.md) - **🛂 Адаптивно прихватање и заштита од преоптерећења** — тешки chat захтеви чекају у реду уместо да добију 503, уз атомске RPM rolling lease-ове по конекцији. → [Resilience Guide](docs/architecture/RESILIENCE_GUIDE.md) - **🗂️ Канонско `/v1/models` сортирање** — један непрекинут блок груписан по провајдеру за сваког провајдера (combo-и приковани први), стабилан кроз сваки извор каталога. → [API Reference](docs/reference/API_REFERENCE.md) - **🗜️ Очвршћивање компресије** — inflation guard укључен по подразумеваном, Caveman пакети за DE / FR / JA + кинески (wényán), RTK филтери за Gradle и .NET. → [Compression](docs/compression/COMPRESSION_ENGINES.md) - **💸 Поштена паушална цена** — провајдери претплата / coding планова приказују **$0** у аналитици трошкова; буџет, квота и рутирање настављају да процењују. → [API Reference](docs/reference/API_REFERENCE.md) - **⚖️ Quota-Share рутирање** — поделите квоту дељеног налога праведно међу удруженим кључевима, радно-конзервативно тако да се неискоришћени делови позајмљују. → [Resilience Guide](docs/architecture/RESILIENCE_GUIDE.md) - **🤖 Подешавање CLI/агената једном командом** — 15 регистрованих `setup-*` команди; `omniroute run` покреће 7 CLI-јева (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); `omniroute configure` подржава 11 циљева са интерактивним бирачем провајдера+модела и омиљеним по контексту. → [CLI Integrations](docs/guides/CLI-INTEGRATIONS.md) - **🛰️ Удаљени режим** — управљајте удаљеним OmniRoute-ом помоћу ограничених токена (`connect` / `contexts` / `tokens`) + `antigravity` OAuth помоћник за VPS инсталације. → [Remote Mode](docs/guides/REMOTE-MODE.md) - **🧭 Паметније аутоматско рутирање** — `auto/:` combo-и, **Fusion** (панел модела + судија), рутирање свесно задатка, замене модела / режима / USD-буџета по захтеву. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🗜️ Прикључива компресија** — 12 компонованих механизама + Compression Studios: LLMLingua-2, двослојни Ultra, omniglyph, верификација верности по кораку, GCF v3.2, уређивач са превлачењем за преуређивање. → [Compression](docs/compression/COMPRESSION_ENGINES.md) - **🕵️ Транспарентно MITM дешифровање (TPROXY)** — хватајте CLI-јеве који игноришу proxy env променљиве, уз CA по SNI + инсталатер trust store-а. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md) - **💸 Телеметрија трошкова свуда** — `X-OmniRoute-*` заглавља трошкова/употребе на сваком endpoint-у, заглавље уштеде за cache-HIT, USD квоте потрошње по кључу. → [API Reference](docs/reference/API_REFERENCE.md) - **🧠 Меморија коју контролишете** — подразумевано искључена, опциона int8 векторска квантизација + типизирано опадање, `x-omniroute-no-memory` по захтеву. → [Memory](docs/frameworks/MEMORY.md) - **🛡️ Безбедност** — заштита од prompt-injection-а на свакој LLM рути (red-team suite), опциона заштитна мера за маскирање акредитива (уклања процуреле API кључеве/тајне у оба смера), бесплатно DuckDuckGo веб претраживање као крајња опција и опциона OIDC пријавна капија за контролну таблу (пријава лозинком је увек доступна). → [Guardrails](docs/security/GUARDRAILS.md) - **🖼️ Нови endpoint-и** — `/v1/ocr` (Mistral OCR) и `/v1/audio/translations` (Whisper-стил) заокружују медијску површину. → [API Reference](docs/reference/API_REFERENCE.md) - **🎨 Генерисање слика / видеа / звука** — један API за медије: xAI Grok Imagine и Novita AI видео, ComfyUI, Magnific, Adobe Firefly, Segmind и говорни провајдери као што је ElevenLabs. → [API Reference](docs/reference/API_REFERENCE.md) - **🌍 Деплојмент и операције** — reverse-proxy `basePath`, аутоматска детекција језика прегледача, праћење уређаја по кључу, MITM поверење без root-а, zh-TW локализација. → [Environment](docs/reference/ENVIRONMENT.md) - **🤝 Још провајдера и агената** — cloud агенти (Codex Cloud, Cursor, Devin, Jules), Grok Build (xAI) са пријавом преко прегледача + OAuth, Ollama као картон првог реда, Claude Opus 5 и Sonnet 5, званично партнерство са Kimi (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… и освежени каталог од **375 провајдера**. → [Providers](docs/reference/PROVIDER_REFERENCE.md) - **📡 Транспарентност рутирања** — сваки одговор носи заглавље `X-OmniRoute-Decision` које именује стратегију/провајдера/кашњење који су га обслужили, нова `cache-optimized` combo стратегија + Auto-Combo фактор `cacheAffinity` враћају поновљене захтеве ка конекцији која држи кеширани префикс, а read-only endpoint `/v1/auto-combo/{channel}/candidates` излаже живи скуп кандидата неког `auto/*` канала. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **⚡ Локалне перформансе и инфраструктура** — локални Redis на један клик, Cloudflare Workers / Deno Deploy relay деплојери, Bifrost и Mux као надгледане уграђене услуге. → [Уграђене услуге](docs/frameworks/EMBEDDED-SERVICES.md) - **🧩 Још у пакету** — plugin фрејмворк + маркетплејс, Omni/Agent/GitHub skills фрејмворци, Obsidian vault интеграција (22 MCP алата), OpenAI-компатибилни Batch и Files API-ји, семантички кеш одговора, гамификација са ранг листама, ACP откривање агената (15 уграђених агената), заказани извоз логова у BigQuery, `auto/chaos` паралелно више-моделско fan-out, Telegram bot мост, верзијски менаџер унутар апликације и LMArena-ELO рангирања бесплатних провајдера. → [Документација](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}	_deyin.ai

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

_{📖 Подешавање по алату за свих 37 алата (27 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 добијају привремени изоловани матични директоријум: ```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 5dive ``` Свака команда поштује активни удаљени контекст (`omniroute connect `), `--dry-run` приказује тачне променљиве окружења и аргументе без извршавања, а `--api-key-env NAME` спречава да тајне доспеју у историју ваше љуске. → [CLI интеграције](docs/guides/CLI-INTEGRATIONS.md)

## 🌐 375 добављача AI услуга — 153 означена у каталогу као бесплатна

> **375 регистрованих добављача** у канонским колекцијама за ћаскање, медије, претрагу, локалне и cloud агенте и системске услуге, укључујући **153 са метаподацима за откривање `hasFree: true`**. Регистар модела за ћаскање обухвата **239 добављача / 3.059 различитих парова добављач–модел / 1.475 необрађених ID-ова модела**; засебни каталог бесплатних квота има **471 ред по моделу**, **34 обнављајуће групе квота** и **51 добављача који су трајно бесплатни, са обнављајућим квотама или без потребе за кључем**. Ово су намерно различити имениоци; дефиниције и прорачуни са уклоњеним дупликатима група налазе се у [Референци добављача](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

_{…и још 350+ — свака икона се уживо учитава из каталога добављача на контролној табли. 📖 [Референца добављача](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+ модела 10 хиљада неурона дневно}	NVIDIA NIM _{GLM, MiniMax ~40 RPM бесплатно}	Cerebras _{GLM 4.7, GPT-OSS Једнократни кредит од $5; картица је обавезна}	OpenRouter _{:free модели +$10 → већи RPM}

📖 Комплетан машински читљив каталог → [`docs/reference/PROVIDER_REFERENCE.md`](docs/reference/PROVIDER_REFERENCE.md)

## 🖥️ Где OmniRoute ради — свуда

> Иста апликација, ваш уређај, ваша правила. Од глобалне npm инсталације до **вашег телефона** путем Termux-а.

Платформа	Инсталација	Најважније
📦 npm (глобално)	`npm install -g omniroute`	Једна команда, било који ОС
🐳 Docker	`docker run … diegosouzapw/omniroute`	Више архитектура: AMD64 + ARM64
🖥️ Десктоп (Electron)	`npm run electron:build`	Изворни прозор + системска палета — Windows / macOS / Linux
🎩 Трака менија (OmniRouteTray)	`brew install --cask zoispag/tap/omniroute-tray`	Надгледа и аутоматски ажурира сервер — macOS
💪 ARM	изворни `arm64`	Raspberry Pi, ARM сервери, Apple Silicon
📱 Android (Termux)	`pkg install nodejs && npx -y omniroute`	Ради на вашем телефону, непрекидно, без root приступа
📲 PWA	"Додај на почетни екран"	Преко целог екрана, ради ван мреже, може се инсталирати из прегледача
🧩 OpenCode додатак	`@omniroute/opencode-provider`	Изворна OpenCode интеграција
🤖 VS Code Copilot Chat	инсталирајте проширење OmniCopilot	Сваки OmniRoute модел у изворном бирачу модела Copilot Chat-а — стабилној и Insiders верзији
🛠️ Из изворног кода	`npm install && npm run dev`	Мењајте га, доприносите развоју

_{📖 [Водич за Docker](docs/guides/DOCKER_GUIDE.md) · [Десктоп](electron/README.md) · [Системска палета у траци менија](https://github.com/zoispag/omniroute-tray) · [Termux](docs/guides/TERMUX_GUIDE.md) · [PWA](docs/guides/PWA_GUIDE.md) · [OpenCode](docs/frameworks/OPENCODE.md)}

### 🧩 Ново: OmniRoute унутар изворног Copilot Chat-а у VS Code-у

> Без нове бочне траке и новог интерфејса за ћаскање — сваки модел који OmniRoute послужује појављује се директно у > **бирачу модела Copilot Chat-а који већ користите**. Од верзије VS Code 1.122, модели добављача раде > без пријављивања на GitHub или претплате на Copilot — агентски режим, позивање алата и рад са сликама, > бесплатно. Инсталирајте проширење **[OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)**, усмерите га ка свом OmniRoute серверу (подразумевано је `localhost:20128`), а затим отворите Copilot Chat → бирач модела → **Управљај моделима…** → **OmniRoute**.

Продавница	Веза	Ради са
🧩 VS Code Marketplace	Инсталирај →	VS Code — стабилна и 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) — подешавање, шта бирач приказује, контролна табла у картици, решавање проблема}

### 🎩 Ново: OmniRouteTray — ваш мрежни пролаз у траци менија

> `omniroute serve` најбоље ради када је стално укључен. **[OmniRouteTray](https://github.com/zoispag/omniroute-tray)** > претвара га у macOS апликацију у траци менија коју једном подесите и заборавите: покреће сервер, одржава га активним > након поновних покретања, ажурира га на лицу места и омогућава приступ тренутном буџету токена једним кликом — **без > остављања отвореног прозора терминала и без надгледања команде `npm install -g omniroute`.** Направљен помоћу [Tauri v2](https://v2.tauri.app/) (Rust језгро занемарљиве величине), испоручује се са сопственим потписаним Node 24 извршним окружењем и управља OmniRoute инсталацијом у власништву апликације, тако да никада није у сукобу са вашим глобалним `node`/`bun` окружењем. **Дели вашу постојећу `~/.omniroute/` конфигурацију и базу података** — тако да је то исти OmniRoute који већ користите, само са шеширом. 🎩

Шта ради	Како
🟢 Надгледа сервер	Покреће `omniroute serve` и преузима већ покренуту инстанцу уместо да је дуплира
📊 Тренутна потрошња на први поглед	Траке квота добављача, ограничења Claude сесије и недељна ограничења са одбројавањем до ресетовања, преглед трошкова за 30 дана
🔄 Аутоматски се ажурира на лицу места	Фазна инсталација, атомска замена, враћање на претходну верзију у случају неуспеха — увек на најновијем издању
🚀 Покретање при пријављивању	Опционо покретање при пријављивању; само системска палета, без иконе у Dock-у
🩺 Дијагностика и евиденције	Дијагностика једним кликом и приступ евиденцијама сервера

```sh brew install --cask zoispag/tap/omniroute-tray ``` _{Радије бисте преузели апликацију? Преузмите најновији .dmg са странице
Издања. Изворни кôд, пријаве проблема и документација за
изградњу доступни су на zoispag/omniroute-tray.

💛 Пројекат заједнице који је направио @zoispag — није званично OmniRoute издање.}

## 🔒 Приватно и локално на првом месту

_{📖 [Ауторизација](docs/architecture/AUTHZ_GUIDE.md) · [Заштитне мере](docs/security/GUARDRAILS.md) · [Усклађеност](docs/security/COMPLIANCE.md)}

## 🔌 Комплетан CLI + A2A и MCP

> Поред сервера, OmniRoute је **комплетан командни центар за командну линију** са **више од 80 команди**, као и отвореним протоколима за агенте, тако да AI агент може да управља њиме **самостално**. ### ⌨️ Прави CLI (не само `start`) ```bash omniroute # покрени мрежни пролаз + контролну таблу (порт 20128) omniroute chat # интерактивни TUI клијент за ћаскање (команде: /model /combo /skill /memory) omniroute setup # вођени чаробњак за прво покретање omniroute doctor # дијагностикуј добављаче, портове и изворне зависности ``` ### 🛰️ Удаљени режим — покрените CLI овде, а OmniRoute на VPS-у OmniRoute је на серверу? Управљајте њиме са свог лаптопа помоћу **истог CLI-ја**. Пријавите се једном помоћу приступног токена ограниченог опсега; свака команда ће затим бити усмерена на удаљени сервер. ```bash omniroute connect 192.168.0.15 # лозинка → токен ограниченог опсега, сачуван као контекст omniroute models # ← извршава се на УДАЉЕНОМ серверу omniroute configure codex # ← бира удаљени модел, уписује локални Codex профил omniroute tokens create --name ci --scope read # издај токене ужег опсега за друге машине omniroute contexts use default # ← врати се на локални сервер ``` Токени имају опсег `read` / `write` / `admin`; руте које покрећу процесе остају доступне само преко повратне петље. _{📖 [Удаљени режим](docs/guides/REMOTE-MODE.md)}

Анимирани терминал који приказује OmniRoute CLI — omniroute providers list, omniroute combo list и omniroute health — смењујући 89 команди највишег нивоа: 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 …

### 🤝 Повежите агента — и он сам управља OmniRoute-ом Омогућите приступ OmniRoute-у преко **MCP-а**, **A2A-а**, **REST API-ја**, **веб-хукова** или **удаљеног CLI-ја** — сваки способан агент (или ваш сопствени кôд) добија приступ целом мрежном пролазу: усмеравању, добављачима, комбинацијама, кешу, компресији и меморији — аутономно. HTTP крајње тачке у наставку доступне су преко `http://localhost:20128`.

Интерфејс	Крајња тачка / команда	Намена
🧰 MCP (stdio)	`omniroute --mcp`	Повежите са Claude Desktop-ом, Cursor-ом или било којим MCP клијентом
🌊 MCP (HTTP)	`/api/mcp/stream`	Удаљени MCP — 110 алата, 33 опсега (примена по избору), потпун траг ревизије
📡 MCP (SSE)	`/api/mcp/sse`	MCP транспорт путем стримовања
🤝 A2A	`/.well-known/agent.json`	Комуникација између агената, JSON-RPC 2.0 + SSE, 6 вештина
🌐 REST API	`/v1/*`	Компатибилан са OpenAI-јем — ћаскање, угнежђивања, слике, звук, OCR
🔔 Веб-хукови	`/api/webhooks`	Шаљите догађаје о захтевима / квотама у Slack, Discord, Telegram или на било који URL
🛰️ Удаљени CLI	`omniroute connect`	Управљајте удаљеном инстанцом помоћу приступних токена ограниченог опсега

```bash # Омогућите Claude Code-у комплетан скуп OmniRoute алата преко MCP-а: claude mcp add-server omniroute --type http --url http://localhost:20128/api/mcp/stream ``` _{📖 [MCP сервер](docs/frameworks/MCP-SERVER.md) · [A2A сервер](docs/frameworks/A2A-SERVER.md) · [Протоколи за агенте](docs/frameworks/AGENT_PROTOCOLS_GUIDE.md)}

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

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

OmniRoute compression pipeline: ilustrativni klijentski zahtev 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 u dokumentovanom stacked primeru može stići do provajdera sa oko 1.080 tokena. Strukturisani sadržaj je zaštićen preservation guard-ovima i fidelity gate-ovima po koraku; eksplicitni lossy ili eksperimentalni režimi mogu transformisati podoban sadržaj.

Podrazumevani stacked combo pokreće `RTK → Caveman`. Kada oba deluju na isti tool/context payload, uštede se sabiraju: ```txt combined = 1 − (1 − RTK) × (1 − Caveman_input) average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2% range = 78.4 – 94.6% ``` Code blokovi, URL-ovi, JSON i strukturisani podaci su **uvek zaštićeni** od strane preservation engine-a. > **Zašto koristiti mnogo tokena kada malo tokena radi posao?** Svaki zahtev prolazi kroz OmniRoute compression pipeline **transparentno** — bez izmena na klijentu. To je sada **stek od 12 kompozabilnih engine-a** koji se izvršavaju po redu i kombinuju po potrebi za svaki routing combo — 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 u redosledu pipeline-a; svaki se nezavisno uključuje/isključuje i konfiguriše po combo-u:

#	Engine	Šta radi
1	Session-Dedup	Uklanja sadržaj koji se ponavlja kroz turnove (content-addressed, cross-turn)
2	CCR	Arhivira velike blokove iza retrieve markera, dohvata ih na zahtev
3	Lite	Skraćivanje whitespace-a + image-URL-ova (latency-light osnova)
4	RTK	Pametno filtriranje tool rezultata, dedup i skraćivanje (command-aware)
5	Responses Tool Output	Lossless-first JSON + ograničena dijagnostička kompresija za shell/patch/search/build izlaze (Responses API)
6	Headroom	Lossless tabelarno sažimanje JSON nizova (~30%) preko vendored GCF kodeka
7	Relevance	Ekstraktivno ocenjivanje rečenica u odnosu na poslednji korisnički upit
8	Caveman	Kompresija proze zasnovana na pravilima (~65–75% na izlazu)
9	Aggressive	Sumarizacija + progresivno starenje starih turnova
10	LLMLingua-2	ML semantičko obrezivanje preko MobileBERT ONNX — code-safe, async
11	Ultra	Heurističko obrezivanje tokena sa opcionim slojem malog modela (SLM)
12	OmniGlyph	Eksperimentalno kodiranje konteksta kao slike za izmereni Claude Fable 5 na direktnom Anthropic wire-u; GPT 5.6 transformer-i ostaju fail-closed dok ne stignu potvrde od provajdera. Četiri profila kompresije (aggressive podrazumevano, balanced, coding-safe, passthrough) (najagresivnije; opt-in)

Code blokovi, URL-ovi i strukturisani podaci su **uvek sačuvani** bajt-po-bajt. **Preseti na jedan klik** kombinuju engine-e:

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

**Stvarni primer — Standard režim:** > **Pre (69 tokena):** _"Razlog zašto se vaša React komponenta ponovo renderuje je verovatno to što kreirate novu referencu objekta u svakom render ciklusu. Kada prosledite inline objekat kao prop, React-ovo plitko poređenje ga svaki put vidi kao drugačiji objekat, što pokreće ponovni render. Preporučujem da koristite useMemo da memorišete objekat."_ > > **Posle (19 tokena):** _"Nova ref objekta svaki render. Inline object prop = nova ref = re-render. Obmotaj u useMemo."_ > > **Isti odgovor. 72% manje tokena. Nula gubitka tačnosti.** ✅ **PT-BR primer — [Troglodita](https://github.com/leninejunior/troglodita) režim:** > **Пре (42 токена):** _„Проблем је у томе што се компонента поново рендерује јер се у сваком циклусу рендеровања креира нова референца на објекат. Препоручио бих употребу useMemo.“_ > > **После (12 токена):** _„Поновно рендеровање: нова референца у сваком циклусу (поново креиран inline објекат). Користити `useMemo`.“_ > > **Исти одговор. ~70% мање токена. Техничка прецизност очувана.** ✅
### 🎚️ Више од механизама — стилови излаза, адаптивно подешавање и контрола по захтеву Горњих 12 механизама смањују оно што улази **на улазу**. Још три слоја обликују **како**, **када** и шта излази **на излазу**: - **🪄 Стилови излаза** _(усмеравање по оси излаза)_ — убацују детерминистичка упутства за обликовање одговора која не ремете кеширање; могу се комбиновати, а сваки има интензитет `lite` / `full` / `ultra`. Додавање стила захтева један ред у регистру: - **Сажета проза** — уклања поштапалице / чланове / ограђивање; технички садржај остаје прецизан. - **Мање кода** — YAGNI приступ „лењег искусног програмера“: најмања функционална измена, без незатражене пратеће структуре. - **Коњски реп (лењи искусни програмер)** — пење се YAGNI лествицом, отклања основни узрок, прави најмању функционалну разлику. - **Имам ADHD (прво радња)** — почиње следећом радњом, кораци су нумерисани, један конкретан следећи корак, без увода. - **Сажети CJK (文言)** — ултрасажети стил класичног кинеског (ограничен на локализацију `zh`). - **🎯 Адаптивни буџет контекста** _(регулатор)_ — уместо једног укљученог/искљученог прага токена, активира најјефтиније механизме са најмање губитака само онолико колико је потребно да би се садржај **уклопио у контекстни прозор модела**. Политика: `reserve-output` (подразумевано, прилагођено моделу) · `percentage` · `absolute`. Режим: `floor` (гарантује уклапање) · `replace-autotrigger` (ваш изричити избор има предност) · `off` (застарели праг). - **🎛️ Где се одлучује о компресији** _(приоритет, од највишег ка најнижем)_ — заглавље `x-omniroute-compression` по захтеву › замена за комбинацију рутирања › активни именовани профил › адаптивно / аутоматско активирање › подразумевана поставка панела › искључено. Примењени план враћа се у заглављу одговора `X-OmniRoute-Compression: ; source=`. Користите аутоматско активирање по прагу токена, укључите адаптивни регулатор, закачите именовани профил, задајте једнократно подешавање по захтеву или доделите ток обраде комбинацији рутирања — шта год одговара радном оптерећењу. Опциони офлајн **оквир за евалуацију** (`npm run eval:compression`) оцењује верност у односу на уштеду на фиксном корпусу пре него што унапредите измену. 📖 [`COMPRESSION_GUIDE.md`](docs/compression/COMPRESSION_GUIDE.md) · [`RTK_COMPRESSION.md`](docs/compression/RTK_COMPRESSION.md) · [`COMPRESSION_ENGINES.md`](docs/compression/COMPRESSION_ENGINES.md)

# ⚡ Брзи почетак

**1) Инсталирајте и покрените** ```bash npm install -g omniroute omniroute ``` > 💡 Видите `npm warn ERESOLVE` или упозорења о peer зависностима? [Безопасна су](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated). > **Користите npm 11 или новији?** npm може блокирати скрипте животног циклуса пакета ако нису дозвољене. OmniRoute скрипта `postinstall` (`node scripts/build/postinstall.mjs`) неопходна је за припрему његових изворних runtime датотека. При глобалној инсталацији дозволите пакете наведене у npm упозорењу. За скуп пакета који пријављује OmniRoute 3.8.53: > > ```bash > npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute > ``` > > Да бисте ову листу дозвољених пакета поново користили при будућим глобалним инсталацијама, подесите је једном, а затим инсталирајте на уобичајен начин: > > ```bash > npm config set allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild --location=user > npm install -g omniroute > ``` > > Листа зависности може се мењати између издања; ако npm пријави другачију листу, употребите називе пакета из тог упозорења. Дозвољавање пакета омогућава покретање његових инсталационих скрипти. > **Користите Gemini Web или другог добављача заснованог на веб колачићима?** npm пакет садржи > Playwright, али не и његову Chromium бинарну датотеку. Пре слања првог захтева веб добављачу погледајте > напомену о [подешавању Playwright Chromium-а](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium). Контролна табла је на `http://localhost:20128` · API је на `http://localhost:20128/v1`. **2) Повежите одговарајућег добављача помоћу сопственог налога** Контролна табла → **Добављачи** → изаберите добављача чији тренутни услови и квота одговарају вашем случају употребе → додајте његов API кључ или довршите поступак повезивања налога. Бесплатни пакети могу захтевати регистрацију, одобрење или начин плаћања. Прегледајте [Водич за бесплатне пакете](docs/getting-started/FREE-TIERS-GUIDE.md); доступност без кључа није загарантована, а добављачи означени са `tos: avoid` подразумевано су искључени из `auto`. **3) Усмерите свој алат за програмирање** ```txt Base URL: http://localhost:20128/v1 API Key: [copy from Dashboard → Endpoints] Model: auto (routes among eligible connections — or choose provider/model) ``` **4) Проверите да ли ради** ```bash curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY" ``` Требало би да видите листу повезаних модела. 🎉 То је све — почните да програмирате, а OmniRoute ће аутоматски рутирати захтеве и по потреби прелазити на резервне опције. Ако ваш клијент не може да шаље прилагођена заглавља, OmniRoute нуди и компатибилне алијасе са токенима: ```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 ``` Користите их само за клијенте који не могу да додају `Authorization: Bearer ...`. Потврда идентитета путем заглавља и даље је препоручени режим.
## 📦 Још начина инсталације — 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` прати највишу **објављену** стабилну SemVer верзију. Не прати git `main`. Закуцајте `:X.Y.Z` за GitOps. Погледајте [Канале издања за Docker](docs/guides/DOCKER_GUIDE.md#release-channels).Слика фиксира **`OMNIROUTE_MEMORY_MB=1024`**. То је довољно за контролну таблу и лагану преписку. **Агенти за кодирање** (`POST /v1/responses` из Claude Code, Codex, Grok, …) захтевају много већи V8 хеап, иначе процес доживи `FATAL ERROR` на ~12 GiB под два дуга контекста која се преклапају. Димензионишите контејнер изнад хеапа (нативни бафери се налазе изван V8): | Радно оптерећење | Хеап (`-e OMNIROUTE_MEMORY_MB`) | Контејнер (`--memory`) | | --------------------------------------- | ------------------------------- | ---------------------- | | Контролна табла / лагана преписка | `1024` (подразумевано за слику) | ≥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 — RAM у време извршавања](docs/guides/DOCKER_GUIDE.md#runtime-ram-for-coding-agents). > **Docker канал за претходна издања:** `diegosouzapw/omniroute:next` и > `diegosouzapw/omniroute:next-web` прате тренутну подразумевану грану `release/v*`. > Ове промењиве ознаке намењене су само за тестирање необјављених исправки и > **нису подржане за продукцију**. Погледајте > [Канале издања за Docker](docs/guides/DOCKER_GUIDE.md#release-channels). **🥟 Bun** Стандардни `bun install` и глобална инсталација (`bun install -g omniroute`) су подржани кроз детекцију Bun окружења: - **Уграђени `bun:sqlite`**: OmniRoute користи Bun-ов уграђени `bun:sqlite` драјвер када се извршава под Bun-ом, а враћа се на `better-sqlite3` на Node.js или `sql.js`. - **Аутоматски избор Webpack бандлера у развоју**: Развој (`bun run dev`) аутоматски детектује Bun и онемогућава Turbopack у корист Webpack-а како би се спречиле некомпатибилности нативних V8 везивања. Продукцијске изградње (`bun run build`) следе `OMNIROUTE_USE_TURBOPACK` потпуно исто као на Node-у: Turbopack је подразумеван, `OMNIROUTE_USE_TURBOPACK=0` за изградњу са Webpack-ом (`Dockerfile.bun` га излаже као `--build-arg`). - **Наменски Bun Dockerfile**: Вишефазна `Dockerfile.bun` за нативна 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 flake-ова nix develop npm run dev # Или коришћењем devbox-а devbox run npm run dev ``` 📖 [Водич за Docker](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. Поставите назнаку окружења, изградите локалну Compose слику и покрените 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](contrib/podman/README.md) — Compose изградње, Podman Machine и подешавање Linux/systemd Quadlet-а. **⚡ Бржа / лакша инсталација (прескочите нативну изградњу)** Нативни SQLite мотор (`better-sqlite3`) је **опциона** зависност, тако да се глобална инсталација никада не блокира на компајлирању из изворног кода: користи унапред изграђени бинарни фајл када одговара вашој платформи/Node-у, а у супротном се транспарентно враћа на чисто-JS мотор (`node:sqlite` на Node 22+, иначе уграђени `sql.js` WASM) — алати за изградњу нису потребни. Да у потпуности прескочите **нативно загревање** након инсталације (CI, без графичког интерфејса или споре машине). Напомена: ово прескаче само корак нативног SQLite загревања (`scripts/postinstall.mjs`); кука за копирање/поправку бинарног фајла (`scripts/build/postinstall.mjs`) се и даље извршава нормално: ```bash OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute # CI=1 такође га прескаче ``` За најбрже инсталације преферирајте **pnpm** (складиште са адресирањем садржаја + тврде везе — види горе). За извршавање без контролне табле и без графичког интерфејса користите Docker `base` профил (горе) или [водич за Termux](docs/guides/TERMUX_GUIDE.md). CLI и веб контролна табла се служе из истог процеса на једном порту, тако да данас не постоји засебан пакет само за CLI.

# 🎬 OmniRoute у акцији

## 📹 Видео-водичи

_{Снимак контролне табле од 2026-10-18 · Необрађени каталог: YT 1.352 | TT 334 | IG 290 · Свежина (дани): YT 5 | TT 48 | IG 49}

🎬 #1 — Instagram
_{nick_saraev — 3,042,474 прегледа}

🎬 #2 — Instagram
_{nnapier7 — 1,454,535 прегледа}

🎬 #3 — YouTube
_{Amidia AI & Tech — 794,974 прегледа}

🎬 #4 — Instagram
_{theopenstack — 692,419 прегледа}

🎬 #5 — TikTok
_{migue.baena — 685,788 прегледа}

**Комплетна ранг-листа (дедуплицирани канонски URL-ови, `v > 0`, највећи досег):** | #1 | #2 | #3 | #4 | #5 | | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | | [nick_saraev — Instagram](https://www.instagram.com/reel/Da8ZthUPK98/) — **3,042,474** | [nnapier7 — Instagram](https://www.instagram.com/reel/Dbp7wv_CIO0/) — **1,454,535** | [Amidia AI & Tech — YouTube](https://www.youtube.com/watch?v=NJ0TQ-pyMDY) — **794,974** | [theopenstack — Instagram](https://www.instagram.com/reel/DaSs65mMrHk/) — **692,419** | [migue.baena — TikTok](https://www.tiktok.com/@migue.baena/video/7670919268216622358) — **685,788** | | #6 | #7 | #8 | #9 | #10 | | ------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | | [milesreevesai — TikTok](https://www.tiktok.com/@milesreevesai/video/7667980059189366019) — **620,400** | [nikothetech — TikTok](https://www.tiktok.com/@nikothetech/video/7671890769665477918) — **610,803** | [Vaibhav Sisinty — YouTube](https://www.youtube.com/watch?v=QucgvbO5gsM) — **509,281** | [buildwithai.club — Instagram](https://www.instagram.com/reel/DbIt9AjK7-U/) — **347,652** | [nivedan.ai — Instagram](https://www.instagram.com/reel/DbIrCksJiqq/) — **331,973** | Канонске метрике на дан 2026-10-18: **1.976 јединствених видео-снимака** · **20.220.289 познатих прегледа** (`v > 0`) · **1.210 канала/профила по мрежи**. Необрађена контролна табла садржи 1.976 редова (YouTube 1.352 = 740 дугих видео-снимака + 612 Shorts · TikTok 334 · Instagram 290); након нормализације према канонском URL-у, која задржава највећи број прегледа по видео-снимку, није преостао ниједан дупликат. Прикупљање података са YouTube-а замрзнуто је на датум 2026-10-13 (квота API-ја исцрпљена од 14. до 18.10), а са TikTok-а/Instagram-а од 2026-09-02 (нема кредита за прикупљање); 76 видео-снимака још увек нема број прегледа. > 🎬 **Направили сте видео о OmniRoute-у?** Отворите [пријаву](https://github.com/diegosouzapw/OmniRoute/issues/new) или [дискусију](https://github.com/diegosouzapw/OmniRoute/discussions) са линком — представићемо га овде.

# 📧 Заједница и помоћ > Све на једном месту — пратите одржаваоца, разговарајте са заједницом или отворите пријаву. | Канал | Где / како | | ---------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- | | 💼 **LinkedIn** — пратите одржаваоца | [linkedin.com/in/diegosouzapw](https://www.linkedin.com/in/diegosouzapw/) | | 🐙 **GitHub** — пратите издања и савете | [@diegosouzapw](https://github.com/diegosouzapw) | | 💬 **Discord** | [discord.gg/U47eFqAXCn](https://discord.gg/U47eFqAXCn) | | ✈️ **Telegram** | [t.me/omnirouteOficial](https://t.me/omnirouteOficial) | | 🟢 **WhatsApp — 🌍 Глобално** | [придружите се групи](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) | | 🟢 **WhatsApp — 🇧🇷 Бразил** | [придружите се групи](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) | | 🌍 **Веб-сајт** | [omniroute.online](https://omniroute.online) | | 🌍 **🌍StHub OmniRoute заједница (бесплатно)** | [StHub портал](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK) | | 📦 **Изворни кôд** | [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute) | | 🐛 **Пријавите грешку** | [отворите пријаву](https://github.com/diegosouzapw/OmniRoute/issues) — приложите излаз команде `npm run system-info` | | 🤝 **Дајте допринос** | [CONTRIBUTING.md](CONTRIBUTING.md) · [Модел гранања и издавања](docs/ops/BRANCHING_MODEL.md) · изаберите `good first issue` | | 💚 **Подржите пројекат** | [Начини да пружите подршку ↑](#-support-omniroute) · [GitHub Sponsors](https://github.com/sponsors/diegosouzapw) |

---

## 🛠️ Технолошки стек

Слој	Технологија
Извршно окружење	Node.js 22.x / 24.x LTS — `>=22.22.2 <23 \|\| >=24.0.0 <27`
Језик	TypeScript 6.0 — 100% TypeScript у `src/` и `open-sse/` (нула `any` у језгру од v2.0)
Оквир	Next.js 16 + React 19 + Tailwind CSS 4
База података	better-sqlite3 (SQLite, WAL журналисање) + LowDB (JSON, наслеђе) — 147 доменских модула, 209 миграција
Меморија	SQLite FTS5 пунотекст + int8-квантизовани векторски embedding-и, типизирано слабљење
Шеме	Zod 4 — валидација улаза/излаза MCP алата + API уговори
Протоколи	MCP (stdio / HTTP / SSE) + A2A v0.3 (JSON-RPC 2.0 + SSE)
Стримовање	Server-Sent Events (SSE) + WebSocket мост (`/v1/ws`)
Компресија	пајплајн од 12 мотора — RTK, Caveman, LLMLingua-2 (MobileBERT ONNX), GCF, OmniGlyph
Аутентификација и безбедност	OAuth 2.0 (PKCE) + JWT + API Keys + MCP аутентификација са ограничењима · AES-256-GCM у мировању · DOMPurify
Стелт	wreq-js — JA3 / JA4 TLS емулација отиска прста, прокси са 3 нивоа
Отпорност	Прекидач кола, експоненцијално одлагање, заштита од налета гомиле (anti-thundering-herd), самоисцељење auto-combo
Логовање	pino — структурисани JSON логови са контекстом захтева
Тестирање	Node.js test runner + Vitest — 56.000+ статичких декларација тестова у 7.800+ евидентираних тест датотека (јединични, интеграциони, E2E, безбедносни, екосистемски)
Платформе	Десктоп (Electron) · Android (Termux) · PWA (било који прегледач)
CI/CD	GitHub Actions — аутоматско npm објављивање + Docker Hub при издању
Линкови	Веб-сајт · npm · Docker Hub

## 📖 Документација

### 📘 Почетак рада

Документ	Опис
Кориснички водич	Провајдери, комбинације, CLI интеграција, примена
Водич за подешавање	Сви начини инсталације, конфигурације CLI алата, подешавање протокола, оптимизација временских ограничења
Водич за CLI алате	Подешавање по алату за Claude Code, Codex, Cursor, Cline, OpenClaw, Kilo, Copilot
Удаљени режим	Управљајте удаљеним OmniRoute-ом (VPS) са CLI-ја на лаптопу помоћу приступних токена ограниченог опсега
Конфигурација Claude Code-а	Повежите Claude Code са OmniRoute-ом (локалним/удаљеним) помоћу `launch` + профила за сваки модел
Брзи почетак	Инсталација у 3 корака → повезивање → конфигурисање

### 🔧 Рад и примена

Документ	Опис
Водич за Docker	Docker покретање, Compose профили, Caddy HTTPS, тунели, ознаке слика
Водич за Podman	Quadlet systemd интеграција, podman-compose, SELinux
Примена на виртуелној машини	Комплетан водич: подешавање виртуелне машине + nginx-а + Cloudflare-а
Примена на Fly.io	Примена на Fly.io са трајним складиштем
Водич за Termux	Покретање OmniRoute-а на Android-у путем Termux-а
Водич за PWA	Инсталација прогресивне веб-апликације, кеширање, архитектура
Водич за деинсталацију	Чисто уклањање за све начине инсталације
Конфигурација окружења	Комплетне променљиве и референце за `.env`

### 🧠 Функције и архитектура

Документ	Опис
Архитектура	Архитектура система, ток података и унутрашњи механизми
Водич за компресију	Процес са 7 опција: искључено / лагано / стандардно / агресивно / ултра / RTK / наслагано
RTK компресија	Компресија излаза команди, филтери, поверење, верификација, опоравак необрађеног излаза
Механизми за компресију	Caveman, RTK, наслагани процеси, контролна табла/API/MCP интерфејси
Формат правила компресије	JSON шеме пакета правила за Caveman и RTK филтере
Језички пакети за компресију	Препознавање језика и израда Caveman пакета правила
Водич за отпорност	Прекидачи кола, периоди хлађења, ред чекања, спречавање наглог истовременог оптерећења, TLS лажирање
Механизам аутоматског комбиновања	Бодовање на основу 16 фактора, пакети режима, самоопоравак
Водич за прокси	Прокси систем са 3 нивоа, 1proxy тржиште, CRUD регистра
Бесплатни нивои	Обједињени директоријум: 34 документована понављајућа скупа / 471 каталогизован унос бесплатног нивоа
Галерија функција	Визуелни обилазак контролне табле са снимцима екрана
Документација базе кода	Преглед базе кода прилагођен почетницима

### 🤖 Протоколи и API-ји

Документ	Опис
API референца	Све крајње тачке са примерима
OpenAPI спецификација	OpenAPI 3.0 спецификација
MCP сервер	110 MCP алата, IDE конфигурације, Python/TS/Go клијенти
Водич за MCP сервер	MCP инсталација, транспорти и референца алата
A2A сервер	JSON-RPC 2.0 протокол, вештине, стримовање, управљање задацима
Водич за A2A сервер	A2A картица агента, задаци, вештине и стримовање

### 📋 Пројекат и квалитет

Документ	Опис
Доприношење	Подешавање развојног окружења и смернице
Модел гранања и издавања	Ка којим гранама се усмеравају PR-ови (`release/*`) и шта означавају `main` и ознаке
Дневник измена	Комплетна историја издања по верзијама
Безбедносна политика	Пријављивање рањивости и безбедносне праксе
Водич за i18n	Подршка за 67 језика, ток превођења, RTL
Контролна листа за издавање	Кораци валидације пре издавања
План покривености	Стратегија покривености тестовима за више од 56,000 статичких декларација тестова у више од 7,800 праћених тестних датотека

# ⭐ Најбољи сарадници > OmniRoute обликује посвећена заједница отвореног кода. Ови појединци су дали изузетне доприносе који директно утичу на квалитет, стабилност и домет пројекта. **Хвала вам.** ### Спољни сарадници према броју спојених pull request-ова

Ранг	Сарадник	Спојени PR-ови	~Измењених линија
1	maxmad64bis	371	25,326,561
2	HouMinXi	269	13,456,272
3	backryun	210	270,562
4	oyi77	190	411,243
5	pacocartones	174	78,276
6	JxnLexn	151	3,562,936
6	KooshaPari	151	5,972,314
8	rdself	145	80,663
9	RaviTharuma	123	500,065
10	herjarsa	88	230,872
11	hartmark	84	2,849,554
12	jonlwheat2-gif	67	68,548
13	artickc	62	43,502
14	chirag127	52	6,661
15	xz-dev	50	245,976
16	xiaoyaner0201	47	33,626
17	woodsonl	46	809,391
18	rqzbeh	44	147,896
19	QuangBlue	43	13,112
20	MumuTW	40	26,093

_{Попис је обављен 2026-10-18 15:09:09 UTC на актуелном врху гране release/v3.8.52, 656f01cb43. Страничени GitHub GraphQL попис садржи 9,191 спојених PR-ова: 3,834 аутора власника репозиторијума, 229 Dependabot-а, 6 других ботова/апликација и 5,122 спољна PR-а од 835 различитих сарадника. „Измењене линије“ представљају збир додавања и брисања на GitHub-у и обухватају генерисане датотеке, lockfile датотеке, каталоге, преводе и документацију; то је обим измена, а не број линија изворног кода које су аутори написали. За 49 PR-ова GitHub пријављује разлике веће од 500,000 линија (на пример, #13399, додавање једног провајдера, наводи 2,347 измењених датотека), што увећава неколико горенаведених збирова. У случају истог резултата, сарадници деле ранг.} ### Комитови приписани на GitHub-у

Dizzle _{🥇 367 комитова приписаних на GitHub-у}	Bob.Hou _{🥈 269 комитова приписаних на GitHub-у}	Paijo _{🥉 229 комитова приписаних на GitHub-у}	backryun _{🏅 202 комита приписана на GitHub-у}	Paco Cartones _{🏅 174 комита приписана на GitHub-у}	Ravi Tharuma _{🏅 126 комитова приписаних на GitHub-у}
Markus Hartung _{🏅 114 комита приписана на GitHub-у}	Randi _{🏅 108 комитова приписаних на GitHub-у}	Jan Leon _{🏅 87 комитова приписаних на GitHub-у}	Chris _{🏅 70 комитова приписаних на GitHub-у}	Koosha Paridehpour _{🏅 68 комитова приписаних на GitHub-у}

_{Поново проверено 2026-10-18 14:44:45 UTC: комитови приписани на GitHub-у које је API сарадника репозиторијума пријавио за подразумевану грану release/v3.8.52. API је вратио 849 идентитета (429 корисника, 2 бота, 418 анонимних); ова табела изоставља одржаваоца, ботове и анонимне идентитете и задржава изједначења у рангирању. Разликује се и од горенаведеног рангирања спојених PR-ова и од доленаведеног пописа Git метаподатака.} > 🙏 Функционалности, исправке грешака и побољшања инфраструктуре ових сарадника представљају **кључни део** онога што OmniRoute чини поузданим и богатим функционалностима. Сваки pull request, сваки тестни случај и свака i18n датотека превода су важни. Отворени код граде људи попут њих.

---
## 💖 Спонзори

Од срца хвала људима који финансирају OmniRoute из сопственог џепа — сваки допринос помаже да пројекат остане бесплатан, независан и настави да се развија.

Andrew _{💛 Активни месечни спонзор}	Vlad I _{💛 Активни месечни спонзор}	小妍儿 _{💛 Активни месечни спонзор}	Guilherme Costa _{💛 Активни једнократни спонзор}	Henrique Iurkiv _{💛 Активни једнократни спонзор}	Somesh Ghaturle _{💛 Активни једнократни спонзор}
Kolonie AI _{💛 Ранији једнократни подржавалац}	Prof. Igor Morais _{💛 Ранији једнократни подржавалац}	Pixma _{💛 Ранији једнократни подржавалац}	Paco Cartones _{💛 Ранији једнократни подржавалац}	longtao _{💛 Ранији једнократни подржавалац}

_{… и другима који желе да остану анонимни 💛} _{Јавни GitHub спонзори поново су проверени 2026-10-18 путем GitHub Sponsors GraphQL API-ја: 11 јавних спонзорстава (6 активних, 5 ранијих) од укупно 14. GitHub-ов статус isActive одређује горенаведене ознаке активности; ранијим јавним једнократним подржаваоцима и даље се захваљујемо, док приватни спонзори остају анонимни. Донације путем Ko-fi, Buy Me a Coffee, Liberapay, PIX и криптовалута нису наведене јер за њих не постоји јавни запис о спонзору.} 💖 Постаните спонзор → — сваки долар помаже да OmniRoute остане бесплатан и независан.

## 👥 900+ сарадника

[![Сарадници](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=993&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors) _{Проверено 2026-10-18 на актуелном врху гране release/v3.8.52, при комиту ad160ab2d1 (6.826 комитова): 993 нормализована људска Git идентитета — 707 се појављује као аутори комитова (укључујући одржаваоца), а 286 само у експлицитним Co-authored-by завршним напоменама. Попис примењује .mailmap, пореди адресе е-поште без обзира на велика и мала слова, спаја нумеричке и обичне GitHub noreply адресе само када кодирају исто корисничко име, изузима 26 идентитета ботова/агената/сервиса/заменских вредности и не спаја обичне адресе е-поште само зато што им се приказана имена подударају. Провером од 2026-08-24 објављено је 639; поновна примена ове методе на основу те провере, ac02c5b42f, даје 619, тако да повећање потиче од нових сарадника, а не од мање строгог метода.} ### Како да допринесете 1. Направите форк репозиторијума 2. Направите грану од врха **активне** гране `release/vX.Y.Z` (не од `main`) — погледајте [Модел гранања и издавања](docs/ops/BRANCHING_MODEL.md) 3. Направите своју грану за функционалност (`git checkout -b feat/amazing-feature`) 4. Комитујте измене (`git commit -m 'feat: add amazing feature'`) 5. Отпремите грану (`git push origin feat/amazing-feature`) 6. Отворите захтев за преузимање измена са **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-ја 18. октобра 2026. — подржите ове пројекте звездицом. Наведени бројеви представљају тачан снимак стања на тај датум и природно ће се мењати. ### 🧬 Порекло и мрежни пролаз

Пројекат	⭐	Како је инспирисао OmniRoute
9router	31,004	Оригинални пројекат на којем је овај форк заснован — овде проширен мултимодалним API-јима и потпуним преписивањем у TypeScript-у.
CLIProxyAPI	55,591	Имплементација у језику Go која је инспирисала овај JavaScript / TypeScript порт.
LiteLLM	61,482	AI мрежни пролаз чији јавни скуп података о ценама напаја нашу синхронизацију праћења трошкова и чији је модел нормализације добављача утицао на наше усмеравање.
codex-chatgpt-web	14,526	MIT изворни код прилагођен за уграђени мост ChatGPT Web → Codex Responses, укључујући адаптере за сесије прегледача, уоквиравање одговора, коришћење и веб-претрагу.
free-claude-code	61,430	Обрасци пренети у опоравак стрима, псеудониме без размишљања, резервну веб-претрагу, ограничења клизног прозора, редакцију евиденције и ојачане токове покретача.
composer-api	346	Обрасци избора алата, ограничења излаза и потврђивања алата из Cursor Composer-а прилагођени су изворном Cursor извршавачу.
codex-multi-auth	553	Обрасци новог пријављивања и ротације токена за освежавање пренети су у Codex OAuth поновну аутентификацију.
opencode-anthropic-auth	558	Подразумеване вредности трансформације компатибилне са Claude Code-ом и понашање заглавља за наплату уопштени су у OmniRoute-ов мост вођен конфигурацијом.
grok2api-merged	2	Његова мапирања Grok модела, Statsig генератор лажног TypeError-а, подразумеване вредности захтева и уређаја, као и NDJSON процесор одговора, у значајној мери су прилагођени за OmniRoute-ов Grok Web извршавач.
TQZHR/grok2api	706	Главни посредни извор кода на којем је заснован grok2api-merged; његове имплементације модела, заглавља, корисног садржаја, Statsig-а и процесора сачуване су у пореклу компоненте Grok Web.
chenyme/grok2api	7,819	Основни MIT изворни код за подразумеване вредности Grok корисног садржаја и уређаја, Statsig генератор и `result.response` процесор, пренет кроз TQZHR и grok2api-merged.
grok2api-pro	27	Посредни извор који grok2api-merged наводи за свој слој скупа проксија; OmniRoute задржава ту напомену о пореклу, али не тврди да је портовао скуп проксија у свом ограниченом Grok Web извршавачу.
GrokProxy	51	Његов Grok прокси са аутентификацијом путем колачића и образац стримовања `result.response.token` утицали су на OmniRoute-ов Grok Web транспорт.
GrokBridge	5	Оригинална Grok Web имплементација ослањала се на његов дизајн узводне HTTP/прегледачке комуникације; њена директна HTTP путања изведена је из GrokProxy-а, па се не тврди да је извршен независан порт кода.

### 🗜️ Компресија контекста и токена — механизми

Пројекат	⭐	Како је инспирисао OmniRoute
Caveman	113,396	Вирални пројекат „зашто користити много токена кад мало токена ради посао“ — његова филозофија пећинског говора покреће наш стандардни режим компресије и више од 30 правила за уклањање сувишних речи и сажимање.
RTK – Rust Token Killer	83,835	Компресија излаза команди високих перформанси — инспирисала је наш RTK механизам, DSL за JSON филтере, опоравак сировог излаза и сложени RTK → Caveman ток обраде.
headroom	75,741	Реверзибилна компресија контекста (SmartCrusher) — инспирисала је наш `headroom` механизам и образац маркера за преузимање `ccr`.
LLMLingua	6,757	Истраживање компресије упита (LLMLingua / LLMLingua-2) — инспирисало је наш асинхрони `llmlingua` механизам који безбедно рукује кодом и у случају грешке пропушта оригинални садржај.
llmlingua-2-js	32	JS/ONNX порт (MobileBERT / XLM-RoBERTa) који се користи као позадински систем радне нити за наш LLMLingua механизам.
Troglodita	50	Компресија токена за pt-BR — покреће наш pt-BR језички пакет: смањивање плеоназама и уклањање сувишних речи прилагођено граматици бразилског португалског.
ponytail	166,731	Вирална вештина YAGNI кодера „лењег старијег програмера“ — инспирисала је наш less-code стил излаза: усмеравање ка најмањој функционалној измени које смањује _генерисани_ код (пандан Caveman-овој сажетој прози на оси излаза).
i-have-adhd	57,628	Његов стил одговора прилагођен особама са ADHD-ом, који прво истиче радњу, прилагођен је у сажети стил излаза OmniRoute-а на пет језика.

### 🧩 Компактни формати, истраживање токена и алати који разумеју код

Пројекат	⭐	Како је инспирисао OmniRoute
TOON	25,509	Објектна нотација оријентисана на токене — њен колонарни модел са заглављем и редовима обликовао је нашу фазу табеларног сажимања.
GCF – Graph Compact Format	59	Његов компактни формат графова и дизајн генеричког профила утицали су на табеларно сажимање OmniRoute-а и формат Headroom кодека.
gcf-typescript	4	MIT TypeScript имплементација која је директно укључена у пројекат и проширена као Headroom кодек генеричког профила.
token-optimizer-mcp	551	Brotli/SQLite кеш + разлика контекста по сесији — инспирисали су наш `session-dedup` механизам.
token-savior	1,182	Сажимање Bash излаза + MCP профили — инспирисали су нашу дисциплину одустајања од компресије и смањивање MCP манифеста алата.
token-saver	154	Компресија излаза која узима у обзир садржај и тип сваке датотеке, уз одустајање у случају грешке — потврдила је наш избор обраде по типу и прескакање када није остварена минимална уштеда.
token-optimizer	2,595	„Пронађи токене духове“ — његов образац измештања и повратљивих ручки утицао је на наш приступ CCR измештању.
TokenMizer	33	Нацрт заснован на графу сесије и уклањању дупликата редова између интеракција, који је утицао на наш дизајн механизма session-dedup.
OmniCompress	3	Колонарни JSON у Rust-у + преузимање адресирано садржајем + уклањање дупликата између порука — потврдили су дизајн наших механизама `headroom`/`ccr`/`session-dedup` и инваријанту стабилности кеша „компримовани облик не зависи од позиције“.
mcp-compressor	133	Компресија шема и описа MCP алата — утицала је на наше смањивање кардиналности манифеста MCP алата.
RepoMapper	217	Рангирање мапе репозиторијума у Aider стилу — утицало је на наше истраживање мапирања репозиторијума и рангирања преузимања.
quiet-shell-mcp	4	Декларативно смањивање излаза љуске преко MCP-а — потврдило је наше декларативно сажимање Bash излаза.
ts-morph	6,205	Скуп алата за TypeScript Compiler API — инспирисао је наше уклањање коментара засновано на парсеру, које чува литерале ниски, шаблона и регуларних израза.

### 🧠 Меморија и RAG

Пројекат	⭐	Како је инспирисао OmniRoute
Mem0	67,385	Универзални слој меморије — његов модел проксија као границе за упис/читање обликовао је нашу архитектуру меморије.
Letta (MemGPT)	25,179	Агенти са стањем и вишеслојном меморијом — инспирисали су наш вишеслојни модел контроле и опоравка контекста (CCR).
WFGY	1,800	ProblemMap таксономија 16 понављајућих режима отказа RAG/LLM система — заједнички речник у нашем водичу за решавање проблема.

### 🛰️ Инспекција саобраћаја, MITM и транспарентни прокси

Пројекат	⭐	Како је инспирисао OmniRoute
llm-interceptor	79	MITM пресретање/анализа саобраћаја између помоћника за програмирање и LLM-а утицали су на ране захтеве за Traffic Inspector. Четири раније изведена модула — спајање SSE токова, нормализација разговора, маскирање тајни и санитизација заглавља — замењена су независним имплементацијама развијеним од нуле на основу јавних стандарда протокола. Две површине за директно прослеђивање ка хосту (`passthrough.ts` и `_internal/bypass.cjs`) остају интерне OmniRoute имплементације које су независно класификоване; оне нису поново написане у оквиру те замене.
ProxyBridge	6,814	Транспарентно усмеравање проксија по процесу — инспирисало је наше безбедно гашење MITM-а у случају отказа, временска ограничења неактивности сокета, приписивање процеса путем `/proc` и TPROXY пресретање.

### 📚 Подаци о моделима, опсервабилност и кориснички интерфејс

Пројекат	⭐	Како је инспирисао OmniRoute
models.dev	7,286	Отворена база спецификација, цена и могућности AI модела — изворно синхронизована са нашим каталогом модела.
React Flow / xyflow	38,705	Библиотека графова заснована на чворовима која покреће наше студије Compression Studio и Combo/Routing Studio у реалном времену.
LangGraph	43,443	LangGraph Studio визуелизација графа тока рада уживо инспирисала је приказ каскаде у реалном времену у нашим студијима.
Langfuse	35,990	Његов модел опсервабилности траг → распон → генерисање обликовао је водопадни приказ у нашем Compression Studio-у.
Kiali	3,645	Опсервабилност Istio услужне мреже — инспирисала је наше значке прекидача кола и визуелне приказе грана са грешкама у Routing/Combo Studio-у.
lobe-icons	2,615	Логотипи AI/LLM брендова који приказују иконе добављача на нашој контролној табли.
flag-icons	12,473	Обезбеђује SVG заставе под MIT лиценцом које користи бирач језика у README датотеци.

### 🛡️ Безбедност

Пројекат	⭐	Како је инспирисао OmniRoute
awesome-secure-defaults	722	Пажљиво одабрана листа библиотека које су подразумевано безбедне и усмерава наше безбедносне изборе (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).

### 🧭 Комплементарни алати

Пројекат	⭐	Како је инспирисао OmniRoute
ClawRouter	6,628	Инспирисао је дедупликацију захтева, резервну опцију без трошкова за хитне случајеве, прикључиве Auto-Combo стратегије и вишејезичку класификацију намера.
Antigravity-Manager	32,333	Његово поновно мапирање модела које узима у обзир налог, валидација путање извршне датотеке и понашање ознака плана утицали су на Antigravity извршно окружење у OmniRoute-у.
vscode-antigravity-cockpit	4,850	Његов компактни формат одбројавања до ресетовања квоте инспирисао је одговарајући приказ ограничења добављача у OmniRoute-у.
AionUi	33,611	Његове ACP интеграције инспирисале су аутоматско откривање инсталираних CLI агената у OmniRoute-у.
CodexBar	22,616	Идентификовао је интерфејс квоте за Grok Build; OmniRoute је затим независно проверио и исправио формат података који се преноси.

## 📄 Лиценца MIT лиценца – погледајте [LICENSE](LICENSE) за детаље. ---

**[⬆ Назад на врх](#-omniroute)** · Направљено са ❤️ за open-source AI заједницу. _{OmniRoute v3.8.53 · Node ≥22.22.2 · MIT лиценца · omniroute.online}