Installation d'Hermes et configuration d'OmniProxy

Hermes est un assistant qui peut conserver les conversations et l’expérience des tâches, transformant le travail terminé en compétences qui peuvent être réutilisées plus tard. Via une passerelle unique, il peut également se connecter à Telegram, Discord, Slack, WhatsApp, Signal et au terminal. La passerelle sert de point d’entrée unifié pour recevoir et transférer des messages. Vous pouvez lui envoyer des revues de code, des notes d’incident ou des documents clients depuis vos outils de chat habituels, puis lui demander de retourner au dépôt et de continuer à travailler.

Avant de commencer

Choisissez d’abord une méthode d’installation basée sur le système d’exploitation de votre ordinateur. macOS et Windows peuvent utiliser directement des installateurs graphiques, tandis que Linux, macOS et WSL2 peuvent utiliser un script de terminal. WSL2 est une fonctionnalité Windows pour exécuter un environnement Linux. Termux sur les téléphones Android et Docker ont leurs propres méthodes d’installation, mais ce guide ne couvre que l’installation sur des ordinateurs ordinaires.

Vous voulez une fenêtre

macOS, Windows

• macOS : ouvrir le DMG
• Windows : ouvrir l'installateur
• Installer l'application sur le système

Terminal uniquement

Linux, macOS, WSL2

• Une commande install.sh
• Utiliser install.ps1 sur Windows
• Entrer hermes après l'installation

Ne pas utiliser ceux-ci pour l'instant

pip, brew, AUR

• Ces méthodes d'installation ne sont pas officiellement prises en charge
• Elles sont aussi difficiles à mettre à jour après l'installation
• Utilisez l'une des deux options à gauche à la place

Avant de commencer, préparez un ordinateur macOS, Windows ou Linux et assurez-vous qu’il peut ouvrir un terminal et accéder à GitHub. Si vous prévoyez d’installer Hermes sur un disque externe, connectez le disque d’abord et confirmez qu’il a assez d’espace libre.

Installation et premier lancement

Si vous voulez une application graphique

Allez dans la section de téléchargement sur le site web d’Hermes et téléchargez l’installateur pour votre système d’exploitation. L’installateur inclut déjà l’environnement d’exécution, donc rien n’a besoin d’être compilé localement lors de la première ouverture.

• macOS : Ouvrez le DMG et déplacez Hermes.app dans Applications. Un DMG est une image d’installation couramment utilisée sur macOS. Cet installateur ne prend en charge que Apple Silicon ; les Mac Intel ne sont pas pris en charge.
• Windows : Ouvrez le .appinstaller fichier avec Windows App Installer. Il installe un MSIX signé, un type de paquet d’application utilisé par Windows.
• Linux : Les installateurs de bureau sont pour macOS et Windows. Sur Linux, utilisez la commande de terminal ci-dessous. Après l’installation, vous pouvez exécuter hermes desktop.

Si vous avez seulement besoin du terminal

Si vous utilisez Linux, macOS ou WSL2, exécutez ceci dans un terminal :

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

Lorsque vous utilisez le PowerShell inclus avec Windows, exécutez :

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

L’installateur télécharge le code d’Hermes et les programmes requis pour l’exécuter. Si le téléchargement est interrompu, exécutez la même commande à nouveau. Une fois l’installation terminée, fermez le terminal actuel, ouvrez une nouvelle fenêtre et entrez :

hermes

Si vous voyez l’invite Hermes, la commande est prête à être utilisée. Vous pouvez ensuite exécuter hermes doctor; cette vérification d’installation vous indique ce qui manque encore.

Stocker le programme sur un disque externe

Le 9 octobre 2026, Hermes Agent v0.21.6 a été installé sur un disque externe connecté à un Mac. Le programme était stocké à /Volumes/AItools/tools/hermes-agent, la commande de lancement était située à ~/.local/bin/hermes, et les données de configuration et de conversation restaient dans ~/.hermes.

Si votre disque a un nom différent, remplacez le chemin après --dir par votre propre dossier. Le disque doit rester connecté pendant qu’Hermes est en cours d’exécution.

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 externe

• tools/hermes-agent
• Gardez le code ici

Commande

~/.local/bin/hermes

• Entrer hermes dans le terminal
• Prend effet après l'ouverture d'une nouvelle fenêtre

Configuration et chats

~/.hermes

• config.yaml est ici
• Quitter avant de déconnecter le disque

Obtenir les valeurs de connexion depuis OmniProxy

Ici, Hermes se connecte à OmniProxy plutôt que directement à Grok ou Gemini. Configurez les URL des services Grok et Gemini dans OmniProxy ; ne les entrez pas directement dans Hermes.

Votre ordinateur

Hermes

→

Passerelle locale

OmniProxy

• Inclure /v1 dans l'adresse

→

Grok

• grok-4.7

Gemini

• gemini-3.8-flash

Un ID de modèle est le nom exact que l’API utilise pour identifier un modèle. Utilisez les noms suivants pour les deux modèles :

• Pour Grok, entrez grok-4.7. L’API xAI est https://api.x.ai/v1, et les requêtes de chat utilisent /v1/chat/completions. Voir la documentation du modèle Grok.
• Pour Gemini, entrez gemini-3.8-flash. L’API compatible OpenAI de Google est https://generativelanguage.googleapis.com/v1beta/openai/. Voir la documentation de compatibilité OpenAI de Gemini.

Pour basculer Hermes vers Gemini, changez seulement le nom du modèle pour gemini-3.8-flash. Continuez à utiliser l’adresse OmniProxy comme point de terminaison de l’API.

