Tutorial Completo: Instalando e Usando o 9Router no Windows 11

Público-alvo: Iniciante completo em programação Sistema operacional: Windows 11 Tempo estimado: 20-30 minutos Run: npx 9router

---

📋 Índice do Tutorial

1. O que é o 9Router?
2. O que você precisa antes de começar
3. Instalando o Node.js (Pré-requisito)
4. Instalando o 9Router
5. Executando o 9Router pela primeira vez
6. Configurando provedores de IA
7. Conectando o 9Router ao Antigravity
8. Resolvendo problemas comuns
9. Dicas úteis para iniciantes

---

1. O que é o 9Router?

Imagine que você tem várias contas de serviços de IA (como Claude, Gemini, etc.), mas cada um deles tem limites de uso e custos diferentes. O 9Router é como um "gerente de tráfego inteligente" que:

• Encaminha automaticamente suas solicitações para o melhor serviço disponível
• Muda sozinho para outro provedor quando um atinge seu limite
• Economiza dinheiro usando primeiro os serviços gratuitos ou mais baratos
• Funciona 24 horas sem interrupções

🎯 Por que usar o 9Router?

---

2. O que você precisa antes de começar

Antes de instalar o 9Router, você precisa de algumas ferramentas básicas:

2.1 O que é o Node.js e o npm?

Node.js é um programa que permite executar código JavaScript no seu computador (não apenas no navegador). É como um "motor" que faz programas funcionarem.

npm (Node Package Manager) é um "gerenciador de pacotes" que vem junto com o Node.js. É como uma loja de aplicativos onde você pode instalar programas como o 9Router.

2.2 Lista de materiais necessários

---

3. Instalando o Node.js (Pré-requisito)

Este é o primeiro passo. Sem o Node.js, o 9Router não funcionará.

Passo 3.1: Baixando o Node.js

1. Abra seu navegador (Chrome, Edge, Firefox, etc.)

2. Acesse o site oficial: https://nodejs.org/

3. Você verá duas opções de download:

   • LTS (Recommended) ← Use esta! É mais estável
   • Current ← Versão mais recente, mas pode ter problemas

4. Clique no botão verde "LTS" para baixar o instalador

Passo 3.2: Instalando o Node.js

1. Localize o arquivo baixado (geralmente na pasta "Downloads")

   • O arquivo terá um nome como: node-v20.x.x-x64.msi

2. Clique duas vezes no arquivo para iniciar a instalação

3. Siga as etapas do assistente de instalação:

   Tela 1 - Boas-vindas:

   • Clique em "Next"

   Tela 2 - Termos de uso:

   • Marque "I accept the terms in the License Agreement"
   • Clique em "Next"

   Tela 3 - Local de instalação:

   • Pode deixar o padrão (C:\Program Files\nodejs)
   • Clique em "Next"

   Tela 4 - Recursos opcionais:

   • Pode marcar tudo (já vem marcado por padrão)
   • Clique em "Next"

   Tela 5 - Ferramentas opcionais:

   • Pode pular esta etapa (marque "Automatically install necessary tools")
   • Clique em "Next"

   Tela 6 - Pronto para instalar:

   • Clique em "Install"

   Tela 7 - Concluindo:

   • Clique em "Finish"

Passo 3.3: Verificando a instalação

1. Abra o Prompt de Comando:

   • Pressione Win + R no teclado
   • Digite cmd e pressione Enter
   • Ou procure "Prompt de Comando" no menu Iniciar

2. Digite os seguintes comandos (pressione Enter após cada um):

node --version

Deverá aparecer algo como: v20.11.0 (número pode variar)

npm --version

Deverá aparecer algo como: 10.2.0 (número pode variar)

3. Se apareceu números, a instalação foi bem-sucedida! ✅

Nota: Se aparecer "não reconhecido", reinicie o computador e tente novamente.

---

4. Instalando o 9Router

Agora que você tem o Node.js instalado, podemos instalar o 9Router.

Passo 4.1: Abrir o Prompt de Comando

1. Pressione Win + X no teclado
2. Selecione "Terminal (Admin)" ou "Prompt de Comando (Admin)"
3. Se aparecer uma pergunta "Deseja permitir que este aplicativo faça alterações no dispositivo?", clique em "Sim"

Passo 4.2: Instalar o 9Router

1. Digite o seguinte comando no terminal:

npm install -g 9router

2. Pressione Enter e aguarde

