Hermes-Relay — плагин

Плагин Hermes Agent с сервером Relay: чат, голос и терминал агента на Android, а настольный CLI дает агенту руки на компьютере

  • 442 ★ репозитория
  • Последний коммит
  • MIT
Плагин

Широкий доступ

Почему такой уровень

  • Настольный CLI дает агенту терминал, чтение и запись файлов, снимки экрана и буфер обмена на спаренной машине
  • В сборке для установки вручную агент читает экран телефона, нажимает, печатает и отправляет SMS
  • Сервер Relay принимает подключения к агенту: без доверенной сети и согласий доступ к нему стоит закрыть
Все причины и проверки

codename-11/hermes-relay

Установка

Работает в

Ручная установка

hermes plugins install Codename-11/hermes-relay/plugin --enable

Нужны Python 3.11 и свежий hermes-agent с включенной панелью. Приложение ставят отдельно из Google Play или APK со страницы релизов.

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

  • Настольный CLI дает агенту терминал, чтение и запись файлов, снимки экрана и буфер обмена на спаренной машине
  • В сборке для установки вручную агент читает экран телефона, нажимает, печатает и отправляет SMS
  • Сервер Relay принимает подключения к агенту: без доверенной сети и согласий доступ к нему стоит закрыть

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Hermes-Relay выводит агента Hermes на устройства, которые вы носите с собой. Плагин для Hermes Agent поднимает сервер Relay на порту 8767, а к нему подключаются Android-приложение Hermes-Relay и настольный CLI `hermes-relay`. Мозг агента остается на вашей машине, телефон и компьютер служат каналами к нему. Плагин добавляет то, чего нет в обычном Hermes: терминал и TUI на телефоне, уведомления, настольные инструменты, расширенный голос, сессии Relay, черновики страниц с одобрением и по желанию Device Control. Чат, управление моделями и ключами, голос и входящие файлы работают и без плагина через панель и шлюз Hermes. Настольный CLI (бета) дает агенту руки на спаренной машине: `read_file`, `write_file`, `terminal`, `search_files`, `screenshot`, `clipboard`, `open_in_editor` и другие инструменты. Они работают за одноразовым согласием, с подтверждением диффов патчей и выключателем `--no-tools`. Пару создает одно приглашение: `hermes pair` рисует QR-код в терминале, а `hermes-relay pair --pair-qr … --grant-tools` подключает компьютер. В сборке для установки вручную агент еще читает экран телефона и нажимает на нем кнопки. Приложения банков и двухфакторной аутентификации по умолчанию заблокированы, а опасные глаголы требуют подтверждения.

Для кого. Пользователям Hermes Agent, которые хотят говорить с агентом с телефона и давать ему доступ к своим машинам под контролем согласий.

Подходит, если

  • Агент Hermes живет дома, а чат и голос нужны на ходу: подключение идет по локальной сети или через Tailscale между вашими устройствами
  • Терминал агента нужен на телефоне, а входящие уведомления агент должен разбирать и пересказывать
  • Агент читает и правит файлы на второй вашей машине, и каждый патч вы одобряете в диффе
  • Домашний и рабочий серверы Hermes переключаются в приложении одним касанием

Не подходит, если

  • Нужен только чат с Hermes: он работает и без плагина через стандартную панель
  • Сервер Relay придется открыть за пределы доверенной сети: сначала прочтите руководство по удаленному доступу
  • Клиент нужен для iPhone: приложение рассчитано на Android 8.0 и новее

Пример запроса к агенту

Поставь плагин Hermes-Relay и покажи приглашение для пары с моим Android-телефоном

Ограничения

  • Приложению нужен Android 8.0 или новее, плагину Python 3.11 и свежий hermes-agent с включенной панелью. CLI для компьютера находится в бете, бинарники без подписи, поэтому SmartScreen и Gatekeeper будут предупреждать.
  • Device Control, SMS, контакты и набор номера есть только в сборке для установки вручную (файл `-sideload-release.apk`), в Google Play их нет.
  • Флаг `--no-ssl` годится для доверенной локальной сети. Открывать Relay шире стоит только после руководства по удаленному доступу.
  • Часть возможностей работает и без плагина через панель Hermes, но терминал, уведомления и настольные инструменты требуют плагин.

