Запуск Hermes Agent через Nous Portal

Этот гайд проводит вас через весь процесс запуска Hermes Agent на подписке Nous Portal — от регистрации до проверки правильной маршрутизации каждого инструмента. Если нужен общий обзор Portal и состава подписки — см. страницу интеграции с Nous Portal. Здесь — конкретный сценарий действий.

Требования

Hermes Agent установлен (Быстрый старт)
Браузер на той же машине, где настраиваете (или проброс SSH-порта — см. OAuth через SSH)
Около 5 минут

Вам не понадобятся: ключ OpenAI, ключ Anthropic, аккаунт веб-поиска, аккаунт FAL, аккаунт Browser Use — никаких отдельных учётных данных сторонних сервисов. В этом и смысл.

1. Оформите подписку

Откройте portal.nousresearch.com/manage-subscription, зарегистрируйтесь и выберите план.

Уже подписаны? Переходите к шагу 2.

2. Запустите одноразовую настройку

hermes setup --portal

Одна команда делает пять вещей:

Открывает браузер на portal.nousresearch.com для OAuth-входа
Сохраняет refresh-токен в ~/.hermes/auth.json
Устанавливает model.provider: nous в ~/.hermes/config.yaml
Выбирает модель по умолчанию для агентской работы (anthropic/claude-sonnet-4.6 или аналогичную)
Включает Tool Gateway для веб-поиска, генерации изображений, TTS и браузерной автоматизации

По завершении вы возвращаетесь в терминал и можете сразу общаться с агентом.

А если я подключён по SSH?

OAuth требует браузера, но loopback-колбэк работает на той машине, где запущен Hermes. Два варианта:

# Вариант A: проброс SSH-порта (рекомендуется)
ssh -N -L 8642:127.0.0.1:8642 user@remote-host    # в локальном терминале
hermes setup --portal                              # на удалённой машине, откройте напечатанный URL в локальном браузере

# Вариант B: вход по коду устройства (работает в Cloud Shell, Codespaces, EC2 Instance Connect)
hermes auth add nous --type oauth
# Затем снова запустите `hermes setup --portal` для привязки провайдера и шлюза

Полный разбор — включая цепочки ProxyJump, mosh/tmux и нюансы ControlMaster — в разделе OAuth через SSH / удалённые хосты.

3. Проверьте результат

hermes portal info

Должно появиться:

  Nous Portal
  ───────────
  Auth:    ✓ logged in
  Portal:  https://portal.nousresearch.com
  Model:   ✓ using Nous as inference provider

  Tool Gateway
  ────────────
  Web search & extract  via Nous Portal
  Image generation      via Nous Portal
  Text-to-speech        via Nous Portal
  Browser automation    via Nous Portal

Если какая-то строка показывает не «via Nous Portal» или авторизация показывает «not logged in» — переходите к разделу Решение проблем ниже.

4. Проведите первый разговор

hermes chat

Попробуйте что-то, что задействует и модель, и Tool Gateway:

Hey, search the web for "Hermes Agent release notes" and summarize the top 3 hits.

Hermes вызовет web_search (через шлюз) и выдаст краткую сводку. Если поиск прошёл и ответ осмысленный — готово, Portal работает от начала до конца.

5. Выберите нужную модель

hermes setup --portal позволяет выбрать модель при настройке, но весь смысл подписки — доступ к полному каталогу. Переключайте в любой момент командой /model прямо в сессии:

/model anthropic/claude-sonnet-4.6     # лучший универсальный агентский
/model openai/gpt-5.4                  # сильный в рассуждениях и вызовах инструментов
/model google/gemini-2.5-pro           # огромное контекстное окно
/model deepseek/deepseek-v3.2          # экономичный кодер
/model anthropic/claude-opus-4.6       # тяжёлая артиллерия для сложных задач

Или откройте интерактивный выбор:

/model

Установить другую модель по умолчанию навсегда:

# в терминале, вне сессии
hermes config set model.default anthropic/claude-sonnet-4.6

Не используйте Hermes-4 для агентской работы

Hermes-4-70B и Hermes-4-405B доступны на Portal со значительной скидкой, но это модели для чата и рассуждений, а не заточенные под вызов инструментов. В многошаговых агентских циклах они будут давать сбои. Используйте их для диалога и исследований через прокси подписки в неагентских инструментах. Для самого Hermes Agent — берите современные агентские модели из списка выше.

Это предупреждение есть и на странице info самого Portal — это официальная позиция Nous, не только мнение Hermes.

6. (Опционально) Настройте маршрутизацию Tool Gateway

Шлюз настраивается по каждому инструменту отдельно — не всё или ничего. Если у вас есть аккаунт Browserbase и вы хотите оставить его для браузера, а веб-поиск и генерацию изображений пустить через Nous — это поддерживается:

hermes tools
# → Web search       → "Nous Subscription"     (рекомендуется)
# → Image generation → "Nous Subscription"     (рекомендуется)
# → Browser          → "Browserbase"           (ваш ключ)
# → TTS              → "Nous Subscription"     (рекомендуется)

Эти строки видны в hermes tools даже до входа в Nous Portal — если выбрать «Nous Subscription» без активной сессии, Hermes запустит вход в Portal прямо здесь (не трогая провайдер вывода и другие инструменты).

Проверьте свою конфигурацию:

hermes portal tools

Вы увидите маршрутизацию по каждому инструменту: via Nous Portal для тех, что идут через подписку, и название партнёра (browserbase, firecrawl и т.д.) для тех, что используют ваши собственные ключи.

