> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sideren.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Hermes Agent on Sideren.

> One command wires Hermes Agent to Sideren — a named provider in ~/.hermes/config.yaml, the key in ~/.hermes/.env.

Hermes Agent speaks the OpenAI [Chat Completions](/api/chat-completions) dialect and takes
named providers, so Sideren is a config file away.

## One command

```sh theme={null}
npx sideren setup --tool hermes --key sdn_your_key --model auto
```

The setup helper writes a **named** provider (the current Hermes shape) — not bare
`provider: custom` with an inline `api_key`. Bare custom still falls through to
OpenRouter on some agent-run paths, and secrets belong in `~/.hermes/.env`.

## By hand

```yaml title="~/.hermes/config.yaml" theme={null}
model:
  provider: custom:sideren
  default: auto

providers:
  sideren:
    name: Sideren
    api: https://api.sideren.io/v1
    key_env: SIDEREN_API_KEY
    transport: chat_completions
    default_model: auto
```

```sh title="~/.hermes/.env" theme={null}
SIDEREN_API_KEY=sdn_your_key
```

The `/v1` in `api` is required — Hermes does not add it. Swap `default` /
`default_model` to `"@sdn/glm-5"` for heavy coding, or any other [catalog id](/models) —
quote it, because an unquoted `@` is invalid YAML.

## Verify

Run `hermes` and send a trivial prompt; switch models later with `hermes model` or
`/model` inside a session. To confirm the key works against the gateway without Hermes in
the loop:

```sh theme={null}
npx sideren test --key sdn_your_key
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.