Hermes Tool Router — плагин
Hermes Agent тратит меньше токенов на старте: плагин отсекает лишние наборы инструментов и откатывается при сомнении.
- 145 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Плагин меняет набор инструментов, который видит модель на первом ходу.
- Включенный классификатор отправляет текст первого запроса в OpenRouter или на локальный сервер.
Установка
- Работает в
Ручная установка
hermes profile create router-test --clone
mkdir -p ~/.hermes/profiles/router-test/plugins
cp -R . ~/.hermes/profiles/router-test/plugins/hermes-token-routerКопировать надо из корня клона репозитория в тестовый профиль. Затем включите плагин в его `config.yaml` и начните свежую сессию.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Плагин меняет набор инструментов, который видит модель на первом ходу.
- Включенный классификатор отправляет текст первого запроса в OpenRouter или на локальный сервер.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Плагин сокращает список инструментов в первом запросе Hermes Agent к модели. На первом ходу он определяет, какие наборы инструментов нужны задаче, и отправляет только их. Если уверенность ниже порога 0.90, остается полный набор. Когда позже понадобится отрезанный инструмент, Hermes добавляет его набор на всю оставшуюся сессию, а модель может запросить набор сама через `request_toolset`. Правила работают без ключей. Необязательный классификатор разбирает неоднозначные запросы: в README пример с моделью `google/gemini-3.5-flash-lite` через OpenRouter. По умолчанию плагин выключен.
Для кого. Пользователям Hermes Agent с большим числом инструментов, у которых первый запрос раздувается схемами, и тем, кто следит за расходом токенов.
Подходит, если
- Стартовый запрос Hermes тянет десятки схем инструментов, а большинству задач нужны два-три набора.
- Профиль подключен к нескольким интеграциям и мессенджерам, и список инструментов сильно разросся.
- Расход токенов сравнивают до и после: `/router off` и `/router on` переключают маршрутизацию без правки конфигурации.
- Совместимость с версией Hermes неясна, и `python diagnostics.py` покажет, есть ли маршрут до запроса к провайдеру.
Не подходит, если
- Основной профиль в боевой работе: автор советует сначала проверять плагин на отдельном профиле.
- Запускают одноразовый `hermes -z`: там команда `/router` не работает, текст сразу уходит модели.
- Первый запрос нельзя отправлять внешним сервисам: включенный классификатор передает его на классификацию.
Пример запроса к агенту
Выполни `/router status`, покажи, какие наборы инструментов остались после маршрутизации, и сравни стартовый запрос с выключенным роутером.Ограничения
Плагин экспериментальный и по умолчанию выключен: его включают значением `enabled: true` для нужного профиля в `config.yaml` и начинают свежую сессию. Экономия на первом ходу зависит от версии Hermes: код выхода 2 у `python diagnostics.py` значит, что обещать ее нельзя. Цифры в README получены оценщиком токенов Hermes и замерами автора, а не счетами провайдера. Классификатор добавляет один короткий сетевой запрос и требует `OPENROUTER_API_KEY` либо локальную модель. Резервные копии храните вне `plugins/`: каталог с `plugin.yaml` Hermes принимает за отдельный живой плагин.
Как отключить. `/router off` отключает маршрутизацию в работающем процессе, а `HERMES_TOKEN_ROUTER_ENABLED=0` служит выключателем, который `/router on` не перекрывает. Чтобы убрать плагин, удалите каталог `plugins/hermes-token-router` профиля.
Частые вопросы
Как установить Hermes Tool Router?
Создайте тестовый профиль `hermes profile create router-test --clone`, скопируйте репозиторий в `plugins/hermes-token-router` этого профиля и включите плагин в его `config.yaml`. Затем начните свежую сессию.
Нужен ли ключ OpenRouter?
Нет. Правила работают без ключа, но неоднозначные запросы тогда получают полный набор инструментов. Ключ `OPENROUTER_API_KEY` включает быстрый классификатор.
Что будет, если роутер отрезал нужный инструмент?
Hermes добавит набор этого инструмента на всю сессию, и вызов продолжится обычным путем. Роутер отрезает инструменты только при уверенности от 0.90.
Как включать и выключать роутер на лету?
Командами `/router on`, `/router off`, `/router reset` и `/router status`. В одноразовом `hermes -z` они не работают.
Как проверить, что экономия на первом ходу возможна?
Запустите `python diagnostics.py`. Код выхода 0 значит, что маршрут до запроса к провайдеру есть; код 2 значит, что обещать экономию на первом ходу нельзя.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныПакет из 19 плагинов для Hermes Desktop: квоты провайдеров, счетчик итераций, очередь памяти, управление сессиями и лента RSS.
Пакет практичных скиллов для Hermes Agent: заметки, поездки, безопасность кода, браузерная автоматизация, темы оформления.
Официальные плагины Hermes Agent: Home Assistant, Spotify, Blender, Snyk, Langfuse, песочницы и импорт настроек других агентов
Провайдер памяти для Hermes Agent: дубликаты сводятся, противоречия видны, а у каждого воспоминания есть причина выдачи.
Тринадцать стабильных и шесть экспериментальных скиллов для Hermes Agent: диагностика стека, миграция, аудит токенов и скиллов
Agent Skills от moonlight-lupin
agent-skills
Каталог скиллов и плагинов для Hermes Agent: исследования, медиа, скрейпинг, документы, DevOps и сопровождение самого агента.
Коротко о README
Схема версии 0.2 в документации такая: маршрутизация только на первом ходу, закрепленный за сессией набор и необратимое пополнение. Отдельно разобраны совместимость, диагностика и работа профилей. В конце замеры: на живом реестре из 39 инструментов схема для запроса про веб сжимается с 18 627 до 490 токенов по оценке Hermes.