> ## 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.
# Esegui n8n in locale con CometAPI
> Usa questa guida per eseguire n8n in locale con CometAPI configurando le impostazioni di distribuzione locale, le credenziali e l'accesso ai modelli.
Distribuisci n8n sulla tua macchina e collegalo a CometAPI tramite il nodo della community per eseguire workflow AI automatizzati in locale.
## Prerequisiti
* Linux (Ubuntu/Debian/CentOS, ecc.) oppure macOS
* 2 GB+ di RAM, 10 GB+ di spazio libero su disco
* Accesso alla shell con connettività al registro npm pubblico
* Node.js 18.x o 20.x LTS (vedi Passo 1)
* Un account CometAPI con una chiave API attiva — [ottieni la tua qui](https://www.cometapi.com/console/token)
Accedi alla [console CometAPI](https://www.cometapi.com/console/token). Fai clic su **Add API Key** e copia la tua chiave API CometAPI.
n8n 1.x richiede Node.js 18.x o 20.x. L'approccio consigliato è [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
```
Se in seguito vedi `n8n: command not found`, riavvia il terminale oppure assicurati che la directory bin globale di npm gestita da nvm sia nel tuo `PATH`.
```bash theme={null}
npm install -g n8n
n8n -v # verify the installed version
n8n start # runs on http://localhost:5678/
```
Se la porta 5678 è già in uso:
```bash theme={null}
export N8N_PORT=5679
n8n start
```
Per mantenere n8n in esecuzione dopo aver chiuso il terminale:
```bash theme={null}
npm install -g pm2
pm2 start "n8n" --name n8n
pm2 save
pm2 status
```
Apri [http://localhost:5678/](http://localhost:5678/) nel browser. Al primo avvio, la procedura guidata di configurazione ti chiederà di creare un account **Owner** (email + password). Completa questo passaggio ed effettua l'accesso.
1. Vai su **Settings** (in basso a sinistra) → **Community nodes**
2. Fai clic su **Install a community node**
3. Inserisci il nome del pacchetto: `@cometapi-dev/n8n-nodes-cometapi`
4. Seleziona la casella di conferma del rischio e fai clic su **Install**
Dopo l'installazione puoi cercare **CometAPI** nel pannello dei nodi.
Se manca la sezione Community Nodes: assicurati di aver effettuato l'accesso con l'account **Owner** e controlla in **Settings → Security** per confermare che l'installazione dei community node sia abilitata.
1. Fai clic su **+ New** in alto per creare un workflow.
2. Fai clic su **+** nell'area di lavoro e cerca **CometAPI** per aggiungere il nodo.
3. Aggiungi un nodo **Manual Trigger** e collegalo al nodo CometAPI.
4. Nel nodo CometAPI, in **Credential to connect with**, scegli **Create new**. Incolla la tua chiave API CometAPI in **CometAPI Key** e fai clic su **Save**. Il Base URL è impostato per default su `https://api.cometapi.com` e in genere non richiede modifiche.
5. Configura il nodo:
* **Model**: inserisci il model ID corrente che vuoi usare
* **Messages**: imposta Role su `user`, Content sul tuo prompt di test (ad esempio `Hello`)
* Facoltativo: aggiungi un messaggio `system`, imposta **Max Tokens**, **Temperature**, ecc.
6. Fai clic su **Execute step** per eseguire il nodo. Il pannello **Output** mostra la risposta JSON.
* **`node-gyp` o errori di build native** — installa gli strumenti di compilazione: `sudo apt install build-essential python3` (Debian/Ubuntu) oppure Xcode Command Line Tools (macOS).
* **Errori di autorizzazione npm (EACCES)** — usa nvm per un'installazione di Node.js a livello utente; non serve `sudo`.
* **Conflitto di porta (`localhost:5678` non disponibile)** — imposta `N8N_PORT=5679` (o un'altra porta libera) prima di eseguire `n8n start`.
* **Sezione Community Nodes mancante** — accedi con l'account **Owner** e controlla **Settings → Security**.
* **`npm install` non riesce sulle reti aziendali** — configura un proxy: `npm config set proxy http://user:pass@host:port`
* **Il nodo CometAPI restituisce 401/403** — verifica la tua chiave API e che il modello sia accessibile nel tuo piano CometAPI.
* **Risposte vuote o errori di limite dei token** — aumenta **Max Tokens**; regola **Temperature** e **Top P** secondo necessità.
* **n8n si arresta quando il terminale viene chiuso** — usa pm2: `pm2 start "n8n" --name n8n && pm2 save`.