🌐 Languages: 🇺🇸 English · 🇪🇸 es · 🇫🇷 fr · 🇩🇪 de · 🇮🇹 it · 🇷🇺 ru · 🇨🇳 zh-CN · 🇯🇵 ja · 🇰🇷 ko · 🇸🇦 ar · 🇮🇳 hi · 🇮🇳 in · 🇹🇭 th · 🇻🇳 vi · 🇮🇩 id · 🇲🇾 ms · 🇳🇱 nl · 🇵🇱 pl · 🇸🇪 sv · 🇳🇴 no · 🇩🇰 da · 🇫🇮 fi · 🇵🇹 pt · 🇷🇴 ro · 🇭🇺 hu · 🇧🇬 bg · 🇸🇰 sk · 🇺🇦 uk-UA · 🇮🇱 he · 🇵🇭 phi · 🇧🇷 pt-BR · 🇨🇿 cs · 🇹🇷 tr

Never stop coding. Smart routing to FREE & low-cost AI models with automatic fallback.

Seu proxy de API universal — um endpoint, mais de 60 provedores, zero tempo de inatividade. Agora comServidor MCP (25 ferramentas),Protocolo A2A,Sistemas de memória/habilidadeseAplicativo Electron Desktop.

Conclusões de bate-papo • Incorporações • Geração de imagens • Vídeo • Música • Áudio • Reclassificação •Pesquisa na Web• Servidor MCP • Protocolo A2A • 100% TypeScript---