7. (Опционально) Включите голосовой режим

Поскольку Tool Gateway включает OpenAI TTS, голосовой режим работает без отдельного ключа OpenAI:

hermes setup tts
# → выберите "Nous Subscription" для TTS
# → выберите бэкенд распознавания речи (локальный faster-whisper бесплатен, без настройки)

После этого в любой сессии мессенджера (Telegram, Discord, Signal и т.д.) отправьте голосовое сообщение — Hermes транскрибирует его, ответит и озвучит ответ. Всё за счёт подписки Portal.

8. (Опционально) Cron и постоянные задачи

Подписка Portal работает для cron-задач и пакетной обработки ровно так же, как для интерактивного чата — OAuth refresh-токен переиспользуется автоматически. Никаких дополнительных настроек: просто создавайте cron-задачи, и они будут тарифицироваться по вашей подписке.

hermes cron create "0 9 * * *" \
  "Search the web for top AI news and summarize the 5 most important stories" \
  --name "Daily AI news"

Задача выполняется без участия человека: модель, веб-поиск и суммаризация — всё через подписку Portal.

Профили и многопользовательские настройки

Если вы используете профили Hermes (например, отдельный конфиг на проект), каждый профиль — независимый остров учётных данных: профиль, который ни разу не входил в Portal, получает отказ, а не перенимает сессию другого профиля. Войдите по одному разу в каждом профиле командой hermes -p <name> portal. Если на машине уже есть общая сессия Portal, команда предложит импортировать её без похода в браузер, и дальше общее хранилище токенов будет поддерживать токен этого профиля актуальным. См. Настройка профилей.

Для командных сценариев, где несколько человек работают на одной машине: у каждого свой аккаунт Portal → каждая домашняя директория хранит свой ~/.hermes/auth.json → токены не пересекаются между пользователями. Это правильная граница.

Решение проблем

`hermes portal info` показывает «not logged in» после `hermes setup --portal`

OAuth-поток не завершился. Запустите его снова:

hermes portal

Если браузер не открылся или колбэк не прошёл — вы, скорее всего, на удалённом или безголовом хосте. См. OAuth через SSH для вариантов с пробросом порта.

«Model: currently openrouter» (или другой провайдер) вместо «using Nous as inference provider»

Локальный конфиг разошёлся с ожидаемым. OAuth сработал, но model.provider всё ещё указывает на другой провайдер. Исправьте:

hermes config set model.provider nous

Или интерактивно:

hermes model
# выберите Nous Portal

Проверьте снова через hermes portal info.

Инструменты Tool Gateway показывают имена партнёров вместо «via Nous Portal»

Настройки по отдельным инструментам перекрывают шлюз. Запустите:

hermes tools
# выберите "Nous Subscription" для нужных инструментов

Некоторые пользователи намеренно смешивают — например, веб через Nous, а браузер через собственный Browserbase. Если это так — оставьте как есть. Если нет — эта команда исправит.

«Re-authentication required» в середине сессии

Ваш Portal refresh-токен стал недействительным (смена пароля, ручный отзыв, истечение сессии). Токен автоматически помещён в карантин, чтобы Hermes не повторял его бесконечно. Просто войдите заново:

hermes auth add nous

Карантин снимается автоматически после успешного повторного входа.

Нужная модель не появляется в выборе `/model`

Каталог Portal опирается на список моделей OpenRouter (300+), плюс модели, доступные через собственных и вторичных провайдеров. Если модель отсутствует, попробуйте ввести slug в стиле OpenRouter напрямую:

/model anthropic/claude-opus-4.6
/model openai/o1-2025-12-17

Если модель действительно недоступна — откройте issue: большинство пробелов — это конфиг маршрутизации, который легко обновить.

Расходы не отображаются в аккаунте Portal

hermes portal info покажет, действительно ли вы идёте через Portal или через другой провайдер. Частые причины:

model.provider указывает на openrouter/anthropic/и т.д. вместо nous
Сбой обновления OAuth, после которого произошёл откат на другой провайдер
Несколько профилей Hermes — вы используете не тот (проверьте hermes profile list)

Хочу отозвать токен и начать заново

hermes auth logout nous       # удаляет локальный refresh-токен
# Затем повторно запустите настройку или отмените подписку через веб-интерфейс Portal

Что это даёт в цифрах

Без Portal	С Portal
1× ключ OpenRouter / Anthropic / OpenAI в `.env`	1× OAuth refresh-токен, никаких ключей в `.env`
1× ключ веб-поиска	Веб через шлюз
1× ключ FAL для генерации изображений	Генерация изображений через шлюз
1× ключ Browser Use / Browserbase для браузера	Браузер через шлюз
1× ключ OpenAI для TTS / голоса	TTS через шлюз
5 отдельных дашбордов, пополнений, счетов	1 подписка, 1 счёт
На новой машине: реплицировать все 5 ключей	На новой машине: OAuth один раз

Вот и всё. Если вы так или иначе используете больше двух из этих бэкендов — подписка окупает себя сама.

Смотрите также

Страница интеграции с Nous Portal — обзор состава подписки
Tool Gateway — подробности по каждому инструменту шлюза
Прокси подписки — используйте Portal-подписку из не-Hermes инструментов
Голосовой режим — настройка голосового общения на подписке Portal
OAuth через SSH — паттерны входа с удалённых и безголовых хостов
Профили — одна Portal-авторизация на несколько конфигов Hermes