# Hermes Agent

Source: https://cicora.ai/en/docs/hermes

## Prepare a key and balance

This guide starts with an installed [Hermes Agent](https://hermes-agent.nousresearch.com/docs/getting-started/installation). The `hermes` command must be available in your terminal.

In [API keys](https://app.cicora.ai/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](https://app.cicora.ai/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](/en/docs/authentication) and [balance funding](/en/docs/billing-balance) for details.

## Configure the provider

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

```bash
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.

| Field                  | Value                      |
| ---------------------- | -------------------------- |
| API base URL           | `https://api.cicora.ai/v1` |
| API key                | The full cicora.ai key     |
| API compatibility mode | **Chat Completions**       |

## 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](/en/docs/models).
* **Context length in tokens:** press Enter for automatic detection.
* **Display name:** enter `Cicora.ai` and press Enter to save.

## Verify the connection

```bash
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`.

```bash
hermes
```

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

## Troubleshooting


**The model is not in the list**


Check current availability and the exact ID in the [model
catalog](/en/docs/models). Do not use an ID from an old example.


**Settings are saved, but there is no response**


Check the full key, available funds, and [key spending
limit](/en/docs/spend-limits). Run `hermes model` again to correct the URL,
key, or API mode.

## FAQ

### What is cicora.ai?

cicora.ai is a multi-model AI workspace and compatible API for chat, text, images, video, coding tools, and teams. Start with the [overview](/en.md), [documentation](/en/docs.md), or [model catalog](/en/models.md).

### How is usage billed?

Confirmed usage is charged in USD from the active workspace's prepaid balance. Use the live catalog for current model prices and the [usage guide](/en/docs/usage-costs.md) for settlement details.

### Which protocols and integrations are available?

Documentation covers OpenAI-compatible Chat Completions and Responses, Anthropic Messages, image interfaces, Claude Code, OpenCode, and Codex CLI. Compatibility does not imply support for every upstream parameter.

### Which sources are authoritative and current?

For model IDs, availability, capabilities, limits, and prices, use the [live catalog](/en/models.md). For API behavior, use the matching [documentation page](/en/docs.md). Never include API keys, private workspace data, or preview URLs in public documents.