Налаштування Hermes Agent: керований сервіс чи Docker

Вступ до Hermes Agent

Hermes Agent — це постійно активний AI-агент, який навчається на ваших взаємодіях. Він перетворює успішні робочі процеси на навички, які можна використовувати повторно. Після виконання завдання агент може використовувати отримані знання для ефективнішого вирішення подібних запитів у майбутньому.

Вибір способу налаштування

Ви можете налаштувати Hermes Agent двома основними способами: скористатися керованим планом, який бере на себе керування сервером та його обслуговування, або самостійно розмістити його за допомогою Docker на віртуальному приватному сервері (VPS). Вибір залежить від необхідного рівня контролю та бажаного обсягу роботи з обслуговування сервера.

Керований Hermes Agent

Цей варіант є швидшим і вимагає менше технічної роботи. Він підходить для користувачів, які хочуть швидко розпочати роботу та уникнути адміністрування сервера. Постачальник послуг обробляє оновлення сервера, інфраструктуру та основну безпеку.

Самостійне розміщення Hermes Agent

Самостійне розміщення надає повний контроль над інфраструктурою агента, моделями, пам'яттю та інструментами. Цей варіант найкраще підходить для розробників та досвідчених користувачів, яким потрібне індивідуальне налаштування та які готові керувати оновленнями, резервним копіюванням, правилами брандмауера та станом контейнерів. Для цього потрібен досвід роботи з Linux, Docker та керуванням серверами.

Налаштування керованого Hermes Agent

Керований Hermes Agent дозволяє запускати його без конфігурації VPS або самостійного обслуговування контейнера Docker. Постачальник послуг готує ізольоване середовище та керує оновленнями інфраструктури та безпекою, тоді як ви обираєте модель AI та спосіб доступу до агента.

Отримання плану

Для початку необхідно отримати керований план Hermes. Це можна зробити через панель керування постачальника послуг. Під час вибору плану можна додати додаткові функції, такі як кредити для доступу до моделей AI або кредити для миттєвого веб-пошуку.

Вибір AI-провайдера

Під час початкового налаштування ви обираєте, як Hermes отримуватиме доступ до моделі AI. Можна використовувати інтеграцію, що входить до плану, або ввести ключ API від підтримуваного зовнішнього провайдера.

Відкриття програми Hermes

Після розгортання керованого середовища Hermes ви можете відкрити програму. Також надається ключ доступу, який слугує токеном шлюзу для доступу до вашого екземпляра Hermes. Його слід зберігати в безпеці.

Завершення початкового налаштування

У вікні налаштування Hermes перегляньте вже налаштовані параметри. Якщо ви не вибрали готову AI-опцію під час покупки, введіть ключ API провайдера та виберіть режим налаштування, а потім модель AI.

Підключення каналу зв'язку та тестування

Підключіть підтримуваний канал зв'язку, такий як Telegram, WhatsApp або електронна пошта, та авторизуйте його. Після цього можна надіслати просте тестове повідомлення, щоб переконатися, що Hermes може отримувати запити та відповідати через обрану модель.

Керування керованим Hermes Agent здійснюється через панель керування, де можна змінювати провайдера AI або модель, моніторити використання кредитів, перезапускати програму, переглядати журнали та керувати резервними копіями.

Налаштування самостійно розміщеного Hermes Agent за допомогою Docker

Самостійне розміщення Hermes Agent за допомогою Docker надає повний контроль над сервером, моделями, пам'яттю та інструментами. Однак вам доведеться самостійно керувати розгортанням, оновленнями та безпекою.

Підготовка середовища VPS

Для запуску Hermes Agent потрібен сервер з дистрибутивом Linux (рекомендується Ubuntu), кореневий доступ та стабільне підключення до Інтернету. Рекомендується VPS з мінімум 2 ядрами CPU та 8 ГБ оперативної пам'яті. Після придбання VPS підключіться до нього через SSH та оновіть системні пакети. Також слід захистити VPS, створивши виділеного користувача, налаштувавши дозволи та увімкнувши автентифікацію за відкритим ключем.

Розгортання Hermes Agent за допомогою Docker

Docker упаковує Hermes Agent та всі його залежності в один контейнер. Якщо у вас ще немає VPS, можна використовувати шаблон постачальника послуг для автоматичної інсталяції. Для існуючих VPS можна розгорнути Hermes Agent через панель керування. Якщо ви використовуєте іншого провайдера VPS, спочатку встановіть Docker, потім створіть каталог даних (~/.hermes) та розгорніть контейнер за допомогою команди docker run. Флаг -v ~/.hermes:/opt/data монтує каталог хоста до шляху даних контейнера, де зберігаються файли конфігурації, ключі API, сесії, навички та пам'ять.

Запуск майстра налаштування

Після доступу до веб-терміналу або запуску контейнера автоматично запускається майстер налаштування Hermes Agent. Він пропонує швидке налаштування (провайдер, модель, обмін повідомленнями) або повне налаштування (додаткові параметри). Майстер проведе вас через вибір LLM-провайдера (наприклад, OpenRouter, Anthropic, OpenAI), введення ключа API, вибір моделі та підключення платформи обміну повідомленнями. Чутливі дані, такі як ключі API, зберігаються в ~/.hermes/.env, а нечутливі дані — в ~/.hermes/config.yaml.

Перевірка роботи Hermes Agent

Щоб перевірити правильність роботи Hermes Agent після майстра налаштування, запустіть сеанс CLI (hermes). Ви повинні побачити вітальне повідомлення з обраною моделлю, доступними інструментами та завантаженими навичками. Протестуйте його за допомогою запиту, який активує інструмент. Якщо агент повертає порожні відповіді або помилки підключення, найчастішою причиною є неправильний ключ API або неправильно налаштований провайдер. Можна повторно запустити hermes setup або використовувати hermes doctor для діагностики.

