# 🚀 OmniRoute — Бесплатный AI-шлюз
### Код без остановок. Один endpoint — **278 провайдеров**, **90+ бесплатных**.
**Claude Code, Codex, Cursor, Cline, Copilot и Antigravity → бесплатные Claude / GPT / Gemini с автопереключением.**
**RTK + Caveman: экономия 15–95% токенов. Лимиты больше не мешают.**
**~1.53B учитываемых бесплатных токенов / месяц** — в первый месяц до **~2.15B** с регистрационными бонусами. Живой учёт на `/dashboard/free-tiers`. ([методика →](../../reference/FREE_TIERS.md))
[](#-278-ai-провайдеров--90-бесплатных)
[](#-278-ai-провайдеров--90-бесплатных)
[](../../reference/FREE_TIERS.md)
[](#️-экономьте-1595-токенов--автоматически)
[](#-комбо--главная-фича)
[](#-быстрый-старт)
### 💬 Сообщество
[](https://discord.gg/U47eFqAXCn)
[](https://t.me/omnirouteOficial)
[](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t)
[](https://chat.whatsapp.com/LTSpdFhXTxjH4R6CCNiKWz)
**Вопросы, советы по провайдерам, roadmap и поддержка → [Discord](https://discord.gg/U47eFqAXCn) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 Global](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) / [🇧🇷 Brasil](https://chat.whatsapp.com/LTSpdFhXTxjH4R6CCNiKWz)**
[](https://www.npmjs.com/package/omniroute)
[](../../../LICENSE)
[](https://github.com/diegosouzapw/OmniRoute)
[](https://www.npmjs.com/package/omniroute)
[](https://hub.docker.com/r/diegosouzapw/omniroute)
[](https://omniroute.online)
[**🚀 Быстрый старт**](#-быстрый-старт) • [**🎯 Комбо**](#-комбо--главная-фича) • [**🌐 Провайдеры**](#-278-ai-провайдеров--90-бесплатных) • [**🔌 CLI и MCP**](#-полный-cli--a2a-и-mcp) • [**🗜️ Сжатие**](#️-экономьте-1595-токенов--автоматически) • [**🌍 Сайт**](https://omniroute.online)
[💥 Обещание](#-обещание) • [🤔 Зачем](#-зачем-omniroute) • [🏆 Чем отличается](#-чем-omniroute-отличается) • [🤖 Совместимые CLI](#-совместимые-cli-и-агенты) • [🖥️ Где запускать](#️-где-запускается-omniroute--везде) • [🔒 Приватность](#-приватно-и-local-first) • [🎬 В деле](#-omniroute-в-деле) • [📚 Дальше](#-узнать-больше) • [📧 Поддержка](#-поддержка-и-сообщество)
# 💰 ~1.53B бесплатных токенов / месяц
> Собирать free-tier вручную — боль: десятки SDK, лимиты и непонятный остаток. OmniRoute сводит **документированные** free-tier **43 пулов / 460+ моделей** в одно честное число и показывает его live на `/dashboard/free-tiers`.
>
> - **~1.53B free tokens / мес** (steady) — в первый месяц до **~2.15B** с signup-кредитами.
> - **Честная математика** — каждый shared pool считается **один раз**. «Если крутить rate limit 24/7» выйдет ~10B — такие цифры мы **не** публикуем.
> - **Отдельно** — навсегда бесплатные провайдеры без cap (SiliconFlow, Z.AI GLM-Flash, Kilo, OpenCode Zen…) и **+$10 OpenRouter** → **+24M/мес** (не раздувают headline).
> - **По моделям**, used/remaining и пометки ToS — прямо в дашборде.
> Методика (дедуп пулов, кредиты, ToS): **[docs/reference/FREE_TIERS.md](../../reference/FREE_TIERS.md)**. Цифры пересматривают примерно раз в две недели — могут и **упасть**, и **вырасти**. CI (`check:docs-counts`) падает, если headline расходится с каталогом.
# 💥 Обещание
> Один endpoint. **278 провайдеров.** Код не останавливается — OmniRoute сам выбирает самый дешёвый рабочий вариант.
🚫 Не упирайтесь в лимиты Авто-fallback по 278 провайдерам за миллисекунды. Квота кончилась — следующий подхватывает, без простоя.
💸 До 95% токенов RTK + Caveman stacked: 15–95% на сжимаемом (в tool-heavy сессиях в среднем ~89%).
🆓 Старт с $0 90+ free-tier, 40+ free forever (Kiro, Qoder, Pollinations, LongCat…). Карта не нужна.
🔌 Все инструменты 26+ coding agents — Claude Code, Codex, Cursor, Cline, Copilot, Antigravity — один конфиг.
🧩 Один endpoint OpenAI ↔ Claude ↔ Gemini ↔ Responses API. Укажите /v1 — и готово.
> Ваши ключи, ваша машина, ваши данные. OmniRoute — **локальный прокси**, без «звонков домой».
- 🏠 **100% на вашем железе** — npm, Docker, desktop или телефон. Нет cloud-hop OmniRoute.
- 🔐 **Credentials at rest** — API keys и OAuth в **AES-256-GCM**.
- 🚫 **Zero telemetry по умолчанию** — промпты уходят только выбранным провайдерам.
- 🛡️ **Жёсткий gateway** — scoping ключей, IP filter, rate limits, prompt-injection guard, loopback-only process routes.
- 📜 **MIT, fully open-source** — аудируйте построчно, self-host навсегда.
📖 [Authorization](../../architecture/AUTHZ_GUIDE.md) · [Guardrails](../../security/GUARDRAILS.md) · [Compliance](../../security/COMPLIANCE.md)
# 🔌 Полный CLI + A2A и MCP
> Это не «просто сервер» — **CLI-кокит** с **80+ командами** и открытыми agent-протоколами, чтобы AI управлял OmniRoute **сам**.
### ⌨️ Настоящий CLI
```bash
omniroute # gateway + dashboard (порт 20128)
omniroute chat # TUI-чат (/model /combo /skill /memory)
omniroute setup # мастер первого запуска
omniroute doctor # диагностика провайдеров, портов, native deps
```
### 🛰️ Remote mode — CLI здесь, OmniRoute на VPS
```bash
omniroute connect 192.168.0.15 # пароль → scoped token
omniroute models list # ← на REMOTE
omniroute configure codex # remote model → local Codex profile
omniroute tokens create --name ci --scope read
omniroute contexts use default # ← обратно на local
```
Scopes: `read` / `write` / `admin`. Process-spawning routes — только loopback.
📖 [Remote Mode](../../guides/REMOTE-MODE.md)
### 🤝 Подключите агента — он управляет шлюзом
| Протокол | Endpoint | Зачем |
|---|---|---|
| 🧰 **MCP (stdio)** | `omniroute --mcp` | Claude Desktop, Cursor, любой MCP client |
| 🌊 **MCP (HTTP)** | `http://localhost:20128/api/mcp/stream` | Remote MCP — **104 tools**, 31 scopes |
| 📡 **MCP (SSE)** | `http://localhost:20128/api/mcp/sse` | Streaming MCP |
| 🤝 **A2A** | `http://localhost:20128/.well-known/agent.json` | Agent-to-agent, JSON-RPC 2.0 + SSE |
```bash
claude mcp add-server omniroute --type http --url http://localhost:20128/api/mcp/stream
```
📖 [MCP](../../frameworks/MCP-SERVER.md) · [A2A](../../frameworks/A2A-SERVER.md) · [Agent Protocols](../../frameworks/AGENT_PROTOCOLS_GUIDE.md)
# 🗜️ Экономьте 15–95% токенов — автоматически
> **Зачем тратить много токенов, если хватает меньшего?** Каждый запрос идёт через compression pipeline **прозрачно** — клиент не меняется. Стек из **11 composable engines** (идеи [RTK](https://github.com/rtk-ai/rtk), [Caveman](https://github.com/JuliusBrussee/caveman), [LLMLingua-2](https://github.com/microsoft/LLMLingua), [Troglodita](https://github.com/leninejunior/troglodita)).
### 🧱 11-engine stack
| # | Engine | Что делает |
|---|---|---|
| 1 | **Session-Dedup** | Убирает повторённый cross-turn контент |
| 2 | **CCR** | Крупные блоки за retrieve-markers, fetch on demand |
| 3 | **RTK** | Умная фильтрация tool-result, dedup, truncation |
| 4 | **Headroom** | Lossless tabular compaction JSON arrays (~30%), GCF v3.2 |
| 5 | **Relevance** | Extractive scoring относительно last user query |
| 6 | **Caveman** | Rule-based prose (~65–75% на output) |
| 7 | **LLMLingua-2** | ML semantic pruning (MobileBERT ONNX), code-safe |
| 8 | **Lite** | Whitespace + image-URL trimming |
| 9 | **Aggressive** | Summarization + progressive aging старых turns |
| 10 | **Ultra** | Heuristic pruning + optional SLM tier |
Код, URL и structured data **всегда** сохраняются byte-perfect.
| Режим | Экономия | Когда |
|---|---|---|
| 🪶 **Lite** | ~15% | Безопасный always-on default |
| 🪨 **Standard (Caveman)** | ~30% | Ежедневный coding |
| ⚡ **Aggressive** | ~50% | Длинные tool-heavy сессии |
| 🔥 **Ultra** | ~75% | Максимум экономии |
| 🧰 **RTK** | 60–90% | Shell / test / build / git output |
| 🔗 **Stacked (RTK → Caveman)** | **78–95%** | Промпты + tool logs |
**Пример — Standard:**
> **До (69 tokens):** _"The reason your React component is re-rendering is likely because you're creating a new object reference on each render cycle…"_
>
> **После (19 tokens):** _"New object ref each render. Inline object prop = new ref = re-render. Wrap in useMemo."_
>
> **Тот же смысл. −72% tokens. Без потери точности.** ✅
Default stack: `RTK → Caveman`. Combined:
```txt
combined = 1 − (1 − RTK) × (1 − Caveman_input)
average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range = 78.4 – 94.6%
```
Precedence (high → low): header `x-omniroute-compression` › combo override › named profile › adaptive › panel default › off.
📖 [`COMPRESSION_GUIDE.md`](../../compression/COMPRESSION_GUIDE.md) · [`RTK_COMPRESSION.md`](../../compression/RTK_COMPRESSION.md) · [`COMPRESSION_ENGINES.md`](../../compression/COMPRESSION_ENGINES.md)
# ⚡ Быстрый старт
**1) Установка и запуск**
```bash
npm install -g omniroute
omniroute
```
> 💡 Видите `npm warn ERESOLVE` / peer-dep? [Это безвредно](../../getting-started/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated).
Dashboard: `http://localhost:20128` · API: `http://localhost:20128/v1`.
**2) Подключите FREE-провайдера (без signup)**
Dashboard → **Providers** → **Kiro AI** (free Claude, ~50 credits/mo) или **OpenCode Free** (без auth) → готово.
**3) Направьте coding tool**
```txt
Base URL: http://localhost:20128/v1
API Key: [Dashboard → Endpoints]
Model: auto (zero-config smart routing — или любой provider/model)
```
**4) Проверка**
```bash
curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY"
```
Должны появиться подключённые модели. 🎉 Дальше пишите код — OmniRoute сам роутит и делает fallback.
Если клиент **не умеет** custom headers — tokenized aliases:
```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, source, 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
```
**🛠️ Из исходников**
```bash
cp .env.example .env && npm install
PORT=20128 npm run dev
```
**📦 pnpm**
```bash
pnpm add -g omniroute@latest --allow-build=better-sqlite3 --allow-build=@swc/core && omniroute
```
**🐧 Arch Linux (AUR)**
```bash
yay -S omniroute-bin && systemctl --user enable --now omniroute.service
```
**🔧 Nix (Flake)**
```bash
nix develop
npm run dev
# или: devbox run npm run dev
```
📖 [Docker Guide](../../guides/DOCKER_GUIDE.md) — Compose, Caddy HTTPS, Cloudflare tunnels.
### Полезные флаги CLI
| Команда | Описание |
|---|---|
| `omniroute` | Сервер (`PORT=20128`, API + dashboard) |
| `omniroute --port 3000` | Порт 3000 |
| `omniroute --mcp` | MCP server (stdio) |
| `omniroute --no-open` | Не открывать браузер |
| `omniroute --help` | Справка |
Split-port:
```bash
PORT=20128 DASHBOARD_PORT=20129 omniroute
# API: http://localhost:20128/v1
# Dashboard: http://localhost:20129
```
### Удаление
| Команда | Действие |
|---|---|
| `npm run uninstall` | Убирает app, **сохраняет** `~/.omniroute` |
| `npm run uninstall:full` | Удаляет app **и** все ключи/БД |
| `npm uninstall -g omniroute` | Глобальный npm uninstall |
### Старт с $0 — Free Stack
| Шаг | Действие | Что открывается |
|---|---|---|
| 1 | Подключить **Kiro** (AWS Builder ID OAuth) | Claude Sonnet / Haiku |
| 2 | Подключить **Qoder** (Google OAuth) | kimi-k2-thinking, qwen3-coder-plus… |
| 3 | Подключить **Qwen** (Device Code) | qwen3-coder-plus/flash… |
| 4 | `/dashboard/combos` → шаблон **Free Stack ($0)** | Round-robin free-провайдеров |
IDE/CLI: `http://localhost:20128/v1` · API Key: любая строка (если `REQUIRE_API_KEY=false`).
> **Дополнительно free:** Groq (30 RPM), NVIDIA NIM (~40 RPM), Cerebras (1M tok/day), LongCat, Cloudflare Workers AI (10K Neurons/day).
# 🎬 OmniRoute в деле
🇧🇷 Português Полный гайд
🇺🇸 English Complete walkthrough
🇷🇺 Русский Полное руководство
> 🎬 **Сняли видео про OmniRoute?** Откройте [issue](https://github.com/diegosouzapw/OmniRoute/issues/new) или [discussion](https://github.com/diegosouzapw/OmniRoute/discussions) — добавим в этот раздел.
### 📘 Старт
| Документ | О чём |
|---|---|
| [User Guide](../../guides/USER_GUIDE.md) | Провайдеры, комбо, CLI, deploy |
| [Setup Guide](../../guides/SETUP_GUIDE.md) | Установка, CLI tools, protocols, timeouts |
| [CLI Tools](../../reference/CLI-TOOLS.md) | Claude Code, Codex, Cursor, Cline… |
| [Remote Mode](../../guides/REMOTE-MODE.md) | CLI с ноутбука → OmniRoute на VPS |
| [Quick Start](../../../README.md#-quick-start) | EN root: install → connect → point |
### 🔧 Ops
| Документ | О чём |
|---|---|
| [Docker Guide](../../guides/DOCKER_GUIDE.md) | Run, Compose, Caddy, tunnels |
| [Podman](../../../contrib/podman/README.md) | Quadlet, SELinux |
| [VM Deployment](../../ops/VM_DEPLOYMENT_GUIDE.md) | VM + nginx + Cloudflare |
| [Termux](../../guides/TERMUX_GUIDE.md) | Android |
| [Environment](../../reference/ENVIRONMENT.md) | Полный `.env` reference |
### 🧠 Архитектура и фичи
| Документ | О чём |
|---|---|
| [Architecture](../../architecture/ARCHITECTURE.md) | Система и data flow |
| [Compression Guide](../../compression/COMPRESSION_GUIDE.md) | Pipeline сжатия |
| [Resilience Guide](../../architecture/RESILIENCE_GUIDE.md) | Breakers, cooldown, queue |
| [Auto-Combo](../../routing/AUTO-COMBO.md) | Scoring и self-heal |
| [Proxy Guide](../../ops/PROXY_GUIDE.md) | 3-level proxy |
| [Free Tiers](../../reference/FREE_TIERS.md) | Free catalog |
### 🤖 Протоколы и API
| Документ | О чём |
|---|---|
| [API Reference](../../reference/API_REFERENCE.md) | Все endpoints |
| [MCP Server](../../frameworks/MCP-SERVER.md) | Tools, transports |
| [A2A Server](../../frameworks/A2A-SERVER.md) | Skills, streaming |
### 📋 Проект
| Документ | О чём |
|---|---|
| [CONTRIBUTING](../../../CONTRIBUTING.md) | Dev setup |
| [CHANGELOG](../../../CHANGELOG.md) | История релизов |
| [SECURITY](../../../SECURITY.md) | Vulnerability reporting |
| [I18N](../../guides/I18N.md) | 43 языка, pipeline переводов |
---
## 👥 Как внести вклад
1. Fork репозитория
2. Ветка: `git checkout -b docs/ru-readme-full-translation`
3. Commit: `git commit -m "docs(i18n): full Russian README rewrite"`
4. Push и **Pull Request** в upstream
Полный гайд: [CONTRIBUTING.md](../../../CONTRIBUTING.md).
[](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
---
## 📊 Star History
**Сделано с ❤️ open-source сообществом · MIT License · [omniroute.online](https://omniroute.online)**
⭐ Если OmniRoute помог сэкономить — поставьте star репозиторию.
