Установка Hermes Agent на VPS: пошаговая инструкция

Hermes Agent – открытый ИИ-агент от Nous Research. Вы общаетесь с ним в терминале или через мессенджеры, а он выполняет задачи, использует инструменты и запоминает контекст. Языковая модель работает по API у выбранного вами поставщика, поэтому видеокарта серверу не нужна. Подробнее о проекте: Hermes Agent в каталоге ИИ-агентов.

Команды ниже взяты из репозитория проекта и официальной документации (адреса в sources) и проверены 6 октября 2026 года на VPS в России с Ubuntu 24.04, 4 ядрами и 6 ГБ памяти. Версия Hermes Agent на момент проверки: 0.21.5. Модель по ключу API мы не подключали, поэтому про работу самого агента здесь выводов нет. Проект развивается быстро, перед установкой сверьтесь со страницей установки в документации. Выполняйте команды под обычным пользователем с sudo: первая настройка VPS. Агент получает доступ к командам и файлам, поэтому не запускайте его от root.

Какой сервер нужен

Официального минимума по процессору и памяти в изученных нами страницах документации нет. Наши замеры: после установки каталог ~/.hermes занял 2,8 ГБ на диске, служба gateway без подключённых мессенджеров занимала около 280 МБ памяти (на пике 350 МБ). Сам агент лёгкий, но во время установки собираются его интерфейсы, и на это нужны память и время. Ориентир, не требование: начинайте с 2 ядер и 4 ГБ памяти. Такие конфигурации в нашей базе стоят от 650 ₽ до 6 400 ₽ в месяц (на 10 октября 2026 года): 2 ядра, 4 ГБ, подбор с фильтром.

По документации, установщик сам ставит нужное окружение: Python, Node.js, npm, ripgrep и FFmpeg. Для установки из исходников нужны git, curl, tar и утилита проверки SHA-256, на Ubuntu они обычно есть. Docker для этой установки не нужен.

Шаг 1. Обновите пакеты

sudo apt update && sudo apt upgrade -y
sudo apt install git curl tar

Первая команда обновляет систему, вторая ставит нужные инструменты, если их нет.

Шаг 2. Запустите установщик

Документация даёт для Linux команду с адресом на сайте проекта: curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash. С сервера в России она не работает: сайт отвечает ошибкой 403, и curl завершается сообщением The requested URL returned error: 403. Мы проверили с двух российских адресов, результат один. С сервера в Казахстане тот же адрес открывается.

Тот же скрипт лежит в официальном репозитории проекта на GitHub, и оттуда он скачивается без ограничений. Мы сравнили оба файла: они совпадают полностью. Поэтому запускайте так:

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

Команда скачивает скрипт установки из репозитория проекта и выполняет его. У нас установка заняла три минуты: скрипт скачивает исходный код, ставит Python и зависимости и собирает интерфейсы. Всё ставится в домашний каталог пользователя, в ~/.hermes.

В конце вывода могут быть предупреждения. У нас их было два: не установился необязательный инструмент cua-driver и один встроенный модуль. На установку и запуск они не повлияли, скрипт закончил строкой Hermes Agent install complete.

Документация проекта находится на том же сайте, что и установщик, и с российских адресов тоже не открывается. Справку по командам можно получить на самом сервере: hermes --help и hermes gateway --help. Если не хотите запускать скрипт вслепую, скачайте его в файл, прочитайте и запустите вручную. После установки перезагрузите настройки оболочки:

source ~/.bashrc

Команда применяет изменения пути поиска программ, чтобы заработала команда hermes.

Шаг 3. Настройте и проверьте

hermes setup

Мастер полной настройки: поставщик модели, ключ и прочие параметры. Выбрать поставщика и модель отдельно можно командой hermes model. Чтобы просто поговорить с агентом в терминале, запустите hermes.

Ключ API вводите только в мастере. Настройки Hermes хранит в каталоге ~/.hermes: общие параметры в config.yaml, ключи и токены в .env. У нас файл .env сразу создался с правами 600, то есть читать его может только владелец. Проверьте у себя:

ls -la ~/.hermes/.env

В начале строки должно стоять -rw-------. Если права другие, исправьте: chmod 600 ~/.hermes/.env.

Шаг 4. Запуск в фоне

Если агент нужен в мессенджерах (в документации перечислены Telegram, Discord, Slack, WhatsApp, Signal), используется процесс gateway. Один процесс обслуживает все подключённые платформы. Настройка платформ:

hermes gateway setup

Установка как службы systemd (пользовательской):

hermes gateway install
hermes gateway start
hermes gateway status

Первая команда регистрирует службу, вторая запускает, третья показывает состояние. У нас hermes gateway install сама запустила службу и сама включила lingering (об этом ниже), а hermes gateway status в конце вывода показала User gateway service is running. Пока модель и мессенджеры не настроены, в журнале службы идут предупреждения об отсутствии авторизации: это ожидаемо. Остановить: hermes gateway stop. Журнал службы:

journalctl --user -u hermes-gateway -f

Опция -f следит за новыми строками журнала.

На VPS, где вы не сидите в сессии постоянно, пользовательская служба должна работать после выхода и подниматься при загрузке. Для этого нужен режим lingering. Команда hermes gateway install включает его сама и пишет Linger enabled. Проверить можно командой loginctl show-user $USER -p Linger: в ответе должно быть Linger=yes. Если там no, включите вручную:

sudo loginctl enable-linger $USER

Команда оставляет пользовательские службы запущенными без открытой сессии. После этого проверьте автозапуск: перезагрузите сервер (sudo reboot), зайдите заново и выполните hermes gateway status.

Для системной службы в документации есть вариант sudo hermes gateway install --system и sudo hermes gateway start --system. Для начала достаточно пользовательской.

Сервису для связи с мессенджерами не нужны входящие порты: проверьте в документации выбранной платформы, нужен ли вам адрес для приёма запросов, и не открывайте лишних портов в фаерволе.

Обновление

hermes update

Команда обновляет установленную программу. По документации, при пользовательской службе с lingering hermes update может перезапустить gateway без повышенных прав. Источники у разных способов установки разные (исходники, Docker, Nix): описанное здесь относится к установке скриптом. Перед обновлением сделайте резервную копию: копируйте домашнюю папку агента, где лежат его настройки и память.

Что проверено, а что нет

Проверено на сервере: установка скриптом из репозитория, недоступность адреса с сайта проекта из России, место хранения настроек и ключей, hermes gateway install, запуск, состояние и остановка службы, имя журнала hermes-gateway, lingering.

Не проверено: работа агента с подключённой моделью и мессенджерами (нужен ключ API), команда hermes update на новую версию. Сайт проекта из России закрыт, и мы не знаем, обращается ли к нему агент во время работы или обновления: если какая-то команда завершится ошибкой 403, причина, скорее всего, в этом.

Что делать дальше

Подберите сервер: VPS с 2 ядрами и 4 ГБ. Если интересует локальный запуск моделей, посмотрите сервер для нейросети.