Hermes

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

Plugins

web-search-plus

Si nécessaire installer les dépendances :

# apt update && apt upgrade
# apt install git python3-venv

Installation du plugin :

# git clone https://github.com/robbyczgw-cla/hermes-web-search-plus.git ~/.hermes/plugins/web-search-plus

Installation des dépendances Python dans l'environnement Hermes :

# cd ~/.hermes/hermes-agent
# source venv/bin/activate
# python -m ensurepip --upgrade
# python -m pip install --upgrade pip
# python -m pip install requests

Configuration du plugin :

# cd ~/.hermes/plugins/web-search-plus
# cp .env.template .env
# vi ~/.hermes/plugins/web-search-plus/.env

On configure SearXNG :

SEARXNG_INSTANCE_URL=http://IP_SEARXNG:8080

On active le plugin :

# vi ~/.hermes/config.yaml

plugins:
  enabled:
    - web-search-plus

tools:
  enabled:
    - web
    - web-search-plus

Créer les sections "plugins" et "tools" si nécessaire.

On autorise le plugin a utiliser une IP local pour searxng :

# systemctl edit hermes-gateway.service

Ajouter dans la zone d’édition (partie supérieure du fichier) :

...
### Anything between here and the comment below will become the contents of the drop-in file

[Service]
Environment="SEARXNG_ALLOW_PRIVATE=1"
Environment="SEARXNG_INSTANCE_URL=http://192.168.2.218:8080"

### Edits below this comment will be discarded
...

On redémarre le service :

# systemctl restart hermes-gateway.service