Copiez l’URL du point de terminaison et la clé depuis OmniProxy, puis entrez 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

L’URL de base est le point de terminaison vers lequel Hermes envoie les requêtes. Il doit se terminer par /v1 ici. La clé API est la clé qu’OmniProxy délivre à Hermes. Remplacez l’espace réservé par votre propre valeur, et ne la publiez pas sur une page publique.

Si votre instance locale OmniProxy ne nécessite pas de clé, vous pouvez laisser la clé API vide. Si l’adresse est accessible à quelqu’un d’autre, vous devriez utiliser une clé. Confirmez également que l’adresse est accessible depuis l’environnement où Hermes s’exécute. Si Hermes et OmniProxy sont sur le même ordinateur, vous pouvez utiliser une adresse locale.

Entrer la configuration de l’outil

Tout d’abord, quittez le chat actuel, puis exécutez ceci dans un terminal :

hermes model

Sélectionnez Custom endpoint (self-hosted / VLLM / etc.). Un point de terminaison personnalisé signifie qu’Hermes se connecte à une adresse de service que vous spécifiez au lieu d’utiliser un fournisseur prédéfini.

L’assistant de configuration demande l’URL du point de terminaison, la clé et le nom du modèle dans l’ordre. Entrez les trois valeurs de la section précédente. Pour utiliser Gemini, entrez gemini-3.8-flash comme nom de modèle.

Vous pouvez également modifier ~/.hermes/config.yaml directement. YAML est un format texte qui utilise l’indentation pour représenter les relations de configuration. La configuration suivante utilise 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, changez default pour gemini-3.8-flash et laissez les trois autres valeurs inchangées :

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

Après avoir enregistré, exécutez hermes à nouveau et démarrez un nouveau chat. Dans une session déjà ouverte, /model ne peut basculer qu’entre les fournisseurs qui ont déjà été enregistrés ; il ne peut pas ajouter cette configuration.

Vérifier avec une tâche réelle

1

hermes doctor

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

2

Envoyer un court message

• Voir une réponse d'Hermes

3

Ouvrir les journaux de requêtes

• Vérifier le nom du modèle

1. Exécutez hermes doctor pour vérifier si l’installation est terminée.
2. Exécutez hermes et demandez-lui d’expliquer en une phrase ce qu’il peut faire. Vous devriez voir une réponse.
3. Ouvrez le journal de requêtes OmniProxy, confirmez que la requête provient d’Hermes et vérifiez si le nom du modèle est grok-4.7 ou gemini-3.8-flash.

Voir que l’assistant de configuration a été enregistré avec succès, ou que l’API a retourné une réponse réussie, ne suffit pas pour montrer qu’Hermes peut accomplir des tâches pour vous. Le nom du modèle dans le journal de requêtes doit correspondre à la valeur que vous avez entrée.

Pour chatter dans un navigateur, exécutez ce qui suit localement :

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

Puis ouvrez http://127.0.0.1:9119. Cette adresse ne fonctionne que sur l’ordinateur actuel.

Erreurs courantes

• Entrer hermes signale que la commande est introuvable : Fermez le terminal et ouvrez une nouvelle fenêtre. Si la commande est toujours introuvable, confirmez que ~/.local/bin est dans le PATH. PATH est la liste des répertoires où le système recherche des commandes. Sur Windows, confirmez que le répertoire de lancement ajouté par l’installateur est dans le PATH.
• Le téléchargement de l’installation s’arrête en cours de route : Exécutez la même commande d’installation à nouveau. Les parties déjà téléchargées seront réutilisées.
• Hermes ne répond pas ou signale qu’il ne peut pas se connecter : Confirmez qu’OmniProxy est en cours d’exécution et vérifiez que l’URL de base se termine par /v1. Si Hermes s’exécute dans Docker alors qu’OmniProxy s’exécute sur l’hôte, n’utilisez pas 127.0.0.1 s’il n’est valide qu’à l’intérieur du conteneur.
• Une erreur de clé apparaît : Mettez à jour la clé OmniProxy, puis changez api_key dans config.yaml. La clé xAI ou Google appartient aux paramètres de fournisseur d’OmniProxy ; ne l’entrez pas dans ce champ Hermes.
• Le modèle est signalé comme indisponible : Ouvrez la liste actuelle des modèles dans OmniProxy et copiez grok-4.7 ou gemini-3.8-flash exactement comme il apparaît dans la liste.
• Hermes répond mais ne peut pas effectuer de tâches telles que lire des fichiers ou exécuter des commandes : Passez à un autre modèle dans OmniProxy qui possède ces capacités, puis démarrez une nouvelle session Hermes.
• Le programme est sur un disque externe, et hermes doctor signale une erreur de stockage après la déconnexion du disque : Reconnectez le disque d’abord. Ne laissez pas Hermes créer une configuration séparée pendant que le disque est déconnecté.

Références

Pour les étapes d’installation, voir la documentation d’installation d’Hermes et la prise en charge des plateformes. Pour la configuration du point de terminaison personnalisé, voir la documentation du fournisseur Hermes. Pour les ID de modèles, voir la documentation du modèle Grok et la documentation de compatibilité OpenAI de Gemini.

Le processus d’installation macOS a été terminé le 2026-10-09 en utilisant Hermes Agent v0.21.6. grok-4.7 et gemini-3.8-flash étaient les ID de modèles standard dans la documentation xAI et Google à cette date. Lors de la saisie des valeurs, utilisez 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 la compatibilité complète de l'Agent. Vérifiez la source et le modèle dans le journal d'appels d'OmniProxy.

Sources officielles · Hermes ↗