Швидкий старт Hermes Agent: від встановлення до перших кроків

Чому варто звернути увагу на Hermes

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

Саме тому варто звернути увагу на Hermes. Коли він працює належним чином, він перестає відчуватися як «ChatGPT у терміналі» і починає поводитися як операційний агент. Він може перевіряти файли, використовувати інструменти терміналу, залишатися в межах робочого простору та продовжувати сесію замість того, щоб поводитися так, ніби кожен запит починається з нуля.

Це робить його гарним вибором для розробників, самостійних хостерів і користувачів, що надають перевагу терміналу, яким потрібна допомога з реальними завданнями: узагальнення кодової бази, перевірка репозиторію на особистій машині або запуск на невеликому VPS від AlexHost, AvaHost або будь-якого іншого провайдера без одразу переходу до більшого стеку автоматизації. Наприкінці цього посібника у вас буде встановлений, налаштований, протестований на безпечному першому завданні та успішно відновлений Hermes.

Що таке Hermes — і що цей посібник насправді допоможе вам зробити

Перш ніж виконувати будь-які команди, тримайте три терміни окремо. Більшість плутанини при першому запуску виникає через те, що їх зводять до одного розмитого поняття «AI».

Наступна таблиця дає вам робочу ментальну модель для цього посібника:

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

📝 Примітка: Встановлення Hermes — це не те саме, що налаштування Hermes. Бінарний файл може бути присутнім і все одно бути непридатним для використання, поки ви не запустите hermes model і не підключите його до провайдера та моделі.

Ви можете помітити, що офіційна документація також пропонує hermes setup. Це дійсний варіант, але цей посібник навмисно відокремлює встановлення від hermes model, щоб ви могли точно побачити, де відбувається більшість успіхів або невдач при першому запуску. Ми також дотримуємося підходу класичного CLI в першу чергу для відтворюваності, хоча hermes –tui існує і використовує ті самі базові сесії. Поза межами цього швидкого старту: налаштування шлюзу, cron, MCP, мережа локальних моделей, маршрутизація між кількома провайдерами та захист виробничого середовища.

Правила безпеки перед тим, як надати Hermes доступ до оболонки

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

⚠️ Попередження: Залишайте підтвердження в безпечному режимі за замовчуванням протягом усього цього швидкого старту і не використовуйте –yolo. Hermes запитує перед ризикованими командами; це функція безпеки, а не безглузде тертя.

Використовуйте цей короткий контрольний список перед тим, як продовжити:

• Починайте на машині або в робочому просторі з низьким ризиком.
• Залишайте підтвердження запитів увімкненими.
• Уникайте особистих виробничих репозиторіїв для першого тесту.
• Очікуйте, що завдання перевірки залишатиметься лише для читання.
• Розглядайте термінальні бекенди Docker і SSH як подальші кроки зміцнення безпеки, а не вимоги першого дня.

Перше реальне завдання перевірки в цьому посібнику залишається в межах ~/.hermes/hermes-agent, що робить демонстрацію актуальною для Hermes, уникаючи при цьому чутливих проектів. Як тільки базовий процес CLI стабілізується, ви можете перейти до більш надійної ізоляції за допомогою Docker або віддалених бекендів. Протягом першої години безпечний і перевірений підхід кращий за амбітний.

Перш ніж встановлювати: передумови, підтримувані шляхи та одна особливість WSL2

Для більшості користувачів підтримувана картина проста: Linux, macOS і WSL2 — це шляхи, на які варто звернути увагу в першу чергу. Нативна Windows існує, але вона все ще знаходиться на ранній стадії бета-тестування, тому якщо ви використовуєте Windows, практична рекомендація все ще WSL2.

На Ubuntu 24.04 або WSL2 почніть з перевірки наявності git і curl:

Якщо другий рядок повертає рядок вашого дистрибутива разом із робочим виводом версій обох інструментів, базові передумови виконані. На macOS еквівалентна перевірка зазвичай полягає лише в підтвердженні git –version і curl –version перед використанням того самого інсталятора Hermes.

📝 Примітка: Нативна Windows все ще знаходиться на ранній стадії бета-тестування, тому надавайте перевагу WSL2, якщо ви використовуєте Windows.
💡 Порада: У WSL2 зберігайте Hermes і ваші робочі репозиторії в ~ замість /mnt/c, щоб уникнути повільніших операцій Git і дивної поведінки з правами доступу до файлів.

Хороша новина полягає в тому, що Hermes не вимагає від вас вручну збирати великий стек залежностей. Офіційний git-інсталятор обробляє uv, Python 3.11, Node.js 22, ripgrep і ffmpeg за вас. Що вам слід підготувати до початку роботи майстра налаштування — це обліковий запис провайдера або принаймні перевірений план для користувацького кінцевого пункту. Також оберіть модель з контекстним вікном не менше 64K: менші контекстні вікна, як правило, дають збій, коли агент починає одночасно обробляти контекст файлів, вивід інструментів і багатокрокові інструкції.

