> ## 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.
# Exécuter n8n localement avec CometAPI
> Utilisez ce guide pour exécuter n8n localement avec CometAPI en configurant les paramètres de déploiement local, les identifiants et l’accès au modèle.
Déployez n8n sur votre propre machine et connectez-le à CometAPI via le nœud communautaire pour exécuter localement des workflows d’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](https://www.cometapi.com/console/token)
Connectez-vous à la [console CometAPI](https://www.cometapi.com/console/token). Cliquez sur **Add API Key** et copiez votre clé API CometAPI.
n8n 1.x nécessite Node.js 18.x ou 20.x. L’approche recommandée est [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
```
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`.
```bash theme={null}
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é :
```bash theme={null}
export N8N_PORT=5679
n8n start
```
Pour laisser n8n s’exécuter après la fermeture du terminal :
```bash theme={null}
npm install -g pm2
pm2 start "n8n" --name n8n
pm2 save
pm2 status
```
Ouvrez [http://localhost:5678/](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.
1. Accédez à **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.
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.
1. Cliquez sur **+ New** en haut pour créer un workflow.
2. Cliquez sur **+** dans le canevas et recherchez **CometAPI** pour ajouter le nœud.
3. Ajoutez un nœud **Manual Trigger** et connectez-le au nœud CometAPI.
4. 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.com` et n’a généralement pas besoin d’être modifiée.
5. 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.
6. Cliquez sur **Execute step** pour exécuter le nœud. Le panneau **Output** affiche la réponse JSON.
* **Erreurs `node-gyp` ou 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 `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 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`.