Быстрый старт с Hermes Agent: от установки до первых шагов

Почему Hermes заслуживает внимания

Если вы когда-либо устанавливали новый инструмент AI, наблюдали, как бинарный файл появляется в вашем PATH, и всё равно получали что-то технически присутствующее, но практически бесполезное, — вы уже понимаете проблему, которую решает это руководство по быстрому старту Hermes Agent. Завершённая установка лишь доказывает, что файлы были скопированы. Она не доказывает, что агент умеет проверять репозиторий, обращаться к реальной модели, безопасно использовать инструменты или возобновлять работу позже.

Именно поэтому Hermes заслуживает внимания. Когда он работает правильно, он перестаёт ощущаться как «ChatGPT в терминале» и начинает вести себя как операционный агент. Он умеет проверять файлы, использовать инструменты терминала, оставаться в рамках рабочего пространства и продолжать сессию, а не вести себя так, будто каждый запрос начинается с нуля.

Это делает его хорошим выбором для разработчиков, пользователей self-hosted решений и тех, кто предпочитает терминал, — всех, кому нужна помощь с реальными задачами: составление резюме кодовой базы, проверка репозитория на личной машине или запуск на небольшом 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, составление runbook развёртывания, запросы для сортировки журналов и поиск пробелов в документации.

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

Теперь у вас есть безопасное рабочее руководство по быстрому старту Hermes

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

Это правильное место, чтобы остановиться и зафиксировать успех. Сохраняйте подтверждения включёнными, расширяйтесь по одному уровню за раз и переходите к более строгой изоляции, когда агент начнёт выполнять работу с более высокими ставками. Если вы в конечном итоге запустите Hermes на личной рабочей станции, лабораторном компьютере или VPS от AlexHost, AvaHost или где-либо ещё, правило остаётся тем же: зарабатывайте доверие маленькими шагами.