Hermes Agent на Windows через WSL2: пошаговая установка 2026

Нативная поддержка Windows в Hermes Agent пока в бета-статусе и работает нестабильно. Стабильный путь — WSL2 (Windows Subsystem for Linux). Устанавливаете Ubuntu внутри Windows, запускаете один curl-скрипт, настраиваете модель через hermes setup — и агент готов.

Ниже пошаговая инструкция с точными командами, разбором типичных ошибок и объяснением, почему на каждом шаге делается именно так.

Что такое WSL2 и зачем он нужен для Hermes

Hermes Agent разработан под Unix-окружение. На Linux или macOS он запускается одной командой, на Windows — нет: агент просто не найдет нужное окружение.

WSL2 решает это без разделения диска и без dual boot. Вы получаете полноценное Ubuntu внутри Windows: со своей файловой системой, терминалом и пакетным менеджером. При этом Windows никуда не девается — два окружения живут параллельно.

Архитектурно WSL2 — это легкая виртуальная машина с настоящим Linux-ядром, а не эмулятор. Hermes не знает разницы между «настоящим» Ubuntu и WSL2-Ubuntu, поэтому работает так же, как на нативном Linux.

Лиза: «Прикинь, первый раз ставила Hermes через WSL2 — показалось сложно. Но на деле это три команды в PowerShell и один curl. Потом настроила OpenRouter с бесплатной моделью, и агент заработал. Всё заняло минут 20, не больше.»

Что нужно перед установкой

Проверьте три вещи до того, как открывать терминал:

Операционная система. WSL2 работает на Windows 10 (версия 2004 и новее) и Windows 11. Если у вас старше — сначала обновите Windows через Settings -> Windows Update.

Права администратора. PowerShell нужно запускать именно с правами администратора. Без них команда wsl --install просто не выполнится.

API-ключ провайдера. Заранее получите ключ хотя бы от одного провайдера. Бесплатные варианты: OpenRouter (дает доступ к нескольким моделям без оплаты), Nvidia NIM (модель MiniMax M 2.7 полностью бесплатно, ключ по адресу build.nvidia.com). Hermes требует модель с контекстным окном минимум 64k токенов: меньше — агент будет терять данные на многошаговых задачах.

Шаг 1. Устанавливаем WSL2 и Ubuntu

Откройте меню «Пуск», найдите PowerShell, кликните правой кнопкой мыши и выберите «Запуск от имени администратора». Это критично — без прав администратора WSL не установится.

В терминале выполните:

wsl --install

Эта команда делает всё за вас: включает необходимые компоненты Windows, скачивает и устанавливает Ubuntu как дистрибутив по умолчанию.

Когда установка завершится, возможно появится сообщение с просьбой перезагрузить компьютер. Перезагружайте — без этого WSL2 может не активироваться полностью.

После перезагрузки откройте PowerShell снова и проверьте версию:

wsl -l -v

В выводе найдите строку с Ubuntu. В колонке VERSION должна стоять 2. Если там 1 — выполните:

wsl --set-version Ubuntu 2

Hermes использует возможности, которые появились только в WSL2. WSL1 не подойдет.

Шаг 2. Базовая настройка Ubuntu

После установки запустите Ubuntu из меню «Пуск» — либо найдите «Ubuntu» в поиске. Первый запуск попросит создать имя пользователя и пароль для Linux-окружения.

Важный нюанс: когда вводите пароль в Ubuntu-терминале, символы на экране не отображаются. Никаких звездочек, никаких точек. Это нормальное поведение безопасности Linux. Просто вводите пароль и нажимайте Enter.

Обновите пакеты:

sudo apt update && sudo apt upgrade -y

Если спросит пароль — это тот, что вы только что создали. После обновления проверьте наличие curl (нужен для скачивания установщика Hermes):

curl --version

Если команда вернула версию — всё готово. Если command not found:

sudo apt install curl -y

Шаг 3. Устанавливаем Hermes Agent

Убедитесь, что вы в Ubuntu-терминале, а не в PowerShell. Это важно: установщик не запустится из Windows-терминала, только из Ubuntu.

Перейдите на официальный сайт Nous Research (agent.nousresearch.com) и скопируйте однострочную команду установки. Она начинается с curl и указывает на репозиторий Hermes.

Вставьте команду в Ubuntu-терминал и нажмите Enter:

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

Установщик автоматически подтянет все зависимости: Python, Node.js, UV package manager и остальное. На медленном соединении это может занять 30-60 минут — иногда процесс выглядит как зависание, но на деле что-то продолжает устанавливаться. Не прерывайте.

