# README (Български) 🌐 **Languages:** 🇺🇸 [English](../../../README.md) · 🇪🇹 [am](../am/README.md) · 🇸🇦 [ar](../ar/README.md) · 🇦🇿 [az](../az/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) · 🇷🇸 [sr](../sr/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 каталогизира **467 записа за безплатни планове в 34 ключа за периодично възобновявани пулове** и изчислява обявения брой токени въз основа на **17-те пула с публикуван положителен месечен бюджет плюс пет лимита на Groq за отделни модели**, като премахва дублирането при споделени пулове. Квотите, които стават достъпни само след регионална проверка на самоличността (в момента: ModelScope), са показани отделно — +~6 млн. след регионална проверка на самоличността — и никога не се включват в обявената обща стойност. Резултатът остава видим в таблото за управление (`/dashboard/free-tiers`).

Карта на бюджета за безплатни планове на OmniRoute: устойчиво ~1,62 млрд. безплатни токена на месец и до ~2,22 млрд. през първия месец с кредити при регистрация, от 34 документирани ключа за периодично възобновявани пулове, обхващащи 467 каталогизирани записа за безплатни планове зад една крайна точка. Честно изчисление с премахване на дублирането по пулове — всеки споделен пул се отчита веднъж, включително 17 периодично възобновявани пула с публикуван положителен месечен бюджет от токени плюс пет лимита на Groq за отделни модели; 12 доставчици са отбелязани за избягване в каталога за рискове в условията, така че вие решавате. Лентата на бюджета включва Mistral 1 млрд., Nara 210 млн., LLM7 150 млн., xKiro 150 млн., Groq 30 млн. (пет лимита за отделни модели) и по-малки пулове, както и кредити за регистрация през първия месец и постоянно безплатни доставчици без лимит на токените, показани отделно, за да не завишават никога обявената обща стойност. Използвани/оставащи в реално време на /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 | 🆕 по избор | ✓ | ✓ | | ⚖️ Планиране със съобразяване с квотите | 🆕 Quota-Share | ✓ | ✓ | | 📊 Телеметрия за квоти | 🆕 на живо | ✓ | ✓ | | 🧰 Режим без интерфейс | — | — | 🆕 `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 ключ от Dashboard → Endpoints: 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 Smart Router (RTK + Caveman компресия, 20 стратегии за маршрутизиране, circuit breakers, TLS stealth, MCP, A2A, guardrails) може да превключва резервно през 4 нива на доставчици, докато има подходяща здрава цел — Ниво 1 Абонамент, Ниво 2 API ключ, Ниво 3 Евтино и Ниво 4 Безплатно.

## 🤝 С подкрепата на нашите приятели на отворения код

> **Искате да се присъедините като приятел на отворения код?** Това са компаниите, които подкрепят отворения код и помагат за развитието на OmniRoute — а ние публично посочваме за какво се използва всеки токен, който ни предоставят. Свържете се с нас: [diegosouza.pw@outlook.com](mailto:diegosouza.pw@outlook.com)

Kimi
_{Moonshot AI} Благодарим на Kimi (Moonshot AI), нашия основополагащ приятел на отворения код, за подкрепата на този проект! Kimi е лабораторията за ИИ зад семействата модели с отворени тегла K2 и K3 — Kimi K3 предоставя контекстен прозорец от 1M токена, вградени визуални възможности и програмиране на най-високо ниво на цена, която е само малка част от тази на затворените модели, и работи веднага с Claude Code, Codex и всеки инструмент за програмиране, обслужван от OmniRoute.

Какво осигурява подкрепата на Kimi: API кредитите на Kimi захранват процеса на OmniRoute за издания, валидиран от ИИ — етапа валидиране на сливането, задвижвано от 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: Chat Completions, нативната крайна точка /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: Chat Completions, форматът за комуникация, съвместим с 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 ще изгради виртуална комбинация от свързаните ви доставчици, оценявани в реално време:

ИД на модела	Какво оптимизира
`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** — незабавно, без такси (Бразилия) PIX QR код на OmniRoute

