Installation de Hermes et configuration avec OmniProxy

Hermes est un assistant capable de conserver l’historique des conversations et l’expérience acquise lors des tâches. Les opérations déjà réalisées peuvent être organisées sous forme de compétences réutilisables. Il peut également se connecter à Telegram, Discord, Slack, WhatsApp, Signal et au terminal par l’intermédiaire d’une même Gateway. Celle-ci sert de point d’entrée commun pour recevoir et transmettre les messages. Depuis votre outil de messagerie habituel, vous pouvez lui confier une revue de code, un compte rendu d’incident ou des documents destinés à un client, puis lui demander de poursuivre le traitement dans le dépôt.

Préparation avant l’installation

Commencez par choisir la méthode d’installation correspondant à votre système. Sur macOS et Windows, vous pouvez utiliser directement un programme d’installation graphique. Sous Linux, macOS et WSL2, vous pouvez utiliser le script dans le terminal. WSL2 est une fonctionnalité permettant d’exécuter un environnement Linux sous Windows. Il existe également des méthodes spécifiques pour Termux sur Android et pour Docker, mais ce guide couvre uniquement l’installation sur un ordinateur classique.

Pour une interface graphique

macOS et Windows

• macOS : ouvrir le DMG
• Windows : ouvrir le programme d’installation
• Installer l’application sur le système

Pour le terminal uniquement

Linux, macOS et WSL2

• Une seule commande install.sh
• Sous Windows, utiliser install.ps1
• Après l’installation, saisir hermes

À éviter pour le moment

pip, brew et AUR

• Ces méthodes d’installation ne sont pas officiellement prises en charge
• Les mises à jour seront également difficiles
• Utiliser plutôt l’une des deux méthodes à gauche

Avant de commencer, préparez un ordinateur sous macOS, Windows ou Linux, puis vérifiez qu’il peut ouvrir un terminal et accéder à GitHub. Si vous prévoyez une installation sur un disque externe, connectez-le d’abord et vérifiez qu’il dispose de suffisamment d’espace.

Installation et premier démarrage

Pour utiliser une application graphique

Accédez à la section de téléchargement du site de Hermes, puis téléchargez le programme d’installation correspondant à votre système. L’environnement d’exécution est déjà inclus, il n’est donc pas nécessaire de compiler le programme sur votre ordinateur lors du premier lancement.

• macOS : ouvrez le fichier DMG et placez Hermes.app dans « Applications ». Le format DMG est couramment utilisé pour les images d’installation sous macOS. Ce programme d’installation prend uniquement en charge les puces Apple ; les Mac Intel ne sont pas compatibles.
• Windows : ouvrez le fichier .appinstaller avec le programme d’installation d’applications de Windows. Celui-ci installe un paquet MSIX signé, un format de paquet d’application utilisé par Windows.
• Linux : les programmes d’installation graphiques sont destinés à macOS et Windows. Sous Linux, utilisez la commande de terminal ci-dessous. Après l’installation, vous pourrez exécuter hermes desktop.

Pour utiliser uniquement le terminal

Sous Linux, macOS ou WSL2, exécutez cette commande dans le terminal :

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Avec le PowerShell intégré à Windows, exécutez :

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

Le programme d’installation télécharge le code de Hermes ainsi que les composants nécessaires à son exécution. Si le téléchargement est interrompu, exécutez de nouveau la même commande. Une fois l’installation terminée, fermez le terminal actuel, ouvrez-en un nouveau, puis saisissez :

hermes

Si l’invite de Hermes apparaît, la commande est prête à être utilisée. Vous pouvez ensuite exécuter hermes doctor. Cette vérification de l’installation vous indiquera les éventuels éléments manquants.

Installation du programme sur un disque externe

Le 9 octobre 2026, Hermes Agent v0.21.6 a été installé sur le disque externe d’un Mac. Le programme se trouve dans /Volumes/AItools/tools/hermes-agent, la commande de lancement dans ~/.local/bin/hermes, tandis que la configuration et les conversations restent enregistrées dans ~/.hermes.

Si votre disque porte un autre nom, remplacez le chemin qui suit --dir par celui de votre propre dossier. Le disque doit rester connecté pendant l’exécution de Hermes.

