SÉRIE HERMES AGENT ÉTAPE 1 4/24

Hermes Agent : comprendre et modifier sa configuration

Retrouve la configuration du bon profil Hermes, change un thème visuel, vérifie son effet et reviens au réglage initial. Un premier exercice simple pour comprendre les réglages.

DANS CE TUTORIELAller à une étape

Tu veux changer un réglage dans Hermes, mais tu hésites devant son fichier de configuration. Où chercher ? Comment savoir si tu modifies le bon profil ? Et comment revenir en arrière ?

Nous allons apprendre ces gestes avec un changement facile à voir : passer l’interface du terminal à un thème monochrome, puis retrouver son apparence initiale. Le principe servira ensuite pour d’autres réglages, sans commencer par toucher au modèle ou à ses accès.

Avant de commencer

Ce parcours vise Hermes dans un terminal classique sous Linux ou WSL, déjà installé et capable de démarrer. Utilise le terminal Linux où la commande hermes fonctionne, pas PowerShell pour une installation dans WSL.

Les commandes ciblent le profil default. Un profil regroupe les réglages et les données d’un usage Hermes. Si ton installation utilise un autre profil, remplace default par son nom dans toutes les commandes. Le tuto sur les profils explique comment les reconnaître.

1. Retrouver le fichier du bon profil

Une configuration est un ensemble de choix enregistrés : apparence, modèle, outils ou environnement de travail. Hermes en conserve une partie dans un fichier nommé config.yaml.

Commence dans ton terminal habituel, en dehors de la conversation Hermes :

Terminal · retrouver le fichier
hermes -p default config path

La commande doit afficher un chemin qui se termine par config.yaml. Note-le. Le dossier courant du terminal et le dossier de configuration sont deux choses différentes : être dans ton projet ne signifie pas que ses réglages Hermes sont enregistrés là.

~/.hermes/ est un emplacement courant pour le profil par défaut. Un autre profil ou un environnement personnalisé peut utiliser un autre chemin. Pour cet exercice, fie-toi au chemin affiché, plutôt qu’à un emplacement recopié depuis un exemple.

Si la commande échoue ou vise un profil inattendu, règle ce point avant de poursuivre. Ne crée pas un nouveau fichier au hasard pour contourner le problème.

2. Noter le réglage initial

Le réglage qui nous intéresse s’appelle display.skin. display regroupe des options d’affichage ; skin désigne le thème visuel. Le point permet de nommer un réglage à l’intérieur d’une section.

Terminal · lire le thème configuré
hermes -p default config get display.skin

Note la valeur obtenue, par exemple default, mono ou slate. Une valeur affichée peut provenir d’un réglage par défaut, même si la ligne n’a jamais été ajoutée à ton fichier. Pour revenir exactement à l’état initial, il faut donc aussi savoir si elle était enregistrée.

Ouvre le fichier dont tu as noté le chemin dans ton éditeur de texte habituel. Fais-en d’abord une copie dans un dossier privé, avec un nom distinct comme config-avant-theme.yaml ; vérifie que cette copie existe. Ne partage pas ce fichier : une configuration peut contenir des informations sensibles.

Dans le fichier original, cherche la section display, puis la ligne skin placée à l’intérieur. Voici uniquement un exemple de lecture, pas un bloc à coller pour remplacer ta configuration :

display:
  skin: default

Le décalage de skin vers la droite indique qu’il appartient à display. Ce format s’appelle YAML. Tu n’as pas besoin de le modifier à la main pour notre essai.

Note soit « display.skin présent, valeur : … », soit « display.skin absent ». Si tu ne trouves pas de section display, le réglage est absent lui aussi. Si la structure est différente ou difficile à interpréter, ne devine pas : garde le fichier intact et clarifie-le avant de poursuivre. Ferme ensuite l’éditeur sans enregistrer de changement.

3. Changer seulement le thème

Nous allons choisir mono, un thème intégré en niveaux de gris. Cela change l’apparence de l’interface, pas la manière dont le modèle raisonne ou répond.

Si une conversation Hermes est ouverte, attends la fin de toute tâche et quitte-la avec /quit. Puis, dans le terminal :

Terminal · choisir le thème monochrome
hermes -p default config set display.skin mono
hermes -p default config get display.skin

La première commande enregistre le choix ; la seconde le relit. Tu dois retrouver mono. Si Hermes signale une erreur ou refuse l’écriture, arrête-toi et lis son message. Ne force pas la modification.

Si ton thème était déjà mono, choisis plutôt slate pour cet essai : remplace mono par slate dans la première commande. Ce thème intégré emploie des accents bleus. Le résultat à vérifier sera alors slate.

4. Vérifier ce qui a réellement changé

Relance le même profil :

Terminal · ouvrir Hermes avec ce profil
hermes -p default chat

Observe les couleurs et les bordures de l’interface. Dans la conversation Hermes, cette commande permet de consulter le thème courant et les thèmes disponibles :

Dans Hermes · consulter le thème courant
/skin

Le résultat attendu
Le choix relu par config get correspond au thème indiqué dans Hermes : mono, ou slate si tu as suivi cette variante. L’apparence correspond à ce choix lorsque ton terminal affiche les couleurs. Aucun appel au modèle n’est nécessaire pour ce contrôle.

Si l’aspect change peu, regarde d’abord le nom du thème. Les couleurs dépendent aussi du terminal, et un thème personnalisé portant le même nom peut modifier le rendu. Si le nom ne correspond pas, vérifie le profil et le chemin du fichier avant de changer autre chose.

