Как установить Hermes Agent на Windows

Коротко. Hermes Agent на Windows ставится тремя способами: готовым приложением Hermes Desktop, одной командой в PowerShell (права администратора не нужны) или внутри WSL2 как обычный Linux. Для большинства подойдёт команда в PowerShell. Ниже каждый способ по шагам, куда программа кладёт файлы, как проверить, что всё работает, и что делать, если команда hermes не находится. Сведения проверены по официальной документации 22 октября 2026 года, ссылки в конце.

Какой способ выбрать

Способ	Подходит, если	Что нужно
Приложение Hermes Desktop (MSIX)	Хотите окно с кнопками и не любите терминал	Windows 11 версии 22H2 или новее
Команда в PowerShell	Хотите работать в терминале на Windows 10 или 11	Права администратора не нужны
WSL2	Нужна среда Linux и её инструменты	Включённый WSL2 с Ubuntu

Версии: поддерживаются Windows 10 и 11 на процессорах x86_64 и aarch64. Для приложения в формате MSIX требуется Windows 11 версии 22H2 или новее, об этом прямо сказано в документации. Если у вас Windows 10, берите команду PowerShell.

Если сомневаетесь, ответьте на три вопроса в подборщике, он выдаст команды именно для вашей системы.

Способ 1. Приложение Hermes Desktop

1. Откройте официальный сайт Hermes Agent и скачайте пакет для Windows.
2. Откройте скачанный файл .appinstaller программой Windows App Installer. Она установит подписанный пакет и запомнит источник обновлений.
3. Запустите приложение. В пакете уже есть агент, Python и зависимости, при первом запуске ничего дополнительно собираться не будет.

Обновляется приложение кнопкой Update внутри него. Если вы поставили версию из Microsoft Store, обновления приходят через Store.

Способ 2. Команда в PowerShell

Откройте PowerShell или Windows Terminal (права администратора не нужны) и выполните:

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

Что делает скрипт: скачивает исходный код, ставит нужные программы (Python, Node.js, ripgrep, FFmpeg), создаёт команду hermes и добавляет её в пользовательский PATH. Если на компьютере нет Git, скрипт может сам скачать Git for Windows. Установка занимает несколько минут.

Полезные параметры скрипта: -Channel main (самая свежая версия вместо стабильной), -NonInteractive (без вопросов), -HermesHome и -InstallDir (свои папки), -SkipBrowser (без браузерных инструментов). Чтобы позже получить окно приложения, выполните hermes desktop.

Важно после установки: закройте окно PowerShell и откройте новое. Старые окна не видят обновлённый PATH.

Способ 3. WSL2

WSL2 это Linux внутри Windows. Откройте терминал Ubuntu и выполните команду для Linux:

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Документация объясняет, когда это оправдано: нужна среда POSIX или инструменты Linux. Данные в этом случае лежат в ~/.hermes, а автозапуск работает через systemd. Нативная установка на Windows и установка в WSL2 могут работать одновременно, у них раздельные данные.

Где лежат файлы

При установке командой PowerShell:

Что	Папка
Исходный код	%LOCALAPPDATA%\hermes\hermes-agent\
Команда hermes	%LOCALAPPDATA%\hermes\bin\
Настройки, сессии, навыки, журналы	%LOCALAPPDATA%\hermes\
Ключи API	%LOCALAPPDATA%\hermes\.env

Чтобы открыть папку, вставьте %LOCALAPPDATA%\hermes в адресную строку Проводника. Не удаляйте эту папку вручную, чтобы «починить» программу: в ней ваша память, навыки и ключи.

Как проверить установку

В новом окне PowerShell:

Get-Command hermes
hermes --version
hermes doctor

Первая команда покажет путь к программе, вторая версию, а hermes doctor проверит окружение и подскажет, чего не хватает и как это исправить. Затем выберите модель командой hermes model и запустите hermes (или hermes --tui, рекомендуемый интерфейс). Подробнее про выбор модели читайте в статье «Hermes Agent бесплатно: какие модели подключить».

Как задать свои папки для установки и данных

По умолчанию всё лежит в %LOCALAPPDATA%\hermes. Если системный диск тесный или данные нужно хранить отдельно, у скрипта установки есть параметры -HermesHome (папка данных) и -InstallDir (папка программы). Вызов с параметрами выглядит так:

