Vai al contenuto principale

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.

Distribuisci n8n sulla tua macchina e collegalo a CometAPI tramite il nodo community per eseguire localmente workflow AI automatizzati.

​
Prerequisiti

  • Linux (Ubuntu/Debian/CentOS, ecc.) o macOS
  • 2 GB+ di RAM, 10 GB+ di spazio libero su disco
  • Accesso alla shell con accesso al registro npm pubblico
  • Node.js 18.x o 20.x LTS (vedi Step 1)
  • Un account CometAPI con una API key attiva — ottieni la tua qui
1

Ottieni la tua API key di CometAPI

Accedi alla console CometAPI. Fai clic su Add API Key e copia la tua chiave <COMETAPI_KEY>.
Dashboard CometAPI che mostra il pulsante Add API Key
Dettagli della API key di CometAPI con base URL
2

Installa Node.js tramite nvm

n8n 1.x richiede Node.js 18.x o 20.x. L’approccio consigliato è 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 in seguito vedi n8n: command not found, riavvia il terminale o assicurati che la directory bin globale npm gestita da nvm sia nel tuo PATH.
3

Installa e avvia n8n

npm install -g n8n
n8n -v       # verify the installed version
n8n start    # runs on http://localhost:5678/
Se la porta 5678 è già in uso:
export N8N_PORT=5679
n8n start
Per mantenere n8n in esecuzione dopo aver chiuso il terminale:
npm install -g pm2
pm2 start "n8n" --name n8n
pm2 save
pm2 status
Terminale che mostra n8n avviato correttamente
Log di avvio di n8n nel terminale
4

Crea il tuo account owner

Apri http://localhost:5678/ nel browser. Al primo avvio, la procedura guidata di configurazione ti chiede di creare un account Owner (email + password). Completa questo passaggio ed effettua l’accesso.
Procedura guidata di prima esecuzione di n8n che richiede i dettagli dell'account Owner
5

Installa il nodo community di CometAPI

  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 accettazione del rischio e fai clic su Install
Dopo l’installazione puoi cercare CometAPI nel pannello dei nodi.
Pannello Settings di n8n che mostra la sezione Community nodes
Finestra di installazione con il nome del pacchetto CometAPI inserito
Se la sezione Community Nodes manca: 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.
6

Crea un workflow e configura le credenziali

  1. Fai clic su + New in alto per creare un workflow.
  2. Fai clic su + nel canvas e cerca CometAPI per aggiungere il nodo.
Canvas del workflow di n8n con la ricerca del nodo CometAPI aperta
Nodo CometAPI aggiunto al canvas di n8n
  1. Aggiungi un nodo Manual Trigger e collegalo al nodo CometAPI.
  2. Nel nodo CometAPI, sotto Credential to connect with, scegli Create new. Incolla la tua chiave <COMETAPI_KEY> in CometAPI Key e fai clic su Save. Il Base URL predefinito è https://api.cometapi.com e in genere non richiede modifiche.
Finestra delle credenziali CometAPI con API key inserita
  1. Configura il nodo:
  • Model: inserisci il model ID corrente che vuoi utilizzare
  • Messages: imposta Role su user, Content sul tuo prompt di test (ad es. Hello)
  • Facoltativo: aggiungi un messaggio system, imposta Max Tokens, Temperature, ecc.
  1. Fai clic su Execute step per eseguire il nodo. Il pannello Output mostra la risposta JSON.
Pannello di output di n8n che mostra una risposta JSON di CometAPI riuscita
  • node-gyp o errori di build nativa — installa gli strumenti di build: 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 API key e che il model sia accessibile nel tuo piano CometAPI.
  • Risposte vuote o errori di limite 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.