Как установить Hermes Agent на VPS и получить работающего личного ИИ-агента

---

Сервер уже оплачен. В терминале мигает курсор. Хочется вставить первую команду из поиска, затем вторую из видео двухмесячной давности — и через час получить три Python, два Hermes и одного молчащего бота.

Надёжная установка устроена скучнее. Поэтому она работает.

Коротко: установите Hermes Agent официальным инсталлятором, подключите модель и проверьте hermes doctor. Сначала добейтесь, чтобы Hermes отвечал прямо на сервере и выполнял проверяемую задачу. Telegram Gateway, память, браузер и расписания добавляйте после этого.

• VPS на актуальном Linux. Tier 1 в официальной документации — Linux/WSL2 на x86_64 или arm64; для первого запуска удобен свежий Ubuntu Server.
• SSH-доступ к серверу.
• Обычный пользователь. sudo понадобится для системных зависимостей и некоторых вариантов службы.
• Стабильный исходящий доступ в интернет.
• Подписка или API-доступ к поддерживаемой модели.

Сам Hermes Agent и удалённая модель не требуют мощного сервера. Запас ресурсов зависит от дополнительных инструментов: локальный браузер, обработка медиа и параллельные задачи увеличивают нагрузку.

Перед установкой обновите индекс пакетов и поставьте системные зависимости:

sudo apt update
sudo apt install -y git curl xz-utils

Затем проверьте свободное место, системное время и наличие зависимостей:

df -h
timedatectl status
git --version
curl --version
xz --version

Не начинайте с BotFather. Сначала Hermes Agent должен запуститься и ответить непосредственно на VPS.

Для обычной пользовательской установки выполните:

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

Инсталлятор сам устанавливает управляемый Python, Node.js, ripgrep и ffmpeg, создаёт виртуальное окружение и делает команду hermes доступной в пользовательском PATH. Не устанавливайте Hermes Agent через случайный pip install: этот способ не поддерживается официально.

После установки перезагрузите shell:

source ~/.bashrc

Проверьте команду и окружение:

hermes --help
hermes doctor

hermes doctor важнее сообщения installed. Он проверяет активную среду запуска, конфигурацию и зависимости. Если команда hermes не найдена, перезагрузите shell и убедитесь, что ~/.local/bin входит в PATH.

Для быстрого входа через Nous Portal используйте:

hermes setup --portal

Для выбора другого провайдера и модели:

hermes model

Следуйте мастеру настройки. Не вставляйте API-ключи в команды, репозиторий, статью или общий чат. Hermes хранит секреты и токены в ~/.hermes/.env, а обычные настройки — в ~/.hermes/config.yaml.

Если вы используете собственную локальную модель, официальный Quickstart требует контекст не меньше 64 000 токенов.

Запустите Hermes:

hermes

Не ограничивайтесь вопросом «ты работаешь?». Дайте безвредную проверяемую задачу:

Назови текущую директорию, создай в ней файл hermes-smoke.txt
со строкой HERMES_OK и затем прочитай этот файл обратно.

Так вы одной задачей проверите модель, терминал, файловые инструменты и чтение результата. Ответ агента без созданного и повторно прочитанного файла не считается успешной проверкой.

Базовая установка готова. Если нужен постоянно работающий бот, настройте Gateway:

hermes gateway setup

В мастере выберите Telegram, сохраните токен бота в защищённом хранилище активного профиля и добавьте свой numeric Telegram user ID в allowlist. Альтернатива — подтвердить себя через DM pairing. Без allowlist или подтверждённого pairing Gateway по умолчанию отклоняет сообщения; не включайте GATEWAY_ALLOW_ALL_USERS для бота с доступом к терминалу. Затем установите и запустите пользовательскую службу:

hermes gateway install
hermes gateway start
sudo loginctl enable-linger "$USER"
hermes gateway status