Встановлення Hermes Agent за допомогою офіційного однорядкового шляху

Після виконання передумов запустіть офіційний інсталятор точно так, як задокументовано:

Це вже більше, ніж просто крок встановлення. Hermes визначає платформу, підготовлює необхідні залежності, а потім одразу переходить до процесу налаштування при першому запуску. У наведеному вище прикладі інсталятор визначає Linux, перевіряє наявність uv, встановлює Python 3.11 там, де це потрібно, підготовлює Node.js 22 для інструментів браузера та будує командне середовище Hermes.

Якщо встановлення виконується від імені root, ви можете побачити шляхи такі як /usr/local/bin/hermes, /usr/local/lib/hermes-agent і /root/.hermes/. При звичайному встановленні користувача очікуйте ту саму структуру у вашому власному домашньому каталозі.

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

Перше рішення — це провайдер виведення. У цьому запуску обрано OpenRouter, що є практичним першим вибором, оскільки він надає доступ до широкого каталогу моделей через один обліковий запис провайдера. Якщо ви вже використовуєте інший підтримуваний провайдер, оберіть його натомість.

Після вибору провайдера Hermes запитує відповідний API-ключ. У цьому прикладі це означає OPENROUTER_API_KEY. Вставте ключ, натисніть Enter, і Hermes збереже його для подальшого використання.

Якщо ви пропустите цей крок, Hermes може завершити встановлення, але він ще не буде готовий до реальної агентської сесії. Вам потрібно буде повернутися і налаштувати провайдера пізніше.

Після збереження ключа майстер переходить до вибору моделі. У цьому запуску обрана модель — deepseek/deepseek-v4-pro. Це дійсний конкретний приклад, але це не єдиний ваш шлях: майстер також дозволяє ввести власну назву моделі або пропустити і зберегти поточну модель, якщо ви повторно запускаєте налаштування на існуючій установці.

Для першого запуску практичне правило просте: оберіть одну модель, до якої ви вже знаєте, що маєте доступ, і переконайтеся, що вона має достатній контекст для реальної агентської роботи. Hermes набагато надійніший з моделями, що пропонують контекстне вікно не менше 64K. Менші контекстні вікна можуть виглядати нормально в невеликому тесті, але дають збій, коли починають накопичуватися вивід інструментів, контекст файлів і багатокрокові інструкції.

Якщо ви коли-небудь захочете змінити цей вибір пізніше, hermes model — це все ще найшвидший спосіб повторно запустити вибір провайдера та моделі без перевстановлення.

Далі Hermes запитує, скільки ширшого налаштування ви хочете зробити прямо зараз. Для цього швидкого старту рекомендований варіант є правильним: швидке налаштування.

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

Наступний екран запитує про термінальний бекенд. Для першого запуску залишайте поточний локальний бекенд, щоб Hermes запускався безпосередньо на цій машині. Docker, SSH, Modal та інші бекенди корисні пізніше, але вони додають складність до того, як ви навіть підтвердили, що базовий процес CLI працює.

Потім Hermes пропонує налаштування платформи обміну повідомленнями. Для цього швидкого старту пропустіть його. Це дозволяє посібнику зосередитися на основному процесі агента CLI, і ви можете додати Telegram, Discord або інший шлях обміну повідомленнями пізніше за допомогою hermes setup gateway.

Після завершення роботи майстра Hermes показує, де він зберіг важливі файли.

Основний поділ, який слід пам’ятати, простий: config.yaml містить несекретні налаштування, .env містить API-ключі та інші секрети, а каталоги даних містять сесії, журнали та пов’язаний стан виконання. На цьому знімку екрана шляхи знаходяться в /root/.hermes/, оскільки встановлення було виконано від імені root. При звичайному встановленні користувача читайте ці шляхи як ~/.hermes/.

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

На цьому етапі Hermes і встановлено, і налаштовано. Наступне, що потрібно зробити — перевірити, що середовище справне, перш ніж переходити до першого реального завдання:

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

Якщо hermes ще не видно в новій оболонці, перезавантажте оболонку та перевірте шлях команди перед тим, як продовжити. У Bash це зазвичай означає source ~/.bashrc; у Zsh — source ~/.zshrc. За потреби підтвердіть запускач за допомогою command -v hermes.

Після успішного проходження Doctor встановлення не просто завершено — Hermes тепер дійсно готовий до використання.

Виконайте своє перше безпечне агентське завдання

Тепер, коли Hermes встановлено, налаштовано та перевірено за допомогою hermes doctor, ви готові до першої реальної демонстрації. Найбезпечнішим першим робочим простором з високим сигналом є сам домашній каталог Hermes. У цьому запуску встановлення було виконано від імені root, тому цей каталог — /root/.hermes. При звичайному встановленні користувача тим самим місцем буде ~/.hermes.