Ключ (случаен): `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-ата комбо стратегия пропуска изчерпаните акаунти, след което тегли сред останалите пропорционално на остатъчната квота ÷ текущото натоварване, запазвайки съществуващите разговори фиксирани. → [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 ключ към един модел или комбо с `forcedModel` и добавяйте или премахвайте моделите и комботата на даден ключ атомарно (`/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 и панел в таблото с гласов чат с push-to-talk на Faro. → [A2A Server](docs/frameworks/A2A-SERVER.md) - **🛂 Адаптивно приемане и защита от претоварване** — тежките чат заявки се нареждат на опашка вместо да връщат 503, с атомарни RPM подвижни наеми за всяка връзка. → [Resilience Guide](docs/architecture/RESILIENCE_GUIDE.md) - **🗂️ Канонично подреждане на `/v1/models`** — един непрекъснат блок, групиран по доставчик, за всеки доставчик (комботата са фиксирани първи), стабилно във всеки източник на каталог. → [API Reference](docs/reference/API_REFERENCE.md) - **🗜️ Затягане на компресията** — защита срещу раздуване, включена по подразбиране, Caveman пакети за DE / FR / JA + китайски (wényán), RTK филтри за Gradle & .NET. → [Compression](docs/compression/COMPRESSION_ENGINES.md) - **💸 Честна цена при фиксирана тарифа** — доставчиците с абонамент / план за кодене се отчитат като **$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`) + OAuth помощник `antigravity` за VPS инсталации. → [Remote Mode](docs/guides/REMOTE-MODE.md) - **🧭 По-умно автоматично маршрутизиране** — комбота `auto/:`, **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, които пренебрегват прокси env променливите, със CA за всеки SNI + инсталатор за хранилището за доверие. → [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 набор), предпазна мярка за маскиране на идентификационни данни по избор (скрива изтекли 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) - **🌍 Внедряване и операции** — `basePath` за обратно прокси, автоматично откриване на езика на браузъра, проследяване на устройства за всеки ключ, MITM доверие без root, локализация zh-TW. → [Environment](docs/reference/ENVIRONMENT.md) - **🤝 Още доставчици и агенти** — облачни агенти (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` + фактор `cacheAffinity` на Auto-Combo връщат повторните заявки обратно към връзката, държаща кеширания префикс, а endpoint-ът само за четене `/v1/auto-combo/{channel}/candidates` показва живия набор от кандидати на канал `auto/*`. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **⚡ Локална производителност и инфраструктура** — локален Redis с едно кликване, деплойъри на Cloudflare Workers / Deno Deploy relay, Bifrost и Mux като supervised вградени услуги. → [Вградени услуги](docs/frameworks/EMBEDDED-SERVICES.md) - **🧩 Още в комплекта** — плъгин рамка + пазар, рамки за умения Omni/Agent/GitHub, интеграция с Obsidian vault (22 MCP инструмента), OpenAI-съвместими Batch и Files API, семантичен кеш на отговори, геймификация с класации, откриване на агенти чрез ACP (15 вградени агента), планиран експорт на логове към BigQuery, паралелно разклоняване към множество модели с `auto/chaos`, мост за Telegram бот, вграден мениджър на версии и класации на безплатни доставчици по 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 регистрирани доставчика** в каноничните колекции chat, media, search, local, cloud-agent и system, включително **153 с метаданни за откриване `hasFree: true`**. Регистърът на chat моделите покрива **239 доставчика / 3,059 отделни двойки доставчик-модел / 1,475 сурови ID на модели**; отделният каталог за безплатен бюджет има **467 реда на модел**, **34 повтарящи се пула** и **51 повтарящи се/безключови безплатни завинаги доставчика**. Това са различни знаменатели по дизайн; дефинициите и изчисленията с дедупликация на пулове се намират в [Provider Reference](docs/reference/PROVIDER_REFERENCE.md) и [Free Tiers](docs/reference/FREE_TIERS.md).

