Kelvinthedude/ccNexus

O que ccNexus faz?

🔄 Automatize a rotação de endpoints de API para o Claude Code com suporte a múltiplos provedores, tentativas inteligentes e estatísticas em tempo real para melhorar a confiabilidade e o desempenho.

Visão Geral

O ccNexus otimiza o uso de APIs de IA com rotação automática de endpoints, garantindo que as requisições sejam distribuídas entre diferentes provedores e regionais. Isso reduz a dependência de um único ponto de falha, evita limitações de taxa e potencialmente reduz custos.

Funcionalidades

• Rotação Inteligente: Distribui requisições com base em latência, taxas de erro e custo.
• Múltiplos Provedores: Suporte para OpenAI, Anthropic, Google, Azure, AWS Bedrock e outros.
• Tentativas Automáticas: Backoff exponencial com limites configuráveis.
• Estatísticas em Tempo Real: Métricas de desempenho visíveis no console.
• Failover Automático: Em caso de falha de um endpoint, alterna automaticamente para o próximo disponível.

Instalação

1. Adicione a skill ao seu projeto:

   claude add skill kelvinthedude/ccnexus
   

2. Configure os provedores no arquivo ccnexus.yaml:

   providers:
     - name: anthropic
       api_key: $ANTHROPIC_API_KEY
       base_url: https://api.anthropic.com/v1
       weight: 2
     - name: openai
       api_key: $OPENAI_API_KEY
       base_url: https://api.openai.com/v1
       weight: 1
     - name: google
       api_key: $GOOGLE_API_KEY
       base_url: https://generativelanguage.googleapis.com/v1beta
       weight: 1
   

Uso

Após a configuração, todas as chamadas de API do Claude Code serão automaticamente roteadas através do ccNexus:

claude run "explique o teorema de Pitágoras"

Para ver estatísticas ao vivo:

ccnexus stats

Configuração Avançada

• Limites de Taxa: Defina max_requests_per_minute e max_tokens_per_minute.
• Tentativas: Configure retry.max_attempts (padrão: 3) e retry.backoff_factor (padrão: 2).
• Estratégias de Rotação: Escolha entre 'round_robin', 'least_latency' ou 'failover'.

Compatibilidade

• Claude Code
• Cursor
• Codex
• Qualquer ambiente que suporte chamadas de API com chave de API

Contribuição

Contribuições são bem-vindas! Abra uma issue ou pull request no repositório GitHub.

Licença

MIT