Перейдіть до цього каталогу, підтвердіть своє місцезнаходження, а потім запустіть Hermes:

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

Якщо ви надаєте перевагу новішому інтерфейсу, hermes –tui все ще доступний, але цей посібник дотримується підходу класичного CLI в першу чергу, оскільки його легше відтворити крок за кроком, і обидва інтерфейси використовують однакові сесії.

Коли Hermes відкриється, дайте йому простий запит лише для читання, який просить його перевірити поточний робочий простір і визначити точку входу. У цьому прикладі запит явно вказує на /root/.hermes, оскільки встановлення було виконано від імені root. При звичайному встановленні користувача вкажіть на власний каталог ~/.hermes.

Використовуйте наступний запит:

Summarize this repo in 5 bullets and tell me what the main entrypoint is: ~/.hermes

Це саме той тип першого завдання, який вам потрібен: безпечний, спостережуваний і легко перевірюваний. На знімку екрана вище Hermes не просто здогадується. Він починає читати конкретні файли, такі як config.yaml, SOUL.md і .install_method, шукає файли, пов’язані з Hermes, і перевіряє встановлений шлях запускача. Ця видима активність інструментів є реальним доказом того, що Hermes поводиться як агент, а не як одноразовий чат-бот.

Здоровий результат повинен повернути конкретний підсумок, прив’язаний до робочого простору, і перевірювану точку входу. У цьому запуску Hermes визначає встановлену обгортку команди в /usr/local/bin/hermes, пояснює, що вона веде до точки входу Python CLI, і підсумовує навколишнє середовище Hermes у п’яти пунктах.

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

Відновіть сесію та підтвердіть, що налаштування дійсно працює

Швидкий старт не завершено, коли Hermes відповідає один раз. Він завершено, коли ви підтверджуєте, що сесію можна відновити.

Використовуйте наведену нижче команду відновлення; -c — це скорочена форма для тієї самої дії:

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

Використовуйте цей компактний контрольний список успіху перед тим, як рухатися далі:

• Hermes встановлено та перевірено
• Провайдер налаштовано
• Перша відповідь чиста
• Перше завдання з репозиторієм виконано
• Сесію успішно відновлено

Якщо відновлення не працює, спочатку переконайтеся, що ви використовуєте той самий профіль, потім перевірте доступні сесії за допомогою hermes sessions list. Як тільки hermes –continue працює, у вас є повна базова лінія, яку цей посібник Hermes Agent мав на меті встановити.

Що спробувати далі, коли базовий процес працює

Як тільки базовий чат стабільний, додавайте лише один новий шар за раз.

💡 Порада: Стримуйте бажання одразу увімкнути всі розширені функції. Спочатку стабілізуйте один чистий процес, а потім розширюйтеся навмисно.

Ось короткий список розумних наступних кроків:

• Спробуйте hermes –tui, якщо хочете новіший термінальний інтерфейс поверх тієї самої моделі сесій.
• Запустіть hermes setup пізніше, якщо хочете ширший майстер налаштування після ручного розуміння основ.
• Дослідіть hermes gateway setup, якщо ваша наступна мета — інтеграція з платформою обміну повідомленнями.
• Перегляньте hermes tools і hermes skills, коли захочете контрольованого розширення можливостей.
• Перейдіть до термінального бекенду Docker або SSH, якщо агент почне торкатися систем з вищими ставками.
• Використовуйте офіційну документацію для користувацьких провайдерів і кінцевих пунктів локальних моделей, коли хостований шлях вже працює.

Якщо вам потрібні ідеї для подальшого реального використання, ось кілька хороших для подальшого дослідження: нотатки для ознайомлення з кодовою базою, складання журналу змін, безпечне планування рефакторингу, пояснення конфігураційних файлів, підсумки перевірки pull request, контрольні списки обслуговування VPS, складання посібників з розгортання, запити для сортування журналів і пошук прогалин у документації.

Для більш глибоких шляхів посилайтеся назовні, а не розтягуйте цей швидкий старт у другу статтю: швидкий старт, документація з встановлення, посібник CLI і посібник з безпеки — це правильні наступні зупинки.

Тепер у вас є безпечний робочий швидкий старт Hermes

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

Це правильне місце, щоб зупинитися і відзначити успіх. Залишайте підтвердження увімкненими, розширюйтеся по одному шару за раз і переходьте до більш надійної ізоляції, коли агент починає виконувати роботу з вищими ставками. Якщо ви врешті-решт запустите Hermes на особистій робочій станції, лабораторному комп’ютері або VPS від AlexHost, AvaHost або будь-де ще, правило залишається тим самим: заробляйте довіру маленькими кроками.