Установка Hermes AI на Windows: Desktop, PowerShell и WSL2

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

Выбор пути установки: нативная среда или WSL2

Перед установкой важно определить контекст выполнения задач:

• Нативный PowerShell и Hermes Desktop используют общую структуру данных: исходный код и виртуальное окружение размещаются в каталоге %LOCALAPPDATA%\hermes\hermes-agent, а пользовательские настройки, история сессий и навыки — в %LOCALAPPDATA%\hermes. Графический клиент и консольный интерфейс взаимозаменяемы и работают с одним состоянием.
• WSL2 изолирует окружение внутри виртуальной машины Linux и хранит конфигурацию отдельно в ~/.hermes.

Примеры выбора архитектуры

1. Проект под Windows (PowerShell / .NET / системные утилиты): если вы автоматизируете рабочие процессы на хосте, запускаете фоновые шлюзы для Telegram или Discord через планировщик задач Windows и работаете с локальными файлами на диске NTFS, выбирайте нативный PowerShell или Hermes Desktop.
2. Проект с Linux-стеком (Docker, Make, POSIX-скрипты): если агент должен компилировать код под Linux, работать с сокетами UNIX или управлять сессиями через встроенный терминал веб-дашборда, развертывайте агент в WSL2. В нативной сборке Windows веб-дашборд поддерживает метрики и конфигурацию, но вкладка встроенного терминала /chat требует POSIX PTY и доступна только в WSL2.

---

Вариант 1: Нативная установка через PowerShell

Нативный установщик не требует прав администратора и автоматически настраивает менеджер uv, изолированный Python 3.11, Node.js для браузерных инструментов и PortableGit. Самостоятельно устанавливать глобальный Python в систему не требуется.

Откройте стандартную консоль PowerShell и выполните команду:

iex (irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1)

Скрипт добавляет путь %LOCALAPPDATA%\hermes\bin в переменную среды PATH текущего пользователя. После завершения закройте окно консоли и откройте новый терминал, чтобы применить обновленный PATH. Подробные параметры скрипта описаны в официальном руководстве по Windows Native.

---

Вариант 2: Графический клиент Hermes Desktop

Hermes Desktop предоставляет оконный интерфейс с боковой панелью сессий, визуальным графом навыков, поддержкой вкладок и управлением параллельными агентами.

1. Загрузите установщик со страницы документации Hermes Desktop.
2. Запустите установленный файл. При первом открытии приложение автоматически запустит сценарий настройки зависимостей в директории %LOCALAPPDATA%\hermes.

Если вы уже настроили агент через PowerShell, десктопное приложение сразу подхватит существующие ключи API и сохраненные диалоги.

---

Вариант 3: Установка внутри WSL2

WSL2 предоставляет стандартную среду Linux (ext4, POSIX-сигналы, поддержка PTY).

Шаг 1. Подготовка WSL2

В консоли PowerShell с правами администратора выполните:

wsl --install

Перезагрузите компьютер по требованию системы, задайте имя пользователя Linux и пароль. Затем проверьте версию дистрибутива:

wsl --list --verbose

В столбце VERSION для выбранного дистрибутива (по умолчанию Ubuntu) должно быть указано значение 2.

Шаг 2. Развертывание Hermes Agent

Откройте терминал Ubuntu и запустите команду согласно руководству по быстрому старту WSL2:

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

Важно: храните рабочие репозитории и файлы проектов внутри файловой системы Linux (например, ~/projects/), а не на смонтированном диске Windows (/mnt/c/). Перекрестные вызовы через протокол 9P могут быть медленнее при операциях ввода-вывода и работе git.

---

Проверка среды и первый запуск

Диагностика и запуск выполняются в терминале соответствующего окружения: для нативной установки и Hermes Desktop используйте PowerShell, а для WSL2 — терминал Ubuntu.

Для нативной установки и Hermes Desktop откройте новую сессию PowerShell и выполните проверку:

Get-Command hermes
hermes --version
hermes doctor

Для установки в WSL2 откройте терминал Ubuntu и выполните диагностику:

command -v hermes
hermes --version
hermes doctor

Команда hermes doctor анализирует корректность путей к git, браузерному движку Chromium и вспомогательным библиотекам.

Перед запуском чата необходимо настроить провайдера: если он еще не сконфигурирован, сначала выполните команду hermes setup и выберите провайдера модели (в окне PowerShell для нативной среды или в терминале Ubuntu для WSL2).

После настройки запустите обычный диалог в соответствующем терминале и запросите задачу, не требующую записи файлов; hermes chat не включает изоляцию прав доступа:

hermes chat

В качестве первого запроса передайте инструкцию, не требующую записи на диск (например, объяснение архитектурного термина). Ожидаемый результат — корректная инициализация настроенного провайдера модели и потоковый вывод текста без ошибок кодировки.

Для опциональной настройки отдельных моделей обратитесь к документации BetterToken.

---

Устранение частых неполадок

Наблюдаемый симптом	Причина	Способ решения
hermes: The term 'hermes' is not recognized	Текущая сессия консоли не перечитала обновленный User PATH.	Перезапустите окно PowerShell или вызовите бинарный файл напрямую: & "$env:LOCALAPPDATA\hermes\bin\hermes.exe".
Вкладка /chat в веб-дашборде показывает баннер с ошибкой	Нативная Windows не имеет системного механизма POSIX PTY.	Управление сессиями и задачами работает нативно, но для веб-терминала в /chat запускайте агент через WSL2.
WinError 193: %1 is not a valid Win32 application	Попытка вызвать скрипт напрямую в обход обертки .cmd.	На Windows запускайте Node- и npm-инструменты с явным указанием расширения (например, npx.cmd).
Вопросительные знаки (?) вместо символов Unicode в CLI	Устаревший хост консоли без поддержки CP 65001.	Используйте Windows Terminal. Убедитесь, что переменная среды HERMES_DISABLE_WINDOWS_UTF8 не установлена в 1.
Высокая задержка при вызове git status внутри WSL2	Рабочий каталог проекта находится по пути /mnt/c/....	Перенесите рабочий репозиторий в домашнюю директорию дистрибутива (~/code/...), чтобы задействовать нативный диск ext4.