Установка Hermes Agent на macOS занимает от двух до десяти минут: новичкам достаточно скачать приложение Hermes Desktop для Mac, а тем, кто хочет полный контроль, — выполнить одну команду в терминале. В этом руководстве — пошаговая установка на Apple Silicon (M1–M4) и Intel Mac, настройка модели через Nous Portal или собственный API-ключ, проверка через hermes doctor и решение типичных проблем macOS: Gatekeeper, Homebrew и автозапуск фонового gateway.
Что такое Hermes Agent
Hermes Agent — это открытый ИИ-агент от лаборатории Nous Research, который устанавливается на ваш компьютер, подключается к мессенджерам (Telegram, Discord, Slack и другим), выполняет задачи по расписанию и сохраняет память между сессиями. В отличие от чат-бота, который отвечает и забывает, Hermes работает как фоновый процесс: он сам запускает команды в терминале, читает и создаёт файлы, открывает браузер и может написать вам в Telegram, пока вы спите.
Проект вышел в феврале 2026 года и к августу 2026-го набрал 226 766 звёзд на GitHub (данные Hermes Atlas на 7 августа 2026). По данным обзора на vc.ru, уже через семь недель после релиза у проекта было 95 000 звёзд, ещё через месяц — 140 000.
У Hermes две точки входа на Mac:
hermes в Терминале и даёт полный функционал агента без графической оболочки.Оба варианта используют один и тот же агент: Desktop просто устанавливает CLI внутри себя. Поэтому способ установки — вопрос удобства, а не возможностей.
Что понадобится для установки на Mac
Минимальные требования по состоянию на август 2026 года (Hermes Agent v0.20.0):
git --version; если Git не установлен, поставьте его через brew install git.hermes model.Устанавливать Python, Node.js, ripgrep или ffmpeg вручную не нужно — установщик Hermes ставит их автоматически:
| Компонент | Кто устанавливает | Зачем нужен |
|---|---|---|
| uv | установщик Hermes | быстрый менеджер Python-пакетов |
| Python 3.11 | установщик Hermes | рантайм агента |
| Node.js v22 | установщик Hermes | браузерная автоматизация и WhatsApp-мост |
| ripgrep | установщик Hermes | быстрый поиск по файлам |
| ffmpeg | установщик Hermes | конвертация аудио для озвучки (TTS) |
Способ 1. Установка через Hermes Desktop — для новичков
Hermes Desktop — это нативное приложение (Electron), которое устанавливает и сам агент, и командную строку автоматически. Официальная документация рекомендует именно этот способ для macOS и Windows.
Шаг 1. Скачайте установщик. Откройте сайт hermes-agent.nousresearch.com и скачайте дистрибутив .dmg для macOS (для Windows рядом лежит .exe).
Шаг 2. Установите приложение. Откройте скачанный .dmg и перетащите иконку Hermes в папку Applications.
Шаг 3. Обойдите Gatekeeper. При первом запуске macOS может показать предупреждение о неизвестном разработчике. Это нормально для новых приложений: откройте Системные настройки → Конфиденциальность и безопасность и разрешите запуск. Приложение подписано сертификатом разработчика, поэтому после подтверждения запуск происходит без проблем.
Шаг 4. Пройдите мастер настройки. При первом запуске приложение предложит подключить провайдера моделей. Самый простой путь — нажать «Connect Nous Portal» и авторизоваться через браузер: одна авторизация закрывает и доступ к моделям, и все инструменты Tool Gateway (веб-поиск, генерация изображений, озвучка).
Шаг 5. Начните работу. После настройки откроется основной интерфейс: окно чата слева, панель с памятью и навыками справа. Агент готов к работе.
Важно: Desktop-версия не ограничивает функционал. Все возможности агента — инструменты, память, cron-задачи — доступны и в CLI, и в Desktop, просто интерфейсы разные.
Способ 2. Установка через терминал (CLI)
Этот способ подходит тем, кто привык к командной строке или планирует использовать Hermes на сервере, где графического интерфейса нет.
Шаг 1. Откройте Терминал. Подойдёт любой эмулятор терминала: встроенный Terminal.app, iTerm или Warp.
Шаг 2. Выполните команду установки:
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
Установка занимает 2–3 минуты. Скрипт сам определяет архитектуру процессора: на Apple Silicon он автоматически ставит нативные бинарники под arm64, эмуляция Rosetta не требуется.
Шаг 3. Перезагрузите оболочку, чтобы команда hermes попала в PATH:
source ~/.zshrc
На Mac по умолчанию используется zsh (начиная с macOS Catalina). Если вы переключились на bash — выполните source ~/.bashrc.
Шаг 4. Проверьте установку:
hermes version
Если команда вернула версию — установка прошла успешно.
Что именно делает установщик
Официальный установщик берёт на себя всю рутину:
~/.hermes/hermes-agent/;hermes (симлинк в ~/.local/bin/hermes);~/.hermes/, где хранятся память, навыки, сессии и конфигурация;Если у вас уже установлен Homebrew, установщик использует его для зависимостей. Если Homebrew нет — установщик поставит его сам и подробно напишет, что делает.
Настройка модели: первый запуск
После установки запустите hermes без аргументов — откроется интерактивный мастер настройки. Он предложит четыре пути:
hermes setup --portal.sk-ant-), OpenAI (sk-), z.AI, MiniMax или DeepSeek.hermes model.Сменить провайдера или модель в любой момент можно командами:
hermes model # выбор провайдера и модели
hermes config set OPENROUTER_API_KEY ваш_ключ
hermes config set model.api_key ваш_ключ
Частая ошибка при вставке ключа — случайный пробел в конце. Если ключ не принимается, вставьте его через hermes config set model.api_key (команда прочитает значение из stdin, так что лишние символы не попадут).
Проверка установки: hermes doctor и первый тест
После настройки модели выполните три команды — все должны отработать без ошибок:
hermes version # версия агента
hermes doctor # проверка здоровья системы — каждая строка должна быть зелёной
hermes status # текущая конфигурация и запущенные процессы
Затем проведите живой тест, который проверит и модель, и инструменты:
hermes chat -q "Hello! What tools do you have available?"
В ответ вы должны получить приветствие и список включённых инструментов. Если команда зависает — значит, модель недоступна: проверьте ключ и баланс на стороне провайдера.
Если после установки что-то сломалось, hermes doctor подскажет, чего именно не хватает и как это исправить.
macOS-специфика: что важно знать владельцам Mac
Apple Silicon vs Intel
arm64 и ставит нативные бинарники, без Rosetta. Локальные модели через Ollama работают быстро.Homebrew на Apple Silicon: путь /opt/homebrew/bin
На Apple Silicon Homebrew устанавливается в /opt/homebrew, а не в /usr/local (как на Intel). Если установщик Hermes не находит зависимости, проверьте, что в ~/.zshrc добавлена строка:
eval "$(/opt/homebrew/bin/brew shellenv)"
После добавления перезапустите терминал и повторите установку.
Gatekeeper и «неизвестный разработчик»
macOS по умолчанию блокирует приложения, скачанные не из App Store. При первом запуске Hermes Desktop появится предупреждение. Решение: Системные настройки → Конфиденциальность и безопасность → раздел «Безопасность» → кнопка «Открыть всё равно». Это разовая процедура.
Локальные модели через Ollama
Hermes умеет работать полностью локально: установите Ollama, скачайте модель и укажите её в hermes model. Официальные тесты показывают стабильную работу даже с моделями класса 30B на чистом CPU. Для фоновых задач по расписанию такая связка работает нормально, но сложные многошаговые цепочки инструментов локальные модели выполняют слабее облачных.
Фоновая работа: gateway и автозапуск на macOS
Одно из главных отличий Hermes от чат-бота — возможность работать в фоне и отвечать в мессенджерах. За это отвечает messaging gateway — процесс, который подключает агента к Telegram, Discord, Slack и другим платформам.
Настройка:
hermes gateway setup
На macOS gateway оформляется как LaunchAgent (launchd-сервис): он автоматически запускается при входе в систему и перезапускается после сбоев.
Известный нюанс: на macOS перезапуск gateway командой hermes gateway restart иногда завершается неудачно из-за гонки launchd (KeepAlive перезапускает процесс раньше, чем команда успевает его поднять). Рабочий обходной путь из issue-трекера NousResearch:
hermes gateway stop && sleep 5 && hermes gateway start
Пауза в 5 секунд даёт launchd время полностью выгрузить задачу перед повторным запуском.
Также учтите: если агент запущен по расписанию (cron) или внутри gateway, его окружение отличается от интерактивного терминала — PATH и переменные окружения могут не совпадать. Если команда работает в терминале, но падает из gateway, проверяйте окружение именно того процесса.
Частые проблемы и их решение
| Проблема | Решение |
|---|---|
| `hermes: command not found` | Перезагрузите оболочку: `source ~/.zshrc`, или откройте новое окно терминала |
| `API key not set` | `hermes model` — выбрать провайдера, или `hermes config set OPENROUTER_API_KEY ваш_ключ` |
| `invalid API key` | Проверьте лишние пробелы при вставке; вставляйте ключ через `hermes config set model.api_key` |
| Homebrew не найден (Apple Silicon) | Добавьте `eval «$(/opt/homebrew/bin/brew shellenv)»` в `~/.zshrc` и перезапустите терминал |
| `Permission denied` при установке | Не запускайте установщик через `sudo` — Hermes ставится в `~/.hermes/` без прав root |
| `uv: command not found` в середине установки | Просто повторите команду установки — скрипт идемпотентен и продолжит с места остановки |
| Ошибки npm (ENOENT, EACCES) | Удалите `~/.hermes/`, поставьте Node через `brew install node`, повторите установку |
| Пропала конфигурация после обновления | `hermes config check`, затем `hermes config migrate` |
Если ничего не помогает — запустите hermes doctor: он покажет, что именно не так, и как это исправить.
Что делать после установки
Установка — это только начало. Дальше стоит:
hermes gateway setup настраивает Telegram, Discord, Slack и другие платформы. Подробно о подключении Telegram-бота мы разобрали в отдельной статье.hermes skills install .~/.hermes/memories/.hermes update --check, обновление: hermes update. Установщик сам определяет способ установки и подбирает правильную команду обновления.Если вы планируете держать Hermes на отдельном сервере, а не на Mac, — у нас есть отдельная инструкция по установке на VPS.
FAQ
Можно ли установить Hermes Agent на Mac с Intel?
Да. Установка идентична: та же команда curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash. Единственное ограничение — локальные модели через Ollama работают на Intel заметно медленнее, поэтому для реальной работы лучше использовать облачные API.
Работает ли Hermes Agent на Apple Silicon (M1, M2, M3, M4)?
Да, Apple Silicon — приоритетная платформа. Установщик определяет архитектуру arm64 и ставит нативные бинарники без Rosetta. Локальный инференс через Ollama на чипах M-серии работает быстро.
Нужен ли Homebrew для установки Hermes?
Нет. Единственное обязательное требование — Git. Если Homebrew уже установлен, установщик использует его для зависимостей; если нет — поставит его сам.
Нужен ли Docker для установки Hermes Agent на Mac?
Нет. Официальный установщик — это нативная установка без контейнеров. Docker не требуется; контейнерный вариант существует, но это отдельный путь для тех, кому он действительно нужен.
Сколько места занимает Hermes Agent?
Около 200 МБ на свежую установку. Память, навыки и логи со временем занимают ещё 100–500 МБ в каталоге ~/.hermes/.
Можно ли работать с Hermes полностью офлайн?
Да. Установите Hermes, подключите Ollama или LM Studio и отключите сеть: память, навыки, cron и файловые инструменты работают без интернета. Ограничение — локальные модели слабее в сложных многошаговых задачах.