# README (Português (Brasil)) 🌐 **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) · 🇷🇴 [ro](../ro/README.md) · 🇷🇺 [ru](../ru/README.md) · 🇱🇰 [si](../si/README.md) · 🇸🇰 [sk](../sk/README.md) · 🇸🇮 [sl](../sl/README.md) · 🇷🇸 [sr](../sr/README.md) · 🇸🇪 [sv](../sv/README.md) · 🇰🇪 [sw](../sw/README.md) · 🇮🇳 [ta](../ta/README.md) · 🇮🇳 [te](../te/README.md) · 🇹🇭 [th](../th/README.md) · 🇹🇷 [tr](../tr/README.md) · 🇺🇦 [uk-UA](../uk-UA/README.md) · 🇵🇰 [ur](../ur/README.md) · 🇺🇿 [uz](../uz/README.md) · 🇻🇳 [vi](../vi/README.md) · 🇳🇬 [yo](../yo/README.md) · 🇨🇳 [zh-CN](../zh-CN/README.md) · 🇹🇼 [zh-TW](../zh-TW/README.md) ---

# 🚀 OmniRoute — O Gateway de IA Gratuito

OmniRoute — Nunca pare de codificar. Todas as ferramentas de IA → 358 provedores — mais de 150 gratuitos — através de um único endpoint. Claude Code, Codex, Cursor, Cline, Copilot & Antigravity em Claude / GPT / Gemini GRATUITOS com fallback automático. A compressão empilhada RTK + Caveman economiza 15–95% de tokens (~89% em média) — nunca atinja os limites. 358 provedores de IA · mais de 150 planos gratuitos · ~1.62B tokens gratuitos/mês · 19 estratégias de roteamento · $0 para começar.

## 💰 ~1,62 bi de tokens gratuitos / mês

> Combinar manualmente os níveis gratuitos é trabalhoso — dezenas de SDKs, dezenas de limites de requisições e nenhuma ideia de quanto você realmente tem. O OmniRoute cataloga **489 entradas de níveis gratuitos em 35 chaves de pools recorrentes** e calcula o total de tokens em destaque com base nos **17 pools com um orçamento mensal positivo publicado, mais cinco limites da Groq por modelo**, eliminando duplicações por pool compartilhado. As cotas que só são liberadas após uma verificação regional de identidade (atualmente: ModelScope) são exibidas separadamente, com +~6 mi condicionados à verificação regional de identidade, e nunca são incluídas no total em destaque. O resultado permanece visível no painel (`/dashboard/free-tiers`).

> Resumo animado da página ativa `/dashboard/free-tiers`. Metodologia completa (eliminação de duplicidades por pool, níveis de crédito, termos dos provedores): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**. > > _{Esses números são reavaliados a cada duas semanas com base no catálogo ativo e **podem variar nos dois sentidos** — se um provedor encerra um nível gratuito, o número diminui; se um novo é adicionado, ele aumenta. Publicamos o que o catálogo realmente calcula, nunca uma estimativa otimista arredondada para cima.}

⭐ Dê uma estrela no repositório se o OMNIROUTE ajudou você a economizar e facilitou seu trabalho.

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

[![Posição no histórico de estrelas](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) ### 💬 Participe da comunidade **👋 Siga o mantenedor — receba primeiro novidades sobre provedores, lançamentos e dicas:** [![Siga Diego no 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/) [![Siga @diegosouzapw no 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) [![Site](https://img.shields.io/badge/Website-omniroute.online-blue?logo=google-chrome&logoColor=white)](https://omniroute.online) **Dúvidas, dicas de provedores, roadmap e suporte → [Discord](https://discord.gg/U47eFqAXCn) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 Global](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) / [🇧🇷 Brasil](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) / [Portal](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK)**
## 📈 O Gateway Continua Crescendo

| | v3.8.49 | **v3.8.50** | `v3.8.51+` | | -------------------------------- | :-----: | :----------------------: | :----------: | | 🌐 Provedores | 290 | **357** | mais na fila | | 🧠 IDs únicos de modelos de chat | 1185 | **1312** | — | | 🖼️ Ponte de modalidades | — | 🆕 visão + áudio + vídeo | — | | 📡 Catálogo gratuito do Radar | — | 🆕 adesão opcional | — | | ⚖️ Agendamento ciente de cotas | — | 🆕 Quota-Share | — | | 📊 Telemetria de cotas | — | 🆕 ao vivo | — | **→ [Roteiro](ROADMAP.md) — seguindo nos trilhos rumo à `v3.9.0 LTS`**

## 🧩 Disponível [![versão npm](https://img.shields.io/npm/v/omniroute?color=cb3837&logo=npm)](https://www.npmjs.com/package/omniroute) ![NPM mensal](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) [![Licença: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](LICENSE) ![Downloads do Docker](https://img.shields.io/docker/pulls/diegosouzapw/omniroute?label=docker%20pulls&logo=docker&color=2496ED) ![Downloads do Electron](https://img.shields.io/github/downloads/diegosouzapw/omniroute/total?style=flat&label=electron%20downloads&logo=electron&color=47848F)

🚀 Comece	🚀 Início rápido	📦 Instalação	🆓 Configuração zero
💡 Aprenda	💥 A promessa	🤔 Por que o OmniRoute	🏆 O que o diferencia
⚙️ Recursos	🎯 Combos	🌐 Provedores	🔌 CLI e MCP
	🗜️ Compressão	🖥️ Onde é executado	🔒 Privado
👀 Veja	🎬 Em ação	✨ Novidades	🤖 CLIs compatíveis
💚 Apoie	💚 Apoie / Doe	💬 Comunidade	💖 Patrocinadores
📦 Projeto	🛠️ Stack tecnológica	📖 Documentação	👥 Colaboradores

🌐 Em 66 idiomas

## 🆓 Funciona assim que você instala — sem chaves, sem configuração

Funciona assim que você instala — configuração zero. Três passos: 1. Instalar — npm i -g omniroute, o servidor inicializa em localhost:20128. 2. Aponte sua ferramenta para http://localhost:20128/v1 — qualquer ferramenta compatível com OpenAI (Claude Code, Cursor, Cline). 3. Ele responde — chame o modelo auto para uma resposta instantânea, sem chave de API, sem cadastro, sem configuração. O provedor sem chave OpenCode Free já vem pré-configurado no combo auto, então uma instalação nova responde de imediato.

```bash # Instalação nova, zero credenciais — `auto` já funciona: curl http://localhost:20128/v1/chat/completions \ -H "Content-Type: application/json" \ -d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}' ``` _{Prefere um backend gratuito específico? Chame `oc/…` (OpenCode Free) diretamente. Depois, passe para `auto` e deixe o OmniRoute escolher.} _{📦 Scripts de início rápido para **Python, Node.js, PHP e cURL** → [`examples/quickstart/`](examples/quickstart/)}

# 💥 A Promessa

# 🤔 Por que OmniRoute?

Fluxo de solicitação do OmniRoute: seu IDE ou CLI (Claude Code, Cursor, Cline…) chama um endpoint local (http://localhost:20128/v1); o OmniRoute Smart Router (compressão RTK + Caveman, 19 estratégias de roteamento, disjuntores, TLS stealth, MCP, A2A, guardrails) pode fazer fallback em 4 níveis de provedor enquanto um alvo saudável elegível permanecer — Nível 1 Assinatura, Nível 2 Chave de API, Nível 3 Barato e Nível 4 Gratuito.

## 🤝 Apoiado pelos nossos Amigos de Código Aberto

> **Quer se juntar como um Amigo de Código Aberto?** Estas são as empresas que apoiam o código aberto e ajudam a manter o OmniRoute em movimento — e nós dizemos publicamente para onde vai cada token que nos dão. Entre em contato: [diegosouza.pw@outlook.com](mailto:diegosouza.pw@outlook.com)

Kimi
_{Moonshot AI} Agradecemos à Kimi (Moonshot AI), nossa Amiga Fundadora de Código Aberto, por apoiar este projeto! A Kimi é o laboratório de IA por trás das famílias de modelos de peso aberto K2 e K3 — o Kimi K3 oferece uma janela de contexto de 1M-token, visão nativa e codificação de nível de fronteira por uma fração dos preços dos modelos fechados, e funciona perfeitamente com Claude Code, Codex e todas as ferramentas de codificação que o OmniRoute oferece.

O que o suporte da Kimi impulsiona: Os créditos da API da Kimi impulsionam o pipeline de lançamento validado por IA do OmniRoute — o estágio de validação de mesclagem impulsionado pelo Kimi K3 que revisa cada pull request antes de ser enviado — além do desenvolvimento diário de recursos. O suporte de primeira classe da Kimi é enviado em ambas as vias: a API direta da Kimi (kimi-k3) e o plano de codificação Kimi Code (OAuth e chave de API). O OmniRoute também é o primeiro projeto de código aberto brasileiro no programa de suporte da Kimi. Obtenha uma chave de API da Kimi com 15% de créditos extras →

Cheaper Inference
_{cheaperinference.com} Agradecemos à Cheaper Inference, uma Amiga de Código Aberto do OmniRoute, por apoiar este projeto! A Cheaper Inference é um gateway classificado por custo que revende 42 modelos de ponta — Claude, GPT-5.x, Gemini, Kimi K3, GLM, DeepSeek, Grok e MiniMax — por trás de um endpoint compatível com OpenAI, roteando cada solicitação para o provedor elegível mais barato sem nunca cobrar acima do preço de tabela do fabricante do modelo.

Suporte de primeira classe no OmniRoute: Chat Completions, o endpoint nativo /v1/responses, visão, chamada de ferramenta e 3 modelos de imagem (grok-imagine, nano-banana-pro, nano-banana-2, acessíveis como cheaperinference/<model>). Obtenha uma chave de API →

_{Links marcados com aff=omniroute são links de parceiros. Eles financiam o projeto sem custo extra para você.}

_{🎟️ Promoção de Afiliados — cupons de inscrição gratuitos de provedores que não patrocinamos (clique para expandir)}

_{Esta seção é apenas para códigos de referência/cupom. Parcerias patrocinadas estão em 🤝 Apoiado pelos nossos Amigos de Código Aberto acima. O OmniRoute não tem patrocínio ou parceria com os provedores listados aqui — estes são cupons públicos que qualquer pessoa pode usar.}

_AgentRouter
_{agentrouter.org} _{AgentRouter — inscrição de afiliado · $100 em créditos grátis na inscrição (servidor gratuito, espere maior latência — melhor para testes, não para produção). Suporte de primeira classe no OmniRoute desde a v3.8.50: Chat Completions, o formato de wire compatível com Anthropic e o caminho compatível com OpenAI. Os modelos disponíveis incluem claude-opus-4-8, claude-opus-5, gpt-5.6-sol e muito mais. Pegue seus $100 →}

_{⚠️ Link de afiliado — O OmniRoute não tem patrocínio ou parceria com este provedor.}

_{Conhece outro provedor com um generoso cupom de inscrição gratuita que beneficia os usuários do OmniRoute? Abra uma issue e nós o adicionaremos aqui.}

## 🎯 Combos — O carro-chefe

Todas as 19 estratégias de roteamento de combos animadas — um bloco por estratégia: priority, fill-first, weighted, round-robin, p2c, least-used, random, strict-random, cost-optimized, headroom, reset-window, reset-aware, context-relay, context-optimized, cache-optimized, lkgp, auto, fusion, pipeline. Consulte a tabela acima para saber o que cada uma faz.

> Um **combo** é uma cadeia de modelos entre os quais o OmniRoute roteia **automaticamente**. Se a cota se esgotar, um provedor falhar ou os custos dispararem, o combo poderá avançar para o próximo modelo íntegro e elegível. 🛡️ ### ⚡ Configuração zero — basta usar `auto` Não é necessário criar um combo. Defina seu modelo como `auto` (ou uma variante), e o OmniRoute criará um combo virtual com base nos provedores conectados, pontuados em tempo real:

ID do modelo	O que ele otimiza
`auto`	🎯 Padrão equilibrado (LKGP — mantém seu último provedor que funcionou bem)
`auto/coding`	🧑💻 Pesos com prioridade para qualidade na geração de código
`auto/fast`	⚡ Menor latência primeiro
`auto/cheap`	💰 Menor custo por token primeiro
`auto/offline`	🔋 Maior folga de cota/limite de requisições primeiro
`auto/smart`	🔭 Prioridade para qualidade + 10% de exploração para descobrir modelos melhores
`auto/lkgp`	📌 Afinidade explícita com o último provedor que funcionou bem
`auto/chaos`	🧪 Pesos de injeção de falhas para testes de resiliência (engenharia do caos)

## ### 🔀 Ou crie o seu próprio — 19 estratégias de roteamento Todas as **19** estratégias — combine-as livremente em cada etapa do combo:

#	Estratégia	O que ela faz
1	`priority`	Lista ordenada pelo primeiro destino — esgota cada um antes de passar ao próximo 🥇
2	`fill-first`	Usa toda a cota de cada destino antes de avançar
3	`weighted`	Seleção aleatória ponderada pelo peso de cada destino
4	`round-robin`	Percorre os destinos em ordem, de forma cíclica
5	`p2c`	Balanceamento de carga aleatório por escolha entre duas opções
6	`least-used`	Seleciona o destino com a menor carga atual
7	`random`	Seleção aleatória uniforme (sem duplicatas)
8	`strict-random`	Seleção aleatória sem remover repetições 🎲
9	`cost-optimized`	Minimiza o custo em $ por requisição com base nos preços do catálogo em tempo real 💸
10	`headroom`	Seleciona o destino com a maior cota restante
11	`reset-window`	Prefere o destino cuja janela de cota será redefinida mais cedo
12	`reset-aware`	Classifica pelo tempo de redefinição da cota — janelas mais curtas primeiro 📊
13	`context-relay`	Transfere o contexto entre destinos em conversas longas 🧠
14	`context-optimized`	Seleciona a melhor opção para o tamanho atual do contexto
15	`cache-optimized`	Fixa cada prefixo reutilizável do prompt na mesma conta — maximiza os acertos do cache de prompts 🎯
16	`lkgp`	Caminho que funcionou bem por último — fixa no último provedor bem-sucedido e depois recorre às regras
17	`auto`	Pontuação em tempo real com 16 fatores para todas as conexões 🤖
18	`fusion`	Distribui a solicitação para um painel de modelos, e um modelo avaliador sintetiza uma única resposta 🧬
19	`pipeline`	Encadeia etapas — a saída de cada destino alimenta o próximo 🔗

_{O mecanismo Auto-Combo pontua cada candidato com base em **16 fatores** (integridade, cota, custo, latência, adequação à tarefa, qualidade, disponibilidade da sessão…) — consulte [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md).} ## ### 🧱 A resiliência é integrada (3 camadas independentes)

Resiliência do OmniRoute — 3 camadas independentes de autorrecuperação, a camada certa para a falha certa. Camada 1: disjuntor do provedor (provedor inteiro): é acionado somente em 408/5xx, limites OAuth 8× / chave de API 12× / local 2×, é redefinido após 60s/30s/15s para uma sondagem HALF-OPEN, recuperação sob demanda; enquanto estiver OPEN, o combo redireciona para o próximo provedor. Camada 2: tempo de espera da conexão (uma chave/conta): base de 5s para OAuth / 3s para chave de API, recuo exponencial de ×2 com proteção contra efeito manada, 429 respeita Retry-After, uma resposta bem-sucedida limpa todo o estado de erro; uma chave em tempo de espera é ignorada enquanto as chaves relacionadas continuam atendendo. Camada 3: bloqueio de modelo (um modelo): 429 por modelo, 404 local ou recusas de modo bloqueiam apenas esse modelo — nunca a conexão inteira. Estados terminais (banido, expirado, créditos esgotados) são responsabilidade do operador, não tempos de espera.

_{📖 [Mecanismo de Combo Automático](docs/routing/AUTO-COMBO.md) · [Guia de Resiliência](docs/architecture/RESILIENCE_GUIDE.md)}

## 🏆 O que diferencia o OmniRoute

_{📊 Metodologia completa e detalhes por recurso versus 9router, OpenRouter, CLIProxyAPI e LiteLLM → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)}
## 💚 Apoie o OmniRoute O OmniRoute tem licença MIT e é mantido de forma aberta. Se ele poupa seu tempo ou dinheiro, veja como ajudar a mantê-lo independente — escolha a opção que mais combina com você. O patrocínio nunca afeta a prioridade de roteamento; ele oferece visibilidade, não posição no ranking.

⭐ Dê uma estrela ao repositório	Grátis — ajuda genuinamente na visibilidade	Dê uma estrela ao OmniRoute
🐙 GitHub Sponsors	Contribuição única ou mensal · taxa zero da plataforma	github.com/sponsors/diegosouzapw
☕ Ko-fi	Contribuição única e rápida, sem cadastro para o doador	ko-fi.com/diegosouzapw
🧋 Buy Me a Coffee	Pequeno gesto informal	buymeacoffee.com/diegosouzapw
🖐 Liberapay	Recorrente · sem fins lucrativos · código aberto	liberapay.com/diegosouzapw
🇧🇷 PIX (Brasil)	Instantâneo, sem taxas	chave e QR abaixo
₿ Criptomoedas	BTC · ETH · USDT-TRC20 · USDC-Solana	endereços abaixo

**🇧🇷 PIX** — instantâneo, sem taxas (Brasil) Código QR PIX do OmniRoute

Chave (aleatória): `5d865059-bc44-483a-962d-43ceb80126eb` Pix copia e cola: ``` 00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD ```

₿ Criptomoedas — BTC · ETH · USDT-TRC20 · USDC-Solana (clique para expandir)

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

_{⚠️ Envie cada moeda somente pela rede indicada — o envio pela rede errada pode resultar na perda dos fundos.}

🐛 Encontrou um bug ou tem algum comentário? Abra uma [Discussão](https://github.com/diegosouzapw/OmniRoute/discussions).

Notas para desenvolvedores: O projeto pode gerar um arquivo local .env durante a instalação ou o postinstall do npm para facilitar o trabalho dos desenvolvedores. Esse arquivo é intencionalmente ignorado por meio do .gitignore (consulte .gitignore) e nunca deve ser commitado — se for commitado acidentalmente, substitua todos os segredos expostos e remova o arquivo do histórico. Consulte docs/DEVELOPER-ENVIRONMENT.md para obter orientações sobre como gerenciar arquivos de ambiente locais e segredos.

## 📡 Radar do OmniRoute O principal destaque do nível gratuito continua sendo **~1,62 bilhão de tokens/mês** do catálogo documentado e com pools sem duplicação acima. Créditos temporários de cadastro de provedores podem, separadamente, elevar o primeiro mês para **~2,22 bilhões**. O Radar é uma sobreposição opcional e assinada do catálogo para quem deseja informações mais atualizadas sobre a disponibilidade de modelos gratuitos entre os lançamentos do OmniRoute; o catálogo da comunidade e todos os recursos gratuitos existentes continuam gratuitos. Os apoiadores podem receber o catálogo em tempo real e oportunidades adicionais de provedores. Seu limite separado e variável é de **aproximadamente 3 bilhões de tokens/mês, no máximo**, dependendo da disponibilidade dos provedores. Esse limite não é uma garantia: os provedores podem alterar cotas, elegibilidade, modelos ou regiões a qualquer momento. O Radar é opcional e usa apenas GET. O cliente OmniRoute não envia prompts, tráfego, configuração de provedores, telemetria de uso nem o estado local de dispensa de anúncios. Saiba mais sobre a elegibilidade e o catálogo atual em **[radar.omniroute.online/planos](https://radar.omniroute.online/planos)**.

## ✨ Novidades

> Destaques recentes da **v3.8.20 → v3.8.50**. Histórico completo em [`CHANGELOG.md`](CHANGELOG.md). - **🎛️ OmniConductor** — delegação A2A de entrada para sua frota de agentes, habilidades do Conductor no Agent Card e um painel no dashboard com chat por voz push-to-talk do Faro. → [Servidor A2A](docs/frameworks/A2A-SERVER.md) - **🛂 Admissão adaptativa e proteção contra sobrecarga** — solicitações pesadas de chat entram na fila em vez de retornarem 503, com concessões móveis atômicas de RPM por conexão. → [Guia de resiliência](docs/architecture/RESILIENCE_GUIDE.md) - **🗂️ Ordenação canônica de `/v1/models`** — um bloco contíguo agrupado por provedor para cada provedor (combos fixados primeiro), estável em todas as fontes do catálogo. → [Referência da API](docs/reference/API_REFERENCE.md) - **🗜️ Reforço da compressão** — proteção contra inflação ativada por padrão, pacotes Caveman para DE / FR / JA + chinês (wényán), filtros RTK para Gradle e .NET. → [Compressão](docs/compression/COMPRESSION_ENGINES.md) - **💸 Custo fixo realista** — provedores de assinatura / planos de programação aparecem com custo de **$0** nas análises; orçamento, cota e roteamento continuam fazendo estimativas. → [Referência da API](docs/reference/API_REFERENCE.md) - **⚖️ Roteamento Quota-Share** — distribui de forma justa a cota de uma conta compartilhada entre chaves agrupadas, preservando o trabalho para que parcelas ociosas sejam emprestadas. → [Guia de resiliência](docs/architecture/RESILIENCE_GUIDE.md) - **🤖 Configuração de CLI/agente com um único comando** — 13 comandos `setup-*` registrados; `omniroute run` inicia 7 CLIs (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); `omniroute configure` oferece suporte a 10 destinos, com um seletor interativo de provedor+modelo e favoritos por contexto. → [Integrações de CLI](docs/guides/CLI-INTEGRATIONS.md) - **🛰️ Modo remoto** — controle uma instância remota do OmniRoute com tokens de escopo limitado (`connect` / `contexts` / `tokens`) + um auxiliar OAuth `antigravity` para instalações em VPS. → [Modo remoto](docs/guides/REMOTE-MODE.md) - **🧭 Roteamento automático mais inteligente** — combos `auto/:`, **Fusion** (painel de modelos + avaliador), roteamento sensível à tarefa, substituições por solicitação de modelo / modo / orçamento em USD. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🗜️ Compressão plugável** — 12 mecanismos combináveis + Compression Studios: LLMLingua-2, Ultra de dois níveis, omniglyph, controle de fidelidade por etapa, GCF v3.2, editor com reordenação por arrastar. → [Compressão](docs/compression/COMPRESSION_ENGINES.md) - **🕵️ Descriptografia MITM transparente (TPROXY)** — capture CLIs que ignoram variáveis de ambiente de proxy, com uma CA por SNI + instalador de armazenamento de confiança. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md) - **💸 Telemetria de custos em toda parte** — cabeçalhos de custo/uso `X-OmniRoute-*` em todos os endpoints, cabeçalho de economia por cache HIT, cotas de gastos em USD por chave. → [Referência da API](docs/reference/API_REFERENCE.md) - **🧠 Memória sob seu controle** — desativada por padrão, quantização vetorial int8 opcional + decaimento tipado, `x-omniroute-no-memory` por solicitação. → [Memória](docs/frameworks/MEMORY.md) - **🛡️ Segurança** — proteção contra injeção de prompt em todas as rotas LLM (suíte de red team), mecanismo opcional de mascaramento de credenciais (remove chaves de API/segredos vazados em ambas as direções), pesquisa web gratuita no DuckDuckGo como último recurso e uma barreira opcional de login OIDC para o dashboard (o login por senha permanece sempre disponível). → [Proteções](docs/security/GUARDRAILS.md) - **🖼️ Novos endpoints** — `/v1/ocr` (Mistral OCR) e `/v1/audio/translations` (no estilo Whisper) completam a cobertura de mídia. → [Referência da API](docs/reference/API_REFERENCE.md) - **🎨 Geração de imagens / vídeos / áudio** — uma API para mídia: xAI Grok Imagine e vídeos da Novita AI, ComfyUI, Magnific, Adobe Firefly, Segmind e provedores de voz como ElevenLabs. → [Referência da API](docs/reference/API_REFERENCE.md) - **🌍 Implantação e operações** — `basePath` de proxy reverso, detecção automática do idioma do navegador, rastreamento de dispositivos por chave, confiança MITM sem acesso root, localização zh-TW. → [Ambiente](docs/reference/ENVIRONMENT.md) - **🤝 Mais provedores e agentes** — agentes na nuvem (Codex Cloud, Cursor, Devin, Jules), Grok Build (xAI) com navegador + login OAuth, card dedicado do Ollama, Claude Opus 5 e Sonnet 5, parceria oficial com a Kimi (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… e um **catálogo atualizado com 352 provedores**. → [Provedores](docs/reference/PROVIDER_REFERENCE.md) - **📡 Transparência de roteamento** — cada resposta inclui um cabeçalho `X-OmniRoute-Decision` que identifica a estratégia/provedor/latência que a atendeu; uma nova estratégia de combo `cache-optimized` + o fator `cacheAffinity` do Auto-Combo encaminham solicitações repetidas de volta à conexão que mantém o prefixo em cache; e um endpoint somente leitura `/v1/auto-combo/{channel}/candidates` expõe o conjunto de candidatos em tempo real de um canal `auto/*`. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **⚡ Desempenho local e infraestrutura** — Redis local com um clique, implantadores de relay para Cloudflare Workers / Deno Deploy, Bifrost e Mux como serviços incorporados supervisionados. → [Serviços incorporados](docs/frameworks/EMBEDDED-SERVICES.md) - **🧩 Também incluído** — framework de plugins + marketplace, frameworks de habilidades Omni/Agent/GitHub, integração com cofres do Obsidian (22 ferramentas MCP), APIs Batch e Files compatíveis com OpenAI, cache semântico de respostas, gamificação com placares de líderes, descoberta de agentes ACP (15 agentes integrados), exportação agendada de logs para o BigQuery, injeção de falhas `auto/chaos`, uma ponte para bots do Telegram, um gerenciador de versões no aplicativo e rankings de provedores gratuitos do LMArena-ELO. → [Documentação](docs/README.md)

## 🤖 CLIs e agentes de programação compatíveis > Uma configuração — `http://localhost:20128/v1` — e **todos** os IDEs ou CLIs de IA são executados com modelos gratuitos e de baixo custo.

_{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

＋ também funciona com · Agent Deck · Kiro · Command Code · Antigravity · Windsurf · AMP · qualquer ferramenta compatível com OpenAI

_{📖 Configuração por ferramenta para todas as 36 ferramentas (26 CLIs de código + 10 agentes de CLI) → [`docs/reference/CLI-TOOLS.md`](docs/reference/CLI-TOOLS.md) · 🧩 Plugin do OpenCode → [`@omniroute/opencode-provider`](https://www.npmjs.com/package/@omniroute/opencode-provider)}

**Inicie qualquer CLI compatível por meio do OmniRoute com um único comando** — nenhum arquivo de configuração é gravado, as credenciais são injetadas por processo e Qwen/Gemini recebem um diretório home isolado e descartável: ```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" # Ou escolha o provedor e o modelo interativamente e grave a configuração da própria ferramenta: omniroute configure codex # também: claude opencode qwen aider goose gemini cline continue kilo ``` Todos os comandos respeitam o contexto remoto ativo (`omniroute connect `), `--dry-run` mostra uma prévia exata das variáveis de ambiente e dos argumentos sem executar nada, e `--api-key-env NAME` mantém os segredos fora do histórico do seu shell. → [Integrações com CLIs](docs/guides/CLI-INTEGRATIONS.md)

## 🌐 357 provedores de IA — 152 marcados como gratuitos no catálogo

> **357 provedores registrados** nas coleções canônicas de chat, mídia, pesquisa, local, agentes de nuvem e sistema, incluindo **152 com metadados de descoberta `hasFree: true`**. O registro de modelos de chat abrange **229 provedores / 2.554 pares distintos de provedor-modelo / 1.283 IDs brutos de modelos**; o catálogo separado de orçamentos gratuitos tem **491 entradas por modelo**, **35 pools recorrentes** e **54 provedores gratuitos para sempre, recorrentes/sem chave**. Esses denominadores são diferentes por definição; as definições e os cálculos com pools desduplicados estão na [Referência de Provedores](docs/reference/PROVIDER_REFERENCE.md) e nos [Planos Gratuitos](docs/reference/FREE_TIERS.md).

### 🏢 Todos os principais laboratórios — por meio de um único endpoint

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

_{…e mais de 330 — todos os ícones são carregados em tempo real a partir do catálogo de provedores do painel. 📖 [Referência de Provedores](docs/reference/PROVIDER_REFERENCE.md)}
### 🆓 Grátis para sempre — US$ 0, sem cartão

OpenCode Zen _{DeepSeek V4, Nemotron 3 Sem limite de tokens}	Kilo Code _{Roteador automático, Tencent Hy3 Grátis para sempre}	Requesty _{GPT-OSS 120B, Nemotron Grátis para sempre}	SiliconFlow _{DeepSeek V3.2 / R1 Plano gratuito}	Z.AI GLM _{GLM-4.7 / 4.5-Flash Grátis para sempre}	Baidu ERNIE _{ERNIE 4.0 Grátis para sempre}
Qoder AI _{Qwen3-Max, Kimi-K2 GRÁTIS e ilimitado}	Pollinations _{GPT, Llama, Claude Nenhuma chave necessária}	Cloudflare AI _{Mais de 50 modelos 10 mil neurônios/dia}	NVIDIA NIM _{GLM, MiniMax ~40 RPM grátis}	Cerebras _{GLM 4.7, GPT-OSS 1 milhão de tokens/dia}	OpenRouter _{Modelos :free +$10 → RPM mais alto}

📖 Catálogo completo legível por máquina → [`docs/reference/PROVIDER_REFERENCE.md`](docs/reference/PROVIDER_REFERENCE.md)

## 🖥️ Onde o OmniRoute roda — em qualquer lugar

> O mesmo aplicativo, sua máquina, suas regras. De uma instalação global via npm até **seu celular** via Termux.

Plataforma	Instalação	Destaques
📦 npm (global)	`npm install -g omniroute`	Um comando, qualquer sistema operacional
🐳 Docker	`docker run … diegosouzapw/omniroute`	Multiarquitetura AMD64 + ARM64
🖥️ Desktop (Electron)	`npm run electron:build`	Janela nativa + bandeja do sistema — Windows / macOS / Linux
🎩 Barra de menus (OmniRouteTray)	`brew install --cask zoispag/tap/omniroute-tray`	Supervisiona e atualiza automaticamente o servidor — macOS
💪 ARM	nativo em `arm64`	Raspberry Pi, servidores ARM, Apple Silicon
📱 Android (Termux)	`pkg install nodejs && npx -y omniroute`	Roda no seu celular, 24 horas por dia, 7 dias por semana, sem root
📲 PWA	"Adicionar à tela inicial"	Tela cheia, offline e instalável pelo navegador
🧩 Plugin do OpenCode	`@omniroute/opencode-provider`	Integração nativa com o OpenCode
🤖 VS Code Copilot Chat	instale a extensão OmniCopilot	Todos os modelos do OmniRoute no seletor nativo do Copilot Chat — versões estável e Insiders
🛠️ A partir do código-fonte	`npm install && npm run dev`	Modifique e contribua

_{📖 [Guia do Docker](docs/guides/DOCKER_GUIDE.md) · [Desktop](electron/README.md) · [Barra de menus](https://github.com/zoispag/omniroute-tray) · [Termux](docs/guides/TERMUX_GUIDE.md) · [PWA](docs/guides/PWA_GUIDE.md) · [OpenCode](docs/frameworks/OPENCODE.md)}

### 🧩 Novo: OmniRoute dentro do Copilot Chat nativo do VS Code

> Sem uma nova barra lateral, sem uma nova interface de chat — todos os modelos disponibilizados pelo OmniRoute aparecem diretamente no > **seletor de modelos do Copilot Chat que você já usa**. Desde o VS Code 1.122, os modelos de provedores funcionam > sem login no GitHub nem assinatura do Copilot — modo agente, chamadas de ferramentas e visão, tudo > gratuitamente. Instale a extensão **[OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)**, aponte-a para seu servidor OmniRoute (o padrão é `localhost:20128`) e abra Copilot Chat → seletor de modelos → **Gerenciar modelos…** → **OmniRoute**.

Loja	Link	Compatível com
🧩 VS Code Marketplace	Instalar →	VS Code — versões estável e Insiders
🔓 Open VSX Registry	Instalar →	Cursor, Windsurf, VSCodium, Theia, code-server, Gitpod, Antigravity, Kiro…

Dentro do editor: abra a visualização **Extensões**, pesquise por **"OmniRoute"** e clique em **Instalar** — funciona da mesma maneira nas duas lojas. O código-fonte, as issues e o guia do processo de publicação estão em [diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot). _{📖 [Guia do VS Code Copilot Chat](docs/guides/VSCODE-COPILOT.md) — configuração, o que o seletor exibe, painel em uma aba e solução de problemas}

### 🎩 Novo: OmniRouteTray — seu gateway na barra de menus

> `omniroute serve` funciona melhor quando está sempre ativo. O **[OmniRouteTray](https://github.com/zoispag/omniroute-tray)** > transforma isso em um aplicativo para a barra de menus do macOS que você configura e esquece: ele inicia o servidor, mantém o serviço ativo > após reinicializações, atualiza-o no próprio local e deixa seu orçamento de tokens em tempo real a apenas um clique — **sem > deixar uma janela do terminal aberta e sem precisar cuidar de `npm install -g omniroute`.** Desenvolvido com [Tauri v2](https://v2.tauri.app/) (um núcleo em Rust minúsculo), ele inclui seu próprio runtime assinado do Node 24 e gerencia uma instalação do OmniRoute pertencente ao aplicativo, portanto nunca entra em conflito com seu `node`/`bun` global. Ele **compartilha sua configuração e seu banco de dados existentes em `~/.omniroute/`** — portanto, é o mesmo OmniRoute que você já executa, só que de chapéu. 🎩

O que ele faz	Como
🟢 Supervisiona o servidor	Inicia `omniroute serve` e adota uma instância já em execução em vez de duplicá-la
📊 Uso em tempo real de relance	Barras de cota dos provedores, limites de sessão/semanais do Claude com contagens regressivas para redefinição e detalhamento de custos dos últimos 30 dias
🔄 Atualiza-se automaticamente no próprio local	Instalação em etapas, substituição atômica e reversão em caso de falha — sempre na versão mais recente
🚀 Inicia ao fazer login	Inicialização opcional ao fazer login; somente na barra de menus, sem ícone no Dock
🩺 Diagnóstico e logs	Diagnósticos com um clique e acesso aos logs do servidor

```sh brew install --cask zoispag/tap/omniroute-tray ``` _{Prefere baixar? Obtenha o .dmg mais recente em
Releases. O código-fonte, as issues e a documentação de compilação
estão disponíveis em zoispag/omniroute-tray.

💛 Um projeto da comunidade criado por @zoispag — não é uma versão oficial do OmniRoute.}

## 🔒 Privado e local-first

_{📖 [Autorização](docs/architecture/AUTHZ_GUIDE.md) · [Proteções](docs/security/GUARDRAILS.md) · [Conformidade](docs/security/COMPLIANCE.md)}

## 🔌 CLI completa + A2A e MCP

> Além do servidor, o OmniRoute é um **cockpit completo de linha de comando** com **mais de 80 comandos**, além de protocolos abertos para agentes, permitindo que um agente de IA o opere **por conta própria**. ### ⌨️ Uma CLI de verdade (não apenas `start`) ```bash omniroute # inicia o gateway + painel (porta 20128) omniroute chat # cliente de chat TUI interativo (barra: /model /combo /skill /memory) omniroute setup # assistente guiado para a primeira execução omniroute doctor # diagnostica provedores, portas e dependências nativas ``` ### 🛰️ Modo remoto — execute a CLI aqui e o OmniRoute em uma VPS OmniRoute em um servidor? Controle-o pelo seu laptop com a **mesma CLI**. Faça login uma vez com um token de acesso com escopo; depois disso, todos os comandos terão como destino a instância remota. ```bash omniroute connect 192.168.0.15 # senha → token com escopo, salvo como um contexto omniroute models list # ← executado no servidor REMOTO omniroute configure codex # ← seleciona um modelo remoto e grava um perfil local do Codex omniroute tokens create --name ci --scope read # gera tokens mais restritos para outras máquinas omniroute contexts use default # ← volta para o servidor local ``` Os tokens têm os escopos `read` / `write` / `admin`; as rotas que iniciam processos continuam restritas ao loopback. _{📖 [Modo remoto](docs/guides/REMOTE-MODE.md)}

Demonstração animada no terminal da CLI do OmniRoute — omniroute providers list, omniroute combo list e omniroute health — percorrendo os 86 comandos de nível superior disponíveis: 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 …

### 🤝 Conecte um agente — e ele controlará o próprio OmniRoute Exponha o OmniRoute por **MCP**, **A2A**, uma **API REST**, **webhooks** ou uma **CLI remota** — qualquer agente compatível (ou seu próprio código) recebe as chaves para controlar todo o gateway: roteamento, provedores, combos, cache, compressão e memória — de forma autônoma. Os endpoints HTTP abaixo são disponibilizados em `http://localhost:20128`.

Interface	Endpoint / comando	Use para
🧰 MCP (stdio)	`omniroute --mcp`	Integrar ao Claude Desktop, Cursor ou qualquer cliente MCP
🌊 MCP (HTTP)	`/api/mcp/stream`	MCP remoto — 110 ferramentas, 33 escopos (aplicação opcional), trilha de auditoria completa
📡 MCP (SSE)	`/api/mcp/sse`	Transporte MCP por streaming
🤝 A2A	`/.well-known/agent.json`	Agente para agente, JSON-RPC 2.0 + SSE, 6 habilidades
🌐 API REST	`/v1/*`	Compatível com OpenAI — chat, embeddings, imagens, áudio e OCR
🔔 Webhooks	`/api/webhooks`	Enviar eventos de solicitação / cota para Slack, Discord, Telegram ou qualquer URL
🛰️ CLI remota	`omniroute connect`	Controlar uma instância remota com tokens de acesso com escopo

```bash # Disponibilize ao Claude Code o conjunto completo de ferramentas do OmniRoute por MCP: claude mcp add-server omniroute --type http --url http://localhost:20128/api/mcp/stream ``` _{📖 [Servidor MCP](docs/frameworks/MCP-SERVER.md) · [Servidor A2A](docs/frameworks/A2A-SERVER.md) · [Protocolos de agentes](docs/frameworks/AGENT_PROTOCOLS_GUIDE.md)}

## 🗜️ Economize de 15–95% dos tokens — Automaticamente

### 📖 Como funciona — pipeline, arquitetura e cálculo da economia

Pipeline de compressão do OmniRoute: uma solicitação ilustrativa do cliente com 10.000 tokens passa por 12 mecanismos combináveis — Session-Dedup, CCR, Lite, RTK, Responses Tool Output, Headroom, Relevance, Caveman, Aggressive, LLMLingua-2, Ultra e OmniGlyph — e pode chegar ao provedor com cerca de 1.080 tokens no exemplo documentado de empilhamento. O conteúdo estruturado é protegido por salvaguardas de preservação e verificações de fidelidade em cada etapa; modos explicitamente com perdas ou experimentais podem transformar conteúdo elegível.

A combinação empilhada padrão executa `RTK → Caveman`. Quando ambos atuam sobre o mesmo payload de ferramenta/contexto, a economia é composta: ```txt combined = 1 − (1 − RTK) × (1 − Caveman_input) average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2% range = 78.4 – 94.6% ``` Blocos de código, URLs, JSON e dados estruturados são **sempre protegidos** pelo mecanismo de preservação. > **Por que usar muitos tokens quando poucos dão conta do recado?** Cada solicitação passa pelo pipeline de compressão do OmniRoute **de forma transparente** — sem alterações no cliente. Agora ele é uma **pilha de 12 mecanismos combináveis**, executados em ordem e combinados de diferentes maneiras conforme a configuração de roteamento — com base em ideias do [RTK](https://github.com/rtk-ai/rtk), [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ 90K+), [LLMLingua-2](https://github.com/microsoft/LLMLingua) e [Troglodita](https://github.com/leninejunior/troglodita) (PT-BR). ### 🧱 A pilha de 12 mecanismos Os mecanismos são executados na ordem do pipeline; cada um pode ser ativado, desativado e configurado de forma independente para cada combinação:

#	Mecanismo	O que faz
1	Session-Dedup	Remove conteúdo repetido entre turnos (endereçado por conteúdo, entre turnos)
2	CCR	Arquiva blocos grandes por trás de marcadores de recuperação, acessados sob demanda
3	Lite	Remoção de espaços em branco + URLs de imagens (base leve em latência)
4	RTK	Filtragem inteligente de resultados de ferramentas, desduplicação e truncamento (com reconhecimento de comandos)
5	Responses Tool Output	JSON priorizando a ausência de perdas + compressão limitada de diagnósticos para saídas de shell/patch/pesquisa/build (Responses API)
6	Headroom	Compactação tabular sem perdas de arrays JSON (~30%) por meio de um codec GCF incorporado
7	Relevance	Pontuação extrativa de frases em relação à última consulta do usuário
8	Caveman	Compressão de texto baseada em regras (~65–75% na saída)
9	Aggressive	Resumo + envelhecimento progressivo de turnos antigos
10	LLMLingua-2	Poda semântica com ML via MobileBERT ONNX — segura para código, assíncrona
11	Ultra	Poda heurística de tokens com uma camada opcional de modelo pequeno (SLM)
12	OmniGlyph	Codificação experimental de contexto como imagem para o Claude Fable 5 medido na conexão direta da Anthropic; os transformers do GPT 5.6 permanecem bloqueados por segurança enquanto aguardam comprovantes do provedor. Quatro perfis de compressão (agressivo por padrão, equilibrado, seguro para código, passagem direta) (mais agressivo; adesão opcional)

Blocos de código, URLs e dados estruturados são **sempre preservados** byte a byte. **Predefinições de um clique** combinam os mecanismos:

Modo	Economia	Mais indicado para
🪶 Lite	~15%	Padrão seguro sempre ativo
🪨 Standard (Caveman)	~30%	Programação diária
⚡ Aggressive	~50%	Sessões longas com uso intensivo de ferramentas
🔥 Ultra	~75%	Economia máxima
🧰 RTK	60–90%	Saídas de shell/test/build/git
🔗 Stacked (RTK → Caveman)	78–95%	Prompts mistos + logs de ferramentas

**Exemplo real — modo Standard:** > **Antes (69 tokens):** _"O motivo pelo qual seu componente React está sendo renderizado novamente provavelmente é que você está criando uma nova referência de objeto a cada ciclo de renderização. Quando você passa um objeto inline como prop, a comparação superficial do React o considera um objeto diferente todas as vezes, o que aciona uma nova renderização. Recomendo usar useMemo para memorizar o objeto."_ > > **Depois (19 tokens):** _"Nova referência de objeto a cada renderização. Objeto inline como prop = nova referência = nova renderização. Envolva em useMemo."_ > > **Mesma resposta. 72% menos tokens. Nenhuma perda de precisão.** ✅ **Exemplo em PT-BR — modo [Troglodita](https://github.com/leninejunior/troglodita):** > **Antes (42 tokens):** _"O problema é que o componente está re-renderizando porque uma nova referência de objeto está sendo criada em cada ciclo de renderização. Eu recomendaria usar useMemo."_ > > **Depois (12 tokens):** _"Re-render: ref nova cada ciclo (objeto inline recriado). Usar `useMemo`."_ > > **Mesma resposta. ~70% menos tokens. Precisão técnica intacta.** ✅
### 🎚️ Além dos mecanismos — estilos de saída, ajuste adaptativo e controle por requisição Os 12 mecanismos acima reduzem o que entra. Outras três camadas determinam **como**, **quando** e o que **sai**: - **🪄 Estilos de saída** _(direcionamento do eixo de saída)_ — injetam instruções determinísticas e seguras para cache que moldam a resposta; podem ser combinados, cada um com intensidade `lite` / `full` / `ultra`. Adicionar um estilo requer uma única linha no registro: - **Prosa concisa** — remove texto supérfluo / artigos / ressalvas; mantém a exatidão técnica. - **Menos código** — YAGNI de "dev sênior preguiçoso": a menor alteração funcional, sem estruturas não solicitadas. - **Rabo de cavalo (dev sênior preguiçoso)** — sobe a escada do YAGNI, corrige a causa raiz, produz o menor diff funcional. - **Tenho TDAH (ação primeiro)** — começa pela próxima ação, numera as etapas, fornece um único próximo passo concreto, sem preâmbulo. - **CJK conciso (文言)** — estilo ultraconciso em chinês clássico (restrito à localidade `zh`). - **🎯 Orçamento de contexto adaptativo** _(o ajuste)_ — em vez de um único limite de tokens liga/desliga, escala apenas os mecanismos mais baratos e com menor perda, até onde for necessário para **caber na janela de contexto do modelo**. Política: `reserve-output` (padrão, ciente do modelo) · `percentage` · `absolute`. Modo: `floor` (garante que caiba) · `replace-autotrigger` (sua escolha explícita prevalece) · `off` (limite legado). - **🎛️ Onde a compactação é decidida** _(precedência, alta → baixa)_ — cabeçalho `x-omniroute-compression` por requisição › substituição da combinação de roteamento › perfil nomeado ativo › adaptativo / acionamento automático › padrão do painel › desativado. O plano aplicado é retornado no cabeçalho de resposta `X-OmniRoute-Compression: ; source=`. Use o acionamento automático por limite de tokens, ative o ajuste adaptativo, fixe um perfil nomeado, defina uma configuração única por requisição ou atribua um pipeline por combinação de roteamento — o que melhor se adequar à carga de trabalho. Um **harness de avaliação** offline opcional (`npm run eval:compression`) pontua fidelidade versus economia em um corpus fixado antes de você promover uma alteração. 📖 [`COMPRESSION_GUIDE.md`](docs/compression/COMPRESSION_GUIDE.md) · [`RTK_COMPRESSION.md`](docs/compression/RTK_COMPRESSION.md) · [`COMPRESSION_ENGINES.md`](docs/compression/COMPRESSION_ENGINES.md)

# ⚡ Início rápido

**1) Instale e execute** ```bash npm install -g omniroute omniroute ``` > 💡 Está vendo `npm warn ERESOLVE` ou avisos de dependências peer? [Eles são inofensivos](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated). Painel em `http://localhost:20128` · API em `http://localhost:20128/v1`. **2) Conecte um provedor GRATUITO (sem cadastro)** Painel → **Provedores** → conecte o **Kiro AI** (Claude gratuito, ~50 créditos/mês por conta) ou o **OpenCode Free** (sem autenticação) → pronto. **3) Configure sua ferramenta de programação** ```txt URL base: http://localhost:20128/v1 Chave de API: [copie em Painel → Endpoints] Modelo: auto (roteamento inteligente sem configuração — ou qualquer provedor/modelo) ``` **4) Verifique se está funcionando** ```bash curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY" ``` Você deverá ver seus modelos conectados na lista. 🎉 Pronto — comece a programar, e o OmniRoute fará o roteamento automático e usará alternativas quando necessário. Se o seu cliente não conseguir enviar cabeçalhos personalizados, o OmniRoute também disponibiliza aliases de compatibilidade com token: ```txt Catálogo OpenAI: http://localhost:20128/vscode/YOUR_KEY/ Modelos OpenAI: http://localhost:20128/vscode/YOUR_KEY/models Chat OpenAI: http://localhost:20128/vscode/YOUR_KEY/chat/completions Respostas OpenAI: http://localhost:20128/vscode/YOUR_KEY/responses Chat Ollama: http://localhost:20128/vscode/YOUR_KEY/api/chat Tags Ollama: http://localhost:20128/vscode/YOUR_KEY/api/tags ``` Use-os apenas com clientes que não conseguem anexar `Authorization: Bearer ...`. A autenticação por cabeçalho continua sendo o modo recomendado.
## 📦 Mais métodos de instalação — Docker, código-fonte, 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` acompanha a versão estável SemVer **publicada** mais alta. Ela não acompanha a `main` do git. Fixe em `:X.Y.Z` para GitOps. Consulte [Canais de lançamento do Docker](docs/guides/DOCKER_GUIDE.md#release-channels). A imagem fixa **`OMNIROUTE_MEMORY_MB=1024`**. Isso é suficiente para o painel e um chat leve. **Agentes de programação** (`POST /v1/responses` do Claude Code, Codex, Grok, …) precisam de um heap V8 muito maior, caso contrário o processo apresenta `FATAL ERROR` com aproximadamente 12 GiB durante dois contextos longos sobrepostos. Dimensione o contêiner acima do tamanho do heap (os buffers nativos ficam fora do V8): | Carga de trabalho | Heap (`-e OMNIROUTE_MEMORY_MB`) | Contêiner (`--memory`) | | --------------------------------------- | ------------------------------- | ---------------------- | | Painel / chat leve | `1024` (padrão da imagem) | ≥2 g | | Um agente de programação | `8192` | ≥10 g | | Duas `/v1/responses` longas simultâneas | `10240`–`12288` | ≥12–16 g | ```bash docker run -d --name omniroute --restart unless-stopped --stop-timeout 40 \ -e OMNIROUTE_MEMORY_MB=8192 --memory=10g \ -p 127.0.0.1:20128:20128 -v omniroute-data:/app/data diegosouzapw/omniroute:latest ``` Tabela completa: [Guia do Docker — RAM em tempo de execução](docs/guides/DOCKER_GUIDE.md#runtime-ram-for-coding-agents). > **Canal de pré-lançamento do Docker:** `diegosouzapw/omniroute:next` e > `diegosouzapw/omniroute:next-web` acompanham a ramificação padrão atual `release/v*`. > Essas tags mutáveis destinam-se apenas a testar correções ainda não lançadas e > **não são compatíveis com ambientes de produção**. Consulte > [Canais de lançamento do Docker](docs/guides/DOCKER_GUIDE.md#release-channels). **🥟 Bun** O `bun install` padrão e a instalação global (`bun install -g omniroute`) são compatíveis por meio da detecção do runtime Bun: - **`bun:sqlite` integrado**: o OmniRoute usa o driver `bun:sqlite` integrado do Bun quando executado no Bun, recorrendo ao `better-sqlite3` no Node.js ou ao `sql.js`. - **Seleção automática do empacotador Webpack em desenvolvimento**: o desenvolvimento (`bun run dev`) detecta automaticamente o Bun e desativa o Turbopack em favor do Webpack para evitar incompatibilidades com bindings nativos do V8. As builds de produção (`bun run build`) seguem `OMNIROUTE_USE_TURBOPACK` exatamente como no Node: Turbopack por padrão, `OMNIROUTE_USE_TURBOPACK=0` para compilar com Webpack (`Dockerfile.bun` o disponibiliza como um `--build-arg`). - **Dockerfile dedicado ao Bun**: `Dockerfile.bun` multiestágio para implantações nativas de produção com Bun (`docker build -f Dockerfile.bun -t omniroute:bun .`). ```bash # Instale e execute com Bun bun install bun run dev ``` **🛠️ A partir do código-fonte** ```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 # Usando flakes do Nix nix develop npm run dev # Ou usando devbox devbox run npm run dev ``` 📖 [Guia do Docker](docs/guides/DOCKER_GUIDE.md) — perfis do Compose, HTTPS com Caddy e túneis do Cloudflare. **🦭 Podman** ```bash # 1. Prepare o diretório de dados montado por bind mkdir -p data # 2. Somente Linux + Podman rootless local (nunca um cliente remoto do Podman Machine): podman unshare chown 1000:1000 ./data # 3. Defina a indicação de runtime, compile a imagem local do Compose e inicie echo "CONTAINER_HOST=podman" >> .env podman compose --profile base up -d --build ``` No macOS ou Windows, o Podman usa um Podman Machine remoto: ignore `podman unshare` e siga as [orientações de diretório de dados específicas para cada topologia](contrib/podman/README.md#data-directory-permissions-by-topology). 📖 [Guia do Podman](contrib/podman/README.md) — builds do Compose, Podman Machine e configuração do Quadlet com Linux/systemd. **⚡ Instalação mais rápida / enxuta (ignore a build nativa)** O mecanismo SQLite nativo (`better-sqlite3`) é uma dependência **opcional**, portanto uma instalação global nunca fica bloqueada compilando a partir do código-fonte: ela usa um binário pré-compilado quando há um compatível com sua plataforma/Node e, caso contrário, recorre de forma transparente a um mecanismo JavaScript puro (`node:sqlite` no Node 22+, ou então o WASM `sql.js` incluído) — nenhuma ferramenta de build é necessária. Para ignorar completamente a preparação nativa pós-instalação (CI, ambientes sem interface gráfica ou máquinas lentas): ```bash OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute # CI=1 também a ignora ``` Para instalações mais rápidas, prefira o **pnpm** (armazenamento endereçado por conteúdo + links físicos — veja acima). Para um runtime sem painel e sem interface gráfica, use o perfil `base` do Docker (acima) ou o [guia do Termux](docs/guides/TERMUX_GUIDE.md). A CLI e o painel web são servidos pelo mesmo processo em uma única porta, portanto atualmente não há um pacote separado somente para CLI.

# 🎬 OmniRoute em ação

## 📹 Guias em vídeo

_{Captura do painel em 2026-08-24 · Catálogo bruto: YT 809 | TT 137 | IG 124 · Frescor (dias): YT 1 | TT 21 | IG 22}

🎬 #1 — Instagram
_{nick_saraev — 3,042,474 visualizações}

🎬 #2 — Instagram
_{theopenstack — 692,419 visualizações}

🎬 #3 — TikTok
_{milesreevesai — 620,400 visualizações}

🎬 #4 — YouTube
_{Vaibhav Sisinty — 391,109 visualizações}

🎬 #5 — Instagram
_{buildwithai.club — 347,652 visualizações}

**Ranking completo (URLs canônicas deduplicadas, `v > 0`, maior alcance):** | #1 | #2 | #3 | #4 | #5 | | -------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | | [nick_saraev — Instagram](https://www.instagram.com/reel/Da8ZthUPK98/) — **3,042,474** | [theopenstack — Instagram](https://www.instagram.com/reel/DaSs65mMrHk/) — **692,419** | [milesreevesai — TikTok](https://www.tiktok.com/@milesreevesai/video/7667980059189366019) — **620,400** | [Vaibhav Sisinty — YouTube](https://www.youtube.com/watch?v=QucgvbO5gsM) — **391,109** | [buildwithai.club — Instagram](https://www.instagram.com/reel/DbIt9AjK7-U/) — **347,652** | | #6 | #7 | #8 | #9 | #10 | | ----------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | | [nivedan.ai — Instagram](https://www.instagram.com/reel/DbIrCksJiqq/) — **331,973** | [vaibhavsisinty — Instagram](https://www.instagram.com/reel/Dae05TSAK1l/) — **263,744** | [Nick Automates — Shorts do YouTube](https://www.youtube.com/shorts/fZIBK_4fKq8) — **218,174** | [theroshankrishna — Instagram](https://www.instagram.com/reel/Dapjs58z0P0/) — **186,786** | [midudev — TikTok](https://www.tiktok.com/@midudev/video/7664636453544152342) — **177,800** | Métricas canônicas em 2026-08-24: **1.029 vídeos únicos** · **11.132.922 visualizações conhecidas** (`v > 0`) · **639 canais/perfis por rede**. O painel bruto contém 1.070 linhas; 41 duplicatas do Instagram foram normalizadas pela URL canônica, mantendo a maior contagem por vídeo. > 🎬 **Fez um vídeo sobre o OmniRoute?** Abra uma [issue](https://github.com/diegosouzapw/OmniRoute/issues/new) ou uma [discussão](https://github.com/diegosouzapw/OmniRoute/discussions) com o link — nós o destacaremos aqui.

# 📧 Comunidade e ajuda > Tudo em um só lugar — siga o mantenedor, converse com a comunidade ou abra uma issue. | Canal | Onde / como | | ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- | | 💼 **LinkedIn** — siga o mantenedor | [linkedin.com/in/diegosouzapw](https://www.linkedin.com/in/diegosouzapw/) | | 🐙 **GitHub** — siga para lançamentos e dicas | [@diegosouzapw](https://github.com/diegosouzapw) | | 💬 **Discord** | [discord.gg/U47eFqAXCn](https://discord.gg/U47eFqAXCn) | | ✈️ **Telegram** | [t.me/omnirouteOficial](https://t.me/omnirouteOficial) | | 🟢 **WhatsApp — 🌍 Global** | [entre no grupo](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) | | 🟢 **WhatsApp — 🇧🇷 Brasil** | [entrar no grupo](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) | | 🌍 **Site** | [omniroute.online](https://omniroute.online) | | 🌍 **🌍Comunidade StHub OmniRoute (gratuita)** | [portal StHub](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK) | | 📦 **Código-fonte** | [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute) | | 🐛 **Relatar um bug** | [abra uma issue](https://github.com/diegosouzapw/OmniRoute/issues) — anexe a saída de `npm run system-info` | | 🤝 **Contribuir** | [CONTRIBUTING.md](CONTRIBUTING.md) · [Modelo de branches e lançamentos](docs/ops/BRANCHING_MODEL.md) · escolha uma `good first issue` | | 💚 **Apoiar o projeto** | [Formas de apoiar ↑](#-support-omniroute) · [GitHub Sponsors](https://github.com/sponsors/diegosouzapw) |

---

## 🛠️ Pilha de Tecnologia

Camada	Tecnologia
Runtime	Node.js 22.x / 24.x LTS — `>=22.22.2 <23 \|\| >=24.0.0 <27`
Linguagem	TypeScript 6.0 — 100% TypeScript em `src/` e `open-sse/` (zero `any` no core desde a v2.0)
Framework	Next.js 16 + React 19 + Tailwind CSS 4
Banco de Dados	better-sqlite3 (SQLite, WAL journaling) + LowDB (JSON legado) — 122 módulos de domínio, 183 migrações
Memória	SQLite FTS5 full-text + embeddings de vetor int8-quantizados, decaimento tipado
Esquemas	Zod 4 — Validação de I/O da ferramenta MCP + contratos de API
Protocolos	MCP (stdio / HTTP / SSE) + A2A v0.3 (JSON-RPC 2.0 + SSE)
Streaming	Server-Sent Events (SSE) + ponte WebSocket (`/v1/ws`)
Compressão	Pipeline de 12 motores — RTK, Caveman, LLMLingua-2 (MobileBERT ONNX), GCF, OmniGlyph
Autenticação e segurança	OAuth 2.0 (PKCE) + JWT + Chaves de API + autenticação com escopo MCP · AES-256-GCM em repouso · DOMPurify
Furtividade	wreq-js — Impersonificação de fingerprint TLS JA3 / JA4, proxy de 3 níveis
Resiliência	Disjuntor, backoff exponencial, anti-thundering-herd, autocombinação de autocorreção
Registro (Logging)	pino — logs JSON estruturados com contexto de requisição
Testes	Node.js test runner + Vitest — Mais de 39.000 declarações de teste estáticas em mais de 5.100 arquivos de teste rastreados (unidade, integração, E2E, segurança, ecossistema)
Plataformas	Desktop (Electron) · Android (Termux) · PWA (qualquer navegador)
CI/CD	GitHub Actions — publicação automática no npm + Docker Hub no lançamento
Links	Site · npm · Docker Hub

## 📖 Documentação

### 📘 Primeiros Passos

Documento	Descrição
Guia do Usuário	Provedores, combos, integração com CLI, implantação
Guia de Configuração	Métodos completos de instalação, configurações de ferramentas CLI, configuração de protocolos, ajuste de tempos limite
Guia de Ferramentas CLI	Configuração específica para Claude Code, Codex, Cursor, Cline, OpenClaw, Kilo e Copilot
Modo Remoto	Controle um OmniRoute remoto (VPS) pelo CLI do seu laptop por meio de tokens de acesso com escopo definido
Configuração do Claude Code	Conecte o Claude Code ao OmniRoute (local/remoto) com `launch` + perfis por modelo
Início Rápido	Instalação em 3 etapas → conexão → configuração

### 🔧 Operações e Implantação

Documento	Descrição
Guia do Docker	Docker run, perfis do Compose, HTTPS com Caddy, túneis, tags de imagem
Guia do Podman	Integração do Quadlet com systemd, podman-compose, SELinux
Implantação em VM	Guia completo: configuração de VM + nginx + Cloudflare
Implantação no Fly.io	Implante no Fly.io com armazenamento persistente
Guia do Termux	Execute o OmniRoute no Android por meio do Termux
Guia de PWA	Instalação, cache e arquitetura do Progressive Web App
Guia de Desinstalação	Remoção completa para todos os métodos de instalação
Configuração do Ambiente	Variáveis e referências completas do `.env`

### 🧠 Recursos e Arquitetura

Documento	Descrição
Arquitetura	Arquitetura do sistema, fluxo de dados e detalhes internos
Guia de Compressão	Pipeline com 7 opções: desativado / leve / padrão / agressivo / ultra / RTK / empilhado
Compressão RTK	Compressão da saída de comandos, filtros, confiança, verificação, recuperação da saída bruta
Mecanismos de Compressão	Caveman, RTK, pipelines empilhados, interfaces de dashboard/API/MCP
Formato das Regras de Compressão	Esquemas JSON de pacotes de regras para filtros Caveman e RTK
Pacotes de Idiomas para Compressão	Detecção de idioma e criação de pacotes de regras do Caveman
Guia de Resiliência	Disjuntores, períodos de espera, fila, prevenção de efeito manada, falsificação de TLS
Mecanismo Auto-Combo	Pontuação com 16 fatores, pacotes de modos, autorrecuperação
Guia de Proxy	Sistema de proxy em 3 níveis, marketplace 1proxy, CRUD do registro
Camadas Gratuitas	Diretório consolidado: 35 pools recorrentes documentados / 489 entradas de camada gratuita catalogadas
Galeria de Recursos	Tour visual pelo dashboard com capturas de tela
Documentação da Base de Código	Visão geral da base de código voltada para iniciantes

### 🤖 Protocolos e APIs

Documento	Descrição
Referência da API	Todos os endpoints com exemplos
Especificação OpenAPI	Especificação OpenAPI 3.0
Servidor MCP	110 ferramentas MCP, configurações de IDE, clientes Python/TS/Go
Guia do Servidor MCP	Instalação do MCP, transportes e referência de ferramentas
Servidor A2A	Protocolo JSON-RPC 2.0, habilidades, streaming, gerenciamento de tarefas
Guia do Servidor A2A	Cartão de agente A2A, tarefas, habilidades e streaming

### 📋 Projeto e Qualidade

Documento	Descrição
Como contribuir	Configuração e diretrizes de desenvolvimento
Modelo de branches e lançamentos	Para onde os PRs são direcionados (`release/*`) e o que `main` e as tags significam
Registro de alterações	Histórico completo de lançamentos por versão
Política de segurança	Relato de vulnerabilidades e práticas de segurança
Guia de i18n	Suporte a 42 idiomas, fluxo de trabalho de tradução e RTL
Checklist de lançamento	Etapas de validação pré-lançamento
Plano de cobertura	Estratégia de cobertura de testes para mais de 39.000 declarações estáticas de testes em mais de 5.100 arquivos de teste rastreados

# ⭐ Principais colaboradores > O OmniRoute é moldado por uma comunidade apaixonada por código aberto. Essas pessoas fizeram contribuições excepcionais que afetam diretamente a qualidade, a estabilidade e o alcance do projeto. **Obrigado.** ### Colaboradores externos por pull requests mesclados

Posição	Colaborador	PRs mesclados	~Linhas alteradas
1	backryun	190	227,977
2	oyi77	180	407,678
3	rdself	145	80,663
4	JxnLexn	128	387,049
5	KooshaPari	101	125,747
6	herjarsa	88	230,872
7	RaviTharuma	79	55,106
8	maxmad64bis	69	394,715
9	artickc	59	33,260
10	HouMinXi	51	47,334
10	chirag127	51	5,153
12	xz-dev	50	245,976
13	hartmark	47	52,185
14	rqzbeh	39	143,181
15	dhaern	34	19,559
16	Dingding-leo	33	1,986
17	NomenAK	32	13,854
18	MumuTW	30	16,953
19	benzntech	29	11,641
20	pacocartones	24	9,331
20	Prudhvivuda	24	6,312

_{Dados congelados na ponta ativa de release/v3.8.50, no commit dafb4ae808, com merges até 2026-08-24 05:26:03 UTC. O censo paginado do GitHub GraphQL contém 5.911 PRs mesclados: 2.707 pelo proprietário do repositório, 179 pelo Dependabot e 3.025 PRs externos de 535 colaboradores distintos. “Linhas alteradas” corresponde às adições + exclusões do GitHub e inclui arquivos gerados, lockfiles, catálogos, traduções e documentação; representa a rotatividade do código, não as LOC de autoria. Empates no limite de corte são mantidos.} ### Commits atribuídos pelo GitHub

backryun _{🥇 220 commits atribuídos pelo GitHub}	Paijo _{🥈 219 commits atribuídos pelo GitHub}	Randi _{🥉 108 commits atribuídos pelo GitHub}	Ravi Tharuma _{🏅 81 commits atribuídos pelo GitHub}	Chris _{🏅 70 commits atribuídos pelo GitHub}	Markus Hartung _{🏅 69 commits atribuídos pelo GitHub · empate em 6º lugar}
Dizzle _{🏅 69 commits atribuídos pelo GitHub · empate em 6º lugar}	Jan Leon _{🏅 64 commits atribuídos pelo GitHub}	zenobit _{🏅 62 commits atribuídos pelo GitHub}	Bob.Hou _{🏅 51 commits atribuídos pelo GitHub · empate em 10º lugar}	Xiangzhe _{🏅 51 commits atribuídos pelo GitHub · empate em 10º lugar}

_{Verificado novamente em 2026-08-24 06:14:31 UTC: commits atribuídos pelo GitHub, conforme informados pela API de Colaboradores do repositório para a branch padrão release/v3.8.50. A API retornou 525 identidades (415 usuários, 2 bots e 108 anônimas); esta tabela exclui o mantenedor, os bots e as identidades anônimas e preserva os empates na classificação. Ela é distinta tanto da classificação de PRs mesclados acima quanto do censo de 639 pessoas baseado nos metadados do Git abaixo.} > 🙏 Os recursos, as correções de bugs e as melhorias de infraestrutura feitos por esses colaboradores são uma **parte essencial** do que torna o OmniRoute confiável e rico em recursos. Cada pull request, cada caso de teste e cada arquivo de tradução i18n importa. O código aberto é construído por pessoas como eles.

---
## 💖 Patrocinadores

Um agradecimento especial às pessoas que financiam o OmniRoute do próprio bolso — cada contribuição mantém o projeto gratuito, independente e em constante evolução.

Andrew
_{💛 Patrocinador mensal ativo}

Vlad I
_{💛 Patrocinador mensal ativo}

Paco Cartones
_{💛 Patrocinador ativo com contribuição única}

Prof. Igor Morais
_{💛 Apoiador anterior com contribuição única}

longtao
_{💛 Apoiador anterior com contribuição única}

_{… e outras pessoas que preferem permanecer anônimas 💛} _{Patrocinadores públicos do GitHub revalidados em 2026-08-24. O status activeOnly do GitHub determina os rótulos de atividade acima; apoiadores públicos com contribuições únicas divulgados anteriormente continuam sendo reconhecidos, e patrocinadores privados permanecem anônimos.} 💖 Torne-se um patrocinador → — cada dólar mantém o OmniRoute gratuito e independente.

## 👥 Mais de 600 colaboradores

[![Colaboradores](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=639&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors) _{Auditado em 2026-08-24 na base congelada ac02c5b42f e verificado novamente na ponta ativa de release/v3.8.50, dafb4ae808: 639 identidades humanas normalizadas do Git — 407 aparecem como autores de commits (incluindo o mantenedor) e 232 aparecem apenas em trailers explícitos de Co-authored-by. O levantamento normaliza identificadores noreply do GitHub, exclui 26 identidades de bots/agentes/serviços/placeholders e não mescla endereços de e-mail comuns apenas porque seus nomes de exibição coincidem.} ### Como contribuir 1. Faça um fork do repositório 2. Crie a branch a partir da ponta **ativa** de `release/vX.Y.Z` (não de `main`) — consulte [Modelo de branches e releases](docs/ops/BRANCHING_MODEL.md) 3. Crie sua branch de funcionalidade (`git checkout -b feat/amazing-feature`) 4. Faça o commit das suas alterações (`git commit -m 'feat: add amazing feature'`) 5. Envie para a branch (`git push origin feat/amazing-feature`) 6. Abra um Pull Request com a **base = essa branch `release/vX.Y.Z`** Consulte [CONTRIBUTING.md](CONTRIBUTING.md) para obter diretrizes detalhadas. ### Publicando uma nova versão ```bash # Crie uma release — npm publish acontece automaticamente VERSION=x.y.z gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes ```

## 📊 Estrelas

## 🌍 StarMapper

## 🙏 Agradecimentos

O OmniRoute apoia-se sobre os ombros de gigantes. Ele começou como um fork do **[9router](https://github.com/decolua/9router)** e uma versão em TypeScript do projeto em Go **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** — e, a partir daí, cada subsistema abaixo foi inspirado por um projeto de código aberto que chegou lá primeiro. Cada um deles ajudou a moldar uma parte concreta do OmniRoute. Este é o nosso agradecimento a todos eles. 🙏 > ⭐ contagens de estrelas verificadas pela API REST do GitHub em 24 de agosto de 2026 — dê uma estrela a esses projetos. As contagens são um retrato exato daquela data e mudarão naturalmente. ### 🧬 Linhagem e gateway

Projeto	⭐	Como inspirou o OmniRoute
9router	26,161	O projeto original no qual este fork se baseia — ampliado aqui com APIs multimodais e uma reescrita completa em TypeScript.
CLIProxyAPI	48,497	A implementação em Go que inspirou esta versão portada para JavaScript / TypeScript.
LiteLLM	57,100	O gateway de IA cujo conjunto público de dados de preços alimenta nossa sincronização de rastreamento de custos e cujo modelo de normalização de provedores serviu de base para nosso roteamento.
codex-chatgpt-web	1,410	Código-fonte MIT adaptado para a ponte ChatGPT Web → Codex Responses incorporada, incluindo adaptadores de sessão do navegador, enquadramento de respostas, uso e pesquisa na web.
free-claude-code	48,112	Padrões portados para recuperação de streaming, aliases sem raciocínio, pesquisa na web de contingência, limites de janela deslizante, ocultação de dados em logs e fluxos de inicialização reforçados.
composer-api	322	Padrões de escolha de ferramentas, restrição de saída e confirmação de ferramentas do Cursor Composer adaptados para o executor nativo do Cursor.
codex-multi-auth	457	Padrões de novo login e rotação de tokens de atualização portados para a reautenticação OAuth do Codex.
opencode-anthropic-auth	510	Valores padrão de transformação compatíveis com o Claude Code e comportamento de cabeçalhos de cobrança generalizados na ponte orientada por configuração do OmniRoute.
grok2api-merged	2	Seus mapeamentos de modelos Grok, gerador Statsig de TypeError simulado, valores padrão de solicitação e dispositivo e processador de respostas NDJSON foram substancialmente adaptados para o executor Grok Web do OmniRoute.
TQZHR/grok2api	705	A principal fonte transitiva de código por trás do grok2api-merged; suas implementações de modelo, cabeçalho, payload, Statsig e processador são preservadas na linhagem do Grok Web.
chenyme/grok2api	7,520	O código-fonte MIT subjacente para os valores padrão de payload e dispositivo do Grok, o gerador Statsig e o processador `result.response`, incorporado por meio do TQZHR e do grok2api-merged.
grok2api-pro	27	Uma fonte transitiva creditada pelo grok2api-merged por sua camada de pool de proxies; o OmniRoute preserva esse aviso de linhagem, mas não alega ter portado um pool de proxies em seu executor Grok Web de escopo limitado.
GrokProxy	50	Seu proxy do Grok autenticado por cookies e o padrão de streaming `result.response.token` serviram de base para o transporte Grok Web do OmniRoute.
GrokBridge	5	A implementação original do Grok Web consultou seu design upstream de HTTP/navegador; seu caminho HTTP direto deriva do GrokProxy, portanto não se alega uma portabilidade de código independente.
grok-web-api	14	Seus esquemas Rust `ChatOptions` e de envelope de resposta serviram de base para os tipos TypeScript de solicitação e resposta de streaming do Grok no OmniRoute.

### 🗜️ Compressão de contexto e tokens — mecanismos

Projeto	⭐	Como inspirou o OmniRoute
Caveman	100,538	O projeto viral do tipo "por que usar muitos token se poucos token resolvem" — sua filosofia de fala das cavernas impulsiona nosso modo de compressão padrão e mais de 30 regras de remoção de palavras supérfluas/condensação.
RTK – Rust Token Killer	77,185	Compressão de alto desempenho da saída de comandos — inspirou nosso mecanismo RTK, a DSL de filtros JSON, a recuperação da saída bruta e o pipeline encadeado RTK → Caveman.
headroom	67,310	Compressão reversível de contexto (SmartCrusher) — inspirou nosso mecanismo `headroom` e o padrão de marcadores de recuperação `ccr`.
LLMLingua	6,598	Pesquisa sobre compressão de prompts (LLMLingua / LLMLingua-2) — inspirou nosso mecanismo `llmlingua` assíncrono, seguro para código e com tolerância a falhas.
llmlingua-2-js	31	O porte para JS/ONNX (MobileBERT / XLM-RoBERTa) usado como backend em thread de trabalho para nosso mecanismo LLMLingua.
Troglodita	40	Compressão de tokens em PT-BR — impulsiona nosso pacote de idioma pt-BR: redução de pleonasmos e remoção de palavras supérfluas ajustadas à gramática do português brasileiro.
ponytail	108,957	A habilidade viral de programação YAGNI do "dev sênior preguiçoso" — inspirou nosso Estilo de Saída less-code: direcionamento para a menor alteração funcional que reduz o código _gerado_ (o equivalente de Caveman no eixo de saída para uma prosa concisa).
i-have-adhd	23,526	Seu estilo de resposta orientado à ação e adequado a pessoas com TDAH foi adaptado para o estilo de saída conciso do OmniRoute em cinco idiomas.

### 🧩 Formatos compactos, pesquisa sobre tokens e ferramentas com reconhecimento de código

Projeto	⭐	Como inspirou o OmniRoute
TOON	25,233	Notação de Objetos Orientada a Tokens — seu modelo colunar de cabeçalho e linhas moldou nossa etapa de compactação tabular.
GCF – Graph Compact Format	41	Seu formato compacto de grafos e design de perfil genérico fundamentaram a compactação tabular do OmniRoute e o formato de codec do Headroom.
gcf-typescript	4	A implementação MIT em TypeScript incorporada diretamente e ampliada como codec de perfil genérico do Headroom.
token-optimizer-mcp	494	Cache Brotli/SQLite + delta de contexto por sessão — inspirou nosso mecanismo `session-dedup`.
token-savior	1,122	Compactação da saída do Bash + perfis MCP — inspirou nossa disciplina de interrupção da compressão e a redução de manifestos de ferramentas MCP.
token-saver	138	Compressão de saída sensível ao conteúdo e por tipo de arquivo, com interrupção em caso de falha — validou nosso despacho por tipo e a omissão quando o ganho é mínimo.
token-optimizer	1,951	"Encontre os tokens fantasmas" — seu padrão de descarregamento + identificador recuperável fundamentou nossa abordagem de descarregamento CCR.
TokenMizer	28	Um modelo de grafo de sessão + desduplicação de linhas entre turnos que fundamentou nosso design de desduplicação por sessão.
OmniCompress	3	JSON colunar em Rust + recuperação endereçada por conteúdo + desduplicação entre mensagens — validou o design dos nossos mecanismos `headroom`/`ccr`/`session-dedup` e a invariante estável para cache de que a "forma comprimida independe da posição".
mcp-compressor	113	Compressão de esquemas/descrições de ferramentas MCP — fundamentou nossa redução da cardinalidade de manifestos de ferramentas MCP.
RepoMapper	197	Classificação de mapas de repositórios no estilo Aider — fundamentou nossa exploração de mapas de repositórios / classificação de recuperação.
quiet-shell-mcp	4	Redução declarativa da saída do shell via MCP — validou nossa compactação declarativa da saída do bash.
ts-morph	6,162	Kit de ferramentas da API do Compilador TypeScript — inspirou nossa remoção de comentários baseada em parser, que preserva literais de string, template e expressões regulares.

### 🧠 Memória e RAG

Projeto	⭐	Como inspirou o OmniRoute
Mem0	63,902	Camada universal de memória — seu modelo de proxy como limite de gravação/leitura moldou nossa arquitetura de memória.
Letta (MemGPT)	24,382	Agentes com estado e memória em camadas — inspiraram nosso modelo em camadas de Controle e Recuperação de Contexto (CCR).
WFGY	1,781	A taxonomia ProblemMap de 16 modos de falha recorrentes em RAG/LLM — o vocabulário comum usado em nosso guia de solução de problemas.

### 🛰️ Inspeção de tráfego, MITM e proxy transparente

Projeto	⭐	Como inspirou o OmniRoute
llm-interceptor	66	A interceptação/análise MITM do tráfego entre assistentes de programação ↔ LLM orientou os requisitos iniciais do Inspetor de Tráfego. Quatro módulos derivados anteriormente — mesclagem de SSE, normalização de conversas, mascaramento de segredos e sanitização de cabeçalhos — foram substituídos por implementações independentes de sala limpa, baseadas em padrões públicos de protocolo. As duas superfícies de passagem direta para o host (`passthrough.ts` e `_internal/bypass.cjs`) continuam sendo implementações internas do OmniRoute classificadas de forma independente; elas não foram reescritas como parte dessa substituição.
ProxyBridge	5,995	Roteamento transparente de proxy por processo — inspirou nosso encerramento de MITM seguro contra falhas, tempos limite de inatividade de soquetes, atribuição de processos via `/proc` e captura TPROXY.

### 📚 Dados de modelos, observabilidade e interface

Projeto	⭐	Como inspirou o OmniRoute
models.dev	6,555	Banco de dados aberto de especificações, preços e recursos de modelos de IA — sincronizado nativamente com nosso catálogo de modelos.
React Flow / xyflow	38,108	A biblioteca de grafos baseada em nós que viabiliza nosso Estúdio de Compressão e nosso Estúdio de Combinação/Roteamento em tempo real.
LangGraph	40,314	A visualização ao vivo do grafo de fluxo de trabalho do LangGraph Studio inspirou a visualização em cascata e em tempo real dos nossos Estúdios.
Langfuse	33,592	Seu modelo de observabilidade de rastreamento → intervalo → geração moldou a visualização em cascata do nosso Estúdio de Compressão.
Kiali	3,631	Observabilidade da malha de serviços do Istio — inspirou nossos indicadores de disjuntor e elementos visuais de arestas com erro no Estúdio de Roteamento/Combinação.
lobe-icons	2,428	Logotipos de marcas de IA/LLM usados para renderizar os ícones dos provedores em todo o nosso painel.
flag-icons	12,354	Fornece as bandeiras SVG licenciadas sob a licença MIT usadas pelo seletor de idioma do README.

### 🛡️ Segurança

Projeto	⭐	Como inspirou o OmniRoute
awesome-secure-defaults	721	Uma lista selecionada de bibliotecas seguras por padrão que orienta nossas escolhas de segurança (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).

### 🧭 Ferramentas complementares

Projeto	⭐	Como inspirou o OmniRoute
ClawRouter	6,564	Inspirou a desduplicação de solicitações, o fallback emergencial de custo zero, as estratégias conectáveis de Auto-Combo e a classificação multilíngue de intenções.
Antigravity-Manager	30,652	Seu remapeamento de modelos com reconhecimento de conta, a validação do caminho do executável e o comportamento dos rótulos de plano serviram de referência para o runtime Antigravity do OmniRoute.
vscode-antigravity-cockpit	4,817	Seu formato compacto de contagem regressiva para redefinição de cota inspirou a exibição correspondente do limite do provedor no OmniRoute.
AionUi	32,230	Suas integrações ACP inspiraram a detecção automática, pelo OmniRoute, dos agentes de CLI instalados.
CodexBar	20,507	Identificou a superfície de cota do Grok Build; em seguida, o OmniRoute verificou e corrigiu de forma independente o formato real dos dados transmitidos.

## 📄 Licença Licença MIT — consulte [LICENSE](LICENSE) para mais detalhes. ---

**[⬆ Voltar ao topo](#-omniroute)** · Feito com ❤️ para a comunidade de IA de código aberto. _{OmniRoute v3.8.51 · Node ≥22.22.2 · Licença MIT · omniroute.online}