Первый AI-агент на VPS

После этой инструкции на отдельном учебном VPS будет работать Hermes Agent: вы выберете модель, сохраните ключ локально и попросите агента разобрать безопасный диагностический отчёт. Это не установка локальной большой модели: вычисления выполняются у выбранного API-провайдера, VPS запускает клиент и инструменты.

Рекомендуемый предварительный шаг: VPS в Европе

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

• Linux VPS на Debian 12/13 либо Ubuntu LTS, доступ к HTTPS и несколько гигабайт свободного диска. Установщик загружает инструменты и зависимости; объём и время зависят от актуальной версии.
• Аккаунт поддерживаемого провайдера моделей. Для примера используем OpenRouter через штатный мастер Hermes; стоимость и доступные модели проверяйте в аккаунте перед запуском.
• Отдельный API-ключ с небольшим бюджетом/лимитом расходов, если провайдер позволяет. Бесплатная модель не гарантирует наличие квоты и поддержку инструментов.
• Менеджер паролей. Ключи и токены не вставляются в команды статьи, чат или Git.

1. Проверить пользователя и окружение

Права, свободное место и исходные пакеты

whoami
id
df -h "$HOME"
free -h
sudo apt update && sudo apt install git curl ca-certificates tar

whoami должен показать отдельного пользователя из предыдущей статьи. Если это root, выйдите из root-shell. APT запускается через sudo, сам Hermes — без sudo. Инструкция использует официальный Linux CLI-установщик, а не неизвестный npm-пакет с похожим названием.[1]

2. Скачать и изучить официальный установщик

Сохранить официальный скрипт без автоматического исполнения

mkdir -p "$HOME/Downloads/hermes-install"
cd "$HOME/Downloads/hermes-install"
curl --fail --show-error --location --proto '=https' --tlsv1.2 https://hermes-agent.nousresearch.com/install.sh --output install.sh
less install.sh

Убедитесь, что команда скачивания завершилась успешно. В less выход — q. Просмотрите адреса загрузок, установку зависимостей и изменения shell-профиля. HTTPS защищает транспорт, но не превращает загрузку изменяемого скрипта в независимую проверку происхождения. Для строгого контроля сохраните копию и дату, сверяйтесь с официальной страницей установки.[1]

Запустить изученный установщик от обычного пользователя

bash "$HOME/Downloads/hermes-install/install.sh" --skip-browser --skip-computer-use

Для первого терминального сценария браузер и управление рабочим столом не нужны. Эти официальные флаги сокращают установку; при необходимости инструменты можно добавить позже. Установщик готовит Python и зависимости, launcher обычно появляется в ~/.local/bin. Не запускайте его через sudo и не передавайте --yolo.[1]

Проверить CLI после установки

export PATH="$HOME/.local/bin:$PATH"
hermes --help
hermes doctor

Doctor должен завершиться без необъяснённых ошибок. Если shell всё ещё не видит команду, откройте новое SSH-соединение и проверьте PATH. Не лечите отсутствующую установку повторным вводом API-ключа.

3. Выбрать провайдера и модель

Штатная интерактивная настройка

hermes model

В мастере выберите OpenRouter, введите отдельный ключ в его защищённое поле и выберите доступную в вашем аккаунте модель, поддерживающую вызовы инструментов. Не фиксируем выдуманный model ID: состав каталога меняется. Сначала проверьте цену входных/выходных токенов и ограничения аккаунта. Запомните выбранный точный ID: он будет виден в конфигурации. Другие провайдеры и Nous Portal настраиваются тем же штатным механизмом, но требуют собственного аккаунта.[1][2]

Проверить настройки и ограничить инструменты

hermes config get model
hermes tools
hermes config set approvals.mode manual

В выборе инструментов оставьте минимальный набор для чтения локальных файлов и терминала; отключите ненужные интеграции. Manual требует подтверждения опасных команд, но это не песочница и не гарантирует, что обычная команда не прочитает секрет. Агент имеет права вашего Linux-пользователя. Для чувствительной машины нужна отдельная учётная запись или документированный контейнерный backend, а не только фраза «ничего не меняй».[7]

4. Проверить хранение ключа

