Skip to content

Latest commit

 

History

History
1053 lines (763 loc) · 39.8 KB

README.pt-BR.md

File metadata and controls

1053 lines (763 loc) · 39.8 KB
OmniRoute Dashboard

🚀 OmniRoute — O Gateway de IA Gratuito

Nunca pare de programar. Roteamento inteligente para modelos de IA GRATUITOS e baratos com fallback automático.

Seu proxy de API universal — um endpoint, 36+ provedores, zero tempo de inatividade.

Chat Completions • Embeddings • Geração de Imagem • Áudio • Reranking • 100% TypeScript

🤖 Provedor de IA Gratuito para seus agentes de programação favoritos

Conecte qualquer IDE ou ferramenta CLI com IA através do OmniRoute — gateway de API gratuito para programação ilimitada.

OpenClaw
OpenClaw
⭐ 205K 		NanoBot
NanoBot
⭐ 20.9K 		PicoClaw
PicoClaw
⭐ 14.6K 		ZeroClaw
ZeroClaw
⭐ 9.9K 		IronClaw
IronClaw
⭐ 2.1K
OpenCode
OpenCode
⭐ 106K 		Codex CLI
Codex CLI
⭐ 60.8K 		Claude Code
Claude Code
⭐ 67.3K 		Gemini CLI
Gemini CLI
⭐ 94.7K 		Kilo Code
Kilo Code
⭐ 15.5K

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

npm version Docker Hub License Website WhatsApp

🌐 Website • 🚀 Início Rápido • 💡 Funcionalidades • 📖 Docs • 💰 Preços

🌐 Disponível em: English | Português | Español | Русский | 中文 | Deutsch | Français | Italiano

🤔 Por que OmniRoute?

Pare de desperdiçar dinheiro e bater em limites:

  • Cota de assinatura expira sem uso todo mês
  • Limites de taxa param você no meio da programação
  • APIs caras ($20-50/mês por provedor)
  • Trocar manualmente entre provedores

OmniRoute resolve isso:

  • ✅ Maximize assinaturas - Rastreie cotas, use tudo antes do reset
  • ✅ Fallback automático - Assinatura → API Key → Barato → Gratuito, zero tempo de inatividade
  • ✅ Multi-conta - Round-robin entre contas por provedor
  • ✅ Universal - Funciona com Claude Code, Codex, Gemini CLI, Cursor, Cline, OpenClaw, qualquer ferramenta CLI

🔄 Como Funciona

┌─────────────┐
│  Sua CLI    │  (Claude Code, Codex, Gemini CLI, OpenClaw, Cursor, Cline...)
│   Tool      │
└──────┬──────┘
       │ http://localhost:20128/v1
       ↓
┌─────────────────────────────────────────┐
│           OmniRoute (Roteador Inteligente) │
│  • Tradução de formato (OpenAI ↔ Claude) │
│  • Rastreamento de cota + Embeddings + Imagens │
│  • Renovação automática de tokens        │
└──────┬──────────────────────────────────┘
       │
       ├─→ [Tier 1: ASSINATURA] Claude Code, Codex, Gemini CLI
       │   ↓ cota esgotada
       ├─→ [Tier 2: API KEY] DeepSeek, Groq, xAI, Mistral, NVIDIA NIM, etc.
       │   ↓ limite de orçamento
       ├─→ [Tier 3: BARATO] GLM ($0.6/1M), MiniMax ($0.2/1M)
       │   ↓ limite de orçamento
       └─→ [Tier 4: GRATUITO] iFlow, Qwen, Kiro (ilimitado)

Resultado: Nunca pare de programar, custo mínimo

⚡ Início Rápido

1. Instale globalmente:

npm install -g omniroute
omniroute

🎉 Dashboard abre em http://localhost:20128

Comando Descrição
omniroute Iniciar servidor (porta padrão 20128)
omniroute --port 3000 Usar porta personalizada
omniroute --no-open Não abrir navegador automaticamente
omniroute --help Mostrar ajuda

2. Conecte um provedor GRATUITO:

Dashboard → Provedores → Conectar Claude Code ou Antigravity → Login OAuth → Pronto!

3. Use na sua ferramenta CLI:

