README (Português (Brasil))
🛠️ Pilha de Tecnologia
Seção intitulada “🛠️ Pilha de Tecnologia”| Camada | Tecnologia |
|---|---|
Node.js 22.x / 24.x LTS — >=22.22.2 <23 || >=24.0.0 <27 | |
TypeScript 6.0 — 100% TypeScript em src/ e open-sse/ (zero any no core desde a v2.0) | |
| Next.js 16 + React 19 + Tailwind CSS 4 | |
| better-sqlite3 (SQLite, WAL journaling) + LowDB (JSON legado) — 122 módulos de domínio, 183 migrações | |
| SQLite FTS5 full-text + embeddings de vetor int8-quantizados, decaimento tipado | |
| Zod 4 — Validação de I/O da ferramenta MCP + contratos de API | |
| MCP (stdio / HTTP / SSE) + A2A v0.3 (JSON-RPC 2.0 + SSE) | |
Server-Sent Events (SSE) + ponte WebSocket (/v1/ws) | |
| Pipeline de 12 motores — RTK, Caveman, LLMLingua-2 (MobileBERT ONNX), GCF, OmniGlyph | |
| OAuth 2.0 (PKCE) + JWT + Chaves de API + autenticação com escopo MCP · AES-256-GCM em repouso · DOMPurify | |
| wreq-js — Impersonificação de fingerprint TLS JA3 / JA4, proxy de 3 níveis | |
| Disjuntor, backoff exponencial, anti-thundering-herd, autocombinação de autocorreção | |
| pino — logs JSON estruturados com contexto de requisição | |
| Node.js test runner + Vitest — Mais de 39.000 declarações de teste estáticas em mais de 5.100 arquivos de teste rastreados (unidade, integração, E2E, segurança, ecossistema) | |
| Desktop (Electron) · Android (Termux) · PWA (qualquer navegador) | |
| GitHub Actions — publicação automática no npm + Docker Hub no lançamento | |
| Site · npm · Docker Hub |
📖 Documentação
Seção intitulada “📖 Documentação”📘 Primeiros Passos
Seção intitulada “📘 Primeiros Passos”| Documento | Descrição |
|---|---|
| Provedores, combos, integração com CLI, implantação | |
| Métodos completos de instalação, configurações de ferramentas CLI, configuração de protocolos, ajuste de tempos limite | |
| Configuração específica para Claude Code, Codex, Cursor, Cline, OpenClaw, Kilo e Copilot | |
| Controle um OmniRoute remoto (VPS) pelo CLI do seu laptop por meio de tokens de acesso com escopo definido | |
Conecte o Claude Code ao OmniRoute (local/remoto) com launch + perfis por modelo | |
| Instalação em 3 etapas → conexão → configuração |
🔧 Operações e Implantação
Seção intitulada “🔧 Operações e Implantação”| Documento | Descrição |
|---|---|
| Docker run, perfis do Compose, HTTPS com Caddy, túneis, tags de imagem | |
| Integração do Quadlet com systemd, podman-compose, SELinux | |
| Guia completo: configuração de VM + nginx + Cloudflare | |
| Implante no Fly.io com armazenamento persistente | |
| Execute o OmniRoute no Android por meio do Termux | |
| Instalação, cache e arquitetura do Progressive Web App | |
| Remoção completa para todos os métodos de instalação | |
Variáveis e referências completas do .env |
🧠 Recursos e Arquitetura
Seção intitulada “🧠 Recursos e Arquitetura”| Documento | Descrição |
|---|---|
| Arquitetura do sistema, fluxo de dados e detalhes internos | |
| Pipeline com 7 opções: desativado / leve / padrão / agressivo / ultra / RTK / empilhado | |
| Compressão da saída de comandos, filtros, confiança, verificação, recuperação da saída bruta | |
| Caveman, RTK, pipelines empilhados, interfaces de dashboard/API/MCP | |
| Esquemas JSON de pacotes de regras para filtros Caveman e RTK | |
| Detecção de idioma e criação de pacotes de regras do Caveman | |
| Disjuntores, períodos de espera, fila, prevenção de efeito manada, falsificação de TLS | |
| Pontuação com 16 fatores, pacotes de modos, autorrecuperação | |
| Sistema de proxy em 3 níveis, marketplace 1proxy, CRUD do registro | |
| Diretório consolidado: 35 pools recorrentes documentados / 489 entradas de camada gratuita catalogadas | |
| Tour visual pelo dashboard com capturas de tela | |
| Visão geral da base de código voltada para iniciantes |
🤖 Protocolos e APIs
Seção intitulada “🤖 Protocolos e APIs”| Documento | Descrição |
|---|---|
| Todos os endpoints com exemplos | |
| Especificação OpenAPI 3.0 | |
| 110 ferramentas MCP, configurações de IDE, clientes Python/TS/Go | |
| Instalação do MCP, transportes e referência de ferramentas | |
| Protocolo JSON-RPC 2.0, habilidades, streaming, gerenciamento de tarefas | |
| Cartão de agente A2A, tarefas, habilidades e streaming |
📋 Projeto e Qualidade
Seção intitulada “📋 Projeto e Qualidade”| Documento | Descrição |
|---|---|
| Configuração e diretrizes de desenvolvimento | |
Para onde os PRs são direcionados (release/*) e o que main e as tags significam | |
| Histórico completo de lançamentos por versão | |
| Relato de vulnerabilidades e práticas de segurança | |
| Suporte a 42 idiomas, fluxo de trabalho de tradução e RTL | |
| Etapas de validação pré-lançamento | |
| Estratégia de cobertura de testes para mais de 39.000 declarações estáticas de testes em mais de 5.100 arquivos de teste rastreados |
⭐ Principais colaboradores
Seção intitulada “⭐ Principais colaboradores”O OmniRoute é moldado por uma comunidade apaixonada por código aberto. Essas pessoas fizeram contribuições excepcionais que afetam diretamente a qualidade, a estabilidade e o alcance do projeto. Obrigado.
Colaboradores externos por pull requests mesclados
Seção intitulada “Colaboradores externos por pull requests mesclados”| Posição | Colaborador | PRs mesclados | ~Linhas alteradas |
|---|---|---|---|
| 1 | backryun | 190 | 227,977 |
| 2 | oyi77 | 180 | 407,678 |
| 3 | rdself | 145 | 80,663 |
| 4 | JxnLexn | 128 | 387,049 |
| 5 | KooshaPari | 101 | 125,747 |
| 6 | herjarsa | 88 | 230,872 |
| 7 | RaviTharuma | 79 | 55,106 |
| 8 | maxmad64bis | 69 | 394,715 |
| 9 | artickc | 59 | 33,260 |
| 10 | HouMinXi | 51 | 47,334 |
| 10 | chirag127 | 51 | 5,153 |
| 12 | xz-dev | 50 | 245,976 |
| 13 | hartmark | 47 | 52,185 |
| 14 | rqzbeh | 39 | 143,181 |
| 15 | dhaern | 34 | 19,559 |
| 16 | Dingding-leo | 33 | 1,986 |
| 17 | NomenAK | 32 | 13,854 |
| 18 | MumuTW | 30 | 16,953 |
| 19 | benzntech | 29 | 11,641 |
| 20 | pacocartones | 24 | 9,331 |
| 20 | Prudhvivuda | 24 | 6,312 |
Dados congelados na ponta ativa de release/v3.8.50, no commit dafb4ae808, com merges até 2026-08-24 05:26:03 UTC. O censo paginado do GitHub GraphQL contém 5.911 PRs mesclados: 2.707 pelo proprietário do repositório, 179 pelo Dependabot e 3.025 PRs externos de 535 colaboradores distintos. “Linhas alteradas” corresponde às adições + exclusões do GitHub e inclui arquivos gerados, lockfiles, catálogos, traduções e documentação; representa a rotatividade do código, não as LOC de autoria. Empates no limite de corte são mantidos.
Commits atribuídos pelo GitHub
Seção intitulada “Commits atribuídos pelo GitHub”|
backryun 🥇 220 commits atribuídos pelo GitHub |
Paijo 🥈 219 commits atribuídos pelo GitHub |
Randi 🥉 108 commits atribuídos pelo GitHub |
Ravi Tharuma 🏅 81 commits atribuídos pelo GitHub |
Chris 🏅 70 commits atribuídos pelo GitHub |
Markus Hartung 🏅 69 commits atribuídos pelo GitHub · empate em 6º lugar |
|
Dizzle 🏅 69 commits atribuídos pelo GitHub · empate em 6º lugar |
Jan Leon 🏅 64 commits atribuídos pelo GitHub |
zenobit 🏅 62 commits atribuídos pelo GitHub |
Bob.Hou 🏅 51 commits atribuídos pelo GitHub · empate em 10º lugar |
Xiangzhe 🏅 51 commits atribuídos pelo GitHub · empate em 10º lugar |
Verificado novamente em 2026-08-24 06:14:31 UTC: commits atribuídos pelo GitHub, conforme informados pela API de Colaboradores do repositório para a branch padrão release/v3.8.50. A API retornou 525 identidades (415 usuários, 2 bots e 108 anônimas); esta tabela exclui o mantenedor, os bots e as identidades anônimas e preserva os empates na classificação. Ela é distinta tanto da classificação de PRs mesclados acima quanto do censo de 639 pessoas baseado nos metadados do Git abaixo.
🙏 Os recursos, as correções de bugs e as melhorias de infraestrutura feitos por esses colaboradores são uma parte essencial do que torna o OmniRoute confiável e rico em recursos. Cada pull request, cada caso de teste e cada arquivo de tradução i18n importa. O código aberto é construído por pessoas como eles.
💖 Patrocinadores
Seção intitulada “💖 Patrocinadores”Um agradecimento especial às pessoas que financiam o OmniRoute do próprio bolso — cada contribuição mantém o projeto gratuito, independente e em constante evolução.
![]() Andrew 💛 Patrocinador mensal ativo |
![]() Vlad I 💛 Patrocinador mensal ativo |
![]() Paco Cartones 💛 Patrocinador ativo com contribuição única |
![]() Prof. Igor Morais 💛 Apoiador anterior com contribuição única |
![]() longtao 💛 Apoiador anterior com contribuição única |
… e outras pessoas que preferem permanecer anônimas 💛
Patrocinadores públicos do GitHub revalidados em 2026-08-24. O status activeOnly do GitHub determina os rótulos de atividade acima; apoiadores públicos com contribuições únicas divulgados anteriormente continuam sendo reconhecidos, e patrocinadores privados permanecem anônimos.
💖 Torne-se um patrocinador → — cada dólar mantém o OmniRoute gratuito e independente.
👥 Mais de 600 colaboradores
Seção intitulada “👥 Mais de 600 colaboradores”Auditado em 2026-08-24 na base congelada ac02c5b42f e verificado novamente na ponta ativa de release/v3.8.50, dafb4ae808: 639 identidades humanas normalizadas do Git — 407 aparecem como autores de commits (incluindo o mantenedor) e 232 aparecem apenas em trailers explícitos de Co-authored-by. O levantamento normaliza identificadores noreply do GitHub, exclui 26 identidades de bots/agentes/serviços/placeholders e não mescla endereços de e-mail comuns apenas porque seus nomes de exibição coincidem.
Como contribuir
Seção intitulada “Como contribuir”- Faça um fork do repositório
- Crie a branch a partir da ponta ativa de
release/vX.Y.Z(não demain) — consulte Modelo de branches e releases - Crie sua branch de funcionalidade (
git checkout -b feat/amazing-feature) - Faça o commit das suas alterações (
git commit -m 'feat: add amazing feature') - Envie para a branch (
git push origin feat/amazing-feature) - Abra um Pull Request com a base = essa branch
release/vX.Y.Z
Consulte CONTRIBUTING.md para obter diretrizes detalhadas.
Publicando uma nova versão
Seção intitulada “Publicando uma nova versão”# Crie uma release — npm publish acontece automaticamenteVERSION=x.y.zgh release create "v${VERSION}" --title "v${VERSION}" --generate-notes📊 Estrelas
Seção intitulada “📊 Estrelas”🌍 StarMapper
Seção intitulada “🌍 StarMapper”🙏 Agradecimentos
Seção intitulada “🙏 Agradecimentos”O OmniRoute apoia-se sobre os ombros de gigantes. Ele começou como um fork do 9router e uma versão em TypeScript do projeto em Go CLIProxyAPI — e, a partir daí, cada subsistema abaixo foi inspirado por um projeto de código aberto que chegou lá primeiro. Cada um deles ajudou a moldar uma parte concreta do OmniRoute. Este é o nosso agradecimento a todos eles. 🙏
⭐ contagens de estrelas verificadas pela API REST do GitHub em 24 de agosto de 2026 — dê uma estrela a esses projetos. As contagens são um retrato exato daquela data e mudarão naturalmente.
🧬 Linhagem e gateway
Seção intitulada “🧬 Linhagem e gateway”| Projeto | ⭐ | Como inspirou o OmniRoute |
|---|---|---|
| 26,161 | O projeto original no qual este fork se baseia — ampliado aqui com APIs multimodais e uma reescrita completa em TypeScript. | |
| 48,497 | A implementação em Go que inspirou esta versão portada para JavaScript / TypeScript. | |
| 57,100 | O gateway de IA cujo conjunto público de dados de preços alimenta nossa sincronização de rastreamento de custos e cujo modelo de normalização de provedores serviu de base para nosso roteamento. | |
| 1,410 | Código-fonte MIT adaptado para a ponte ChatGPT Web → Codex Responses incorporada, incluindo adaptadores de sessão do navegador, enquadramento de respostas, uso e pesquisa na web. | |
| 48,112 | Padrões portados para recuperação de streaming, aliases sem raciocínio, pesquisa na web de contingência, limites de janela deslizante, ocultação de dados em logs e fluxos de inicialização reforçados. | |
| 322 | Padrões de escolha de ferramentas, restrição de saída e confirmação de ferramentas do Cursor Composer adaptados para o executor nativo do Cursor. | |
| 457 | Padrões de novo login e rotação de tokens de atualização portados para a reautenticação OAuth do Codex. | |
| 510 | Valores padrão de transformação compatíveis com o Claude Code e comportamento de cabeçalhos de cobrança generalizados na ponte orientada por configuração do OmniRoute. | |
| 2 | Seus mapeamentos de modelos Grok, gerador Statsig de TypeError simulado, valores padrão de solicitação e dispositivo e processador de respostas NDJSON foram substancialmente adaptados para o executor Grok Web do OmniRoute. | |
| 705 | A principal fonte transitiva de código por trás do grok2api-merged; suas implementações de modelo, cabeçalho, payload, Statsig e processador são preservadas na linhagem do Grok Web. | |
| 7,520 | O código-fonte MIT subjacente para os valores padrão de payload e dispositivo do Grok, o gerador Statsig e o processador result.response, incorporado por meio do TQZHR e do grok2api-merged. | |
| 27 | Uma fonte transitiva creditada pelo grok2api-merged por sua camada de pool de proxies; o OmniRoute preserva esse aviso de linhagem, mas não alega ter portado um pool de proxies em seu executor Grok Web de escopo limitado. | |
| 50 | Seu proxy do Grok autenticado por cookies e o padrão de streaming result.response.token serviram de base para o transporte Grok Web do OmniRoute. | |
| 5 | A implementação original do Grok Web consultou seu design upstream de HTTP/navegador; seu caminho HTTP direto deriva do GrokProxy, portanto não se alega uma portabilidade de código independente. | |
| 14 | Seus esquemas Rust ChatOptions e de envelope de resposta serviram de base para os tipos TypeScript de solicitação e resposta de streaming do Grok no OmniRoute. |
🗜️ Compressão de contexto e tokens — mecanismos
Seção intitulada “🗜️ Compressão de contexto e tokens — mecanismos”| Projeto | ⭐ | Como inspirou o OmniRoute |
|---|---|---|
| 100,538 | O projeto viral do tipo "por que usar muitos token se poucos token resolvem" — sua filosofia de fala das cavernas impulsiona nosso modo de compressão padrão e mais de 30 regras de remoção de palavras supérfluas/condensação. | |
| 77,185 | Compressão de alto desempenho da saída de comandos — inspirou nosso mecanismo RTK, a DSL de filtros JSON, a recuperação da saída bruta e o pipeline encadeado RTK → Caveman. | |
| 67,310 | Compressão reversível de contexto (SmartCrusher) — inspirou nosso mecanismo headroom e o padrão de marcadores de recuperação ccr. | |
| 6,598 | Pesquisa sobre compressão de prompts (LLMLingua / LLMLingua-2) — inspirou nosso mecanismo llmlingua assíncrono, seguro para código e com tolerância a falhas. | |
| 31 | O porte para JS/ONNX (MobileBERT / XLM-RoBERTa) usado como backend em thread de trabalho para nosso mecanismo LLMLingua. | |
| 40 | Compressão de tokens em PT-BR — impulsiona nosso pacote de idioma pt-BR: redução de pleonasmos e remoção de palavras supérfluas ajustadas à gramática do português brasileiro. | |
| 108,957 | A habilidade viral de programação YAGNI do "dev sênior preguiçoso" — inspirou nosso Estilo de Saída less-code: direcionamento para a menor alteração funcional que reduz o código _gerado_ (o equivalente de Caveman no eixo de saída para uma prosa concisa). | |
| 23,526 | Seu estilo de resposta orientado à ação e adequado a pessoas com TDAH foi adaptado para o estilo de saída conciso do OmniRoute em cinco idiomas. |
🧩 Formatos compactos, pesquisa sobre tokens e ferramentas com reconhecimento de código
Seção intitulada “🧩 Formatos compactos, pesquisa sobre tokens e ferramentas com reconhecimento de código”| Projeto | ⭐ | Como inspirou o OmniRoute |
|---|---|---|
| 25,233 | Notação de Objetos Orientada a Tokens — seu modelo colunar de cabeçalho e linhas moldou nossa etapa de compactação tabular. | |
| 41 | Seu formato compacto de grafos e design de perfil genérico fundamentaram a compactação tabular do OmniRoute e o formato de codec do Headroom. | |
| 4 | A implementação MIT em TypeScript incorporada diretamente e ampliada como codec de perfil genérico do Headroom. | |
| 494 | Cache Brotli/SQLite + delta de contexto por sessão — inspirou nosso mecanismo session-dedup. | |
| 1,122 | Compactação da saída do Bash + perfis MCP — inspirou nossa disciplina de interrupção da compressão e a redução de manifestos de ferramentas MCP. | |
| 138 | Compressão de saída sensível ao conteúdo e por tipo de arquivo, com interrupção em caso de falha — validou nosso despacho por tipo e a omissão quando o ganho é mínimo. | |
| 1,951 | "Encontre os tokens fantasmas" — seu padrão de descarregamento + identificador recuperável fundamentou nossa abordagem de descarregamento CCR. | |
| 28 | Um modelo de grafo de sessão + desduplicação de linhas entre turnos que fundamentou nosso design de desduplicação por sessão. | |
| 3 | JSON colunar em Rust + recuperação endereçada por conteúdo + desduplicação entre mensagens — validou o design dos nossos mecanismos headroom/ccr/session-dedup e a invariante estável para cache de que a "forma comprimida independe da posição". | |
| 113 | Compressão de esquemas/descrições de ferramentas MCP — fundamentou nossa redução da cardinalidade de manifestos de ferramentas MCP. | |
| 197 | Classificação de mapas de repositórios no estilo Aider — fundamentou nossa exploração de mapas de repositórios / classificação de recuperação. | |
| 4 | Redução declarativa da saída do shell via MCP — validou nossa compactação declarativa da saída do bash. | |
| 6,162 | Kit de ferramentas da API do Compilador TypeScript — inspirou nossa remoção de comentários baseada em parser, que preserva literais de string, template e expressões regulares. |
🧠 Memória e RAG
Seção intitulada “🧠 Memória e RAG”| Projeto | ⭐ | Como inspirou o OmniRoute |
|---|---|---|
| 63,902 | Camada universal de memória — seu modelo de proxy como limite de gravação/leitura moldou nossa arquitetura de memória. | |
| 24,382 | Agentes com estado e memória em camadas — inspiraram nosso modelo em camadas de Controle e Recuperação de Contexto (CCR). | |
| 1,781 | A taxonomia ProblemMap de 16 modos de falha recorrentes em RAG/LLM — o vocabulário comum usado em nosso guia de solução de problemas. |
🛰️ Inspeção de tráfego, MITM e proxy transparente
Seção intitulada “🛰️ Inspeção de tráfego, MITM e proxy transparente”| Projeto | ⭐ | Como inspirou o OmniRoute |
|---|---|---|
| 66 | A interceptação/análise MITM do tráfego entre assistentes de programação ↔ LLM orientou os requisitos iniciais do Inspetor de Tráfego. Quatro módulos derivados anteriormente — mesclagem de SSE, normalização de conversas, mascaramento de segredos e sanitização de cabeçalhos — foram substituídos por implementações independentes de sala limpa, baseadas em padrões públicos de protocolo. As duas superfícies de passagem direta para o host (passthrough.ts e _internal/bypass.cjs) continuam sendo implementações internas do OmniRoute classificadas de forma independente; elas não foram reescritas como parte dessa substituição. | |
| 5,995 | Roteamento transparente de proxy por processo — inspirou nosso encerramento de MITM seguro contra falhas, tempos limite de inatividade de soquetes, atribuição de processos via /proc e captura TPROXY. |
📚 Dados de modelos, observabilidade e interface
Seção intitulada “📚 Dados de modelos, observabilidade e interface”| Projeto | ⭐ | Como inspirou o OmniRoute |
|---|---|---|
| 6,555 | Banco de dados aberto de especificações, preços e recursos de modelos de IA — sincronizado nativamente com nosso catálogo de modelos. | |
| 38,108 | A biblioteca de grafos baseada em nós que viabiliza nosso Estúdio de Compressão e nosso Estúdio de Combinação/Roteamento em tempo real. | |
| 40,314 | A visualização ao vivo do grafo de fluxo de trabalho do LangGraph Studio inspirou a visualização em cascata e em tempo real dos nossos Estúdios. | |
| 33,592 | Seu modelo de observabilidade de rastreamento → intervalo → geração moldou a visualização em cascata do nosso Estúdio de Compressão. | |
| 3,631 | Observabilidade da malha de serviços do Istio — inspirou nossos indicadores de disjuntor e elementos visuais de arestas com erro no Estúdio de Roteamento/Combinação. | |
| 2,428 | Logotipos de marcas de IA/LLM usados para renderizar os ícones dos provedores em todo o nosso painel. | |
| 12,354 | Fornece as bandeiras SVG licenciadas sob a licença MIT usadas pelo seletor de idioma do README. |
🛡️ Segurança
Seção intitulada “🛡️ Segurança”| Projeto | ⭐ | Como inspirou o OmniRoute |
|---|---|---|
| 721 | Uma lista selecionada de bibliotecas seguras por padrão que orienta nossas escolhas de segurança (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink). |
🧭 Ferramentas complementares
Seção intitulada “🧭 Ferramentas complementares”| Projeto | ⭐ | Como inspirou o OmniRoute |
|---|---|---|
| 6,564 | Inspirou a desduplicação de solicitações, o fallback emergencial de custo zero, as estratégias conectáveis de Auto-Combo e a classificação multilíngue de intenções. | |
| 30,652 | Seu remapeamento de modelos com reconhecimento de conta, a validação do caminho do executável e o comportamento dos rótulos de plano serviram de referência para o runtime Antigravity do OmniRoute. | |
| 4,817 | Seu formato compacto de contagem regressiva para redefinição de cota inspirou a exibição correspondente do limite do provedor no OmniRoute. | |
| 32,230 | Suas integrações ACP inspiraram a detecção automática, pelo OmniRoute, dos agentes de CLI instalados. | |
| 20,507 | Identificou a superfície de cota do Grok Build; em seguida, o OmniRoute verificou e corrigiu de forma independente o formato real dos dados transmitidos. |
📄 Licença
Seção intitulada “📄 Licença”Licença MIT — consulte LICENSE para mais detalhes.
⬆ Voltar ao topo · Feito com ❤️ para a comunidade de IA de código aberto.
OmniRoute v3.8.51 · Node ≥22.22.2 · Licença MIT · omniroute.online
HagiCode
HagiCode é um ambiente de programação com agentes, fluxos estruturados, execução multiagente e visualizações Hero Dungeon.
Transforme ideias em software útil com um fluxo de trabalho com agentes mais inteligente, rápido e agradável.

- SmartFluxos estruturados transformam intenções em um caminho executável da ideia à entrega.
- EfficientFluxos multiagente mantêm pesquisa, implementação e revisão em andamento simultaneamente.
- FunO Hero Dungeon torna longas sessões de programação mais visuais e colaborativas.




