Hermes Agent + DeepSeek sur le réseau Gonka : un agent autonome à petit prix

Installation de Hermes (Linux, macOS, WSL2). L'installateur officiel récupérera automatiquement Python, Node.js, ripgrep et ffmpeg :

# Linux / macOS / WSL2
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

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

Après l'installation, redémarrez votre shell et vérifiez s'il s'exécute :

source ~/.bashrc   # ou ~/.zshrc
hermes             # CLI interactive

Clé API JoinGonka : si vous n'en avez pas encore, inscrivez-vous sur gate.joingonka.ai/register, vérifiez votre adresse e-mail — 3M de jetons gratuits seront crédités sur votre compte — et créez une clé avec le préfixe jg- dans le Dashboard. Une seule clé et un seul solde fonctionnent immédiatement pour tous les modèles.

Hermes fonctionne avec n'importe quel endpoint compatible OpenAI : si le serveur répond à /v1/chat/completions — Hermes peut y être dirigé. La passerelle JoinGonka est exactement cela. Il y a trois façons de le configurer.

Méthode 1 : notre installateur (une seule commande, recommandé). Il configurera le fournisseur dans le fichier de configuration d'Hermes, définira DeepSeek V4 Flash comme modèle par défaut et vérifiera par une requête en direct que la passerelle accepte la clé et le modèle :

npx @joingonka/setup --tool hermes

Méthode 2 : assistant de configuration. Exécutez dans le terminal en dehors d'une session active :

hermes model

Dans la liste des fournisseurs, sélectionnez « Custom endpoint (self-hosted / VLLM / etc.) » et entrez trois valeurs :

• API base URL : https://gate.joingonka.ai/v1
• API key : jg-votre-clé
• Model name : deepseek-ai/DeepSeek-V4-Flash-0731

Méthode 3 : édition manuelle de la configuration. Hermes stocke les paramètres des modèles dans ~/.hermes/config.yaml — c'est la seule source de vérité. Ajoutez la section suivante :

# ~/.hermes/config.yaml
model:
  provider: custom
  model: deepseek-ai/DeepSeek-V4-Flash-0731
  base_url: https://gate.joingonka.ai/v1
  api_key: jg-votre-clé

⚠️ La clé doit se trouver uniquement dans model.api_key. La documentation d'Hermes autorise OPENAI_API_KEY dans ~/.hermes/.env, mais cela ne fonctionne pas pour un endpoint personnalisé : Hermes lit la clé uniquement à partir de model.api_key, et avec la clé dans .env, la passerelle répondra par 401 Invalid API key. Testé sur Hermes v0.20.4.

Vérification : lancez hermes et tapez « Crée un fichier hello.py avec une fonction hello world ». L'agent doit créer le fichier et afficher le résultat. L'état actuel de la configuration est visible via hermes config show | grep '^model\.' et hermes status.

Basculement à la volée : pendant la session avec la commande /model custom:deepseek-ai/DeepSeek-V4-Flash-0731. Et /model custom sans nom récupérera automatiquement le modèle depuis l'endpoint s'il n'y en a qu'un seul.

Hermes est un outil d'agent avec mémoire et compétences. Il ne répond pas par une simple réplique : il lit des fichiers, écrit du code, exécute des commandes, compresse le contexte, gère de longues tâches en arrière-plan via un planificateur. Chaque action est un appel API, et une journée de travail autonome accumule des dizaines de millions de tokens. Comparons le coût des sessions typiques :

Avec JoinGonka Gateway, Hermes peut rester actif 24h/24 : rapports de nuit, audits hebdomadaires, tâches en arrière-plan via un planificateur cron — sans se soucier de la facture. Aux prix d'Anthropic, chaque exécution de ce type devrait être calculée manuellement. Le solde de départ lors de l'inscription suffit à faire tourner l'agent sur une tâche réelle et à constater sa propre consommation avant la première recharge.

Via la Gateway, l'utilisateur a immédiatement accès à trois modèles Gonka — tous supportent le tool calling natif (OpenAI function calling), ce qui permet aux compétences et aux outils de Hermes de fonctionner de manière fiable, sans parsing des réponses textuelles :

À propos des limites de tokens dans Hermes. Dans config.yaml, le champ context_length est la fenêtre de contexte totale (entrée + sortie), et max_tokens est le plafond uniquement pour la longueur de la réponse. Il est préférable de ne pas définir les deux : Hermes déterminera lui-même les valeurs correctes via le fournisseur. Si vous définissez max_tokens manuellement, gardez-le dans les limites du modèle : via la Gateway, c'est 32768 pour DeepSeek V4 Flash et 8192 pour MiniMax M2.7 et GLM-5.3 Flash. Vous pouvez changer de modèle à tout moment avec la commande hermes model ou directement dans la session via /model.

Outils de terminal similaires dans notre base de connaissances : Claude Code, Cline.