Choisir entre installation native et WSL
Hermes Agent fonctionne nativement sur Windows sans nécessiter de couche de compatibilité. C'est l'approche la plus directe si vous travaillez principalement dans un environnement Windows et que vous souhaitez intégrer Hermes à vos outils existants. L'installation native utilise les mêmes mécanismes que sur Linux et macOS, avec des adaptations automatiques pour les chemins et l'environnement Windows.
L'alternative est d'utiliser Windows Subsystem for Linux (WSL), qui offre un environnement Linux complet sur Windows. Cette approche est pertinente si vous êtes déjà familier avec Linux, si vous utilisez des outils qui fonctionnent mieux sous Linux, ou si vous souhaitez un environnement isolé. Dans ce cas, suivez les instructions d'installation Linux depuis votre terminal WSL. Les deux approches sont valides et supportées.
- Installation native : directe, intégrée à l'environnement Windows
- WSL : environnement Linux complet, suivre le guide Linux
- Les deux approches sont officiellement supportées
- Choisir selon votre flux de travail habituel
Installer Hermes Agent sur Windows natif
Pour l'installation native sur Windows, consultez la documentation officielle sur https://hermes-agent.nousresearch.com/docs qui détaille la procédure adaptée à Windows. Si curl est disponible dans votre terminal (il l'est par défaut dans Windows 10 et 11 récents), vous pouvez tenter l'installateur officiel. Sinon, l'installation via PyPI avec `pip install hermes-agent` constitue une alternative fonctionnelle depuis un terminal avec Python installé.
Assurez-vous que Python 3.9 ou supérieur est installé et accessible depuis votre terminal avant de procéder. Après l'installation, vérifiez que la commande `hermes` est accessible en tapant `which hermes` dans un terminal compatible, ou en vérifiant que le répertoire d'installation figure dans votre PATH. Si la commande n'est pas trouvée, redémarrez votre terminal ou votre session pour que les modifications de PATH prennent effet.
- Consulter https://hermes-agent.nousresearch.com/docs pour la procédure Windows
- Alternative : `pip install hermes-agent` avec Python 3.9+
- Vérifier que `hermes` est dans le PATH après installation
- Redémarrer le terminal si la commande n'est pas trouvée
Configuration initiale sur Windows
Une fois Hermes installé, lancez `hermes setup` depuis votre terminal pour démarrer l'assistant de configuration interactif. Cette étape est identique à celle décrite pour Linux : vous choisissez votre fournisseur de modèle, saisissez votre clé API et définissez les paramètres de base. L'assistant crée automatiquement les fichiers de configuration nécessaires dans l'emplacement approprié pour Windows.
Pour sélectionner ou modifier le modèle utilisé, la commande est `hermes model`. Elle fonctionne de la même façon que sur les autres systèmes. Si vous souhaitez ajuster des paramètres avancés, `hermes setup` peut être relancé à tout moment pour modifier la configuration existante sans repartir de zéro.
- `hermes setup` — configuration interactive initiale
- `hermes model` — sélection du modèle
- Relancer `hermes setup` pour modifier la configuration
- L'assistant gère les chemins Windows automatiquement
Localiser les fichiers de configuration via la CLI
Sur Windows, les chemins de fichiers peuvent varier selon la méthode d'installation et la configuration du système. Plutôt que de deviner ou de chercher manuellement, utilisez les commandes CLI dédiées : `hermes config path` affiche le chemin exact du fichier de configuration principal, et `hermes config env-path` affiche le chemin du fichier de variables d'environnement. Ces commandes sont fiables quel que soit le système d'exploitation.
Cette approche est particulièrement importante sur Windows où les chemins peuvent impliquer des répertoires comme AppData ou d'autres emplacements spécifiques au profil utilisateur. En utilisant `hermes config path`, vous obtenez toujours le chemin réel utilisé par votre installation, sans risque d'erreur. Si vous devez éditer manuellement un fichier de configuration, commencez toujours par cette commande pour localiser le bon fichier.
- `hermes config path` — chemin exact du fichier de configuration
- `hermes config env-path` — chemin du fichier d'environnement
- Ne pas deviner les chemins Windows manuellement
- Ces commandes fonctionnent sur tous les systèmes d'exploitation
Diagnostic avec hermes doctor sur Windows
La commande `hermes doctor` fonctionne sur Windows de la même façon que sur Linux et macOS. Elle inspecte l'environnement, vérifie les dépendances, teste la connectivité au fournisseur de modèle et signale les problèmes détectés. C'est le premier outil à utiliser si quelque chose ne fonctionne pas comme attendu après l'installation.
Si `hermes doctor` signale des problèmes de connectivité, vérifiez que votre pare-feu Windows ou votre logiciel de sécurité n'intercepte pas les connexions HTTPS sortantes vers les fournisseurs de modèles. Si des dépendances manquent, suivez les indications affichées par la commande. En cas de doute, consultez la documentation officielle sur https://hermes-agent.nousresearch.com/docs pour les solutions connues sur Windows.
- `hermes doctor` — diagnostic complet sur Windows
- Vérifier les connexions HTTPS sortantes si problème réseau
- Suivre les indications affichées pour résoudre les problèmes
- Consulter https://hermes-agent.nousresearch.com/docs pour l'aide Windows
Utiliser Hermes Agent sous WSL
Si vous optez pour WSL, ouvrez votre distribution Linux installée (Ubuntu est la plus courante) et suivez exactement les instructions du guide d'installation Linux de ce site. L'environnement WSL est un Linux complet : la commande curl fonctionne, les chemins sont des chemins Linux standard, et `~/.hermes/` correspond au répertoire personnel de votre utilisateur WSL.
Un avantage de WSL est l'isolation : votre configuration Hermes dans WSL est indépendante d'une éventuelle installation native Windows. Vous pouvez utiliser la variable `HERMES_HOME` pour pointer vers un répertoire spécifique si vous souhaitez gérer plusieurs profils ou environnements isolés. Les logs restent accessibles dans `~/.hermes/logs/` depuis votre terminal WSL.
- Suivre le guide Linux depuis le terminal WSL
- Les chemins WSL sont des chemins Linux standard
- `HERMES_HOME` pour isoler les profils si nécessaire
- Logs disponibles dans `~/.hermes/logs/` sous WSL
Sources et méthode
Cette page est une synthèse éditoriale indépendante. Les capacités et commandes doivent être vérifiées dans les sources officielles avant une utilisation en production.