Как установить Hermes Agent на Ubuntu и проверить запуск

Что понадобится

Для POSIX-установки документация Hermes указывает Git, curl, tar и утилиты SHA-256. Скрипт самостоятельно загружает закреплённую версию uv; уже установленный uv из PATH не используется. Текущие first-party installations работают на Python 3.14. Более широкий диапазон в проекте позволяет старым установкам обновиться, но не означает гарантированную поддержку текущего runtime на Python 3.11–3.13.

Перед началом выберите пользователя, от имени которого будет работать Hermes. Установка в домашний каталог обычного пользователя обычно проще для CLI. Если агент будет работать как сервисный пользователь, установщик нужно запускать именно от его имени. Администратор отдельно обеспечивает системные библиотеки, необходимые выбранным инструментам.

Установите Hermes Agent

В терминале Ubuntu выполните официальный POSIX-установщик:

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

Скрипты клонируют исходный код, подготавливают uv и передают подготовку зависимостей менеджеру PM. По умолчанию устанавливаются Python-зависимости, браузерные инструменты и компьютерный драйвер, если для платформы доступен соответствующий вариант. Если эти компоненты не нужны, POSIX-установщик поддерживает параметры --skip-browser и --skip-computer-use.

Установка из исходников размещает checkout по умолчанию в ~/.hermes/hermes-agent/, launcher — в ~/.local/bin/hermes, а пользовательские данные — в ~/.hermes/. Переменная HERMES_HOME меняет каталог данных, а параметр --dir задаёт каталог исходного checkout независимо от него.

Обновите shell и проверьте команду

После завершения установки перечитайте конфигурацию shell:

source ~/.bashrc

Если launcher не находится, проверьте PATH:

export PATH="$HOME/.local/bin:$PATH"

Затем запустите диагностику:

hermes doctor

Не используйте жёстко заданный путь вроде venv/bin/hermes: для установленного wrapper документация рекомендует запускать команду hermes. Если команда всё ещё не найдена, проверьте, что вы используете того же пользователя, от имени которого выполнялась установка.

Настройте провайдера и модель

Установка CLI ещё не означает, что агент сможет отвечать: нужно выбрать провайдера и модель. Интерактивная настройка выполняется командой:

hermes model

Альтернативно можно запустить полный мастер:

hermes setup

Для быстрого сценария с Nous Portal официальная документация также приводит:

hermes setup --portal

При использовании другого провайдера подготовьте требуемую им авторизацию и укажите модель через мастер. Секреты и обычные настройки хранятся раздельно: секреты — в ~/.hermes/.env, несекретные параметры — в ~/.hermes/config.yaml. Значения можно задавать через CLI, например:

hermes config set OPENROUTER_API_KEY your_key

Не вставляйте настоящий ключ в публичный текст, shell-скрипт или историю команд без необходимости.

Выполните первый тестовый запуск

Запустите классический CLI:

hermes

Или TUI:

hermes --tui

Отправьте простой запрос, результат которого легко проверить, например попросите перечислить файлы текущего проекта. Успешный базовый запуск означает, что banner показывает выбранного провайдера и модель, Hermes отвечает без ошибки, а диалог продолжается хотя бы ещё одним сообщением.

После этого проверьте сохранение сессии:

hermes --continue

Если последняя сессия не восстановилась, проверьте, что вы работаете с тем же профилем и что сессия действительно была сохранена.

Что делать при ошибках

hermes: command not found. Перезапустите shell командой source ~/.bashrc и проверьте $PATH, включая $HOME/.local/bin.

API key not set. Запустите hermes model и завершите настройку провайдера либо задайте нужный секрет через поддерживаемую команду конфигурации.

Пустые или ошибочные ответы. Повторно проверьте провайдера, модель и авторизацию через hermes model.

Проблемы с конфигурацией. Сначала выполните:

hermes doctor

Для диагностики конфигурации документация также указывает:

hermes config check
hermes config migrate

Не добавляйте gateway и дополнительные инструменты до успешного обычного чата. Если базовый запуск работает, подключить messaging gateway можно позже:

hermes gateway setup

Для постоянно работающего Linux user service документация отдельно указывает команду администратора sudo loginctl enable-linger SERVICE_USER, но это не требуется для обычного запуска CLI.

Важные ограничения

Если HERMES_HOME или отдельные каталоги данных указывают на симлинки, цель должна существовать, быть доступной и оставаться каталогом. При недоступной цели Hermes останавливает инициализацию, а не создаёт замену на локальном диске. Сначала восстановите mount или исправьте ссылку, затем повторите проверку.

Не удаляйте весь каталог данных для ремонта установки: источник приложения и пользовательские данные имеют разные роли. Для браузерных сценариев на Linux могут понадобиться системные библиотеки дистрибутива; установщик не выполняет автоматический шаг Playwright --with-deps и не заменяет пакетный менеджер Ubuntu.

После того как CLI и обычный чат проверены, можно отдельно настраивать gateway, skills, cron или изоляцию терминальных действий. Каждую такую возможность проверяйте отдельно, не считая её подтверждённой только потому, что базовая команда hermes запускается.