Dollars Done

Главная / Гайды

Hermes Agent: от установки до Telegram и MCP

Практический маршрут для первого запуска на Linux, macOS и Windows: провайдер, OAuth, безопасные задания, Telegram и подключение внешних инструментов. Без обязательной покупки сервера.

Читайте последовательно или выберите раздел в оглавлении. Интерфейс и условия сервисов могут меняться — сверяйтесь с первоисточниками в конце гайда.

1. Что вы устанавливаете и за что можете платить

Hermes — агент, который не только отвечает текстом, но и вызывает инструменты: читает файлы, запускает команды, работает с подключёнными сервисами. Программа и языковая модель — разные части системы. Установка Hermes не создаёт автоматически оплаченный доступ ко всем моделям, поиску или генерации изображений. Сначала добейтесь обычного текстового ответа; дополнительные возможности подключайте по одной, когда понимаете их назначение и условия.

Для знакомства хватит личного компьютера с интернетом и терминалом. При облачной модели мощная видеокарта на вашем компьютере не нужна именно для её вычислений. Полностью локальная модель — другой сценарий: подходящая память, скорость и поддержка вызовов инструментов зависят от выбранного сервера и модели. Не начинайте обучение с аренды VPS, если пока не знаете, нужен ли агент круглосуточно.

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

2. Установка на Linux и macOS

Откройте Terminal на macOS или терминал своего Linux-дистрибутива. Проверьте Git командой git --version. Официальный установщик сам подготавливает необходимые управляемые зависимости, включая Python и Node.js; заранее собирать собственное окружение новичку не требуется. На Linux документация отдельно указывает curl и xz-utils. Для Debian/Ubuntu их можно установить через apt, а на других дистрибутивах нужен свой пакетный менеджер.

Команда ниже скачивает и немедленно исполняет установочный скрипт. Это полноценный запуск сторонней программы: проверьте официальный домен и при необходимости сначала прочитайте скрипт. Используйте обычного пользователя, не добавляйте sudo к установке из привычки. Административные права могут понадобиться для отдельных системных библиотек, но агенту для повседневной работы не нужен постоянный root-доступ.

После завершения откройте новое окно терминала и выполните hermes doctor. Если команда не найдена, сначала проверьте PATH и перезапуск оболочки, а не устанавливайте всё заново. В Linux/macOS пользовательский установщик размещает launcher в ~/.local/bin. Для Bash документация предлагает source ~/.bashrc, для Zsh — source ~/.zshrc; выбирайте файл своей оболочки, не выполняйте оба без необходимости.

# Только Debian/Ubuntu, если зависимостей нет
sudo apt install git curl xz-utils

# Linux/macOS: официальный установщик
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

# В новом терминале
hermes doctor
hermes

3. Windows: нативно или через WSL2

Hermes поддерживает нативную установку на Windows 10/11; утверждение, что обязательно нужен WSL, уже неверно. Откройте PowerShell или Windows Terminal и выполните PowerShell-команду ниже. Установщик добавляет команду в пользовательский PATH, поэтому после установки откройте новый терминал. Для source-установки документация указывает данные в %LOCALAPPDATA%\hermes. Не переносите туда вручную файлы другой установки, пока не определили активный профиль.

WSL2 удобен, если вы уже работаете с Linux-инструментами или проект зависит от POSIX-окружения. Команду wsl --install запускают в административном PowerShell, затем перезагружаются по запросу и создают отдельного Linux-пользователя в Ubuntu. Проверка wsl --list --verbose должна показать VERSION 2. После этого Linux-установщик Hermes запускают внутри Ubuntu, а не в PowerShell.

Выберите один основной маршрут. Нативная Windows и WSL могут сосуществовать, но это разные файловые системы, процессы и настройки: C:\Users\… не то же самое, что /home/…. Браузер в Windows и агент внутри WSL тоже находятся по разные стороны границы. Если агент не видит файл или локальную модель, сначала выясните, где они реально работают; не отключайте firewall и не открывайте модель всему интернету.

