# 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 — Бесплатный шлюз ИИ **Создано [Diego Souza](https://github.com/diegosouzapw)**

OmniRoute — Никогда не прекращайте программировать. Каждый инструмент ИИ → 388 провайдер — 150+ бесплатных — через одну конечную точку. Claude Code, Codex, Cursor, Cline, Copilot и Antigravity для БЕСПЛАТНЫХ Claude / GPT / Gemini с автоматическим резервным переключением. Компрессия RTK + Caveman в несколько этапов экономит 15–95% токенов (~89% в среднем) — лимиты больше не помеха. 388 провайдер ИИ · 150+ бесплатных тарифов · ~1,62 млрд бесплатных токенов в месяц · 20 стратегий маршрутизации · старт за $0.

## 💰 ~1.62B токенов / месяц на бесплатных тарифах сторонних провайдеров

> **Используйте собственные аккаунты провайдеров.** Это оценочный совокупный показатель для отдельно доступных бесплатных тарифов сторонних провайдеров, а не грант токенов от OmniRoute. Зарегистрируйтесь, получите необходимые учётные данные и подключите доступных вам провайдеров; каждый провайдер самостоятельно устанавливает лимиты, доступность и условия использования. > > Вручную объединять бесплатные тарифы неудобно — десятки SDK, десятки ограничений скорости и отсутствие понимания, каким объёмом вы действительно располагаете. OmniRoute каталогизирует **465 записей бесплатных тарифов по 34 повторяющимся ключам пулов** и вычисляет итоговый показатель токенов на основе **17 пулов с опубликованным положительным месячным бюджетом, а также пяти ограничений Groq для отдельных моделей**, с дедупликацией по общему пулу. Квоты, которые открываются только после проверки региональной идентичности (сегодня это ModelScope), отображаются отдельно: +~6M после региональной проверки личности и никогда не включаются в итоговый показатель. Результат постоянно доступен на панели управления (`/dashboard/free-tiers`).

Карточка бесплатных тарифов OmniRoute: ~1.62B бесплатных токенов в месяц стабильно, до ~2.22B в первый месяц с бонусами за регистрацию, на основе 34 задокументированных повторяющихся ключей пулов, охватывающих 465 каталогизированных записей бесплатных тарифов за одной конечной точкой. Честный расчёт с дедупликацией пулов — каждый общий пул учитывается один раз, включая 17 повторяющихся пулов с опубликованным положительным месячным бюджетом токенов, а также пять ограничений Groq для отдельных моделей; 12 провайдеров отмечены как нежелательные в каталоге рисков условий, поэтому решение остаётся за вами. Полоса бюджета включает Mistral 1B, Nara 210M, LLM7 150M, xKiro 150M, Groq 30M (пять ограничений для отдельных моделей) и меньшие пулы, а также бонусы за регистрацию в первый месяц и провайдеров, которые навсегда бесплатны и не имеют ограничения по токенам, отображаемых отдельно, чтобы они никогда не завышали итоговый показатель. Текущее использованное и оставшееся количество на /dashboard/free-tiers.

> Анимированный обзор текущей страницы `/dashboard/free-tiers`. Полная методология (дедупликация пулов, уровни кредитов, условия провайдеров): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**. > > _{Эти показатели проверяются заново каждые две недели по актуальному каталогу и **могут изменяться в обе стороны** — провайдер прекращает действие бесплатного тарифа, и число уменьшается; появляется новый провайдер — и оно увеличивается. Мы публикуем фактические вычисления каталога, а не округлённый показатель в лучшем случае.}

⭐ Поставьте звезду репозиторию, если OMNIROUTE помог вам сэкономить деньги и упростить работу.

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

