Module 05 / 19← Ordre des modules
● Agent IA · Installation locale

Hermes Agent

Ce module installe Hermes Agent avec la méthode officielle, le connecte au modèle Ollama déjà validé et vérifie une première conversation locale. La Gateway, l’API réseau, Telegram, la mémoire Golden, les skills et la voix seront volontairement configurés dans les modules suivants.

Point de départ

Ollama + modèle local validés

Point d’arrivée

Hermes dialogue avec Ollama

Exposition réseau

Aucune à ce stade

Avant de commencer

Prérequis

  • Modules 00 à 04 validés.
  • Ollama actif localement.
  • Au moins un modèle compatible avec les outils installé.
  • Contexte Ollama configuré à 65536 pour le Golden Build.
  • Accès Internet pour télécharger Hermes.

Valeurs à personnaliser

Modèle Ollama choisiMETTRE_VOTRE_MODELE_OLLAMA
Commit Hermes Golden, si utiliséMETTRE_VOTRE_COMMIT_HERMES
Règle : ne lancez jamais une commande contenant encore METTRE_VOTRE_.... Le Golden Build Jarvis utilise actuellement qwen3.6:35b-a3b, mais un autre modèle validé au Module 04 peut être utilisé.

Légende des commandes

Lecture seuleModificationValidationOptionnel

Installation pas à pas

05.1 · Vérifier le modèle local avant Hermes

Validation
ollama list
ollama ps
curl -fsS http://localhost:11434/v1/models | jq .
Pourquoi : Hermes ne doit pas être diagnostiqué tant que le moteur local n’est pas lui-même sain.
Résultat attendu : Le modèle choisi est visible et l’endpoint OpenAI-compatible d’Ollama répond.

05.2 · Choisir la méthode d’installation Hermes

Lecture seule
# Méthode A — installation courante officielle
# Utiliser l’étape 05.3

# Méthode B — reproductibilité Golden avec commit figé
# Utiliser l’étape 05.4 uniquement si le commit exact est connu
Pourquoi : Une nouvelle installation peut suivre la version actuelle, tandis qu’un Golden Build strict peut figer Hermes sur un commit précis.
Résultat attendu : Une seule méthode est choisie.

05.3 · Méthode A — Installer Hermes avec le script officiel

Modification
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash -s -- --skip-setup
Pourquoi : Le script officiel installe Hermes et ses dépendances. --skip-setup empêche l’assistant initial de mélanger prématurément la configuration du modèle avec les futurs modules Gateway ou messagerie.
Résultat attendu : L’installation se termine sans erreur et publie la commande hermes pour votre compte.

05.4 · Méthode B — Installer Hermes au commit Golden

Optionnel
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | \
  bash -s -- --skip-setup --commit METTRE_VOTRE_COMMIT_HERMES
Pourquoi : L’installateur officiel accepte --commit, ce qui permet de reproduire exactement une version figée dans votre manifest Golden.
Résultat attendu : Hermes est installé à partir du commit demandé.
Ne pas inventer le commit : utilisez uniquement une valeur réellement enregistrée dans votre manifest Golden. Sinon, utilisez la méthode A.

05.5 · Recharger l’environnement du shell

Modification
source ~/.bashrc
Pourquoi : L’installateur peut avoir ajouté les chemins Hermes au PATH du compte courant.
Résultat attendu : Les nouvelles commandes deviennent immédiatement accessibles sans ouvrir une nouvelle session.

05.6 · Vérifier la commande Hermes

Validation
command -v hermes
hermes --help | head -40
Pourquoi : Vérifier que l’installation a publié le lanceur Hermes et que le CLI démarre correctement.
Résultat attendu : command -v retourne un chemin et l’aide Hermes s’affiche.

05.7 · Configurer le modèle local

Modification
hermes model
Pourquoi : Configurer explicitement Hermes pour utiliser l’endpoint OpenAI-compatible local d’Ollama.

Choix à effectuer dans l’assistant

  1. Choisir le fournisseur Custom endpoint / endpoint auto-hébergé.
  2. Base URL : http://localhost:11434/v1.
  3. Clé API : laisser vide si l’assistant l’accepte ; Ollama local n’en exige pas.
  4. Modèle : sélectionner ou saisir METTRE_VOTRE_MODELE_OLLAMA.
  5. Contexte : utiliser 65536 pour reproduire le Golden Build.