enable-linger позволяет пользовательской службе продолжать работу без открытой SSH-сессии. После запуска получите ответ на первое тестовое сообщение, полностью закройте SSH-сессию и отправьте боту ещё одно сообщение, пока SSH закрыт. Затем подключитесь к серверу снова, проверьте hermes gateway status и убедитесь, что бот ответил на оба сообщения.

Если пользовательская служба запрещена политикой сервера, используйте системный вариант. Сначала проверьте command -v hermes: если sudo не видит пользовательский PATH, передайте команде точный путь, который вернул этот вызов.

sudo hermes gateway install --system
sudo hermes gateway start --system
sudo hermes gateway status --system

Для именованного профиля указывайте его при установке и управлении службой: hermes -p ИМЯ gateway .... Иначе CLI и фоновый процесс могут читать разные config.yaml, .env и сессии.

Готовая установка выдерживает семь проверок:

1. hermes doctor не показывает блокирующих ошибок.
2. Новый диалог отвечает через выбранную модель.
3. Агент выполняет безопасную операцию инструментом, а не только описывает её.
4. После нового входа по SSH команда hermes использует тот же профиль.
5. Тестовый файл или другой результат читается обратно.
6. hermes gateway status показывает запущенную службу.
7. Telegram-бот отвечает после выхода из SSH и повторного входа.

CLI можно использовать без Telegram. Но если цель — постоянно работающий личный бот, Gateway, запуск как службы и повторная проверка после выхода из SSH входят в критерий готовности.

Устанавливают под одним пользователем, запускают под другим

У каждого пользователя свой ~/.hermes, профиль, сессии и данные авторизации. Проверяйте владельца установки и активный профиль перед диагностикой.

Путают команду запуска и исходный файл

Команда hermes должна вести в управляемое виртуальное окружение Hermes. Случайный запуск файла репозитория системным Python может закончиться ошибками отсутствующих модулей.

Оставляют долгоживущий процесс только в SSH-окне

Выход из SSH завершает обычный процесс, запущенный в терминале. Для Telegram и других каналов используйте документированный Gateway как службу, а затем проверяйте работу после выхода из SSH.

Публикуют секреты

Токен Telegram-бота, API-ключ модели и другие данные для доступа не должны попадать в shell history, Git и чаты. Если секрет уже опубликован, его нужно отозвать и выпустить заново.

Нужен ли Docker для установки Hermes Agent на VPS?

Нет. Официальный пользовательский инсталлятор поддерживает обычную установку на Linux. Docker — отдельный поддерживаемый маршрут, но он не обязателен для первого личного агента.

Нужно ли вручную устанавливать Python и Node.js?

Обычно нет. Официальный инсталлятор управляет нужными версиями сам. На Linux заранее нужны git, curl и xz-utils.

Почему CLI работает, а Telegram-бот молчит?

CLI и Telegram Gateway — разные слои. Сначала проверьте модель и инструменты в терминале, затем отдельно настройте Gateway и устойчивый запуск.

Останется ли Hermes работать после выхода из SSH?

Установка и профиль останутся. Обычный foreground-процесс завершится. Для постоянно работающего Telegram-бота или другого канала настройте Gateway как службу и проверьте его после выхода из SSH.

Если хотите сначала разобраться, что именно установили, откройте «Hermes Agent простым языком». Затем посмотрите кейс «Hermes полезнее всего там, где уже есть процесс»: он показывает, почему агент начинает приносить пользу после выбора конкретного рабочего процесса.

На воркшопе «Человек 2.0» поверх базовой установки собирается рабочая система: PowerPack, Telegram, модели, память, браузер, расписания, безопасность, резервные копии и проверка реальных задач.

• Официальная установка Hermes Agent
• Hermes Agent Quickstart
• Поддерживаемые платформы
• Команды Hermes CLI
• Профили Hermes
• Messaging Gateway и запуск как службы
• Безопасность Gateway: allowlists и DM pairing

*Команды и ссылки проверены 2 сентября 2026 года. Технический TTL статьи — 30 дней.*