Когда установка завершится и вы снова увидите приглашение командной строки, выполните:

source ~/.bashrc

Это критичный шаг, который часто пропускают. Без него Ubuntu не знает о новой команде hermes, и вы получите ошибку command not found. source ~/.bashrc перезагружает конфигурацию оболочки и сразу делает команду доступной.

Проверьте:

hermes --version

Если вернулся номер версии — установка прошла успешно.

Шаг 4. Настройка модели через hermes setup

Запустите мастер настройки:

hermes setup

Появится два варианта: Quick Setup и Full Setup.

Quick Setup — выбираете провайдера и вводите API-ключ. Подходит для быстрого старта. Full Setup — настраиваете всё детально: модель, шлюзы мессенджеров, рабочие каталоги. Если планируете использовать Hermes серьезно, сразу берите Full Setup.

Выбор провайдера

После выбора режима появится список провайдеров. Навигация — стрелками. Самые популярные варианты:

• OpenRouter — агрегатор, один ключ дает доступ к сотням моделей. Есть бесплатный тир, но лимиты на запросы. Хорошо для теста.
• Nvidia NIM — полностью бесплатно для MiniMax M 2.7. Ключ получаете на build.nvidia.com за 2 минуты (email + верификация).
• Anthropic — Claude Sonnet 4.6 или Opus 4.7. Платно, но качество заметно выше для сложных задач.

Вставьте API-ключ, когда система попросит. На экране он тоже не отображается — это снова нормальная защита.

Выбор модели

Hermes требует модель с контекстным окном минимум 64k токенов. Это не пожелание — без этого агент будет обрезать данные на длинных задачах и давать некорректные результаты.

Если используете OpenRouter с бесплатными моделями, введите имя модели точно как указано в интерфейсе OpenRouter: например, deepseek/deepseek-chat-v3-0324:free.

Настройка мессенджеров

На этом шаге можно подключить Telegram, Discord, Slack или другие шлюзы — чтобы управлять агентом с телефона. Для первого запуска выберите «Skip» или введите 2. Мессенджеры легко настроить позже через hermes gateway.

Шаг 5. Первый запуск и проверка

Запустите чат с агентом:

hermes

Вы увидите большой ASCII-логотип и статусную строку внизу: активный профиль, используемая модель, количество загруженных навыков. Если строка показывает модель — соединение установлено.

Сначала проверьте базовый ответ простым сообщением:

hi hermes

Если ответил нормально — добавляйте сложные задачи. Не спешите с настройкой мессенджеров и cron-задач до получения чистого ответа.

Попробуйте что-то с инструментами:

what files are in my current directory and what is this folder for

Hermes напишет команду, выполнит её в терминале и вернет читаемый ответ. Если видите в логах, что агент сам вызывает инструменты — всё работает правильно.

Шаг 6. Финальная диагностика

Выйдите из чата (Ctrl+C) и запустите проверку системы:

hermes doctor

Эта команда проверяет git-окружение, API-ключи, доступность инструментов и конфигурацию. Вы хотите видеть зеленые OK напротив ключевых пунктов. Если что-то красное — команда покажет, что именно нужно исправить.

Типичные ошибки и как их решать

hermes: command not found после установки

Вы пропустили source ~/.bashrc. Выполните:

source ~/.bashrc

Или просто закройте Ubuntu-терминал и откройте заново — новая сессия загружает конфигурацию автоматически.

API call failed after 3 retries

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

Попробуйте переключиться на другую модель:

hermes model

Откроется то же меню, что при настройке. Некоторые бесплатные модели ограничены по числу запросов в час. Если хотите стабильность без перебоев — положите на OpenRouter $5-10: этого хватит на несколько месяцев активного использования.

API-ключ не сохраняется или не работает

Иногда ключ вводится, но не прописывается в конфиг. Проверьте вручную:

hermes config

Команда покажет путь к файлу конфигурации. Открыть его можно через nano:

nano ~/.config/hermes/.env

Найдите строку с вашим провайдером (например, OPENROUTER_API_KEY=). Если после знака равенства пусто — вставьте ключ вручную, сохраните через Ctrl+O, подтвердите Enter, выйдите через Ctrl+X.

Установка «зависает» на полпути

Это не баг — это нормальное поведение на медленном соединении или при установке тяжелых зависимостей. Подождите 30-60 минут, не прерывайте процесс. Если всё-таки ничего не происходит дольше часа — попробуйте нажать любую клавишу: иногда установщик ждет скрытого подтверждения.

Модель отвечает с ошибками или обрезает задачи

Модель не соответствует требованию 64k токенов. Смените модель через hermes model на ту, у которой контекст 64k+. В OpenRouter это видно в карточке модели.

