Saltar para o conteúdo principal
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.
Painel da CometAPI mostrando o botão Add API Key
Detalhes da chave de API da CometAPI com a 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:
# 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
Terminal mostrando o n8n iniciando com sucesso
Logs de inicialização do n8n no terminal
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.
Assistente de configuração da primeira execução do n8n solicitando os detalhes 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á procurar por CometAPI no painel de nós.
Painel Settings do n8n mostrando a seção Community nodes
Janela de instalação com o nome do pacote CometAPI preenchido
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ó.
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 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.
Janela de credenciais do CometAPI com a chave de API preenchida
  1. 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.
  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
  • 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.