Passer au contenu principal
Déployez n8n sur votre propre machine et connectez-le à CometAPI via le nœud communautaire pour exécuter localement des workflows IA automatisés.

​
Prérequis

  • Linux (Ubuntu/Debian/CentOS, etc.) ou macOS
  • 2 Go+ de RAM, 10 Go+ d’espace disque libre
  • Accès au shell avec accès au registre npm public
  • Node.js 18.x ou 20.x LTS (voir l’étape 1)
  • Un compte CometAPI avec une clé API active — obtenez la vôtre ici
1

Obtenez votre clé API CometAPI

Connectez-vous à la console CometAPI. Cliquez sur Add API Key et copiez votre clé sk-xxxxx.
Tableau de bord CometAPI affichant le bouton Add API Key
Détails de la clé API CometAPI avec l’URL de base
2

Installez Node.js via nvm

n8n 1.x nécessite Node.js 18.x ou 20.x. L’approche recommandée est 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 vous voyez n8n: command not found plus tard, redémarrez le terminal ou assurez-vous que le répertoire global bin npm géré par nvm est bien dans votre PATH.
3

Installez et démarrez n8n

npm install -g n8n
n8n -v       # verify the installed version
n8n start    # runs on http://localhost:5678/
Si le port 5678 est déjà utilisé :
export N8N_PORT=5679
n8n start
Pour maintenir n8n en cours d’exécution après la fermeture du terminal :
npm install -g pm2
pm2 start "n8n" --name n8n
pm2 save
pm2 status
Terminal affichant le démarrage réussi de n8n
Journaux de démarrage de n8n dans le terminal
4

Créez votre compte propriétaire

Ouvrez http://localhost:5678/ dans votre navigateur. Lors du premier lancement, l’assistant de configuration vous demande de créer un compte Owner (e-mail + mot de passe). Terminez cette étape puis connectez-vous.
Assistant de configuration du premier lancement de n8n demandant les détails du compte Owner
5

Installez le nœud communautaire CometAPI

  1. Allez dans Settings (en bas à gauche) → Community nodes
  2. Cliquez sur Install a community node
  3. Saisissez le nom du package : @cometapi-dev/n8n-nodes-cometapi
  4. Cochez la case de reconnaissance des risques puis cliquez sur Install
Après l’installation, vous pouvez rechercher CometAPI dans le panneau des nœuds.
Panneau Settings de n8n affichant la section Community nodes
Boîte de dialogue d’installation avec le nom du package CometAPI saisi
Si la section Community Nodes n’apparaît pas : assurez-vous d’être connecté avec le compte Owner, puis vérifiez dans Settings → Security que l’installation des nœuds communautaires est activée.
6

Créez un workflow et configurez les identifiants

  1. Cliquez sur + New en haut pour créer un workflow.
  2. Cliquez sur + sur le canevas et recherchez CometAPI pour ajouter le nœud.
Canevas de workflow n8n avec la recherche du nœud CometAPI ouverte
Nœud CometAPI ajouté au canevas n8n
  1. Ajoutez un nœud Manual Trigger et connectez-le au nœud CometAPI.
  2. Dans le nœud CometAPI, sous Credential to connect with, choisissez Create new. Collez votre clé sk-xxxxx dans CometAPI Key puis cliquez sur Save. L’URL de base est par défaut https://api.cometapi.com et n’a généralement pas besoin d’être modifiée.
Boîte de dialogue des identifiants CometAPI avec la clé API saisie
  1. Configurez le nœud :
  • Model : saisissez l’ID du modèle actuel que vous souhaitez utiliser
  • Messages : définissez Role sur user, Content sur votre prompt de test (par ex. Hello)
  • Facultatif : ajoutez un message system, définissez Max Tokens, Temperature, etc.
  1. Cliquez sur Execute step pour exécuter le nœud. Le panneau Output affiche la réponse JSON.
Panneau de sortie n8n affichant une réponse JSON CometAPI réussie
  • Erreurs node-gyp ou de build natif — installez les outils de compilation : sudo apt install build-essential python3 (Debian/Ubuntu) ou les Xcode Command Line Tools (macOS).
  • Erreurs de permissions npm (EACCES) — utilisez nvm pour une installation de Node.js au niveau utilisateur ; aucun sudo n’est nécessaire.
  • Conflit de port (localhost:5678 indisponible) — définissez N8N_PORT=5679 (ou un autre port libre) avant d’exécuter n8n start.
  • Section Community Nodes absente — connectez-vous avec le compte Owner et vérifiez Settings → Security.
  • Échec de npm install sur les réseaux d’entreprise — configurez un proxy : npm config set proxy http://user:pass@host:port
  • Le nœud CometAPI renvoie 401/403 — vérifiez votre clé API et que le modèle est accessible avec votre offre CometAPI.
  • Réponses vides ou erreurs de limite de token — augmentez Max Tokens ; ajustez Temperature et Top P selon les besoins.
  • n8n s’arrête quand le terminal se ferme — utilisez pm2 : pm2 start "n8n" --name n8n && pm2 save.