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


4
Créer votre compte owner
Ouvrez http://localhost:5678/ dans votre navigateur. Lors du premier démarrage, l’assistant de configuration vous demande de créer un compte Owner (email + mot de passe). Effectuez cette étape puis connectez-vous.

5
Installer le nœud communautaire CometAPI
- Accédez à Settings (en bas à gauche) → Community nodes
- Cliquez sur Install a community node
- Saisissez le nom du package :
@cometapi-dev/n8n-nodes-cometapi - Cochez la case d’acceptation des risques puis cliquez sur Install


Si la section Community Nodes est absente : assurez-vous d’être connecté avec le compte Owner, puis vérifiez dans Settings → Security que l’installation de nœuds communautaires est activée.
6
Créer un workflow et configurer les identifiants
- Cliquez sur + New en haut pour créer un workflow.
- Cliquez sur + dans le canevas et recherchez CometAPI pour ajouter le nœud.


- Ajoutez un nœud Manual Trigger et connectez-le au nœud CometAPI.
- Dans le nœud CometAPI, sous Credential to connect with, choisissez Create new. Collez votre clé API CometAPI dans CometAPI Key puis cliquez sur Save. L’URL de base est par défaut
https://api.cometapi.comet n’a généralement pas besoin d’être modifiée.

- Configurez le nœud :
- Model : saisissez le model ID 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.
- Cliquez sur Execute step pour exécuter le nœud. Le panneau Output affiche la réponse JSON.

Résolution des problèmes
Résolution des problèmes
- Erreurs
node-gypou de build natif — installez les outils de build :sudo apt install build-essential python3(Debian/Ubuntu) ou Xcode Command Line Tools (macOS). - Erreurs de permission npm (EACCES) — utilisez nvm pour une installation de Node.js au niveau utilisateur ; aucun
sudon’est nécessaire. - Conflit de port (
localhost:5678indisponible) — définissezN8N_PORT=5679(ou un autre port libre) avant d’exécutern8n 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 dans 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 à la fermeture du terminal — utilisez pm2 :
pm2 start "n8n" --name n8n && pm2 save.