Résultat attendu : Hermes confirme le fournisseur personnalisé et le modèle local.

05.8 · Vérifier la configuration Hermes

Validation
hermes config check
Pourquoi : Détecter immédiatement une configuration invalide avant le premier chat.
Résultat attendu : La configuration est acceptée sans erreur bloquante.

05.9 · Contrôler uniquement la section modèle

Lecture seule
grep -A8 '^model:' ~/.hermes/config.yaml
Pourquoi : Vérifier le fournisseur, le modèle et le contexte sans afficher tout le fichier de configuration.
Résultat attendu : La section indique un provider personnalisé, l’URL locale Ollama, votre modèle et le contexte choisi.

05.10 · Lancer le diagnostic Hermes

Validation
hermes doctor
Pourquoi : Le diagnostic officiel permet d’identifier les dépendances ou réglages incomplets avant de tester les workflows agentiques.
Résultat attendu : Aucun problème critique n’empêche Hermes de fonctionner avec le fournisseur local.

05.11 · Tester une requête non interactive

Validation
hermes chat -q "Réponds uniquement par : HERMES OK"
Pourquoi : Valider le trajet complet Hermes → API Ollama → modèle → réponse.
Résultat attendu : Hermes retourne HERMES OK ou une réponse équivalente, sans erreur fournisseur.

05.12 · Vérifier le modèle après la conversation

Validation
ollama ps
Pourquoi : Confirmer qu’Hermes a bien utilisé le modèle local et que le contexte / placement GPU restent conformes au Module 04.
Résultat attendu : Le modèle choisi apparaît avec le contexte attendu et le placement GPU validé précédemment.

05.13 · Tester le mode interactif

Validation
hermes
Pourquoi : Vérifier que l’interface conversationnelle principale démarre correctement.
Résultat attendu : Une session Hermes s’ouvre et permet une conversation normale avec le modèle local.

05.14 · Vérifier les répertoires Hermes créés

Lecture seule
find ~/.hermes -maxdepth 2 -type d | sort | head -80
Pourquoi : Vérifier que l’arborescence utilisateur Hermes existe avant d’y ajouter secrets, skills, mémoire ou hooks dans les modules suivants.
Résultat attendu : ~/.hermes et ses sous-répertoires de base sont présents.

Ce que ce module ne configure pas encore

Module 06

Gateway Hermes, API locale, service persistant et exposition contrôlée sur le réseau privé.

Module 07

Configuration Golden, mémoire, SOUL, garde-fous de sécurité et règles d’approbation.

Modules suivants

Skills, Home Assistant, réseau, Telegram, voix, Camofox, Open WebUI, Gmail et Calendar.

Principe

À ce stade, Hermes doit simplement savoir parler correctement au modèle Ollama local.

Dépannage rapide

hermes: command not found

source ~/.bashrc
command -v hermes

Si la commande reste absente, relisez la sortie de l’installateur avant de relancer une installation.

Endpoint Ollama inaccessible

curl -fsS http://localhost:11434/v1/models | jq .
sudo systemctl status ollama --no-pager

Si ce test échoue, revenez au Module 03 au lieu de modifier Hermes.

Contexte insuffisant

ollama ps
sudo systemctl cat ollama

Hermes Agent a besoin d’un grand contexte pour les outils. Le Golden Build utilise 65536 ; corrigez Ollama au Module 03 si nécessaire.

Le modèle ne sait pas appeler les outils

Revenez au Module 04 et choisissez un modèle explicitement adapté au tool calling / function calling. Un modèle conversationnel seul limite fortement Hermes.

Références officielles

Validation du Module 05

Ne passez au module suivant que lorsque tous les points applicables sont validés.

La commande hermes est disponible.
Hermes a été installé avec la méthode officielle.
Le provider configuré est l’endpoint local Ollama.
Le modèle sélectionné correspond au modèle validé au Module 04.
Le contexte Hermes est 65536 pour le Golden Build.
hermes config check ne retourne pas d’erreur bloquante.
hermes doctor ne signale pas de problème critique.
hermes chat -q obtient une réponse du modèle local.
ollama ps confirme toujours le bon modèle et le bon contexte.
Le mode interactif Hermes démarre correctement.

STOP — Module 05 validé

Hermes Agent est installé et sait utiliser votre modèle local. Ne configurez pas encore la Gateway ou l’API dans cette page : elles appartiennent au Module 06.

← Module précédentRevenir à l’ordre des modules