Skip to content

Hermes

Configure the Hermes agent to use Engy models as a custom provider.

This page explains how to configure the Hermes agent to use Engy as a custom model provider. It is intended for developers who want to use open models from Engy in Hermes.

Prerequisites

Before you begin, make sure you have:

  • Hermes installed
  • An Engy API key. For details, see API keys

Configure Hermes

Add Engy as the model provider

Open ~/.hermes/config.yaml in a text editor, and add the following settings. Replace sk-engy-... with your API key.

~/.hermes/config.yaml
model:
  provider: "custom"
  default: "glm-5.2"
  base_url: "https://api.engy.ai/v1"
  api_key: "sk-engy-..."

Start Hermes

Run hermes chat in your terminal.

Settings reference

SettingDescription
providerThe provider type. Set it to custom for an OpenAI-compatible API.
defaultThe Engy model ID. For the list of models, see Models and pricing.
base_urlThe Engy API base URL, including /v1.
api_keyYour Engy API key.

The configuration file contains your API key. Restrict access to the file, for example with chmod 600 ~/.hermes/config.yaml, and do not commit it to source control.