### 🏢 Всяка голяма лаборатория — през един endpoint

_OpenAI	_Anthropic	_Gemini	_{xAI Grok}	_DeepSeek	_Mistral
_Qwen	_{Meta Llama}	_Groq	_NVIDIA	_MiniMax	_Cohere
_Perplexity	_HuggingFace	_Together	_Fireworks	_Cloudflare	_Baidu

_{…и още 350+ — всяка икона се зарежда на живо от каталога с доставчици на таблото. 📖 [Provider Reference](docs/reference/PROVIDER_REFERENCE.md)}
### 🆓 Безплатно завинаги — $0, без карта

OpenCode Zen _{DeepSeek V4, Nemotron 3 Без ограничение на токени}	Kilo Code _{Auto-router, 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 неврона/ден}	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…

От самия редактор: отворете изгледа **Разширения**, потърсете **„OmniRoute“** и щракнете върху **Инсталиране** — работи по един и същ начин и в двата магазина. Изходният код, проблемите и ръководството за публикуване се намират в [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`; маршрутите, стартиращи процеси, остават достъпни само през loopback. _{📖 [Отдалечен режим](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**, **webhooks** или **отдалечен 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
🔔 Webhooks	`/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)}

## 🗜️ Спестете 15–95% токени — автоматично

### 📖 Как работи — конвейер, архитектура и изчисляване на спестяванията

Конвейер за компресиране на OmniRoute: илюстративна клиентска заявка от 10 000 токена преминава през 12 комбинируеми механизма — Session-Dedup, CCR, Lite, RTK, Responses Tool Output, Headroom, Relevance, Caveman, Aggressive, LLMLingua-2, Ultra и OmniGlyph — и в документирания пример с последователно прилагане може да достигне до доставчика с около 1 080 токена. Структурираното съдържание е защитено чрез механизми за запазване и проверки за точност на всяка стъпка; изрично активираните режими със загуби или експериментални режими могат да преобразуват подходящото съдържание.