Как отключить. Выключите плагин в Hermes Agent и отзовите спаренные устройства в панели Relay. Порядок удаления сервера Relay описан в справочнике по серверу на сайте проекта. С компьютера CLI убирают как обычное приложение, а в Windows есть кнопка аварийной остановки.

Частые вопросы

Как поставить плагин Hermes-Relay в Hermes Agent?

Выполните `hermes plugins install Codename-11/hermes-relay/plugin --enable`, затем `hermes relay doctor` и `hermes relay start --no-ssl`. После обновления панели откройте раздел Relay, нажмите «Pair new device» и отсканируйте QR-код в приложении.

Нужен ли плагин, чтобы говорить с Hermes с телефона?

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

Что агент может делать на телефоне?

В сборке для Google Play агент работает как чат и голосовой помощник. В сборке для установки вручную он дополнительно читает экран, нажимает, печатает, делает снимки и пишет SMS, а банковские приложения по умолчанию закрыты блокировкой.

Как подключить настольный CLI?

Поставьте CLI установщиком со страницы релизов, затем выполните `hermes-relay pair --remote ws://<хост>:8767`. Приглашение из панели подключает компьютер с флагом `--grant-tools`, а фоновый маршрутизатор запускает `hermes-relay daemon start`.

Безопасно ли открывать Relay из интернета?

Проект советует начать с доверенной локальной сети, а вне дома использовать Tailscale между своими устройствами. Прежде чем открывать Relay шире, прочтите руководство по удаленному доступу на hermes-relay.dev.

Обсуждение

Вопросов и отзывов пока нет.

Плагины
Выбор редакции

Самообучающийся агент от Nous Research: терминал, мессенджеры, cron-задачи и скиллы, которые он пишет сам

CLIШирокий доступ262,9 тыс.Звезды репозитория

Пакет из 19 плагинов для Hermes Desktop: квоты провайдеров, счетчик итераций, очередь памяти, управление сессиями и лента RSS.

ПлагинШирокий доступ52Звезды репозитория

Плагин Hermes Agent: голосовые звонки в WhatsApp, вы звоните боту или он звонит вам, речь идет через Gemini Live.

ПлагинШирокий доступ152Звезды репозитория

Официальные плагины Hermes Agent: Home Assistant, Spotify, Blender, Snyk, Langfuse, песочницы и импорт настроек других агентов

ПлагинШирокий доступ665Звезды репозитория

Alice Voice для Hermes

hermes-alice-voice

Российский стек

Голосовой ввод через Яндекс Алису для Hermes Agent: приватный навык отправляет распознанный текст в личный Telegram-диалог. Экспериментальный

ПлагинШирокий доступ11Звезды репозитория

Пакет практичных скиллов для Hermes Agent: заметки, поездки, безопасность кода, браузерная автоматизация, темы оформления.

СкиллРасширенный доступ78Звезды репозитория

Сравнение с похожими

Карточки с тем же главным запросом: чем они отличаются.

ИнструментОфициальныйЗвезды репозиторияГлавное отличие
Hermes-Relay (эта карточка)нет442
Telegram Dashboard для Hermesнет7состояние агента в одном закрепленном сообщении Telegram, без приложения и без терминала
Hermes Field Kitнет127набор скиллов для диагностики и миграции Hermes Agent, без клиента для телефона

Коротко о README

Страница рассказывает, что проект состоит из Android-приложения и настольного CLI для Hermes Agent, и ведет через установку приложения, запуск панели Hermes и подключение. Затем идут возможности Android, описание CLI с таблицей маршрутов и схема соединений между телефоном, панелью, API и Relay.

Бейдж для README

Сообщить о проблеме