nousresearch/hermes-agentL'agent qui grandit avec vous
<p align="center">
<img src="https://assets.kitploit.com/production/public/readmes/7225/75e85ef6fecf5a6227985f2082e5b35331fceff4d8db03720c82a7d9ee8b7eea.png" alt="Hermes Agent" width="100%">
</p>
# Hermes Agent ☤
<p align="center">
<a href="https://hermes-agent.nousresearch.com/">Hermes Agent</a> | <a href="https://hermes-agent.nousresearch.com/">Hermes Desktop</a>
</p>
<p align="center">
<a href="https://hermes-agent.nousresearch.com/docs/"><img src="https://img.shields.io/badge/Docs-hermes--agent.nousresearch.com-FFD700?style=for-the-badge" alt="Documentation"></a>
<a href="https://discord.gg/NousResearch"><img src="https://img.shields.io/badge/Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Discord"></a>
<a href="https://github.com/NousResearch/hermes-agent/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-green?style=for-the-badge" alt="Licence : MIT"></a>
<a href="https://nousresearch.com"><img src="https://img.shields.io/badge/Built%20by-Nous%20Research-blueviolet?style=for-the-badge" alt="Développé par Nous Research"></a>
<a href="https://github.com/nousresearch/hermes-agent/blob/main/README.zh-CN.md"><img src="https://img.shields.io/badge/Lang-%E4%B8%AD%E6%96%87-red?style=for-the-badge" alt="中文"></a>
<a href="https://github.com/nousresearch/hermes-agent/blob/main/README.ur-pk.md"><img src="https://img.shields.io/badge/Lang-%D8%A7%D8%B1%D8%AF%D9%88-green?style=for-the-badge" alt="اردو"></a>
<a href="https://github.com/nousresearch/hermes-agent/blob/main/README.es.md"><img src="https://img.shields.io/badge/Lang-Espa%C3%B1ol-orange?style=for-the-badge" alt="Español"></a>
</p>
**L'agent IA auto-améliorant conçu par [Nous Research](https://nousresearch.com).** 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 pendant leur utilisation, se pousse lui-même à conserver ses connaissances, explore ses propres conversations passées et construit un modèle de plus en plus précis 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](https://portal.nousresearch.com), OpenRouter, OpenAI, votre propre endpoint, et [bien d'autres](https://hermes-agent.nousresearch.com/docs/integrations/providers). Changez avec `hermes model` — aucune modification de code, aucun verrouillage.
<table>
<tr><td><b>Une véritable interface de terminal</b></td><td>TUI complète avec édition multiligne, autocomplétion des commandes slash, historique des conversations, interruption-et-redirection, et sortie des outils en streaming.</td></tr>
<tr><td><b>Vit là où vous vivez</b></td><td>Telegram, Discord, Slack, WhatsApp, Signal et CLI — le tout depuis un seul processus de passerelle. Transcription des mémos vocaux, continuité des conversations entre plateformes.</td></tr>
<tr><td><b>Une boucle d'apprentissage fermée</b></td><td>Mémoire organisée par l'agent avec des rappels périodiques. Création autonome de compétences après des tâches complexes. Les compétences s'auto-améliorent pendant leur utilisation. Recherche de sessions FTS5 avec résumé par LLM pour le rappel entre sessions. Modélisation dialectique de l'utilisateur via <a href="https://github.com/plastic-labs/honcho">Honcho</a>. Compatible avec le standard ouvert <a href="https://agentskills.io">agentskills.io</a>.</td></tr>
<tr><td><b>Automatisations planifiées</b></td><td>Planificateur cron intégré avec livraison vers n'importe quelle plateforme. Rapports quotidiens, sauvegardes nocturnes, audits hebdomadaires — le tout en langage naturel, fonctionnant sans surveillance.</td></tr>
<tr><td><b>Délègue et parallélise</b></td><td>Générez des sous-agents isolés pour des flux de travail parallèles. Dans Desktop, choisissez leur fournisseur, modèle et limites sous Settings → Model → Subagents, puis appliquez la route complète. Écrivez des scripts Python qui appellent des outils via RPC, transformant des pipelines multi-étapes en tours à coût de contexte nul.</td></tr>
<tr><td><b>S'exécute partout, pas seulement sur votre ordinateur portable</b></td><td>Sept backends de terminal — local, Docker, SSH, Singularity, Modal, Daytona et Vercel Sandbox. Daytona et Modal offrent une persistance serverless — l'environnement de votre agent se met en veille lorsqu'il est inactif et se réveille à la demande, ne coûtant presque rien entre les sessions. Exécutez-le sur un VPS à 5 $ ou un cluster GPU.</td></tr>
<tr><td><b>Prêt pour la recherche</b></td><td>Génération de trajectoires par lots, compression de trajectoires pour entraîner la prochaine génération de modèles d'appel d'outils.</td></tr>
</table>
---
## Installation rapide
### Linux, macOS, WSL2
```bash
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
```
### Windows (natif, PowerShell)
> **Attention :** Windows natif exécute Hermes sans WSL — la CLI, la passerelle, la TUI et les outils fonctionnent tous nativement. Si vous préférez utiliser WSL2, la commande unique Linux/macOS ci-dessus y fonctionne également. Vous avez trouvé un bug ? Veuillez [ouvrir un ticket](https://github.com/NousResearch/hermes-agent/issues).
Exécutez ceci dans PowerShell :
```powershell
iex (irm https://hermes-agent.nousresearch.com/install.ps1)
```
L'installateur source délègue Python 3.14, Node.js, npm, ripgrep, FFmpeg et les dépendances Python à PM. Si Git est absent, il dépose l'archive vérifiée de Git for Windows dans le magasin d'outils de Hermes. Il ne remplace pas votre Git système. Consultez les [méthodes d'installation](https://hermes-agent.nousresearch.com/docs/getting-started/installation) pour le paquet MSIX/App Installer séparé et la gestion de ses mises à jour.
> **Android / Termux :** Un dépôt APT signé est disponible pour les appareils aarch64, avec un canal `stable` (versions étiquetées) et un canal de préversion `canary`. Le paquet inclut Python, Node.js et la TUI. Utilisez le [guide Termux](https://hermes-agent.nousresearch.com/docs/getting-started/termux), et non le script d'installation pour poste de travail/serveur.
>
> **Windows :** Windows natif est entièrement pris en charge — la commande PowerShell ci-dessus installe tout. Si vous préférez utiliser WSL2, la commande Linux fonctionne également. L'installation native sous Windows se trouve dans `%LOCALAPPDATA%\hermes` ; l'installation WSL2 se fait sous `~/.hermes` comme sous Linux.
Après l'installation :
```bash
source ~/.bashrc # reload shell (or: source ~/.zshrc)
hermes # start chatting!
```
### Dépannage
#### Windows Defender ou un 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 qu'Hermes embarque 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 :**
```powershell
# Install GitHub CLI if needed
winget install --id GitHub.cli
# Login to GitHub
gh auth login
# Run verification
$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 est bon.
**Pour mettre Hermes en 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 en 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](https://github.com/astral-sh/uv/issues/13553), [astral-sh/uv#15011](https://github.com/astral-sh/uv/issues/15011), [astral-sh/uv#10079](https://github.com/astral-sh/uv/issues/10079).
---
## Premiers pas
```bash
hermes # Interactive CLI — start a conversation
hermes model # Choose your LLM provider and model
hermes tools # Configure which tools are enabled
hermes config set # Set individual config values
hermes config get # Print individual config values
hermes gateway # Start the messaging gateway (Telegram, Discord, etc.)
hermes setup # Run the full setup wizard (configures everything at once)
hermes claw migrate # Migrate from OpenClaw (if coming from OpenClaw)
hermes update # Update to the latest version
hermes doctor # Diagnose any issues
```
📖 **[Documentation complète →](https://hermes-agent.nousresearch.com/docs/)**
---
## É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 synthèse vocale et un navigateur cloud, **[Nous Portal](https://portal.nousresearch.com)** les couvre toutes sous un seul abonnement :
- **Plus de 300 modèles** — choisissez n'importe lequel avec `/model <name>`
- **Tool Gateway** — recherche web, génération d'images (FAL), synthèse vocale (OpenAI), navigateur cloud (Browser Use), le tout acheminé via votre abonnement. Aucun compte supplémentaire.
Une seule commande depuis une installation fraîche :
```bash
hermes setup --portal
```
Cela vous connecte via OAuth, définit Nous comme fournisseur et active le Tool Gateway. Vérifiez à tout moment ce qui est configuré avec `hermes portal info`. Tous les détails sur la [page de documentation du Tool Gateway](https://hermes-agent.nousresearch.com/docs/user-guide/features/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 dispose de deux points d'entrée : lancez l'interface terminal avec `hermes`, ou exécutez la passerelle et dialoguez avec elle depuis Telegram, Discord, Slack, WhatsApp, Signal ou Email. Une fois dans une conversation, de nombreuses commandes slash sont partagées entre les deux interfaces.
| Action | CLI | Plateformes de messagerie |
| ------------------------------ | --------------------------------------------- | -------------------------------------------------------------------------------- |
| Démarrer une conversation | `hermes` | Exécutez `hermes gateway setup` + `hermes gateway start`, puis envoyez un message au bot |
| Démarrer une nouvelle conversation | `/new` ou `/reset` | `/new` ou `/reset` |
| Changer de modèle | `/model [provider:model]` | `/model [provider:model]` |
| Définir une personnalité | `/personality [name]` | `/personality [name]` |
| Réessayer ou annuler le dernier tour | `/retry`, `/undo` | `/retry`, `/undo` |
| Compresser le contexte / vérifier l'utilisation | `/compress`, `/usage`, `/insights [--days N]` | `/compress`, `/usage`, `/insights [days]` |
| Parcourir les compétences | `/skills` ou `/<skill-name>` | `/<skill-name>` |
| Interrompre le travail en cours | `Ctrl+C` ou envoyer un nouveau message | `/stop` ou envoyer un nouveau message |
| Statut spécifique à la plateforme | `/platforms` | `/status`, `/sethome` |
Pour les listes complètes de commandes, consultez le [guide CLI](https://hermes-agent.nousresearch.com/docs/user-guide/cli) et le [guide de la passerelle de messagerie](https://hermes-agent.nousresearch.com/docs/user-guide/messaging).
---
## Documentation
Toute la documentation se trouve sur **[hermes-agent.nousresearch.com/docs](https://hermes-agent.nousresearch.com/docs/)** :
| Section | Contenu couvert |
| --------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
| [Quickstart](https://hermes-agent.nousresearch.com/docs/getting-started/quickstart) | Installation → configuration → première conversation en 2 minutes |
| [CLI Usage](https://hermes-agent.nousresearch.com/docs/user-guide/cli) | Commandes, raccourcis clavier, personnalités, sessions |
| [Configuration](https://hermes-agent.nousresearch.com/docs/user-guide/configuration) | Fichier de configuration, fournisseurs, modèles, toutes les options |
| [Messaging Gateway](https://hermes-agent.nousresearch.com/docs/user-guide/messaging) | Telegram, Discord, Slack, WhatsApp, Signal, Home Assistant |
| [Security](https://hermes-agent.nousresearch.com/docs/user-guide/security) | Approbation des commandes, appairage des messages privés, isolation par conteneur |
| [Tools & Toolsets](https://hermes-agent.nousresearch.com/docs/user-guide/features/tools) | Plus de 40 outils, système de toolsets, backends de terminal |
| [Skills System](https://hermes-agent.nousresearch.com/docs/user-guide/features/skills) | Mémoire procédurale, Skills Hub, création de skills |
| [Memory](https://hermes-agent.nousresearch.com/docs/user-guide/features/memory) | Mémoire persistante, profils utilisateur, bonnes pratiques |
| [MCP Integration](https://hermes-agent.nousresearch.com/docs/user-guide/features/mcp) | Connecter n'importe quel serveur MCP pour étendre les capacités |
| [Cron Scheduling](https://hermes-agent.nousresearch.com/docs/user-guide/features/cron) | Tâches planifiées avec livraison sur les plateformes |
| [Context Files](https://hermes-agent.nousresearch.com/docs/user-guide/features/context-files) | Contexte de projet qui façonne chaque conversation |
| [Architecture](https://hermes-agent.nousresearch.com/docs/developer-guide/architecture) | Structure du projet, boucle de l'agent, classes clés |
| [Contributing](https://hermes-agent.nousresearch.com/docs/developer-guide/contributing) | Configuration de développement, processus de PR, style de code |
| [CLI Reference](https://hermes-agent.nousresearch.com/docs/reference/cli-commands) | Toutes les commandes et options |
| [Environment Variables](https://hermes-agent.nousresearch.com/docs/reference/environment-variables) | Référence complète des variables d'environnement |
---
## Migration depuis OpenClaw
Si vous venez d'OpenClaw, Hermes peut importer automatiquement vos paramètres, vos mémoires, vos skills et vos clés API.
**Lors de la configuration initiale :** 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 :**
```bash
hermes claw migrate # Interactive migration (full preset)
hermes claw migrate --dry-run # Preview what would be migrated
hermes claw migrate --preset user-data # Migrate without secrets
hermes claw migrate --overwrite # Overwrite existing conflicts
```
Éléments importés :
- **SOUL.md** — fichier de persona
- **Memories** — entrées MEMORY.md et USER.md
- **Skills** — compétences créées par l'utilisateur → `~/.hermes/skills/openclaw-imports/`
- **Command allowlist** — modèles d'approbation
- **Messaging settings** — configurations de plateforme, utilisateurs autorisés, répertoire de travail
- **API keys** — secrets figurant sur la liste autorisée (Telegram, OpenRouter, OpenAI, Anthropic, ElevenLabs)
- **TTS assets** — fichiers audio de l'espace de travail
- **Workspace instructions** — 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 en dry-run.
---
## Contribuer
Les contributions sont les bienvenues ! Consultez le [Guide de contribution](https://hermes-agent.nousresearch.com/docs/developer-guide/contributing) pour la configuration de développement, le style de code et le processus de PR.
Commencez par le [flux de travail développeur PM](https://github.com/nousresearch/hermes-agent/blob/main/website/docs/reference/package-management.md#developer-workflow)
pour l'activation, l'utilisation quotidienne, les modifications de dépendances et la sortie de l'environnement.
[Development Setup](https://github.com/nousresearch/hermes-agent/blob/main/CONTRIBUTING.md#development-setup) couvre l'environnement de test séparé et les commandes de vérification.
---
## Communauté
- 💬 [Discord](https://discord.gg/NousResearch)
- 📚 [Skills Hub](https://agentskills.io)
- 🐛 [Issues](https://github.com/NousResearch/hermes-agent/issues)
- 🔌 [computer-use-linux](https://github.com/avifenesh/computer-use-linux) — serveur MCP de contrôle du bureau Linux pour Hermes et d'autres hôtes MCP, avec arbres d'accessibilité AT-SPI, entrée Wayland/X11, captures d'écran et ciblage de fenêtres de compositeur.
- 🔌 [HermesClaw](https://github.com/AaronWong1999/hermesclaw) — pont WeChat communautaire : exécutez Hermes Agent et OpenClaw sur le même compte WeChat.
---
## Licence
MIT — voir [LICENSE](https://github.com/nousresearch/hermes-agent/blob/main/LICENSE).
Développé par [Nous Research](https://nousresearch.com).