Ce contrôle porte sur l’affichage. Il ne démontre pas que le modèle est joignable, qu’un outil fonctionne ou que toute l’installation est saine. Pour ces questions, il faut un essai adapté, comme celui du branchement à llama.cpp.

5. Revenir au choix initial

Quitte la conversation avec /quit. Reprends maintenant la note de l’étape 2 et suis un seul des deux cas.

Le réglage était présent dans ton fichier. Remplace ANCIEN_THEME par le nom exact que tu avais noté, par exemple default. Les guillemets peuvent rester.

Terminal · restaurer une valeur présente au départ
hermes -p default config set display.skin "ANCIEN_THEME"

Le réglage était absent de ton fichier. Retire uniquement la valeur ajoutée pour l’exercice :

Terminal · retirer la valeur ajoutée pour l’essai
hermes -p default config unset display.skin

Ce retrait laisse Hermes utiliser sa valeur par défaut pour ce réglage. Il ne supprime pas le thème ni le reste de la configuration. Ne lance pas cette commande après la première : ce sont deux retours différents, selon ton état initial.

Relis le réglage et rouvre Hermes :

Terminal · contrôler le retour
hermes -p default config get display.skin
hermes -p default chat

Utilise de nouveau /skin pour comparer avec ton point de départ. Si la valeur était absente, tu peux aussi rouvrir le fichier pour vérifier que la ligne ajoutée a disparu. Ne remplace pas automatiquement tout le fichier par la copie : tu risquerais d’annuler d’autres changements effectués entre-temps.

6. Garder les mêmes repères pour les autres réglages

Tu viens de suivre une méthode transposable : retrouver le bon fichier, noter l’état initial, modifier un choix, observer son effet et savoir l’annuler. Le contrôle change avec le réglage : pour un thème, tu regardes l’interface ; pour un modèle, tu vérifies le modèle utilisé et une réponse réelle.

Il reste une distinction importante : le choix enregistré dans le fichier n’est pas toujours celui d’un lancement particulier. Certaines options données au démarrage prennent le dessus pour cette invocation.

Prenons un exemple illustratif, sans te demander de changer de modèle. Dans le même profil, le modèle A est enregistré. Tu choisis explicitement le modèle B au lancement, chez le même fournisseur. Si ces deux modèles sont disponibles et que ce lancement réussit, la conversation utilise B ; ce choix ponctuel ne remplace pas A dans le fichier.

Enregistré ne veut pas dire utilisé à chaque lancement.

Un choix temporaire n’est pas un réglage enregistré.

Dans le même profil et chez le même fournisseur, A est enregistré et B est choisi explicitement pour le lancement. Si B est disponible et le lancement réussit, la conversation utilise B sans remplacer A dans le fichier. Les lettres sont des repères illustratifs, pas des noms de modèles à saisir.

Les lettres A et B servent à comprendre la relation : ce ne sont pas des identifiants à saisir. Cet exemple concerne une option de lancement, pas le configurateur hermes model ni un changement interactif avec /model, qui ont leur propre fonctionnement.

Pour le thème de notre exercice, nous avons volontairement utilisé config set : le choix est enregistré. Relancer Hermes permet de vérifier le résultat dans un point de départ clair ; cela ne signifie pas que tous les réglages exigent un redémarrage, certains étant rechargés en cours d’utilisation.

Situer les réglages et les identifiants

Quand tu voudras aller plus loin, garde ces repères. Ils décrivent les fichiers courants du dossier Hermes concerné, pas une liste exhaustive de tous les mécanismes de connexion.

FichierÀ quoi il sert
config.yamlRéglages, dont le thème et le choix du modèle.
.envVariables, dont des clés d’accès à des services.
auth.jsonIdentifiants de connexion de certains fournisseurs.

Une connexion par abonnement peut passer par une authentification dans le navigateur plutôt que par une clé d’API que tu colles toi-même. N’affiche pas les fichiers d’identifiants pour vérifier ton thème et ne transmets pas leur contenu dans une demande d’aide. Le parcours sécurité précise ces précautions.

Pour changer de fournisseur ou de modèle, utilise le parcours adapté de hermes model. Selon la version et le choix proposé, cet assistant peut aussi gérer l’installation d’un moteur local et le téléchargement d’un modèle. Il ne faut donc pas le présenter comme une simple modification de quelques lignes.

Si le résultat ne correspond pas à la configuration

Repars du profil, du chemin affiché et de la commande de lancement. Un autre profil, une option ponctuelle ou une conversation déjà ouverte peuvent expliquer une différence. Évite de corriger cinq paramètres à la fois.

Pour un modèle local, une adresse localhost désigne la machine vue par le processus qui l’utilise ; elle peut aussi mener à un relais qui contacte un service distant. Une clé présente ou absente ne suffit pas à déterminer le trajet des données. De même, ne pas voir d’activité dans une fenêtre serveur ne prouve pas que la réponse vient d’ailleurs.

Les vues de configuration et les diagnostics sont des aides. Leur succès ne remplace pas une requête vérifiée dans les conditions de ton usage. Si l’écart reste inexpliqué, poursuis avec le tuto de diagnostic en gardant le réglage testé et le résultat observé.

Références : configuration Hermes, thèmes visuels, profils et modèles locaux gérés. Les commandes proposées ont été recoupées avec ces références et le code officiel ; l’exercice n’a pas été exécuté dans une installation Hermes pour cette révision.

↑ Revenir au sommaire