Préparer l'environnement macOS
Hermes Agent fonctionne sur macOS 11 Big Sur et les versions ultérieures, sur les architectures Intel et Apple Silicon (M1, M2, M3 et suivants). Avant de commencer, ouvrez l'application Terminal, disponible dans Applications > Utilitaires, ou recherchez-la via Spotlight. Vérifiez que Python 3.9 ou supérieur est disponible avec `python3 --version`. Sur les Mac récents, Python 3 est souvent déjà présent ou peut être installé via les outils de développement Xcode.
Assurez-vous que curl est disponible : il est inclus par défaut sur macOS. Vous n'avez pas besoin d'installer Homebrew ou d'autres gestionnaires de paquets pour utiliser Hermes Agent, bien que ceux-ci puissent être utiles pour gérer d'autres dépendances de votre environnement de travail. L'installation se fait entièrement dans votre répertoire personnel et ne nécessite pas de mot de passe administrateur.
- macOS 11 Big Sur ou supérieur (Intel et Apple Silicon)
- Terminal disponible dans Applications > Utilitaires
- Python 3.9+ (`python3 --version`)
- curl inclus par défaut sur macOS
- Pas besoin de droits administrateur
Lancer l'installateur officiel depuis le Terminal
Dans le Terminal, exécutez la commande d'installation officielle : `curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash`. L'installateur télécharge les composants nécessaires, les installe dans votre répertoire personnel et configure votre PATH. Suivez les messages affichés dans le terminal pour vous assurer que chaque étape se déroule correctement.
Une fois l'installation terminée, rechargez votre profil shell. Si vous utilisez zsh (le shell par défaut sur macOS depuis Catalina), exécutez `source ~/.zshrc`. Si vous utilisez bash, exécutez `source ~/.bash_profile`. Vérifiez ensuite que la commande hermes est disponible avec `which hermes`. Si vous préférez une installation via PyPI, `pip install hermes-agent` est une alternative valide, mais l'installateur officiel reste recommandé.
- `curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash`
- Recharger zsh : `source ~/.zshrc`
- Recharger bash : `source ~/.bash_profile`
- Vérifier : `which hermes`
- Alternative : `pip install hermes-agent`
Configuration initiale avec hermes setup
Lancez `hermes setup` pour démarrer l'assistant de configuration interactif. Vous serez guidé pour choisir votre fournisseur de modèle et saisir votre clé API. Le fichier de configuration est créé automatiquement à `~/.hermes/config.yaml`. Pour sélectionner ou changer le modèle, utilisez `hermes model` après la configuration initiale.
Pour connaître l'emplacement exact de vos fichiers de configuration, utilisez `hermes config path` pour le fichier principal et `hermes config env-path` pour le fichier de variables d'environnement. Ces commandes sont particulièrement utiles si vous avez plusieurs profils ou si vous souhaitez inspecter ou sauvegarder votre configuration manuellement.
- `hermes setup` — configuration interactive
- `hermes model` — sélection du modèle
- `hermes config path` — localiser la configuration
- `hermes config env-path` — localiser les variables d'environnement
- Configuration par défaut : `~/.hermes/config.yaml`
Gérer les permissions macOS au cas par cas
macOS peut afficher des demandes de permission lorsque Hermes Agent tente d'accéder à certaines ressources système, comme les fichiers, le réseau ou d'autres fonctionnalités selon les outils activés. Ces demandes apparaissent sous forme de dialogues système standard et doivent être accordées au cas par cas, selon les fonctionnalités que vous souhaitez utiliser. Accordez uniquement les permissions nécessaires à votre usage.
Si une fonctionnalité ne fonctionne pas comme attendu après avoir refusé une permission, vous pouvez ajuster les autorisations dans les Préférences Système (ou Réglages Système sur macOS Ventura et ultérieur), dans la section Confidentialité et sécurité. Consultez la documentation officielle sur https://hermes-agent.nousresearch.com/docs pour savoir quelles permissions sont requises par les fonctionnalités spécifiques que vous utilisez.
- Accorder les permissions système au cas par cas
- Réglages Système > Confidentialité et sécurité pour ajuster
- N'accorder que les permissions nécessaires à votre usage
- Consulter la documentation pour les permissions par fonctionnalité
Vérifier l'installation avec hermes doctor
Lancez `hermes doctor` pour effectuer un diagnostic complet de votre installation sur macOS. Cette commande vérifie les dépendances, la configuration, la connectivité réseau et l'état des composants installés. Elle est particulièrement utile sur macOS pour identifier rapidement si un problème est lié à l'environnement système ou à la configuration d'Hermes.
Si `hermes doctor` signale des problèmes, suivez les indications affichées. Pour les problèmes de connectivité, vérifiez que votre connexion Internet est active et que les connexions HTTPS sortantes ne sont pas bloquées. Consultez les logs dans `~/.hermes/logs/` pour des informations détaillées sur les erreurs éventuelles.
- `hermes doctor` — diagnostic complet sur macOS
- Vérifie dépendances, configuration et connectivité
- Consulter `~/.hermes/logs/` pour les détails d'erreur
- Relancer après toute modification de configuration
Mettre à jour et maintenir l'installation
Pour mettre à jour Hermes Agent sur macOS, utilisez `hermes update`. Cette commande gère le téléchargement et l'application des mises à jour sans nécessiter de réinstallation. Après chaque mise à jour, lancez `hermes doctor` pour confirmer que l'environnement est toujours cohérent et que les nouvelles fonctionnalités sont correctement disponibles.
Suivez les évolutions du projet sur le dépôt officiel https://github.com/NousResearch/hermes-agent et dans la documentation https://hermes-agent.nousresearch.com/docs. Les notes de version vous informent des changements importants, des nouvelles commandes disponibles et des éventuels ajustements de configuration recommandés entre versions.
- `hermes update` — mise à jour sur macOS
- Lancer `hermes doctor` après la mise à jour
- Suivre les notes de version sur GitHub
- Documentation : https://hermes-agent.nousresearch.com/docs
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.