Skip to main content
Implante o n8n na sua própria máquina e conecte-o ao CometAPI por meio do nó da comunidade para executar fluxos de trabalho automatizados de IA localmente.

​
Pré-requisitos

  • Linux (Ubuntu/Debian/CentOS, etc.) ou macOS
  • 2 GB+ de RAM, 10 GB+ de espaço livre em disco
  • Acesso ao shell com acesso ao registro público do npm
  • Node.js 18.x ou 20.x LTS (consulte a Etapa 1)
  • Uma conta CometAPI com uma chave de API ativa — obtenha a sua aqui
1

Obtenha sua chave de API da CometAPI

Faça login no console da CometAPI. Clique em Add API Key e copie sua chave de API da CometAPI.
Painel da CometAPI mostrando o botão Add API Key
Detalhes da chave de API da CometAPI com URL base
2

Instale o Node.js via nvm

O n8n 1.x requer Node.js 18.x ou 20.x. A abordagem recomendada é o nvm:
Se mais tarde você vir n8n: command not found, reinicie o terminal ou garanta que o diretório bin global do npm gerenciado pelo nvm esteja no seu PATH.
3

Instale e inicie o n8n

Se a porta 5678 já estiver em uso:
Para manter o n8n em execução após fechar o terminal:
Terminal mostrando o n8n iniciando com sucesso
Logs de inicialização do n8n no terminal
4

Crie sua conta Owner

Abra http://localhost:5678/ no navegador. Na primeira execução, o assistente de configuração solicita que você crie uma conta Owner (email + senha). Conclua isso e faça login.
Assistente de configuração da primeira execução do n8n solicitando os dados da conta Owner
5

Instale o nó da comunidade CometAPI

  1. Vá para Settings (canto inferior esquerdo) → Community nodes
  2. Clique em Install a community node
  3. Digite o nome do pacote: @cometapi-dev/n8n-nodes-cometapi
  4. Marque a caixa de reconhecimento de risco e clique em Install
Após a instalação, você poderá pesquisar por CometAPI no painel de nós.
Painel Settings do n8n mostrando a seção Community nodes
Caixa de diálogo de instalação com o nome do pacote CometAPI inserido
Se a seção Community Nodes estiver ausente: verifique se você está conectado com a conta Owner e confira em Settings → Security se a instalação de nós da comunidade está habilitada.
6

Crie um workflow e configure as credenciais

  1. Clique em + New no topo para criar um workflow.
  2. Clique em + na tela e pesquise por CometAPI para adicionar o nó.
Tela de workflow do n8n com a busca do nó CometAPI aberta
Nó CometAPI adicionado à tela do n8n
  1. Adicione um nó Manual Trigger e conecte-o ao nó CometAPI.
  2. No nó CometAPI, em Credential to connect with, escolha Create new. Cole sua chave de API da CometAPI em CometAPI Key e clique em Save. A Base URL vem por padrão como https://api.cometapi.com e normalmente não precisa ser alterada.
Caixa de diálogo de credenciais da CometAPI com a chave de API inserida
  1. Configure o nó:
  • Model: insira o model ID atual que você deseja usar
  • Messages: defina Role como user, Content como seu prompt de teste (por exemplo, Hello)
  • Opcional: adicione uma mensagem system, defina Max Tokens, Temperature etc.
  1. Clique em Execute step para executar o nó. O painel Output mostra a resposta JSON.
Painel de saída do n8n mostrando uma resposta JSON bem-sucedida da CometAPI
  • node-gyp ou erros de build nativo — instale as ferramentas de compilação: sudo apt install build-essential python3 (Debian/Ubuntu) ou Xcode Command Line Tools (macOS).
  • Erros de permissão do npm (EACCES) — use nvm para uma instalação do Node.js em nível de usuário; não é necessário sudo.
  • Conflito de porta (localhost:5678 indisponível) — defina N8N_PORT=5679 (ou outra porta livre) antes de executar n8n start.
  • Seção Community Nodes ausente — faça login com a conta Owner e verifique Settings → Security.
  • A instalação do npm falha em redes corporativas — configure um proxy: npm config set proxy http://user:pass@host:port
  • O nó CometAPI retorna 401/403 — verifique sua chave de API e se o model está acessível no seu plano CometAPI.
  • Respostas vazias ou erros de limite de token — aumente Max Tokens; ajuste Temperature e Top P conforme necessário.
  • O n8n para quando o terminal é fechado — use pm2: pm2 start "n8n" --name n8n && pm2 save.