VibeCoderzVibeCoderz
Все статьи
Агенты и CLI2026/05/139 мин чтения

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

УстановитеHermes Agent на Windows, используя WSL2: один curl‑скрипт, настройка через hermes setup и готовый к работе агент, без проблем с нативной поддержкой.

Содержание (13)+

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

Изображение

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


Что такое 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 токенов: меньше — агент будет терять данные на многошаговых задачах.

Мастер сделает это за вас. Не хотите разбираться с ключами, настройками Windows и командами: Hermes Start проведет по девяти шагам, поставит проверенную версию Hermes и подключит Telegram. Ключ ИИ-модели вы получаете сами, а способы оплаты модели меняются, поэтому актуальные проверяйте на сайте модели на дату покупки.

Изображение
ПровайдерЦенаМодельКонтекст
OpenRouter (бесплатный тир)$0DeepSeek V3, Llama 4 и др.64k+
Nvidia NIM$0 (ключ бесплатно)MiniMax M 2.71M токенов
OpenRouter (платный)от $0.28/M токеновDeepSeek V3.264k+
Anthropic$3/M (input)Claude Sonnet 4.6200k
Изображение

Шаг 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 минут — иногда процесс выглядит как зависание, но на деле что-то продолжает устанавливаться. Не прерывайте.

В Hermes Start установка проверенной версии Hermes идет одним из шагов программы. На компьютере она занимает 10-30 минут, при медленном интернете до часа, а любой шаг можно прервать и продолжить позже с того же места. Человеку остается подтверждать шаги и ответить на короткую анкету о себе.

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

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 руками бесплатно, но нужны терминал и час-полтора времени. Hermes Start делает то же самое примерно за 30 минут и дальше остается пультом: показывает, все ли работает и сколько осталось на счете модели.


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

Изображение

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 это видно в карточке модели.


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

ПроблемаПричинаКоманда/Решение
hermes: command not foundНе перезагружен .bashrcsource ~/.bashrc
API call failed after 3 retriesЛимиты модели или несовместимостьhermes model -> сменить модель
API-ключ не работаетНе сохранился в конфигnano ~/.config/hermes/.env
Установка зависла на 30+ минМедленное соединение / скрытый запросЖдать, или нажать любую клавишу
Агент обрезает задачиМодель с контекстом меньше 64kСменить на модель с 64k+
WSL версия 1 вместо 2Устаревшая конфигурацияwsl --set-version Ubuntu 2

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

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

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

МетодСтабильностьСложностьПодходит для
WSL2 + UbuntuВысокаяСредняяПостоянное использование
Нативный Windows (бета)НизкаяНизкаяБыстрый тест, не для продакшна
VPS (Ubuntu)ВысокаяСредняя24/7 работа без зависимости от ПК

Если хотите, чтобы 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 — если хотите сравнить подходы.

Три причины завести такого помощника

Первая причина: помощнику подходит любая нейросеть. Больше 20 поставщиков: от DeepSeek и Gemini до YandexGPT, GigaChat и локальных моделей через Ollama и LM Studio. Если бесплатная модель уперлась в лимит запросов, вы переключаетесь на другую за минуту, а память и навыки остаются прежними.

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

Третья причина: подключение сервисов без программирования. По данным Composio, сервисов больше полутора тысяч: Google Документы и Таблицы, Notion, GitHub, Slack, календари. Вы пишете «подключи Gmail», входите в аккаунт, и дальше помощник сам заполняет таблицу, правит документ или заводит задачу.


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 можно подключить несколько провайдеров и переключаться между ними на уровне профилей или прямо в чате.

Чем Hermes Start отличается от самого Hermes? Hermes, бесплатный открытый помощник команды Nous Research, можно поставить самому через терминал. Hermes Start, программа для Mac и Windows, делает установку за человека: ставит Hermes, подключает Telegram и доводит до первой выполненной задачи примерно за 30 минут.



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

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


Обновлено: октябрь 2026

Автор

Елисавета Наговицына

Предприниматель · Контент-маркетолог · SEO-стратег · AI-продуктолог

2026/05/13

400 000+ органических переходов за 3 месяца. Со-основатель GoBanana (231K пользователей, 12+ млн ₽ без рекламы) и NeuroScribe (65K пользователей). SEO/GEO-стратегии для AI-поисковиков, 1 700+ единиц контента, 17+ реализованных стратегий.

Об авторе →
All Posts

Инструменты, упомянутые в статье

Читать далее

📄 Статья

Hermes Agent: полный список CLI-команд и шпаргалка по использованию 2026

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

2026/05/158 мин
📄 Статья

Какие модели работают с Hermes Agent: OpenRouter, Ollama, LM Studio и свой endpoint

Hermes Agent легко переключается между OpenRouter, Anthropic, OpenAI, Nvidia, Ollama, LM Studio и любыми OpenAI‑совместимыми endpoint, позволяя подобрать идеальный «мозг» под задачу без лишних настроек.

2026/05/159 мин
📄 Статья

Hermes Agent бесплатно: сколько реально стоит запустить и что входит в MIT-лицензию

Hermes Agent в MIT‑лицензии полностью бесплатен, но запуск требует учёта стоимости модели, инфраструктуры и опционального портала; в статье показаны пять реальных конфигураций от нуля до продвинутого.

2026/05/159 мин
📄 Статья

ИИ-агент для автоматизации задач: как Hermes Agent делает работу за вас

ИИ‑агент Hermes умеет самостоятельно планировать и выполнять задачи, используя браузер, терминал и API, и сам корректирует ошибки, экономя ваше время. В статье показаны пять практических сценариев, где он действительно повышает продуктивность.

2026/05/159 мин
📄 Статья

Оживить фото нейросетью как работает image to video в 2026

Оживить фото нейросетью сегодня можно за пять минут: загружаешь одну картинку, пишешь пару строк промта и получаешь готовый видеоролик с движением камеры или анимацией объекта. Технология называется image to video, работает на диффузионных моделях вр…

2026/09/2510 мин
📄 Статья

Qwen3.7 Max и MiniMax M3 как альтернатива Claude за 1/6 цены

Новые модели Qwen3.7 Max и MiniMax M3 из Китая почти догоняют Claude Opus по качеству кода, но стоят в 4‑16 раз дешевле, что делает их привлекательной альтернативой для разработчиков.

2026/06/1812 мин