Implantação Local do n8n

Implante o n8n localmente no Linux/macOS, instale o nó da comunidade CometAPI e configure credenciais de API para executar fluxos de trabalho automatizados na sua máquina.

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 (veja o Passo 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 sk-xxxxx.

   

   
2. Instale o Node.js via nvm

   O n8n 1.x requer Node.js 18.x ou 20.x. A abordagem recomendada é o nvm:

   # Install nvm
   curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
   
   # Reload your shell profile
   source ~/.bashrc   # or ~/.zshrc on macOS
   
   # Install and activate the LTS version
   nvm install --lts
   nvm use --lts
   
   # Verify
   node -v
   npm -v
   

   Se você vir n8n: command not found depois, 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

   npm install -g n8n
   n8n -v       # verify the installed version
   n8n start    # runs on http://localhost:5678/
   

   Se a porta 5678 já estiver em uso:

   export N8N_PORT=5679
   n8n start
   

   Para manter o n8n em execução após fechar o terminal:

   npm install -g pm2
   pm2 start "n8n" --name n8n
   pm2 save
   pm2 status
   

   

   
4. Crie sua conta de proprietário

   Abra http://localhost:5678/ no navegador. Na primeira execução, o assistente de configuração solicita que você crie uma conta Owner (e-mail + senha). Conclua isso e faça login.

   
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á procurar por CometAPI no painel de nós.

   

   

   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 procure por CometAPI para adicionar o nó.

   

   

   3. Adicione um nó Manual Trigger e conecte-o ao nó CometAPI.
   4. No nó CometAPI, em Credential to connect with, escolha Create new. Cole sua chave sk-xxxxx em CometAPI Key e clique em Save. A Base URL é definida por padrão como https://api.cometapi.com e normalmente não precisa ser alterada.

   

   5. Configure o nó:

   • Model: insira o ID do modelo atual que deseja usar
   • Messages: defina Role como user, Content com seu Prompt de teste (por exemplo, Hello)
   • Opcional: adicione uma mensagem system, defina Max Tokens, Temperature, etc.

   6. Clique em Execute step para executar o nó. O painel Output mostra a resposta JSON.

   

Solução de problemas

• Erros de node-gyp ou 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 o 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.
• npm install 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 modelo 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.