Claude Code/Codex/Gemini CLI/OpenClaw/Cursor/Cline Configurações:
  Endpoint: http://localhost:20128/v1
  API Key: [copie do dashboard]
  Model: if/kimi-k2-thinking

Pronto! Comece a programar com modelos de IA GRATUITOS.

Alternativa — rodar a partir do código-fonte:

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

🐳 Docker

OmniRoute está disponível como imagem Docker pública no Docker Hub.

Execução rápida:

docker run -d \
  --name omniroute \
  --restart unless-stopped \
  -p 20128:20128 \
  -v omniroute-data:/app/data \
  diegosouzapw/omniroute:latest

Com arquivo de ambiente:

# Copie e edite o .env primeiro
cp .env.example .env

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

Usando Docker Compose:

# Perfil base (sem ferramentas CLI)
docker compose --profile base up -d

# Perfil CLI (Claude Code, Codex, OpenClaw integrados)
docker compose --profile cli up -d
Imagem Tag Tamanho Descrição
diegosouzapw/omniroute latest ~250MB Última versão estável
diegosouzapw/omniroute 1.0.6 ~250MB Versão atual

💰 Preços Resumidos

Tier Provedor Custo Reset de Cota Melhor Para
💳 ASSINATURA Claude Code (Pro) $20/mês 5h + semanal Já é assinante
Codex (Plus/Pro) $20-200/mês 5h + semanal Usuários OpenAI
Gemini CLI GRATUITO 180K/mês + 1K/dia Todos!
GitHub Copilot $10-19/mês Mensal Usuários GitHub
🔑 API KEY NVIDIA NIM GRATUITO (1000 créditos) Único Testes gratuitos
DeepSeek Por uso Nenhum Melhor preço/qualidade
Groq Tier gratuito + pago Limitado Inferência ultra-rápida
xAI (Grok) Por uso Nenhum Modelos Grok
Mistral Tier gratuito + pago Limitado IA Europeia
OpenRouter Por uso Nenhum 100+ modelos
💰 BARATO GLM-4.7 $0.6/1M Diário 10h Backup econômico
MiniMax M2.1 $0.2/1M Rotativo 5h Opção mais barata
Kimi K2 $9/mês fixo 10M tokens/mês Custo previsível
🆓 GRATUITO iFlow $0 Ilimitado 8 modelos gratuitos
Qwen $0 Ilimitado 3 modelos gratuitos
Kiro $0 Ilimitado Claude gratuito

💡 Dica Pro: Comece com Gemini CLI (180K grátis/mês) + iFlow (ilimitado grátis) = $0 de custo!

🎯 Casos de Uso

Caso 1: "Tenho assinatura Claude Pro"

Problema: Cota expira sem uso, limites de taxa durante programação intensa

Combo: "maximize-claude"
  1. cc/claude-opus-4-6        (usar assinatura ao máximo)
  2. glm/glm-4.7               (backup barato quando a cota acabar)
  3. if/kimi-k2-thinking       (fallback de emergência gratuito)

Custo mensal: $20 (assinatura) + ~$5 (backup) = $25 total
vs. $20 + bater em limites = frustração

Caso 2: "Quero custo zero"

Problema: Não pode pagar assinaturas, precisa de IA confiável para programar

Combo: "free-forever"
  1. gc/gemini-3-flash         (180K grátis/mês)
  2. if/kimi-k2-thinking       (ilimitado grátis)
  3. qw/qwen3-coder-plus       (ilimitado grátis)

Custo mensal: $0
Qualidade: Modelos prontos para produção

Caso 3: "Preciso programar 24/7, sem interrupções"

Problema: Prazos apertados, não pode ter tempo de inatividade

Combo: "always-on"
  1. cc/claude-opus-4-6        (melhor qualidade)
  2. cx/gpt-5.2-codex          (segunda assinatura)
  3. glm/glm-4.7               (barato, reset diário)
  4. minimax/MiniMax-M2.1      (mais barato, reset 5h)
  5. if/kimi-k2-thinking       (gratuito ilimitado)

Resultado: 5 camadas de fallback = zero tempo de inatividade

Caso 4: "Quero IA GRATUITA no OpenClaw"

Problema: Precisa de assistente de IA em aplicativos de mensagens, completamente gratuito

