Налаштування Hermes Agent: Керований сервіс чи самостійне розміщення на VPS

Hermes Agent: AI-агент для автоматизації робочих процесів

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

Цей агент може бути використаний для різноманітних завдань: від розробки (клонування репозиторіїв, створення тестових середовищ, запуск тестів через повідомлення) до системного адміністрування (планування завдань, моніторинг сервісів, сповіщення) та особистого використання (ранкові брифінги з календарем та новинами).

Варіанти налаштування Hermes Agent

Hermes Agent можна налаштувати двома основними способами:

• Керований Hermes Agent: Цей варіант передбачає використання керованого плану, де постачальник послуг (наприклад, Hostinger) бере на себе керування сервером та його обслуговування. Він швидший у налаштуванні та вимагає менше технічної роботи.
• Самостійно розміщений Hermes Agent: Цей варіант дозволяє розгорнути агент на власному віртуальному приватному сервері (VPS) за допомогою Docker. Він надає повний контроль над інфраструктурою агента, моделями, пам'яттю та інструментами, але вимагає досвіду роботи з Linux, Docker та керуванням серверами.

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

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

1. Отримання плану: Придбайте план керованого Hermes Agent через панель керування або сторінку продукту. Можна обрати додаткові функції, такі як кредити nexos.ai для доступу до моделей (Claude, Gemini, GPT) або кредити Oxylabs для веб-пошуку.
2. Вибір AI-провайдера: Під час початкового налаштування оберіть, як Hermes отримуватиме доступ до моделі AI — через інтеграцію nexos.ai або за допомогою API-ключа від підтримуваного зовнішнього провайдера.
3. Відкриття програми: Дочекайтеся розгортання середовища. Після завершення встановлення відкрийте програму Hermes. Вам також буде надано ключ доступу, який слугує токеном шлюзу.
4. Завершення початкового налаштування: Перегляньте попередньо налаштовані параметри. Якщо ви не обрали готову AI-інтеграцію, введіть API-ключ провайдера та виберіть модель AI.
5. Підключення каналу зв'язку та тестування: Підключіть підтримуваний канал зв'язку (наприклад, Telegram, WhatsApp або Hostinger Email) та надішліть тестове повідомлення, щоб переконатися, що Hermes може отримувати запити та відповідати.

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

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

1. Підготовка середовища VPS:
   • Вам потрібен сервер з дистрибутивом Linux (Ubuntu рекомендується), кореневим доступом та стабільним інтернет-з'єднанням.
   • Рекомендується VPS з мінімум 2 ядрами ЦП та 8 ГБ оперативної пам'яті.
   • Підключіться до VPS через SSH, оновіть системні пакети та забезпечте безпеку (створіть окремого користувача, налаштуйте дозволи, увімкніть автентифікацію за відкритим ключем).
2. Розгортання Hermes Agent за допомогою Docker:
   • Docker упаковує Hermes Agent та всі його залежності в один контейнер.
   • Для Hostinger VPS: Використайте шаблон Hermes Agent або розгорніть його з hPanel (VPS → OS & Panel → Operating System → Change OS).
   • Для інших VPS: Встановіть Docker. Створіть каталог даних (mkdir -p ~/.hermes && cd ~/.hermes), потім розгорніть контейнер: docker run -it --rm -v ~/.hermes:/opt/data nousresearch/hermes-agent setup. Флаг -v монтує каталог хоста для зберігання конфігураційних файлів, API-ключів, сесій, навичок та пам'яті.
3. Запуск майстра налаштування: Після доступу до веб-терміналу або запуску контейнера автоматично запуститься майстер налаштування. Він пропонує "Швидке налаштування" (провайдер, модель, обмін повідомленнями) або "Повне налаштування" (додаткові параметри).
   • Виберіть LLM-провайдера (наприклад, OpenRouter, Anthropic, OpenAI), введіть API-ключ, виберіть модель та підключіть платформу обміну повідомленнями (Telegram, Discord, Slack, WhatsApp).
   • Чутливі дані зберігаються у ~/.hermes/.env, нечутливі — у ~/.hermes/config.yaml.
