Hermes Agent ☤

Hermes Agent | Hermes Desktop

L'agent IA auto-améliorant conçu par Nous Research. C'est le seul agent doté d'une boucle d'apprentissage intégrée — il crée des compétences à partir de l'expérience, les améliore en cours d'utilisation, se pousse à persister les connaissances, recherche dans ses propres conversations passées et construit un modèle de plus en plus approfondi de qui vous êtes au fil des sessions. Exécutez-le sur un VPS à 5 $, un cluster GPU ou une infrastructure serverless qui ne coûte presque rien au repos. Il n'est pas lié à votre ordinateur portable — parlez-lui depuis Telegram pendant qu'il travaille sur une VM cloud.

Utilisez le modèle de votre choix — Nous Portal, OpenRouter, OpenAI, votre propre endpoint, et bien d'autres. Changez avec hermes model — aucune modification de code, aucune dépendance.

Installation rapide

Linux, macOS, WSL2, Termux

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Windows (natif, PowerShell)

Attention : Windows natif exécute Hermes sans WSL — CLI, passerelle, TUI et outils fonctionnent tous nativement. Si vous préférez utiliser WSL2, la commande unique Linux/macOS ci-dessus fonctionne également là-bas. Vous avez trouvé un bug ? Merci de signaler les problèmes.

Exécutez ceci dans PowerShell :

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

L'installateur gère tout : uv, Python 3.11, Node.js, ripgrep, ffmpeg, et un Git Bash portable (MinGit, décompressé dans %LOCALAPPDATA%\hermes\git — aucune autorisation administrateur requise, complètement isolé de toute installation Git système). Hermes utilise ce Git Bash intégré pour exécuter les commandes shell.

Si vous avez déjà Git installé, l'installateur le détecte et l'utilise à la place. Sinon, un téléchargement MinGit d'environ 45 Mo est tout ce dont vous avez besoin — il ne touchera ni n'interférera avec aucun Git système.

Android / Termux : Le chemin manuel testé est documenté dans le guide Termux. Sur Termux, Hermes installe un extra .[termux] organisé car l'extra complet .[all] tire actuellement des dépendances vocales incompatibles avec Android.

Windows : Windows natif est entièrement pris en charge — la commande unique PowerShell ci-dessus installe tout. Si vous préférez utiliser WSL2, la commande Linux fonctionne également là-bas. L'installation Windows native se trouve sous %LOCALAPPDATA%\hermes ; l'installation WSL2 se trouve sous ~/.hermes comme sur Linux.

Après l'installation :

source ~/.bashrc    # rechargez le shell (ou : source ~/.zshrc)
hermes              # commencez à discuter !

Dépannage

Windows Defender ou l'antivirus signale uv.exe comme malware

Si votre antivirus (Bitdefender, Windows Defender, etc.) met en quarantaine uv.exe du dossier bin de Hermes (%LOCALAPPDATA%\hermes\bin\uv.exe), il s'agit d'un faux positif. Le fichier est uv d'Astral — le gestionnaire de paquets Python en Rust que Hermes intègre pour gérer son environnement Python. Les moteurs antivirus basés sur le ML signalent couramment les binaires Rust non signés qui téléchargent et installent des paquets.

Pour vérifier que votre copie est authentique :

# Installez GitHub CLI si nécessaire
winget install --id GitHub.cli

# Connectez-vous à GitHub
gh auth login

# Exécutez la vérification
$uv = "$env:LOCALAPPDATA\hermes\bin\uv.exe"
$ver = (& $uv --version).Split(' ')[1]
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
$zip = "$env:TEMP\uv.zip"
Invoke-WebRequest "https://github.com/astral-sh/uv/releases/download/$ver/uv-x86_64-pc-windows-msvc.zip" -OutFile $zip -UseBasicParsing
gh attestation verify $zip --repo astral-sh/uv
Expand-Archive $zip "$env:TEMP\uv_x" -Force
(Get-FileHash "$env:TEMP\uv_x\uv.exe").Hash -eq (Get-FileHash $uv).Hash

Si l'attestation indique « Verification succeeded » et que la dernière ligne affiche True, tout va bien.

Pour mettre Hermes sur liste blanche :

• Windows Defender : Exécutez PowerShell en tant qu'administrateur → Add-MpPreference -ExclusionPath "$env:LOCALAPPDATA\hermes\bin"
• Bitdefender : Ajoutez une exception dans la console Bitdefender (Protection > Antivirus > Paramètres > Gérer les exceptions)
• Mettez sur liste blanche le dossier, pas le hash du fichier — Hermes met à jour uv et le hash change à chaque version

Pour plus de contexte, consultez les rapports Astral en amont : astral-sh/uv#13553, astral-sh/uv#15011, astral-sh/uv#10079.

Pour commencer

hermes              # CLI interactive — démarrez une conversation
hermes model        # Choisissez votre fournisseur LLM et votre modèle
hermes tools        # Configurez quels outils sont activés
hermes config set   # Définissez des valeurs de configuration individuelles
hermes config get   # Affichez des valeurs de configuration individuelles
hermes gateway      # Démarrez la passerelle de messagerie (Telegram, Discord, etc.)
hermes setup        # Exécutez l'assistant de configuration complet (configure tout en une fois)
hermes claw migrate # Migrez depuis OpenClaw (si vous venez d'OpenClaw)
hermes update       # Mettez à jour vers la dernière version
hermes doctor       # Diagnostiquez tout problème