Combo: "openclaw-free"
  1. if/glm-4.7                (ilimitado grátis)
  2. if/minimax-m2.1           (ilimitado grátis)
  3. if/kimi-k2-thinking       (ilimitado grátis)

Custo mensal: $0
Acesso via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...

💡 Funcionalidades Principais

🧠 Roteamento e Inteligência

Funcionalidade O que Faz
🎯 Fallback Inteligente 4 Tiers Auto-roteamento: Assinatura → API Key → Barato → Gratuito
📊 Rastreamento de Cota em Tempo Real Contagem de tokens ao vivo + countdown de reset por provedor
🔄 Tradução de Formato OpenAI ↔ Claude ↔ Gemini ↔ Cursor ↔ Kiro transparente
👥 Suporte Multi-Conta Múltiplas contas por provedor com seleção inteligente
🔄 Renovação Automática de Token Tokens OAuth renovam automaticamente com retry
🎨 Combos Personalizados 6 estratégias: fill-first, round-robin, p2c, random, least-used, cost-optimized
🧩 Modelos Personalizados Adicione qualquer ID de modelo a qualquer provedor
🌐 Roteador Wildcard Roteie padrões provider/* para qualquer provedor dinamicamente
🧠 Budget de Raciocínio Modos passthrough, auto, custom e adaptativo para modelos de raciocínio
💬 Injeção de System Prompt System prompt global aplicado em todas as requisições
📄 API Responses Suporte completo à API Responses da OpenAI (/v1/responses) para Codex

🎵 APIs Multi-Modal

Funcionalidade O que Faz
🖼️ Geração de Imagem /v1/images/generations — 4 provedores, 9+ modelos
📐 Embeddings /v1/embeddings — 6 provedores, 9+ modelos
🎤 Transcrição de Áudio /v1/audio/transcriptions — Compatível com Whisper
🔊 Texto para Fala /v1/audio/speech — Síntese de áudio multi-provedor
🛡️ Moderações /v1/moderations — Verificações de segurança
🔀 Reranking /v1/rerank — Reranking de relevância de documentos

🛡️ Resiliência e Segurança

Funcionalidade O que Faz
🔌 Circuit Breaker Auto-abertura/fechamento por provedor com limites configuráveis
🛡️ Anti-Thundering Herd Mutex + semáforo rate-limit para provedores com API key
🧠 Cache Semântico Cache de duas camadas (assinatura + semântico) reduz custo e latência
⚡ Idempotência de Requisição Janela de dedup de 5s para requisições duplicadas
🔒 Spoofing de Fingerprint TLS Bypass de detecção de bot via TLS com wreq-js
🌐 Filtragem de IP Allowlist/blocklist para controle de acesso à API
📊 Rate Limits Editáveis RPM, gap mínimo e concorrência máxima configuráveis
🛡 Proteção de Endpoint API Gateway de Auth + bloqueio de provedores para o endpoint /models

📊 Observabilidade e Analytics

Funcionalidade O que Faz
📝 Logs de Requisição Modo debug com logs completos de request/response
💾 Logs SQLite Logs de proxy persistentes sobrevivem a reinicializações
📊 Dashboard de Analytics Recharts: cards de estatísticas, gráfico de uso, tabela de provedores
📈 Rastreamento de Progresso Eventos de progresso SSE opt-in para streaming
🧪 Avaliações de LLM Testes com conjunto golden e 4 estratégias de match
🔍 Telemetria de Requisição Agregação de latência p50/p95/p99 + rastreamento X-Request-Id
📋 Logs + Cotas Páginas dedicadas para navegação de logs e rastreamento de cotas
🏥 Dashboard de Saúde Uptime, estados de circuit breaker, lockouts, stats de cache
💰 Rastreamento de Custo Gestão de orçamento + configuração de preços por modelo

☁️ Deploy e Sincronização

Funcionalidade O que Faz
💾 Cloud Sync Sincronize configurações entre dispositivos via Cloudflare Workers
🌐 Deploy em Qualquer Lugar Localhost, VPS, Docker, Cloudflare Workers
🔑 Gestão de API Keys Gere, rotacione e defina escopo de API keys por provedor
🧙 Assistente de Configuração Setup guiado em 4 etapas para novos usuários
🔧 Dashboard CLI Tools Configuração em um clique para Claude, Codex, Cline, OpenClaw, Kilo, Antigravity
🔄 Backups de DB Backup, restauração, exportação e importação automática de todas as configurações
📖 Detalhes das Funcionalidades

🎯 Fallback Inteligente 4 Tiers

Crie combos com fallback automático:

Combo: "my-coding-stack"
  1. cc/claude-opus-4-6        (sua assinatura)
  2. nvidia/llama-3.3-70b      (API NVIDIA gratuita)
  3. glm/glm-4.7               (backup barato, $0.6/1M)
  4. if/kimi-k2-thinking       (fallback gratuito)

→ Troca automaticamente quando a cota acaba ou erros ocorrem

📊 Rastreamento de Cota em Tempo Real

  • Consumo de tokens por provedor
  • Countdown de reset (5 horas, diário, semanal)
  • Estimativa de custo para tiers pagos
  • Relatórios de gastos mensais

🔄 Tradução de Formato

Tradução transparente entre formatos:

  • OpenAI ↔ Claude ↔ Gemini ↔ OpenAI Responses
  • Sua ferramenta CLI envia formato OpenAI → OmniRoute traduz → Provedor recebe formato nativo
  • Funciona com qualquer ferramenta que suporte endpoints OpenAI customizados

👥 Suporte Multi-Conta

  • Adicione múltiplas contas por provedor
  • Round-robin automático ou roteamento por prioridade
  • Fallback para próxima conta quando uma atinge a cota

🔄 Renovação Automática de Token

  • Tokens OAuth renovam automaticamente antes de expirar
  • Sem necessidade de re-autenticação manual
  • Experiência transparente em todos os provedores

🎨 Combos Personalizados

  • Crie combinações ilimitadas de modelos
  • 6 estratégias: fill-first, round-robin, power-of-two-choices, random, least-used, cost-optimized
  • Compartilhe combos entre dispositivos com Cloud Sync

🏥 Dashboard de Saúde

  • Status do sistema (uptime, versão, uso de memória)
  • Estados de circuit breaker por provedor (Closed/Open/Half-Open)
  • Status de rate limit e lockouts ativos
  • Estatísticas de cache de assinatura
  • Telemetria de latência (p50/p95/p99) + cache de prompt
  • Reset de saúde com um clique

🔧 Playground do Tradutor

O OmniRoute inclui um poderoso Playground de Tradução integrado com 4 modos para debug, teste e monitoramento de traduções de API:

Modo Descrição
💻 Playground Tradução direta entre formatos — cole qualquer corpo de requisição e veja instantaneamente como o OmniRoute traduz entre formatos (OpenAI ↔ Claude ↔ Gemini ↔ Responses API). Inclui templates de exemplo e auto-detecção de formato.
💬 Chat Tester Envie requisições reais pelo OmniRoute e veja a viagem completa: sua entrada, a requisição traduzida, a resposta do provedor, e a resposta traduzida de volta. Inestimável para validar roteamento de combos.
🧪 Test Bench Modo de teste em lote — defina múltiplos casos de teste com diferentes entradas e saídas esperadas, execute todos de uma vez, e compare resultados entre provedores e modelos.
📱 Live Monitor Monitoramento de requisições em tempo real — acompanhe requisições entrando conforme fluem pelo OmniRoute, veja traduções de formato acontecendo ao vivo, e identifique problemas instantaneamente.

Acesso: Dashboard → Translator (barra lateral)

💾 Cloud Sync

  • Sincronize provedores, combos e configurações entre dispositivos
  • Sincronização automática em background
  • Armazenamento criptografado seguro

📖 Guia de Configuração

💳 Provedores por Assinatura

Claude Code (Pro/Max)

Dashboard → Provedores → Conectar Claude Code
→ Login OAuth → Renovação automática de token
→ Rastreamento de cota 5h + semanal

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

Dica Pro: Use Opus para tarefas complexas, Sonnet para velocidade. OmniRoute rastreia cota por modelo!

OpenAI Codex (Plus/Pro)

Dashboard → Provedores → Conectar Codex
→ Login OAuth (porta 1455)
→ Reset 5h + semanal

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

Gemini CLI (GRATUITO 180K/mês!)

Dashboard → Provedores → Conectar Gemini CLI
→ Google OAuth
→ 180K completions/mês + 1K/dia

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

Melhor Valor: Tier gratuito enorme! Use antes dos tiers pagos.

GitHub Copilot

Dashboard → Provedores → Conectar GitHub
→ OAuth via GitHub
→ Reset mensal (1º do mês)

Modelos:
  gh/gpt-5
  gh/claude-4.5-sonnet
  gh/gemini-3-pro
🔑 Provedores por API Key

NVIDIA NIM (GRATUITO 1000 créditos!)

  1. Cadastre-se: build.nvidia.com
  2. Obtenha API key gratuita (1000 créditos de inferência incluídos)
  3. Dashboard → Adicionar Provedor → NVIDIA NIM:
    • API Key: nvapi-your-key

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

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

DeepSeek

  1. Cadastre-se: platform.deepseek.com
  2. Obtenha API key
  3. Dashboard → Adicionar Provedor → DeepSeek

Modelos: deepseek/deepseek-chat, deepseek/deepseek-coder

Groq (Tier Gratuito Disponível!)

  1. Cadastre-se: console.groq.com
  2. Obtenha API key (tier gratuito incluído)
  3. Dashboard → Adicionar Provedor → Groq

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

Dica Pro: Inferência ultra-rápida — melhor para programação em tempo real!

OpenRouter (100+ Modelos)

  1. Cadastre-se: openrouter.ai
  2. Obtenha API key
  3. Dashboard → Adicionar Provedor → OpenRouter

Modelos: Acesse 100+ modelos de todos os principais provedores através de uma única API key.

💰 Provedores Baratos (Backup)

GLM-4.7 (Reset diário, $0.6/1M)

  1. Cadastre-se: Zhipu AI
  2. Obtenha API key do Plano Coding
  3. Dashboard → Adicionar API Key:
    • Provedor: glm
    • API Key: your-key

Use: glm/glm-4.7

Dica Pro: Plano Coding oferece 3× cota a 1/7 do custo! Reset diário 10:00 AM.

MiniMax M2.1 (Reset 5h, $0.20/1M)

  1. Cadastre-se: MiniMax
  2. Obtenha API key
  3. Dashboard → Adicionar API Key

Use: minimax/MiniMax-M2.1

Dica Pro: Opção mais barata para contexto longo (1M tokens)!

Kimi K2 ($9/mês fixo)

  1. Assine: Moonshot AI
  2. Obtenha API key
  3. Dashboard → Adicionar API Key

Use: kimi/kimi-latest

Dica Pro: $9/mês fixo por 10M tokens = $0.90/1M de custo efetivo!

🆓 Provedores GRATUITOS (Backup de Emergência)

iFlow (8 modelos GRATUITOS)

Dashboard → Conectar iFlow
→ Login OAuth iFlow
→ Uso ilimitado

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

Qwen (3 modelos GRATUITOS)

Dashboard → Conectar Qwen
→ Autorização por código de dispositivo
→ Uso ilimitado

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

Kiro (Claude GRATUITO)

Dashboard → Conectar Kiro
→ AWS Builder ID ou Google/GitHub
→ Uso ilimitado

Modelos:
  kr/claude-sonnet-4.5
  kr/claude-haiku-4.5
🎨 Criar Combos

Exemplo 1: Maximizar Assinatura → Backup Barato

Dashboard → Combos → Criar Novo

Nome: premium-coding
Modelos:
  1. cc/claude-opus-4-6 (Assinatura primária)
  2. glm/glm-4.7 (Backup barato, $0.6/1M)
  3. minimax/MiniMax-M2.1 (Fallback mais barato, $0.20/1M)

Use na CLI: premium-coding

Exemplo 2: Somente Gratuito (Custo Zero)

Nome: free-combo
Modelos:
  1. gc/gemini-3-flash-preview (180K grátis/mês)
  2. if/kimi-k2-thinking (ilimitado)
  3. qw/qwen3-coder-plus (ilimitado)

Custo: $0 para sempre!
🔧 Integração CLI

Cursor IDE

Configurações → Modelos → Avançado:
  OpenAI API Base URL: http://localhost:20128/v1
  OpenAI API Key: [do dashboard OmniRoute]
  Model: cc/claude-opus-4-6

Claude Code

Use a página CLI Tools no dashboard para configuração em 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 — Dashboard (recomendado):

Dashboard → CLI Tools → OpenClaw → Selecionar Modelo → Aplicar

Opção 2 — Manual: Edite ~/.openclaw/openclaw.json:

{
  "models": {
    "providers": {
      "omniroute": {
        "baseUrl": "http://127.0.0.1:20128/v1",
        "apiKey": "sk_omniroute",
        "api": "openai-completions"
      }
    }
  }
}

Nota: OpenClaw funciona apenas com OmniRoute local. Use 127.0.0.1 em vez de localhost para evitar problemas de resolução IPv6.

Cline / Continue / RooCode

Configurações → Configuração de API:
  Provedor: OpenAI Compatible
  Base URL: http://localhost:20128/v1
  API Key: [do dashboard OmniRoute]
  Model: if/kimi-k2-thinking

📊 Modelos Disponíveis

Ver todos os modelos disponíveis

Claude Code (cc/) - Pro/Max:

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

Codex (cx/) - Plus/Pro:

  • cx/gpt-5.2-codex
  • cx/gpt-5.1-codex-max

Gemini CLI (gc/) - GRATUITO:

  • gc/gemini-3-flash-preview
  • gc/gemini-2.5-pro

GitHub Copilot (gh/):

  • gh/gpt-5
  • gh/claude-4.5-sonnet

NVIDIA NIM (nvidia/) - Créditos GRATUITOS:

  • nvidia/llama-3.3-70b-instruct
  • nvidia/mistral-7b-instruct
  • 50+ mais modelos em build.nvidia.com

GLM (glm/) - $0.6/1M:

  • glm/glm-4.7

MiniMax (minimax/) - $0.2/1M:

  • minimax/MiniMax-M2.1

iFlow (if/) - GRATUITO:

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

Qwen (qw/) - GRATUITO:

  • qw/qwen3-coder-plus
  • qw/qwen3-coder-flash

Kiro (kr/) - GRATUITO:

  • kr/claude-sonnet-4.5
  • kr/claude-haiku-4.5

OpenRouter (or/) - 100+ modelos:

🧪 Avaliações (Evals)

OmniRoute inclui um framework de avaliação integrado para testar a qualidade de respostas de LLM contra um conjunto golden. Acesse via Analytics → Evals no dashboard.

Conjunto Golden Integrado

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

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

Estratégias de Avaliação

Estratégia Descrição Exemplo
exact Saída deve corresponder exatamente "4"
contains Saída deve conter substring (case-insensitive) "Paris"
regex Saída deve corresponder ao padrão regex "1.*2.*3"
custom Função JS customizada retorna true/false (output) => output.length > 10

🐛 Solução de Problemas

Clique para expandir o guia de solução de problemas

"Language model did not provide messages"

  • Cota do provedor esgotada → Verifique o rastreador de cota no dashboard
  • Solução: Use combo com fallback ou mude para tier mais barato

Rate limiting

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

Token OAuth expirado

  • Renovado automaticamente pelo OmniRoute
  • Se persistir: Dashboard → Provedor → Reconectar

Custos altos

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

Dashboard abre na porta errada

  • Defina PORT=20128 e NEXT_PUBLIC_BASE_URL=http://localhost:20128

Erros de cloud sync

  • Verifique se BASE_URL aponta para sua instância em execução
  • Verifique se CLOUD_URL aponta para seu endpoint cloud esperado
  • Mantenha valores NEXT_PUBLIC_* alinhados com valores do servidor

Primeiro login não funciona

  • Verifique INITIAL_PASSWORD no .env
  • Se não definido, senha padrão é 123456

Sem logs de requisição

  • Defina ENABLE_REQUEST_LOGS=true no .env

Teste de conexão mostra "Invalid" para provedores compatíveis com OpenAI

  • Muitos provedores não expõem endpoint /models
  • OmniRoute v1.0.6+ inclui validação via chat completions como fallback
  • Certifique-se de que a base URL inclui sufixo /v1

🛠️ Stack Tecnológico

  • Runtime: Node.js 20+
  • Linguagem: TypeScript 5.9 — 100% TypeScript em src/ e open-sse/ (v1.0.6)
  • Framework: Next.js 16 + React 19 + Tailwind CSS 4
  • Banco de Dados: LowDB (JSON) + SQLite (estado do domínio + logs de proxy)
  • Streaming: Server-Sent Events (SSE)
  • Auth: OAuth 2.0 (PKCE) + JWT + API Keys
  • Testes: Node.js test runner (368+ testes unitários)
  • CI/CD: GitHub Actions (publicação automática npm + Docker Hub no release)
  • Website: omniroute.online
  • Pacote: npmjs.com/package/omniroute
  • Docker: hub.docker.com/r/diegosouzapw/omniroute
  • Resiliência: Circuit breaker, backoff exponencial, anti-thundering herd, spoofing TLS

📖 Documentação

Documento Descrição
Guia do Usuário Provedores, combos, integração CLI, deploy
Referência da API Todos os endpoints com exemplos
Solução de Problemas Problemas comuns e soluções
Arquitetura Arquitetura do sistema e internos
Contribuindo Setup de desenvolvimento e diretrizes
Spec OpenAPI Especificação OpenAPI 3.0
Política de Segurança Reportar vulnerabilidades e práticas de segurança
Deploy em VM Guia completo: VM + nginx + Cloudflare
Galeria de Features Tour visual do dashboard com screenshots

📸 Preview do Dashboard

Clique para ver screenshots do dashboard
Página Screenshot
Provedores Providers
Combos Combos
Analytics Analytics
Saúde Health
Tradutor Translator
Configurações Settings
CLI Tools CLI Tools
Logs de Uso Usage
Endpoint Endpoint

🗺️ Roadmap

O OmniRoute tem 210+ funcionalidades planejadas em múltiplas fases de desenvolvimento. Áreas principais:

Categoria Features Planejadas Destaques
🧠 Roteamento e Inteligência 25+ Roteamento por menor latência, roteamento por tags, pré-verificação de cota
🔒 Segurança e Compliance 20+ Hardening SSRF, cloaking de credenciais, rate-limit por endpoint
📊 Observabilidade 15+ Integração OpenTelemetry, monitoramento de cota em tempo real
🔄 Integrações 20+ Registro dinâmico de modelos, cooldowns de provedor
⚡ Performance 15+ Cache dupla camada, prompt cache, response cache, batch API
🌐 Ecossistema 10+ WebSocket API, config hot-reload, modo comercial

🔜 Em Breve

  • 🔗 Integração com OpenCode — Suporte nativo como provider para a IDE OpenCode
  • 🔗 Integração com TRAE — Suporte completo ao framework de desenvolvimento TRAE
  • 📦 Batch API — Processamento assíncrono em lote para requisições em massa
  • 🎯 Roteamento por Tags — Roteamento de requisições baseado em tags personalizadas
  • 💰 Estratégia de Menor Custo — Seleção automática do provedor mais barato

📝 Especificações completas de features disponíveis em docs/new-features/ (217 specs detalhadas)

📧 Suporte

💬 Participe da comunidade! Grupo WhatsApp — Tire dúvidas, compartilhe dicas e fique atualizado.

👥 Contribuidores

Contributors

Como Contribuir

  1. Faça fork do repositório
  2. Crie sua branch de funcionalidade (git checkout -b feature/amazing-feature)
  3. Faça commit das suas alterações (git commit -m 'Add amazing feature')
  4. Faça push para a branch (git push origin feature/amazing-feature)
  5. Abra um Pull Request

Veja CONTRIBUTING.md para diretrizes detalhadas.

Lançando uma Nova Versão

# Crie um release — publicação no npm acontece automaticamente
gh release create v1.0.6 --title "v1.0.6" --generate-notes

📊 Histórico de Stars

Star History Chart

🙏 Agradecimentos

Agradecimento especial a 9router por decolua — o projeto original que inspirou este fork. OmniRoute se baseia nessa fundação incrível com funcionalidades adicionais, APIs multi-modal e uma reescrita completa em TypeScript.

Agradecimento especial a CLIProxyAPI — a implementação original em Go que inspirou esta adaptação em JavaScript.

📄 Licença

Licença MIT - veja LICENSE para detalhes.

Feito com ❤️ para desenvolvedores que programam 24/7
omniroute.online