Hermes Agent

Prepare a key and balance

This guide starts with an installed Hermes Agent. The hermes command must be available in your terminal.

In API keys, select Create key, name it Hermes, and immediately copy the full value: it is not shown again. Keep the key and local files containing it out of repositories.

Open Balance, select Top up, choose an amount in USD, and continue to the available checkout. Complete payment, return to the balance page, and check the available funds. The key and balance must belong to the same workspace. See API authentication and balance funding for details.

Configure the provider

If a Hermes chat is open, exit it with /quit first. Run in your terminal:

hermes model

Select Custom endpoint (enter URL manually) and fill in the wizard. Use the option name: its number depends on the version and saved providers.

Select a model

The wizard retrieves Available models through GET /v1/models.

• Select model: the exact ID of an available text model with tools support. Check capabilities in the model catalog.
• Context length in tokens: press Enter for automatic detection.
• Display name: enter Cicora.ai and press Enter to save.

Verify the connection

hermes config get model.base_url
hermes config get model.default
hermes config get model.api_mode

Expected values: https://api.cicora.ai/v1, your selected model ID, and chat_completions.

hermes

Send Reply with ok. A model response confirms that the request completed; saving settings or retrieving the catalog alone does not.

Troubleshooting