# 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) · 🇱🇰 [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 — бесплатный ИИ-шлюз

OmniRoute — программируйте без остановки. Любой ИИ-инструмент → 375 провайдеров, более 150 из которых бесплатны, через единую конечную точку. Claude Code, Codex, Cursor, Cline, Copilot и Antigravity получают доступ к БЕСПЛАТНЫМ Claude / GPT / Gemini с автоматическим переключением при сбое. Многоуровневое сжатие RTK + Caveman экономит 15–95% токенов (в среднем ~89%) — забудьте о лимитах. 375 ИИ-провайдеров · более 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 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 помог вам сэкономить деньги и упростить работу.

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

[![Star History Rank](https://api.star-history.com/badge?repo=diegosouzapw/OmniRoute&theme=dark)](https://www.star-history.com/diegosouzapw/omniroute) [![olud.ai](https://olud.ai/badge.php?tool=diegosouzapw-omniroute)](https://olud.ai/project/diegosouzapw-omniroute.html) ### 💬 Присоединяйтесь к сообществу **👋 Следите за мейнтейнером — первыми узнавайте о новых провайдерах, релизах и советах:** [![Follow Diego on LinkedIn](https://img.shields.io/badge/Follow_Diego_on-LinkedIn-0A66C2?style=for-the-badge&logo=linkedin&logoColor=white)](https://www.linkedin.com/in/diegosouzapw/) [![Follow @diegosouzapw on GitHub](https://img.shields.io/github/followers/diegosouzapw?style=for-the-badge&logo=github&logoColor=white&label=Follow%20on%20GitHub&color=181717)](https://github.com/diegosouzapw) [![Discord](https://img.shields.io/badge/Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/U47eFqAXCn) [![Telegram](https://img.shields.io/badge/Telegram-26A5E4?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/omnirouteOficial) [![WhatsApp Global](https://img.shields.io/badge/WhatsApp_Global-25D366?style=for-the-badge&logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) [![WhatsApp Brasil](https://img.shields.io/badge/WhatsApp_Brasil-25D366?style=for-the-badge&logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) [![Website](https://img.shields.io/badge/Website-omniroute.online-blue?logo=google-chrome&logoColor=white)](https://omniroute.online) **Вопросы, советы по провайдерам, дорожная карта и поддержка → [Discord](https://discord.gg/U47eFqAXCn) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 Global](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) / [🇧🇷 Brasil](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) / [Portal](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK)**
## 📈 Шлюз продолжает расти

| | v3.8.50 | **v3.8.51** | `v3.8.53+` | | ----------------------------- | :-----------------------: | :---------: | :-------------------: | | 🌐 Провайдеры | 352 | **358** | 375 | | 🧠 Уникальные ID чат-моделей | 1320 | **1374** | 1475 | | 🖼️ Мост модальностей | 🆕 зрение + аудио + видео | ✓ | ✓ | | 📡 Бесплатный каталог Radar | 🆕 по желанию | ✓ | ✓ | | ⚖️ Планирование с учётом квот | 🆕 Quota-Share | ✓ | ✓ | | 📊 Телеметрия квот | 🆕 в реальном времени | ✓ | ✓ | | 🧰 Headless-режим | — | — | 🆕 `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, используя API-ключ OmniRoute и модель 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); Smart Router OmniRoute (сжатие RTK + Caveman, 20 стратегий маршрутизации, предохранители, TLS stealth, MCP, A2A, guardrails) может переключаться между 4 уровнями провайдеров, пока доступна подходящая здоровая цель — Уровень 1 Subscription, Уровень 2 API Key, Уровень 3 Cheap и Уровень 4 Free.

## 🤝 Поддерживается нашими друзьями из Open Source

> **Хотите присоединиться в качестве друга Open Source?** Это компании, которые поддерживают открытый исходный код и помогают OmniRoute развиваться — и мы публично сообщаем, куда идет каждый токен, который они нам дают. Свяжитесь с нами: [diegosouza.pw@outlook.com](mailto:diegosouza.pw@outlook.com)

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

Что обеспечивает поддержка Kimi: Кредиты API Kimi обеспечивают работу конвейера выпуска OmniRoute, проверенного ИИ — этап *проверки слияния на базе Kimi K3*, который проверяет каждый pull request перед его отправкой — плюс ежедневную разработку функций. Первоклассная поддержка Kimi поставляется по обоим каналам: прямой Kimi API (kimi-k3) и план кодирования Kimi Code (OAuth и API key). OmniRoute также является первым бразильским проектом с открытым исходным кодом в программе поддержки Kimi. Получите Kimi API key с 15% дополнительными кредитами →

Cheaper Inference
_{cheaperinference.com} Благодарим Cheaper Inference, друга Open Source 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 key →

_{Ссылки с тегом aff=omniroute являются партнерскими ссылками. Они финансируют проект без дополнительных затрат для вас.}

_{🎟️ Партнерские акции — бесплатные купоны на регистрацию от провайдеров, которых мы не спонсируем (нажмите, чтобы развернуть)}

_{Этот раздел предназначен только для реферальных/купонных кодов. Спонсируемые партнерства находятся в разделе **🤝 Поддерживается нашими друзьями из Open Source** выше. 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? Откройте issue, и мы добавим его сюда.}

## 🎯 Комбо — флагманская возможность

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

Ключ (случайный): `5d865059-bc44-483a-962d-43ceb80126eb` Pix copia-e-cola: ``` 00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD ```

₿ Криптовалюта — BTC · ETH · USDT-TRC20 · USDC-Solana (нажмите, чтобы развернуть)

₿ BTC	Bitcoin (SegWit)	`bc1qh00smz004sy85wyl28v77tenkt3ckl6eaep7fd`
Ξ ETH	Ethereum (ERC20)	`0x64Cf6B68A6Ff34288e89172950a2d00102337a84`
₮ USDT	Tron (TRC20)	`TKAF41JpuQrHbKTnsQa9svJE2T192Hvsc2`
$ USDC	Solana	`2emNNZzVVWQc3FQ2wk9M6qXUQmW8AKdjjL174fXR28Tu`

_{⚠️ Отправляйте каждую монету только через указанную сеть — отправка через неверную сеть может привести к потере средств.}

🐛 Нашли ошибку или хотите поделиться отзывом? Создайте [обсуждение](https://github.com/diegosouzapw/OmniRoute/discussions).

Примечания для разработчиков: Во время npm install/postinstall проект может создать локальный файл .env для удобства разработчика. Этот файл намеренно игнорируется через .gitignore (см. .gitignore) и никогда не должен попадать в коммиты — если он был случайно добавлен в коммит, замените все раскрытые секреты и удалите файл из истории. Рекомендации по управлению локальными файлами окружения и секретами см. в docs/DEVELOPER-ENVIRONMENT.md.

## 📡 Радар OmniRoute Основной показатель бесплатного уровня по-прежнему составляет **~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 и панель на дашборде с голосовым чатом Faro с кнопкой push-to-talk. → [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 + китайского (вэньянь), фильтры 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, игнорирующие переменные окружения прокси, с CA для каждого SNI + установщиком доверенного хранилища. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md) - **💸 Телеметрия затрат повсюду** — заголовки стоимости/использования `X-OmniRoute-*` на каждом эндпоинте, заголовок экономии при попадании в кеш, квоты расходов в 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) - **🖼️ Новые эндпоинты** — `/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 направляют повторные запросы обратно в соединение, удерживающее кешированный префикс; а эндпоинт только для чтения `/v1/auto-combo/{channel}/candidates` раскрывает живой пул кандидатов канала `auto/*`. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **⚡ Локальная производительность и инфраструктура** — локальный Redis в один клик, деплоеры relay для Cloudflare Workers / Deno Deploy, Bifrost и Mux как управляемые встроенные сервисы. → [Встроенные сервисы](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` — и **любая** ИИ-среда разработки или 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 для написания кода + 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 зарегистрированных провайдеров** в канонических коллекциях чата, медиа, поиска, локальных моделей, облачных агентов и системных сервисов, включая **153 с метаданными обнаружения `hasFree: true`**. Реестр чат-моделей охватывает **239 провайдеров / 3 059 уникальных пар «провайдер — модель» / 1 475 исходных ID моделей**; отдельный каталог бесплатных лимитов содержит **467 строк по моделям**, **34 повторяющихся пула** и **51 повторяющегося/бесключевого провайдера с бессрочным бесплатным доступом**. Это разные знаменатели по замыслу; определения и расчёты с дедупликацией пулов приведены в [Provider Reference](docs/reference/PROVIDER_REFERENCE.md) и [Free Tiers](docs/reference/FREE_TIERS.md).

### 🏢 Каждая крупная лаборатория — через одну конечную точку

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

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

OpenCode Zen _{DeepSeek V4, Nemotron 3 Без лимита токенов}	Kilo Code _{Автомаршрутизация, Tencent Hy3 Бесплатно навсегда}	Requesty _{GPT-OSS 120B, Nemotron Бесплатно навсегда}	SiliconFlow _{DeepSeek V3.2 / R1 Бесплатный тариф}	Z.AI GLM _{GLM-4.7 / 4.5-Flash Бесплатно навсегда}	Baidu ERNIE _{ERNIE 4.0 Бесплатно навсегда}
Qoder AI _{Qwen3-Max, Kimi-K2 Безлимитно БЕСПЛАТНО}	Pollinations _{GPT, Llama, Claude Ключ не нужен}	Cloudflare AI _{50+ моделей 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…

В редакторе откройте представление **Расширения**, найдите **"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 командами**, а также открытые агентские протоколы, позволяющие ИИ-агенту управлять им **самостоятельно**. ### ⌨️ Настоящий 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)}

Анимированная демонстрация CLI OmniRoute в терминале — 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)}

## 🗜️ Экономьте 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%	Безопасный режим по умолчанию для постоянного использования
🪨 Standard (Caveman)	~30%	Повседневной разработки
⚡ Aggressive	~50%	Длительных сеансов с интенсивным использованием инструментов
🔥 Ultra	~75%	Максимальной экономии
🧰 RTK	60–90%	Вывода оболочки, тестов, сборки и git
🔗 Stacked (RTK → Caveman)	78–95%	Смешанных запросов и журналов инструментов

**Реальный пример — режим Standard:** > **До (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, исправлять первопричину, минимальный работающий diff. - **У меня СДВГ (сначала действие)** — вперёд идёт следующее действие, шаги пронумерованы, один конкретный следующий шаг, без вступлений. - **Лаконичный CJK (文言)** — сверхлаконичный стиль классического китайского (включается только для локали `zh`). - **🎯 Адаптивный бюджет контекста** _(регулятор)_ — вместо одного порога токенов вкл/выкл наращивать самые дешёвые и наименее разрушительные движки ровно настолько, насколько нужно, чтобы **уместиться в контекстное окно модели**. Политика: `reserve-output` (по умолчанию, с учётом модели) · `percentage` · `absolute`. Режим: `floor` (гарантировать вписывание) · `replace-autotrigger` (ваш явный выбор побеждает) · `off` (устаревший порог). - **🎛️ Где решается сжатие** _(приоритет, от высшего к низшему)_ — заголовок `x-omniroute-compression` на уровне запроса › переопределение в routing-combo › активный именованный профиль › адаптивный / авто-триггер › значение панели по умолчанию › выкл. Применённый план возвращается в заголовке ответа `X-OmniRoute-Compression: ; source=`. Авто-триггер по порогу токенов, включение адаптивного регулятора, закрепление именованного профиля, разовая настройка на запрос или назначение конвейера на routing-combo — что лучше подходит под нагрузку. Опциональный офлайн-**стенд для оценки** (`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 может блокировать скрипты жизненного цикла пакета, если они не разрешены. `postinstall` OmniRoute (`node scripts/build/postinstall.mjs`) необходим для подготовки его нативных файлов среды выполнения. Разрешите пакеты, перечисленные в предупреждении 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 или другого провайдера с веб-cookie?** Пакет npm включает > Playwright, но не его бинарник Chromium. См. заметку > [Настройка 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: [скопировать из Dashboard → Endpoints] Model: auto (маршрутизирует среди подходящих подключений — или выберите provider/model) ``` **4) Проверьте, что всё работает** ```bash curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY" ``` Вы должны увидеть список подключённых моделей. 🎉 Вот и всё — начинайте писать код, а OmniRoute сам маршрутизирует запросы и делает fallback за вас. Если ваш клиент не может отправлять пользовательские заголовки, OmniRoute также предоставляет совместимые псевдонимы с токеном: ```txt Каталог OpenAI: http://localhost:20128/vscode/YOUR_KEY/ Модели OpenAI: http://localhost:20128/vscode/YOUR_KEY/models Чат OpenAI: http://localhost:20128/vscode/YOUR_KEY/chat/completions Responses OpenAI: http://localhost:20128/vscode/YOUR_KEY/responses Чат Ollama: http://localhost:20128/vscode/YOUR_KEY/api/chat Теги Ollama: 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`. Для GitOps закрепляйте тег `:X.Y.Z`. См. [каналы выпусков Docker](docs/guides/DOCKER_GUIDE.md#release-channels). В образе задано значение **`OMNIROUTE_MEMORY_MB=1024`**. Этого достаточно для панели управления и непродолжительных чатов. **Агенты для программирования** (`POST /v1/responses` из Claude Code, Codex, Grok, …) требуют значительно большего объёма кучи V8, иначе при двух перекрывающихся длинных контекстах процесс завершается с `FATAL ERROR` примерно на 12 ГиБ. Выделяйте контейнеру больше памяти, чем размер кучи (нативные буферы размещаются за пределами V8): | Рабочая нагрузка | Куча (`-e OMNIROUTE_MEMORY_MB`) | Контейнер (`--memory`) | | ------------------------------------------------- | ------------------------------- | ---------------------- | | Панель управления / лёгкий чат | `1024` (по умолчанию в образе) | ≥2 ГиБ | | Один агент для программирования | `8192` | ≥10 ГиБ | | Два одновременных длинных запроса `/v1/responses` | `10240`–`12288` | ≥12–16 ГиБ | ```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`**: при запуске в Bun OmniRoute использует встроенный драйвер Bun `bun:sqlite`, а в Node.js переключается на `better-sqlite3` или `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 # Использование flakes Nix nix develop npm run dev # Или использование devbox devbox run npm run dev ``` 📖 [Руководство по Docker](docs/guides/DOCKER_GUIDE.md) — профили Compose, HTTPS через Caddy, туннели 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+ либо встроенный WASM-модуль `sql.js`) — инструменты сборки не требуются. Чтобы полностью пропустить нативную инициализацию после установки (для 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?** Создайте [задачу](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-квантованные векторные эмбеддинги, типизированное затухание
Схемы	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-ключи + аутентификация MCP с ограниченными областями · AES-256-GCM при хранении · DOMPurify
Маскировка	wreq-js — имитация TLS-отпечатков JA3 / JA4, трёхуровневый прокси
Отказоустойчивость	Размыкатель цепи, экспоненциальная задержка, защита от «громового стада», самовосстановление auto-combo
Логирование	pino — структурированные JSON-логи с контекстом запроса
Тестирование	Раннер тестов Node.js + 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, HTTPS через Caddy, туннели, теги образов
Руководство по Podman	Интеграция с Quadlet systemd, podman-compose, SELinux
Развёртывание на VM	Полное руководство: VM + nginx + настройка Cloudflare
Развёртывание на Fly.io	Развёртывание на Fly.io с постоянным хранилищем
Руководство по Termux	Запуск OmniRoute на Android через Termux
Руководство по PWA	Установка Progressive Web App, кэширование, архитектура
Руководство по удалению	Чистое удаление для всех способов установки
Конфигурация окружения	Полный список переменных `.env` и ссылки

### 🧠 Возможности и архитектура

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

### 🤖 Протоколы и 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, включая сгенерированные файлы, lock-файлы, каталоги, переводы и документацию; это объём изменений, а не количество написанных автором строк кода (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, о которых сообщает Contributors 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 в общей сложности. Статус 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, адреса электронной почты сравниваются без учёта регистра, числовые и обычные noreply-адреса GitHub объединяются только в том случае, если они соответствуют одному и тому же имени пользователя; исключены 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. Откройте Pull Request с **базовой веткой = соответствующая ветка `release/vX.Y.Z`** Подробные рекомендации см. в [CONTRIBUTING.md](CONTRIBUTING.md). ### Выпуск новой версии ```bash # Создайте релиз — публикация в npm произойдёт автоматически 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 с аутентификацией по cookie и шаблон потоковой передачи `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	Его ориентированный на действия и удобный для людей с СДВГ стиль ответов был адаптирован в лаконичный стиль вывода 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	Проектная основа с графом сеанса и дедупликацией строк между репликами, повлиявшая на архитектуру нашего механизма дедупликации сеансов.
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	Открытая база данных спецификаций, цен и возможностей моделей ИИ — встроенная синхронизация с нашим каталогом моделей.
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	Логотипы брендов ИИ/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 ИИ. _{OmniRoute v3.8.53 · Node ≥22.22.2 · Лицензия MIT · omniroute.online}