Passer au contenu principal

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.

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

Obtenir votre clé API CometAPI

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

Installer 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 binaire global npm géré par nvm est bien dans votre PATH.
3

Installer et démarrer 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 garder 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 montrant le démarrage réussi de n8n
Logs de démarrage de n8n dans le terminal
4

Créer 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 informations du compte Owner
5

Installer 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 d’acceptation 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 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

  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é <COMETAPI_KEY> dans CometAPI Key puis cliquez sur Save. L’URL de base est définie par défaut sur 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 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.
  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 Xcode Command Line Tools (macOS).
  • Erreurs de permission 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 des 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 tokens — augmentez Max Tokens ; ajustez Temperature et Top P selon les besoins.
  • n8n s’arrête lorsque le terminal se ferme — utilisez pm2 : pm2 start "n8n" --name n8n && pm2 save.