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

Nous Research выпустила Hermes Agent, бесплатный ИИ-агент под лицензией MIT. Он живёт в терминале и в мессенджерах, помнит прошлые сессии, запускает субагентов и выполняет команды на компьютере. На Windows работает нативно, без WSL и Docker.

64-bit: x86_64 или ARM64. Установщик ≈ 8 МБ. Без прав администратора. Windows значится первым уровнем поддержки.

Коротко

Скачать Hermes-Setup.exe с официального сайта.
Запустить и дождаться, пока докачаются компоненты.
Пройти мастер настройки: проще всего Nous Portal, тариф Free.
В новом окне PowerShell проверить hermes doctor.

Что нужно заранее

Windows 10 или 11, 64-bit (x86_64 или ARM64).
Интернет. Установщик весит около 8 МБ, остальное (Python, Node.js, портативный Git, ffmpeg) докачивается при первом запуске.
Права администратора не нужны, всё ставится в папку пользователя.
Аккаунт для модели. Проще всего Nous Portal, у него есть бесплатный тариф. Подойдут и свои ключи: OpenRouter, OpenAI, DeepSeek, Kimi и другие.

Шаг 1. Скачать установщик

Официальная страница: hermes-agent.nousresearch.com. В блоке «Hermes Desktop App» нажмите «Download desktop app» под надписью Windows 10/11. Файл называется Hermes-Setup.exe.

Прямая ссылка на ту же сборку: hermes-assets.nousresearch.com/Hermes-Setup.exe

Официально поддерживается только этот установщик: способы через pip, brew или архивы с форумов не поддерживаются.

Шаг 2. Запустить файл

Двойной клик по Hermes-Setup.exe. Если Windows покажет окно SmartScreen о неизвестном издателе, нажмите «Подробнее», затем «Выполнить в любом случае».

Сам установщик маленький: при первом запуске он вызывает официальный скрипт install.ps1, и тот ставит всё остальное:

uv и Python 3.11;
Node.js 26 для браузерного инструмента и WhatsApp-моста;
портативный Git с bash.exe (около 45 МБ), через него Hermes выполняет команды; если Git уже стоит, установщик возьмёт системный;
ripgrep и ffmpeg;
код Hermes в папку %LOCALAPPDATA%\hermes\hermes-agent.

Команда hermes появится в PATH.

Не закрывайте окно установщика, пока идёт загрузка компонентов. Дождитесь сообщения о завершении.

Шаг 3. Пройти мастер настройки

После установки запускается мастер hermes setup. Три варианта.

Quick Setup (Nous Portal)

Для начала. Вход через браузер по OAuth, ключи вводить не нужно. Одна подписка даёт модель и четыре инструмента: веб-поиск, генерацию картинок, озвучку и облачный браузер.

Free $0 (только бесплатные модели), Plus $20, Super $100, Ultra $200 в месяц. Для знакомства хватит Free.

Full Setup

Свои ключи: OpenRouter, OpenAI (включая подписку ChatGPT или Codex через вход по коду устройства), DeepSeek, Kimi, Google AI Studio, xAI, локальные модели через LM Studio или Ollama.

Модели нужен контекст от 64 000 токенов, иначе Hermes её не примет.

Blank Slate

Вручную. Всё выключено, кроме модели, файлов и терминала. Для тех, кто хочет включать инструменты сам.

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

hermes setup --portal   # Nous Portal
hermes model            # выбор провайдера

Про подписку Claude. По документации Anthropic подключается по API-ключу либо по OAuth на плане Max с extra usage credits. В чате вайбкодеров 22.09 предупреждали, что за вход по OAuth-токену подписки в Hermes прилетали баны, а официальный плагин Claude Subscription DirectSDK помечен как экспериментальный. Для первого запуска безопаснее Nous Portal или OpenRouter.

Шаг 4. Проверить, что работает

