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

Чому Hermes заслуговує на увагу

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

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

Це робить його відмінним вибором для розробників, тих, хто займається самостійним хостингом, і користувачів, орієнтованих на термінал, яким потрібна допомога з реальними завданнями: підсумовування кодової бази, перевірка репозиторію на особистій машині або запуск на невеликому VPS від AlexHost чи будь-якого іншого провайдера без переходу одразу до більшого стеку автоматизації. Наприкінці цього посібника у вас буде встановлений, налаштований 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, складання runbook розгортання, запити для сортування журналів та пошук прогалин у документації.

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

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

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

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