Решил поставить Hermes Agent и понял, что нормального руководства на русском, которое отвечает на вопрос «как запустить hermes agent», практически нет. Есть официальная дока, есть разрозненные посты на Reddit и Vc.ru. Но всё вперемешку: то про установку, то про шлюз, то про API-ключи. В итоге новичок тратит вечер и бросает. Собрал здесь цельный путь - от первого скачивания до работающего бота в Telegram. Проверил на себе.
Сразу оговорюсь: есть два сценария. Первый - поднимать Hermes Agent самому, со всеми настройками. Второй - если хочется просто пользоваться нейросетями без заморочек с инфраструктурой. Для второго есть однострочное решение - 3GPT от 3SELLER. Но не будем забегать вперёд. Сначала разберём первый путь.
Hermes Agent - не просто чат-бот
Hermes Agent - это открытый ИИ-агент от Nous Research. Он умеет общаться в мессенджерах, работать с инструментами, запускать команды в песочнице. Главная фишка - он сам решает, какие инструменты ему нужны для задачи. Ты просто даёшь промпт, а он строит план, вызывает функции, делает какие-то действия за тебя.
Но в этом же и сложность: чтобы он заработал, нужно выбрать провайдера модели, настроить шлюз для мессенджера. Для человека, который в первый раз видит CLI, это может показаться высоким порогом входа. Спокойно. Тут нет ничего сверхъестественного. Идём по шагам, и всё получится.
Да, сам агент бесплатный. Но платить за токены всё равно придётся. Точнее, за доступ к модели, которая находится внутри. Суть в том, что агент - это оболочка, а мозг - это LLM. Выбор провайдера - один из важных этапов настройки. К этой теме вернёмся.
Установка на macOS и Windows: официальный способ
Если ты работаешь на macOS или Windows, самый простой путь - скачать установщик с hermes-agent.nousresearch.com/desktop. Там лежат два файла: .dmg для macOS 12 и новее, и .exe для Windows 10/11. Скачивай нужный и запускай.
На macOS нужно открыть .dmg и перетащить Hermes в папку Applications. Затем запустить. Тебя может встретить предупреждение о неизвестном разработчике. Это нормально. Просто открой «Системные настройки», раздел «Конфиденциальность и безопасность», и разреши запуск. Потом таких окон больше не будет.
На Windows всё ещё проще: запускаешь .exe и следуешь мастеру установки. Минутная история. После этого Hermes появляется в меню «Пуск» как обычная программа. Жмёшь иконку - и перед тобой десктопный интерфейс.
Обрати внимание: десктопный клиент - это надстройка над CLI. Она запускает терминальные процессы, но делает их невидимыми для пользователя. Поэтому не пугайся, если в интерфейсе есть кнопки вроде «Start Gateway» - это просто управление командами из CLI.
После установки запустите шлюз кнопкой «Start Gateway» в Desktop или командой hermes gateway start в терминале. Напишите своему боту что угодно - агент ответит.
Установка через CLI для тех, кто любит терминал
Десктопная версия хороша, но многие предпочитают классический метод - через скрипт. Официальный quickstart упоминает установку одной строкой: идёшь на страницу документации, копируешь curl-команду и выполняешь в терминале.
Скрипт устанавливает Python 3.11, если его нет, затем Node.js для мессенджерных платформ, создаёт виртуальное окружение и добавляет команду hermes в PATH. В итоге у тебя появляется папка ~/.hermes/, в которой лежит вся конфигурация.
После установки не забудь перезагрузить оболочку или открыть новый терминал. Иначе команда hermes может не найтись.
Выбираем провайдера модели: OpenRouter, Anthropic и другие
Агент без модели - как автомобиль без мотора. Hermes Agent не привязан к одному провайдеру. Можно подключить OpenAI, Anthropic, OpenRouter, локальные модели через Ollama. Выбор зависит от задач и бюджета.
Совет из r/hermesagent (он мне очень помог): начинайте с OpenRouter. У него есть бесплатные кредиты для новых пользователей, доступ к сотням моделей через один API. Один ключ - и ты можешь переключаться между моделями прямо в чате агента. Это удобно, когда ещё не понимаешь, какая модель лучше подходит для твоих сценариев.
Передать ключ проще всего через CLI: hermes model. Указываешь провайдера, вставляешь API-ключ. Настройки сохраняются в ~/.hermes/ и автоматически подхватываются всеми компонентами агента.
Но есть нюанс: если ты в России, получить ключи тех же OpenAI или Anthropic проблематично - нужна зарубежная карта, а многие сервисы просто не принимают наших пользователей. Приходится искать обходные пути. Впрочем, OpenRouter работает с криптой и многими другими методами. Но не со всеми российскими картами.
Если хочется просто общаться с нормальными моделями, поднимать Hermes Agent не обязательно. Российские реалии с API-ключами и VPN превращают это в квест. Более гладкий вариант - готовый ИИ-роутер 3GPT. Он даёт доступ к актуальным флагманским моделям из России, без иностранных карт. Об этом расскажу в конце статьи.
Запускаем Hermes Agent в первый раз
Всё установлено, ключ есть. Теперь самое интересное - первый запуск.
Интерактивный режим запускается командой hermes. Ты оказываешься в терминальном чате, где можно сразу задать вопрос агенту. На этом этапе проверяем, что всё работает. Пишешь что-то вроде «привет, вот тебе задача - найди последние новости про IT», и смотришь, как агент начинает рассуждать и выполнять действия.
Именно в интерактивном режиме удобно пробовать фичи: длинные промпты, мультистрочный ввод, возможность прервать агента горячей клавишей. Ты ощущаешь, как он думает, как останавливается и переспрашивает. Это сильно отличается от обычного чата в вебе.
Если видишь ошибку при первом запуске, не спеши паниковать. Проверь ключ, проверь интернет. В большинстве случаев проблема в неправильном выборе провайдера в hermes model.
Подключаем Telegram, Discord и WhatsApp через hermes gateway setup
Терминальный чат - это хорошо, но интереснее завернуть агента в мессенджер. Тогда можно общаться с ним с телефона, делиться доступом с коллегами. Для этого существует шлюз - прослойка, которая связывает агента с платформами обмена сообщениями.
Запусти настройку шлюза:
hermes gateway setup
Она интерактивная. Тебя по шагам проведут по каждой платформе, попросят вставить токены. Плюс в том, что поддерживаются Telegram, Discord, WhatsApp и, возможно, другие сервисы. Разберём самые популярные сценарии.
Telegram
Тут понадобится бот. Открой в Telegram @BotFather. Напиши /newbot. Бот спросит имя и username. После этого он выдаст токен - длинную строку с двоеточием. Скопируй её.
Теперь снова запусти hermes gateway setup, выбери Telegram и вставь токен. Готово. Осталось запустить шлюз командой hermes gateway start. Всё. Можно писать своему боту - он ответит.
Discord
Схема похожая, но чуть сложнее. Заходишь на Discord Developer Portal. Создаёшь новое приложение. В разделе Bot создаёшь собственно бота, копируешь токен. Приглашаешь бота на свой сервер, выдав нужные разрешения. Потом вставляешь токен в hermes gateway setup.
Есть нюанс: в настройках бота на портале разработчиков иногда нужно включить переключатели, связанные с message content intent. Иначе бот не будет видеть сообщения участников. Но в консоли разработчика сейчас это довольно явно подсвечивается.
WhatsApp настраивается иначе - через сопряжение по QR-коду. hermes gateway setup, выбираешь WhatsApp, и в терминале появляется QR-код. Сканируешь его своим телефоном в WhatsApp. Всё, агент живёт внутри ватсапа.
После настройки всех платформ можно запустить шлюз как фоновый сервис: hermes gateway start. Если же ты хочешь видеть логи в реальном времени и отлаживать, используй hermes gateway run. Разница в том, что run держит терминал занятым и показывает всё, что происходит внутри.
Полезные команды CLI: шпаргалка на каждый день
Запуск агента - это не разовая операция. Ежедневное использование строится вокруг терминала. Вот команды, которые вы будете использовать чаще всего:
- hermes - запускает агента в интерактивном режиме;
- hermes gateway start - запускает мессенджерный шлюз;
- hermes model - меняет провайдера или модель на лету;
- hermes tools - управляет набором инструментов, доступных агенту;
- hermes dashboard - открывает веб-интерфейс в браузере;
- hermes update - обновляет агент до последней версии.
Этих команд достаточно на первое время. Ещё будет полезно посмотреть официальную документацию по расширенным возможностям, но уже после того, как сервис запущен и работает. Разумеется, команда hermes update - твой друг. Агент развивается, баги чинят, инструменты добавляют. Держать его в актуальном состоянии важно.
Частые ошибки при запуске Hermes Agent
Запуск агента не всегда проходит гладко. Собрал типовые ситуации, с которыми сталкивался сам и которые видел в комментариях.
Ошибка авторизации или 401 при любом запросе. Чаще всего значит, что API-ключ введён с ошибкой, либо не тот провайдер выбран. Проверь через hermes model, какой провайдер активен, и скопируй ключ заново.
Команда hermes не найдена. Значит, скрипт установки не добавил директорию с бинарниками в PATH. В большинстве случаев помогает перезагрузка терминала. На Windows также стоит проверить переменные окружения.
Шлюз запускается, но бот не отвечает. Убедись, что в BotFather у бота нет конфликта с другим процессом. Иногда старый бот продолжает держать соединение. Также проверь, что пригласил бота на сервер с разрешениями читать сообщения.
Тормоза при ответах. Если агент явно думает слишком долго, возможно, выбрана тяжёлая модель, а качество ответа не стоит этого. В OpenRouter это лечится сменой модели на более дешёвую. Например, если ответа приходится ждать дольше минуты, переключись на модель из средней ценовой категории.
Обычно на этом всё. Остальные баги либо уже исправлены в свежих версиях, либо связаны с конкретным провайдером.
Что попробовать после запуска: функции, ради которых всё затевалось
Когда первый диалог состоялся, хочется копать глубже. Вот несколько направлений, которые стоит протестировать в первый же день.
Служебные команды (slash-commands) - встроенный набор управляющих директив, которые позволяют переключать режим, вызывать инструменты, менять температуру генерации. Открываешь список прямо в терминале - и ты уже не просто чат-бот, а управляемая система.
Мультистрочный ввод. Задача, которая требует нескольких абзацев промпта. В CLI это решено удобно в отличие от многих одноразовых веб-чатов.
Прерывание агента. Бывает, что модель понесло не туда. В Hermes Agent можно жмякнуть ESC, и она остановится. Это очень удобно, когда ты видишь, что агент тратит время впустую на бессмысленные действия, и хочешь скорректировать его план.
Sandboxed terminal - это когда агент получает доступ к изолированному терминалу внутри своей же среды. Он может выполнять команды, устанавливать пакеты, запускать код. Для автоматизации задач - мощнейшая штука. Но нужно аккуратно настраивать права, чтобы это не превратилось в дыру безопасности.
Режим голоса - тоже есть, если установить дополнительные зависимости. Но это уже не для первого вечера.
Для разговора с интеллектуальными моделями не обязательно городить такой огород. Особенно если вы живёте в России и каждый шаг с ключами и оплатой превращается в квест. Это не значит, что Hermes Agent плох. Он классный. Но у тебя должен быть выбор.
Альтернатива для тех, кто не хочет возиться с инфраструктурой - 3GPT
Я не зря упоминал 3GPT в начале. Пока я изучал Hermes Agent, понял, что многие люди не хотят запускать софт самостоятельно. Им не нужен агент, способный сам выполнять команды. Им нужен быстрый ответ от умной нейросети, которую можно использовать в работе, в текстах, для картинок и видео.
Если это твой случай, посмотри на 3GPT от 3SELLER. Это ИИ-роутер, который открывает из России доступ ко всем топовым флагманским моделям. Без иностранных карт, без VPN-плясок.
Что внутри:
- Chat GPT 6 Astra
- Claude Fable 5
- Claude Fable 5.1
- Claude Opus 5.5
- Chat GPT 5.5
- Chat GPT 6.1 Sol
- Nano Banana для создания изображений
Плюс генерация видео и многое другое. И всё это за 149 рублей при подключении через официальный сайт 3GPT. Баланс пополняется российской картой, СБП или криптой.
Разница простая: Hermes Agent - это конструктор, из которого собираешь middleware для своих задач. А 3GPT - это готовая работающая система. Запустил и сразу используешь. Для бизнеса, для продающих текстов, для сайтов - как раз то, что нужно в повседневных задачах.
Создавайте и обрабатывайте максимально реалистичные изображения. Создавайте видеоролики и генерируйте голос. Всё это доступно в том же интерфейсе.
Но это ещё не вся фишка. У 3SELLER есть отдельная площадка с готовыми ИИ-агентами под разные задачи - 3seller.com/ai/agents. Там выбираешь готового агента, начинаешь с ним общаться, и можно менять модель прямо в чате. Никаких установок и конфигов.
По сути это тот же Hermes Agent, только уже настроенный и не требующий танцев с бубном. Для меня такая модель потребления намного проще. Особенно если нужно работать над контентом, а не копаться в CLI.
Выбирай свой путь
Запустить Hermes Agent - это увлекательное приключение для технически подкованных людей. Ты получаешь полный контроль, можешь настраивать агента под себя, подключать к любому мессенджеру. Если тебе нравится копаться в инструментах, этот путь тебя точно затянет.
Если же цель не в процессе, а в результате - просто хочешь получить ответ от лучшей нейросети из России, не заморачиваясь с установкой, - тогда облегчённый вариант. 3GPT делает за тебя всю техническую работу. Подключайся, пополняй баланс российской картой и начинай пользоваться. Через пять минут после оплаты ты уже общаешься с Chat GPT 6 или Claude Fable 5.
Я сам часто выбираю второй вариант. Мои эксперименты с Hermes Agent продолжаются, но в рабочие моменты, когда нужен быстрый результат, я перехожу на 3GPT. Не потому, что Hermes плох, а потому что JS-часть, шлюзы и API-ключи отнимают время, которое мне проще потратить на саму работу.
Впрочем, решать тебе. Оба инструмента достойны внимания. Если ты дочитал до этого места, значит, тебе точно не безразличен умный софт. Ставь, пробуй, выбирай удобное. Технологии должны работать на тебя, а не наоборот.
Получить доступ ко всем флагманским моделям нейросетей из России можно на официальном сайте 3GPT - 3seller.com/3gpt.