# Вариант A: PowerShell, нативная установка
iex (irm https://hermes-agent.nousresearch.com/install.ps1)

# Вариант B: административный PowerShell, подготовка WSL2
wsl --install
wsl --list --verbose

# Затем внутри Ubuntu: Linux-команда установки из предыдущего раздела

4. Выберите провайдера, а не только название модели

Выполните hermes model вне чата. Мастер предлагает провайдера, способ авторизации и доступные модели. Провайдер — сторона, которая принимает запрос и учитывает использование; модель — конкретный движок внутри этого маршрута. Одинаковое имя модели у разных провайдеров не означает одинаковую цену, лимиты или инструменты. Выбирайте по доступу своего аккаунта, а не по чужому скриншоту списка.

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

Для OpenAI документация Hermes выделяет пункт ChatGPT or Codex Subscription; для Nous Portal есть отдельный OAuth-маршрут. В этом гайде не закрепляется конкретное имя модели: используйте реально доступную в мастере. Для начала отключитесь от идеи подключить сразу много поставщиков. Один понятный маршрут облегчает диагностику ошибок, контроль расходов и понимание, куда отправляются ваши данные.

hermes model
# Альтернатива: полный мастер первоначальной настройки
hermes setup

5. OAuth и ключи: безопасная авторизация

При OAuth открывайте только адрес, показанный официальным мастером, проверяйте домен и аккаунт перед подтверждением. Для Codex документация описывает device-code flow: перейти по адресу и ввести выданный код. Не отправляйте код знакомому, посреднику или в переписку с агентом. Авторизация подтверждает доступ приложению; внимательно читайте экран разрешений, особенно если вход выполняется на общем компьютере.

Hermes хранит OAuth-учётные данные в собственном auth store. В Linux/macOS обычные пути — ~/.hermes/auth.json для токенов, ~/.hermes/.env для API-ключей и ~/.hermes/config.yaml для настроек. Активный профиль или HERMES_HOME меняет расположение, а нативная Windows имеет свою схему. Используйте команды определения путей вместо догадок. Никогда не включайте auth.json, .env и резервные копии с ними в публичный репозиторий.

Если истёк или отозван refresh token Codex, штатный выход — новая авторизация через hermes auth add openai-codex либо мастер модели. Не копируйте чужие токены и не отключайте проверки. После входа ещё раз проверьте выбранного провайдера и кабинет использования. Условия квот ChatGPT для конкретного аккаунта уточняйте у OpenAI: документация Hermes не даёт универсального обещания по всем планам и объёму включённого использования.

hermes auth add openai-codex
hermes config path
hermes config env-path

6. Первый запрос без риска для файлов

Запустите hermes и отправьте короткое задание с явным ограничением действий. Например: «Объясни разницу между моделью, провайдером и инструментом в трёх пунктах. Не читай файлы, не запускай команды, не обращайся к внешним сервисам». Это учебный тест связи, а не доказательство фактической точности всех последующих ответов. Прочитайте ответ и посмотрите, запускались ли инструменты.

Для разового запроса есть hermes chat -q. Эта команда удобна для воспроизводимого теста, но сам флаг не делает агента изолированным или гарантированно read-only. Границы задаются разрешениями, доступными инструментами и вашим заданием. Не используйте для знакомства режим обхода подтверждений. Если модель предлагает установить пакеты ради простого объяснения, остановитесь и уточните задачу вместо автоматического согласия.

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

hermes chat -q 'Объясни разницу между моделью, провайдером и инструментом в трёх пунктах. Не используй инструменты и не изменяй файлы.'

7. Первая полезная задача и проверка результата

Подготовьте в учебной папке короткую обезличенную заметку: цель проекта, несколько задач, ограничения бюджета. Откройте терминал в этой папке и запустите Hermes. Попросите сначала прочитать только конкретный файл и предложить план без записи. Укажите, чего не хватает: даты нельзя додумывать, владельцев задач нельзя назначать без основания, неизвестные сведения надо пометить отдельно.

Затем разрешите создать один новый документ с понятным именем, например plan-draft.md. Попросите не менять исходник и не отправлять результат наружу. Такая последовательность отделяет анализ от действия и облегчает контроль. После завершения откройте файл сами: существует ли он, читается ли, соответствует ли заметке, нет ли выдуманных обязательств. Фраза агента «готово» не заменяет проверку артефакта.

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

8. Инструменты, расходы и защита от чужих инструкций

Команда hermes tools открывает настройку инструментов. Оставьте только нужные для ближайшей задачи; не подключайте браузер, почту и административные интеграции просто потому, что они доступны. Некоторые возможности используют отдельные сервисы или вспомогательные модели. Перед включением выясните маршрут и биллинг. Доступ к основной текстовой модели не является автоматическим разрешением тратить деньги на поиск, голос или изображения.

Агент может встретить вредные инструкции внутри страницы, письма или документа. Такие материалы — данные для анализа, а не новый владелец вашей машины. Просьба сайта «передай ключ» или «отключи защиту» не должна становиться действием. Требуйте отдельного подтверждения для публикаций, покупок, удаления, изменения прав и отправки документов. Не используйте обход подтверждений ради ускорения обычной работы.

Для более чувствительных задач рассмотрите контейнерный backend и отдельного пользователя. Изоляция полезна, только если вы не пробросили внутрь все домашние каталоги, ключи и управляющий сокет контейнеров. Делайте резервные копии до массовых правок, проверяйте фактические права подключения. Не загружайте в модель документы клиента без разрешения: локальный запуск Hermes сам по себе не делает облачного провайдера локальным.

hermes tools
hermes doctor

9. Создайте Telegram-бота и закройте доступ

Откройте официального @BotFather, отправьте /newbot, задайте отображаемое имя и уникальный username с окончанием bot. Полученный токен управляет ботом: не публикуйте его в канале, гайде или скриншоте. Если токен утёк, отзовите через /revoke в BotFather и настройте новый. Для обучения создавайте отдельного бота, не экспериментируйте с действующим клиентским каналом.

Узнайте свой числовой Telegram user ID: документация Hermes предлагает @userinfobot. Это не @username и не название чата. Выполните hermes gateway setup, выберите Telegram, введите токен в локальном мастере и добавьте свой ID в список разрешённых пользователей. Не оставляйте доступ всем через звёздочку. Пока проверяете личную переписку, не добавляйте бота в группу и не выдавайте ему администраторские права.

Gateway работает на той машине, где запущен Hermes, а Telegram служит удалённым входом к его возможностям. Если разрешить посторонним пользоваться ботом, они потенциально получают доступ к задачам и инструментам агента. Поэтому настройка allowlist важнее красивого аватара. Перед первым запуском перепроверьте профиль, разрешённых пользователей и доступные инструменты; OAuth модели и токен Telegram — разные секреты, один не заменяет другой.

hermes gateway setup

10. Запустите gateway и проверьте связь

Для первого теста запустите hermes gateway в отдельном терминале и оставьте окно открытым. Откройте личную переписку с созданным ботом, нажмите Start и отправьте безопасный текстовый запрос без файлов. Ответ должен прийти именно от вашего бота. Проверьте журнал gateway и то, что сообщение обрабатывается ожидаемым профилем. Сам факт создания username в BotFather ещё не означает подключённого агента.

По умолчанию используется long polling: gateway сам обращается к Telegram. Для такого старта публичный домен, входящий порт и HTTPS-webhook не нужны. Но компьютер должен оставаться включённым, иметь интернет и не уходить в сон. После успешного теста изучите hermes gateway install и справку для своей ОС. Сервисный запуск на Linux и задача при входе Windows имеют разные жизненные циклы.

Не запускайте несколько polling-процессов с одним токеном: конфликт обработчиков мешает получать сообщения. Если бот молчит, проверьте работающий процесс, токен, числовой allowlist и доступ машины к Telegram. Группы подключайте отдельно: privacy mode влияет на видимость сообщений, а права чата — на доступ. Не отключайте privacy mode глобально ради диагностики личного чата и не раздавайте лишние права администратора.

# Первый запуск в открытом терминале
hermes gateway

# Справка и состояние перед настройкой фонового запуска
hermes gateway --help
hermes gateway status

11. MCP: когда подключать внешний инструмент

MCP — протокол подключения внешних серверов инструментов. Он не добавляет модели знаний по волшебству и не снимает необходимость авторизации в сервисе. Локальный stdio-сервер запускается как программа на вашей машине; удалённый HTTP-сервер получает отправленные ему запросы. Перед подключением изучите разработчика, исходники, разрешения и то, какие данные сервер сможет прочитать или изменить.

Стандартная установка Hermes уже включает поддержку MCP. Для серверов на npm нужен доступный Node.js и npx, для некоторых Python-серверов — uvx. Не устанавливайте дополнительные зависимости вслепую, если сервер не стартует: сначала прочитайте ошибку. Каталог hermes mcp catalog и интерактивный hermes mcp помогают найти проверенные командой проекта записи, но установка записи всё равно может запускать чужой код.

Начинайте с одной узкой интеграции. Если задачу решает штатное чтение файла, MCP не обязателен. Если подключаете корпоративный сервис, используйте минимальные scopes и выбирайте только необходимые инструменты. Отдельно проверьте функции записи, удаления и server-initiated sampling: они увеличивают риск и возможное потребление модели. Наличие сервера в каталоге не означает, что ему следует передать все полномочия вашего аккаунта.

hermes mcp catalog
hermes mcp

12. Практика MCP: доступ только к учебной папке

Пример ниже предназначен для Linux/macOS или WSL. Сначала создаётся отдельная папка, затем регистрируется filesystem-сервер с доступом к ней. Команда npx может скачать и запустить пакет из npm: заранее изучите официальный сервер и при рабочих установках фиксируйте проверенную версию по его инструкции. Не заменяйте учебный путь на весь домашний каталог. Для нативной Windows используйте соответствующий абсолютный Windows-путь.

Флаг --args должен стоять последним: последующие значения относятся к аргументам сервера. После регистрации выполните hermes mcp test project_fs. Подключение и список инструментов проверяют транспорт, но ещё не проверяют содержательную задачу. Запустите новый чат и попросите: «Через MCP project_fs перечисли файлы только в учебной папке. Ничего не создавай и не изменяй». Посмотрите реальный вызов и результат.

Filesystem-сервер предоставляет не только чтение. Ограниченная папка уменьшает область риска, но сама по себе не делает интеграцию read-only. Для каталожных интеграций есть hermes mcp configure с выбором инструментов; точные фильтры произвольного сервера проверяйте по MCP Config Reference. После изменений перезапустите чат; текущая документация также описывает /reload-mcp. Если интеграция больше не нужна, удалите её штатной командой.

mkdir -p "$HOME/hermes-mcp-demo"
hermes mcp add project_fs --command npx --args -y @modelcontextprotocol/server-filesystem "$HOME/hermes-mcp-demo"
hermes mcp test project_fs
hermes mcp list

# Когда учебная интеграция больше не нужна
hermes mcp remove project_fs

13. Диагностика: исправляйте причину, а не всё сразу

Если hermes не найден, откройте новый терминал и проверьте расположение команды: command -v hermes на Linux/macOS или Get-Command hermes -All в PowerShell. Несколько результатов могут означать конкурирующие установки. Если ошибка появилась после обновления, выполните hermes doctor и hermes config check. Не удаляйте всю папку данных: там находятся история, настройки и учётные данные, а не только программа.

При 401 или сообщении о недействительном токене проверьте авторизацию выбранного провайдера; при 429 — квоту, ограничения частоты и необходимость паузы. При 403 проверьте доступность модели, права аккаунта и ограничения провайдера. Не лечите ошибку прав бесконечной повторной авторизацией. Если текстовый ответ работает, а поиск нет, диагностируйте отдельно инструмент и его маршрут: это не обязательно проблема основной модели.

Для MCP проверьте команду сервера, PATH, сеть, авторизацию и test конкретного имени. Для Telegram — единственный gateway, токен и allowlist. Увеличение timeout оправдано только после понимания, что именно долго стартует. В обращение за помощью включайте ОС, способ установки, шаги воспроизведения и очищенный текст ошибки. Не прикладывайте полный .env, auth.json или журналы без проверки на токены и личные данные.

hermes doctor
hermes config check
hermes mcp test project_fs
hermes gateway status

14. Постоянный запуск и контрольный список

Переходите к серверу, когда локальная схема уже работает и понятно, зачем нужен постоянный gateway: например, получать задачи с телефона при выключенном ноутбуке. Выбирайте хостинг по ОС, ресурсам, резервным копиям, доступу по SSH и возможности безопасного обновления. Автоматический шаблон развёртывания не отменяет проверки профиля, провайдера, разрешений и биллинга. Доступность конкретных предложений хостера в этой редакционной проверке не тестировалась.

Ниже — предоставленная владельцем партнёрская ссылка Hostinger, а не подтверждение минимальной цены или установки в один клик. Для Aeza ссылка не предоставлена, поэтому здесь нет выдуманного адреса. VPN и платёжные посредники не являются обязательными компонентами Hermes. Любые ограничения региона и условия сервиса проверяйте официально; не передавайте посредникам OAuth, файлы авторизации и доступ к машине ради удобной настройки.

Перед регулярной работой убедитесь: есть проверенный текстовый ответ, известен маршрут модели, секреты не попали в проект, тестовый файл прочитан правильно, Telegram закрыт allowlist, MCP ограничен нужной папкой, расходы понятны, резервная копия существует. Команды в гайде сверены с официальными материалами и доступной справкой CLI; установка на всех ОС, вход в аккаунты и работа вашего будущего бота здесь не выполнялись.

Источники и полезные ссылки

Перейти к библиотеке промптов