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

# Hermes

> Use RedPill as a named custom provider in Hermes Agent

Hermes supports custom Chat Completions providers in `~/.hermes/config.yaml`.

## Configure

Export your key:

```bash theme={null}
export REDPILL_AI_API_KEY="YOUR_API_KEY"
```

Add and select the provider:

```yaml ~/.hermes/config.yaml theme={null}
providers:
  redpill:
    api: https://api.redpill.ai/v1
    key_env: REDPILL_AI_API_KEY
    transport: chat_completions
    default_model: z-ai/glm-5.2
    discover_models: true

model:
  provider: custom:redpill
  default: z-ai/glm-5.2
```

Hermes reads `REDPILL_AI_API_KEY` from its process environment or `~/.hermes/.env`. Do not put the key
directly in `config.yaml`.

## Check the setup

Start a new session and confirm the active provider with `/model`:

```bash theme={null}
hermes
```

Existing sessions remain pinned to their original provider. Start a new session after a config
change, and restart a running Hermes gateway when every session must use the new provider.

Run one harmless tool task before unattended work. Features that use separate image, speech,
embedding, search, or browser providers do not automatically use RedPill.

## Privacy and rollback

Use `https://tee.redpill.ai/v1` only with an `is_tee: true` model for confidential-only routing. To
roll back, exit the current session, run `hermes model`, select the previous provider, and remove the
`providers.redpill` block if it is no longer needed.

## Troubleshooting

| Symptom                        | Check                                                          |
| ------------------------------ | -------------------------------------------------------------- |
| Provider is not selected       | Start a new session and choose `custom:redpill` with `/model`. |
| Authentication fails           | Export `REDPILL_AI_API_KEY` in the Hermes process environment. |
| Old sessions use another model | Exit and create a new session after changing the provider.     |

## References

* [Hermes model providers](https://hermes-agent.nousresearch.com/docs/integrations/providers)
* [RedPill model catalog](/api-reference/models)