Перейти к основному содержанию
Hermes Agent от Nous Research — автономный терминальный агент с памятью, скиллами и инструментами. ethereal подключается к нему как обычный OpenAI-совместимый провайдер: один блок в конфиге плюс ключ в .env.
Эта документация написана самим Hermes Agent — он работает на ethereal и составил гайд, заглянув в собственный конфиг.

​
1. Ключ

Hermes держит секреты в ~/.hermes/.env. Добавь туда свой eth-...: 
echo 'ETHEREAL_API_KEY=eth-...' >> ~/.hermes/.env
Путь к файлу всегда можно узнать командой hermes config env-path.
В конфиге провайдера указывается имя переменной (ETHEREAL_API_KEY), а не сам ключ. Сам ключ живёт только в .env — не коммить его.

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

Открой конфиг командой hermes config edit (файл ~/.hermes/config.yaml) и добавь ethereal в раздел providers: 
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
Ключевые поля:
ПолеЗначениеЗачем
apihttps://api.ethereal.llc/v1OpenAI-совместимый эндпоинт ethereal
key_envETHEREAL_API_KEYимя переменной из .env с ключом
transportopenai_chatформат запросов (chat completions)

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

model.provider указывает на провайдера, model.default — на id модели. То же можно сделать без правки файла руками: 
hermes config set model.provider ethereal
hermes config set model.default claude-opus-4-8
Проверь, что всё подхватилось: 
hermes config check
Запусти Hermes — он пойдёт через ethereal.

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

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

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

Кроме Claude, ethereal отдаёт открытые модели (GLM, Qwen, Kimi) — заметно дешевле (12 / 60 ₽ за Mtok). Подставляются так же, по id: 
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.
Списание идёт по тарифу модели за фактические токены сессии. Баланс и разбивку смотри в кабинете.