Чтобы установить Hermes Agent, возьмите пакет или команду с официального сайта, затем подключите доступную вам нейросеть через hermes model. Открывшееся окно ещё не результат: модель должна ответить, а агент - создать файл, который вы откроете сами.
Проверим программу, ответ нейросети и работу инструмента по порядку, чтобы при ошибке знать, куда вернуться.
Теперь давайте его установим. Покажу, где он будет работать, как его запустить и подключить к нему нейросеть.
Что подготовить: компьютер и доступ к нейросети
Начните со своего компьютера. Сервер нужен, если агент должен работать 24/7, а вы не хотите держать компьютер включённым. Выберите 1 способ установки из таблицы.
| Среда | Первый способ | Что учитывать |
|---|---|---|
| Windows | Desktop-пакет | Консольная альтернатива - PowerShell |
| macOS Apple Silicon | DMG | Есть консольный вариант; Intel macOS не поддерживается |
| Linux | Консольный установщик | Нужны зависимости для установки из исходников |
| Уже используемый WSL2 | Установщик внутри WSL2 | Команду выполняйте в оболочке WSL2 |
Desktop-пакет содержит Python и зависимости. Отдельно ставить Python или Node.js перед ним не нужно. Для установки из исходников на Linux, macOS или WSL2 нужны Git, curl, tar и утилиты SHA-256. Установщик сам подбирает Python 3.14.
Подготовьте свой API-ключ или учётную запись для входа к провайдеру. Проверьте, доступна ли вам выбранная модель и на каких условиях. Установка Hermes доступа к платной нейросети не даёт.
Для подключения по своему адресу API нужны Base URL, имя модели и ключ. Окно контекста - минимум 64 000 токенов. Модель с меньшим окном Hermes отклоняет при старте.
Полная схема Hermes с нуля есть в канале:
Теперь давайте его установим: берём команду с официального сайта
Официальная документация Hermes - на домене Nous Research, репозиторий - в GitHub NousResearch. Пакеты и команды берите со страницы установки.
Команды и условия сверены 10.11.2026.
В видео я показываю установку на сервере: открываем официальный сайт Гермеса, копируем команду для Linux и запускаем в терминале сервера. Обновляем окружение командой из инструкции и проверяем версию Гермеса. Если установщик сразу открыл мастер настройки, остаёмся в нём.
На своём компьютере выберите подходящий вариант.
Windows: откройте скачанный .appinstaller через Windows App Installer, он установит подписанный MSIX-пакет. macOS Apple Silicon: откройте DMG и скопируйте приложение в Applications.
Для консольной установки на Linux, macOS Apple Silicon или WSL2:
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bashДля установки в Windows без WSL2 откройте PowerShell:
iex (irm https://hermes-agent.nousresearch.com/install.ps1)Первую команду в обычный PowerShell не переносите. Для второго варианта WSL2 не нужен.
После консольной установки на Linux, macOS или WSL2 перезагрузите оболочку. Для bash:
source ~/.bashrcДля zsh:
source ~/.zshrcЗатем запустите hermes. Команды source не предназначены для PowerShell. Если мастер появился сам, продолжайте в нём. Desktop поверх консольной установки можно открыть через hermes desktop.
В стандартной POSIX-установке код лежит в ~/.hermes/hermes-agent/, запускатель - ~/.local/bin/hermes, данные - ~/.hermes/. У установки из исходников в Windows основная папка - %LOCALAPPDATA%\\hermes\\, запускатель - в подпапке bin. У готового Desktop-пакета папки другие.
Программа открывается - переходите к модели. Команда не найдена - смотрите строку hermes: command not found в диагностике ниже.
Подключаем нейросеть: выбираем провайдера, входим, сохраняем модель
Модель получает нашу задачу, выбирает, какие инструменты задействовать и какой навык применить. Провайдер даёт доступ к модели, а способ входа зависит от него.
Запустите:
hermes modelВыберите доступного вам провайдера, пройдите предложенный вход, выберите модель и сохраните выбор. Затем откройте hermes. Если вы уже в мастере hermes setup, сделайте выбор там.
У Nous Portal - вход через OAuth и подписка Nous Portal. У OpenAI Codex - вход по коду устройства через подписку ChatGPT или Codex. Для своего адреса API укажите Base URL, имя модели и ключ.
Провайдер есть в меню, но доступ зависит от его условий. Проверьте их до входа.
Для Anthropic есть API с оплатой за токены либо OAuth с Max и дополнительными средствами для оплаты использования.
Команда hermes setup --portal авторизует в Nous Portal, выбирает Nous и включает Tool Gateway. Работа оплачивается по условиям подписки Nous Portal.
При открытии чата сверьте провайдера и модель в приветственном блоке.
Подключение локальной модели через Ollama разобрано в отдельной статье.
Ключ хранится отдельно, для первой задачи нужна пустая папка
Ключ вставляем в поле секретов. Всё, что вы в чат скидываете, попадает в контекст модели и сохраняется в истории.
В стандартной домашней POSIX-разметке секреты хранятся в ~/.hermes/.env, обычные настройки - в ~/.hermes/config.yaml. Команда hermes config set направляет значения в нужный файл автоматически. При другом HERMES_HOME или на Windows расположение данных отличается.
Для разбора ошибки не отправляйте полный файл настроек, ключ или снимок окна с ним. Достаточно сообщения об ошибке без секретов.
До первой задачи вручную создайте отдельную пустую папку без рабочих документов и ключей. Скопируйте её полный путь для запроса агенту. Это граница задачи в вашем запросе; сама папка не мешает агенту обращаться к другим файлам.
Не выдавайте агенту root ради локального запуска и не отключайте подтверждения опасных действий. Серверную учётную запись и изоляцию терминала через Docker можно настроить отдельно, под рабочую задачу.
Проверяем результат: окно открылось, модель ответила, файл появился
Через командную строку агент управляет установленными программами: обрезает видео, распознаёт речь, собирает данные. Для первой проверки поручим ему создать текстовый файл.
Проверка программы
Откройте приложение или запустите hermes. Другой терминальный интерфейс - hermes --tui.
Интерфейс должен показать выбранную модель и провайдера. Команда не найдена - переходите к строке с этой ошибкой в диагностике. Общая проверка установки и настроек - hermes doctor.
Проверка модели
Отправьте:
Ответь словом: готовПосле ответа уточните:
Какое слово я попросил тебя написать в предыдущем сообщении?Модель должна ответить без ошибки и вспомнить слово из предыдущего сообщения. Если ответа нет, проверяйте вход, модель или сообщение провайдера по таблице диагностики.
Проверка действия инструментом
Убедитесь, что в подготовленной пустой папке нет hermes-check.txt. Замените ПОЛНЫЙ_ПУТЬ_ТЕСТОВОЙ_ПАПКИ на её полный путь и отправьте запрос:
Работай только в папке ПОЛНЫЙ_ПУТЬ_ТЕСТОВОЙ_ПАПКИ.
Создай в ней новый текстовый файл hermes-check.txt со строкой «Гермес: проверка выполнена.».
Затем прочитай этот файл инструментом и покажи полный путь и прочитанную строку.
Другие файлы не меняй.
Если инструмента или доступа нет, сообщи об этом вместо слова «готово».Проверьте вызов файлового или терминального инструмента и его результат. Доступность инструментов настраивается через hermes tools.
Откройте названную папку обычным файловым менеджером, затем hermes-check.txt текстовым редактором. Должны совпасть полный путь, имя и строка Гермес: проверка выполнена..
Слово «готово» и содержимое файла в чате эту проверку не заменяют. Откройте файл сами.
Нет файла, другая папка или строка отличается - тест не пройден. Найдите причину по диагностике и повторите. Этот тест проверяет только создание и чтение файла. Следующую рабочую задачу тоже проверяйте по её результату.
Кстати, я снял видео «Полная схема по Hermes Agent с нуля для автоматизации бизнеса», обязательно посмотрите.
В нём показываю установку Hermes, подключение нейросетей и работу с базой знаний о бизнесе. Посмотрите, как после установки заложить второй мозг, чтобы у агента был контекст вашего бизнеса. Текущие команды берите из документации выше.
Вернуться к разговору можно через hermes --continue или hermes -c. Если беседа не нашлась, проверьте hermes sessions list и профиль. Сохранённый разговор ещё не доказывает работу долговременной памяти.
Если вы собираете свои проекты с ИИ-агентами, посмотрите программу практикума СмыслоКода.
Не работает: на каком шаге остановились?
Программа не открывается, модель не отвечает или инструмент не создал файл? Найдите свой случай в таблице. Сохраните текст ошибки без секретов: по нему проверяйте причину.
| Симптом | Где ошибка | Что проверить или сделать | Что повторить |
|---|---|---|---|
hermes: command not found | Программа | Перезагрузите оболочку. Проверьте PATH и каталог запускателя для своего способа установки | Запуск hermes |
API key not set или вход не проходит | Модель | Откройте hermes model. Проверьте провайдера, действующий ключ или предусмотренный способ входа | Короткий разговор |
model not available / model not found | Модель | Проверьте имя модели и доступный выбор в hermes model. При сообщении о малом контексте проверьте его размер | Ответ модели |
| Провайдер сообщает об отсутствии доступа или средств | Модель | Прочитайте его сообщение. В кабинете проверьте доступ и оплату. Если доступа нет, выберите модель, доступную вам по условиям её провайдера | Короткий разговор |
Ошибка 429 | Модель | Превышена частота запросов. Подождите и повторите; при постоянной нагрузке пересмотрите тариф или модель | Запрос |
| Чат отвечает, файла нет | Инструмент | Проверьте hermes tools, заданный путь, вызов инструмента и сообщение об отказе | Создание и самостоятельное открытие файла |
Ключи провайдеров не взаимозаменяемы: проверьте, к тому ли провайдеру относится ваш ключ.
Если файла нет, прочитайте отказ инструмента: куда он пытался записать, хватило ли прав. Отключать защитные подтверждения ради теста не нужно.
Если модель по вашему адресу API возвращает пустые или сломанные ответы, проверьте Base URL, имя модели и совместимость с OpenAI API. Проверьте подключение в отдельном клиенте.
Как обновить Hermes и повторить проверку
Сначала определите способ установки через hermes doctor. Порядок сверён с инструкцией по обновлению 10.11.2026.
Для управляемой установки из исходников:
hermes updateДля Windows MSIX используйте Update в Desktop и Windows App Installer; для пакета Microsoft Store - сам Store. Для готового приложения macOS - Update в Desktop.
В Docker обновите образ и пересоздайте контейнер с прежним подключением данных. В Termux: pkg update, затем pkg upgrade hermes-agent.
git pull не подходит для всех способов установки. hermes pm update предназначена для сопровождающих проекта и обновляет закреплённые версии зависимостей. Приложение обновляйте способом, который соответствует вашей установке.
Если пропустили настройку новых параметров, выполните hermes config check, затем при необходимости hermes config migrate. Если проверить обновления не удалось, это не значит, что у вас последняя версия.
После обновления повторите разговор и файловый тест в новой пустой папке. Прошлый файл сохраните, новый откройте самостоятельно.
Что дальше: бот после работающего агента
Руки у агента теперь у нас есть. Давайте сделаем из него сотрудника. Человек, которому вы выдали доступ к почте, к таблицам, финансовым документам, автоматически директором не становится. С агентом то же самое.
Для подключения мессенджера запустите hermes gateway setup, для проверки - hermes gateway status. Если модель ещё не отвечает, бот это не исправит. Постоянный сервер и навыки добавляйте под рабочую задачу.
Подключение Telegram разобрано в отдельной статье, а постоянная работа на сервере - в инструкции по VPS.
На каком шаге вы остановились: запуск программы, ответ модели или создание файла? Напишите в комментариях в канале.
Источники
- Nous Research: установка Hermes Agent - пакеты, поддержка систем, команды, зависимости и пути установки.
- Nous Research: первый запуск - подключение модели, условия входа, проверка чата, инструменты, сохранённые разговоры и шлюз.
- Nous Research: FAQ - ошибки ключа, выбора модели и частоты запросов.
- Nous Research: безопасность - подтверждения опасных действий и изоляция терминала.
- Nous Research: обновление - способы обновления и проверка новых параметров.
Новые материалы - дайджестом, без спама
Гайды выходят регулярно. Подпишись, чтобы не пропускать: пришлю подборку в Telegram или на email. Раз в неделю или каждый день - выбираешь сам.