Комбинацията по подразбиране изпълнява последователно `RTK → Caveman`. Когато и двата механизма обработват едни и същи данни от инструмент или контекст, спестяванията се натрупват: ```txt combined = 1 − (1 − RTK) × (1 − Caveman_input) average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2% range = 78.4 – 94.6% ``` Блоковете с код, URL адресите, JSON и структурираните данни са **винаги защитени** от механизма за запазване. > **Защо да използвате много токени, когато малко вършат същата работа?** Всяка заявка преминава **прозрачно** през конвейера за компресиране на OmniRoute — без промени в клиента. Това вече е **стек от 12 комбинируеми механизма**, които се изпълняват последователно и могат да се съчетават за всяка комбинация за маршрутизиране — надграждайки идеите от [RTK](https://github.com/rtk-ai/rtk), [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ 90K+), [LLMLingua-2](https://github.com/microsoft/LLMLingua) и [Troglodita](https://github.com/leninejunior/troglodita) (PT-BR). ### 🧱 Стекът от 12 механизма Механизмите се изпълняват по реда на конвейера; всеки може да бъде включван или изключван и конфигуриран независимо за всяка комбинация:

#	Механизъм	Какво прави
1	Session-Dedup	Премахва съдържанието, което се повтаря между отделните реплики (адресирано по съдържание, между реплики)
2	CCR	Архивира големи блокове зад маркери за извличане, достъпвани при поискване
3	Lite	Съкращаване на празните пространства и URL адресите на изображения (базов режим с ниска латентност)
4	RTK	Интелигентно филтриране, дедупликация и съкращаване на резултатите от инструменти (с отчитане на командата)
5	Responses Tool Output	JSON обработка без загуби като първи избор и ограничено диагностично компресиране на изходни данни от обвивки, корекции, търсене и компилации (Responses API)
6	Headroom	Таблично уплътняване без загуби на JSON масиви (~30%) чрез вграден GCF кодек
7	Relevance	Оценяване и извличане на изречения спрямо последната потребителска заявка
8	Caveman	Компресиране на проза чрез правила (~65–75% при изходните данни)
9	Aggressive	Обобщаване и постепенно съкращаване на старите реплики
10	LLMLingua-2	Семантично съкращаване чрез машинно обучение с MobileBERT ONNX — безопасно за код и асинхронно
11	Ultra	Евристично съкращаване на токени с незадължително ниво с малък модел (SLM)
12	OmniGlyph	Експериментално кодиране на контекста като изображение за измерения Claude Fable 5 по директната връзка с Anthropic; трансформаторите GPT 5.6 остават затворени при грешка до получаването на потвърждения от доставчика. Четири профила за компресиране (агресивен по подразбиране, балансиран, безопасен за код, без обработка) (най-агресивният; с изрично активиране)

Блоковете с код, URL адресите и структурираните данни **винаги се запазват** с точност до байт. **Предварителните настройки с едно щракване** комбинират механизмите:

Режим	Спестявания	Най-подходящ за
🪶 Lite	~15%	Безопасен режим по подразбиране, който е винаги включен
🪨 Стандартен (Caveman)	~30%	Ежедневно програмиране
⚡ Агресивен	~50%	Дълги сесии с интензивно използване на инструменти
🔥 Ultra	~75%	Максимални спестявания
🧰 RTK	60–90%	Изходни данни от обвивки, тестове, компилации и git
🔗 Последователен (RTK → Caveman)	78–95%	Смесени подкани и журнали от инструменти

**Реален пример — стандартен режим:** > **Преди (69 токена):** _„Причината вашият React компонент да се рендира повторно вероятно е, че създавате нова препратка към обект при всеки цикъл на рендиране. Когато подадете вграден обект като свойство, повърхностното сравнение на React го разпознава като различен обект всеки път, което задейства повторно рендиране. Препоръчвам да използвате useMemo, за да мемоизирате обекта.“_ > > **След (19 токена):** _„Нова препратка към обект при всяко рендиране. Вграден обект като свойство = нова препратка = повторно рендиране. Обвийте го в useMemo.“_ > > **Същият отговор. 72% по-малко токени. Нулева загуба на точност.** ✅ **Пример на PT-BR — режим [Troglodita](https://github.com/leninejunior/troglodita):** > **Преди (42 токена):** "Проблемът е, че компонентът се пре-рендира, защото при всеки цикъл на рендиране се създава нова референция към обект. Бих препоръчал да използвате useMemo." > > **След (12 токена):** "Пре-рендиране: нова реф. на всеки цикъл (inline обектът се пресъздава). Да се използва `useMemo`." > > **Същият отговор. ~70% по-малко токени. Техническата точност е запазена.** ✅
### 🎚️ Отвъд двигателите — стилове на изхода, адаптивният регулатор и контрол за всяка заявка 12-те двигателя по-горе свиват това, което **влиза**. Още три слоя оформят **как**, **кога** и какво **излиза**: - **🪄 Стилове на изхода** _(насочване по оста на изхода)_ — вкарват детерминистични, безопасни за кеша инструкции, оформящи отговора; комбинируеми, всяка с интензитет `lite` / `full` / `ultra`. Добавянето на стил е един ред в регистъра: - **Сбита проза** — без пълнеж / членове / предпазливост; техническата същност остава точна. - **По-малко код** — YAGNI на "мързелив старши разработчик": най-малката работеща промяна, без непоискано скеле. - **Ponytail (мързелив старши разработчик)** — изкачете стълбата на YAGNI, отстранете основната причина, най-малката работеща разлика. - **Имам ADHD (действие на първо място)** — следващото действие е начело, стъпките са номерирани, една конкретна следваща стъпка, без увод. - **Terse CJK (文言)** — свръхсбит стил на класически китайски (ограничен до локал `zh`). - **🎯 Адаптивен бюджет на контекста** _(регулаторът)_ — вместо един праг на токените включено/изключено, ескалирайте най-евтините и най-беззагубни двигатели само доколкото е нужно, за да **се побере в контекстния прозорец на модела**. Политика: `reserve-output` (по подразбиране, съобразена с модела) · `percentage` · `absolute`. Режим: `floor` (гарантира поберане) · `replace-autotrigger` (изричният ви избор печели) · `off` (легаси праг). - **🎛️ Къде се решава компресията** _(приоритет, висок → нисък)_ — хедър `x-omniroute-compression` за всяка заявка › override от routing combo › активен именуван профил › адаптивен / авто-тригер › стойност по подразбиране в панела › изключено. Приложеният план се връща в хедъра на отговора `X-OmniRoute-Compression: ; source=`. Авто-тригер по праг на токените, включване на адаптивния регулатор, закачане на именуван профил, еднократна настройка за конкретна заявка или задаване на pipeline за всяко routing combo — което пасва на натоварването. Опционален офлайн **eval harness** (`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 може да блокира lifecycle скриптовете на пакетите, освен ако не са разрешени. `postinstall` на OmniRoute (`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 binary. Вижте бележката за > [настройка на Playwright Chromium](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium) > преди първата заявка към уеб доставчик. Табло на `http://localhost:20128` · API на `http://localhost:20128/v1`. **2) Свържете подходящ доставчик с вашия собствен акаунт** Табло → **Providers** → изберете доставчик, чиито текущи условия и квота пасват на случая ви → добавете неговия 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 heap памет, в противен случай процесът завършва с `FATAL ERROR` при около 12 GiB с два припокриващи се дълги контекста. Оразмерете контейнера над размера на heap паметта (собствените буфери са извън V8): | Натоварване | Heap (`-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 — оперативна памет за изпълнение](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`). - **Специализиран Dockerfile за Bun**: Многоетапен `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 flakes 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 mount 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 и настройка на Quadlet за Linux/systemd. **⚡ По-бързо / по-леко инсталиране (пропускане на собствената компилация)** Собственият SQLite енджин (`better-sqlite3`) е **незадължима** зависимост, така че глобалното инсталиране никога не блокира заради компилиране от изходен код: използва предварително компилиран двоичен файл, когато има съвпадащ за вашата платформа/Node, а в противен случай прозрачно преминава към енджин, реализиран изцяло на JS (`node:sqlite` при Node 22+, иначе включения `sql.js` WASM) — не са необходими инструменти за компилиране. За да пропуснете напълно собственото предварително инициализиране след инсталиране (CI, среди без графичен интерфейс или бавни машини): ```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?** Отворете [issue](https://github.com/diegosouzapw/OmniRoute/issues/new) или [discussion](https://github.com/diegosouzapw/OmniRoute/discussions) с връзката — ще го представим тук.

# 📧 Общност и помощ > Всичко на едно място — следвайте поддържащия проекта, разговаряйте с общността или отворете issue. | Канал | Къде / как | | ------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | | 💼 **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 — валидиране на I/O на 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 ключове + MCP оторизация с обхват · AES-256-GCM при съхранение · DOMPurify
Скритост	wreq-js — имитация на TLS отпечатък JA3 / JA4, тристепенен прокси
Устойчивост	Прекъсвач на веригата, експоненциално отстъпване, защита срещу 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
Разгръщане на VM	Пълно ръководство: настройка на VM + nginx + Cloudflare
Разгръщане във Fly.io	Разгръщане във Fly.io с постоянно хранилище
Ръководство за Termux	Стартиране на OmniRoute на Android чрез Termux
Ръководство за PWA	Инсталиране на Progressive Web App, кеширане, архитектура
Ръководство за деинсталиране	Чисто премахване за всички методи за инсталиране
Конфигурация на средата	Пълен списък с променливи на `.env` и референции

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

Документ	Описание
Архитектура	Системна архитектура, поток на данни и вътрешна структура
Ръководство за компресия	7-опционен pipeline: off / lite / standard / aggressive / ultra / RTK / stacked
RTK компресия	Компресия на изхода от команди, филтри, доверие, проверка, възстановяване на суров изход
Компресионни машини	Caveman, RTK, стекирани pipeline-и, интерфейси dashboard/API/MCP
Формат на правилата за компресия	JSON схеми за rule-pack за Caveman и RTK филтри
Езикови пакети за компресия	Откриване на език и създаване на Caveman rule-pack
Ръководство за устойчивост	Прекъсвачи на веригата, периоди на изчакване, опашка, защита срещу thundering herd, TLS спуфинг
Машина за Auto-Combo	Оценяване по 16 фактора, режимни пакети, самовъзстановяване
Ръководство за прокси	3-нивова прокси система, пазар 1proxy, CRUD на регистър
Безплатни нива	Консолидиран каталог: 34 документирани повтарящи се пула / 467 каталогизирани записа за безплатни нива
Галерия с функции	Визуална обиколка на таблото със снимки
Документация на кодовата база	Опознаване на кодовата база, подходящо за начинаещи

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

Документ	Описание
API референция	Всички endpoint-и с примери
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 заявки

Място	Сътрудник	Слети 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 и включва генерирани файлове, заключващи файлове, каталози, преводи и документация; това е обем на промените, а не авторски LOC. За 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 надежден и богат на функционалности. Всяка заявка за изтегляне, всеки тестов случай и всеки файл с 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. Състоянието isActive на GitHub определя обозначенията за активност по-горе; на предишните публични еднократни дарители продължава да бъде изказвана благодарност, а частните спонсори остават анонимни. Даренията чрез 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. Направете fork на хранилището 2. Създайте клон от върха на **активния** `release/vX.Y.Z` (не от `main`) — вижте [Модел за разклоняване и издания](docs/ops/BRANCHING_MODEL.md) 3. Създайте своя функционален клон (`git checkout -b feat/amazing-feature`) 4. Направете commit на промените си (`git commit -m 'feat: add amazing feature'`) 5. Изпратете клона (`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. С това изказваме благодарността си към всички тях. 🙏 > ⭐ броят звезди е проверен чрез REST API на GitHub на 18 октомври 2026 г. — дайте звезда и на тези проекти. Стойностите са точна моментна снимка към посочената дата и естествено ще се променят. ### 🧬 Произход и шлюз

Проект	⭐	Как е вдъхновил OmniRoute
9router	31,004	Оригиналният проект, върху който е изградено това разклонение — разширен тук с мултимодални API и цялостно пренаписване на TypeScript.
CLIProxyAPI	55,591	Реализацията на Go, вдъхновила този порт на JavaScript / TypeScript.
LiteLLM	61,482	Шлюзът за ИИ, чийто публичен набор от ценови данни захранва синхронизирането за проследяване на разходите ни и чийто модел за нормализиране на доставчиците повлия върху нашето маршрутизиране.
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 отговори бяха съществено адаптирани в изпълнителя Grok Web на OmniRoute.
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` повлияха върху транспорта Grok Web на OmniRoute.
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	TypeScript реализацията под MIT лиценз, директно включена и разширена като кодек с общ профил на 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	Декларативно намаляване на shell изхода чрез MCP — потвърди нашето декларативно уплътняване на Bash изхода.
ts-morph	6,205	Набор от инструменти за TypeScript Compiler API — вдъхнови нашето базирано на синтактичен анализатор премахване на коментари, което запазва низовите, шаблонните и regex литералите.

### 🧠 Памет и RAG

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

### 🛰️ Проверка на трафика, MITM и прозрачно прокси

Проект	⭐	Как вдъхнови OmniRoute
llm-interceptor	79	MITM прихващането/анализът на трафика между асистент за програмиране ↔ LLM повлия върху първоначалните изисквания към инспектора на трафика. Четири модула, създадени по-рано — обединяване на 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 вдъхнови каскадния изглед в реално време на нашите 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](LICENSE) за подробности. ---

**[⬆ Обратно към началото](#-omniroute)** · Създаден с ❤️ за общността на отворения код в AI. _{OmniRoute v3.8.53 · Node ≥22.22.2 · MIT License · omniroute.online}