curl -fsSL https://hermes-agent.nousresearch.com/install.sh -o install.sh
bash install.sh --dir /Volumes/AItools/tools/hermes-agent --non-interactive

Programme

Disque dur externe

• tools/hermes-agent
• Le code se trouve ici

Commande

~/.local/bin/hermes

• Saisir hermes dans le terminal
• La modification prend effet après l’ouverture d’une nouvelle fenêtre

Configuration et conversations

~/.hermes

• config.yaml se trouve ici
• Quitter avant de débrancher le disque

Obtention des paramètres de connexion depuis OmniProxy

Dans cette configuration, Hermes se connecte à OmniProxy, et non directement à Grok ou Gemini. Les adresses des services Grok et Gemini sont configurées dans OmniProxy ; ne les saisissez pas directement dans Hermes.

Votre ordinateur

Hermes

→

Passerelle locale

OmniProxy

• Terminer l’adresse par /v1

→

Grok

• grok-4.7

Gemini

• gemini-3.8-flash

L’ID de modèle est le nom exact utilisé par l’API pour identifier le modèle. Utilisez les noms suivants pour les deux modèles :

• Pour Grok, saisissez grok-4.7. L’API de xAI se trouve à l’adresse https://api.x.ai/v1 et les requêtes de chat passent par /v1/chat/completions. Consultez la documentation des modèles Grok.
• Pour Gemini, saisissez gemini-3.8-flash. L’API de Google compatible avec OpenAI se trouve à l’adresse https://generativelanguage.googleapis.com/v1beta/openai/. Consultez les instructions de compatibilité OpenAI de Gemini.

Pour utiliser Gemini dans Hermes, il suffit de remplacer le nom du modèle par gemini-3.8-flash. L’adresse de l’API reste celle d’OmniProxy.

Copiez l’adresse de l’API et la clé depuis OmniProxy, puis indiquez l’ID de modèle correspondant :

Base URL: https://your-omniproxy-origin.example/v1
API Key:  <YOUR_OMNIPROXY_API_KEY>
Model ID: grok-4.7

Base URL est l’adresse à laquelle Hermes envoie ses requêtes. Elle doit ici se terminer par /v1. API Key est la clé fournie à Hermes par OmniProxy. Remplacez-la par votre propre clé et ne la publiez pas sur une page accessible au public.

Si l’instance locale d’OmniProxy n’exige pas de clé, le champ API Key peut rester vide. Dès que l’adresse est accessible à d’autres personnes, vous devez utiliser une clé. Vérifiez également que cette adresse est accessible depuis l’environnement dans lequel Hermes s’exécute. Si Hermes et OmniProxy se trouvent sur le même ordinateur, vous pouvez utiliser une adresse locale.

Saisie de la configuration de l’outil

Quittez d’abord la conversation en cours, puis exécutez cette commande dans le terminal :

hermes model

Sélectionnez Custom endpoint (self-hosted / VLLM / etc.). Custom endpoint désigne une API personnalisée : Hermes se connectera à l’adresse de service que vous indiquez, au lieu d’utiliser un fournisseur prédéfini.

L’assistant de configuration vous demandera successivement l’adresse de l’API, la clé et le nom du modèle. Saisissez les trois valeurs indiquées dans la section précédente. Pour utiliser Gemini, indiquez gemini-3.8-flash comme nom de modèle.

Vous pouvez également modifier directement ~/.hermes/config.yaml. YAML est un format texte qui utilise l’indentation pour représenter les relations entre les paramètres. Voici la configuration pour Grok :

model:
  default: grok-4.7
  provider: custom
  base_url: https://your-omniproxy-origin.example/v1
  api_key: <YOUR_OMNIPROXY_API_KEY>

Pour utiliser Gemini, remplacez la valeur de default par gemini-3.8-flash. Les trois autres paramètres restent inchangés :

model:
  default: gemini-3.8-flash
  provider: custom
  base_url: https://your-omniproxy-origin.example/v1
  api_key: <YOUR_OMNIPROXY_API_KEY>

Après l’enregistrement, relancez hermes, puis démarrez une conversation. Dans une session déjà ouverte, /model permet uniquement de basculer entre les fournisseurs déjà enregistrés ; cette commande ne permet pas d’ajouter la configuration décrite ici.

