bizkot

Установка и настройка Hermes Agent на VPS

—

от автора

Dmitrybell77
в

Введение в Hermes Agent

Hermes Agent — это открытый фреймворк для запуска автономных ИИ-агентов на собственном сервере. Он позволяет модели взаимодействовать с файловой системой, выполнять консольные команды, запускать фоновые процессы и писать код. В этой инструкции описан процесс развертывания, базового конфигурирования и интеграции агента с Telegram-ботом на VPS под управлением Ubuntu Linux.

Hermes Agent Mascot

1. Подготовка системы

Для стабильной работы Hermes Agent требуется сервер на базе Ubuntu (22.04 LTS / 24.04 LTS) с минимальным объемом оперативной памяти 2 ГБ. Перед установкой необходимо обновить пакетную базу и установить системные зависимости:

sudo apt update && sudo apt upgrade -y
sudo apt install -y python3 python3-pip python3-venv git curl tmux ffmpeg

2. Установка Hermes Agent

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

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

Для ручной установки из репозитория в изолированное виртуальное окружение выполните следующую последовательность команд:

# Клонирование репозитория в домашнюю директорию
git clone https://github.com/NousResearch/hermes-agent.git ~/.hermes/hermes-agent
cd ~/.hermes/hermes-agent

# Создание и активация виртуального окружения
python3 -m venv venv
source venv/bin/activate

# Обновление менеджера пакетов и установка в режиме редактирования
pip install --upgrade pip
pip install -e .

3. Настройка конфигурационного файла

Главный конфигурационный файл агента находится по пути ~/.hermes/config.yaml. Для его автоматической генерации и интерактивной настройки запустите мастер:

hermes setup

Также файл конфигурации можно отредактировать вручную. Пример стандартной структуры:

model:
  default: anthropic/claude-3-5-sonnet
  provider: openrouter
agent:
  max_turns: 50
  tool_use_enforcement: true
terminal:
  backend: local
  cwd: /opt/data
memory:
  memory_enabled: true
  provider: builtin

4. Подключение провайдера и API-ключей

Все конфиденциальные переменные окружения и ключи доступа ИИ-провайдеров хранятся в скрытом файле ~/.hermes/.env. Создайте его и пропишите ключ авторизации:

# Открытие/создание файла переменных
nano ~/.hermes/.env

# Пример содержимого для работы через OpenRouter:
OPENROUTER_API_KEY=your_openrouter_key_here

# Пример для прямого использования Anthropic:
ANTHROPIC_API_KEY=your_anthropic_key_here

5. Использование в CLI-режиме

Запуск интерактивного чата с агентом осуществляется командой:

hermes

Для управления сессией прямо во время диалога используйте слеш-команды:

  • /new — сбросить контекст и начать чистый диалог;
  • /model [имя] — быстро переключить модель;
  • /tools — интерактивное управление доступными инструментами;
  • /exit — завершить сессию и выйти в шелл.

6. Фоновый запуск и интеграция с Telegram

Hermes Agent оснащен встроенным шлюзом (gateway), позволяющим общаться с агентом через сторонние платформы. Запустите настройку интеграции:

hermes gateway setup

В мастере настройки выберите Telegram, укажите токен бота от @BotFather и ваш персональный Telegram ID для разграничения прав доступа. После сохранения настроек добавьте службу шлюза в автозапуск системы:

# Установка службы в systemd
hermes gateway install

# Запуск службы в фоновом режиме
hermes gateway start

# Проверка корректности запуска
hermes gateway status

Управление сервисом в случае изменения конфигурации производится перезапуском службы командой hermes gateway restart.