Hermes est un outil d’agent de Nous Research. Il peut se connecter à un point de terminaison personnalisé compatible OpenAI, ce qui vous permet d’utiliser les modèles LLM de Novita dans Hermes pour des workflows d’agents locaux.
Prérequis
Avant de commencer, préparez les valeurs suivantes :
- Clé API : créez ou copiez une clé API depuis Gestion des clés.
- URL de base :
https://api.novita.ai/openai/v1
- ID du modèle : copiez l’ID du modèle que vous souhaitez utiliser depuis le Model Hub, par exemple
deepseek/deepseek-v3.1.
Hermes stocke localement les paramètres du point de terminaison et de la clé API. Ne validez aucune configuration générée contenant votre clé API.
Installer Hermes
Hermes propose des options d’installation pour terminal et ordinateur de bureau. Choisissez celle qui convient à votre workflow.
Linux / macOS / WSL2
Windows PowerShell
Bureau
Vous pouvez également télécharger Hermes Desktop depuis :
Après l’installation, exécutez le flux de configuration de Hermes. La commande exacte peut varier selon la version de Hermes ; suivez donc les invites du terminal correspondant à votre version installée.
Pendant la configuration, utilisez les choix et valeurs suivants :
- Sélectionnez Custom endpoint ou l’option qui vous permet de saisir manuellement une URL de fournisseur.
- Définissez l’URL de base sur
https://api.novita.ai/openai/v1.
- Saisissez votre clé API Novita.
- Pour le type d’API, conservez l’option de détection automatique par défaut. Si vous devez choisir manuellement, sélectionnez le mode compatible OpenAI ou Chat Completions.
- Sélectionnez un modèle dans la liste, ou saisissez manuellement un ID de modèle Novita, par exemple
deepseek/deepseek-v3.1.
- Définissez le nombre maximal de tokens en fonction de la longueur de contexte du modèle. Si vous n’êtes pas sûr, conservez la valeur par défaut ou détectée automatiquement.
- Donnez à la configuration du modèle un nom reconnaissable, par exemple
novita-deepseek-v3.1.
- Si vous souhaitez uniquement exécuter Hermes localement, choisissez le runtime Local par défaut.
- Si vous n’avez pas besoin de canaux tels que Telegram, Slack ou Matrix, ignorez les canaux d’intégration.
Recharger votre shell
Si Hermes vous demande de recharger votre shell, exécutez :
Démarrer Hermes
Démarrez Hermes depuis votre terminal :
Envoyez un message de test, par exemple :
Si la requête échoue, vérifiez que :
- Votre clé API est correcte.
- L’URL de base est
https://api.novita.ai/openai/v1.
- L’ID du modèle correspond à celui affiché dans le Model Hub de Novita.
- Le type d’API sélectionné est compatible avec un point de terminaison compatible OpenAI.
