Repolode
NadirRouter

NadirRouter/NadirClaw

Roteador de LLM self-hosted e com código disponível que direciona prompts simples para modelos baratos ou locais e os complexos para modelos premium, por meio de um proxy compatível com OpenAI.

Estrelas
661
Forks
80
Issues abertas
1
Último commit
há 4 horas

O que é?

NadirClaw é um proxy local que fica entre ferramentas de programação com IA e provedores de modelos. Cada prompt recebido é classificado em cerca de 10 ms, enviado para a faixa de modelos mais barata com maior probabilidade de respondê-lo e avaliado por um verificador heurístico que detecta recusas, truncamentos e JSON malformado. Se a resposta não passar na verificação, a solicitação é encaminhada para um modelo mais potente. O projeto informa a economia por solicitação em comparação com uma configuração que usa apenas modelos premium.

Ele oferece endpoints compatíveis com OpenAI (/v1/chat/completions) e Anthropic (/v1/messages), para que clientes como Claude Code, Codex, Cursor, Aider, Continue e OpenClaw possam usá-lo alterando a URL base. O Gemini é chamado nativamente pelo Google GenAI SDK, enquanto os demais provedores são acessados pelo LiteLLM. Também há suporte a Ollama e servidores personalizados compatíveis com OpenAI, como vLLM e LM Studio, para modelos locais.

Além do roteamento, o projeto inclui cadeias de fallback para erros 429 e 5xx, fixação do modelo por sessão, filtragem por janela de contexto, compactação de contexto, cache de prompts em memória, alertas de orçamento, dashboards no terminal e na web, exportação de logs em CSV/JSONL e métricas Prometheus. A licença é PolyForm Noncommercial, portanto o código está disponível, mas não é open source.

Recursos principais

  • 01Classifica cada prompt em cerca de 10 ms e o direciona para faixas de modelos simples, intermediários ou complexos.
  • 02Verifica respostas de modelos baratos com checagens heurísticas e as encaminha para um modelo mais potente quando não passam na validação.
  • 03Oferece endpoints compatíveis com OpenAI e Anthropic para ferramentas de programação existentes.
  • 04Acessa o Gemini nativamente e outros provedores pelo LiteLLM, incluindo Ollama.
  • 05Percorre uma cadeia configurável de modelos quando um provedor retorna erros de limite de requisições ou do servidor.
  • 06Informa a economia por solicitação e oferece dashboards no terminal e na web, além de alertas de orçamento.

Casos de uso

  • Reduzir os gastos mensais com API de desenvolvedores que usam Claude Code, Cursor ou Codex com prompts de diferentes níveis de dificuldade.
  • Executar solicitações simples em um modelo local do Ollama e enviar tarefas difíceis para um modelo na nuvem.
  • Oferecer a uma equipe pequena um gateway self-hosted que monitora o uso de modelos e os custos.
  • Direcionar uma ferramenta compatível com OpenAI para um endpoint personalizado do vLLM ou LM Studio, junto com modelos na nuvem.

Tópicos

Perguntas frequentes

O que é NadirClaw?
Roteador de LLM self-hosted e com código disponível que direciona prompts simples para modelos baratos ou locais e os complexos para modelos premium, por meio de um proxy compatível com OpenAI. NadirClaw é um proxy local que fica entre ferramentas de programação com IA e provedores de modelos. Cada prompt recebido é classificado em cerca de 10 ms, enviado para a faixa de modelos mais barata com maior probabilidade de respondê-lo e avaliado por um verificador heurístico que detecta recusas, truncamentos e JSON malformado. Se a resposta não passar na verificação, a solicitação é encaminhada para um modelo mais potente. O projeto informa a economia por solicitação em comparação com uma configuração que usa apenas modelos premium.
NadirClaw é gratuito? Qual é a licença?
NadirClaw é open source sob a licença Other. Confira os termos da licença antes de usá-lo em produtos comerciais.
NadirClaw ainda é mantido?
Manutenção ativa. O último commit de NadirClaw foi em 22 de out. de 2026.
Para que posso usar NadirClaw?
Reduzir os gastos mensais com API de desenvolvedores que usam Claude Code, Cursor ou Codex com prompts de diferentes níveis de dificuldade. Executar solicitações simples em um modelo local do Ollama e enviar tarefas difíceis para um modelo na nuvem. Oferecer a uma equipe pequena um gateway self-hosted que monitora o uso de modelos e os custos. Direcionar uma ferramenta compatível com OpenAI para um endpoint personalizado do vLLM ou LM Studio, junto com modelos na nuvem.
Onde consigo NadirClaw?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/NadirRouter/NadirClaw

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados