Hermes Agent на Windows: установка из терминала и первый запуск

Hermes Agent на Windows устанавливается прямо из PowerShell. WSL2 тоже поддерживается, но ставить Linux ради обычного терминального диалога теперь необязательно. Выберите один путь, подключите модель и проверьте три вещи: команда запуска находится, агент получает ответ, история разговора сохраняется. Поддержка обоих вариантов указана в официальной матрице платформ.

Команды и границы поддержки сверены с официальными источниками 8 октября 2026 года. Сквозной прогон на компьютере с Windows для этой версии материала не проводился. Поэтому под каждым этапом приведены признаки, которые нужно проверить у себя; сообщения об успешной установке или ответ агента сами по себе не заменяют эти проверки.

Где вы сейчас с установкой Hermes Agent

• Hermes ещё не установлен, работа идёт в Windows. Начните с выбора варианта и PowerShell. Вам нужен терминальный клиент, доступ к сети и провайдер модели.
• Вы уже работаете в Ubuntu через WSL2. Переходите к разделу про WSL. Команды установки выполняются внутри Linux, а состояние самой WSL проверяется со стороны Windows.
• Команда hermes есть, но ответов нет. Сначала проверьте выбранный launcher и модель. Повторная загрузка программы не исправит отказ авторизации у провайдера.
• Нужен помощник для процесса компании. Прочитайте как внедряют ИИ-агентов в компании, чтобы отделить тест на ноутбуке от доступа к рабочим системам.

Установка Hermes Agent заканчивается тем, что агент можно запустить. Внедрение начинается с другого вопроса: какой результат вы принимаете и кто отвечает за его проверку. Для первого знакомства результат небольшой - один ответ на тестовый запрос и восстановленный разговор. Не переносите на эту проверку заявки клиентов, коммерческие документы или работу отдела целиком.

Какой вариант установки Hermes Agent выбрать

Native означает, что программа работает как процесс Windows. CLI - интерфейс командной строки: вы запускаете программу командой и общаетесь с ней в терминале. PowerShell - оболочка, в которой вводится команда установки. Windows Terminal - приложение, способное открыть вкладку PowerShell или Ubuntu; название приложения ещё не определяет, в какой системе выполняется команда.

Оба пути относятся к Tier 1 для указанных в матрице архитектур x86_64 и aarch64. Это приоритет поддержки проекта, а не обещание, что каждое дополнительное расширение работает на любом ПК. Например, нативный зашифрованный адаптер Matrix ограничен Linux. На Windows ARM64 есть отдельные ограничения некоторых голосовых компонентов и Google Chat SDK. Для первого текстового диалога эти интеграции не нужны.

У native source-установщика Hermes Agent и готового Desktop-пакета разные требования. Windows 11 22H2 или новее требуется для MSIX-пакета Desktop. Переносить это условие на CLI-установку Windows 10 нельзя. Здесь разберём терминальный запуск; настройка графического приложения не входит в последовательность действий.

Если статья, найденная через поиск, утверждает, что Windows поддерживается только через WSL, сравните её с сегодняшней официальной матрицей. Также проверяйте домен источника: русскоязычная копия документации может помочь с переводом, но сведения о поддержке и команды установки лучше брать у разработчика.

1. Выберите native окружение

   Откройте PowerShell под своим обычным пользователем Windows. Для работы внутри уже настроенной WSL2 используйте отдельную Linux-процедуру из статьи.