Hermes хранит секреты в ~/.hermes/.env, настройки — в ~/.hermes/config.yaml; OAuth-данные могут находиться в auth.json. При другом HERMES_HOME используйте именно его каталог. Не выводите содержимое .env и auth.json и не добавляйте их в репозиторий.[2]

Права на каталог и существующие секретные файлы без вывода содержимого

hermes_home="${HERMES_HOME:-$HOME/.hermes}"
chmod 700 "$hermes_home"
for f in "$hermes_home/.env" "$hermes_home/auth.json"; do
  if [ -f "$f" ]; then
    chmod 600 "$f"
    stat -c '%a %U %n' "$f"
  fi
done

Ожидаются 600 и ваш пользователь. Команда не проверяет, что ключ корректен, и не печатает его. Скройте ключ также в панели провайдера, не используйте один ключ для всех проектов. При утечке сразу отзовите ключ у провайдера и создайте новый; удаление строки из истории не отменяет утечку.

5. Первый полезный сценарий: объяснить диагностику VPS

Создать маленький отчёт без секретов в отдельном рабочем каталоге

mkdir -p "$HOME/agent-lab"
cd "$HOME/agent-lab"
(umask 077
  {
    printf '=== Disk ===\n'
    df -h /
    printf '\n=== Memory ===\n'
    free -h
    printf '\n=== Failed units ===\n'
    systemctl --failed --no-pager
  } > diagnostics.txt
)
less diagnostics.txt

Просмотрите отчёт сами: названия служб тоже могут раскрывать устройство сервера. Если данные чувствительны, замените их вручную до передачи. Не добавляйте env, ps с аргументами процессов, systemctl show Environment или сырые журналы.

Попросить агента прочитать только подготовленный отчёт

cd "$HOME/agent-lab"
hermes chat -q 'Прочитай только diagnostics.txt в текущем каталоге. Объясни загрузку памяти и диска и failed units понятным языком. Не выполняй команды, не меняй файлы, не читай другие пути. Дай список проверок, которые я выполню сам, и явно отдели факты из отчёта от предположений.'

На первом запуске следите за вызовами инструментов. Если агент пытается читать другой путь или запускать команды, отклоните запрос и остановите сеанс. Ожидаемый результат — объяснение фактических строк отчёта и осторожные рекомендации, а не автоматический ремонт. Текст запроса ограничивает намерение, но не даёт технической изоляции.[7]

6. Проверка результата и частые ошибки

• CLI запускается обычным пользователем; doctor работает; мастер сохранил точный выбранный model ID.
• Ответ опирается на diagnostics.txt, не выдумывает отсутствующие измерения; агент не менял сервер.
• В панели провайдера виден ожидаемый расход. После теста проверьте лимит и оставшуюся квоту.
• 401: проверьте ключ в штатном мастере, провайдера и активность аккаунта, не печатайте ключ.
• 429: проверьте квоту/лимиты, подождите либо выберите доступную модель; бесконечные повторы увеличивают расходы.
• Ошибка tool calling: модель может не поддерживать инструменты; выберите другую через hermes model и повторите безопасный запрос.
• Недостаточно RAM/диска: посмотрите реальные ошибки установки, ресурсы и место. Не удаляйте ~/.hermes ради переустановки — там история и конфигурация.

Обновление и остановка

Обновляйте по официальной инструкции для своего метода установки, а не через случайный пакетный менеджер. Перед обновлением сохраните данные Hermes в приватную резервную копию отдельно от ключа API. Для этой статьи gateway и фоновые службы не нужны: выход из CLI завершает интерактивную работу, сам по себе закрытый SSH не отзывает API-ключ.[1]

Источники

[1] https://hermes-agent.nousresearch.com/docs/getting-started/installation

[2] https://hermes-agent.nousresearch.com/docs/user-guide/configuration

[7] https://hermes-agent.nousresearch.com/docs/user-guide/security

Sources

[1] https://hermes-agent.nousresearch.com/docs/getting-started/installation

[2] https://hermes-agent.nousresearch.com/docs/user-guide/configuration

[7] https://hermes-agent.nousresearch.com/docs/user-guide/security