4. Перевірка роботи Hermes Agent: Запустіть CLI-сесію командою hermes та перевірте зв'язок агента з обраною моделлю. Протестуйте його за допомогою запиту, що активує інструмент (наприклад, "What’s in my current directory?").
5. Налаштування інших моделей, шлюзів та інструментів:
   • Додайте нових LLM-провайдерів за допомогою hermes model. Перемикайтеся між ними під час сесії командою /model.
   • Налаштуйте шлюз обміну повідомленнями за допомогою hermes gateway setup для підключення платформ (Telegram, Discord, Slack, WhatsApp, Signal, email). Запустіть бота командою hermes gateway run.
   • Увімкніть або вимкніть вбудовані інструменти (виконання термінальних команд, веб-пошук, доступ до файлової системи, генерація зображень) за допомогою hermes tools. Деякі інструменти вимагають власних API-ключів.
6. Захист налаштування Hermes Agent:
   • Сканер безпеки Tirith: Вбудований сканер перевіряє кожну термінальну команду на ризики (ін'єкції, витік облікових даних). Режим схвалення можна налаштувати в config.yaml (manual, smart, off).
   • Захист шлюзу обміну повідомленнями: Додайте ідентифікатори дозволених користувачів (allowed_user_ids) у config.yaml для кожної платформи, щоб обмежити доступ.
   • Мережева безпека: Закрийте порти 8642 (API-сервер) та 9119 (панель керування), якщо Hermes Agent використовується лише через чат-платформи (sudo ufw deny).
   • Оновлення: Регулярно оновлюйте контейнер Docker (docker pull, docker rm, docker run). Дані зберігаються у змонтованому томі ~/.hermes.
   • Безпека VPS: Вимкніть SSH-вхід для root, налаштуйте fail2ban та встановіть сканер шкідливих програм.

Поширені помилки при налаштуванні (для самостійного розміщення)

• Додавання функцій до тестування CLI-чату.
• Немонтування тому даних (-v ~/.hermes:/opt/data).
• Неправильні або прострочені API-ключі.
• Пропуск списку дозволених користувачів шлюзу (allowed_user_ids).
• Залишення стандартного термінального бекенду на VPS, що дозволяє агенту виконувати команди безпосередньо на сервері. Рекомендується переключитися на ізольований контейнер за допомогою hermes config set terminal.backend docker.

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

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

• Керований Hermes Agent: Керування здійснюється через панель керування (наприклад, hPanel), де можна відкривати інтерфейс, перевіряти статус, змінювати провайдера AI, переглядати логи, моніторити кредити, керувати резервними копіями та оновлювати підписку. Резервні копії створюються щодня та зберігаються протягом семи днів.
• Самостійно розміщений Hermes Agent:
  • Моніторинг логів: docker logs hermes або docker logs -f hermes.
  • Статус шлюзу: hermes gateway status та hermes gateway restart.
  • Планування завдань: Використовуйте hermes cron для налаштування регулярних завдань (звіти, резервні копії).
  • Веб-панель керування: Запустіть контейнер панелі керування, прив'язавши його до локального інтерфейсу (127.0.0.1:9119), та отримайте доступ через SSH-тунель (ssh -L 9119:127.0.0.1:9119 username@your-server-ip). Не виставляйте порт 9119 безпосередньо в інтернет.
  • Регулярно моніторте доступне сховище, оновлюйте контейнер Hermes та створюйте резервні копії каталогу ~/.hermes.

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

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

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

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

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

• Керований варіант швидший і вимагає менше технічної роботи, тоді як самостійне розміщення надає повний контроль над інфраструктурою, моделями, пам'яттю та інструментами агента.

• Hermes Agent підтримує інтеграцію з різними LLM-провайдерами (наприклад, OpenRouter, Anthropic, OpenAI) та платформами обміну повідомленнями (Telegram, Discord, Slack, WhatsApp).

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

Джерела

• How to set up Hermes Agent (managed or self-hosted)