🌐 Site • [🚀 Início rápido](#-início rápido) • 💡 Recursos • 📖 Documentos • 💰 Preços • 💬 WhatsApp

🖼️ Main Dashboard

📸 Dashboard Preview

Clique para ver capturas de tela do painel

Página	Captura de tela
Fornecedores
Combos
Análise
Saúde
Tradutor
Configurações
Ferramentas CLI
Registros de uso
Pontos finais

🤖 Free AI Provider for your favorite coding agents

Conecte qualquer ferramenta IDE ou CLI com tecnologia de IA por meio do OmniRoute - gateway de API gratuito para codificação ilimitada.

OpenClaw
_{⭐ 205 mil}

NanoBot
_{⭐ 20,9K}

Pico Garra
_{⭐ 14,6K}

ZeroClaw
_{⭐ 9,9K}

Garra de Ferro
_{⭐ 2,1K}

OpenCode
_{⭐ 106K}

CLI do Codex
_{⭐ 60,8K}

Código Claude
_{⭐ 67,3K}

CLI Gemini
_{⭐ 94,7K}

Código do quilo
_{⭐ 15,5 mil}

_{📡 Todos os agentes se conectam via http://localhost:20128/v1 ou http://cloud.omniroute.online/v1 — uma configuração, modelos e cota ilimitados}---

🤔 Why OmniRoute?

Pare de desperdiçar dinheiro e atingir limites:

A cota de assinatura expira sem ser utilizada todos os meses
Os limites de taxa impedem você de codificar no meio
APIs caras (US$ 20-50/mês por provedor)
Troca manual entre provedores

OmniRoute resolve isso:

✅Maximize as assinaturas- Rastreie a cota, use cada bit antes de redefinir
✅Fullback automático- Assinatura → Chave de API → Barato → Gratuito, tempo de inatividade zero
✅Múltiplas contas- Round-robin entre contas por provedor
✅Universal- Funciona com Claude Code, Codex, Gemini CLI, Cursor, Cline, OpenClaw, qualquer ferramenta CLI---

📧 Support

💬Junte-se à nossa comunidade!Grupo WhatsApp — Obtenha ajuda, compartilhe dicas e fique atualizado.

-Site: omniroute.online -GitHub: github.com/diegosouzapw/OmniRoute -Problemas: github.com/diegosouzapw/OmniRoute/issues -WhatsApp: Grupo comunitário -Contribuindo: Consulte CONTRIBUTING.md, abra um PR ou escolha uma boa primeira edição -Projeto Original: 9router by decolua### 🐛 Reporting a Bug?

Ao abrir um problema, execute o comando system-info e anexe o arquivo gerado:```bash npm run system-info


Isso gera um `system-info.txt` com sua versão do Node.js, versão do OmniRoute, detalhes do sistema operacional, ferramentas CLI instaladas (qoder, gemini, claude, codex, antigravity, droid, etc.), status do Docker/PM2 e pacotes do sistema - tudo o que precisamos para reproduzir seu problema rapidamente. Anexe o arquivo diretamente ao seu problema do GitHub.---

## 🔄 How It Works

┌─────────────┐ │ Your CLI │ (Claude Code, Codex, Gemini CLI, OpenClaw, Cursor, Cline...) │ Tool │ └──────┬──────┘ │ http://localhost:20128/v1 ↓ ┌─────────────────────────────────────────┐ │ OmniRoute (Smart Router) │ │ • Format translation (OpenAI ↔ Claude) │ │ • Quota tracking + Embeddings + Images │ │ • Auto token refresh │ └──────┬──────────────────────────────────┘ │ ├─→ [Tier 1: SUBSCRIPTION] Claude Code, Codex, Gemini CLI │ ↓ quota exhausted ├─→ [Tier 2: API KEY] DeepSeek, Groq, xAI, Mistral, NVIDIA NIM, etc. │ ↓ budget limit ├─→ [Tier 3: CHEAP] GLM ($0.6/1M), MiniMax ($0.2/1M) │ ↓ budget limit └─→ [Tier 4: FREE] Qoder, Qwen, Kiro (unlimited)

Result: Never stop coding, minimal cost


---

## 🎯 What OmniRoute Solves — 30 Real Pain Points & Use Cases

>**Todo desenvolvedor que usa ferramentas de IA enfrenta esses problemas diariamente.**O OmniRoute foi criado para resolver todos eles, desde custos excessivos até bloqueios regionais, desde fluxos quebrados de OAuth até operações de protocolo e observabilidade empresarial.

<detalhes>
<summary><b>💸 1. "Eu pago por uma assinatura cara, mas ainda sou interrompido por limites"</b></summary>

Os desenvolvedores pagam US$ 20–200/mês pelo Claude Pro, Codex Pro ou GitHub Copilot. Mesmo pagando, a cota tem um limite máximo – 5h de uso, limites semanais ou limites de taxa por minuto. No meio da sessão de codificação, o provedor para de responder e o desenvolvedor perde fluxo e produtividade.

**Como o OmniRoute resolve isso:**

-**Smart 4-Tier Fallback**— Se a cota de assinatura acabar, redireciona automaticamente para API Key → Barato → Gratuito sem intervenção manual
-**Rastreamento de limites do provedor**— Instantâneos de cota armazenados em cache são atualizados em uma programação do lado do servidor (padrão `PROVIDER_LIMITS_SYNC_INTERVAL_MINUTES=70`) com atualização manual disponível na UI
-**Suporte para múltiplas contas**— Várias contas por provedor com round-robin automático — quando uma acabar, muda para a próxima
-**Combos personalizados**— Cadeias alternativas personalizáveis com 9 estratégias de balanceamento (prioridade, ponderada, preencher primeiro, round-robin, P2C, aleatória, menos usada, com custo otimizado, estritamente aleatória)
-**Codex Business Quotas**— Monitoramento de cotas de espaço de trabalho de negócios/equipe diretamente no painel</details>

<detalhes>
<summary><b>🔌 2. "Preciso usar vários provedores, mas cada um tem uma API diferente"</b></summary>

OpenAI usa um formato, Claude (Anthropic) usa outro, Gemini ainda outro. Se um desenvolvedor quiser testar modelos de diferentes provedores ou fazer fallback entre eles, ele precisará reconfigurar SDKs, alterar endpoints e lidar com formatos incompatíveis. Provedores personalizados (FriendLI, NIM) possuem endpoints de modelo não padrão.

**Como o OmniRoute resolve isso:**

-**Endpoint unificado**— Um único `http://localhost:20128/v1` serve como proxy para todos os mais de 60 provedores
-**Tradução de formato**— Automática e transparente: OpenAI ↔ Claude ↔ Gemini ↔ API de respostas
-**Response Sanitization**— Remove campos não padrão (`x_groq`, `usage_breakdown`, `service_tier`) que quebram o OpenAI SDK v1.83+
-**Normalização de funções**— Converte `desenvolvedor` → `sistema` para provedores não-OpenAI; `sistema` → `usuário` para GLM/ERNIE
-**Think Tag Extraction**— Extrai blocos `<think>` de modelos como DeepSeek R1 em `reasoning_content` padronizado
-**Saída estruturada para Gemini**— `json_schema` → conversão automática `responseMimeType`/`responseSchema`
-**`stream` tem como padrão `false`**— Alinha-se com a especificação OpenAI, evitando SSE inesperado em SDKs Python/Rust/Go</details>

<detalhes>
<summary><b>🌐 3. "Meu provedor de IA bloqueia minha região/país"</b></summary>

Provedores como OpenAI/Codex bloqueiam o acesso de determinadas regiões geográficas. Os usuários recebem erros como `unsupported_country_region_territory` durante conexões OAuth e API. Isto é especialmente frustrante para desenvolvedores de países em desenvolvimento.

**Como o OmniRoute resolve isso:**

-**Configuração de proxy de 3 níveis**— Proxy configurável em 3 níveis: global (todo o tráfego), por provedor (apenas um provedor) e por conexão/chave
-**Selos de proxy codificados por cores**— Indicadores visuais: 🟢 proxy global, 🟡 proxy do provedor, 🔵 proxy de conexão, sempre mostrando o IP
-**Troca de token OAuth por meio de proxy**— O fluxo OAuth também passa pelo proxy, resolvendo `unsupported_country_region_territory`
-**Testes de conexão via proxy**— Os testes de conexão usam o proxy configurado (não há mais bypass direto)
-**Suporte SOCKS5**— Suporte completo ao proxy SOCKS5 para roteamento de saída
-**TLS Fingerprint Spoofing**— Impressão digital TLS semelhante a um navegador via `wreq-js` para ignorar a detecção de bot
-**🔏 CLI Fingerprint Matching**— Reordena cabeçalhos e campos de corpo para corresponder às assinaturas binárias CLI nativas, reduzindo drasticamente o risco de sinalização de conta. O IP do proxy é preservado – você obtém mascaramento de IP furtivo**e**simultaneamente</details>

<detalhes>
<summary><b>🆓 4. "Quero usar IA para codificação, mas não tenho dinheiro"</b></summary>

Nem todos podem pagar US$ 20–200/mês por assinaturas de IA. Estudantes, desenvolvedores de países emergentes, amadores e freelancers precisam de acesso a modelos de qualidade a custo zero.

**Como o OmniRoute resolve isso:**

-**Provedores de nível gratuito integrados**— Suporte nativo para provedores 100% gratuitos: Qoder (5 modelos ilimitados via OAuth: kimi-k2-thinking, qwen3-coder-plus, deepseek-r1, minimax-m2, kimi-k2), Qwen (4 modelos ilimitados: qwen3-coder-plus, qwen3-coder-flash, qwen3-coder-next, vision-model), Kiro (Claude + AWS Builder ID gratuitamente), Gemini CLI (180 mil tokens/mês grátis)
-**Ollama Cloud**— Modelos Ollama hospedados na nuvem em `api.ollama.com` com nível gratuito de "uso leve"; use o prefixo `ollamacloud/<model>`
-**Combos somente gratuitos**— Cadeia `gc/gemini-3-flash → if/kimi-k2-thinking → qw/qwen3-coder-plus` = $0/mês com tempo de inatividade zero
-**NVIDIA NIM Free Access**— ~40 RPM de acesso gratuito para desenvolvedores para sempre a mais de 70 modelos em build.nvidia.com (transição de créditos para limites de taxa pura)
-**Estratégia de Custo Otimizado**— Estratégia de roteamento que escolhe automaticamente o provedor mais barato disponível</details>

<detalhes>
<summary><b>🔒 5. "Preciso proteger meu gateway de IA contra acesso não autorizado"</b></summary>

Ao expor um gateway de IA à rede (LAN, VPS, Docker), qualquer pessoa com o endereço pode consumir os tokens/cota do desenvolvedor. Sem proteção, as APIs ficam vulneráveis ao uso indevido, injeção imediata e abuso.

**Como o OmniRoute resolve isso:**

-**Gerenciamento de chaves de API**— Geração, rotação e escopo por provedor com uma página `/dashboard/api-manager` dedicada
-**Permissões em nível de modelo**— Restringir chaves de API a modelos específicos (`openai/*`, padrões curinga), com alternância Permitir tudo/Restringir
-**API Endpoint Protection**— Exige uma chave para `/v1/models` e bloqueia provedores específicos da listagem
-**Auth Guard + Proteção CSRF**— Todas as rotas do painel protegidas com middleware `withAuth` + tokens CSRF
-**Rate Limiter**— Limitação de taxa por IP com janelas configuráveis
-**Filtragem de IP**— Lista de permissões/lista de bloqueio para controle de acesso
-**Prompt Injection Guard**— Sanitização contra padrões de prompt maliciosos
-**Criptografia AES-256-GCM**— Credenciais criptografadas em repouso</details>

<detalhes>
<summary><b>🛑 6. "Meu provedor caiu e perdi meu fluxo de codificação"</b></summary>

Os provedores de IA podem ficar instáveis, retornar erros 5xx ou atingir limites de taxa temporários. Se um desenvolvedor depender de um único provedor, ele será interrompido. Sem disjuntores, tentativas repetidas podem travar o aplicativo.

**Como o OmniRoute resolve isso:**

-**Disjuntor por modelo**— Abertura/fechamento automático com limites configuráveis e resfriamento (Fechado/Aberto/Meio-aberto), com escopo definido por modelo para evitar bloqueios em cascata
-**Retirada exponencial**— Atrasos progressivos em novas tentativas
-**Rebanho Anti-Trovão**— Proteção Mutex + semáforo contra tempestades de novas tentativas simultâneas
-**Combo Fallback Chains**— Se o provedor primário falhar, ele cairá automaticamente na cadeia sem intervenção
-**Combo Circuit Breaker**— Desativa automaticamente provedores com falha em uma cadeia de combinação
-**Health Dashboard**— Monitoramento de tempo de atividade, estados de disjuntores, bloqueios, estatísticas de cache, latência p50/p95/p99</details>

<detalhes>
<summary><b>🔧 7. "Configurar cada ferramenta de IA é tedioso e repetitivo"</b></summary>

Os desenvolvedores usam Cursor, Claude Code, Codex CLI, OpenClaw, Gemini CLI, Kilo Code... Cada ferramenta precisa de uma configuração diferente (endpoint da API, chave, modelo). Reconfigurar ao trocar de provedor ou modelo é uma perda de tempo.

**Como o OmniRoute resolve isso:**

-**CLI Tools Dashboard**— Página dedicada com configuração de um clique para Claude Code, Codex CLI, OpenClaw, Kilo Code, Antigravity, Cline
-**GitHub Copilot Config Generator**— Gera `chatLanguageModels.json` para VS Code com seleção de modelo em massa
-**Assistente de integração**— Configuração guiada em 4 etapas para usuários iniciantes
-**Um endpoint, todos os modelos**— Configure `http://localhost:20128/v1` uma vez, acesse mais de 60 provedores</details>

<detalhes>
<summary><b>🔑 8. "Gerenciar tokens OAuth de vários provedores é um inferno"</b></summary>

Claude Code, Codex, Gemini CLI, Copilot — todos usam OAuth 2.0 com tokens expirados. Os desenvolvedores precisam se autenticar novamente constantemente, lidar com `client_secret is missing`, `redirect_uri_mismatch` e falhas em servidores remotos. OAuth em LAN/VPS é particularmente problemático.

**Como o OmniRoute resolve isso:**

-**Atualização automática de token**— Os tokens OAuth são atualizados em segundo plano antes da expiração
-**OAuth 2.0 (PKCE) integrado**— Fluxo automático para Claude Code, Codex, Gemini CLI, Copilot, Kiro, Qwen, Qoder
-**OAuth de várias contas**— Várias contas por provedor por meio de extração de token JWT/ID
-**OAuth LAN/Remote Fix**— Detecção de IP privado para `redirect_uri` + modo de URL manual para servidores remotos
-**OAuth por trás do Nginx**— Usa `window.location.origin` para compatibilidade de proxy reverso
-**Guia OAuth remoto**— Guia passo a passo para credenciais do Google Cloud em VPS/Docker</details>

<detalhes>
<summary><b>📊 9. "Não sei quanto estou gastando ou onde"</b></summary>

Os desenvolvedores usam vários provedores pagos, mas não têm uma visão unificada dos gastos. Cada provedor possui seu próprio painel de faturamento, mas não há visão consolidada. Custos inesperados podem se acumular.

**Como o OmniRoute resolve isso:**

-**Painel de análise de custos**— Acompanhamento de custos por token e gerenciamento de orçamento por provedor
-**Limites de orçamento por nível**— Teto de gastos por nível que aciona substituto automático
-**Configuração de preços por modelo**— Preços configuráveis por modelo
-**Estatísticas de uso por chave de API**— Contagem de solicitações e carimbo de data/hora do último uso por chave
-**Painel de análise**— Cartões de estatísticas, gráfico de uso do modelo, tabela de provedores com taxas de sucesso e latência</details>

<detalhes>
<summary><b>🐛 10. "Não consigo diagnosticar erros e problemas em chamadas de IA"</b></summary>

Quando uma chamada falha, o desenvolvedor não sabe se foi um limite de taxa, um token expirado, um formato errado ou um erro do provedor. Logs fragmentados em diferentes terminais. Sem observabilidade, a depuração é uma tentativa e erro.

**Como o OmniRoute resolve isso:**

-**Painel de registros unificados**— 4 guias: registros de solicitação, registros de proxy, registros de auditoria, console
-**Console Log Viewer**— Visualizador em estilo terminal em tempo real com níveis codificados por cores, rolagem automática, pesquisa, filtro
-**SQLite Proxy Logs**— Logs persistentes que sobrevivem às reinicializações do servidor
-**Translator Playground**— 4 modos de depuração: Playground (tradução de formato), Chat Tester (ida e volta), Test Bench (lote), Live Monitor (tempo real)
-**Solicitar telemetria**— latência p50/p95/p99 + rastreamento X-Request-Id
-**Registro baseado em arquivo com rotação**— Os logs do aplicativo são alternados por tamanho, dias de retenção e contagem de arquivos; os artefatos do registro de chamadas são alternados por dias de retenção e contagem de arquivos
-**Relatório de informações do sistema**— `npm run system-info` gera `system-info.txt` com seu ambiente completo (versão do Node, versão do OmniRoute, sistema operacional, ferramentas CLI, status do Docker/PM2). Anexe-o ao relatar problemas para triagem instantânea.</details>

<detalhes>
<summary><b>🏗️ 11. "Implantar e manter o gateway é complexo"</b></summary>

Instalar, configurar e manter um proxy de IA em diferentes ambientes (local, VPS, Docker, nuvem) exige muito trabalho. Problemas como caminhos codificados, `EACCES` em diretórios, conflitos de porta e compilações entre plataformas adicionam atrito.

**Como o OmniRoute resolve isso:**

-**instalação global npm**— `npm install -g omniroute && omniroute` — concluído
-**Docker Multiplataforma**— AMD64 + ARM64 nativo (Apple Silicon, AWS Graviton, Raspberry Pi)
-**Docker Compose Profiles**— `base` (sem ferramentas CLI) e `cli` (com Claude Code, Codex, OpenClaw)
-**Aplicativo Electron Desktop**— Aplicativo nativo para Windows/macOS/Linux com bandeja do sistema, inicialização automática e modo offline
-**Modo Split-Port**— API e Dashboard em portas separadas para cenários avançados (proxy reverso, rede de contêineres)
-**Cloud Sync**— Sincronização de configuração entre dispositivos via Cloudflare Workers
-**Backups de banco de dados**— Backup, restauração, exportação e importação automática de todas as configurações, com `DISABLE_SQLITE_AUTO_BACKUP` para backups gerenciados externamente</details>

<detalhes>
<summary><b>🌍 12. "A interface é somente em inglês e minha equipe não fala inglês"</b></summary>

Equipes em países que não falam inglês, especialmente na América Latina, Ásia e Europa, enfrentam dificuldades com interfaces somente em inglês. As barreiras linguísticas reduzem a adoção e aumentam os erros de configuração.

**Como o OmniRoute resolve isso:**

-**Painel i18n — 30 idiomas**— Todas as mais de 500 teclas traduzidas, incluindo árabe, búlgaro, dinamarquês, alemão, espanhol, finlandês, francês, hebraico, hindi, húngaro, indonésio, italiano, japonês, coreano, malaio, holandês, norueguês, polonês, português (PT/BR), romeno, russo, eslovaco, sueco, tailandês, ucraniano, vietnamita, chinês, filipino, inglês
-**Suporte RTL**— Suporte da direita para a esquerda para árabe e hebraico
-**READMEs multilíngues**— 30 traduções completas de documentação
-**Seletor de idioma**— Ícone de globo no cabeçalho para troca em tempo real</details>

<detalhes>
<summary><b>🔄 13. "Preciso de mais do que bate-papo - preciso de incorporações, imagens, áudio"</b></summary>

IA não é apenas conclusão de bate-papo. Os desenvolvedores precisam gerar imagens, transcrever áudio, criar embeddings para RAG, reclassificar documentos e moderar conteúdo. Cada API possui um endpoint e formato diferente.

**Como o OmniRoute resolve isso:**

-**Embeddings**— `/v1/embeddings` com 6 provedores e mais de 9 modelos
-**Geração de imagens**— `/v1/images/Generations` com 10 provedores e mais de 20 modelos (OpenAI, xAI, Together, Fireworks, Nebius, Hyperbolic, NanoBanana, Antigravity, SD WebUI, ComfyUI)
-**Texto para vídeo**— `/v1/videos/generações` — ComfyUI (AnimateDiff, SVD) e SD WebUI
-**Text-to-Music**— `/v1/music/Generations` — ComfyUI (Stable Audio Open, MusicGen)
-**Transcrição de áudio**— `/v1/audio/transcrições` — Whisper + Nvidia NIM, HuggingFace, Qwen3
-**Text-to-Speech**— `/v1/audio/speech` — ElevenLabs, Nvidia NIM, HuggingFace, Coqui, Tortoise, Qwen3,**Inworld**,**Cartesia**,**PlayHT**, + provedores existentes
-**Moderações**— `/v1/moderations` — Verificações de segurança de conteúdo
-**Reclassificação**— `/v1/rerank` — Reclassificação da relevância do documento
-**API Responses**— Suporte completo `/v1/responses` para Codex</details>

<detalhes>
<summary><b>🧪 14. "Não tenho como testar e comparar a qualidade entre modelos"</b></summary>

Os desenvolvedores querem saber qual modelo é melhor para seu caso de uso – código, tradução, raciocínio – mas comparar manualmente é lento. Não existem ferramentas de avaliação integradas.

**Como o OmniRoute resolve isso:**

-**Avaliações LLM**— Teste Golden Set com 10 casos pré-carregados cobrindo saudações, matemática, geografia, geração de código, conformidade com JSON, tradução, remarcação, recusa de segurança
-**4 estratégias de correspondência**— `exato`, `contém`, `regex`, `custom` (função JS)
-**Translator Playground Test Bench**— Teste em lote com múltiplas entradas e saídas esperadas, comparação entre fornecedores
-**Testador de bate-papo**— Ida e volta completa com renderização de resposta visual
-**Monitoramento ao vivo**— Transmissão em tempo real de todas as solicitações que passam pelo proxy</details>

<detalhes>
<summary><b>📈 15. "Preciso escalar sem perder desempenho"</b></summary>

À medida que o volume de solicitações aumenta, sem armazenar em cache as mesmas perguntas geram custos duplicados. Sem idempotência, solicitações duplicadas desperdiçam processamento. Os limites de tarifas por provedor devem ser respeitados.

**Como o OmniRoute resolve isso:**

-**Cache Semântico**— Cache de duas camadas (assinatura + semântica) reduz custo e latência
-**Idempotência de solicitação**— janela de desduplicação de 5s para solicitações idênticas
-**Detecção de limite de taxa**— RPM por provedor, intervalo mínimo e rastreamento simultâneo máximo
-**Limites de taxa editáveis**— Padrões configuráveis em Configurações → Resiliência com persistência
-**Cache de validação de chave de API**— cache de três camadas para desempenho de produção
-**Health Dashboard com telemetria**— latência p50/p95/p99, estatísticas de cache, tempo de atividade</details>

<detalhes>
<summary><b>🤖 16. "Quero controlar o comportamento do modelo globalmente"</b></summary>

Desenvolvedores que desejam todas as respostas em um idioma específico, com um tom específico ou que desejam limitar os tokens de raciocínio. Configurar isso em cada ferramenta/solicitação é impraticável.

**Como o OmniRoute resolve isso:**

-**Injeção de Prompt do Sistema**— Prompt global aplicado a todas as solicitações
-**Thinking Budget Validation**— Controle de alocação de token de raciocínio por solicitação (passthrough, automático, personalizado, adaptativo)
-**9 Estratégias de Roteamento**— Estratégias globais que determinam como as solicitações são distribuídas
-**Wildcard Router**— Os padrões `provider/*` roteiam dinamicamente para qualquer provedor
-**Combo Habilitar/Desabilitar Alternar**— Alternar combos diretamente do painel
-**Alternância de provedor**— Habilite/desabilite todas as conexões de um provedor com um clique
-**Provedores bloqueados**— Excluir provedores específicos da listagem `/v1/models`</details>

<detalhes>
<summary><b>🧰 17. "Preciso de ferramentas MCP como recursos de produto de primeira classe"</b></summary>

Muitos gateways de IA expõem o MCP apenas como um detalhe de implementação oculto. As equipes precisam de uma camada operacional visível e gerenciável.

**Como o OmniRoute resolve isso:**

- MCP aparece na navegação do painel e na guia protocolo de endpoint
- Página dedicada de gerenciamento de MCP com processos, ferramentas, escopos e auditoria
- Início rápido integrado para `omniroute --mcp` e integração do cliente</details>

<detalhes>
<summary><b>🧠 18. "Preciso de orquestração A2A com caminhos de tarefa de sincronização + fluxo"</b></summary>

Os fluxos de trabalho do agente precisam de respostas diretas e execução em streaming de longa duração com controle do ciclo de vida.

**Como o OmniRoute resolve isso:**

- Endpoint A2A JSON-RPC (`POST /a2a`) com `message/send` e `message/stream`
- Streaming SSE com propagação de estado terminal
- APIs de ciclo de vida de tarefas para `tasks/get` e `tasks/cancel`</details>

<detalhes>
<summary><b>🛰️ 19. "Preciso de integridade real do processo MCP, não de status adivinhado"</b></summary>

As equipes operacionais precisam saber se o MCP está realmente ativo, e não apenas se uma API está acessível.

**Como o OmniRoute resolve isso:**

- Arquivo de pulsação em tempo de execução com PID, carimbos de data/hora, transporte, contagem de ferramentas e modo de escopo
- API de status MCP combinando pulsação + atividade recente
- Cartões de status da interface do usuário para atualização de processo/tempo de atividade/pulsação</details>

<detalhes>
<summary><b>📋 20. "Preciso de execução auditável da ferramenta MCP"</b></summary>

Quando as ferramentas alteram a configuração ou acionam ações operacionais, as equipes precisam de rastreabilidade forense.

**Como o OmniRoute resolve isso:**

- Registro de auditoria apoiado por SQLite para chamadas de ferramentas MCP
- Filtros por ferramenta, sucesso/falha, chave de API e paginação
- Tabela de auditoria do painel + endpoints de estatísticas para automação</details>

<detalhes>
<summary><b>🔐 21. "Preciso de permissões MCP com escopo definido por integração"</b></summary>

Clientes diferentes devem ter acesso com privilégios mínimos às categorias de ferramentas.

**Como o OmniRoute resolve isso:**

- 10 escopos MCP granulares para acesso controlado à ferramenta
- Aplicação do escopo e visibilidade na UI de gerenciamento do MCP
- Postura padrão segura para ferramentas operacionais</details>

<detalhes>
<summary><b>⚙️ 22. "Preciso de controles operacionais sem reimplantar"</b></summary>

As equipes precisam de mudanças rápidas no tempo de execução durante incidentes ou eventos de custo.

**Como o OmniRoute resolve isso:**

- Alternar ativação combinada diretamente do painel MCP
- Aplicar perfis de resiliência de pacotes de políticas predefinidos
- Redefinir o estado do disjuntor no mesmo painel de operações</details>

<detalhes>
<summary><b>🔄 23. "Preciso de visibilidade e cancelamento do ciclo de vida da tarefa A2A ao vivo"</b></summary>

Sem visibilidade do ciclo de vida, os incidentes de tarefas tornam-se difíceis de triagem.

**Como o OmniRoute resolve isso:**

- Listagem/filtragem de tarefas por estado/habilidade com paginação
- Detalhamento de metadados de tarefas, eventos e artefatos
- Terminal de cancelamento de tarefa e ação de UI com confirmação</details>

<detalhes>
<summary><b>🌊 24. "Preciso de métricas de fluxo ativo para carga A2A"</b></summary>

Os fluxos de trabalho de streaming exigem insights operacionais sobre simultaneidade e conexões em tempo real.

**Como o OmniRoute resolve isso:**

- Contadores de fluxo ativos integrados ao status A2A
- Carimbo de data/hora da última tarefa e contagens por estado
- Cartões de painel A2A para monitoramento de operações em tempo real</details>

<detalhes>
<summary><b>🪪 25. "Preciso de descoberta de agente padrão para clientes"</b></summary>

Clientes e orquestradores externos precisam de metadados legíveis por máquina para integração.

**Como o OmniRoute resolve isso:**

- Cartão de agente exposto em `/.well-known/agent.json`
- Capacidades e habilidades mostradas na UI de gerenciamento
- A API de status A2A inclui metadados de descoberta para automação</details>

<detalhes>
<summary><b>🧭 26. "Preciso de descoberta de protocolo na experiência do usuário do produto"</b></summary>

Se os usuários não conseguirem descobrir superfícies de protocolo, a adoção e a qualidade do suporte cairão.

**Como o OmniRoute resolve isso:**

- Página**Endpoints**consolidada com guias para Proxy, MCP, A2A e API Endpoints
- Alterna o status do serviço inline (Online/Offline) para MCP e A2A
- Links da visão geral para guias de gerenciamento dedicadas</details>

<detalhes>
<summary><b>🧪 27. "Preciso de validação de protocolo ponta a ponta com clientes reais"</b></summary>

Os testes simulados não são suficientes para validar a compatibilidade do protocolo antes do lançamento.

**Como o OmniRoute resolve isso:**

- Suíte E2E que inicializa o aplicativo e usa transporte de cliente SDK MCP real
- Testes de cliente A2A para fluxos de descoberta, envio, streaming, obtenção e cancelamento
- Verificação cruzada de afirmações com APIs de auditoria MCP e tarefas A2A</details>

<detalhes>
<summary><b>📡 28. "Preciso de observabilidade unificada em todas as interfaces"</b></summary>

A divisão da observabilidade por protocolo cria pontos cegos e MTTR mais longo.

**Como o OmniRoute resolve isso:**

- Painéis/logs/análises unificados em um produto
- Saúde + auditoria + solicitação de telemetria nas camadas OpenAI, MCP e A2A
- APIs operacionais para status e automação</details>

<detalhes>
<summary><b>💼 29. "Preciso de um tempo de execução para proxy + ferramentas + orquestração de agentes"</b></summary>

A execução de muitos serviços separados aumenta o custo operacional e os modos de falha.

**Como o OmniRoute resolve isso:**

- Proxy compatível com OpenAI, servidor MCP e servidor A2A em uma pilha
- Autenticação compartilhada, resiliência, armazenamento de dados e observabilidade
- Modelo de política consistente em todas as superfícies de interação</details>

<detalhes>
<summary><b>🚀 30. "Preciso enviar fluxos de trabalho de agente sem confusão de códigos colados"</b></summary>

As equipes perdem velocidade ao unir vários serviços e scripts ad-hoc.

**Como o OmniRoute resolve isso:**

- Estratégia unificada de endpoint para clientes e agentes
- UIs de gerenciamento de protocolo integradas e caminhos de validação de fumaça
- Fundações prontas para produção (segurança, registro, resiliência, backup)</details>

### Example Playbooks (Integrated Use Cases)

**Manual A: Maximize a assinatura paga + backup barato**```txt
Combo: "maximize-claude"
  1. cc/claude-opus-4-6
  2. glm/glm-4.7
  3. if/kimi-k2-thinking

Monthly cost: $20 + small backup spend
Outcome: higher quality, near-zero interruption

Manual B: Pilha de codificação de custo zero```txt Combo: "free-forever"

gc/gemini-3-flash
if/kimi-k2-thinking
qw/qwen3-coder-plus

Monthly cost: $0 Outcome: stable free coding workflow


**Manual C: cadeia de fallback sempre ativa 24 horas por dia, 7 dias por semana**```txt
Combo: "always-on"
  1. cc/claude-opus-4-6
  2. cx/gpt-5.2-codex
  3. glm/glm-4.7
  4. minimax/MiniMax-M2.1
  5. if/kimi-k2-thinking

Outcome: deep fallback depth for deadline-critical workloads

Manual D: Operações de agente com MCP + A2A```txt

Start MCP transport (omniroute --mcp) for tool-driven operations
Run A2A tasks via message/send and message/stream
Observe via /dashboard/endpoint (MCP and A2A tabs)
Toggle services via inline status controls


---

## 🆓 Start Free — Zero Configuration Cost

> Configure a codificação de IA em minutos por**$0/mês**. Conecte essas contas gratuitas e use o combo**Free Stack**integrado.

| Etapa | Ação | Provedores desbloqueados |
| ---- | -------------------------------------------------- | ------------------------------------------------------------------ |
| 1 | Conectar**Kiro**(ID do AWS Builder OAuth) | Claude Soneto 4.5, Haiku 4.5 —**ilimitado**|
| 2 | Conecte**Qoder**(Google OAuth) | kimi-k2-thinking, qwen3-coder-plus, deepseek-r1... —**ilimitado**|
| 3 | Conecte**Qwen**(código do dispositivo) | qwen3-coder-plus, qwen3-coder-flash... —**ilimitado**|
| 4 | Conecte**Gemini CLI**(Google OAuth) | gemini-3-flash, gemini-2.5-pro —**180K/mês grátis**|
| 5 | `/dashboard/combos` →**Pilha grátis ($0)**modelo | Round-robin todos os provedores gratuitos automaticamente |

**Aponte qualquer IDE/CLI para:**`http://localhost:20128/v1` · Chave API: `any-string` · Concluído.

>**Cobertura extra opcional (também gratuita):**Chave de API Groq (30 RPM grátis), NVIDIA NIM (40 RPM grátis, modelos com mais de 70), Cerebras (1 milhão de tok/dia), chave de API LongCat (50 milhões de tokens/dia!), Cloudflare Workers AI (10 mil neurônios/dia, mais de 50 modelos).## Início Rápido

### 1) Install and run

```bash
npm install -g omniroute
omniroute

**usuários pnpm:**Execute pnpm aprovar-builds -g após a instalação para habilitar scripts de construção nativos exigidos por better-sqlite3 e @swc/core:
instalação pnpm -g omniroute
pnpm aprovar-builds -g # Selecione todos os pacotes → aprovar
omnirota

O painel abre em http://localhost:20128 e o URL base da API é http://localhost:20128/v1.

Comando	Descrição
`omnirota`	Iniciar servidor (`PORT=20128`, API e dashboard na mesma porta)
`omniroute --port 3000`	Defina a porta canônica/API como 3000
`omniroute --mcp`	Inicie o servidor MCP (transporte stdio)
`omniroute --no-open`	Não abra o navegador automaticamente
`omniroute --help`	Mostrar ajuda

Modo de porta dividida opcional:```bash PORT=20128 DASHBOARD_PORT=20129 omniroute

API: http://localhost:20128/v1

Dashboard: http://localhost:20129


### Long-Running Streaming Timeouts

Para a maioria das implantações, você só precisa de:

| Variável | Padrão | Finalidade |
| ------------------------ | ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| `REQUEST_TIMEOUT_MS` | `600000` | Linha de base compartilhada para busca upstream, tempos limite ocultos de Undici, solicitações de impressão digital TLS e tempos limite de solicitação/proxy de ponte de API |
| `STREAM_IDLE_TIMEOUT_MS` | herda `REQUEST_TIMEOUT_MS` | Intervalo máximo entre blocos de streaming antes que o OmniRoute anule o fluxo SSE |

A compatibilidade com versões anteriores é preservada: `FETCH_TIMEOUT_MS`, `API_BRIDGE_PROXY_TIMEOUT_MS` e outras variáveis de tempo limite por camada ainda funcionam e substituem a linha de base compartilhada.

Substituições avançadas estão disponíveis se você precisar de um controle mais preciso:| Variável | Padrão | Finalidade |
| ---------------------------------------- | ------------------------------------------ | -------------------------------------------------------------------- |
| `FETCH_TIMEOUT_MS` | herda `REQUEST_TIMEOUT_MS` | Tempo limite total da solicitação upstream usado pelo sinal de aborto de busca principal |
| `FETCH_HEADERS_TIMEOUT_MS` | herda `FETCH_TIMEOUT_MS` | Prazo Undici para recepção de cabeçalhos de resposta a montante |
| `FETCH_BODY_TIMEOUT_MS` | herda `FETCH_TIMEOUT_MS` | Limite de tempo Undici entre partes do corpo upstream (`0` desativa) |
| `FETCH_CONNECT_TIMEOUT_MS` | `30000` | Tempo limite de conexão TCP Undici |
| `FETCH_KEEPALIVE_TIMEOUT_MS` | `4000` | Undici tempo limite de soquete keep-alive ocioso |
| `TLS_CLIENT_TIMEOUT_MS` | herda `FETCH_TIMEOUT_MS` | Tempo limite para solicitações de impressão digital TLS feitas por meio de `wreq-js` |
| `API_BRIDGE_PROXY_TIMEOUT_MS` | herda `REQUEST_TIMEOUT_MS` ou `30000` | Tempo limite para encaminhamento de proxy `/v1` da porta API para a porta do painel |
| `API_BRIDGE_SERVER_REQUEST_TIMEOUT_MS` | `máx(API_BRIDGE_PROXY_TIMEOUT_MS, 300000)` | Tempo limite de solicitação de entrada no servidor ponte API |
| `API_BRIDGE_SERVER_HEADERS_TIMEOUT_MS` | `60000` | Tempo limite do cabeçalho de entrada no servidor ponte API |
| `API_BRIDGE_SERVER_KEEPALIVE_TIMEOUT_MS` | `5000` | Tempo limite de atividade no servidor ponte API |
| `API_BRIDGE_SERVER_SOCKET_TIMEOUT_MS` | `0` | Tempo limite de inatividade do soquete no servidor ponte API (`0` desativa) |

Se você executar o OmniRoute atrás de Nginx, Caddy, Cloudflare ou outro proxy reverso, certifique-se de que o proxy
os tempos limite também são maiores que os tempos limites de fluxo/busca do OmniRoute.### 2) Connect providers and create your API key

1. Abra Dashboard → `Providers` e conecte pelo menos um provedor (OAuth ou chave API).
2. Abra Dashboard → `Endpoints` e crie uma chave de API.
3. (Opcional) Abra Dashboard → `Combos` e defina sua cadeia de fallback.### 3) Point your coding tool to OmniRoute

```txt
Base URL: http://localhost:20128/v1
API Key:  [copy from Endpoint page]
Model:    if/kimi-k2-thinking (or any provider/model prefix)

Funciona com Claude Code, Codex CLI, Gemini CLI, Cursor, Cline, OpenClaw, OpenCode e SDKs compatíveis com OpenAI.### 4) Enable and validate protocols (v2.0)

MCP (para operações orientadas por ferramentas):```bash omniroute --mcp


Em seguida, conecte seu cliente MCP através de `stdio` e teste ferramentas como:

- `omniroute_get_health`
- `omniroute_list_combos`

**A2A (para fluxos de trabalho entre agentes):**```bash
curl http://localhost:20128/.well-known/agent.json

curl -X POST http://localhost:20128/a2a \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":"quickstart","method":"message/send","params":{"skill":"quota-management","messages":[{"role":"user","content":"Give me a short quota summary."}]}}'

5) Validate everything end-to-end (recommended)

npm run test:protocols:e2e

Este conjunto valida fluxos reais de clientes MCP e A2A em um aplicativo em execução.### Alternative: run from source

cp .env.example .env
npm install
PORT=20128 DASHBOARD_PORT=20129 NEXT_PUBLIC_BASE_URL=http://localhost:20129 npm run dev

Void Linux (modelo `xbps-src`)

Para usuários do Void Linux, você pode construir um pacote nativo usando xbps-src. Salve este bloco como srcpkgs/omniroute/template:```bash

Template file for 'omniroute'

pkgname=omniroute version=3.4.1 revision=1 hostmakedepends="nodejs python3 make" depends="openssl" short_desc="Universal AI gateway with smart routing for multiple LLM providers" maintainer="zenobit zenobit@disroot.org" license="MIT" homepage="https://github.com/diegosouzapw/OmniRoute" distfiles="https://github.com/diegosouzapw/OmniRoute/archive/refs/tags/v${version}.tar.gz" checksum=009400afee90a9f32599d8fe734145cfd84098140b7287990183dde45ae2245b system_accounts="_omniroute" omniroute_homedir="/var/lib/omniroute" export NODE_ENV=production export npm_config_engine_strict=false export npm_config_loglevel=error export npm_config_fund=false export npm_config_audit=false

do_build() { # Determine target CPU arch for node-gyp local _gyp_arch case "$XBPS_TARGET_MACHINE" in aarch64*) _gyp_arch=arm64 ;; armv7*|armv6*) _gyp_arch=arm ;; i686*) _gyp_arch=ia32 ;; *) _gyp_arch=x64 ;; esac

# 1) Install all deps – skip scripts (no network in do_build, native modules
#    compiled separately below; better-sqlite3 is serverExternalPackage so
#    Next.js does not execute it during next build)
NODE_ENV=development npm ci --ignore-scripts

# 2) Build the Next.js standalone bundle
npm run build

# 3) Copy static assets into standalone
cp -r .next/static .next/standalone/.next/static
[ -d public ] && cp -r public .next/standalone/public || true

# 4) Compile better-sqlite3 native binding for the target architecture.
#    Use node-gyp directly so CC/CXX from xbps-src cross-toolchain are used
#    without npm altering them.
local _node_gyp=/usr/lib/node_modules/npm/node_modules/node-gyp/bin/node-gyp.js
(cd node_modules/better-sqlite3 && node "$_node_gyp" rebuild --arch="$_gyp_arch")

# 5) Place the compiled binding into the standalone bundle
local _bs3_release=.next/standalone/node_modules/better-sqlite3/build/Release
mkdir -p "$_bs3_release"
cp node_modules/better-sqlite3/build/Release/better_sqlite3.node "$_bs3_release/"

# 6) Remove arch-specific sharp bundles – upstream sets images.unoptimized=true
#    so sharp is not used at runtime; x64 .so files would break aarch64 strip
rm -rf .next/standalone/node_modules/@img

# 7) Copy pino runtime deps omitted by Next.js static analysis:
#    pino-abstract-transport – required by pino's worker thread
#    split2 – dep of pino-abstract-transport
#    process-warning – dep of pino itself
for _mod in pino-abstract-transport split2 process-warning; do
	cp -r "node_modules/$_mod" .next/standalone/node_modules/
done

}

do_check() { npm run test:unit }

do_install() { vmkdir usr/lib/omniroute/.next

vcopy .next/standalone/. usr/lib/omniroute/.next/standalone

# Prevent removal of empty Next.js app router dirs by the post-install hook
for _d in \
	.next/standalone/.next/server/app/dashboard \
	.next/standalone/.next/server/app/dashboard/settings \
	.next/standalone/.next/server/app/dashboard/providers; do
	touch "${DESTDIR}/usr/lib/omniroute/${_d}/.keep"
done

cat > "${WRKDIR}/omniroute" <<'EOF'

#!/bin/sh export PORT="${PORT:-20128}" export DATA_DIR="${DATA_DIR:-${XDG_DATA_HOME:-${HOME}/.local/share}/omniroute}" export LOG_TO_FILE="${LOG_TO_FILE:-false}" mkdir -p "${DATA_DIR}" exec node /usr/lib/omniroute/.next/standalone/server.js "$@" EOF vbin "${WRKDIR}/omniroute" }

post_install() { vlicense LICENSE }


</details>

---

## 🐳 Docker

OmniRoute está disponível como uma imagem pública do Docker no [Docker Hub](https://hub.docker.com/r/diegosouzapw/omniroute).

**Execução rápida:**```bash
docker run -d \
  --name omniroute \
  --restart unless-stopped \
  --stop-timeout 40 \
  -p 20128:20128 \
  -v omniroute-data:/app/data \
  diegosouzapw/omniroute:latest

Com arquivo de ambiente:```bash

Copy and edit .env first

cp .env.example .env

docker run -d
--name omniroute
--restart unless-stopped
--stop-timeout 40
--env-file .env
-p 20128:20128
-v omniroute-data:/app/data
diegosouzapw/omniroute:latest


**Usando Docker Compose:**```bash
# Base profile (no CLI tools)
docker compose --profile base up -d

# CLI profile (Claude Code, Codex, OpenClaw built-in)
docker compose --profile cli up -d

O suporte do painel para implantações do Docker agora inclui umCloudflare Quick Tunnelcom um clique em Dashboard → Endpoints. A primeira habilita o download de cloudflared somente quando necessário, inicia um túnel temporário para seu endpoint /v1 atual e mostra o URL https://*.trycloudflare.com/v1 gerado diretamente abaixo de seu URL público normal.

Notas:

Os URLs do Quick Tunnel são temporários e mudam após cada reinicialização.
Os Quick Tunnels não são restaurados automaticamente após um OmniRoute ou reinicialização do contêiner. Reative-os no painel quando necessário.
A instalação gerenciada atualmente oferece suporte a Linux, macOS e Windows em x64 / arm64.
Túneis rápidos gerenciados padrão para transporte HTTP/2 para evitar avisos de buffer QUIC UDP barulhentos em ambientes de contêiner restritos. Defina CLOUDFLARED_PROTOCOL=quic ou auto se desejar um transporte diferente.
As imagens do Docker agrupam as raízes da CA do sistema e as passam para o cloudflared gerenciado, o que evita falhas de confiança do TLS quando o túnel é inicializado dentro do contêiner.
SQLite roda em modo WAL. docker stop deve ter permissão para terminar para que o OmniRoute possa verificar as alterações mais recentes em storage.sqlite.
Os arquivos Compose incluídos já definem um período de carência de 40 segundos. Se você executar a imagem diretamente, mantenha --stop-timeout 40 (ou similar) para que as paradas manuais não interrompam a limpeza do desligamento.
Defina CLOUDFLARED_BIN=/absolute/path/to/cloudflared se quiser que o OmniRoute use um binário existente em vez de baixar um.

Usando Docker Compose com Caddy (HTTPS Auto-TLS):

OmniRoute pode ser exposto com segurança usando o provisionamento SSL automático da Caddy. Certifique-se de que o registro DNS A do seu domínio aponte para o IP do seu servidor.```yaml services: omniroute: image: diegosouzapw/omniroute:latest container_name: omniroute restart: unless-stopped volumes: - omniroute-data:/app/data environment: - PORT=20128 - NEXT_PUBLIC_BASE_URL=https://your-domain.com

caddy: image: caddy:latest container_name: caddy restart: unless-stopped ports: - "80:80" - "443:443" command: caddy reverse-proxy --from https://your-domain.com --to http://omniroute:20128

volumes: omniroute-data:


| Imagem | Etiqueta | Tamanho | Descrição |
| ------------------------ | -------- | ------ | --------------------- |
| `diegosouzapw/omniroute` | `mais recente` | ~250 MB | Última versão estável |
| `diegosouzapw/omniroute` | `1.0.3` | ~250 MB | Versão atual |---

## 🖥️ Desktop App — Offline & Always-On

> 🆕**NOVO!**OmniRoute agora está disponível como um**aplicativo de desktop nativo**para Windows, macOS e Linux.

Execute o OmniRoute como um aplicativo de desktop independente — sem terminal, sem navegador, sem necessidade de internet para modelos locais. O aplicativo baseado em Electron inclui:

- 🖥️**Janela Nativa**— Janela de aplicativo dedicada com integração na bandeja do sistema
- 🔄**Início automático**— Inicie o OmniRoute no login do sistema
- 🔔**Notificações nativas**— Receba alertas sobre esgotamento de cota ou problemas com o provedor
- ⚡**Instalação com um clique**— NSIS (Windows), DMG (macOS), AppImage (Linux)
- 🌐**Modo offline**— Funciona totalmente offline com servidor incluído### Início Rápido

```bash
# Development mode
npm run electron:dev

# Build for your platform
npm run electron:build         # Current platform
npm run electron:build:win     # Windows (.exe)
npm run electron:build:mac     # macOS (.dmg) — x64 & arm64
npm run electron:build:linux   # Linux (.AppImage)

System Tray

Quando minimizado, o OmniRoute fica na bandeja do sistema com ações rápidas:

Abra o painel
Alterar porta do servidor
Sair do aplicativo

📖 Documentação completa: electron/README.md---

💰 Pricing at a Glance

Nível	Provedor	Custo	Redefinição de cota	Melhor para
💳 ASSINATURA	Código Claude (Pro)	$ 20/mês	5h + semanalmente	Já inscrito
	Códice (Plus/Pro)	US$ 20-200/mês	5h + semanalmente	Usuários OpenAI
	Gêmeos CLI	GRÁTIS	180 mil/mês + 1 mil/dia	Todos!
	Copiloto GitHub	US$ 10-19/mês	Mensalmente	Usuários do GitHub
🔑 CHAVE DE API	NVIDIA NIM	GRÁTIS(desenvolvedor para sempre)	~40RPM	Mais de 70 modelos abertos
	Cérebros	GRÁTIS(1 milhão de tok/dia)	60KTPM/30RPM	O mais rápido do mundo
	Groq	GRÁTIS(30 RPM)	RPD de 14,4K	Lhama/Gemma ultrarrápida
	DeepSeek V3.2	US$ 0,27/US$ 1,10 por 1 milhão	Nenhum	Melhor raciocínio preço/qualidade
	xAI Grok-4 Rápido	$0,20/$0,50 por 1 milhão🆕	Nenhum	Chamada de ferramenta mais rápida +, ultrabaixa
	xAI Grok-4 (padrão)	US$ 0,20/US$ 1,50 por 1 milhão 🆕	Nenhum	Carro-chefe do raciocínio da xAI
	Mistral	Teste grátis + pago	Taxa limitada	IA Europeia
	OpenRouter	Pagamento conforme uso	Nenhum	Mais de 100 modelos no total.
💰 BARATO	GLM-5 (via Z.AI) 🆕	US$ 0,5/1 milhão	Diariamente 10h	Saída de 128K, o mais novo carro-chefe
	GLM-4.7	US$ 0,6/1 milhão	Diariamente 10h	Backup de orçamento
	MiniMax M2.5 🆕	Entrada de US$ 0,3/1 milhão	Rolamento de 5 horas	Raciocínio + tarefas de agência
	MiniMax M2.1	US$ 0,2/1 milhão	Rolamento de 5 horas	Opção mais barata
	Kimi K2.5 (API Moonshot) 🆕	Pagamento conforme uso	Nenhum	Acesso direto à API Moonshot
	Kimi K2	$ 9 / mês fixo	10 milhões de tokens/mês	Custo previsível
🆓 GRÁTIS	Qoder	$0	Ilimitado	5 modelos ilimitados
	Qwen	$0	Ilimitado	4 modelos ilimitados
	Kiro	$0	Ilimitado	Claude Sonnet/Haiku (Construtor AWS)
	LongCat Flash Lite 🆕	$0(50 milhões de dólares/dia 🔥)	1RPS	Maior cota gratuita do planeta
	Polinizações AI 🆕	$0(sem necessidade de chave)	1 necessidade/15s	GPT-5, Claude, DeepSeek, Lhama 4
	IA dos trabalhadores da Cloudflare 🆕	$0(10 mil neurônios/dia)	~150 resp/dia	Mais de 50 modelos, vantagem global
	IA Scaleway 🆕	$0(total de 1 milhão de tokens)	Taxa limitada	UE/GDPR, Qwen3 235B, Llama 70B	> 🆕Novos modelos adicionados (março de 2026):Família Grok-4 Fast a US$ 0,20/US$ 0,50/M (comparado em 1143ms — 30% mais rápido que Gemini 2.5 Flash), GLM-5 via Z.AI com saída de 128K, raciocínio MiniMax M2.5, preço atualizado DeepSeek V3.2, Kimi K2.5 via API direta Moonshot.

💡 Pilha Combo de $0 — A configuração gratuita completa:```

🆓 Ultimate Free Stack 2026 — 11 Providers, $0 Forever

Kiro (kr/) → Claude Sonnet/Haiku UNLIMITED Qoder (if/) → kimi-k2-thinking, qwen3-coder-plus, deepseek-r1 UNLIMITED LongCat Lite (lc/) → LongCat-Flash-Lite — 50M tokens/day 🔥 Pollinations (pol/) → GPT-5, Claude, DeepSeek, Llama 4 — no key needed Qwen (qw/) → qwen3-coder-plus, qwen3-coder-flash, qwen3-coder-next UNLIMITED Gemini (gemini/) → Gemini 2.5 Flash — 1,500 req/day free API key Cloudflare AI (cf/) → Llama 70B, Gemma 3, Mistral — 10K Neurons/day Scaleway (scw/) → Qwen3 235B, Llama 70B — 1M free tokens (EU) Groq (groq/) → Llama/Gemma ultra-fast — 14.4K req/day NVIDIA NIM (nvidia/) → 70+ open models — 40 RPM forever Cerebras (cerebras/) → Llama/Qwen world-fastest — 1M tok/day


**Custo zero. Nunca para de codificar.**Configure isso como um combo OmniRoute e todos os fallbacks acontecem automaticamente - nunca há troca manual.---

---

## 🆓 Free Models — What You Actually Get

> Todos os modelos abaixo são**100% gratuitos, sem necessidade de cartão de crédito**. OmniRoute roteia automaticamente entre eles quando uma cota acaba – combine todos eles para um combo inquebrável de $ 0.### 🔵 CLAUDE MODELS (via Kiro — AWS Builder ID)

| Modelo | Prefixo | Limite | Limite de taxa |
| ------------------- | ------ | ------------- | --------------------- |
| `claude-soneto-4.5` | `kr/` |**Ilimitado**| Nenhum limite diário comunicado |
| `claude-haiku-4.5` | `kr/` |**Ilimitado**| Nenhum limite diário comunicado |
| `claude-opus-4.6` | `kr/` |**Ilimitado**| Último Opus via Kiro |### 🟢 QODER MODELS (Free PAT via qodercli)

| Modelo | Prefixo | Limite | Limite de taxa |
| ------------------ | ------ | ------------- | --------------- |
| `kimi-k2-pensando` | `se/` |**Ilimitado**| Nenhum limite máximo comunicado |
| `qwen3-coder-plus` | `se/` |**Ilimitado**| Nenhum limite máximo comunicado |
| `deepseek-r1` | `se/` |**Ilimitado**| Nenhum limite máximo comunicado |
| `minimax-m2.1` | `se/` |**Ilimitado**| Nenhum limite máximo comunicado |
| `kimi-k2` | `se/` |**Ilimitado**| Nenhum limite máximo comunicado |

> Método de conexão recomendado:**Token de acesso pessoal + `qodercli`**. OAuth do navegador é
> experimental e desativado por padrão, a menos que variáveis de ambiente `QODER_OAUTH_*` sejam configuradas.### 🟡 QWEN MODELS (Device Code Auth)

| Modelo | Prefixo | Limite | Limite de taxa |
| ------------------- | ------ | ------------- | ------------------- |
| `qwen3-coder-plus` | `qw/` |**Ilimitado**| Nenhum limite máximo comunicado |
| `qwen3-codificador-flash` | `qw/` |**Ilimitado**| Nenhum limite máximo comunicado |
| `qwen3-coder-next` | `qw/` |**Ilimitado**| Nenhum limite máximo comunicado |
| `modelo de visão` | `qw/` |**Ilimitado**| Multimodal (imagens) |### 🟣 GEMINI CLI (Google OAuth)

| Modelo | Prefixo | Limite | Limite de taxa |
| ------------------------ | ------ | --------------------------- | ------------- |
| `gemini-3-flash-preview` | `gc/` |**180 mil tok/mês**+ 1 mil/dia | Redefinição mensal |
| `gemini-2.5-pro` | `gc/` | 180 mil/mês (pool compartilhado) | Alta qualidade |### ⚫ NVIDIA NIM (Free API Key — build.nvidia.com)

| Nível | Limite Diário | Limite de taxa | Notas |
| ---------- | ------------ | ----------- | ------------------------------------------------------ |
| Grátis (Desenvolvedor) | Sem limite de token |**~40RPM**| Mais de 70 modelos; transição para limites de taxas puras em meados de 2025 |

Modelos gratuitos populares: `moonshotai/kimi-k2.5` (Kimi K2.5), `z-ai/glm4.7` (GLM 4.7), `deepseek-ai/deepseek-v3.2` (DeepSeek V3.2), `nvidia/llama-3.3-70b-instruct`, `deepseek/deepseek-r1`### ⚪ CEREBRAS (Free API Key — inference.cerebras.ai)

| Nível | Limite Diário | Limite de taxa | Notas |
| ---- | ----------------- | ---------------- | ------------------------------------------- |
| Grátis |**1 milhão de tokens/dia**| 60KTPM/30RPM | A inferência LLM mais rápida do mundo; reinicia diariamente |

Disponível gratuitamente: `llama-3.3-70b`, `llama-3.1-8b`, `deepseek-r1-distill-llama-70b`### 🔴 GROQ (Free API Key — console.groq.com)

| Nível | Limite Diário | Limite de taxa | Notas |
| ---- | ------------- | ---------------- | ----------------------------------------- |
| Grátis |**RPD de 14,4K**| 30 RPM por modelo | Sem cartão de crédito; 429 no limite, sem cobrança |

Disponível gratuitamente: `llama-3.3-70b-versatile`, `gemma2-9b-it`, `mixtral-8x7b`, `whisper-large-v3`### 🔴 LONGCAT AI (Free API Key — longcat.chat) 🆕

| Modelo | Prefixo | Cota diária gratuita | Notas |
| ----------------------------- | ------ | ----------------- | ----------------------- |
| `LongCat-Flash-Lite` | `lc/` |**50 milhões de tokens**💥 | Maior cota gratuita de todos os tempos |
| `LongCat-Flash-Chat` | `lc/` | 500 mil tokens | Bate-papo multiturno |
| `LongCat-Flash-Thinking` | `lc/` | 500 mil tokens | Raciocínio / CoT |
| `LongCat-Flash-Thinking-2601` | `lc/` | 500 mil tokens | Versão de janeiro de 2026 |
| `LongCat-Flash-Omni-2603` | `lc/` | 500 mil tokens | Multimodal |

> 100% gratuito durante a versão beta pública. Cadastre-se em [longcat.chat](https://longcat.chat) com e-mail ou telefone. Reinicia diariamente às 00:00 UTC.### 🟢 POLLINATIONS AI (No API Key Required) 🆕

| Modelo | Prefixo | Limite de taxa | Provedor por trás |
| ---------- | ------ | ---------- | ------------------ |
| `openai` | `pol/` | 1 necessidade/15s | GPT-5 |
| `cláudio` | `pol/` | 1 necessidade/15s | Claude Antrópico |
| `gêmeos` | `pol/` | 1 necessidade/15s | Google Gêmeos |
| `busca profunda` | `pol/` | 1 necessidade/15s | DeepSeek V3 |
| `lhama` | `pol/` | 1 necessidade/15s | Batedor Meta Lhama 4 |
| `mistral` | `pol/` | 1 necessidade/15s | IA Mistral |

> ✨**Atrito zero:**Sem inscrição, sem chave de API. Adicione o provedor Polinizações com um campo-chave vazio e ele funcionará imediatamente.### 🟠 CLOUDFLARE WORKERS AI (Free API Key — cloudflare.com) 🆕

| Nível | Neurônios Diários | Uso equivalente | Notas |
| ---- | ------------- | --------------------------------------- | ----------------------- |
| Grátis |**10.000**| ~150 LLM resp / áudio 500s / incorporações de 15K | Vantagem global, mais de 50 modelos |

Modelos gratuitos populares: `@cf/meta/llama-3.3-70b-instruct`, `@cf/google/gemma-3-12b-it`, `@cf/openai/whisper-large-v3-turbo` (áudio grátis!), `@cf/qwen/qwen2.5-coder-15b-instruct`

> Requer token de API + ID da conta de [dash.cloudflare.com](https://dash.cloudflare.com). Armazene o ID da conta nas configurações do provedor.### 🟣 SCALEWAY AI (1M Free Tokens — scaleway.com) 🆕

| Nível | Cota Grátis | Localização | Notas |
| ---- | ------------- | ------------ | ----------------------------------- |
| Grátis |**1 milhão de tokens**| 🇫🇷 Paris, UE | Não é necessário cartão de crédito dentro dos limites |

Disponível gratuitamente: `qwen3-235b-a22b-instruct-2507` (Qwen3 235B!), `llama-3.1-70b-instruct`, `mistral-small-3.2-24b-instruct-2506`, `deepseek-v3-0324`

> Compatível com UE/GDPR. Obtenha a chave de API em [console.scaleway.com](https://console.scaleway.com).

>**💡 The Ultimate Free Stack (11 provedores, $ 0 para sempre):**
>
> ```
> Kiro (kr/) → Claude Sonnet/Haiku ILIMITADO
> Qoder (if/) → kimi-k2-thinking, qwen3-coder-plus, deepseek-r1 ILIMITADO
> LongCat Lite (lc/) → LongCat-Flash-Lite — 50 milhões de tokens/dia 🔥
> Polinizações (pol/) → GPT-5, Claude, DeepSeek, Llama 4 — nenhuma chave necessária
> Qwen (qw /) → modelos de codificador qwen3 ILIMITADOS
> Gemini (gemini/) → Gemini 2.5 Flash – 1.500 req/dia grátis
> Cloudflare AI (cf/) → mais de 50 modelos — 10 mil neurônios/dia
> Scaleway (scw/) → Qwen3 235B, Llama 70B — 1 milhão de tokens grátis (UE)
> Groq (groq/) → Llama/Gemma — 14,4K req/dia ultrarrápido
> NVIDIA NIM (nvidia/) → Mais de 70 modelos abertos — 40 RPM para sempre
> Cerebras (cerebras/) → Llama/Qwen mais rápido do mundo — 1 milhão tok/dia
> ```## 🎙️ Free Transcription Combo

> Transcreva qualquer áudio/vídeo por**US$ 0**— Deepgram lidera com US$ 200 grátis, AssemblyAI US$ 50 substitutos, Groq Whisper como backup de emergência ilimitado.

| Provedor | Créditos Grátis | Melhor Modelo | Limite de taxa |
| ----------------- | ---------------------- | -------------------------------------------- | ---------------------------- |
| 🟢**Deepgram**|**$200 grátis**(inscrição) | `nova-3` — melhor precisão, mais de 30 idiomas | Sem limite de RPM em créditos gratuitos |
| 🔵**AssemblyAI**|**$50 grátis**(inscrição) | `universal-3-pro` — capítulos, sentimento, PII | Sem limite de RPM em créditos gratuitos |
| 🔴**Groque**|**Grátis para sempre**| `whisper-large-v3` — OpenAI Whisper | 30 RPM (taxa limitada) |

**Combo sugerido em `/dashboard/combos`:**```
Name: free-transcription
Strategy: Priority
Nodes:
  [1] deepgram/nova-3          → uses $200 free first
  [2] assemblyai/universal-3-pro → fallback when Deepgram credits run out
  [3] groq/whisper-large-v3    → free forever, emergency fallback

Em seguida, em /dashboard/media → guiaTranscrição: carregue qualquer arquivo de áudio ou vídeo → selecione seu endpoint combinado → obtenha a transcrição em formatos suportados.## 💡 Key Features

OmniRoute v2.0 é construído como uma plataforma operacional, não apenas um proxy de retransmissão.### 🆕 New — ClawRouter-Inspired Improvements (Mar 2026)

Recurso	O que faz
⚡Grok-4 Família Rápida	Modelos xAI por US$ 0,20/US$ 0,50/M – benchmark de 1143 ms (30% mais rápido que Gemini 2.5 Flash)
🧠GLM-5 via Z.AI	Contexto de saída de 128K, US$ 0,5/1 milhão – o mais novo carro-chefe da família GLM
🔮MiniMax M2.5	Raciocínio + tarefas de agência por US$ 0,30/1 milhão — atualização significativa do M2.1
🎯toolCalling Flag por modelo	`toolCalling: true/false` por modelo no registro — AutoCombo ignora modelos sem capacidade de ferramenta
🌍Detecção de intenção multilíngue	Palavras-chave PT/ZH/ES/AR na pontuação AutoCombo — melhor seleção de modelos para conteúdo diferente do inglês
📊Recursos baseados em benchmarks	Latência p95 real de solicitações ao vivo alimenta pontuação combinada – AutoCombo aprende com dados reais
🔁Solicitar desduplicação	Janela de desduplicação baseada em hash de conteúdo — segura para vários agentes, evita cobranças duplicadas
🔌Estratégia de roteador conectável	Interface `RouterStrategy` extensível — adicione lógica de roteamento personalizada como plug-ins	### 🚀 Previous v2.0.9+ — Playground, CLI Fingerprints & ACP

Recurso	O que faz
🎮Parque Modelo	Página do painel para testar qualquer modelo diretamente - seletores de provedor/modelo/endpoint, Monaco Editor, streaming, aborto, tempo
🔏Correspondência de impressão digital CLI	Ordenação de cabeçalho/corpo por provedor para corresponder às assinaturas CLI nativas — alterne por provedor em Configurações > Segurança.Seu IP proxy é preservado
🤝Suporte ACP (Protocolo Agente Cliente)	Descoberta de agente CLI (Codex, Claude, Goose, Gemini CLI, OpenClaw e mais 9), gerador de processo, endpoint `/api/acp/agents`
🤖Painel de Agentes ACP	Depurar › Página Agentes — grade de 14 agentes com status de instalação, versão, formulário de agente personalizado para qualquer ferramenta CLI. Os usuários doOpenCoderecebem um botão "Baixar opencode.json" que gera automaticamente uma configuração pronta para uso com todos os modelos disponíveis.
🔧Roteamento `apiFormat` de modelo personalizado	Modelos personalizados com `apiFormat: "responses"` agora roteiam corretamente para o tradutor da API Responses
🏢Isolamento do espaço de trabalho do Codex	Vários espaços de trabalho do Codex por e-mail — OAuth separa corretamente as conexões por ID do espaço de trabalho
🔄Atualização automática eletrônica	O aplicativo de desktop verifica atualizações + instalação automática ao reiniciar	### 🤖 Agent & Protocol Operations (v2.0)

Recurso	O que faz
🔧Servidor MCP (25 ferramentas)	Ferramentas IDE/agente por meio de 3 transportes: stdio, SSE (`/api/mcp/sse`), HTTP Streamable (`/api/mcp/stream`). 18 núcleos + 3 memórias + 4 ferramentas de habilidade
🤝Servidor A2A (JSON-RPC + SSE)	Execução de tarefas entre agentes com fluxos de sincronização e streaming
🧭Página de endpoints consolidados	Página de gerenciamento com guias com guias Endpoint Proxy, MCP, A2A e API Endpoints
🎚️Alternativas de ativação/desativação de serviço	Chaves ON/OFF para MCP e A2A com persistência de configurações (padrão: OFF)
🛰️Pulsação de tempo de execução do MCP	Status real do processo (pid, tempo de atividade, idade da pulsação, transporte, modo de escopo)
📋Trilha de auditoria MCP	Logs de auditoria filtráveis com sucesso/falha e atribuição de chave
🔐Aplicação do escopo do MCP	10 permissões de escopo granular para acesso controlado a ferramentas
📡Gerenciamento do ciclo de vida de tarefas A2A	Listar/filtrar tarefas, inspecionar eventos/artefatos, cancelar tarefas em execução
📋Descoberta de cartão de agente	`/.well-known/agent.json` para descoberta automática de clientes
🧪Arnês de teste do protocolo E2E	Fluxos reais do cliente MCP SDK + A2A em `test:protocols:e2e`
⚙️Controles operacionais	Combinação de interruptores, aplicação de perfis de resiliência, reinicialização de disjuntores a partir de uma superfície de controle	### 🧠 Routing & Intelligence

Recurso	O que faz
🎯Fullback inteligente de 4 camadas	Roteamento automático: Assinatura → Chave de API → Barato → Grátis
📊Acompanhamento de cotas em tempo real	Contagem de tokens ativos + contagem regressiva redefinida por provedor
🔄Tradução de formato	OpenAI ↔ Claude ↔ Gemini ↔ Respostas com conversões seguras de esquema
👥Suporte para múltiplas contas	Múltiplas contas por provedor com seleção inteligente
🔄Atualização automática de token	Os tokens OAuth são atualizados automaticamente com nova tentativa
🎨Combos Personalizados	9 estratégias de balanceamento + controle da cadeia de fallback
🌐Roteador curinga	`provedor/*` roteamento dinâmico
🧠Pensando em controles de orçamento	Limites de raciocínio de passagem, automático, personalizado e adaptativo
🔀Alases de modelo	Aliasing de modelo integrado + personalizado e segurança de migração
⚡Degradação de fundo	Encaminhar tarefas em segundo plano de baixa prioridade para modelos mais baratos
🧪Roteamento inteligente com reconhecimento de tarefas	Seleção automática de modelo por tipo de conteúdo (codificação/visão/análise/resumo)
🔄Fluxos de trabalho do agente A2A	Orquestrador FSM determinístico para execuções de agentes em várias etapas com estado
🔀Roteamento Adaptativo	Substituição de estratégia dinâmica com base no volume de tokens e complexidade imediata
🎲Diversidade de Provedores	Pontuação de entropia de Shannon equilibrando distribuição de tráfego de combinação automática
💬Injeção imediata do sistema	Controles de comportamento globais aplicados de forma consistente
📄Compatibilidade da API de respostas	Suporte completo `/v1/responses` para Codex e fluxos de trabalho de agentes avançados	### 🎵 Multi-Modal APIs

Recurso	O que faz
🖼️Geração de imagens	`/v1/images/generações` com nuvem e backends locais
📐Incorporações	`/v1/embeddings` para pipelines de pesquisa e RAG
🎤Transcrição de áudio	`/v1/audio/transcrições` — 7 provedores (Deepgram Nova 3, AssemblyAI, Groq Whisper, HuggingFace, ElevenLabs, OpenAI, Azure), detecção automática de idioma, suporte a MP4/MP3/WAV
🔊Conversão de texto em fala	`/v1/audio/speech` — 10 provedores (ElevenLabs, OpenAI, Deepgram, Cartesia, PlayHT, HuggingFace, Nvidia NIM, Inworld, Coqui, Tortoise) com mensagens de erro corretas
🎬Geração de Vídeo	`/v1/videos/generações` (fluxos de trabalho ComfyUI + SD WebUI)
🎵Geração Musical	`/v1/music/Generations` (fluxos de trabalho ComfyUI)
🛡️Moderações	verificações de segurança `/v1/moderations`
🔀Reclassificação	`/v1/rerank` para pontuação de relevância
🔍Pesquisa na Web🆕	`/v1/search` — 5 provedores (Serper, Brave, Perplexity, Exa, Tavily), mais de 6.500 grátis/mês, failover automático, cache	### 🛡️ Resilience, Security & Governance

Recurso	O que faz
🔌Disjuntores	Acionamento/recuperação por modelo com controles de limite
🎯Modelos com reconhecimento de endpoint	Modelos personalizados declaram endpoints suportados + formato API
🛡️Rebanho Anti-Trovão	Proteções Mutex + semáforo em eventos de nova tentativa/taxa
🧠Semântica + Cache de Assinatura	Redução de custo/latência com duas camadas de cache
⚡Solicitar Idempotência	Janela de proteção duplicada
🔒Falsificação de impressão digital TLS	Impressão digital TLS semelhante a navegador —reduz a detecção de bots e a sinalização de contas
🔏Correspondência de impressão digital CLI	Corresponde às assinaturas de solicitação CLI nativas —reduz o risco de banimento enquanto preserva o IP do proxy
🌐Filtragem de IP	Controle de lista de permissões/lista de bloqueio para implantações expostas
📊Limites de taxas editáveis	Limites configuráveis em nível global/de provedor com persistência
📉Degradação graciosa	Fallbacks de capacidade multicamadas protegendo as principais operações de gateway
📜Trilha de auditoria de configuração	Rastreamento de alterações baseado em diferenças, evitando desvios operacionais com reversões simples
⏳Sincronização de saúde do provedor	Monitoramento proativo de expiração de token acionando alertas antes de falhas de autorização
🚪Desativar automaticamente contas banidas	Disjuntor operacional vedando automaticamente contas de token permanentemente bloqueadas
🔑Gerenciamento de chaves de API + escopo	Emissão/rotação segura de chaves e controles de modelo/provedor
👁️Revelação da chave de API com escopo🆕	Recuperação opcional de chaves de API via `ALLOW_API_KEY_REVEAL`
🛡️`/modelos` protegidos	Autenticação opcional e ocultação de provedor para catálogo de modelos	### 📊 Observability & Analytics

Recurso	O que faz
📝Solicitação + Registro de Proxy	Solicitação/resposta completa e registro de proxy
📉Registros detalhados transmitidos🆕	Reconstrói fluxos de carga útil SSE de forma limpa na UI
📋Painel de registros unificado	Visualizações de solicitação, proxy, auditoria e console em uma página
🔍Solicitar Telemetria	Latência p50/p95/p99 e rastreamento de solicitação
🏥Painel de saúde	Tempo de atividade, estados de disjuntores, bloqueios, estatísticas de cache
💰Acompanhamento de custos	Controles de orçamento e visibilidade de preços por modelo
📈Visualizações analíticas	Insights de uso de modelo/provedor e visualizações de tendências
🧪Estrutura de Avaliação	Teste de Golden Set com estratégias de jogo configuráveis
📡Diagnóstico ao vivo🆕	Desvio de cache semântico para testes combinados ao vivo precisos	### ☁️ Deployment & Platform

Recurso	O que faz
🌐Implante em qualquer lugar	Ambientes Localhost, VPS, Docker, Cloud
🚇Túnel Cloudflare🆕	Integração do Quick Tunnel com um clique no painel
🔑Filtragem de modelo de chave de API	Resposta nativa /v1/models filtrada por meio de funções de contexto de portador atribuídas
⚡Ignorar Cache Inteligente	Heurísticas TTL configuráveis e controles de busca forçada
🔄Backup/Restauração	Fluxos de exportação/importação e recuperação de desastres
🧙Assistente de integração	Configuração guiada na primeira execução
🔧Painel de Ferramentas CLI	Configuração com um clique para ferramentas de codificação populares
🎮Parque Modelo	Teste qualquer provedor/modelo/endpoint no painel
🔏Alternar impressão digital CLI	Correspondência de impressão digital por provedor em Configurações > Segurança
🌐i18n (30 idiomas)	Painel completo + suporte a idiomas de documentos com cobertura RTL
🧹Limpar todos os modelos	Limpeza da lista de modelos com um clique nos detalhes do fornecedor
👁️Controles da barra lateral🆕	Ocultar componentes e integrações em Configurações de aparência
📋Modelos de problemas	Modelos padronizados do GitHub para bugs e recursos
📂Diretório de dados personalizado	Substituição `DATA_DIR` para local de armazenamento	### Feature Deep Dive

Smart fallback with practical cost control

Combo: "my-coding-stack"
  1. cc/claude-opus-4-6
  2. nvidia/llama-3.3-70b
  3. glm/glm-4.7
  4. if/kimi-k2-thinking

Quando a cota, a taxa ou a integridade falham, o OmniRoute passa automaticamente para o próximo candidato sem alternância manual.#### Protocol management that is visible and operable

MCP + A2A podem ser descobertos na interface do usuário e nos documentos (não ocultos)
APIs de status de protocolo expõem dados operacionais em tempo real (/api/mcp/*, /api/a2a/*)
Os painéis incluem ações para operações do dia 2 (alternâncias de combinação, reinicializações de disjuntores, cancelamento de tarefas)#### Translator + validation workflow

A área do Tradutor inclui:

-Playground: solicita verificações de transformação -Testador de bate-papo: solicitação/resposta completa, ida e volta -Banco de testes: vários casos em uma execução -Monitoramento ao vivo: visualização do tráfego em tempo real

Além de validação de protocolo com clientes reais via npm run test:protocols:e2e.

📖README do servidor MCP— Referência de ferramentas, configurações de IDE e exemplos de clientes

📖README do servidor A2A— Habilidades, métodos JSON-RPC, streaming e ciclo de vida de tarefas## 🧪 Evaluations (Evals)

OmniRoute inclui uma estrutura de avaliação integrada para testar a qualidade da resposta do LLM em relação a um conjunto dourado. Acesse-o emAnalytics → Evalsno painel.### Built-in Golden Set

O "OmniRoute Golden Set" pré-carregado contém casos de teste para:

Saudações, matemática, geografia, geração de código
Conformidade com o formato JSON, tradução, geração de descontos
Recusa de segurança (conteúdo prejudicial), contagem, lógica booleana### Evaluation Strategies

Estratégia	Descrição	Exemplo
`exato`	A saída deve corresponder exatamente	`"4"`
`contém`	A saída deve conter substring (sem distinção entre maiúsculas e minúsculas)	`"Paris"`
`regex`	A saída deve corresponder ao padrão regex	`"1.2.3"`
`personalizado`	Função JS personalizada retorna verdadeiro/falso	`(saída) => saída.comprimento > 10`	---

📖 Setup Guide

Protocol Setup (MCP + A2A)

🧩 Configuração do MCP (Protocolo de Contexto do Modelo)

Inicie o transporte MCP no modo stdio:```bash omniroute --mcp


Fluxo de validação recomendado:

1. Conecte seu cliente MCP por stdio.
2. Execute `omniroute_get_health`.
3. Execute `omniroute_list_combos`.
4. Abra `/dashboard/mcp` para confirmar pulsação, atividade e auditoria.

APIs úteis para automação:

- `GET /api/mcp/status`
- `GET /api/mcp/tools`
- `GET /api/mcp/auditoria`
- `GET /api/mcp/audit/stats`</details>

<detalhes>
<summary><b>🤝 Configuração A2A (Agent2Agent)</b></summary>

Conheça o agente:```bash
curl http://localhost:20128/.well-known/agent.json

Envie uma tarefa:```bash curl -X POST http://localhost:20128/a2a
-H 'content-type: application/json'
-d '{"jsonrpc":"2.0","id":"setup-a2a","method":"message/send","params":{"skill":"quota-management","messages":[{"role":"user","content":"Summarize quota status."}]}}'


Gerenciar ciclo de vida:

- `GET /api/a2a/status`
- `GET /api/a2a/tarefas`
- `GET /api/a2a/tasks/:id`
- `POST /api/a2a/tasks/:id/cancel`

IU operacional:

- `/dashboard/a2a` para observabilidade de tarefa/estado/fluxo e ações de fumaça</details>

<detalhes>
<summary><b>🧪 Validação de protocolo ponta a ponta</b></summary>

Valide ambos os protocolos com clientes reais:```bash
npm run test:protocols:e2e

Isso verifica:

Conexão/lista/chamada do cliente MCP SDK
Descoberta A2A/enviar/transmitir/obter/cancelar
Verificação cruzada de dados em APIs de auditoria MCP e gerenciamento de tarefas A2A

💳 Provedores de assinatura

### Claude Code (Pro/Max)

Dashboard → Providers → Connect Claude Code
→ OAuth login → Auto token refresh
→ 5-hour + weekly quota tracking

Models:
  cc/claude-opus-4-6
  cc/claude-sonnet-4-5-20250929
  cc/claude-haiku-4-5-20251001

**Dica profissional:**Use o Opus para tarefas complexas e o Sonnet para velocidade. OmniRoute rastreia cota por modelo!### OpenAI Codex (Plus/Pro)

Dashboard → Providers → Connect Codex
→ OAuth login (port 1455)
→ 5-hour + weekly reset

Models:
  cx/gpt-5.2-codex
  cx/gpt-5.1-codex-max

Codex Account Limit Management (5h + Weekly)

Cada conta do Codex agora possui opções de política em Dashboard -> Providers:

5h (ON/OFF): impõe a política de limite de janela de 5 horas.
Semanal (LIGADO/DESLIGADO): impõe a política de limite de janela semanal.
Comportamento do limite: quando uma janela habilitada atinge >=90% de uso, essa conta é ignorada.
Comportamento de rotação: OmniRoute roteia automaticamente para a próxima conta Codex qualificada.
Comportamento de redefinição: quando o tempo resetAt do provedor passa, a conta se torna elegível novamente automaticamente.

Cenários:

5h ON + Weekly ON: a conta é ignorada quando qualquer uma das janelas atinge o limite.
5h OFF + Weekly ON: apenas o uso semanal pode bloquear a conta.
5h ON + Weekly OFF: apenas o uso de 5 horas pode bloquear a conta.
resetAt aprovado: a conta entra novamente na rotação automaticamente (sem reativação manual).### Gemini CLI (FREE 180K/month!)

Dashboard → Providers → Connect Gemini CLI
→ Google OAuth
→ 180K completions/month + 1K/day

Models:
  gc/gemini-3-flash-preview
  gc/gemini-2.5-pro

**Melhor valor:**Grande nível gratuito! Use isso antes dos níveis pagos.### GitHub Copilot

Dashboard → Providers → Connect GitHub
→ OAuth via GitHub
→ Monthly reset (1st of month)

Models:
  gh/gpt-5
  gh/claude-4.5-sonnet
  gh/gemini-3.1-pro-preview

🔑 Provedores de chaves de API

### NVIDIA NIM (FREE developer access — 70+ models)

Cadastre-se: build.nvidia.com
Obtenha uma chave de API gratuita (1.000 créditos de inferência incluídos)
Painel → Adicionar Provedor → NVIDIA NIM:
- Chave API: nvapi-sua-chave

Modelos:nvidia/llama-3.3-70b-instruct, nvidia/mistral-7b-instruct e mais de 50

**Dica profissional:**API compatível com OpenAI — funciona perfeitamente com a tradução de formato do OmniRoute!### DeepSeek

Cadastre-se: platform.deepseek.com
Obtenha a chave API
Painel → Adicionar provedor → DeepSeek

Modelos:deepseek/deepseek-chat, deepseek/deepseek-coder### Groq (Free Tier Available!)

Cadastre-se: console.groq.com
Obtenha a chave API (nível gratuito incluído)
Painel → Adicionar Provedor → Groq

Modelos:groq/llama-3.3-70b, groq/mixtral-8x7b

**Dica profissional:**Inferência ultrarrápida — melhor para codificação em tempo real!### OpenRouter (100+ Models)

Cadastre-se: openrouter.ai
Obtenha a chave API
Painel → Adicionar Provedor → OpenRouter

**Modelos:**acesse mais de 100 modelos de todos os principais fornecedores por meio de uma única chave de API.

Comportamento do painel:os modelos do OpenRouter são gerenciados a partir deModelos disponíveis. Adição manual, importação e sincronização automática atualizam a mesma lista.

💰 Provedores baratos (backup)

### GLM-4.7 (Daily reset, $0.6/1M)

Inscreva-se: Zhipu AI
Obtenha a chave API do plano de codificação
Painel → Adicionar chave API:
- Provedor: glm
- Chave API: sua-chave

Usar:glm/glm-4.7

**Dica profissional:**O plano de codificação oferece cota 3× com custo de 1/7! Redefinir diariamente às 10h.### MiniMax M2.1 (5h reset, $0.20/1M)

Cadastre-se: MiniMax
Obtenha a chave API
Painel → Adicionar chave API

Usar:minimax/MiniMax-M2.1

**Dica profissional:**Opção mais barata para contexto longo (1 milhão de tokens)!### Kimi K2 ($9/month flat)

Inscreva-se: Moonshot AI
Obtenha a chave API
Painel → Adicionar chave API

Usar:kimi/kimi-latest

Dica profissional:$9 fixos/mês para 10 milhões de tokens = $0,90/custo efetivo de 1 milhão!

🆓 Provedores GRATUITOS (backup de emergência)

### Qoder (5 FREE models via OAuth)

Dashboard → Connect Qoder
→ Qoder OAuth login
→ Unlimited usage

Models:
  if/kimi-k2-thinking
  if/qwen3-coder-plus
  if/glm-4.7
  if/minimax-m2
  if/deepseek-r1

Qwen (4 FREE models via Device Code)

Dashboard → Connect Qwen
→ Device code authorization
→ Unlimited usage

Models:
  qw/qwen3-coder-plus
  qw/qwen3-coder-flash

Kiro (Claude FREE)

Dashboard → Connect Kiro
→ AWS Builder ID or Google/GitHub
→ Unlimited usage

Models:
  kr/claude-sonnet-4.5
  kr/claude-haiku-4.5

🎨 Criar Combos

### Example 1: Maximize Subscription → Cheap Backup

Dashboard → Combos → Create New

Name: premium-coding
Models:
  1. cc/claude-opus-4-6 (Subscription primary)
  2. glm/glm-4.7 (Cheap backup, $0.6/1M)
  3. minimax/MiniMax-M2.1 (Cheapest fallback, $0.20/1M)

Use in CLI: premium-coding

Example 2: Free-Only (Zero Cost)

Name: free-combo
Models:
  1. gc/gemini-3-flash-preview (180K free/month)
  2. if/kimi-k2-thinking (unlimited)
  3. qw/qwen3-coder-plus (unlimited)

Cost: $0 forever!

🔧 Integração CLI

### Cursor IDE

Settings → Models → Advanced:
  OpenAI API Base URL: http://localhost:20128/v1
  OpenAI API Key: [from OmniRoute dashboard]
  Model: cc/claude-opus-4-6

Claude Code

Use a páginaFerramentas CLIno painel para configuração com um clique ou edite ~/.claude/settings.json manualmente.### Codex CLI

export OPENAI_BASE_URL="http://localhost:20128"
export OPENAI_API_KEY="your-omniroute-api-key"

codex "your prompt"

OpenClaw

Opção 1 — Painel (recomendado):``` Dashboard → CLI Tools → OpenClaw → Select Model → Apply


**Opção 2 — Manual:**Edite `~/.openclaw/openclaw.json`:```json
{
  "models": {
    "providers": {
      "omniroute": {
        "baseUrl": "http://127.0.0.1:20128/v1",
        "apiKey": "sk_omniroute",
        "api": "openai-completions"
      }
    }
  }
}

**Observação:**OpenClaw só funciona com OmniRoute local. Use 127.0.0.1 em vez de localhost para evitar problemas de resolução IPv6.### Cline / Continue / RooCode

Settings → API Configuration:
  Provider: OpenAI Compatible
  Base URL: http://localhost:20128/v1
  API Key: [from OmniRoute dashboard]
  Model: if/kimi-k2-thinking

OpenCode

**Etapa 1:**Adicione OmniRoute como um provedor personalizado:```bash opencode /connect

Select "Other" → Enter ID: "omniroute" → Enter your OmniRoute API key


**Etapa 2:**Crie/edite `opencode.json` na raiz do seu projeto:```json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "omniroute": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "OmniRoute",
      "options": {
        "baseURL": "http://localhost:20128/v1"
      },
      "models": {
        "cc/claude-sonnet-4-20250514": { "name": "Claude Sonnet 4" },
        "gg/gemini-2.5-pro": { "name": "Gemini 2.5 Pro" },
        "if/kimi-k2-thinking": { "name": "Kimi K2 (Free)" }
      }
    }
  }
}

**Etapa 3:**Selecione o modelo no OpenCode:```bash /models

Select any OmniRoute model from the list


>**Dica:**Adicione qualquer modelo disponível no endpoint `/v1/models` do OmniRoute à seção `models`. Use o formato `provider/model-id` do painel do OmniRoute.</details>

---

## Resolução de Problemas

<detalhes>
<summary><b>Clique para expandir o guia de solução de problemas</b></summary>

**"O modelo de linguagem não forneceu mensagens"**

- Cota do provedor esgotada → Verifique o rastreador de cota do painel
- Solução: use o combo substituto ou mude para um nível mais barato

**Limitação de taxa**

- Cota de assinatura esgotada → Fallback para GLM/MiniMax
- Adicionar combo: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`

**O token OAuth expirou**

- Atualizado automaticamente pelo OmniRoute
- Se os problemas persistirem: Painel → Provedor → Reconectar

**Custos elevados**

- Verifique as estatísticas de uso em Painel → Custos
- Mude o modelo primário para GLM/MiniMax
- Use o nível gratuito (Gemini CLI, Qoder) para tarefas não críticas

**As portas do painel/API estão erradas**

- `PORT` é a porta base canônica (e porta API por padrão)
- `API_PORT` substitui apenas o ouvinte de API compatível com OpenAI
- `DASHBOARD_PORT` substitui apenas o ouvinte dashboard/Next.js
- Defina `NEXT_PUBLIC_BASE_URL` como seu painel/URL público (para retornos de chamada OAuth)

**Erros de sincronização na nuvem**

- Verifique se `BASE_URL` aponta para sua instância em execução
- Verifique os pontos `CLOUD_URL` para o endpoint de nuvem esperado
- Mantenha os valores `NEXT_PUBLIC_*` alinhados com os valores do lado do servidor

**Primeiro login não funciona**

- Verifique `INITIAL_PASSWORD` em `.env`
- Se não definida, a senha substituta é `123456`

**Sem registros de solicitação**

- Os artefatos de solicitação são gravados em `DATA_DIR/call_logs/` como um arquivo JSON por solicitação
- Habilite a captura de pipeline em Painel → Logs → Solicitar logs se precisar de cargas úteis detalhadas por estágio
- Defina `APP_LOG_TO_FILE=true` se você também deseja logs do console do aplicativo em `logs/application/app.log`
- Ajuste `APP_LOG_MAX_FILE_SIZE`, `APP_LOG_RETENTION_DAYS`, `APP_LOG_MAX_FILES` e `CALL_LOG_MAX_ENTRIES` conforme necessário

**O teste de conexão mostra "Inválido" para provedores compatíveis com OpenAI**

- Muitos provedores não expõem um endpoint `/models`
- OmniRoute v1.0.6+ inclui validação de fallback por meio de conclusões de chat
- Certifique-se de que o URL base inclua o sufixo `/v1`### 🔐 OAuth on a Remote Server

<a name="oauth-on-a-remote-server"></a>
<a name="oauth-em-servidor-remoto"></a>

>**⚠️ Importante para usuários executando OmniRoute em um VPS, Docker ou qualquer servidor remoto**#### Why does Antigravity / Gemini CLI OAuth fail on remote servers?

Os provedores**Antigravity**e**Gemini CLI**usam o**Google OAuth 2.0**. O Google exige que `redirect_uri` no fluxo OAuth corresponda exatamente a um dos URIs pré-registrados no Google Cloud Console do aplicativo.

As credenciais OAuth incluídas no OmniRoute são registradas**apenas para `localhost`**. Quando você acessa o OmniRoute em um servidor remoto (por exemplo, `https://omniroute.myserver.com`), o Google rejeita a autenticação com:```
Error 400: redirect_uri_mismatch

Solution: Configure your own OAuth credentials

Você precisa criar umID do cliente OAuth 2.0no Console do Google Cloud com o URI do seu servidor.#### Step-by-step

1. Abra o Console do Google Cloud

Acesse: https://console.cloud.google.com/apis/credentials

2. Crie um novo ID de cliente OAuth 2.0

Clique em**"+ Criar credenciais"→"ID do cliente OAuth"**
Tipo de aplicativo:"Aplicativo Web"
Nome: o que você quiser (por exemplo, OmniRoute Remote)

3. Adicionar URIs de redirecionamento autorizados

No campo**"URIs de redirecionamento autorizados"**, adicione:``` https://your-server.com/callback


> Substitua `your-server.com` pelo domínio ou IP do seu servidor (inclua a porta se necessário, por exemplo, `http://45.33.32.156:20128/callback`).

**4. Salve e copie as credenciais**

Após a criação, o Google mostrará o**ID do cliente**e o**Segredo do cliente**.

**5. Definir variáveis de ambiente**

No seu `.env` (ou variáveis de ambiente do Docker):```bash
# For Antigravity:
ANTIGRAVITY_OAUTH_CLIENT_ID=your-client-id.apps.googleusercontent.com
ANTIGRAVITY_OAUTH_CLIENT_SECRET=GOCSPX-your-secret

# For Gemini CLI:
GEMINI_OAUTH_CLIENT_ID=your-client-id.apps.googleusercontent.com
GEMINI_OAUTH_CLIENT_SECRET=GOCSPX-your-secret
GEMINI_CLI_OAUTH_CLIENT_SECRET=GOCSPX-your-secret

6. Reinicie o OmniRoute```bash

npm:

npm run dev

Docker:

docker restart omniroute


**7. Tente conectar novamente**

Painel → Provedores → Antigravidade (ou Gemini CLI) → OAuth

O Google agora redirecionará corretamente para `https://your-server.com/callback`.---

#### Temporary workaround (without custom credentials)

Se não quiser configurar suas próprias credenciais agora, você ainda pode usar o**fluxo manual de URL**:

1. OmniRoute abre o URL de autorização do Google
2. Após autorização, o Google tenta redirecionar para `localhost` (que falha no servidor remoto)
3.**Copie o URL completo**da barra de endereço do seu navegador (mesmo que a página não carregue)
4. Cole esse URL no campo mostrado no modal de conexão OmniRoute
5. Clique em**"Conectar"**

> Isso funciona porque o código de autorização no URL é válido independentemente de a página de redirecionamento ter sido carregada.---

<detalhes>
<summary><b>🇧🇷 Versão em Português</b></summary>#### Por que o OAuth do Antigravity / Gemini CLI falha em servidores remotos?

Os provedores**Antigravity**e**Gemini CLI**usam**Google OAuth 2.0**para autenticação. O Google exige que um `redirect_uri` usado no fluxo OAuth seja**exatamente**uma das URIs pré-cadastradas no Google Cloud Console do aplicativo.

As credenciais OAuth incorporadas no OmniRoute estão cadastradas**apenas para `localhost`**. Quando você acessa o OmniRoute em um servidor remoto (ex: `https://omniroute.meuservidor.com`), o Google rejeita a autenticação com:```
Error 400: redirect_uri_mismatch

Solução: Configure suas próprias credenciais OAuth

Você precisa criar umOAuth 2.0 Client IDno Google Cloud Console com o URI do seu servidor.#### Passo a passo

1. Acesse o Console do Google Cloud

Abra: https://console.cloud.google.com/apis/credentials

2. Crie um novo ID de cliente OAuth 2.0

Clique em**"+ Criar credenciais"→"ID do cliente OAuth"**
Tipo de aplicativo:"Aplicativo Web"
Nome: escolha qualquer nome (ex: OmniRoute Remote)

3. Adicionar como URIs de redirecionamento autorizados

No campo**"URIs de redirecionamento autorizados"**, adicionado:``` https://seu-servidor.com/callback


> Substitua `seu-servidor.com` pelo domínio ou IP do seu servidor (inclua a porta se necessário, ex: `http://45.33.32.156:20128/callback`).

**4. Salve e copie as credenciais**

Após criar, o Google mostrará o**Client ID**e o**Client Secret**.

**5. Configurar como variáveis de ambiente**

No seu `.env` (ou nas variáveis de ambiente do Docker):```bash
# Para Antigravity:
ANTIGRAVITY_OAUTH_CLIENT_ID=seu-client-id.apps.googleusercontent.com
ANTIGRAVITY_OAUTH_CLIENT_SECRET=GOCSPX-seu-secret

# Para Gemini CLI:
GEMINI_OAUTH_CLIENT_ID=seu-client-id.apps.googleusercontent.com
GEMINI_OAUTH_CLIENT_SECRET=GOCSPX-seu-secret
GEMINI_CLI_OAUTH_CLIENT_SECRET=GOCSPX-seu-secret

6. Reinicie o OmniRoute```bash

Se usando npm:

npm run dev

Se usando Docker:

docker restart omniroute


**7. Tente conectar novamente**

Painel → Provedores → Antigravidade (ou Gemini CLI) → OAuth

Agora o Google redirecionará corretamente para `https://seu-servidor.com/callback` e a autenticação funcionará.---

#### Workaround temporário (sem configurar credenciais próprias)

Se não quiser criar credenciais próprias agora, ainda é possível usar o fluxo**manual de URL**:

1. O OmniRoute abrirá uma URL de autorização do Google
2. Após você autorizar, o Google tentará redirecionar para `localhost` (que falha no servidor remoto)
3.**Copie a URL completa**da barra de endereço do seu navegador (mesmo que a página não carregue)
4. Cole essa URL no campo que aparece no modal de conexão do OmniRoute
5. Clique em**"Conectar"**

> Esta solução alternativa funciona porque o código de autorização na URL é válido, independentemente do redirecionamento ter sido carregado ou não.</details>

---

</details>

## 🛠️ Tech Stack

<detalhes>
<summary><b>Clique para expandir os detalhes da pilha de tecnologia</b></summary>

-**Tempo de execução**: Node.js 18–22 LTS (⚠️ Node.js 24+**não é compatível**— binários nativos `better-sqlite3` são incompatíveis)
-**Idioma**: TypeScript 5.9 —**100% TypeScript**em `src/` e `open-sse/` (zero `any` nos módulos principais desde a v2.0)
-**Estrutura**: Next.js 16 + React 19 + Tailwind CSS 4
-**Banco de dados**: LowDB (JSON) + SQLite (estado do domínio + logs de proxy + auditoria MCP + decisões de roteamento)
-**Esquemas**: Zod (validação de E/S da ferramenta MCP, contratos de API)
-**Protocolos**: MCP (stdio/HTTP) + A2A v0.3 (JSON-RPC 2.0 + SSE)
-**Streaming**: eventos enviados pelo servidor (SSE)
-**Auth**: OAuth 2.0 (PKCE) + JWT + Chaves de API + Autorização com escopo MCP
-**Testes**: executor de testes Node.js + Vitest (mais de 900 testes incluindo unidade, integração, E2E)
-**CI/CD**: GitHub Actions (publicação automática de npm + Docker Hub no lançamento)
-**Site**: [omniroute.online](https://omniroute.online)
-**Pacote**: [npmjs.com/package/omniroute](https://www.npmjs.com/package/omniroute)
-**Docker**: [hub.docker.com/r/diegosouzapw/omniroute](https://hub.docker.com/r/diegosouzapw/omniroute)
-**Resiliência**: Disjuntor, espera exponencial, rebanho anti-trovão, falsificação de TLS, autocura de combinação automática</details>

---

## Documentação

| Documento | Descrição |
| -------------------------------------------------------- | --------------------------------------------------- |
| [Guia do usuário](docs/USER_GUIDE.md) | Provedores, combos, integração CLI, implantação |
| [Referência de API](docs/API_REFERENCE.md) | Todos os endpoints com exemplos |
| [Servidor MCP](open-sse/mcp-server/README.md) | 16 ferramentas MCP, configurações IDE, clientes Python/TS/Go |
| [Servidor A2A](src/lib/a2a/README.md) | Protocolo JSON-RPC 2.0, habilidades, streaming, gerenciamento de tarefas |
| [Mecanismo de combinação automática](docs/auto-combo.md) | Pontuação de 6 fatores, pacotes de modos, autocura |
| [Solução de problemas](docs/TROUBLESHOOTING.md) | Problemas e soluções comuns |
| [Arquitetura](docs/ARCHITECTURE.md) | Arquitetura do sistema e componentes internos |
| [Contribuindo](CONTRIBUTING.md) | Configuração e diretrizes de desenvolvimento |
| [Especificações OpenAPI](docs/openapi.yaml) | Especificação OpenAPI 3.0 |
| [Política de Segurança](SECURITY.md) | Relatórios de vulnerabilidades e práticas de segurança |
| [Implantação de VM](docs/VM_DEPLOYMENT_GUIDE.md) | Guia completo: configuração de VM + nginx + Cloudflare |
| [Galeria de recursos](docs/FEATURES.md) | Tour visual do painel com capturas de tela |
| [Lista de verificação de lançamento](docs/RELEASE_CHECKLIST.md) | Etapas de validação de pré-lançamento |---

## 🗺️ Roadmap

OmniRoute tem**210+ recursos planejados**em diversas fases de desenvolvimento. Aqui estão as principais áreas:

| Categoria | Recursos planejados | Destaques |
| ----------------------------- | ---------------- | -------------------------------------------------------------------------------------- |
| 🧠**Roteamento e Inteligência**| 25+ | Roteamento de menor latência, roteamento baseado em tags, simulação de cota, seleção de conta P2C |
| 🔒**Segurança e Conformidade**| 20+ | Proteção SSRF, camuflagem de credenciais, limite de taxa por endpoint, escopo de chave de gerenciamento |
| 📊**Observabilidade**| 15+ | Integração OpenTelemetry, monitoramento de cotas em tempo real, rastreamento de custos por modelo |
| 🔄**Integrações com Provedores**| 20+ | Registro de modelo dinâmico, resfriamento de provedor, Codex multicontas, análise de cotas do Copilot |
| ⚡**Desempenho**| 15+ | Camada de cache dupla, cache de prompt, cache de resposta, manutenção de atividade de streaming, API em lote |
| 🌐**Ecossistema**| 10+ | API WebSocket, configuração hot-reload, armazenamento de configuração distribuído, modo comercial |### 🔜 Coming Soon

- 🔗**Integração OpenCode**— Suporte de provedor nativo para o IDE de codificação OpenCode AI
- 🔗**Integração TRAE**— Suporte total para a estrutura de desenvolvimento TRAE AI
- 📦**API Batch**— Processamento assíncrono em lote para solicitações em massa
- 🎯**Roteamento baseado em tags**— Roteie solicitações com base em tags personalizadas e metadados
- 💰**Estratégia de custo mais baixo**— Selecione automaticamente o provedor mais barato disponível

> 📝 Especificações completas de recursos disponíveis em [`docs/new-features/`](docs/new-features/) (217 especificações detalhadas)---

## 👥 Contributors

[![Contributors](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=100&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)

### How to Contribute

1. Bifurque o repositório
2. Crie seu branch de recursos (`git checkout -b feature/amazing-feature`)
3. Confirme suas alterações (`git commit -m 'Adicionar recurso incrível'`)
4. Envie para o branch (`git push origin feature/amazing-feature`)
5. Abra uma solicitação pull

Consulte [CONTRIBUTING.md](CONTRIBUTING.md) para obter diretrizes detalhadas.### Releasing a New Version

```bash
# Create a release — npm publish happens automatically
gh release create v2.0.0 --title "v2.0.0" --generate-notes

📊 Star History

Stargazers over time

🙏 Acknowledgments

Agradecimentos especiais a**9routerdedecolua**— o projeto original que inspirou este fork. OmniRoute se baseia nessa base incrível com recursos adicionais, APIs multimodais e uma reescrita completa do TypeScript.

Agradecimentos especiais a**CLIProxyAPI**— a implementação Go original que inspirou esta versão JavaScript.---

Licença

Licença MIT - consulte LICENSE para obter detalhes.---

_{Built with ❤️ for developers who code 24/7}
_{omniroute.online}

README.md Unescape Escape

🚀 OmniRoute — The Free AI Gateway (Português (Portugal))

Never stop coding. Smart routing to FREE & low-cost AI models with automatic fallback.

🖼️ Main Dashboard

📸 Dashboard Preview

🤖 Free AI Provider for your favorite coding agents

🤔 Why OmniRoute?

📧 Support

API: http://localhost:20128/v1

Dashboard: http://localhost:20129

5) Validate everything end-to-end (recommended)

Template file for 'omniroute'

Copy and edit .env first

System Tray

💰 Pricing at a Glance

🆓 Ultimate Free Stack 2026 — 11 Providers, $0 Forever

Smart fallback with practical cost control

📖 Setup Guide

Protocol Setup (MCP + A2A)

Codex Account Limit Management (5h + Weekly)

Qwen (4 FREE models via Device Code)

Kiro (Claude FREE)

Example 2: Free-Only (Zero Cost)

Claude Code

OpenClaw

OpenCode

Select "Other" → Enter ID: "omniroute" → Enter your OmniRoute API key

Select any OmniRoute model from the list

Solution: Configure your own OAuth credentials

npm:

Docker:

Solução: Configure suas próprias credenciais OAuth

Se usando npm:

Se usando Docker:

📊 Star History

Stargazers over time

🙏 Acknowledgments

Licença

README.md