Налаштування інших моделей, шлюзу та інструментів

Після того, як CLI-чат працює, можна додати іншу модель, підключити платформу обміну повідомленнями та налаштувати необхідні інструменти. Для додавання нового LLM-провайдера використовуйте hermes model. Перемикатися між провайдерами під час сеансу можна за допомогою команди /model. Шлюз обміну повідомленнями дозволяє спілкуватися з Hermes Agent через платформи, такі як Telegram, Discord, Slack, WhatsApp, Signal або електронна пошта. Для підключення використовуйте hermes gateway setup, а для запуску бота — hermes gateway run. Hermes Agent також включає вбудовані інструменти, такі як виконання термінальних команд, веб-пошук, доступ до файлової системи та генерація зображень. Їх можна вмикати або вимикати за допомогою hermes tools.

Захист налаштування Hermes Agent

Захист налаштування Hermes Agent охоплює як вбудовані засоби захисту агента, так і правила на рівні сервера. Hermes Agent має сканер безпеки Tirith, який перевіряє кожну термінальну команду перед виконанням на наявність ризиків, таких як ін'єкції запитів або витік облікових даних. Його можна налаштувати в ~/.hermes/config.yaml для ручного, інтелектуального або вимкненого режиму затвердження. Для захисту шлюзу обміну повідомленнями додайте свій ідентифікатор користувача до списку дозволених (allowed_user_ids) у config.yaml. На мережевому рівні закрийте порти 8642 (API-сервер) та 9119 (панель керування), якщо ви використовуєте Hermes Agent лише через чат-платформи. Для оновлення слід завантажити останній образ Docker та замінити запущений контейнер, при цьому дані зберігаються в змонтованому томі ~/.hermes.

Поширені помилки при налаштуванні

Найпоширеніші помилки при налаштуванні Hermes Agent, особливо при самостійному розміщенні Docker, включають додавання функцій до тестування CLI-чату, немонтування тому даних, використання неправильних облікових даних API, пропуск списку дозволених для шлюзу та запуск команд безпосередньо на хості. Наприклад, якщо не змонтувати том даних (-v ~/.hermes:/opt/data), всі дані будуть втрачені при перезапуску контейнера. Також важливо перевіряти ключі API та додавати ідентифікатори користувачів до списку дозволених для ботів обміну повідомленнями. На VPS слід переключити бекенд терміналу на docker для ізольованого виконання команд.

Керування Hermes Agent після налаштування

Спосіб керування Hermes Agent залежить від методу встановлення.

Керування керованим Hermes Agent

Для керованого Hermes Agent керування здійснюється через панель керування постачальника послуг. Звідти можна відкривати веб-інтерфейс або інтерфейс командного рядка, перевіряти стан програми, змінювати провайдера AI, ключі API або модель, додавати змінні середовища, переглядати журнали, моніторити кредити та керувати автоматичними резервними копіями.

Керування самостійно розміщеним Hermes Agent

Для самостійно розміщеного встановлення використовуйте Docker та CLI Hermes для моніторингу контейнера, керування підключеними каналами, планування завдань та доступу до панелі керування. Можна переглядати журнали контейнера (docker logs hermes), перевіряти стан шлюзу (hermes gateway status) та перезапускати його. Hermes Agent включає планувальник cron для повторюваних завдань, таких як щоденні звіти або резервне копіювання (hermes cron). Веб-панель керування дозволяє керувати налаштуваннями, ключами API, сесіями та запланованими завданнями. До неї можна отримати доступ, запустивши контейнер панелі керування та створивши SSH-тунель до сервера, щоб порт 9119 не був публічно доступним. Важливо також моніторити доступне сховище, оновлювати контейнер Hermes та регулярно створювати резервні копії каталогу ~/.hermes.

Можливості Hermes Agent

Незалежно від того, чи використовуєте ви керований Hermes Agent, чи самостійно розміщуєте його на VPS, ви отримуєте постійно активного AI-помічника, доступ до якого можна отримати через бажані канали зв'язку.

Для розробників: можна попросити агента клонувати репозиторій, створити проміжне середовище та запустити тести, все це з повідомлення Telegram.
Для системних адміністраторів: можна підключити Hermes Agent до сервера та планувати завдання за допомогою природної мови, наприклад, запитувати щотижневий звіт про використання диска або моніторити сервіс та отримувати сповіщення про його збій.
Для особистого використання: агент може надсилати ранковий брифінг з календарем, головними новинами та сповіщеннями GitHub.

Що це означає для розробників

Для розробників Hermes Agent пропонує гнучкість самостійного розміщення для повного контролю над інфраструктурою, моделями та інструментами. Це дозволяє автоматизувати такі завдання, як клонування репозиторіїв, створення тестових середовищ та запуск тестів, а також інтегрувати його в конвеєри розгортання.

Ключові факти

Hermes Agent — це постійно активний AI-агент, який навчається на взаємодіях та перетворює успішні робочі процеси на навички.
Його можна налаштувати двома способами: як керований сервіс (швидше, менше технічної роботи) або самостійно розмістити за допомогою Docker на VPS (повний контроль).
Для самостійного розміщення потрібен VPS з Linux, мінімум 2 ядра CPU та 8 ГБ RAM, а також досвід роботи з Docker та керуванням серверами.
Hermes Agent підтримує інтеграцію з різними LLM-провайдерами (OpenRouter, Anthropic, OpenAI, Nous Portal, Ollama) та платформами обміну повідомленнями (Telegram, Discord, Slack, WhatsApp).
Він має вбудований сканер безпеки Tirith для перевірки термінальних команд та дозволяє планувати повторювані завдання.