& ([scriptblock]::Create((irm https://hermes-agent.nousresearch.com/install.ps1))) -NonInteractive -HermesHome D:\hermes-data

Однострочная форма iex (irm ...) параметры не принимает, поэтому для них нужна запись через scriptblock. Переменная окружения HERMES_HOME задаёт папку данных так же. Прочие параметры: -Channel stable|main (по умолчанию стабильный выпуск), -NonInteractive, -IncludeDesktop, -ShowResolvedPaths (показать, какие пути выбраны), -Verbose.

Нативная Windows или WSL2: как выбрать

В документации оба варианта описаны как рабочие, и их можно держать одновременно:

	Нативная Windows	WSL2
Где данные	%LOCALAPPDATA%\hermes	~/.hermes внутри Linux
Автозапуск шлюза	Планировщик задач Windows	systemd
Терминал в веб-панели	Через ConPTY	Через POSIX PTY
Когда выбирать	Нужна обычная работа на Windows без лишних слоёв	Нужна среда POSIX или Linux-инструменты

Автозапуск шлюза на Windows

Если вы подключили мессенджер (как это сделать), шлюз должен работать постоянно. На Windows это делают командами:

hermes gateway install
hermes gateway start
hermes gateway status

Автозапуск создаётся через планировщик задач Windows. Компьютер при этом должен быть включён: для работы круглосуточно агента лучше ставить на сервер (инструкция).

Первые 10 минут после установки

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

1. Откройте новое окно PowerShell и выполните hermes doctor.
2. Выберите провайдера и модель: hermes model (как выбрать).
3. Запустите hermes или hermes --tui и напишите простую задачу, результат которой легко проверить.
4. Убедитесь, что в шапке видны нужные модель и провайдер, ответ пришёл без ошибок и диалог идёт дальше одного хода.
5. Закройте окно и выполните hermes --continue: прошлый разговор должен вернуться.

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

Обновление и копия перед ним

hermes update --check
hermes update --backup
hermes --version

Первая команда только показывает, что будет сделано. Вторая обновляет и создаёт резервную копию перед обновлением. Опция --set-channel main переключает на самую свежую версию вместо стабильной. Приложение из пакета MSIX обновляется кнопкой Update и через Windows App Installer, версия из Microsoft Store через Store. Внутри MSIX-пакета команда hermes update Git для файлов пакета не запускает.

Что нужно знать про Windows

Для выполнения команд Hermes на Windows использует Git Bash. Если вы ставили свой Git, убедитесь, что это полный Git for Windows с Bash (урезанный MinGit его не заменяет). Другие особенности из документации:

• в старом cmd.exe для переноса строки в диалоге используйте Esc, затем Enter, а в Windows Terminal и VS Code работает Ctrl+Enter;
• на Windows с процессором ARM64 часть необязательных функций (локальное распознавание речи, движок голосовой активации) недоступна;
• адаптер Matrix с шифрованием работает только на Linux.

Типичные проблемы

• hermes не найдена. Откройте новое окно PowerShell. Если не помогло, запустите программу по полному пути: & "$env:LOCALAPPDATA\hermes\bin\hermes.exe", а затем проверьте, что папка %LOCALAPPDATA%\hermes\bin есть в PATH.
• Установка прервалась. Скрипт выводит команду для повтора и путь к журналу logs\install.log в папке данных. Последние строки журнала покажут причину.
• Антивирус ругается. Если защита блокирует файл установки, не добавляйте в исключения всю папку. Сначала разберитесь, какой именно файл заблокирован, и проверьте его источник.
• Не работает команда в старом окне. Это обычный случай с PATH, см. выше.

Что делать дальше

Когда обычный диалог в терминале работает, подключайте остальное: мессенджер, расписание, навыки. Порядок такой же, как в разделе быстрого старта документации: сначала базовый чат, потом дополнительные функции. Список команд на каждый день собран в нашей шпаргалке на 18 команд (форма на этой странице). Если хотите поставить агента на сервер, чтобы он работал круглосуточно, читайте «Hermes Agent на VPS в Docker», а про подключение к Telegram «Hermes Agent в Telegram». Если программа больше не нужна, как удалить Hermes Agent полностью.

Частые вопросы

Нужны ли права администратора? Для установки командой PowerShell нет. Скрипт ставит всё в вашу пользовательскую папку.

Работает ли Hermes Agent на Windows 10? Да, командой PowerShell. Приложение в формате MSIX требует Windows 11 версии 22H2 или новее.

Нужен ли WSL2? Нет. Нативная установка работает без него. WSL2 нужен, только если вы хотите среду Linux.

Сколько стоит программа? Программа бесплатна (лицензия MIT). Платить придётся за модель, если вы выберете платного провайдера.

Как обновить? Для установки из скрипта выполните hermes update. Приложение обновляется кнопкой Update, версия из Store через Store.

Источники и дата проверки

Данные проверены 22 октября 2026 года. Программа быстро развивается, поэтому перед установкой сверьтесь с первоисточниками:

• Hermes Agent: официальный сайт
• Документация: установка
• Документация: Hermes на Windows
• Документация: поддерживаемые платформы
• Документация: быстрый старт
• Документация: обновление и удаление

Материал независимый: учебный центр «Альма Матер» не связан с разработчиками упомянутых программ и сервисов. Названия принадлежат их владельцам.