[![Рейтинг истории звёзд](https://api.star-history.com/badge?repo=diegosouzapw/OmniRoute&theme=dark)](https://www.star-history.com/diegosouzapw/omniroute) [![olud.ai](https://olud.ai/badge.php?tool=diegosouzapw-omniroute)](https://olud.ai/project/diegosouzapw-omniroute.html) ### 💬 Присоединяйтесь к сообществу **👋 Подпишитесь на обновления от сопровождающего — узнавайте о новых провайдерах, релизах и советах первыми:** [![Подписаться на Diego в LinkedIn](https://img.shields.io/badge/Follow_Diego_on-LinkedIn-0A66C2?style=for-the-badge&logo=linkedin&logoColor=white)](https://www.linkedin.com/in/diegosouzapw/) [![Подписаться на @diegosouzapw в GitHub](https://img.shields.io/github/followers/diegosouzapw?style=for-the-badge&logo=github&logoColor=white&label=Follow%20on%20GitHub&color=181717)](https://github.com/diegosouzapw) [![Discord](https://img.shields.io/badge/Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/U47eFqAXCn) [![Telegram](https://img.shields.io/badge/Telegram-26A5E4?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/omnirouteOficial) [![WhatsApp 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) [![Веб-сайт](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.54+` | | ---------------------------------------- | :-----------------------: | :---------: | :-------------------: | | 🌐 Провайдеры | 352 | **358** | 388 | | 🧠 Уникальные идентификаторы чат-моделей | 1320 | **1374** | 1491 | | 🖼️ Мост модальностей | 🆕 зрение + аудио + видео | ✓ | ✓ | | 📡 Бесплатный каталог 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, используя API-ключ OmniRoute и модель auto. Маршрутизация зависит от доступных подходящих подключений и ограничений провайдера.

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

# 💥 Обещание

# 🤔 Почему OmniRoute?

Поток запросов OmniRoute: ваша IDE или CLI (Claude Code, Cursor, Cline…) вызывает одну локальную конечную точку (http://localhost:20128/v1); интеллектуальный маршрутизатор OmniRoute (сжатие RTK + Caveman, 20 стратегий маршрутизации, автоматические выключатели, скрытие TLS, MCP, A2A, защитные ограничения) может переключаться между 4 уровнями провайдеров, пока доступна подходящая работоспособная цель — уровень 1: подписка, уровень 2: API-ключ, уровень 3: дешёвые и уровень 4: бесплатные.

## 🤝 Поддерживается нашими друзьями из 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.54**. Полная история — в [`CHANGELOG.md`](CHANGELOG.md). - **⚖️ Маршрутизация `quota-weighted`** — 20-я стратегия комбинирования пропускает исчерпавшие аккаунты, а затем выбирает среди остальных пропорционально отношению оставшейся квоты к нагрузке активных запросов, сохраняя привязку существующих диалогов. → [Автоматическое комбинирование](docs/routing/AUTO-COMBO.md) - **🧰 Безголовый режим** — `omniroute serve --headless` (или `OMNIROUTE_HEADLESS=1`) запускает только прокси-движок `/v1/*`, отключая панель управления и подсистемы, предназначенные только для неё. → [Безголовый режим](docs/guides/HEADLESS.md) - **🔎 Обнаружение моделей** — `/v1/models` фильтрует модели по возможностям, контексту, типу и тексту, а `POST /v1/models/query` возвращает короткий детерминированный список с той же видимостью для каждого ключа. → [Справочник API](docs/reference/API_REFERENCE.md) - **🔑 Управление маршрутизацией для каждого ключа** — привязывайте API-ключ к одной модели или комбинации с помощью `forcedModel`, а также атомарно добавляйте или удаляйте модели и комбинации ключа (`/api/keys/{id}/access`). → [Справочник API](docs/reference/API_REFERENCE.md) · [OpenAPI](docs/openapi.yaml) - **🛡️ Более точная настройка PII** — выбор по типам, до 20 проверенных пользовательских шаблонов маскирования и счётчики обнаружений для каждого типа; само маскирование по-прежнему включается по желанию. → [Защитные механизмы](docs/security/GUARDRAILS.md) - **🌍 67 языков** — панель управления, зеркала документации и CLI, при этом `npm run i18n:add-locale` добавляет язык сразу во все компоненты одной командой. → [Руководство по i18n](docs/guides/I18N.md) - **🎛️ OmniConductor** — входящая делегация A2A вашему пулу агентов, навыки Conductor в карточке агента и панель с голосовым чатом Faro в режиме push-to-talk. → [Сервер A2A](docs/frameworks/A2A-SERVER.md) - **🛂 Адаптивный допуск и защита от перегрузки** — тяжёлые запросы чата помещаются в очередь вместо ответа 503, с атомарными скользящими арендными лимитами RPM для каждого подключения. → [Руководство по отказоустойчивости](docs/architecture/RESILIENCE_GUIDE.md) - **🗂️ Канонический порядок `/v1/models`** — один непрерывный блок моделей каждого провайдера, сгруппированный по провайдеру (комбинации закрепляются в начале), стабильный для всех источников каталога. → [Справочник API](docs/reference/API_REFERENCE.md) - **🗜️ Усиленная защита сжатия** — включённая по умолчанию защита от чрезмерного распаковывания, пакеты Caveman для DE / FR / JA и китайского языка (вэньянь), фильтры RTK для Gradle и .NET. → [Сжатие](docs/compression/COMPRESSION_ENGINES.md) - **💸 Честная стоимость по фиксированной ставке** — провайдеры подписок и тарифных планов для программирования отображаются как **$0** в аналитике затрат; бюджет, квота и маршрутизация продолжают выполнять оценку. → [Справочник API](docs/reference/API_REFERENCE.md) - **⚖️ Маршрутизация Quota-Share** — справедливое распределение квоты общего аккаунта между объединёнными ключами с эффективным использованием ресурсов: простаивающие доли передаются другим. → [Руководство по отказоустойчивости](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](docs/guides/CLI-INTEGRATIONS.md) - **🛰️ Удалённый режим** — управление удалённым OmniRoute с помощью токенов с ограниченной областью действия (`connect` / `contexts` / `tokens`) и помощника OAuth `antigravity` для установки на VPS. → [Удалённый режим](docs/guides/REMOTE-MODE.md) - **🧭 Более интеллектуальная автоматическая маршрутизация** — комбинации `auto/:`, **Fusion** (панель моделей + судья), маршрутизация с учётом задачи, переопределения модели / режима / бюджета в USD для каждого запроса. → [Автоматическое комбинирование](docs/routing/AUTO-COMBO.md) - **🗜️ Подключаемое сжатие** — 12 компонуемых движков и Compression Studios: LLMLingua-2, двухуровневый Ultra, omniglyph, проверка точности на каждом шаге, GCF v3.2, редактор с перетаскиванием для изменения порядка. → [Сжатие](docs/compression/COMPRESSION_ENGINES.md) - **🕵️ Прозрачная расшифровка MITM (TPROXY)** — CLI для перехвата трафика, игнорирующие переменные окружения прокси, с установщиком CA для каждого SNI и хранилища доверия. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md) - **💸 Повсеместная телеметрия затрат** — заголовки затрат и использования `X-OmniRoute-*` для каждой конечной точки, заголовок экономии при попадании в кэш и квоты расходов в USD для каждого ключа. → [Справочник API](docs/reference/API_REFERENCE.md) - **🧠 Управляемая память** — по умолчанию отключена; поддерживаются квантование векторов int8 по желанию и типизированное затухание, а также `x-omniroute-no-memory` для каждого запроса. → [Память](docs/frameworks/MEMORY.md) - **🛡️ Безопасность** — защита от prompt injection для каждого маршрута LLM (набор red-team-тестов), защитный механизм маскирования учётных данных по желанию (скрывает утёкшие API-ключи и секреты в обоих направлениях), бесплатный веб-поиск DuckDuckGo в качестве последнего средства и дополнительный шлюз входа OIDC для панели управления (вход по паролю всегда остаётся доступен). → [Защитные механизмы](docs/security/GUARDRAILS.md) - **🖼️ Новые конечные точки** — `/v1/ocr` (Mistral OCR) и `/v1/audio/translations` (в стиле Whisper) дополняют набор возможностей для работы с медиа. → [Справочник API](docs/reference/API_REFERENCE.md) - **🎨 Генерация изображений, видео и аудио** — единый API для медиа: xAI Grok Imagine и видео Novita AI, ComfyUI, Magnific, Adobe Firefly, Segmind и провайдеры речи, такие как ElevenLabs. → [Справочник API](docs/reference/API_REFERENCE.md) - **🌍 Развёртывание и эксплуатация** — `basePath` для обратного прокси, автоматическое определение языка браузера, отслеживание устройств для каждого ключа, доверие к MITM без root-доступа, локализация zh-TW. → [Переменные окружения](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… и обновлённый **каталог из 388 провайдера**. → [Провайдеры](docs/reference/PROVIDER_REFERENCE.md) - **📡 Прозрачность маршрутизации** — каждый ответ содержит заголовок `X-OmniRoute-Decision` с указанием стратегии, провайдера и задержки, обслуживших запрос; новая стратегия комбинирования `cache-optimized` и фактор маршрута `cacheAffinity` в Auto-Combo направляют повторные запросы обратно к подключению, содержащему кэшированный префикс; доступная только для чтения конечная точка `/v1/auto-combo/{channel}/candidates` показывает текущий пул кандидатов канала `auto/*`. → [Автоматическое комбинирование](docs/routing/AUTO-COMBO.md) - **⚡ Локальная производительность и инфраструктура** — локальный Redis в один клик, средства развертывания ретрансляторов Cloudflare Workers / Deno Deploy, а также Bifrost и Mux в качестве контролируемых встроенных сервисов. → [Встроенные сервисы](docs/frameworks/EMBEDDED-SERVICES.md) - **🧩 Также в комплекте** — фреймворк плагинов и маркетплейс, фреймворки навыков Omni/Agent/GitHub, интеграция с хранилищем Obsidian (22 инструмента MCP), совместимые с OpenAI API 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

_{📖 Индивидуальная настройка для каждого из 39 инструментов (28 CLI Code's + 11 CLI Agents) → [`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)

## 🌐 388 провайдер ИИ — 153 отмечены в каталоге как бесплатные

> **388 зарегистрированный провайдер** в канонических коллекциях чатов, медиа, поиска, локальных, облачных агентов и систем, включая **153 провайдера с метаданными обнаружения `hasFree: true`**. Реестр моделей чата охватывает **239 провайдеров / 3,059 уникальных пар провайдер–модель / 1,475 исходных идентификаторов моделей**; отдельный каталог бесплатных тарифов содержит **471 строку для отдельных моделей**, **34 регулярно пополняемых пула** и **52 провайдера с регулярно возобновляемым или бессрочно бесплатным доступом без ключа**. Это разные знаменатели по замыслу; определения и расчёты с дедупликацией пулов приведены в [справочнике провайдеров](docs/reference/PROVIDER_REFERENCE.md) и разделе [Бесплатные тарифы](docs/reference/FREE_TIERS.md).

### 🏢 Все ведущие лаборатории — через одну конечную точку

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

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

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

Платформа	Установка	Основные моменты
📦 npm (глобальный)	`npm install -g omniroute`	Одна команда, OS
⚡ Bun (глобальный)	`Bun add -g omniroute`	Тот же архив реестра, быстрее устанавливается
🐳 Docker	`docker run … diegosouzapw/omniroute`	Multi-arch AMD64 + ARM64
🖥️ Desktop (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`	Запускает на вашем телефоне , 24/7, без рута
📲 PWA	«Добавить на главный экран»	Полноэкранный режим, автономный режим, установка из браузера
🧩 OpenCode плагин	`@omniroute/opencode-provider`	OpenCode интеграция
🤖 VS Код Copilot Chat	install OmniCopilot Расширение	OmniRoute модель zqo в встроенном средстве выбора чата Copilot — стабильная версия & Инсайдеры
🛠️ Из исходного кода	`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

> Ни новой боковой панели, ни нового чата UI — каждая модель, которую обслуживает OmniRoute отображается прямо в**Copilot Средство выбора модели чата, которое вы уже используете** . Начиная с версии VS Code 1.122, модели поставщиков работают без входа в систему GitHub или подписки Copilot — режим агента, вызов инструментов и видение предоставляются бесплатно. Установите** [OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)** расширение, укажите его на свой сервер OmniRoute (по умолчанию `localhost:20128`), затем откройте Copilot Chat средство выбора модели → →** Управление моделями…** →**OmniRoute** . < td align =«left»>VS Code — стабильный & Инсайдеры < td align ="left">Cursor, Windsurf, VSCodium, Theia, code-server, Gitpod, Antigravity, Kiro…

Магазин	Ссылка	Работает с
🧩 VS Marketplace	Установить →
🔓 Открыть реестр VSX	Установить →

Изнутри редактора: откройте** Расширения** просмотр, поиск** "OmniRoute"** , нажмите** Установить** — работает одинаково в обоих магазинах. Исходный код, выпуски и книга публикаций доступны по адресу [diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot). _{📖 [VS Код Copilot Руководство по чату](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 service` , принимает уже работающий экземпляр вместо его дублирования
📊 Краткий обзор использования в реальном времени	Квоты поставщика, Claude ограничения session/weekly со сбросом обратного отсчета, 30-дневная разбивка затрат
🔄 Автоматические обновления на месте	Поэтапная установка, атомарная замена, откат в случае сбоя — всегда на новейшей версии
🚀 Запуск при входе в систему	Необязательный запуск при входе в систему; только в трее, без значка в доке
🩺 Doctor & logs	Диагностика в один клик и доступ к журналам сервера

```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`. Когда оба движка обрабатывают один и тот же payload инструмента/контекста, экономия суммируется: ```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 без потерь + ограниченное диагностическое сжатие результатов shell/patch/search/build (Responses API)
6	Headroom	Сжатие табличных данных в массивах JSON без потерь (примерно 30%) с помощью поставляемого вместе с системой кодека GCF
7	Relevance	Экстрактивное ранжирование предложений по отношению к последнему запросу пользователя
8	Caveman	Сжатие прозы на основе правил (примерно 65–75% для выходных данных)
9	Aggressive	Суммаризация + постепенное устаревание старых ходов
10	LLMLingua-2	Семантическое прореживание с помощью ML через MobileBERT ONNX — безопасно для кода, асинхронно
11	Ultra	Эвристическое удаление токенов с дополнительным уровнем небольшой модели (SLM)
12	OmniGlyph	Экспериментальное кодирование контекста в виде изображения для измеренного Claude Fable 5 при прямой передаче по протоколу Anthropic; трансформеры GPT 5.6 остаются в режиме отказа по умолчанию до получения подтверждений от провайдера. Четыре профиля сжатия (по умолчанию агрессивный, сбалансированный, безопасный для программирования, passthrough) (наиболее агрессивный; включается явно)

Блоки кода, URL и структурированные данные **всегда сохраняются** побайтно. **Предустановки в один клик** объединяют движки:

Режим Экономия Лучше всего подходит для

🪶 Lite ~15% Безопасный режим по умолчанию для постоянного использования

🪨 Standard (Caveman) ~30% Ежедневной работы с кодом

⚡ Aggressive ~50% Длительных сессий с большим количеством инструментов

🔥 Ultra ~75% Максимальной экономии

🧰 RTK 60–90% Вывода shell/test/build/git

🔗 Stacked (RTK → Caveman)

78–95%

> **После (12 токенов):** _"Повторный рендер: новая ссылка на каждом цикле (встроенный объект создаётся заново). Использовать `useMemo`."_ > > **Тот же ответ. Примерно на 70% меньше токенов. Техническая точность сохранена.** ✅
### 🎚️ Помимо движков — стили вывода, адаптивный регулятор и управление для каждого запроса 12 движков выше сокращают то, что **поступает**. Ещё три уровня определяют **как**, **когда** и что поступает **на выходе**: - **🪄 Стили вывода** _(управление осью вывода)_ — добавляют детерминированные инструкции для формирования ответа, безопасные для кэша; их можно комбинировать, причём каждый доступен с интенсивностью `lite` / `full` / `ultra`. Добавление стиля — это одна строка в реестре: - **Лаконичная проза** — убрать заполнители / артикли / смягчающие формулировки; сохранить техническую суть без изменений. - **Меньше кода** — YAGNI в духе «ленивого старшего разработчика»: минимальное рабочее изменение, без незапрошенной инфраструктуры. - **Конский хвост (ленивый старший разработчик)** — подняться по лестнице YAGNI, исправить корневую причину, внести минимальное рабочее изменение. - **У меня СДВГ (сначала действие)** — сначала указать следующее действие, пронумеровать шаги, привести один конкретный следующий шаг, без вступления. - **Лаконичный CJK (文言)** — ультралаконичный стиль на классическом китайском (ограничен локалью `zh`). - **🎯 Адаптивный бюджет контекста** _(регулятор)_ — вместо одного порога токенов вкл./выкл. наращивать использование самых дешёвых и наименее искажающих движков только настолько, насколько необходимо, чтобы **вместить запрос в окно контекста модели**. Политика: `reserve-output` (по умолчанию, с учётом модели) · `percentage` · `absolute`. Режим: `floor` (гарантировать соответствие) · `replace-autotrigger` (ваш явный выбор имеет приоритет) · `off` (устаревший порог). - **🎛️ Где принимается решение о сжатии** _(приоритет, от высокого к низкому)_ — заголовок `x-omniroute-compression` для запроса › переопределение комбинации маршрутизации › активный именованный профиль › адаптивный режим / автоматический триггер › значение по умолчанию панели › выключено. Применённый план возвращается в заголовке ответа `X-OmniRoute-Compression: ; source=`. Автоматически запускайте сжатие по порогу токенов, включайте адаптивный регулятор, закрепляйте именованный профиль, задавайте разовое значение для запроса или назначайте конвейер для каждой комбинации маршрутизации — выбирайте вариант, подходящий для рабочей нагрузки. Опциональный офлайн-**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 может блокировать скрипты жизненного цикла пакетов, если им не разрешён запуск. `postinstall` в OmniRoute (`node scripts/build/postinstall.mjs`) необходим для подготовки собственных файлов среды выполнения. При глобальной установке разрешите пакеты, названные в предупреждении npm. Для набора пакетов, указанного в OmniRoute 3.8.54: > > ```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) Подключите подходящего провайдера, используя собственную учётную запись** Панель → **Провайдеры** → выберите провайдера, чьи текущие условия и квота подходят для вашего сценария использования → добавьте его API-ключ или завершите процедуру подключения учётной записи. Бесплатные тарифы могут требовать регистрации, одобрения или способа оплаты. Ознакомьтесь с [Руководством по бесплатным тарифам](docs/getting-started/FREE-TIERS-GUIDE.md); доступность без ключа не гарантируется, а провайдеры, отмеченные как `tos: avoid`, по умолчанию исключаются из `auto`. **3) Укажите провайдера в инструменте разработки** ```txt Base URL: http://localhost:20128/v1 API Key: [скопируйте из Панель → Конечные точки] Model: auto (маршрутизация среди подходящих подключений — или выберите провайдера/модель) ``` **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`. Для 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 предметных модулей, 233 миграций
Память	Полнотекстовый поиск 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 Keys + область действия аутентификации MCP · AES-256-GCM при хранении · DOMPurify
Скрытность	wreq-js — имитация TLS-отпечатков JA3 / JA4, прокси с 3 уровнями
Отказоустойчивость	Автоматический выключатель, экспоненциальная задержка, защита от эффекта «стада», автоматическое комбинированное самовосстановление
Журналирование	pino — структурированные журналы JSON с контекстом запроса
Тестирование	Средство запуска тестов Node.js + Vitest — более 60 000 статических объявлений тестов в более чем 8 400 отслеживаемых файлах тестов (модульные, интеграционные, 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	Установка прогрессивного веб-приложения, кэширование, архитектура
Руководство по удалению	Полное удаление для всех способов установки
Конфигурация окружения	Полный список переменных и ссылок `.env`

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

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

### 🤖 Протоколы и 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
Контрольный список выпуска	Шаги проверки перед выпуском
План покрытия	Стратегия покрытия тестами для более чем 60 000 статических объявлений тестов в более чем 8 400 отслеживаемых файлах тестов

# ⭐ Основные участники > OmniRoute создаётся увлечённым сообществом открытого исходного кода. Эти люди внесли исключительный вклад, непосредственно повлиявший на качество, стабильность и охват проекта. **Спасибо.** ### Внешние участники по количеству объединённых запросов на включение изменений

Место	Участник	Объединённые PR	~Изменённых строк
1	maxmad64bis	418	25,367,739
2	HouMinXi	295	13,557,796
3	pacocartones	222	81,551
4	backryun	210	270,562
5	JxnLexn	198	3,570,623
6	oyi77	190	411,243
7	KooshaPari	151	5,972,314
8	rdself	145	80,663
9	RaviTharuma	123	500,065
10	herjarsa	88	230,872
11	hartmark	85	2,849,623
12	jonlwheat2-gif	68	69,097
13	artickc	62	43,502
14	xiaoyaner0201	59	126,220
15	chirag127	52	6,661
16	xz-dev	50	245,976
17	woodsonl	48	811,771
18	rqzbeh	46	151,229
19	MumuTW	43	28,166
19	QuangBlue	43	13,112

_{Перепись проведена 2026-11-03 03:01:19 UTC по актуальному состоянию release/v3.8.53 с коммитом 05bc048d6c. Постраничная перепись GitHub GraphQL содержит 9 947 объединённых PR: 4 130 от владельца репозитория, 240 от Dependabot, 6 от других ботов/приложений и 5 571 внешний PR от 883 отдельных участников. «Изменённые строки» — это сумма добавлений и удалений на GitHub; сюда входят сгенерированные файлы, lock-файлы, каталоги, переводы и документация. Это показатель объёма изменений, а не количество строк кода, написанных автором. В 53 PR указано более 500 000 строк в различиях GitHub (например, в #13399, одном добавлении провайдера, указано 2 347 изменённых файлов), что завышает некоторые приведённые выше итоги. Одинаковые места в рейтинге объединены.} ### Коммиты, атрибутированные GitHub

Dizzle _{🥇 418 коммитов, атрибутированных GitHub}	Bob.Hou _{🥈 294 коммита, атрибутированных GitHub}	Paijo _{🥉 229 коммитов, атрибутированных GitHub}	Paco Cartones _{🏅 222 коммита, атрибутированных GitHub}	backryun _{🏅 202 коммита, атрибутированных GitHub}	Jan Leon _{🏅 134 коммита, атрибутированных GitHub}
Ravi Tharuma _{🏅 126 коммитов, атрибутированных GitHub}	Markus Hartung _{🏅 115 коммитов, атрибутированных GitHub}	Randi _{🏅 108 коммитов, атрибутированных GitHub}	Chris _{🏅 70 коммитов, атрибутированных GitHub}	WebPerson _{🏅 68 коммитов, атрибутированных GitHub}	Koosha Paridehpour _{🏅 68 коммитов, атрибутированных GitHub}

_{Повторная проверка выполнена 2026-11-03 02:09:16 UTC: коммиты, атрибутированные GitHub, согласно данным Contributors API репозитория для ветки по умолчанию release/v3.8.53. API вернул 903 идентификатора (429 пользователей, 2 бота, 472 анонимных); из этой таблицы исключены сопровождающий, боты и анонимные идентификаторы, а места с одинаковыми результатами сохранены. Этот рейтинг отличается как от приведённого выше рейтинга объединённых PR, так и от представленного ниже подсчёта метаданных Git.} > 🙏 Функции, исправления ошибок и улучшения инфраструктуры этих участников — **важнейшая часть** того, что делает OmniRoute надёжным и функционально насыщенным. Важен каждый pull request, каждый тестовый сценарий и каждый файл перевода i18n. Открытый исходный код создают такие люди, как они.

---
## 💖 Спонсоры

Огромное спасибо людям, которые финансируют OmniRoute из собственного кармана — каждый вклад помогает проекту оставаться бесплатным, независимым и продолжать развиваться.

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

_{… и другим людям, предпочитающим сохранять конфиденциальность 💛} _{Данные о публичных спонсорах GitHub повторно проверены 2026-10-18 через GitHub Sponsors GraphQL API: 11 публичных спонсорских взносов (6 активных, 5 прошлых) из 14 в общей сложности. Статус GitHub isActive определяет приведённые выше пометки об активности; публичные пользователи, ранее оказавшие разовую поддержку, по-прежнему упомянуты с благодарностью, а частные спонсоры остаются анонимными. Пожертвования через Ko-fi, Buy Me a Coffee, Liberapay, PIX и в криптовалюте не указаны, поскольку для них нет публичной записи о спонсоре.} 💖 Стать спонсором → — каждый доллар помогает OmniRoute оставаться бесплатным и независимым.

## 👥 Более 1 000 участников

[![Contributors](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=1074&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors) _{Аудит проведён 02.11.2026 на актуальном коммите release/v3.8.53 1c7135e0fb (7 972 коммита): 1 074 нормализованных человеческих идентификатора Git — 759 отображаются как авторы коммитов (включая сопровождающего), а 315 указаны только в явных трейлерах Co-authored-by. При подсчёте учитывается .mailmap, адреса электронной почты сравниваются без учёта регистра, числовые и обычные адреса GitHub noreply объединяются только в том случае, если они содержат один и тот же идентификатор, исключаются 29 идентификаторов ботов/агентов/служб/заполнителей, а обычные адреса электронной почты не объединяются только на основании совпадения отображаемых имён. Аудит от 24.08.2026 выявил 639 участников; повторный запуск этого метода на его исходном коммите ac02c5b42f даёт 619, поэтому увеличение связано с появлением новых участников, а не с применением менее строгого метода.} ### Как внести вклад 1. Создайте форк репозитория 2. Создайте ветку от **актуального** коммита `release/vX.Y.Z` (не от `main`) — см. [Модель ветвления и выпуска](docs/ops/BRANCHING_MODEL.md) 3. Создайте ветку для своей функции (`git checkout -b feat/amazing-feature`) 4. Зафиксируйте изменения (`git commit -m 'feat: add amazing feature'`) 5. Отправьте ветку (`git push origin feat/amazing-feature`) 6. Откройте запрос на включение изменений с **base = этой веткой** `release/vX.Y.Z` Подробные рекомендации см. в [CONTRIBUTING.md](CONTRIBUTING.md). ### Выпуск новой версии ```bash # Создать выпуск — публикация через npm выполняется автоматически 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 3 ноября 2026 г. — поставьте этим проектам звезду. Значения представляют собой точный снимок на указанную дату и, естественно, будут меняться. ### 🧬 Происхождение и шлюз

Проект	⭐	Как он вдохновил OmniRoute
9router	31,861	Исходный проект, на котором основан этот форк — здесь он расширен поддержкой мультимодальных API и полностью переписан на TypeScript.
CLIProxyAPI	57,329	Реализация на Go, вдохновившая этот порт на JavaScript / TypeScript.
LiteLLM	62,580	AI-шлюз, чей общедоступный набор данных о ценах используется для синхронизации отслеживания затрат, а модель нормализации провайдеров повлияла на нашу маршрутизацию.
codex-chatgpt-web	15,435	Исходный код под лицензией MIT, адаптированный для поставляемого моста ChatGPT Web → Codex Responses, включая адаптеры браузерной сессии, формата ответов, статистики использования и веб-поиска.
free-claude-code	65,966	Шаблоны, перенесённые в восстановление потоков, псевдонимы без рассуждений, резервный веб-поиск, ограничения по скользящему окну, редактирование журналов и усиленные сценарии запуска.
composer-api	347	Шаблоны выбора инструментов, ограничений вывода и фиксации инструментов Cursor Composer, адаптированные для собственного исполнителя Cursor.
codex-multi-auth	561	Шаблоны повторной аутентификации при новом входе и ротации токенов обновления, перенесённые в OAuth-реаутентификацию Codex.
opencode-anthropic-auth	562	Совместимые с Claude Code значения преобразований по умолчанию и поведение заголовков биллинга, обобщённые в управляемом конфигурацией мосте OmniRoute.
grok2api-merged	2	Его сопоставления моделей Grok, генератор Statsig с фиктивным TypeError, значения запросов и устройств по умолчанию, а также обработчик ответов NDJSON были существенно адаптированы для исполнителя Grok Web в OmniRoute.
TQZHR/grok2api	707	Основной транзитивный источник кода для grok2api-merged; его реализации моделей, заголовков, полезной нагрузки, Statsig и обработчика сохранены в цепочке происхождения Grok Web.
chenyme/grok2api	7,874	Базовый исходный код под лицензией MIT для значений полезной нагрузки Grok и устройств по умолчанию, генератора Statsig и обработчика `result.response`, переданных через TQZHR и grok2api-merged.
grok2api-pro	27	Транзитивный источник, указанный grok2api-merged для слоя пула прокси; OmniRoute сохраняет это упоминание о происхождении, но не заявляет о переносе пула прокси в своём ограниченном исполнителе Grok Web.
GrokProxy	52	Его прокси Grok с аутентификацией по cookie и шаблон потоковой передачи `result.response.token` повлияли на транспорт Grok Web в OmniRoute.
GrokBridge	5	Его исходная реализация Grok Web использовалась при разработке HTTP/browser-дизайна взаимодействия с внешним сервисом; её прямой HTTP-путь основан на GrokProxy, поэтому отдельный перенос кода не заявляется.

### 🗜️ Сжатие контекста и токенов — движки

Проект	⭐	Как он вдохновил OmniRoute
Caveman	116,957	Вирусный проект «зачем использовать много токенов, если можно использовать мало токенов» — его философия речи пещерного человека лежит в основе нашего стандартного режима сжатия и более чем 30 правил удаления заполнителей и конденсации.
RTK – Rust Token Killer	85,350	Высокопроизводительное сжатие вывода команд — вдохновило наш движок RTK, DSL фильтрации JSON, восстановление исходного вывода и объединённый конвейер RTK → Caveman.
headroom	78,672	Обратимое сжатие контекста (SmartCrusher) — вдохновило наш движок `headroom` и шаблон маркеров извлечения `ccr`.
LLMLingua	6,797	Исследования сжатия промптов (LLMLingua / LLMLingua-2) — вдохновили наш асинхронный, безопасный для кода и допускающий исходный режим при сбоях движок `llmlingua`.
llmlingua-2-js	33	Порт на JS/ONNX (MobileBERT / XLM-RoBERTa), используемый как серверная часть рабочего потока для нашего движка LLMLingua.
Troglodita	50	Сжатие токенов для PT-BR — лежит в основе нашего языкового пакета pt-BR: сокращение плеоназмов и удаление заполнителей, настроенные для грамматики бразильского португальского.
ponytail	182,929	Вирусный навык YAGNI-кодера «ленивого опытного разработчика» — вдохновил наш стиль вывода меньше кода: управление изменениями по принципу минимального рабочего решения, сокращающее _сгенерированный_ код (аналог краткой прозы Caveman по оси вывода).
i-have-adhd	59,838	Его ориентированный на действия и удобный для людей с СДВГ стиль ответов был адаптирован в краткий стиль вывода OmniRoute для пяти языков.

### 🧩 Компактные форматы, исследования токенов и инструменты с учётом кода

Проект	⭐	Как он вдохновил OmniRoute
TOON	25,602	Token-Oriented Object Notation — его табличная модель с заголовком и строками определила этап табличной компактификации.
GCF – Graph Compact Format	61	Его компактный формат графов и дизайн с универсальными профилями повлияли на табличную компактификацию OmniRoute и формат кодека Headroom.
gcf-typescript	4	Реализация на TypeScript под лицензией MIT, непосредственно включённая в проект и расширенная в качестве кодека универсальных профилей Headroom.
token-optimizer-mcp	566	Кэш Brotli/SQLite + дельта контекста для каждого сеанса — вдохновили наш движок `session-dedup`.
token-savior	1,203	Компактификация вывода Bash + профили MCP — вдохновили нашу дисциплину отказа от сжатия и сокращение манифеста инструментов MCP.
token-saver	162	Компрессия вывода с учётом содержимого и типа каждого файла с отказом при сбоях — подтвердила нашу диспетчеризацию по типам и пропуск при минимальном выигрыше.
token-optimizer	2,853	«Найдите призрачные токены» — его шаблон выгрузки с возможностью восстановления по дескриптору повлиял на наши идеи выгрузки CCR.
TokenMizer	34	Схема графа сеанса и дедупликации строк между ходами, повлиявшая на дизайн нашего session-dedup.
OmniCompress	3	Колончатый JSON на Rust + извлечение по адресу содержимого + дедупликация между сообщениями — подтвердили дизайн наших движков `headroom`/`ccr`/`session-dedup` и инвариант стабильности кэша «сжатая форма не зависит от позиции».
mcp-compressor	140	Сжатие схем и описаний инструментов MCP — повлияло на сокращение количества инструментов в манифесте MCP.
RepoMapper	218	Ранжирование карты репозитория в стиле Aider — повлияло на наше исследование карты репозитория и ранжирования извлечения.
quiet-shell-mcp	4	Декларативное сокращение вывода shell через MCP — подтвердило нашу декларативную компактификацию вывода Bash.
ts-morph	6,222	Набор инструментов API компилятора TypeScript — вдохновил наше удаление комментариев на основе парсера с сохранением строковых, шаблонных и регулярных литералов.

### 🧠 Память и RAG

Проект	⭐	Как он вдохновил OmniRoute
Mem0	68,294	Универсальный слой памяти — его модель прокси как границы записи/чтения сформировала нашу архитектуру памяти.
Letta (MemGPT)	25,321	Состояние агентов с многоуровневой памятью — вдохновило нашу многоуровневую модель Context Control & Recovery (CCR).
WFGY	1,804	Таксономия ProblemMap из 16 часто встречающихся режимов сбоев RAG/LLM — общий словарь в нашем руководстве по устранению неполадок.

### 🛰️ Инспекция трафика, MITM и прозрачный прокси

Проект	⭐	Как он вдохновил OmniRoute
llm-interceptor	81	Перехват и анализ трафика между помощником программиста и LLM по схеме MITM сформировали ранние требования к Traffic Inspector. Четыре ранее производных модуля — объединение SSE, нормализация разговоров, маскирование секретов и очистка заголовков — были заменены независимыми реализациями, созданными в чистом окружении на основе общедоступных стандартов протоколов. Две поверхности передачи хост-трафика (`passthrough.ts` и `_internal/bypass.cjs`) остаются внутренними реализациями OmniRoute, классифицированными независимо; они не переписывались в рамках этой замены.
ProxyBridge	6,978	Прозрачная маршрутизация прокси для каждого процесса — вдохновила безопасное при сбоях завершение MITM, тайм-ауты простоя сокетов, атрибуцию процессов через `/proc` и перехват TPROXY.

### 📚 Данные о моделях, наблюдаемость и UI

Проект	⭐	Как он вдохновил OmniRoute
models.dev	7,486	Открытая база данных спецификаций, цен и возможностей AI-моделей — нативно синхронизируется с нашим каталогом моделей.
React Flow / xyflow	38,874	Библиотека графов на основе узлов, обеспечивающая работу наших студий Compression Studio и Combo/Routing Studio в реальном времени.
LangGraph	44,349	Визуализация рабочих графов в реальном времени в LangGraph Studio вдохновила представление каскада в реальном времени в наших студиях.
Langfuse	36,907	Его модель наблюдаемости trace → span → generation сформировала представление водопада в Compression Studio.
Kiali	3,647	Наблюдаемость сервисной сетки Istio — вдохновила значки автоматического размыкателя цепи и визуализацию рёбер ошибок в Routing/Combo Studio.
lobe-icons	2,666	Логотипы брендов AI/LLM, отображающие значки провайдеров на нашей панели управления.
flag-icons	12,499	Предоставляет флаги SVG под лицензией MIT, используемые переключателем языков README.

### 🛡️ Безопасность

Проект	⭐	Как он вдохновил OmniRoute
awesome-secure-defaults	723	Подборка библиотек с безопасными настройками по умолчанию, определяющая наш выбор средств безопасности (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).

### 🧭 Дополнительные инструменты

Проект	⭐	Как он вдохновил OmniRoute
ClawRouter	6,649	Вдохновил дедупликацию запросов, экстренный бесплатный резервный вариант, подключаемые стратегии Auto-Combo и многоязычную классификацию намерений.
Antigravity-Manager	32,785	Учитывающее учётные записи переназначение моделей, проверка путей к исполняемым файлам и поведение меток тарифных планов повлияли на среду выполнения Antigravity в OmniRoute.
vscode-antigravity-cockpit	4,852	Его компактный формат обратного отсчёта до сброса квоты вдохновил соответствующее отображение ограничений провайдера в OmniRoute.
AionUi	33,996	Его интеграции ACP вдохновили автоматическое обнаружение установленных CLI-агентов в OmniRoute.
CodexBar	22,955	Выявил поверхность квот Grok Build; затем OmniRoute независимо проверил и исправил фактический формат передачи по проводному протоколу.

## 📄 Лицензия Лицензия MIT — подробности см. в файле [LICENSE](LICENSE). ---

**[⬆ Вернуться наверх](#-omniroute)** · Создано ❤️ для сообщества разработчиков ИИ с открытым исходным кодом. _{Создано Diego Souza · OmniRoute v3.8.54 · Node ≥22.22.2 · Лицензия MIT · omniroute.online}