📖 Documentation complète →

Évitez la collecte de clés API — Nous Portal

Hermes fonctionne avec le fournisseur de votre choix — cela ne change pas. Mais si vous préférez ne pas collecter cinq clés API distinctes pour le modèle, la recherche web, la génération d'images, la TTS et un navigateur cloud, Nous Portal couvre tout cela avec un seul abonnement :

• 300+ modèles — choisissez-en un avec /model <nom>
• Tool Gateway — recherche web (Firecrawl), génération d'images (FAL), synthèse vocale (OpenAI), navigateur cloud (Browser Use), le tout routé via votre abonnement. Aucun compte supplémentaire.

Une seule commande depuis une installation fraîche :

hermes setup --portal

Cela vous connecte via OAuth, définit Nous comme fournisseur et active la Tool Gateway. Vérifiez ce qui est configuré à tout moment avec hermes portal info. Détails complets sur la page de documentation Tool Gateway.

Vous pouvez toujours apporter vos propres clés par outil quand vous le souhaitez — la passerelle est par backend, pas tout ou rien.

Référence rapide CLI vs Messagerie

Hermes a deux points d'entrée : démarrez l'interface terminal avec hermes, ou exécutez la passerelle et parlez-lui depuis Telegram, Discord, Slack, WhatsApp, Signal ou Email. Une fois en conversation, de nombreuses commandes slash sont partagées entre les deux interfaces.

Pour les listes complètes des commandes, consultez le guide CLI et le guide Messaging Gateway.

Documentation

Toute la documentation se trouve sur hermes-agent.nousresearch.com/docs :

Migration depuis OpenClaw

Si vous venez d'OpenClaw, Hermes peut importer automatiquement vos paramètres, souvenirs, compétences et clés API.

Lors de la première configuration : L'assistant de configuration (hermes setup) détecte automatiquement ~/.openclaw et propose de migrer avant le début de la configuration.

À tout moment après l'installation :

hermes claw migrate              # Migration interactive (préréglage complet)
hermes claw migrate --dry-run    # Aperçu de ce qui serait migré
hermes claw migrate --preset user-data   # Migrer sans secrets
hermes claw migrate --overwrite  # Écraser les conflits existants

Ce qui est importé :

• SOUL.md — fichier de personnalité
• Souvenirs — entrées MEMORY.md et USER.md
• Compétences — compétences créées par l'utilisateur → ~/.hermes/skills/openclaw-imports/
• Liste blanche de commandes — modèles d'approbation
• Paramètres de messagerie — configurations de plateforme, utilisateurs autorisés, répertoire de travail
• Clés API — secrets sur liste blanche (Telegram, OpenRouter, OpenAI, Anthropic, ElevenLabs)
• Ressources TTS — fichiers audio de l'espace de travail
• Instructions d'espace de travail — AGENTS.md (avec --workspace-target)

Consultez hermes claw migrate --help pour toutes les options, ou utilisez la compétence openclaw-migration pour une migration interactive guidée par agent avec aperçus dry-run.

Contribution

Nous accueillons les contributions ! Consultez le Guide de contribution pour la configuration de développement, le style de code et le processus de PR.

Démarrage rapide pour les contributeurs — utilisez l'installateur standard, puis travaillez à partir du clone git complet qu'il crée dans $HERMES_HOME/hermes-agent (généralement ~/.hermes/hermes-agent). Cela correspond à la disposition utilisée par hermes update, le venv géré, les dépendances paresseuses, la passerelle et les outils de documentation.

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
cd "${HERMES_HOME:-$HOME/.hermes}/hermes-agent"
uv pip install -e ".[all,dev]"
scripts/run_tests.sh

Repli de clonage manuel (pour les clones jetables/CI où vous ne souhaitez intentionnellement pas la disposition d'installation gérée) :

Créez le venv en dehors de l'arborescence source clonée — un venv à l'intérieur du répertoire d'où l'agent opère peut être effacé par une commande à chemin relatif que l'agent exécute contre son propre checkout, détruisant le runtime en cours en pleine session.

curl -LsSf https://astral.sh/uv/install.sh | sh
uv venv ~/.hermes/venvs/hermes-dev --python 3.11
source ~/.hermes/venvs/hermes-dev/bin/activate
uv pip install -e ".[all,dev]"
scripts/run_tests.sh

Communauté

• 💬 Discord
• 📚 Skills Hub
• 🐛 Problèmes
• 🔌 computer-use-linux — Serveur MCP de contrôle de bureau Linux pour Hermes et autres hôtes MCP, avec arbres d'accessibilité AT-SPI, entrée Wayland/X11, captures d'écran et ciblage de fenêtres du compositeur.
• 🔌 HermesClaw — Pont WeChat communautaire : exécutez Hermes Agent et OpenClaw sur le même compte WeChat.

Licence

MIT — voir LICENSE.

Conçu par Nous Research.