Skip to main content
Hermes Desktop — кросс-платформенное десктопное приложение Hermes Agent от Nous Research с графическим интерфейсом. Поддерживает несколько провайдеров моделей и подключается к Polza.ai через собственный Custom Endpoint — без правки конфигов вручную.
Это инструкция для десктопного приложения Hermes Agent. Терминальная версия — отдельная страница: Hermes Agent.

​
Требования

  • Установленное приложение Hermes Desktop (Windows, macOS или Linux)
  • Аккаунт на polza.ai и API-ключ

​
Подключение к Polza.ai

Все шаги выполняются в самом приложении.
1

Установите Hermes Desktop

Скачайте и установите десктопное приложение с официальной страницы:https://hermes-agent.nousresearch.com/После запуска откроется начальный экран — нажмите «Выберу провайдера позже», чтобы пропустить встроенный онбординг провайдера. Провайдера Polza.ai мы добавим вручную на следующем шаге.
Начальный экран Hermes Desktop с кнопкой Выберу провайдера позже
2

Откройте Настройки → Провайдеры → Свои эндпоинты

Перейдите в раздел Settings → вкладку Провайдеры → Свои эндпоинты и создайте новый endpoint с параметрами Polza.ai.
Форма Custom Endpoint в Hermes Desktop с заполненными полями для Polza.ai
Ключ хранится локально в настройках приложения. Не публикуйте скриншоты и дампы конфигурации с ключом.
3

Проверьте подключение и сохраните

Нажмите Test — приложение отправит запрос к Polza.ai и убедится, что API-ключ и модель валидны. После успешного теста нажмите Save, чтобы сохранить endpoint.
Окно успешного теста подключения в Hermes Desktop
4

Готово

После сохранения endpoint готов к использованию — выберите его в пикере моделей и начинайте чат.

​
Рекомендуемые модели

Polza.ai поддерживает сотни моделей; ниже подборка для типовых задач в Hermes Desktop. Полный — на polza.ai/models.

​
Переключение моделей

Hermes Desktop поддерживает работу со всеми чатовыми моделями из каталога Polza.ai. Переключать можно в настройках чата.
Переключение модели в настройках чата Hermes Desktop

​
Решение проблем

  • Скопируйте ключ заново из polza.ai/dashboard/api-keys — лишние пробелы и Unicode-символы ломают auth
  • Проверьте что на балансе есть положительный остаток
  • Убедитесь что BaseURL — ровно https://polza.ai/api/v1 (без trailing slash, без /chat/completions на конце)
  • Проверьте Default model — он должен существовать в каталоге Polza.ai в формате <vendor>/<model-id>
  • Опечатки в slug-е (например, claude-sonnet-4-6 через дефис вместо claude-sonnet-4.6 через точку) — самая частая причина
Убедитесь что вы в разделе Settings → вкладка Провайдеры (не Модели и не Аккаунт). Вкладка «Свои эндпоинты» находится внутри раздела «Провайдеры».
В некоторых сборках поле называется иначе (например, OpenAI Compatible или chat-completions). Выберите любой OpenAI-совместимый режим — Polza.ai работает со всеми.
  • Переключитесь на другой endpoint из пикера и обратно
  • Проверьте интернет-соединение до polza.ai
  • Посмотрите логи приложения (раздел Settings → Logs) — там будет HTTP-код ответа

​
Следующие шаги

Hermes Agent (CLI)

Терминальный вариант Hermes Agent — подключение через hermes setup или config.yaml

OpenClaw Desktop

Ещё одно десктоп-приложение с подключением к Polza.ai через мастер настройки