3. O que vai acontecer:

   • O npm vai baixar o 9Router da internet
   • Você verá texto passando na tela (não se preocupe)
   • Pode levar de 1 a 3 minutos dependendo da sua internet

4. Quando terminar, você verá uma mensagem como:

   added 1 package in 10s
   

5. Parabéns! O 9Router está instalado! 🎉

Passo 4.3: Verificando a instalação

Digite o comando:

9router --version

Deverá aparecer a versão do 9Router instalada.

---

5. Executando o 9Router pela primeira vez

Agora vamos iniciar o 9Router e acessar seu painel de controle.

Passo 5.1: Iniciar o 9Router

1. Digite o comando no terminal:

9router

2. Pressione Enter

3. Você verá algo assim:

   > Starting 9Router...
   > Server running on http://localhost:20128
   > Dashboard: http://localhost:20128/dashboard
   > Ready to route! ✓
   

4. Mantenha esta janela aberta! Ela é o "motor" do 9Router.

Passo 5.2: Acessar o Painel de Controle (Dashboard)

1. Abra seu navegador (Chrome, Edge, etc.)

2. Digite na barra de endereços:

   http://localhost:20128/dashboard
   

3. Pressione Enter

4. Você verá a tela de login do 9Router

Passo 5.3: Fazer login no Dashboard

1. Na tela de login, você verá um campo de senha

2. Digite a senha padrão:

   123456
   

3. Clique em "Login" ou "Entrar"

4. Parabéns! Você está no painel de controle do 9Router! 🎉

⚠️ Importante: Esta senha padrão é apenas para testes iniciais. Em uso real, você deve alterá-la.

---

6. Configurando provedores de IA

Agora vamos configurar quais serviços de IA você quer usar. Você pode começar apenas com serviços gratuitos!

Passo 6.1: Conhecendo os níveis de serviço

Passo 6.2: Adicionar provedores gratuitos (Recomendado para iniciantes)

1. No Dashboard do 9Router, localize o menu lateral
2. Procure por "Providers" ou "Provedores"
3. Clique para expandir as opções

Adicionando iFlow (Grátis):

1. Clique em "Add Provider" ou botão similar
2. Selecione "iFlow" na lista de provedores
3. Não é necessário API key para começar (versão gratuita)
4. Configure:
   • Tier: FREE
   • Modelo: Escolha qualquer um disponível
5. Salve as configurações

Adicionando Qwen (Grátis):

1. Clique em "Add Provider"
2. Selecione "Qwen"
3. Para Qwen, você precisa de uma chave API:
   • Acesse: https://www.modelscope.cn
   • Crie uma conta (grátis)
   • Gere uma chave API nas configurações
4. Cole a chave API no campo correspondente
5. Salve

Adicionando Kiro (Grátis):

1. Clique em "Add Provider"
2. Selecione "Kiro"
3. Visite: https://kiro.ai para obter chave API gratuita
4. Cole a chave e salve

Passo 6.3: Adicionar provedores pagos (Opcional)

Se você quiser usar serviços como Claude ou Gemini:

1. Claude API:

   • Acesse: https://console.anthropic.com
   • Crie uma conta
   • Gere uma API key
   • Cole no campo do 9Router

2. Gemini API:

   • Acesse: https://aistudio.google.com
   • Crie uma conta Google
   • Gere uma API key
   • Cole no campo do 9Router

Passo 6.4: Verificar configuração

1. No Dashboard, vá para "Status" ou "Health Check"
2. Verifique se seus provedores aparecem como "Online" ou "Conectado"
3. Se aparecerem verdes/ativos, está funcionando! ✅

---

7. Conectando o 9Router ao Antigravity

Agora vamos configurar o Antigravity para usar o 9Router como intermediário.

Passo 7.1: O que é integração?

Integrar significa fazer dois programas trabalharem juntos. O Antigravity vai enviar suas perguntas para o 9Router, e o 9Router vai decidir qual serviço de IA usar.

Passo 7.2: Configurar o Antigravity

1. Abra o arquivo de configuração do Antigravity:

   • O arquivo geralmente fica em: ~/.gemini/settings.json
   • ~ significa sua pasta de usuário (ex: C:\Users\SeuNome)

2. Adicione a configuração do 9Router:

{
  "mcpServers": {
    "9router": {
      "command": "node",
      "args": ["-y", "9router"]
    }
  }
}

Passo 7.3: Alternativa - Configurar manualmente

Se a configuração acima não funcionar:

1. Localize o arquivo settings.json do Antigravity
2. Abra com um editor de texto (Bloco de Notas, VS Code, etc.)
3. Encontre a seção de modelos/provedores
4. Adicione:

   "providers": {
     "9router": {
       "baseUrl": "http://localhost:20128/v1",
       "apiKey": "[sua_chave_do_9router]"
     }
   }
   

5. Salve o arquivo

Passo 7.4: Testar a conexão

1. Inicie o 9Router (se ainda não estiver rodando)
2. Abra o Antigravity
3. Faça uma pergunta simples
4. Verifique se a resposta vem corretamente

Se funcionar, a integração está completa! 🎉

---

8. Resolvendo problemas comuns

Se você encontrar algum problema, verifique as soluções abaixo:

Problema 1: "npm não é reconhecido"

Causa: Node.js não foi instalado corretamente ou não foi adicionado ao PATH.

Solução:

1. Reinicie o computador
2. Se ainda não funcionar, desinstale e reinstale o Node.js
3. Durante a instalação, marque "Add to PATH"

Problema 2: "9router não é reconhecido"

Causa: Instalação não completou ou problemas de permissão.

Solução:

1. Abra o terminal como Administrador
2. Digite:

   npm uninstall -g 9router
   npm install -g 9router
   

Problema 3: Dashboard não abre

Causa: Serviço não está rodando ou porta está bloqueada.

Solução:

1. Verifique se o 9Router está rodando (janela do terminal aberta)
2. Tente URLs alternativas:
   • http://127.0.0.1:20128/dashboard
   • http://localhost:20128
3. Verifique se a porta 20128 não está sendo usada por outro programa

Problema 4: Login não funciona

Causa: Senha incorreta ou problema de conexão.

Solução:

1. Senha padrão: 123456
2. Se mudou e esqueceu:
   • Pare o 9Router (Ctrl+C no terminal)
   • Delete o arquivo de dados (C:\Users\SeuNome\AppData\Roaming\9router\db.json)
   • Reinicie o 9Router
   • Use a senha padrão novamente

Problema 5: Provedor mostra "Erro" ou "Offline"

Soluções:

1. Verifique sua chave API:
   • Está correta? Sem espaços extras?
   • Ainda é válida? (algumas expiram)
2. Verifique sua internet
3. Tente outro provedor do mesmo nível

Problema 6: Todas as requisições falham

Causa: Nenhum provedor configurado ou todos com problemas.

Solução:

1. Volte ao Dashboard
2. Configure pelo menos um provedor da categoria FREE
3. Verifique se ele está Online

---

9. Dicas úteis para iniciantes

9.1 Mantendo o 9Router rodando

• O 9Router precisa estar rodando para funcionar
• Não feche a janela do terminal enquanto estiver usando
• Você pode minimizar a janela, mas não fechá-la

9.2 Reiniciando o 9Router

Se algo parar de funcionar:

1. No terminal, pressione Ctrl + C para parar
2. Digite 9router novamente
3. Aguarde a mensagem "Ready to route! ✓"

9.3 Verificando o status

No Dashboard, você pode ver:

• Usage: Quanto você usou
• Active Provider: Qual provedor está ativo
• Quota: Limites restantes de cada serviço

9.4 Salvando sua configuração

• O 9Router salva suas configurações automaticamente
• O arquivo fica em: C:\Users\SeuNome\AppData\Roaming\9router\db.json
• Não edite este arquivo manualmente - use o Dashboard

9.5 Quando atualizar o 9Router

Execute este comando periodicamente:

npm update -g 9router

Isso garante que você tem a versão mais recente com correções de bugs.

---

📊 Resumo dos Comandos

---

🚀 Próximos Passos

Depois de dominar o básico, você pode:

1. Adicionar provedores pagos para mais opções
2. Configurar combinações de modelos para tarefas específicas
3. Monitorar uso através do Dashboard
4. Explorar integrações com outras ferramentas de IA

---

❓ Precisa de ajuda?

Se ainda tiver dúvidas:

• Documentação oficial: https://github.com/decolua/9router
• Site oficial: https://9router.com/
• Comunidade: Procure ajuda em fóruns ou grupos de usuários

---

Parabéns por completar este tutorial! 🎉

Agora você sabe como instalar, configurar e usar o 9Router no Windows 11. Continue praticando e explorando as funcionalidades para aproveitar ao máximo esta ferramenta poderosa!