2. Выполните официальный установщик

   Введите iex (irm https://hermes-agent.nousresearch.com/install.ps1), дождитесь завершения шагов и прочитайте сообщения об ошибках или незавершённых компонентах.

3. Проверьте команду запуска

   Откройте новое окно PowerShell. Выполните Get-Command hermes, hermes --version и hermes doctor, чтобы проверить launcher и состояние установки.

4. Подключите провайдера и модель

   Запустите hermes model и настройте выбранный способ авторизации. Если требуется полный мастер настроек, выполните hermes setup.

5. Проверьте диалог и инструмент

   Запустите hermes, отправьте пробный запрос на вымышленных данных. Отдельно проверьте инструмент на тестовом файле, сравнив вывод с его содержимым.

6. Откройте сохранённую сессию

   Завершите разговор и проверьте hermes sessions list и hermes --continue в том же окружении, где только что общались.

Шаг 1. Подготовьте Windows, терминал и доступ к модели

Найдите PowerShell в меню Windows или выберите его профиль в Windows Terminal. Для native установщика Hermes Agent права администратора не требуются. Не запускайте всю процедуру под другой учётной записью: потом придётся выяснять, чей каталог данных и PATH использует команда.

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

До запуска решите, каким аккаунтом или API-доступом будете пользоваться. Не выбирайте провайдера только потому, что он первым стоит в списке мастера. Проверьте у него доступность нужной модели, условия аккаунта и ограничения запросов. Наличие обычного веб-чата этого провайдера само по себе не доказывает, что Hermes получит доступ через API или другой поддержанный способ входа.

Не устанавливайте заранее случайные версии Python и Node по старому руководству. В текущем source-процессе зависимости готовит PM - встроенный механизм управления пакетами Hermes. Установщик использует управляемые версии, а конкретные сбои компонентов нужно разбирать по его сообщению. Ручная сборка проекта и работа разработчика требуют отдельной процедуры.

Перед началом сохраните открытые рабочие документы. Обязательной перезагрузки native установка не требует, но так вам будет спокойнее разбирать неожиданную ошибку окружения. Для первого теста выделите папку с вымышленным содержимым. Такая папка даст понятную границу: её можно читать, а остальные данные пока не нужны агенту.

Если задача уже связана с рабочими документами компании, отдельно определите доступы и способ приёмки. В ClaudeLab внедрение ИИ под ключ начинается с аудита процесса и прототипа: решение можно увидеть до договора.

Шаг 2. Установите Hermes Agent в PowerShell

В PowerShell вставьте команду из официального раздела Installation:

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

Команда получает скрипт по указанному адресу и выполняет его. Сверяйте адрес перед запуском: особенно если копируете строку из чата, поискового результата или стороннего руководства. Не заменяйте домен на похожий и не добавляйте предложенные неизвестным источником команды отключения защиты Windows.

Установщик загружает исходный код Hermes Agent, подготавливает окружение и создаёт команду запуска. Интерактивная процедура также может открыть настройку модели и gateway - подключения мессенджеров. Для этой инструкции нужны терминальный диалог и модель. Подключения каналов оставьте на следующий этап, не вводите токены ботов только ради завершения мастера.

Смотрите на итог по этапам. Окно может показывать успешную подготовку основной программы и отдельно сообщать, что дополнительная загрузка не завершилась. В таком случае проблема относится к названному компоненту. Если первый диалог уже доступен, это полезный частичный результат, но работу дополнительного инструмента надо проверить отдельно.

При остановке скрипта сохраните последнюю ошибку и путь к журналу, который он вывел. Не копируйте в обращение за помощью весь каталог пользователя. Перед отправкой любого журнала просмотрите его: в нём могут оказаться имена локальных файлов, адреса сервисов или чувствительные параметры.

Завершение установки ещё не повод повторять ту же строку. Следующий шаг - проверить команду в новом окне терминала. Повторный установщик поверх неизвестного состояния добавит ещё один источник неопределённости: будет труднее понять, что именно не сработало при первом запуске.

Шаг 3. Проверьте launcher, PATH и состояние установки

Закройте окно, в котором установка завершилась, и откройте новое окно PowerShell. Установщик добавляет каталог запуска в пользовательский PATH - список мест, где оболочка ищет программы. Уже открытое окно может сохранять прежний список и не находить новую команду.

Введите по очереди:

Get-Command hermes
hermes --version
hermes doctor

Первая команда должна найти launcher. В source-установке с путями по умолчанию он находится в %LOCALAPPDATA%\hermes\bin. Вторая должна вывести версию программы. Третья проверяет состояние Hermes Agent и сообщает о найденных проблемах. Не ждите заранее придуманный номер версии: зафиксируйте тот, который показывает ваша установка.

Doctor удобен тем, что позволяет уточнить причину до изменения настроек. Если он указывает на отсутствующий доступ к модели, продолжайте к выбору провайдера. Если на компоненты окружения - сначала разберите их. Исправный PATH и неработающая авторизация могут существовать одновременно; это не противоречие.

При нескольких установках посмотрите все совпадения:

Get-Command hermes -All

Такой случай возможен, например, после source-установки рядом с Desktop. Проверьте, какой вариант вы действительно запускаете, прежде чем менять его конфигурацию. Иначе можно настроить одну копию, а открыть другую и решить, что настройки не сохранились.

Для source-установки по умолчанию официальное Windows-руководство также даёт временный прямой запуск:

& "$env:LOCALAPPDATA\hermes\bin\hermes.exe"

Используйте его только при этом расположении по умолчанию. Если при установке вы выбрали собственный каталог, путь будет другим. Прямой вызов помогает проверить launcher, но не объясняет автоматически, почему PATH старого окна не обновился.

Состояние управляемых пакетов проверяется отдельно:

hermes pm doctor

Не выполняйте команды ремонта вслепую вслед за этой проверкой. Сначала прочитайте, какой пакет отсутствует или не проходит проверку. Запишите, что найдено: команда, версия, конкретное предупреждение. Тогда у следующего шага будет проверяемая причина.

Шаг 4. Подключите провайдера и модель

Выйдите из пробного запуска, если он открыт, и выполните:

hermes model

Выберите поддержанного провайдера, доступную вам модель и предусмотренный для него способ авторизации. По документации моделей именно основной слот обрабатывает сообщения пользователя и цикл вызова инструментов. Подключение дополнительных моделей для отдельных функций не требуется, чтобы просто начать разговор.

Названия пунктов и перечень моделей могут меняться. Следуйте мастеру своей версии и не копируйте идентификатор модели из старой статьи без сверки. Если сервис отклоняет выбранный идентификатор, уточните его у провайдера. Заменять название похожим по памяти бесполезно: доступ проверяется по точному запросу.

Полный мастер настроек запускается отдельно:

hermes setup

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

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

При выборе основной модели учитывайте требование текущего Quickstart: окно контекста должно быть не меньше 64 000 токенов. Контекст - объём материала, который модель может учитывать в одном рабочем цикле. Для локальной модели одного факта, что сервер отвечает, недостаточно: нужно проверить его настройки и совместимость.

Если пока не знаете, какую задачу поручить агенту, начните с объяснения ИИ-агента для бизнеса. Выбор модели проще оценивать по результату на своей небольшой задаче: соблюдает ли она ограничения, правильно ли читает данные, можно ли проверить её вывод.

Шаг 5. Проведите первый диалог и тест инструмента

В том же новом окне PowerShell выполните:

hermes

Должен открыться интерфейс общения. Для первого запроса не берите реальную клиентскую таблицу. Подойдёт такой вымышленный пример:

Помоги проверить запуск. Вот три вымышленные задачи: согласовать макет,
подготовить черновик письма, сверить список вопросов к встрече.
Раздели их на действия владельца и действия помощника.
Не вызывай инструменты и ничего не отправляй. Если данных недостаточно,
напиши, каких именно. Ответ - максимум шесть строк.

Здесь критерий успеха простой: вы получили содержательный ответ на русском, без ошибки авторизации, и он относится к указанным задачам. Это проверка подключения модели. По ней нельзя заключить, что чтение файлов, браузер, мессенджеры или работа с вашей системой уже доступны.

Для второго теста подготовьте отдельную пустую папку, например hermes-test, и поместите туда один текстовый файл с вымышленными вопросами. Скопируйте её точный путь из Проводника. Не используйте имя пользователя из чужого примера: у вас другой путь, и агент должен получить именно его.

В чате сформулируйте запрос своими данными:

В тестовой папке по указанному мной пути находится один текстовый файл.
Используй инструмент только для просмотра списка файлов и чтения этого
файла. Верни его имя и перечисленные в нём вопросы.
Не выходи за пределы папки, ничего не записывай и не выполняй внешних действий.
Если чтение не удалось, покажи причину. Содержимое не угадывай.

Перед отправкой добавьте точный путь своей папки. Проверьте журнал вызовов инструментов и итоговый ответ: должны совпасть имя файла и его реальное содержимое. Фраза агента «файл прочитан» без наблюдаемого вызова и совпадения данных ещё не доказывает чтение.

В native Windows terminal-tool использует Git Bash. Поэтому команды внутри этого инструмента могут выглядеть как Linux-команды, хотя вы запустили Hermes Agent из PowerShell. Это описано в Windows-руководстве. Не подставляйте PowerShell-синтаксис в Bash только потому, что внешнее окно называется PowerShell.

Для справки по командам в диалоге есть /help, а /tools показывает доступные инструменты. Если тест выходит за заданные границы, остановите работу через Ctrl+C и уточните задачу. Ограничение в промпте помогает описать намерение; права доступа и настройки инструментов нужно оценивать отдельно. Подробнее - в разборе безопасности ИИ-агентов.

Шаг 6. Проверьте сохранение сессии

В CLI команда завершения с клавиатуры - Ctrl+D. После выхода вернитесь в оболочку и выполните:

hermes sessions list
hermes --continue

Первая команда показывает список сохранённых разговоров. Вторая возобновляет последний CLI-разговор. Оба способа описаны в руководстве интерфейса командной строки. Для проверки задайте уточняющий вопрос о вымышленных задачах из первого сообщения. Сравните ответ с тем, что уже обсуждали.

Проверяйте восстановление при тех же исходных условиях: пользователь Windows, выбранная установка и профиль. Если переключиться на WSL или другую копию приложения, вы можете попасть в другой каталог данных. Тогда пустой список сессий относится к этому окружению и не объясняет состояние первоначальной истории.

Не удаляйте каталог Hermes Agent, чтобы «начать чисто», пока разбираетесь с разговором. Вместе с программой там могут находиться настройки и история. У source-установки код и данные имеют разные назначения, хотя их каталоги расположены рядом. Перед переносом или очисткой сначала нужно понять, что именно сохраняется и какой экземпляр это использует.

Результат первого запуска удобно записать коротко: какая установка открыта, какую версию она сообщает, какая модель выбрана, какой тест выполнен и найдена ли сессия. Секреты в эту запись не входят. Она поможет повторить проверку после обновления и обнаружить, на каком шаге изменилось поведение.

Если вы выбрали WSL2: отдельная последовательность

WSL - подсистема Windows для Linux. По процедуре Microsoft упрощённая установка доступна на Windows 10 версии 2004 со сборкой 19041 или новее и Windows 11. Для более старой системы нужна отдельная ручная процедура. Если компьютер управляется компанией, сначала согласуйте включение этой возможности с ответственным за рабочую машину.

Если WSL ещё не установлена, откройте PowerShell с правами администратора и выполните команду ниже. Если Ubuntu уже работает в WSL2, повторная установка не нужна: переходите к проверке версии.

wsl --install

Перезагрузите компьютер, если процедура этого требует. При первом открытии Ubuntu задайте Linux-имя пользователя и пароль. Они относятся к Linux-окружению и не заменяют вашу учётную запись Windows. Далее со стороны PowerShell проверьте:

wsl --list --verbose

У нужного дистрибутива в колонке VERSION должно быть 2. Наличие окна Ubuntu без этой проверки не подтверждает версию WSL. Если там 1, сначала разберите переход на WSL2 по инструкции Microsoft; для Hermes нужен именно подтверждённый путь WSL2.

Откройте Ubuntu и убедитесь, что вы в Linux-оболочке. Для install.sh официальный раздел Installation перечисляет Git, curl, tar и средства SHA-256 среди предпосылок. Если скрипт сообщает об отсутствующем компоненте, установите именно названную зависимость по правилам своего дистрибутива. Не копируйте в Ubuntu команду iex (irm ...) из PowerShell.

В Bash внутри Ubuntu:

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
source ~/.bashrc
hermes doctor
hermes model
hermes

Выполняйте строки по очереди и продолжайте после проверки результата предыдущего шага. Для Bash команда source ~/.bashrc перечитывает настройки оболочки; если вы используете другую оболочку, потребуется её файл настроек. Пробный разговор и восстановление сессии дальше проверяются тем же способом, что и в основном сценарии.

В WSL храните Linux-проекты и окружение на Linux-стороне. Windows-папка имеет другой вид пути: например, диск C доступен как /mnt/c, а домашний каталог Linux находится под /home. Официальное руководство WSL2 для Hermes Agent разбирает пересечение этих границ. Для первого теста проще взять папку внутри Linux и не подключать одновременно Windows-приложения.

Не переносите Windows-каталог с ключами в WSL целиком ради удобства. У двух установок отдельные настройки по умолчанию. Если нужна миграция действующего помощника, сначала разберите состав резервной копии и выбранный каталог данных. Эта статья закрывает новый терминальный запуск; перенос рабочего агента требует своей проверки.

Что делать при ошибке первого запуска

PowerShell не находит hermes. Откройте новое окно и выполните Get-Command hermes. Если результат пустой, сравните фактический каталог установки с путём launcher. При нескольких совпадениях используйте -All. Не начинайте с удаления данных: отсутствие команды в PATH ещё ничего не говорит об истории и настройках.

Hermes найден, но сам не запускается. Сохраните текст ошибки и результат проверки версии. Запустите hermes doctor, если команда доступна. Если вывод указывает на управляемые пакеты, используйте hermes pm doctor. Не заменяйте окружение набором случайных pip-команд из ответа другого чат-бота.

Интерфейс открылся, но модель отклоняет запрос. Повторно откройте hermes model. Проверьте провайдера, идентификатор модели и способ входа. Если ответ содержит ошибку квоты или доступа, разберите её в выбранном сервисе. Установка агента не создаёт дополнительный доступ к модели.

Ответ модели есть, но файл не читается. Сравните путь, окружение и выбранный инструмент. Для native запуска проверьте Windows-папку; для WSL - то, что этот путь виден внутри Linux. Попросите агента вернуть фактическую ошибку вызова: предложение заново установить всю программу причину не покажет. Для текста запроса полезен разбор постановки задач и промптов.

Сохранённый разговор не найден. Проверьте список сессий в том окружении, где шёл диалог. У native и WSL каталоги по умолчанию различаются. Также убедитесь, что запускаете тот же профиль и ту же установку. До прояснения этих условий не называйте историю потерянной.

Для обращения за помощью подготовьте короткий отчёт: Windows и архитектура, native или WSL2, версия Hermes, команда, последняя успешная проверка и точный текст сбоя. Перед отправкой уберите ключи, токены, личные пути и содержимое рабочих файлов. Отдельно укажите, что уже меняли: иначе другой человек будет разбирать первоначальную ошибку на изменённом окружении.

Не подключайте браузер, CRM, мессенджер и задания по расписанию одним действием. Сначала доведите до повторяемого результата текстовый диалог. Затем добавьте один нужный инструмент и проверьте его на ограниченном примере. О переходе к рабочему процессу - в материале об автоматизации малого бизнеса.

Чек-лист

• Выбран один путь: native PowerShell или Linux внутри подтверждённой WSL2.
• Команда hermes находится; для native её расположение проверено через Get-Command, версия записана из фактического вывода.
• Результат hermes doctor прочитан; предупреждения перечислены и не скрыты общим сообщением об успехе.
• Выбраны провайдер, модель и способ авторизации; получен ответ на тестовый запрос.
• На вымышленных данных проверен отдельный вызов инструмента; имя и содержание файла совпадают с реальностью.
• Сессия видна в списке и открывается повторно в том же окружении.
• Определена следующая небольшая задача; доступ к рабочим системам не выдан только ради теста установки.