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

Installer Hermes (Linux, macOS, WSL2). L'installateur officiel récupère 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, rechargez votre shell et vérifiez que tout fonctionne :

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

Clé API JoinGonka : si vous n'en avez pas encore, inscrivez-vous sur gate.joingonka.ai/register, confirmez votre adresse — 3M tokens gratuits seront crédités sur votre compte — puis 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 un serveur répond à /v1/chat/completions, Hermes peut y être pointé. La Gateway JoinGonka est exactement de ce type. Trois méthodes de configuration s'offrent à vous.

Méthode 1 : notre installateur (une seule commande, recommandée). Il inscrit le fournisseur dans la config Hermes, définit DeepSeek V4 Flash comme modèle par défaut et vérifie par une requête en direct que la gateway accepte la clé et le modèle :

npx @joingonka/setup --tool hermes

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

hermes model

Dans la liste des fournisseurs, choisissez « Custom endpoint (self-hosted / VLLM / etc.) » et saisissez trois valeurs :

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

Méthode 3 : modification du fichier de config. Hermes stocke les réglages des modèles dans ~/.hermes/config.yaml (dans la build native Windows — %LOCALAPPDATA%\hermes\config.yaml) — c'est l'unique source de vérité. Ajoutez la section :

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

Le nom du modèle s'écrit dans la clé default — c'est la clé canonique de Hermes. La ligne model: à l'intérieur du bloc n'est qu'un alias de secours : elle n'a aucun effet si default est déjà défini (par l'assistant de configuration, par exemple), donc en cas de modification manuelle, c'est bien default qu'il faut changer.

⚠️ La clé va uniquement dans model.api_key. La documentation de Hermes autorise OPENAI_API_KEY dans ~/.hermes/.env, mais avec un endpoint personnalisé cela ne fonctionne pas : Hermes ne lit la clé que dans model.api_key, et avec la clé dans .env, la gateway répondra 401 Invalid API key. Vérifié sur Hermes v0.20.4.

Vérification : lancez hermes et écrivez « 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 de la configuration actuelle est visible via hermes config show | grep '^model\.' et hermes status.

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

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.