Обзор развертывания Hermes Agent на сервере¶
Предварительные требования¶
Для успешной установки и работы приложения требуются следующие компоненты:
-
Операционная система: Linux (поддерживаются дистрибутивы с поддержкой
glibcилиmusl, например, Ubuntu) или macOS. -
Системные утилиты:
-
git— для загрузки исходного кода из репозитория. -
curl— для загрузки необходимых компонентов и инструментов. -
Зависимости среды выполнения:
-
Наличие системных библиотек (например,
libatomic1в Debian/Ubuntu) может потребоваться для работы Node.js. -
Для пользователей macOS требуется наличие установленных Apple Command Line Tools.
FQDN итоговой панели на домене hostkey.in¶
| Параметр | Значение | | Префикс | hermes | | Домен | hostkey.in | | Полный шаблон | hermes{Server_ID_from_Invapi}.hostkey.in |
Структура файлов и каталогов¶
После установки приложение использует следующие основные пути:
-
~/.hermes/— домашняя директория приложения (содержит логи, конфигурации, сессии и кэш). -
~/.hermes/logs/— файлы журналов установки и работы. -
~/.hermes/config.yaml— основной конфигурационный файл приложения. -
~/.hermes/.env— файл переменных окружения (создается автоматически из примера). -
INSTALL_DIR(по умолчанию/home/<user>/.hermes/hermes-agent) — директория с исходным кодом и рабочими файлами приложения.
Процесс установки приложения¶
Установка выполняется с помощью установочного скрипта install.sh, который автоматизирует процесс развертывания. Основные этапы включают:
-
Проверка системных требований: проверка наличия
git,curlи совместимости платформы. -
Загрузка репозитория: клонирование исходного кода Hermes Agent из GitHub (используется механизм "treeless clone" для оптимизации трафика).
-
Подготовка среды выполнения Python:
-
Автоматическая загрузка и установка изолированной версии
uv(менеджер пакетов) в директорию~/.hermes/tools. -
Установка необходимой версии Python через
uv. -
Установка зависимостей: использование менеджера пакетов для установки всех необходимых библиотек Python, верифицированных по хеш-сумме (
uv.lock). -
Сборка продуктов: выполнение команды сборки CLI и приложений (включая desktop-версию при наличии флага
--include-desktop). -
Настройка окружения: создание директорий для данных, копирование примеров конфигурационных файлов (
.env,config.yaml) и настройка путей в системных профилях пользователя (.bashrc,.zshrcи др.).
Права доступа и безопасность¶
-
Переменные окружения: Файл
~/.hermes/.envустанавливается с правами доступа600(чтение и запись только владельцем) для обеспечения безопасности конфиденциальных данных. -
Пользователь: Приложение работает от имени текущего пользователя, не требуя постоянных прав суперпользователя после этапа установки зависимостей.
Базы данных¶
Приложение использует локальное хранилище данных, которое инициализируется в директории ~/.hermes/. Сюда входят:
-
Папки для хранения сессий (
sessions), воспоминаний (memories) и навыков (skills). -
Кэш изображений (
image_cache) и аудио (audio_cache).
Контейнеры Docker и их запуск¶
В данном проекте использование контейнеров Docker не предусмотрено. Приложение развертывается непосредственно в операционной системе (bare metal) с использованием изолированной среды Python, управляемой менеджером uv.
Кастомные скрипты и дополнительные настройки¶
-
Установочный скрипт (
install.sh): Основной инструмент автоматизации, который управляет жизненным циклом установки: от проверки платформы до финальной сборки CLI. -
Скрипт инициализации окружения: Автоматически добавляет путь к исполняемым файлам приложения в переменную
PATHпользователя (через.bashrc,.zshrc,.profileили.config/fish/config.fish). -
Настройка конфигурации: Скрипт автоматически создает структуру папок для работы приложения (
cron,sessions,logs,pairing,hooks,image_cache,audio_cache,memories,skills) и подготавливает файлы настроек из шаблонов.
Инструкция по обновлению приложения¶
Обновление выполняется с помощью встроенной команды управления: hermes update
Процесс обновления включает в себя:
-
Синхронизацию текущего состояния репозитория с официальным каналом (stable или main).
-
Обновление зависимостей Python.
-
Пересборку продуктов приложения для обеспечения совместимости с новой версией кода.
Расположение конфигурационных файлов и данных¶
| Тип данных | Путь к файлу/директории |
|---|---|
| Основной конфиг | ~/.hermes/config.yaml |
| Переменные окружения | ~/.hermes/.env |
| Логи приложения | ~/.hermes/logs/install.log (установочный) и системные логи в ~/.hermes/logs/ |
| Исполняемые файлы | ~/.local/bin/ или внутри директории установки |
Доступные порты для подключения¶
Приложение использует сетевые интерфейсы для работы gateway-сервиса (настраивается на этапе gateway setup), однако конкретные порты определяются в процессе выполнения команды hermes gateway install.
Запуск, остановка приложения¶
Для запуска основного интерфейса командной строки используется команда: hermes
После установки пользователю может потребоваться перезапустить терминал или выполнить команду source <ваш_rc_файл> (например, source ~/.bashrc), чтобы изменения в PATH вступили в силу.