Guide d’intégration agent
Utiliser Hermes avec l’API LLM WaveSpeed
Ce guide montre comment connecter Hermes à WaveSpeed AI avec ~/.hermes/config.yaml, Chat completions compatibles OpenAI, /v1/chat/completions, la base URL https://llm.wavespeed.ai/v1 et le modèle par défaut anthropic/claude-opus-4.8. Copiez la configuration ci-dessus, exportez votre clé API, lancez l’agent, puis vérifiez les requests dans Logs.
Créer une clé d’accès WaveSpeed
Exporter localement la clé requise
Coller la configuration dans
~/.hermes/config.yamlExécuter hermes chat et consulter Logs
Ce que configure ce setup Hermes
Protocole
Chat completions compatibles OpenAI
Endpoint
/v1/chat/completions
Modèle
anthropic/claude-opus-4.8
La configuration prête à copier ci-dessus est le seul fichier Hermes à modifier pour le setup recommandé : ~/.hermes/config.yaml. Gardez la clé API dans votre environnement shell afin de ne pas la commit dans un dépôt.
Dépannage
La clé API n’est pas prise en compte
Exportez WAVESPEED_API_KEY dans le même shell que celui où vous lancez Hermes. Si vous utilisez un profil shell, rechargez le terminal avant de démarrer l’agent.
Les requests échouent avec une erreur de protocole ou endpoint
Vérifiez que Hermes utilise Chat completions compatibles OpenAI et endpoint /v1/chat/completions. Les incompatibilités de protocole sont la cause la plus fréquente des erreurs 404 ou payload.
Le modèle sélectionné ne fonctionne pas
Confirmez que l’ID du modèle existe dans WaveSpeed Models, puis collez l’ID exact dans ~/.hermes/config.yaml. Vous pouvez commencer avec le modèle par défaut affiché sur cette page.
Aucun request n’apparaît dans Logs
Vérifiez que Hermes utilise la base URL WaveSpeed et votre clé API actuelle. Envoyez ensuite un nouveau prompt depuis l’agent local et actualisez Logs.
Ce guide Hermes peut-il apparaître dans les moteurs de recherche ?
Oui. Cette page est conçue comme un guide de setup indexable pour les utilisateurs recherchant Hermes custom provider, endpoint compatible OpenAI, base URL et workflows de configuration locale d’agent.