Aller au contenu

Hermes Agent — Aide-mémoire des commandes

Résumé

Hermes est un agent LLM local tournant dans un conteneur Docker, piloté depuis WSL via docker exec. Ce document regroupe toutes les commandes utiles : gestion du conteneur, lancement du chat, configuration des fichiers, dépannage et gestion des fallbacks de modèles via OpenRouter.

Contenu structuré

Gestion du conteneur Docker

Depuis WSL dans ~/hermes-local

Action Commande
Démarrer docker compose up -d
Arrêter docker compose down
Redémarrer docker compose down && docker compose up -d
État docker ps
Logs en direct docker logs -f hermes
Mettre à jour l'image docker compose pull && docker compose down && docker compose up -d

Lancer le chat

docker exec -it hermes /opt/hermes/.venv/bin/hermes
# ou avec l'alias :
hermes

Configurer l'alias : 

echo "alias hermes='docker exec -it hermes /opt/hermes/.venv/bin/hermes'" >> ~/.bashrc && source ~/.bashrc

Commandes slash dans le chat

Commande Action
/help Toutes les commandes disponibles
/model Changer de modèle LLM
/tools Activer / désactiver des outils
/new Nouvelle session
/voice on Mode vocal
/skills Gérer les skills

Fichiers de configuration

Fichier Contenu
~/hermes-local/docker-compose.yml Config Docker (ports, volumes, ressources)
~/hermes-local/data/.env Clés API, email, mots de passe
~/hermes-local/data/config.yaml Config avancée (modèle, fallbacks, backend terminal)

Copier un fichier vers Hermes

cp "/chemin/vers/fichier.docx" ~/hermes-local/data/
# Accessible dans le chat via : /opt/data/nom_du_fichier.docx

Fallbacks de modèles (OpenRouter)

Dans ~/hermes-local/data/config.yaml : 

model:
  provider: openrouter
  model: nvidia/nemotron-3-super-120b
  fallbacks:
    - google/gemma-3-27b-it:free
    - meta-llama/llama-3.1-8b-instruct:free
    - qwen/qwen-2.5-72b-instruct:free

Vérifier le gateway

curl http://localhost:8642/health
# Réponse attendue : {"status": "ok"}

Permissions

sudo chown -R $USER:$USER ~/hermes-local/data

Points clés

  • Le conteneur écoute sur le port 8642 (gateway health check)
  • Les clés API et mots de passe sont dans data/.env — ne pas versionner
  • Après toute modification de config.yaml : redémarrer le conteneur
  • L'alias hermes dans .bashrc simplifie le lancement
  • En cas de crash loop : lire docker logs hermes avant tout redémarrage

Dépannage rapide

Problème Solution
Crash loop docker logs hermes
Hermes ne répond plus Redémarrer le conteneur
Erreur permission data/ sudo chown -R $USER:$USER ~/hermes-local/data
Diagnostic hermes doctor dans le chat

Liens connexes