Comment démarrer avec Hermès ? Installation et configuration pas à pas
Démarrer avec Hermès consiste à lancer une commande d'installation unique, choisir un fournisseur de modèle IA, puis activer les outils et canaux souhaités. Comptez 15 à 20 minutes pour une première session fonctionnelle sur Linux, macOS ou WSL2, sans droits administrateur particuliers.
Une commande d'installation, le choix d'un fournisseur de modèle IA, puis l'activation des outils suffisent pour avoir un premier agent Hermès opérationnel en moins de 20 minutes.
De quoi a-t-on besoin avant de commencer ?
Hermès s'installe sur Linux, macOS, WSL2, Windows natif ou Android (via Termux). Avant de lancer le script d'installation, quelques prérequis sont nécessaires.
Vérifiable avec git --version ; requis pour récupérer les mises à jour du projet.
Deux utilitaires système généralement déjà présents sur la plupart des distributions récentes.
Pour connecter Hermès à un modèle : Anthropic, OpenAI, OpenRouter, ou un compte Nous Portal.
Le script d'installation télécharge et configure lui-même le reste : gestionnaire de paquets Python, Python 3.11, Node.js v22 pour l'automatisation de navigateur, ripgrep pour la recherche de fichiers et ffmpeg pour la conversion audio, le tout sans droits administrateur.
Comment installer et configurer Hermès étape par étape ?
- Lancer le script d'installationDepuis un terminal :
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash(sous Windows PowerShell :iex (irm https://hermes-agent.nousresearch.com/install.ps1)). - Recharger le shellUne fois l'installation terminée, exécutez
source ~/.bashrcousource ~/.zshrcselon votre shell pour que la commandehermessoit reconnue. - Choisir un fournisseur de modèleLancez le sélecteur interactif
hermes model, ou passez directement parhermes setup --portalpour une connexion OAuth simplifiée via Nous Portal. - Lancer sa première sessionTapez
hermespour l'interface classique, ouhermes --tuipour l'interface terminale moderne recommandée. - Vérifier que tout fonctionneLa commande
hermes doctordiagnostique la configuration et signale les prérequis manquants.
Comment activer les premiers outils et une messagerie ?
Une fois la première session validée, deux commandes suffisent pour étendre les capacités de l'agent.
- Activer des outils :
hermes toolsliste les intégrations disponibles (recherche web, gestion de fichiers, génération d'images) à autoriser. - Connecter une messagerie :
hermes gateway setupouvre l'assistant de connexion à Telegram, Discord, Slack, WhatsApp, Signal ou Teams, pour piloter Hermès sans rester devant un terminal. - Parcourir des compétences prêtes à l'emploi :
hermes skills browsepuishermes skills installsuivi du nom d'une compétence pour l'ajouter sans avoir à la reconstruire soi-même.
Pour isoler l'exécution de code générée par l'agent du reste du système, la commande hermes config set terminal.backend docker bascule le terminal de Hermès dans un conteneur Docker sandboxé, une option recommandée sur un serveur mutualisé.
Quelles erreurs éviter au démarrage ?
Hermès a besoin d'un modèle offrant au moins 64 000 tokens de fenêtre de contexte. Choisir un modèle plus économique mais trop limité en contexte provoque des réponses tronquées ou des erreurs sur les tâches longues.
Autres points de vigilance fréquents : oublier de recharger le shell après l'installation (la commande hermes reste alors introuvable), et activer une passerelle de messagerie sans avoir d'abord restreint les outils autorisés dans hermes tools, ce qui laisse l'agent plus de latitude que nécessaire dès sa première utilisation.
Comment avons-nous installé Hermès en interne ?
Voici un exemple représentatif de notre méthode, sans donnée client ni promesse de résultat garantie.
Un serveur dédié plutôt qu'un poste de travail
Nous avons volontairement installé Hermès sur un petit serveur séparé de nos machines de travail habituelles, avec le terminal sandboxé activé dès le départ. Cette séparation nous permet de laisser l'agent tourner en continu sur des tâches de veille sans lui donner accès aux fichiers et identifiants utilisés au quotidien par l'équipe.
Quels contenus lire ensuite ?
Ces ressources complètent ce tutoriel sans cibler la même requête :
Questions fréquentes sur l'installation de Hermès
Combien de temps prend l'installation de Hermès ?
Le script d'installation lui-même prend quelques minutes. Comptez 15 à 20 minutes au total pour avoir une première session fonctionnelle avec un modèle et un outil connectés.
Peut-on installer Hermès sur Windows ?
Oui, via une commande PowerShell dédiée qui télécharge et configure l'agent nativement, sans passer par WSL2, bien que WSL2 reste également supporté.
Faut-il une clé API pour démarrer ?
Oui pour la plupart des fournisseurs (Anthropic, OpenAI, OpenRouter). La commande hermes setup --portal simplifie cette étape via une connexion OAuth à Nous Portal, sans manipuler de clé directement.
L'installation modifie-t-elle le système en profondeur ?
Non, le script installe ses dépendances (Python, Node.js, outils annexes) dans un environnement dédié à l'utilisateur, sans droits administrateur ni modification système globale, hors application desktop optionnelle.
Peut-on utiliser Hermès sans connexion Internet ?
Non pour la plupart des usages, l'agent devant contacter le fournisseur de modèle configuré. Connecter un endpoint personnalisé pointant vers un modèle local reste possible pour qui veut s'en affranchir.