Prérequis

(Hermes seul)

Une machine ou VM dédiée (LXC compatible)

Pour un Hermes de base (sans LLM local) :

RAM :
- 1 Go → minimum (test uniquement)
- 2 Go → recommandé
- 4 Go -> confortable
CPU / vCPU :
- 1 vCPU → suffisant
- 2 vCPU → recommandé
Espace disque :
- 5 Go → minimum
- 10 Go → confortable
GPU :
- Inutile

Installation Hermes (service dédié)

Installation (Debian)

# apt update && apt upgrade
# apt install curl git
# curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

How would you like to set up Hermes?
> (○) Quick setup — provider, model & messaging (recommended)

Ollama local :

Select provider:
>(○) Custom endpoint (enter URL manually)

Custom OpenAI-compatible endpoint configuration:
API base URL [e.g. https://api.example.com/v1]: http://IP_OLLAMA:11434/v1
API key [optional]:

Detected model: mon_model
Use this model? [Y/n]: Y

Context length in tokens [leave blank for auto-detect]:

Display name [192.168.2.216:11434]: Ollama

Remplir les options désirées puis fin de l'installation :

Launch hermes chat now? [Y/n]: y

Ensuite, inscrire Hermes comme service pour qu'il se lance automatiquement :

Sur une machine physique ou VM :

# hermes gateway install --system

Dans un LXC :

# hermes gateway install --system --run-as-user root

# systemctl enable hermes-gateway.service      
# systemctl start hermes-gateway.service

Configuration

Activer le serveur API :

On édite le fichier :

# vi ~/.hermes/.env

Ajouter :

...
API_SERVER_ENABLED=true
API_SERVER_KEY="maclefsecrete"
# pour autoriser toutes les interfaces :
API_SERVER_HOST=0.0.0.0
# pour autoriser une seule interface :
# API_SERVER_HOST=IP_HERMES
API_SERVER_PORT=8642

Si API_SERVER_HOST=0.0.0.0 : L’API est accessible sur le réseau. Limiter l’accès via firewall ou réseau privé recommandé.

On relance le service :

# systemctl restart hermes-gateway.service

Pour tester :

# curl http://IP_HERMES:8642/health

Doit renvoyer :

{"status":"ok"}

Pour vérifier le modèle exposé :

# curl http://IP_HERMES:8642/v1/models -H "Authorization: Bearer maclefsecrete"

Commandes

Lancer l’interface interactive :

# hermes

Choisir le modèle et le provider LLM :

# hermes model

Configurer les outils disponibles :

# hermes tools

Modifier une configuration spécifique :

# hermes config set

Démarrer le gateway (Telegram, Discord, etc.) :

# hermes gateway

Lancer le script de configuration complet :

# hermes setup

Migrer depuis OpenClaw :

# hermes claw migrate

Mettre à jour Hermes :

# hermes update

Diagnostiquer les problèmes :

# hermes doctor

MCP

SearXNG

# vi ~/.hermes/config.yaml

On inscrit le serveur (créer la section mcp_servers si absente) :

...
mcp_servers:
  searxng:
    url: "http://IP_MCP:3000/mcp"
...

La section mcp_servers doit être au niveau racine (tout à gauche)

On redémarre le service :

# systemctl restart hermes-gateway.service

Ou depuis Hermes :

/reload-mcp

Test :

# hermes mcp list