Чеклист установки Hermes Agent на Mac в 2026:
что подготовить перед выходными

Для быстрого теста достаточно официального Quickstart. Если нужен Hermes на Mac надолго — пройдите чеклист ниже до запуска установщика.

1Перед установкой: железо, система и резервная копия

2Зависимости: единственное обязательное — Git

Согласно руководству по установке, однострочный установщик автоматически ставит uv, Python 3.11, Node.js v22, ripgrep и ffmpeg — Homebrew Python или Node заранее не нужны. Проверьте Git:

• →Git: git --version должен выводить версию; Xcode CLT установите до старта, а не посреди установки.
• →Shell: по умолчанию zsh; после установки выполните source ~/.zshrc, чтобы обновить PATH.
• →Nix (опционально): пользователи Nix следуют руководству по Nix вместо curl-установщика — выберите один путь.

3Аккаунты и секреты

Установщик настроит LLM-провайдера; готовые ключи избавят от «полуустановки»:

• →Минимум один API-ключ от OpenRouter, Anthropic, OpenAI или другого поддерживаемого провайдера.
• →Храните секреты в ~/.hermes/.env и выполните chmod 600 ~/.hermes/.env.
• →Не коммитьте ключи в Git проекта; используйте allowlist вроде TELEGRAM_ALLOWED_USERS — избегайте GATEWAY_ALLOW_ALL_USERS=true.

4Безопасная рабочая область

Официальная схема на пользователя: код в ~/.hermes/hermes-agent/, данные в ~/.hermes/ (конфиг, логи, pairing, sandbox).

• →Отдельная подпапка как workspace агента — не отдавайте весь домашний каталог.
• →Логи: ~/.hermes/logs/ (Gateway пишет gateway.log).
• →Свой путь установки: задайте HERMES_INSTALL_DIR=... до запуска установщика (см. официальную документацию).

5Установка и первый запуск

Установка (минимально рабочая):

Затем source ~/.zshrc → hermes или hermes setup → hermes model.

Проверка при первом запуске:

• ✓which hermes → ~/.local/bin/hermes
• ✓hermes doctor без блокеров (нет API-ключа — подскажет hermes model)
• ✓Отправьте реальный запрос и убедитесь в ответе модели и вызовах инструментов
• ✓При включении файловых или терминальных инструментов выдайте полный доступ к диску и другие права в системных настройках

6Держать в работе: persist через launchd

hermes в окне Terminal живёт только в этой сессии; messaging gateway нужен как демон:

• 1После стабильной CLI: hermes gateway setup (Telegram, Discord, Slack и т.д. по актуальному списку поддержки)
• 2hermes gateway install → plist в ~/Library/LaunchAgents/ai.hermes.gateway.plist
• 3hermes gateway start → hermes gateway status
• 4Логи: tail -f ~/.hermes/logs/gateway.log
• 5После новых инструментов Homebrew или nvm снова выполните hermes gateway install, чтобы обновить PATH в plist

7Восстановление: что проверять при сбое установки

8Наблюдение в течение 24 часов

• ①Перезагрузите Mac → hermes gateway status по-прежнему показывает running
• ②Отключите сеть на 5 минут, восстановите — gateway поднимается сам или нужен ручной старт?
• ③Выборочно проверьте ~/.hermes/logs/ на стеки ошибок
• ④Следите за биллингом LLM, чтобы циклы инструментов не раздули расходы
• ⑤Намеренно вызовите одну рискованную команду и убедитесь, что подтверждение всё ещё работает

9Mac mini лучше подходит для агентов 24/7

Шлюзы Hermes, мосты BlueBubbles и локальные toolchain предполагают стабильный хост macOS. Mac mini M4 сочетает unified memory Apple Silicon с потреблением около 4 Вт в простое — тихий домашний или командный узел агента: нативный Unix, Homebrew, Docker и launchd без WSL; Gatekeeper и FileVault снижают долгосрочные риски; частота сбоев ниже, чем у многих Windows-ПК той же цены — это важно для незаметных gateway.

Если из этого чеклиста вы делаете хост «установил в субботу — в понедельник онлайн», Mac mini M4 — сильная отправная точка по цене и возможностям. Оформите заказ сейчас и запускайте Hermes на железе, рассчитанном на круглосуточную работу.