Installer Nod, l’agent IA personnel de n8n : le guide pas à pas

Nod est un agent IA personnel publié par n8n Labs : vous lui parlez dans un seul chat, et il travaille dans son propre espace Linux avec son propre navigateur. Il s’installe en une dizaine de minutes sur Mac, sur Windows 11 ou sur votre serveur, il est gratuit et open source (licence Apache 2.0), et c’est vous qui branchez le modèle d’IA de votre choix. Ce guide suit l’installation dans l’ordre : prérequis, installation, premier lancement, modèle, applications, budget, puis auto-hébergement.

Ce qu’il vous faut avant de commencer

Un ordinateur récent et une clé d’API (ou un abonnement ChatGPT) suffisent ; l’application elle-même ne coûte rien.

Élément	Détail
Mac	macOS 14 ou plus récent, puce Apple ou Intel
Windows	Windows 11, en preview
Serveur (option)	Linux AMD64 ou ARM64 avec Docker, ou un Mac avec Docker Desktop
Espace disque	Environ 1,8 Go à télécharger pour l’assistant local
Modèle d’IA	Clé OpenAI, Anthropic, Google Gemini ou OpenRouter, abonnement ChatGPT, ou modèle local (Ollama)
Prix de Nod	Gratuit ; votre fournisseur de modèle vous facture directement

Nod est une application distincte de l’AI Assistant intégré à n8n : vous n’avez besoin ni d’un compte n8n, ni d’une instance n8n pour l’utiliser.

Étape 1 : installer l’application

Sur Mac, l’installation passe par un fichier DMG ; sur Windows, par un installateur à lancer sans droits administrateur.

Sur Mac

1. Téléchargez le DMG depuis le bouton « Download for Mac » du site, ou depuis les releases GitHub : nod-arm64.dmg pour une puce Apple, nod-x64.dmg pour un Mac Intel.
2. Ouvrez le fichier et glissez Nod dans le dossier Applications.
3. Lancez Nod, puis confirmez l’ouverture quand macOS signale une application téléchargée sur Internet.

La documentation propose aussi une installation par le Terminal, avec un script à lancer depuis votre compte habituel. La consigne de n8n est claire : exécutez-le sans sudo.

Sur Windows 11

Lancez l’installateur dans une fenêtre PowerShell normale, et non avec « Exécuter en tant qu’administrateur ».

Étape 2 : le premier lancement

Au premier démarrage, Nod vous propose deux chemins :

• Get started pour un assistant local, sur votre ordinateur ;
• Connect to a server si vous avez déjà installé Nod sur un serveur (voir l’étape 6).

L’assistant de démarrage vous fait ensuite connecter une adresse e-mail (facultatif), choisir un modèle et activer les notifications (« Enable notifications »). Activez-les : c’est par là que Nod vous demande votre accord avant d’agir.

Étape 3 : connecter un modèle d’IA

Chaque assistant a besoin d’une connexion à un modèle, que vous gérez depuis Settings, en bas de la barre latérale, puis Models.

1. Cliquez sur Add connection et cherchez votre fournisseur.
2. Pour OpenAI par exemple : OpenAI, puis Use an API key, collez la clé dans le champ API key et cliquez sur Connect.
3. Pour changer de modèle, cliquez sur Change à côté de Your model.

Quelques points à connaître selon le fournisseur :

Fournisseur	Connexion	À savoir
Google Gemini	Clé AI Studio	Gemini 3.8 Flash a un niveau gratuit, dans la limite des quotas Google
OpenAI / ChatGPT	Clé d’API ou connexion ChatGPT	Avec l’abonnement ChatGPT, l’usage est décompté sur votre forfait
Anthropic	Clé d’API uniquement	Un abonnement Claude ne suffit pas, d’après la documentation
OpenRouter	Clé d’API ou connexion par navigateur	Donne accès à de nombreux modèles
Modèle local	Serveur compatible OpenAI (Ollama)	Aucun coût par requête

Les clés sont chiffrées : Nod les range dans le Trousseau sur Mac et via DPAPI sur Windows.

Étape 4 : brancher vos applications

Nod se connecte en une seule authentification à Gmail, Google Agenda, Google Drive, Slack, Notion ou Linear. La même conversation vous suit dans l’application, dans le navigateur, sur Telegram et sur WhatsApp.

Commencez par une seule application, celle qui correspond à votre première tâche : Gmail et l’agenda pour les briefs d’avant-call, par exemple. Vous ajouterez les autres une fois le fonctionnement compris.

Étape 5 : fixer un budget avant la première tâche

Nod ne facture rien, mais chaque tâche consomme des appels au modèle. Deux réglages évitent les mauvaises surprises.

1. Un plafond mensuel. Ouvrez Usage dans la barre latérale (⌘5 sur Mac, Ctrl+5 sur Windows), cliquez sur no monthly limit, saisissez un montant en dollars (à partir de 1 $) et cliquez sur Save. Une fois le plafond atteint, les nouveaux messages, les tâches planifiées et le travail en arrière-plan s’arrêtent jusqu’au mois suivant.
2. Le seuil par tâche. Par défaut, une tâche se met en pause à 5 $ et vous demande si elle continue. Pour le modifier, demandez-le simplement à Nod dans le chat.

Étape 6 (option) : héberger Nod sur votre serveur

L’auto-hébergement sert surtout à garder Nod sur une machine dédiée plutôt que sur votre ordinateur portable. La documentation recommande au départ 2 cœurs, 8 Go de mémoire et 50 Go de disque, avec Docker Engine 25 ou plus récent et Compose v2.

Depuis les sources :

git clone https://github.com/n8n-io/nod.git
cd nod/deployment/self-host
sh setup.sh
docker compose up -d --build --wait

Ouvrez ensuite http://localhost:4310, copiez la valeur NOD_AUTH_TOKEN du fichier .env du serveur et terminez la configuration. Depuis l’application de bureau, choisissez Connect to a server et saisissez l’adresse du serveur et ce jeton.

Pour un serveur distant sans nom de domaine, passez par un tunnel SSH : ssh -L 4310:127.0.0.1:4310 utilisateur@adresse-du-serveur. Avec un domaine, renseignez NOD_PUBLIC_URL dans le .env et démarrez avec le profil https : Caddy s’occupe du certificat.

Un serveur correspond à une seule personne, et son jeton donne un accès complet à votre assistant et à vos comptes : gardez-le comme un mot de passe.

Les limites à connaître

Nod est un aperçu de recherche, et plusieurs fonctions annoncées n’existent pas encore.

• L’assistant local travaille seulement quand Nod est ouvert et l’ordinateur allumé. Les tâches planifiées attendent le réveil de la machine.
• La version hébergée, qui tournera ordinateur fermé, est annoncée « bientôt ».
• Un Nod appartient à une seule personne. Le partage entre plusieurs utilisateurs est prévu.
• Deux installations séparées ne synchronisent pas leurs données.
• Les statistiques d’usage sont activées par défaut ; vous pouvez les désactiver dans Settings, puis Privacy & data.

Vos données, la mémoire de l’agent et vos identifiants enregistrés restent sur votre machine, et les requêtes partent uniquement vers le fournisseur de modèle que vous avez choisi.