Saltar para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

Implante o n8n na sua própria máquina e conecte-o ao CometAPI por meio do nó da comunidade para executar workflows 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 alcance ao registro npm público
  • Node.js 18.x ou 20.x LTS (veja 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 do CometAPI. Clique em Add API Key e copie sua chave <COMETAPI_KEY>.
Painel do CometAPI mostrando o botão Add API Key
Detalhes da chave de API da CometAPI com base URL
2

Instale o Node.js via nvm

O n8n 1.x requer Node.js 18.x ou 20.x. A abordagem recomendada é 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 global bin 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 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 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. Insira 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 inserido
Se a seção Community Nodes estiver ausente: certifique-se de que você está conectado com a conta Owner e verifique em Settings → Security para confirmar que 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 + no canvas e procure por CometAPI para adicionar o nó.
Canvas de workflow do n8n com a busca do nó CometAPI aberta
Nó CometAPI adicionado ao canvas 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 <COMETAPI_KEY> em CometAPI Key e clique em Save. A Base URL tem como padrão https://api.cometapi.com e normalmente não precisa ser alterada.
Janela de credenciais do 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 com seu prompt de teste (ex.: 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 do CometAPI
  • node-gyp ou erros de build nativo — instale as ferramentas de build: 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 no nível do 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
  • 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.