Vérification avec une tâche réelle

1

hermes doctor

• La vérification de l’installation réussit

2

Envoyer une courte phrase

• Une réponse de Hermes apparaît

3

Ouvrir le journal des appels

• Vérifier le nom du modèle

1. Exécutez hermes doctor pour vérifier que l’installation est complète.
2. Exécutez hermes, puis demandez-lui d’expliquer en une phrase ce qu’il peut faire. Une réponse doit apparaître.
3. Ouvrez le journal des appels d’OmniProxy, vérifiez que cette requête provient de Hermes et assurez-vous que le nom du modèle est grok-4.7 ou gemini-3.8-flash.

Le simple fait que l’assistant de configuration ait correctement enregistré les paramètres ou que l’API ait renvoyé une réponse positive ne suffit pas à démontrer que Hermes peut accomplir une tâche pour vous. Le nom du modèle dans le journal des appels doit correspondre exactement à celui que vous avez saisi.

Pour discuter dans un navigateur, exécutez localement :

hermes dashboard --no-open --host 127.0.0.1 --port 9119

Ouvrez ensuite http://127.0.0.1:9119. Cette adresse fonctionne uniquement sur l’ordinateur actuel.

Erreurs courantes

• La commande hermes est introuvable : fermez d’abord le terminal, puis ouvrez-en un nouveau. Si la commande reste introuvable, vérifiez que ~/.local/bin figure dans PATH. PATH est la liste des emplacements dans lesquels le système recherche les commandes. Sous Windows, vérifiez que le dossier de lancement ajouté par le programme d’installation figure dans PATH.
• Le téléchargement de l’installation s’interrompt : exécutez de nouveau la même commande d’installation. Les éléments déjà téléchargés seront réutilisés.
• Hermes ne répond pas ou indique qu’il ne peut pas se connecter : vérifiez qu’OmniProxy est en cours d’exécution et que Base URL se termine par /v1. Si Hermes s’exécute dans Docker alors qu’OmniProxy s’exécute sur la machine hôte, n’utilisez pas l’adresse 127.0.0.1, qui n’est valable qu’à l’intérieur du conteneur.
• Une erreur de clé est signalée : mettez à jour la clé d’OmniProxy, puis modifiez la valeur api_key dans config.yaml. Les clés de xAI ou de Google font partie de la configuration des fournisseurs d’OmniProxy et ne doivent pas être saisies dans ce champ de Hermes.
• Le modèle est indiqué comme inexistant : ouvrez la liste actuelle des modèles dans OmniProxy, puis recopiez grok-4.7 ou gemini-3.8-flash exactement comme le nom apparaît dans cette liste.
• Hermes répond, mais ne peut pas lire de fichiers, exécuter des commandes ou effectuer des opérations similaires : choisissez dans OmniProxy un autre modèle disposant de ces capacités, puis ouvrez une nouvelle session Hermes.
• Le programme est installé sur un disque externe et hermes doctor signale une erreur de stockage après le débranchement du disque : reconnectez d’abord ce disque. Ne laissez pas Hermes créer une autre configuration pendant que le disque est déconnecté.

Références officielles

Pour la procédure d’installation, consultez la documentation d’installation de Hermes et la page sur la prise en charge des plateformes. Pour la configuration de Custom endpoint, consultez la documentation des fournisseurs de Hermes. Pour les ID de modèles, consultez respectivement la documentation des modèles Grok et les instructions de compatibilité OpenAI de Gemini.

L’installation sous macOS a été effectuée intégralement le 2026-10-09 avec Hermes Agent v0.21.6. grok-4.7 et gemini-3.8-flash étaient à cette date les ID de modèles standard indiqués dans les documentations de xAI et de Google. Lors de la configuration, utilisez en priorité les noms affichés dans OmniProxy.

Remplacez chaque espace réservé par des valeurs de votre propre configuration OmniProxy. Ne publiez jamais une vraie clé.

Un résultat sauvegardé ou un HTTP 200 seul ne prouve pas une compatibilité complète de l'Agent. Vérifiez la source et le modèle dans l'enregistrement d'appel d'OmniProxy.

Sources officielles · Hermes ↗