Перейти к содержанию

Обзор развертывания 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, который автоматизирует процесс развертывания. Основные этапы включают:

  1. Проверка системных требований: проверка наличия git, curl и совместимости платформы.

  2. Загрузка репозитория: клонирование исходного кода Hermes Agent из GitHub (используется механизм "treeless clone" для оптимизации трафика).

  3. Подготовка среды выполнения Python:

  4. Автоматическая загрузка и установка изолированной версии uv (менеджер пакетов) в директорию ~/.hermes/tools.

  5. Установка необходимой версии Python через uv.

  6. Установка зависимостей: использование менеджера пакетов для установки всех необходимых библиотек Python, верифицированных по хеш-сумме (uv.lock).

  7. Сборка продуктов: выполнение команды сборки CLI и приложений (включая desktop-версию при наличии флага --include-desktop).

  8. Настройка окружения: создание директорий для данных, копирование примеров конфигурационных файлов (.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 вступили в силу.

question_mark
Я могу вам чем-то помочь?
question_mark
ИИ Помощник ×