Руководство

Установка Hermes Agent на Mac mini

Hermes Agent ставится на Mac с Apple silicon одним скриптом. Скрипт сам настраивает свой Python и инструменты. Затем две команды выбирают модель и превращают gateway для мессенджеров в сервис launchd. Здесь официальные шаги, вывод нашей тестовой установки и способ держать его включённым круглосуточно.

Что такое Hermes Agent

Hermes Agent это агент с открытым исходным кодом от Nous Research под лицензией MIT. Он помнит прошлые сессии и сам пишет себе навыки, изучая вашу работу. Gateway подключает его к Telegram, Discord, WhatsApp и другим мессенджерам (github.com/NousResearch/hermes-agent, октябрь 2026 года).

Им можно пользоваться как чатом в терминале, как другими агентами для программирования. А можно оставить gateway запущенным и писать ему с телефона. Именно ради второго варианта его хотят держать на всегда включённом Mac.

Требования

  • Apple silicon. В документации по установке сказано, что установщик для macOS работает только на Apple silicon, а Mac на Intel не поддерживаются (октябрь 2026 года).
  • Python от 3.11 до 3.14, git и curl. Установщик ставит собственные Python, Node, ffmpeg и ripgrep, так что чистый Mac подойдёт.
  • Модель. Hermes работает с Anthropic, OpenAI, OpenRouter, Nous Portal и многими другими. В документации по провайдерам перечислены API-ключи, вход через браузер и некоторые подписки. Он также принимает любой локальный endpoint, совместимый с OpenAI, например Ollama.

Установка

Это документированная команда для macOS. После неё перезагрузите оболочку.

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
source ~/.zshrc

Для скрипта или удалённой оболочки у установщика есть флаги, которые пропускают вопросы и необязательные инструменты для браузера и computer use. Мы использовали их в тесте.

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash -s -- --non-interactive --skip-browser --skip-computer-use

Мы запускали его дважды на машинах macOS 26 от GitHub 2 октября 2026 года. Один раз он занял около 2 минут, другой раз 6.5 минуты, в основном на загрузки. Проверка версии вывела вот что.

$ hermes --version
Hermes Agent v0.21.5+5635.g5bba024 (2026.9.24) · upstream 5bba024d

Полезно знать, что куда попало. Установщик клонировал код в папку hermes в домашней папке. Свои копии Python 3.14.7, Node, ffmpeg и ripgrep он положил в папку tools внутри неё. Команда hermes попала в локальную папку bin в домашней папке. Ещё он добавил 58 встроенных навыков, в том числе для Apple Notes, Reminders и iMessage. Это одна из причин запускать Hermes на Mac, а не на Linux-машине.

Теперь выберите модель и запустите мастер настройки.

hermes model
hermes setup
hermes doctor

Переходите с OpenClaw? В README есть команда, которая импортирует ваши настройки OpenClaw.

hermes claw migrate

Gateway, который работает 24/7

Сначала подключите мессенджеры. Затем установите gateway как сервис. В macOS это агент launchd.

hermes gateway setup
hermes gateway install
hermes gateway start
hermes gateway status
tail -f ~/.hermes/logs/gateway.log

Мы запустили команду установки на тестовой машине, где мессенджеры ещё не были настроены. Её пользователь называется runner. Проверка статуса подтвердила, что launchd запустил gateway.

$ hermes gateway install
Installing launchd service to: /Users/runner/Library/LaunchAgents/ai.hermes.gateway.plist
✓ Service installed and loaded!
$ hermes gateway status
✓ Service definition matches the current Hermes install
✓ Gateway is supervised by launchd (PID 14390)
  Auto-start at login and auto-restart on crash are available.

Файл сервиса настроен на запуск при загрузке, поэтому он поднимается при каждом входе в систему. Ещё он перезапускает gateway, если тот завершился с ошибкой. Одна тонкость из документации по мессенджерам. Если позже вы установите новые инструменты, запустите команду установки ещё раз, чтобы сервис увидел новый PATH.

Как и любому LaunchAgent, ему нужен пользователь, вошедший в систему. Включите автоматический вход, затем отключите сон.

sudo pmset -a sleep 0
sudo pmset -a disksleep 0
sudo pmset -a displaysleep 10

Чтобы сессия в терминале переживала обрыв соединения, запускайте интерактивного агента внутри tmux. Шаги описаны в нашем руководстве по tmux. Для Hermes они работают так же.

Безопасность

  • Gateway отклоняет всех, пока вы их не разрешите. Задайте allowlist из ID пользователей или одобряйте людей по одному через коды привязки. Коды истекают через час.
  • У одобрений три режима: manual, smart и off. Off равнозначен флагу yolo. Держите manual, пока не доверяете своей настройке.
  • Храните API-ключи в файле env в папке hermes с доступом на чтение только для вас. Никогда не коммитьте его.
  • Для большей изоляции в документации по безопасности показано, как запускать команды в контейнере Docker, а не на самом Mac.
# in ~/.hermes/.env
TELEGRAM_ALLOWED_USERS=123456789

# or approve one person by pairing code
hermes pairing approve telegram XKGH5N7P
chmod 600 ~/.hermes/.env

По документации, часть защит действует даже в режиме yolo. Жёсткий блоклист останавливает команды вроде рекурсивного удаления всего диска. Его файловые инструменты отказываются писать в папки ssh и aws.

Запуск на Mac от MacRun

Наш тариф «Агент» даёт выделенный Mac mini с отключённым сном. После перезагрузки его сессия входа восстанавливается сама. Claude Code и Codex предустановлены. Hermes нет. Вы ставите его скриптом выше, пользуясь правами администратора. Если Hermes работает с облачной моделью, базового M6 с 16 GB более чем хватает.

Кому не стоит арендовать для этого Mac. Hermes работает и на Linux. Если вам не нужны Xcode, Apple Notes или iMessage, Linux-сервер дешевле. И MacRun предназначен для работы разработчика. Используйте его для кода, сборок и рутины в репозиториях, а не как личного ассистента для жизни.

Что входит в тариф «Агент», смотрите на странице Mac для агентов.

Частые вопросы

Работает ли Hermes Agent на Mac с Intel?

+

Нет. В документации Hermes Agent по установке сказано, что установщик для macOS поддерживает только Apple silicon, по состоянию на октябрь 2026 года.

Как запустить Hermes Agent в фоне на macOS?

+

Выполните hermes gateway install. Команда создаёт агент launchd, который запускается при входе в систему. Для управления используйте hermes gateway start, stop и status.

Может ли Hermes Agent работать с локальной моделью?

+

Да. В документации по провайдерам сказано, что он работает с любым endpoint, совместимым с OpenAI, включая Ollama и LM Studio. Выберите его командой hermes model.

Где Hermes Agent хранит API-ключи?

+

В файле env внутри папки hermes в домашней папке. Документация по безопасности советует выставить на него chmod 600 и никогда его не коммитить.

Похожие руководства