Hermes Agent: установка - теперь давайте его запустим

Опубликовано 22.08.2026Обновлено 10.11.20268 мин чтенияБазовый
Шлем Гермеса на экране компьютера, от которого потоки данных касаются терминала, документов и браузера.
Что узнаешь
  • Как выбрать официальный установщик для своего компьютера
  • Как подключить модель и проверить действие инструментом
  • Как найти причину ошибки и обновить свою установку Hermes
Базовый
785просмотров
2поделились

Чтобы установить Hermes Agent, возьмите пакет или команду с официального сайта, затем подключите доступную вам нейросеть через hermes model. Открывшееся окно ещё не результат: модель должна ответить, а агент - создать файл, который вы откроете сами.

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

Теперь давайте его установим. Покажу, где он будет работать, как его запустить и подключить к нему нейросеть.

Что подготовить: компьютер и доступ к нейросети

Начните со своего компьютера. Сервер нужен, если агент должен работать 24/7, а вы не хотите держать компьютер включённым. Выберите 1 способ установки из таблицы.

СредаПервый способЧто учитывать
WindowsDesktop-пакетКонсольная альтернатива - PowerShell
macOS Apple SiliconDMGЕсть консольный вариант; 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:

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

Для установки в Windows без WSL2 откройте PowerShell:

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

Первую команду в обычный PowerShell не переносите. Для второго варианта WSL2 не нужен.

После консольной установки на Linux, macOS или WSL2 перезагрузите оболочку. Для bash:

bash
source ~/.bashrc

Для zsh:

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 в диагностике ниже.

Подключаем нейросеть: выбираем провайдера, входим, сохраняем модель

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

Запустите:

bash
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 Agent с нуля для автоматизации бизнеса

В нём показываю установку Hermes, подключение нейросетей и работу с базой знаний о бизнесе. Посмотрите, как после установки заложить второй мозг, чтобы у агента был контекст вашего бизнеса. Текущие команды берите из документации выше.

Вернуться к разговору можно через hermes --continue или hermes -c. Если беседа не нашлась, проверьте hermes sessions list и профиль. Сохранённый разговор ещё не доказывает работу долговременной памяти.

Если вы собираете свои проекты с ИИ-агентами, посмотрите программу практикума СмыслоКода.

Практикум по вайб-кодингу
+Твой второй мозг
3 вечера - инструменты, метод, первый проект
Старт 24–26 ноября  ·  2 000 ₽
Записаться →

Не работает: на каком шаге остановились?

Программа не открывается, модель не отвечает или инструмент не создал файл? Найдите свой случай в таблице. Сохраните текст ошибки без секретов: по нему проверяйте причину.

СимптомГде ошибкаЧто проверить или сделатьЧто повторить
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.

Для управляемой установки из исходников:

bash
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.

На каком шаге вы остановились: запуск программы, ответ модели или создание файла? Напишите в комментариях в канале.

Источники

Практикум по вайб-кодингу
+Твой второй мозг
3 вечера - инструменты, метод, первый проект
Старт 24–26 ноября  ·  2 000 ₽
Записаться →

Новые материалы - дайджестом, без спама

Гайды выходят регулярно. Подпишись, чтобы не пропускать: пришлю подборку в Telegram или на email. Раз в неделю или каждый день - выбираешь сам.

Была инструкция полезна?
Артемий Миллер
Автор
Артемий Миллер
Предприниматель и вайб-кодер

Артемий Миллер - предприниматель и вайб-кодер. Бывший программист, собирает продукты исключительно вместе с ИИ-агентами, без найма разработчиков.

Связанные инструкции

OpenCode Agents: исполнитель делает, проверяющий принимает

В OpenCode исполнитель готовит результат, отдельный reviewer принимает его по брифу и эталону. Задайте ему модель, разрешите чтение нужных файлов и проверьте запреты до работы с реальными данными.

7 мин

Как сделать ИИ-мультик: первый ролик с навыком «Мультик»

Первый ИИ-мультик можно собрать с навыком «Мультик» для Claude Code: от темы и постоянного героя до вертикального MP4. Сам навык открытый; доступ к модели, разборы и клон голоса оплачиваются отдельно.

9 мин

Claude Code 2.1.300: MCP больше не роняет диалог ошибкой 400

Claude Code 2.1.300 вышел 14 октября: разговор с MCP больше не падает на каждом ходу с ошибкой 400, если API не принял схему инструмента, такой инструмент уходит без параметров. Fast mode в VS Code сам выключается без кредитов, а расшифровки сессий теперь хранят промпт и инструменты.

4 мин

OpenCode Zen и Go: цены моделей, лимиты и условия оплаты

Сравнение OpenCode Zen и подписок Go и Go Plus по официальной документации: цены за 1 млн токенов, месячные лимиты моделей, автопополнение баланса, условия обработки данных и выбор способа оплаты.

15 мин

Связанные термины