Установить Hermes Agent можно пятью официальными способами: скриптом для Linux, macOS и WSL2, установщиком для Windows, приложением Hermes Desktop, официальным Docker-образом и пакетом для Android через Termux. Выбор зависит от одного вопроса — где агент должен работать: на вашем компьютере, на сервере круглосуточно или в контейнере. Ниже — сравнение всех способов, что понадобится перед началом, как выбрать под свой сценарий и что сделать сразу после установки.
Что такое установка Hermes Agent
Установка Hermes Agent — это разворачивание агента (CLI, десктопного приложения или контейнера) и создание отдельного каталога данных, где хранятся конфигурация, ключи доступа, память, скиллы и история сессий. Главное, что нужно понять до выбора способа: код агента и его данные лежат в разных местах. Код можно переустановить или обновить без потерь, а вот каталог данных (~/.hermes/ в обычной установке) — это и есть ваш агент со всей его памятью, и он должен переживать обновления.
Hermes Agent распространяется по лицензии MIT: сам агент бесплатен, платить нужно только за доступ к языковой модели и за сервер, если агент работает круглосуточно. Единственный официальный источник кода — репозиторий NousResearch/hermes-agent на GitHub; сайт проекта — hermes-agent.nousresearch.com.
Какие способы установки официально поддерживаются
Проект делит платформы на три уровня поддержки. Это удобная отправная точка: если ваша система в первом уровне, установка и обновления не должны ломаться.
| Платформа | Способы установки | Уровень |
|---|---|---|
| macOS на Apple Silicon | Hermes Desktop, скрипт install.sh | Tier 1 |
| Windows 10 и 11 (x86_64, aarch64) | install.ps1, MSIX-приложение | Tier 1 |
| Linux и WSL2 (x86_64, aarch64) | install.sh | Tier 1 |
| Docker-контейнер (x86_64, aarch64) | docker pull официального образа | Tier 1 |
| Nix (macOS, Linux, NixOS) | Nix flake и модули | Tier 2 |
| Android / Termux (только aarch64) | подписанный APT-репозиторий | Tier 2 |
Tier 1 — то, что обещают не ломать: регрессии здесь исправляют в первую очередь. Tier 2 означает поддержку «по возможности»: выпуски могут её сломать.
Официально не поддерживаются и могут перестать работать в любой момент: установка через pip и PyPI (pip install hermes-agent, uv tool install hermes-agent), через Homebrew, пакеты из AUR, Termux на не-arm64 устройствах и 32-битный macOS на Intel. Если вы уже поставили агента одним из этих способов, документация советует перейти на поддерживаемый канал — иначе обновления однажды просто перестанут применяться.
Что понадобится перед установкой
Требований меньше, чем ожидаешь. Установщик для Linux и macOS просит только базовый набор системных утилит: Git, curl, tar и утилиты для проверки SHA-256. Всё остальное — Python, Node.js, npm, ripgrep и ffmpeg — он ставит сам, в том числе без прав root.
| Компонент | Кто ставит |
|---|---|
| Git, curl, tar, sha256 | вы, до установки |
| Python (актуальные установки идут на 3.14) | установщик |
| Node.js, npm, ripgrep, ffmpeg | установщик |
| Инструменты браузера и Chromium | установщик (можно отключить флагом) |
Ещё два практических момента. Первый: если вы собираете десктопное приложение из исходников, нужен компилятор — например, пакет build-essential в Debian и Ubuntu; для готовых установочных пакетов это не требуется. Второй: требования к железу определяет не сам Hermes, а модель, которой он пользуется. При работе через API агент почти не нагружает машину, а при локальной модели через Ollama или vLLM память и GPU считаются по размеру модели.
Как выбрать способ: таблица решений
| Ваш сценарий | Способ | Почему |
|---|---|---|
| Mac или Windows, хочу просто попробовать | Hermes Desktop | Графический интерфейс, никакого терминала |
| Linux-сервер, агент должен жить 24/7 | install.sh и служба gateway | Постоянная работа и доступ из мессенджеров |
| Хочу иметь агента под рукой на своём компьютере | install.sh | Полный доступ к терминалу и файлам |
| Нужна изоляция или несколько агентов на одной машине | Docker | Данные в томе, образ обновляется отдельно |
| Windows, но нужен POSIX-терминал | WSL2 и install.sh | Полноценный Linux внутри Windows |
| Только телефон | Android/Termux | Единственный мобильный вариант, aarch64 |
Цитируемый факт: в Docker-установках команда hermes update не работает — обновление делается загрузкой нового образа и пересозданием контейнера с тем же томом данных.
Способ 1: скрипт для Linux, macOS и WSL2
Самый короткий путь — одна команда:
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
Потом нужно перезагрузить оболочку и запустить агента:
source ~/.bashrc # или source ~/.zshrc
hermes
У скрипта есть полезные флаги. --skip-browser не ставит инструменты браузера и Chromium — это заметно экономит время и место на слабом сервере или в headless-окружении. --skip-computer-use пропускает драйвер компьютерного управления. Hermes запоминает выбор: последующие обновления не добавят эти компоненты обратно, поставить их позже можно через hermes pm install.
Если агент должен работать не от вашей учётной записи, а от отдельного сервисного пользователя, установщик запускают именно под ним, а чтобы служба пережила выход из системы, администратор включает «долгоживущие» сессии командой sudo loginctl enable-linger ИМЯ_ПОЛЬЗОВАТЕЛЯ.
Подробный разбор установки на сервер — в статье «Как установить Hermes Agent на VPS: пошаговая инструкция».
Способ 2: Hermes Desktop для macOS и Windows
Hermes Desktop — это тот же агент в виде обычного приложения: чат, память, скиллы, логи и настройки в одном окне, без терминала. Установочные пакеты лежат на официальном сайте.
Важное ограничение: установщик для macOS собран только под Apple Silicon. На Intel-Mac файл сообщит «not supported on this Mac» — там остаётся CLI-установка и команда hermes desktop. На Windows штатный MSIX-пакет требует Windows 11 версии 22H2 или новее.
Что важно понимать: Desktop не отдельный продукт, а оболочка. Он использует тот же агент и те же данные, поэтому способ установки — вопрос удобства, а не возможностей. Пошаговая инструкция для Mac — в статье «Hermes Agent на macOS: пошаговая установка и настройка».
Способ 3: Windows — нативно или через WSL2
Hermes работает и напрямую в Windows, и внутри WSL2. Выбор определяется задачей, а не удобством установки.
| Что нужно | Native Windows | WSL2 |
|---|---|---|
| Чат, gateway, cron, браузер | работает | работает |
| Встроенный терминал в дашборде | нет | да, нужен POSIX-терминал |
| Работа с POSIX-путями и скриптами | через Git Bash | полноценный Linux |
Нативная установка запускается в PowerShell:
iex (irm https://hermes-agent.nousresearch.com/install.ps1)
Для WSL2 нужен именно второй уровень: wsl --install, затем проверка wsl --list --verbose — в строке должно быть VERSION 2. На WSL1 агент работает нестабильно, потому что там Linux-системные вызовы транслируются на лету. Внутри дистрибутива стоит включить systemd — иначе служба gateway не переживёт выключение WSL. После этого установка внутри WSL ничем не отличается от обычного Linux: тот же install.sh.
Способ 4: Docker
Официальный образ — nousresearch/hermes-agent. Его удобно использовать, когда агент должен всегда быть онлайн или когда вы хотите держать несколько независимых агентов на одной машине.
Первый запуск — интерактивная настройка (мастер запишет ключи в каталог данных):
mkdir -p ~/.hermes
docker run -it --rm \
-v ~/.hermes:/opt/data \
nousresearch/hermes-agent setup
Дальше контейнер запускают как постоянную службу:
docker run -d \
--name hermes \
--restart unless-stopped \
-v ~/.hermes:/opt/data \
-p 8642:8642 \
nousresearch/hermes-agent gateway run
Три вещи, которые стоит знать заранее:
/opt/data, смонтированном с хоста. Сам образ без состояния, поэтому обновление — это замена образа, а не миграция.docker compose pull и пересоздание контейнера: hermes update в Docker-установке не поддерживается.Не путайте два разных сценария. «Hermes в Docker» — это агент внутри контейнера вместе с данными. «Docker как терминальный бэкенд» — это когда агент работает на вашем хосте, а команды терминала выполняет в изолированном контейнере. Первое — про круглосуточную работу, второе — про безопасность и песочницу.
Способ 5: Android через Termux
Это Tier 2 — поддержка по возможности. Пакет ставится из подписанного APT-репозитория и работает только на устройствах aarch64:
pkg update
pkg install hermes-agent
Перед добавлением репозитория документация требует сверить отпечаток ключа подписи: C572 B5FD D1A2 9CCF A9A9 12B6 840B 0848 E139 156D. Если отпечаток другой — установку нужно прекратить. Обычный десктопный скрипт install.sh на Android использовать нельзя, а gateway придётся держать в сессии Termux: Android умеет останавливать фоновые процессы.
Где окажутся файлы после установки
| Способ установки | Код | Команда | Данные |
|---|---|---|---|
| Обычный пользователь | `~/.hermes/hermes-agent/` | `~/.local/bin/hermes` | `~/.hermes/` |
| Установка от root | `/usr/local/lib/hermes-agent/` | `/usr/local/bin/hermes` | `/root/.hermes/` или `HERMES_HOME` |
| Docker | внутри образа | внутри образа | том, смонтированный в `/opt/data` |
| Termux | `$PREFIX/lib/hermes-agent/` | ссылки в `$PREFIX/bin/` | `~/.hermes/` |
Практический вывод из этой таблицы один: переносить агента на другую машину нужно вместе с каталогом данных — именно там память, скиллы и ключи. Для этого есть штатные команды hermes backup и hermes profile export; профильный экспорт по умолчанию исключает доступы и потому не заменяет полную резервную копию.
Что сделать сразу после установки
source ~/.bashrc) и проверьте, что команда видна: hermes --version.hermes setup — полный мастер, hermes setup --portal — быстрый вход через подписку Nous Portal, hermes model — только выбор модели. Подойдёт любой OpenAI-совместимый провайдер, включая локальный сервер.hermes doctor показывает, что не хватает, и как это починить. Заодно он сообщает, каким способом агент установлен.hermes chat -q "reply ok". Если ответ пришёл — базовая связка «агент плюс модель» работает, и можно добавлять мессенджеры, cron и интеграции.hermes tools, а мессенджеры — через hermes gateway setup.Частые ошибки при установке
| Проблема | Причина и решение |
|---|---|
| hermes: command not found | Не перезагружена оболочка: `source ~/.bashrc` или проверьте PATH |
| API key not set | Не настроен провайдер: `hermes model` или `hermes config set` |
| Настройки пропали после обновления | `hermes config check`, затем `hermes config migrate` |
| Дашборд недоступен | Порт не опубликован или не задан `HERMES_DASHBOARD=1` |
| Служба умирает после перезагрузки | Не включён systemd (в WSL2) или служба не установлена |
Отдельно про безопасность: дашборд на не-localhost адресе требует настроенной аутентификации. После инцидента июня 2026 года, когда открытые дашборды использовали как точку входа, Hermes запрещает неаутентифицированный доступ к веб-интерфейсу. Для домашнего использования проще всего не публиковать порт наружу, а ходить на него через SSH-туннель или VPN-сеть.
Как обновлять агента при разных способах установки
| Способ установки | Как обновлять |
|---|---|
| Скрипт (управляемый исходник) | `hermes update` |
| Hermes Desktop | кнопка обновления в приложении |
| Windows MSIX | Windows App Installer или Store |
| Docker | pull нового образа и пересоздание контейнера |
| Termux | `pkg update`, затем `pkg upgrade hermes-agent` |
| Nix | обновление flake и пересборка |
Hermes определяет способ установки сам — по раскладке каталогов или метке образа — и подсказывает подходящую команду. Настраивать переменные окружения для этого не нужно.
FAQ
Какой способ установки Hermes Agent выбрать?
Для первого запуска на Mac или Windows — Hermes Desktop: он не требует терминала. Для круглосуточной работы — install.sh на Linux-сервере плюс служба gateway. Для изоляции и нескольких агентов на одной машине — официальный Docker-образ.
Можно ли установить Hermes Agent на Windows?
Да, двумя способами: нативно через PowerShell-установщик или внутри WSL2 по инструкции для Linux. Нативная установка проще, WSL2 даёт полноценное POSIX-окружение и встроенный терминал в дашборде.
Работает ли Hermes Agent в Docker?
Да, это поддерживаемый способ установки первого уровня. Данные хранятся в одном каталоге, смонтированном в /opt/data, а обновление делается заменой образа. Команда hermes update внутри контейнера не работает — это ожидаемое поведение, а не ошибка.
Нужен ли VPS, чтобы пользоваться Hermes Agent?
Не обязательно. На своём компьютере агент работает, когда он включён. VPS нужен, если агент должен отвечать в мессенджерах и выполнять задачи по расписанию круглосуточно и без вашего участия.
Сколько стоит установка Hermes Agent?
Сам агент бесплатен и распространяется по лицензии MIT. Расходы — это доступ к языковой модели у выбранного провайдера (или ноль при локальной модели) и, при круглосуточной работе, аренда сервера.
Можно ли поставить Hermes Agent на телефон?
Да, на Android через Termux — но это поддержка второго уровня и только для устройств aarch64. Десктопный установщик на Android не применяется.