Таблица решений по типичным проблемам

Нативная Windows-установка: когда это вариант

Avec мая 2026 существует экспериментальная нативная установка Hermes без WSL. Запускается прямо из PowerShell-администратора. Если при установке видите ошибку Python — скачайте Python 3.11.9 с python.org и при установке обязательно отметьте «Add to PATH».

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

Если хотите, чтобы Hermes работал круглосуточно — смотрите в сторону VPS с Ubuntu. Там нет WSL, там сразу Linux, и агент живет независимо от вашего компьютера.

Установка навыков после базовой настройки

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

hermes skills browse

Установить конкретный навык:

hermes skills install duckduckgo-search

Навыки работают не со всеми моделями одинаково. Если навык падает с ошибкой на бесплатной модели — переключитесь на более качественную через hermes model и попробуйте снова. Большинство навыков хорошо работают с Claude Sonnet 4.6, GPT-5.4 mini и DeepSeek V3.2.

Полный каталог инструментов для работы с агентами — в разделе каталога AI-инструментов. Там же обзоры Claude Code, Cursor и Windsurf — если хотите сравнить подходы.

FAQ

Нужен ли мощный компьютер для Hermes через WSL2? Нет. Hermes работает как клиент: вычисления идут на серверах AI-провайдера. Для самого агента хватит 4 GB RAM и любого процессора. Требования к железу появляются только если хотите запускать модели локально (Gemma 4, DeepSeek через Ollama).

Можно ли установить Hermes без интернета? Нет. Для установки нужен интернет, для работы — тоже (запросы идут к API провайдера). Исключение: если настроите локальную модель через Ollama, она работает оффлайн.

Какую модель выбрать для старта, чтобы не платить? Nvidia NIM с MiniMax M 2.7 — полностью бесплатно, контекст 1M токенов. Регистрация на build.nvidia.com, ключ получаете сразу. Второй вариант — OpenRouter с бесплатным тиром, но там лимиты на запросы.

Где хранятся данные Hermes на Windows? В файловой системе WSL2, в домашней папке Ubuntu: ~/.config/hermes/ и ~/.local/share/hermes/. Из Windows эти файлы доступны через \\wsl$\Ubuntu\home\[username]\.

Как обновить Hermes до новой версии? Через ту же установочную команду с ключом обновления, или через hermes update если команда доступна в вашей версии. Следите за репозиторием на GitHub (nousresearch/hermes-agent).

Что делать, если hermes doctor показывает ошибки? Читайте что именно красное. Если API-ключ — проверьте через nano ~/.config/hermes/.env. Если git — установите через sudo apt install git -y. Если проблема с Python — убедитесь, что установщик завершился без ошибок.

Можно ли использовать Hermes с несколькими API-ключами одновременно? Да. В Full Setup можно подключить несколько провайдеров и переключаться между ними на уровне профилей или прямо в чате.

Глоссарий

WSL2 (Windows Subsystem for Linux 2) — встроенная технология Windows для запуска полноценного Linux-окружения. Работает на уровне легкой виртуальной машины с настоящим Linux-ядром.

Ubuntu — один из самых популярных дистрибутивов Linux. Hermes использует его как базовую среду для Windows.

hermes setup — команда запуска мастера настройки Hermes. Здесь выбирается провайдер модели, вводится API-ключ и настраиваются шлюзы.

hermes doctor — команда диагностики. Проверяет, все ли компоненты установлены и сконфигурированы корректно.

source ~/.bashrc — команда перезагрузки конфигурации оболочки. Нужна после установки, чтобы новая команда hermes стала доступна без перезапуска терминала.

OpenRouter — агрегатор API для множества AI-моделей. Один ключ — доступ к сотням моделей от разных провайдеров.

Контекстное окно (context window) — максимальный объем данных, который модель держит в «памяти» за один разговор. Hermes требует минимум 64k токенов из-за многошагового планирования.

Gateway (шлюз) — интеграция Hermes с мессенджерами. Настраивается через hermes gateway, после чего управлять агентом можно из Telegram, Slack, Discord или WhatsApp.

hermes skills install — команда установки дополнительного навыка. Навыки расширяют возможности агента: поиск, работа с файлами, генерация медиа и другое.

Если после прохождения гайда возникли вопросы по конкретной ошибке или хотите разобраться, как использовать Hermes под свои задачи, запишитесь на консультацию к Максиму. Разберем ваш кейс конкретно.

Другие инструменты вайбкодинга — в каталоге AI-инструментов VibeCoderz.

Обновлено: май 2026