> ## 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.
# Ejecuta n8n localmente con CometAPI
> Usa esta guía para ejecutar n8n localmente con CometAPI configurando los ajustes de despliegue local, las credenciales y el acceso a modelos.
Despliega n8n en tu propia máquina y conéctalo a CometAPI mediante el nodo de la comunidad para ejecutar flujos de trabajo de IA automatizados localmente.
## Requisitos previos
* Linux (Ubuntu/Debian/CentOS, etc.) o macOS
* 2 GB+ de RAM, 10 GB+ de espacio libre en disco
* Acceso a 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í](https://www.cometapi.com/console/token)
Inicia sesión en la [consola de CometAPI](https://www.cometapi.com/console/token). Haz clic en **Add API Key** y copia tu API key de CometAPI.
n8n 1.x requiere Node.js 18.x o 20.x. El enfoque recomendado es [nvm](https://github.com/nvm-sh/nvm):
```bash theme={null}
# 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`.
```bash theme={null}
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:
```bash theme={null}
export N8N_PORT=5679
n8n start
```
Para mantener n8n en ejecución después de cerrar la terminal:
```bash theme={null}
npm install -g pm2
pm2 start "n8n" --name n8n
pm2 save
pm2 status
```
Abre [http://localhost:5678/](http://localhost:5678/) en tu navegador. En la primera ejecución, el asistente de configuración te pedirá que crees una cuenta de **Owner** (correo electrónico + contraseña). Completa este paso e inicia sesión.
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 riesgos y haz clic en **Install**
Después de la instalación, puedes buscar **CometAPI** en el panel de nodos.
Si falta la sección Community Nodes: asegúrate de haber iniciado sesión como la cuenta **Owner** y revisa **Settings → Security** para confirmar que la instalación de nodos comunitarios está habilitada.
1. Haz clic en **+ New** en la parte superior para crear un workflow.
2. Haz clic en **+** en el lienzo y busca **CometAPI** para añadir el nodo.
3. Añade un nodo **Manual Trigger** y conéctalo al nodo de CometAPI.
4. En el nodo de CometAPI, en **Credential to connect with**, elige **Create new**. Pega tu API key de CometAPI en **CometAPI Key** y haz clic en **Save**. La Base URL predeterminada es `https://api.cometapi.com` y normalmente no necesita cambios.
5. Configura el nodo:
* **Model**: introduce el model ID actual que quieres usar
* **Messages**: establece Role como `user` y Content con tu prompt de prueba (por ejemplo, `Hello`)
* Opcional: añade un mensaje `system`, configura **Max Tokens**, **Temperature**, etc.
6. Haz clic en **Execute step** para ejecutar el nodo. El panel **Output** muestra la respuesta JSON.
* **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)** — establece `N8N_PORT=5679` (u otro puerto libre) antes de ejecutar `n8n start`.
* **Falta la sección Community Nodes** — inicia sesión como 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 model sea accesible en tu plan de CometAPI.
* **Respuestas vacías o errores de límite de token** — 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`.