Symptôme, cause, correction : les six incidents qui couvrent la quasi-totalité des installations qui bloquent.
Symptôme : l'installeur refuse de démarrer. Cause : Python 3.9 ou moins dans le PATH. Correction : vérifier avec python3 --version, installer la version courante, relancer.
Symptôme : le test de connexion échoue. Cause : clé tronquée au collage, ou compte sans quota. Correction : recopier la clé entière depuis le tableau de bord du provider, vérifier le crédit restant.
Symptôme : erreurs de dépendances natives. Cause : installation sans WSL2. Correction : wsl --install, puis reprendre l'installation dans la distribution Ubuntu.
Symptôme : le curseur clignote sans réponse. Cause : provider indisponible ou modèle trop lent. Correction : vérifier hermes status, changer de modèle avec /model, ou configurer un fallback.
Symptôme : l'installeur ne peut pas écrire. Cause : dossier sans droits d'écriture. Correction : cloner le dépôt dans votre dossier utilisateur, jamais dans un dossier système.
Devant tout comportement étrange : hermes doctor puis hermes status. Doctor diagnostique l'installation complète et propose des corrections automatiques avec --fix. Les logs donnent la séquence réelle des événements.