Hermes Agent

Подключите Hermes Agent к Mixen — оплата с баланса в рублях, самоулучшающийся TUI-агент с любыми моделями из каталога через наш OpenAI-совместимый API.

Hermes Agent — опенсорсный агент (MIT) от Nous Research: терминальный TUI-интерфейс, встроенная система скиллов (около 80 из коробки), персистентная память между проектами и каналы уведомлений — Telegram, Discord и другие. Модель выбирается любой: официальный провайдер, OpenRouter или свой эндпоинт — Mixen подключается последним способом.

Установка

# Linux / macOS / WSL2 / Termux
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

# Windows (PowerShell)
iex (irm https://hermes-agent.nousresearch.com/install.ps1)

Установщик сам приносит зависимости: uv, Python 3.11, Node.js, ripgrep, ffmpeg и портативный Git Bash. После установки выполните source ~/.bashrc (или ~/.zshrc) и запустите hermes.

Конфигурация

Конфиг — ~/.hermes/config.yaml, секреты — ~/.hermes/.env. Раздел model определяет провайдера, модель и эндпоинт:

model:
  provider: openai
  default: openai/gpt-5.6-sol
  base_url: https://api.mixen.ai/v1
  api_mode: chat_completions

Ключ — в ~/.hermes/.env; переменная OPENAI_API_KEY документирована у Hermes именно для кастомных OpenAI-совместимых эндпоинтов:

OPENAI_API_KEY="ваш-api-ключ"   # mxn-… из кабинета Mixen

Ключевые моменты:

base_url указывает на https://api.mixen.ai/v1 — с суффиксом, как в OpenAI SDK; api_mode: chat_completions — протокол /v1/chat/completions.
default — ID модели Mixen, уходит в API как есть; любой из каталога.
provider: openai — имя встроенного провайдера, чей ключ читается из OPENAI_API_KEY.

Альтернатива — именованный провайдер с Anthropic-транспортом (полезно, если держите несколько эндпоинтов):

providers:
  mixen:
    api: https://api.mixen.ai        # без /v1 — путь дописывает транспорт
    api_key: "ваш-api-ключ"
    transport: anthropic_messages
    models:
      - anthropic/claude-sonnet-5
      - z-ai/glm-5.3-flash

model:
  provider: mixen
  default: anthropic/claude-sonnet-5

Смена модели

hermes model      # интерактивный пикер: провайдер + модель, пишет в config.yaml
hermes setup      # полный мастер первичной настройки

Внутри сессии — слэш-команда:

/model z-ai/glm-5.3-flash --provider openai             # до конца сессии
/model z-ai/glm-5.3-flash --provider openai --global    # и в config.yaml
/model anthropic/claude-sonnet-5 --once                 # один ход, затем откат

Выбор применяется к новым сессиям — уже открытые вкладки чата сохраняют прежнюю модель.

Проверка подключения

Ключ и баланс проверяются минимальным генерирующим запросом:

curl https://api.mixen.ai/v1/chat/completions \
  -H "Authorization: Bearer ваш-api-ключ" \
  -H "Content-Type: application/json" \
  -d '{"model":"z-ai/glm-5.3-flash","messages":[{"role":"user","content":"ping"}],"max_tokens":5}'

200 — ключ и баланс рабочие; 401 — ключ скопирован не целиком или это не API-ключ Mixen; 402 — на балансе нет средств. GET /v1/models ключ не проверяет — он отвечает и без него.

Выбор модели под задачу

Агент таскает с собой растущий контекст (память, скиллы, история), поэтому цена входа — главный множитель счёта. Цены — за 1M токенов, вход/выход; полные таблицы с кэш-колонками — в каталоге.

Задача	Модель	Вход / выход
Рутина: разбор файлов, простые вопросы, черновики	GLM 5.3 Flash (`z-ai/glm-5.3-flash`)	8,4 / 27,9 ₽
Длинные задачи в знакомом контексте	GLM 5.3 (`z-ai/glm-5.3`)	156 / 490,2 ₽
Сложные многошаговые задачи	GPT-5.6 Sol (`openai/gpt-5.6-sol`)	213,9 / 1069,5 ₽

Кэш и экономия сессий

Повторный контекст в течение 5 минут считается по ~10% цены входа (21.4 ₽ за 1M у gpt-5.6-sol вместо 213.9 ₽, 1.7 ₽ у glm-5.3-flash), и каждое попадание продлевает окно ещё на 5 минут — плотная сессия живёт в кэше от начала до конца.
Пауза дольше 5 минут обнуляет кэш: следующий ход заплатит полную цену входа, дальше скидка снова накапливается.
Персистентная память агента — это как раз тот стабильный префикс, который кэшируется лучше всего; не редактируйте правила и память посреди активной задачи.
Лимит — 60 RPM на ключ.

Типичные проблемы

401 / Invalid API Key — ключ неполный, не в ~/.hermes/.env, либо ему мешает устаревшая запись другого провайдера в том же файле (Hermes прямо предупреждает о конфликтах stale-значений в .env).
Настройки не применяются — смена модели действует на новые сессии: перезапустите текущую вкладку/сессию; быструю диагностику запускает hermes doctor.
Модель не находится — model.default должен быть ID из каталога Mixen (со слэшем: openai/gpt-5.6-sol), а model.provider — именем провайдера из конфига.