Hermes Agent - установка на Windows через WSL2 и Web UI

Hermes Agent не поддерживает Windows нативно. Но 90% людей сидят на Windows - и это не повод оставаться без агента. Всё работает через WSL2.

Что такое WSL2

WSL2 (Windows Subsystem for Linux) - полноценный Linux внутри Windows. Запускается как приложение, не требует виртуалки, не тормозит. Ubuntu 22.04, общий доступ к файлам C:, порты наружу пробрасываются автоматически.

Шаг 1. Включаем WSL2

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

`wsl --install`

Установится Ubuntu 22.04. Перезагрузите ПК. После перезагрузки задайте имя пользователя и пароль.

Важно: включите systemd. Откройте файл /etc/wsl.conf:

`sudo nano /etc/wsl.conf
[boot]
systemd=true`

Перезапустите WSL (в PowerShell):

`wsl --shutdown`

Заново откройте терминал WSL и проверьте:

`ps -p 1 -o comm=
# systemd`

Шаг 2. Установка Hermes Agent

В терминале WSL выполняем установку:

`curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash`

После установки перезагружаем shell:

`source ~/.bashrc
hermes model`

Шаг 3. Запускаем API Server (Web UI)

Hermes имеет встроенный OpenAI-совместимый API. Добавляем в .env:

`API_SERVER_ENABLED=true
API_SERVER_KEY=change-me-local-dev`

Запускаем gateway:

`hermes gateway`

API доступен на http://localhost:8642. Из Windows открывается как localhost.

Вариант: Hermes WebUI

Популярная community-оболочка. Трёхпанельный интерфейс: сессии, чат, файлы.

`git clone https://github.com/nesquena/hermes-webui.git
cd hermes-webui
pip install -r requirements.txt
python app.py`

Открыть http://localhost:3000 в браузере на Windows.

Частые проблемы

systemd not available - правьте /etc/wsl.conf, добавьте [boot] systemd=true, затем wsl --shutdown

gateway install не работает - используйте foreground: hermes gateway. Или tmux.

Браузер из WSL - Chrome на Windows с --remote-debugging-port=9222

Установка зависает - возможно проблема с ollama, пропустите её в установщике.

Итог

Вся схема занимает 15 минут. WSL2 + Hermes + API Server дают полноценного агента на Windows с доступом через браузер.

---

🌐 hermes-agent.ru - сайт проекта

Застряли на установке? Напишите в контакты на сайте - поможем.