Saltar al contenido principal
Despliega n8n en tu propia máquina y conéctalo a CometAPI mediante el nodo comunitario para ejecutar localmente flujos de trabajo automatizados de IA.

​
Prerrequisitos

  • Linux (Ubuntu/Debian/CentOS, etc.) o macOS
  • 2 GB+ de RAM, 10 GB+ de espacio libre en disco
  • Acceso al shell con alcance al registro público de npm
  • Node.js 18.x o 20.x LTS (consulta el Paso 1)
  • Una cuenta de CometAPI con una API key activa — obtén la tuya aquí
1

Obtén tu API key de CometAPI

Inicia sesión en la consola de CometAPI. Haz clic en Add API Key y copia tu clave sk-xxxxx.
Panel de CometAPI mostrando el botón Add API Key
Detalles de la API key de CometAPI con la URL base
2

Instala Node.js mediante nvm

n8n 1.x requiere Node.js 18.x o 20.x. El enfoque recomendado es 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
Si más adelante ves n8n: command not found, reinicia la terminal o asegúrate de que el directorio global bin de npm administrado por nvm esté en tu PATH.
3

Instala e inicia n8n

npm install -g n8n
n8n -v       # verify the installed version
n8n start    # runs on http://localhost:5678/
Si el puerto 5678 ya está en uso:
export N8N_PORT=5679
n8n start
Para mantener n8n en ejecución después de cerrar la terminal:
npm install -g pm2
pm2 start "n8n" --name n8n
pm2 save
pm2 status
Terminal mostrando que n8n se inició correctamente
Registros de inicio de n8n en la terminal
4

Crea tu cuenta de propietario

Abre http://localhost:5678/ en tu navegador. En la primera ejecución, el asistente de configuración te pide crear una cuenta Owner (correo electrónico + contraseña). Completa este paso e inicia sesión.
Asistente de configuración inicial de n8n solicitando los datos de la cuenta Owner
5

Instala el nodo comunitario de CometAPI

  1. Ve a Settings (abajo a la izquierda) → Community nodes
  2. Haz clic en Install a community node
  3. Introduce el nombre del paquete: @cometapi-dev/n8n-nodes-cometapi
  4. Marca la casilla de reconocimiento de riesgo y haz clic en Install
Después de la instalación, puedes buscar CometAPI en el panel de nodos.
Panel de Settings de n8n mostrando la sección Community nodes
Diálogo de instalación con el nombre del paquete de CometAPI introducido
Si falta la sección Community Nodes: asegúrate de haber iniciado sesión con la cuenta Owner, y revisa Settings → Security para confirmar que la instalación de nodos comunitarios está habilitada.
6

Crea un workflow y configura las credenciales

  1. Haz clic en + New en la parte superior para crear un workflow.
  2. Haz clic en + en el lienzo y busca CometAPI para agregar el nodo.
Lienzo de workflow de n8n con la búsqueda del nodo CometAPI abierta
Nodo CometAPI agregado al lienzo de n8n
  1. Agrega un nodo Manual Trigger y conéctalo al nodo de CometAPI.
  2. En el nodo de CometAPI, en Credential to connect with, elige Create new. Pega tu clave sk-xxxxx en CometAPI Key y haz clic en Save. La Base URL por defecto es https://api.cometapi.com y normalmente no necesita cambios.
Diálogo de credenciales de CometAPI con la API key introducida
  1. Configura el nodo:
  • Model: introduce el ID del modelo actual que quieres usar
  • Messages: establece Role en user, Content con tu prompt de prueba (por ejemplo, Hello)
  • Opcional: agrega un mensaje system, configura Max Tokens, Temperature, etc.
  1. Haz clic en Execute step para ejecutar el nodo. El panel Output muestra la respuesta JSON.
Panel de salida de n8n mostrando una respuesta JSON correcta de CometAPI
  • Errores de node-gyp o de compilación nativa — instala las herramientas de compilación: sudo apt install build-essential python3 (Debian/Ubuntu) o Xcode Command Line Tools (macOS).
  • Errores de permisos de npm (EACCES) — usa nvm para una instalación de Node.js a nivel de usuario; no se necesita sudo.
  • Conflicto de puertos (localhost:5678 no disponible) — configura N8N_PORT=5679 (u otro puerto libre) antes de ejecutar n8n start.
  • Falta la sección Community Nodes — inicia sesión con la cuenta Owner y revisa Settings → Security.
  • npm install falla en redes corporativas — configura un proxy: npm config set proxy http://user:pass@host:port
  • El nodo de CometAPI devuelve 401/403 — verifica tu API key y que el modelo esté accesible en tu plan de CometAPI.
  • Respuestas vacías o errores de límite de tokens — aumenta Max Tokens; ajusta Temperature y Top P según sea necesario.
  • n8n se detiene al cerrar la terminal — usa pm2: pm2 start "n8n" --name n8n && pm2 save.