Закройте старые окна PowerShell и откройте новое: PATH обновляется только в новых окнах. Затем:

hermes --version
hermes doctor
hermes --tui

hermes doctor покажет, чего не хватает, и подскажет команду для исправления. hermes --tui открывает интерфейс с мышью и автодополнением команд через слэш; классический режим запускается командой hermes.

Первое сообщение возьмите проверяемое, например: «Посмотри мою текущую папку и скажи, какой файл здесь главный». Если агент ответил и смог прочитать файлы, установка прошла успешно.

Продолжить последний разговор: hermes -c. Новая строка внутри сообщения: Ctrl+Enter в Windows Terminal.

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

C:\Users\<имя>\AppData\Local\hermes\
├─ hermes-agent\   код; можно удалять и ставить заново
├─ git\            портативный Git
├─ node\           портативный Node.js
├─ bin\            hermes.exe, uv.exe
├─ .env            секреты и ключи
├─ config.yaml     обычные настройки
└─ …               навыки и история сессий

Настройки, ключи, навыки и история лежат прямо в корне папки hermes и переживают переустановку. Править их удобнее командой hermes config set: значения она разложит по нужным файлам сама.

Что дальше

Задача	Команда
Бот в Telegram, Discord, Slack или WhatsApp	`hermes gateway setup`, затем `hermes gateway start`
Автозапуск шлюза при входе в Windows	`hermes gateway install` (через планировщик задач, без прав администратора)
Состояние шлюза	`hermes gateway status`
Обновление	`hermes update`
Удаление	`hermes uninstall`

hermes uninstall стирает код и убирает команду из PATH, данные остаются. Для полного удаления сотрите папку AppData\Local\hermes.

Если что-то пошло не так

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

Откройте новое окно PowerShell. До этого работает полный путь:

& "$env:LOCALAPPDATA\hermes\bin\hermes.exe"

Антивирус удалил uv.exe из папки hermes\bin

Это ложное срабатывание Windows Defender или Bitdefender: Hermes использует менеджер пакетов Python uv для обновлений. Добавьте папку в исключения. Для Defender в PowerShell от администратора:

Add-MpPreference -ExclusionPath "$env:LOCALAPPDATA\hermes\bin"

Исключение ставьте на папку, а не на файл: при каждом обновлении хэш файла меняется.

Русские буквы отображаются знаками «?»

Используйте Windows Terminal вместо старого cmd.exe. На Windows 11 он установлен по умолчанию.

Браузерный инструмент запускается, но зависает

При первом запуске докачивается Chromium. Если загрузка сорвалась, hermes doctor покажет команду для повторной установки.

Не работает вкладка терминала /chat в веб-дашборде

Это единственное, что не работает нативно: вкладке нужен POSIX PTY. Остальной дашборд, CLI, TUI, шлюз, cron, браузер и MCP работают. Если вкладка нужна, поставьте Hermes ещё и в WSL2. Обе установки живут рядом и не мешают друг другу.

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

Запасной путь без графического установщика

Откройте PowerShell и выполните одну команду. Она делает то же самое, что установщик:

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

Захотите потом графическое приложение: hermes desktop.

Если нужен агент под задачи бизнеса

Hermes закрывает личные задачи: почитать код, разобрать папку, ответить в мессенджере. Рабочие сценарии сложнее: приём заявок, ответы клиентам, выгрузка в CRM, отчёты. Такие контуры мы собираем и поддерживаем сами, подробности на странице ИИ-ассистенты для бизнеса. Опишите задачу в форме на странице контактов: созвон 30 минут бесплатный, скажем честно, решается ли она и сколько стоит.

Источники

hermes-agent.nousresearch.com (главная, Installation, Platform Support, Quickstart, Windows Native Guide), README репозитория github.com/NousResearch/hermes-agent.

Проверено 23.09.2026: сервер отдаёт Hermes-Setup.exe размером 7,9 МБ, файл датирован 10.08.2026.