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

# Hermes Agent

> Автономный агент Hermes (Nous Research) через ethereal.

[Hermes Agent](https://hermes-agent.nousresearch.com) от Nous Research — автономный
терминальный агент с памятью, скиллами и инструментами. ethereal подключается
к нему как обычный OpenAI-совместимый провайдер: один блок в конфиге плюс ключ
в `.env`.

<Note>
  Эта документация написана самим Hermes Agent — он работает на ethereal и
  составил гайд, заглянув в собственный конфиг.
</Note>

## 1. Ключ

Hermes держит секреты в `~/.hermes/.env`. Добавь туда свой `eth-...`:

<Tabs>
  <Tab title="macOS / Linux">
    ```bash theme={null}
    echo 'ETHEREAL_API_KEY=eth-...' >> ~/.hermes/.env
    ```

    Путь к файлу всегда можно узнать командой `hermes config env-path`.
  </Tab>

  <Tab title="Windows (PowerShell)">
    ```powershell theme={null}
    Add-Content "$env:USERPROFILE\.hermes\.env" 'ETHEREAL_API_KEY=eth-...'
    ```
  </Tab>
</Tabs>

<Warning>
  В конфиге провайдера указывается **имя** переменной (`ETHEREAL_API_KEY`), а не
  сам ключ. Сам ключ живёт только в `.env` — не коммить его.
</Warning>

## 2. Провайдер

Открой конфиг командой `hermes config edit` (файл `~/.hermes/config.yaml`) и добавь
ethereal в раздел `providers`:

```yaml theme={null}
model:
  default: claude-opus-4-8
  provider: ethereal

providers:
  ethereal:
    name: Ethereal
    api: https://api.ethereal.llc/v1
    key_env: ETHEREAL_API_KEY
    transport: openai_chat
```

Ключевые поля:

| Поле        | Значение                      | Зачем                                |
| ----------- | ----------------------------- | ------------------------------------ |
| `api`       | `https://api.ethereal.llc/v1` | OpenAI-совместимый эндпоинт ethereal |
| `key_env`   | `ETHEREAL_API_KEY`            | имя переменной из `.env` с ключом    |
| `transport` | `openai_chat`                 | формат запросов (chat completions)   |

## 3. Модель по умолчанию

`model.provider` указывает на провайдера, `model.default` — на id модели. То же
можно сделать без правки файла руками:

```bash theme={null}
hermes config set model.provider ethereal
hermes config set model.default claude-opus-4-8
```

Проверь, что всё подхватилось:

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

Запусти Hermes — он пойдёт через ethereal.

## 4. Выбор модели

<Tip>
  Для повседневной работы держи `claude-sonnet-4-6`, переключайся на
  `claude-opus-4-8` под сложные задачи и на `claude-haiku-4-5` — где нужна
  скорость/дешевизна.
</Tip>

### Открытые модели (дешевле)

Кроме Claude, ethereal отдаёт открытые модели (GLM, Qwen, Kimi) — заметно дешевле
(`12 / 60 ₽` за Mtok). Подставляются так же, по id:

```bash theme={null}
hermes config set model.default glm-5.2
```

Доступные id: `glm-5.2`, `glm-5.1`, `kimi-k2.7`, `qwen3.6`, `qwen3.7`. Полный
актуальный список — `GET https://api.ethereal.llc/v1/models`.

<Note>
  Списание идёт по [тарифу модели](/ru/pricing) за фактические токены сессии.
  Баланс и разбивку смотри в [кабинете](https://ethereal.llc/dashboard).
</Note>