Hermes Agent Desktop: как установить на Windows, macOS и Linux

Hermes Agent Desktop: как установить на Windows, macOS и Linux

Hermes Agent Desktop — AI-агент от Nous Research с GUI и CLI. Устанавливается за две минуты: скачал installer, настроил API-ключ, запустил. Работает с GPT-4, Claude, YandexGPT, локальными моделями через Ollama. Можно вывести в Telegram.

Что такое Hermes Agent Desktop

Hermes Agent Desktop — AI-агент с Electron GUI + CLI в одном пакете. Desktop даёт графический интерфейс (окошко, system tray), CLI-only — только терминал. Движок один. Можно работать в интерфейсе, в терминале или подключить Telegram.

Системные требования

  • ОС: Windows 10+, macOS 12+ (M1/M2/Intel), Ubuntu 20.04+, Fedora, Arch
  • Python: 3.9–3.13 (installer поставит, если нет)
  • RAM: 8 ГБ минимум, рекомендуется 16 ГБ
  • Node.js: 16+ (нужен только для Desktop GUI)
  • Интернет: для зависимостей и облачных моделей

Установка на Windows

Desktop installer

  • Скачайте .exe с hermes-agent.nousresearch.com
  • Запустите, следуйте wizard'у (Next → Install)
  • После установки откройте PowerShell: hermes --version

Если hermes not found — перезапустите терминал (PATH обновится).

Установка на macOS

Desktop DMG

  • Скачайте DMG с hermes-agent.nousresearch.com
  • Перетащите Hermes Agent в Applications
  • Первый запуск: правой кнопкой → Open (обход Gatekeeper)
  • Проверьте в терминале: hermes --version
macOS установка Hermes Agent Desktop
После установки DMG проверьте CLI в Terminal

Установка на Linux

Linux — только CLI (нет Desktop installer).

Первый запуск и проверка

После установки проверьте работу командой hermes doctor. Она проверит Python, зависимости, конфиг, подключения к провайдерам. Если всё ОК — увидите зелёные галочки.

Настройка провайдеров (API-ключи)

Hermes работает с разными LLM. Нужно настроить хотя бы один провайдер.

OpenRouter (универсальный)

OpenRouter даёт доступ к GPT-4, Claude, Gemini через один API. Получите ключ на openrouter.ai/keys, затем настройте через hermes config.

YandexGPT (для РФ)

Доступ из РФ без VPN. Получите API-ключ в Yandex Cloud и настройте через конфиг.

Ollama (локальные модели)

Бесплатно, без API-ключей. Установите Ollama, скачайте модель. Hermes автоматически найдёт Ollama на localhost:11434.

Подключение Telegram Gateway

Можно общаться с Hermes из Telegram. Gateway — фоновый процесс, который подключает агента к мессенджерам.

Создайте бота

В Telegram найдите @BotFather, отправьте /newbot, следуйте инструкции. Скопируйте токен.

Telegram Gateway Hermes Agent
Hermes Agent работает через Telegram — общайтесь из телефона

Типичные ошибки

hermes: command not found

PATH не обновился. Перезапустите терминал или выполните source ~/.bashrc (Linux), source ~/.zshrc (macOS). На Windows перезапустите PowerShell.

API key not set

Не настроен провайдер. Запустите hermes model или hermes config set OPENROUTER_API_KEY your_key.