Nous Portal

Nous Portal — единый шлюз по подписке от Nous Research и рекомендуемый способ запускать Hermes Agent. Один вход через OAuth заменяет всю возню с отдельными аккаунтами, API-ключами и платёжными отношениями. Иначе пришлось бы вручную связывать каждую лабораторию моделей, поисковый API, генератор изображений и провайдера браузера по отдельности.

Времени хватает только на одну настройку? Сделайте именно эту. Самый быстрый путь:

hermes setup --portal

Одна команда проводит OAuth Portal, даёт выбрать модель Nous, назначает Nous вашим провайдером инференса в config.yaml и включает Tool Gateway. Сразу после неё запускайте hermes chat.

Подписки ещё нет? Откройте portal.nousresearch.com/manage-subscription, оформите её, затем вернитесь и выполните команду выше.

Что входит в подписку

300+ передовых моделей, один счёт

Portal проксирует отобранный каталог агентных моделей со всей экосистемы. Оплата списывается с подписки Nous, а не с отдельного баланса кредитов у каждой лаборатории.

Семейство	Модели
Anthropic Claude	Opus 4.7, Opus 4.6, Sonnet 4.6, Haiku 4.5
OpenAI	GPT-5.5, GPT-5.5 Pro, GPT-5.4 Mini, GPT-5.4 Nano, GPT-5.3 Codex
Google Gemini	Gemini 3 Pro Preview, Gemini 3 Flash Preview, Gemini 3.1 Pro Preview, Gemini 3.1 Flash Lite Preview
DeepSeek	DeepSeek V4 Pro
Qwen	Qwen3.7-Max, Qwen3.6-35B-A3B
Kimi / Moonshot	Kimi K2.6
GLM / Zhipu	GLM-5.1
MiniMax	MiniMax M2.7
xAI	Grok 4.3
NVIDIA	Nemotron-3 Super 120B-A12B
Tencent	Hunyuan 3 Preview
Xiaomi	MiMo V2.5 Pro
StepFun	Step 3.5 Flash
Hermes	Hermes-4-70B, Hermes-4-405B (чат, см. заметку ниже)
+ всё остальное	280+ дополнительных моделей — весь агентный фронтир

Под капотом маршрутизация идёт через OpenRouter, поэтому доступность моделей и переключение при сбоях совпадают с тем, что вы получили бы по ключу OpenRouter, — только оплата списывается с подписки Nous. Прямо в сессии командой /model переключайтесь с Claude Sonnet 4.6 для кода на Gemini 3 Pro, когда нужно большое окно контекста. Никаких новых учётных данных, никаких пополнений и внезапных ошибок «нулевой баланс».

Nous Tool Gateway

Та же подписка открывает Tool Gateway — он направляет вызовы инструментов Hermes Agent через инфраструктуру под управлением Nous. Пять бэкендов, один вход:

Инструмент	Партнёр	Что делает
Веб-поиск и извлечение	Firecrawl	Поиск и извлечение целых страниц на уровне агента. Без ключа Firecrawl, без возни с лимитами.
Генерация изображений	FAL	Девять моделей под одним эндпоинтом: FLUX 2 Klein 9B, FLUX 2 Pro, Z-Image Turbo, Nano Banana Pro (Gemini 3 Pro Image), GPT Image 1.5, GPT Image 2, Ideogram V3, Recraft V4 Pro, Qwen Image.
Синтез речи	OpenAI TTS	Качественный TTS без отдельного ключа OpenAI. Включает голосовой режим на платформах сообщений.
Облачная автоматизация браузера	Browser Use	Headless-сессии Chromium для `browser_navigate`, `browser_click`, `browser_type`, `browser_vision`. Аккаунт Browserbase не нужен.
Облачная песочница-терминал	Modal	Бессерверные песочницы-терминалы для выполнения кода (опциональное дополнение).

Без шлюза за каждым из этих инструментов стоит свой аккаунт: Firecrawl, FAL, Browser Use, ключ OpenAI и аккаунт Modal — пять регистраций, пять панелей, пять отдельных процессов пополнения. Со шлюзом всё это уходит в одну подписку.

Можно включить и только отдельные инструменты шлюза — например, веб-поиск, но не генерацию изображений. Подробности — в разделе Совмещение шлюза со своими бэкендами ниже.

Nous Chat

Аккаунт Portal покрывает и chat.nousresearch.com — веб-чат от Nous Research с тем же каталогом моделей. Пригодится, когда вы вдали от терминала, или для не-агентной переписки.

Никаких учётных данных в дотфайлах

Раз всё идёт через одну сессию Portal с авторизацией OAuth, файл .env с десятком долгоживущих API-ключей попросту не копится. На диске остаётся единственный секрет — refresh-токен в ~/.hermes/auth.json. Из него Hermes на каждый запрос выпускает короткоживущие JWT, см. Работа с токенами ниже.

Паритет между платформами

У нативного Windows самое слабое место — настройка API-ключей под каждый инструмент. Завести аккаунт Firecrawl, аккаунт FAL, аккаунт Browser Use и ключ OpenAI из-под Windows — самая трудоёмкая часть на пути к рабочему агенту. Подписка Portal сглаживает эту шероховатость: один OAuth покрывает и модель, и каждый инструмент шлюза, так что пользователи Windows получают тот же опыт, что и на macOS/Linux, без ручной настройки четырёх бэкендов.

Заметка о Hermes 4

Собственное семейство Hermes 4 от Nous Research (Hermes-4-70B, Hermes-4-405B) доступно через Portal по сильно сниженным тарифам. Это передовые гибридно-рассуждающие чат-модели: сильны в математике, науке, следовании инструкциям, соблюдении схем, ролевой игре и длинных текстах.

А вот внутри Hermes Agent их использовать не стоит. Hermes 4 заточен под чат и рассуждения, не под скоростной цикл вызова инструментов, на котором держится агент. Берите их для Nous Chat, для исследовательских процессов или через прокси подписки из стороннего инструментария. Для агентной же работы выбирайте из каталога передовую агентную модель:

/model anthropic/claude-sonnet-4.6     # лучшая универсальная агентная модель
/model openai/gpt-5.5-pro              # сильные рассуждения + вызов инструментов
/model google/gemini-3-pro-preview     # огромное окно контекста
/model deepseek/deepseek-v4-pro        # экономичный кодер

То же предупреждение стоит и на собственной странице с информацией о моделях у Portal — значит, это не мнение со стороны Hermes, а официальная рекомендация Nous Research.

Настройка

Свежая установка — одна команда

hermes setup --portal

Команда проводит полную настройку за один заход:

Открывает браузер на portal.nousresearch.com для входа через OAuth
Сохраняет refresh-токен в ~/.hermes/auth.json
Даёт выбрать модель Nous из отобранного списка (или пропустить и оставить текущую)
Назначает Nous вашим провайдером инференса в ~/.hermes/config.yaml (когда вы выбираете модель)
Включает Tool Gateway (маршрутизация веб-поиска, изображений, TTS, браузера)
Возвращает вас в терминал, готовый к hermes chat

Если подписки ещё нет, сначала оформите её на portal.nousresearch.com/manage-subscription.

Существующая установка — добавить Portal рядом с другими провайдерами

Hermes уже настроен на OpenRouter, Anthropic или другого провайдера, а вы хотите добавить Portal рядом? Тогда так:

hermes model
# выберите «Nous Portal» из списка провайдеров
# откроется браузер, войдите — готово

Существующие провайдеры остаются настроенными. Переключайтесь между ними через /model в сессии или hermes model между сессиями — Portal становится одним из доступных провайдеров, а не единственным.

Headless / SSH / удалённая настройка

OAuth требует браузера, но обратный вызов на loopback выполняется на той машине, где запущен Hermes. Для удалённых хостов смотрите OAuth через SSH / удалённые хосты — для Portal работают те же схемы, что и для любого другого провайдера на OAuth: проброс порта ssh -L, --manual-paste для сред только с браузером вроде Cloud Shell / Codespaces.

Настройка профилей

Используете профили Hermes? Refresh-токен Portal автоматически разделяется всеми профилями через общее хранилище токенов. Войдите один раз в любом профиле — остальные подхватят его сами, без повторного потока OAuth для каждого профиля.

Portal в повседневной работе

Проверка того, что подключено

hermes portal            # вход в Nous Portal + настройка (онбординг за один заход)
hermes portal info       # статус входа, данные о подписке, маршрутизация модели и шлюза
hermes portal status     # псевдоним для `portal info`
hermes portal tools      # подробный каталог Tool Gateway с маршрутизацией по инструментам
hermes portal open       # открыть страницу управления подпиской в браузере

hermes portal без подкоманды — человекочитаемый псевдоним для hermes auth add nous --type oauth: он входит за вас, даёт выбрать модель Nous, назначает Nous провайдером инференса и предлагает включить Tool Gateway. Поведение идентично hermes setup --portal и повторяет тот же поток Nous, что и первая быстрая настройка.

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
  Cloud terminal        not configured

Смена моделей

Внутри сессии:

/model anthropic/claude-sonnet-4.6
/model openai/gpt-5.5-pro
/model google/gemini-3-pro-preview

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

/model
# стрелки, enter для выбора

Вне сессии (полный мастер настройки, удобно при добавлении нового провайдера):

hermes model

Совмещение шлюза со своими бэкендами

Допустим, у вас уже есть аккаунт Browserbase и менять его не хочется, а веб-поиск и генерацию изображений хочется пустить через Nous. Так можно. Через hermes tools выбирается бэкенд для каждого инструмента:

hermes tools
# → Веб-поиск             → «Nous Subscription»
# → Генерация изображений → «Nous Subscription»
# → Браузер               → «Browserbase»  (ваш существующий ключ)
# → TTS                   → «Nous Subscription»

Tool Gateway подключается по инструментам, а не по принципу «всё или ничего». Управляемые бэкенды видны в hermes tools независимо от того, вошли вы в Nous Portal или нет: если выбрать «Nous Subscription» до авторизации, Hermes проведёт вход в Portal по ходу — провайдер инференса при этом не сменится, другие инструменты тоже останутся нетронутыми. Полную матрицу настройки по инструментам ищите в документации Tool Gateway.

Управление подпиской

План, статистику использования, повышение или отмену подписки можно поправить в любой момент:

Веб: portal.nousresearch.com/manage-subscription
Ярлык CLI: hermes portal open (открывает ту же страницу в браузере по умолчанию)

Справочник по конфигурации

После hermes setup --portal файл ~/.hermes/config.yaml выглядит так:

model:
  provider: nous
  default: anthropic/claude-sonnet-4.6     # или та модель, что вы выбрали
  base_url: https://inference-api.nousresearch.com/v1

Настройки Tool Gateway лежат в соответствующих секциях инструментов:

web:
  backend: nous       # веб-поиск и извлечение идут через Tool Gateway

image_gen:
  provider: nous

tts:
  provider: nous

browser:
  backend: nous

OAuth refresh-токен хранится отдельно, в ~/.hermes/auth.json, а не в config.yaml: учётные данные и конфигурация разведены намеренно.

Работа с токенами

На каждый вызов инференса Hermes выпускает короткоживущий JWT из сохранённого refresh-токена Portal, а не переиспользует долгоживущий API-ключ. Жизненный цикл токена полностью автоматический — обновление, выпуск, повтор при временном 401, — и вы его не видите.

Допустим, Portal аннулировал refresh-токен: сменили пароль, отозвали доступ вручную, истекла сессия. Тогда недействительный токен уходит в локальный карантин — Hermes перестаёт его переотправлять, и вы не получаете поток одинаковых 401. Следующий вызов покажет понятное сообщение «требуется повторная аутентификация». Войдите снова через hermes auth add nous; карантин снимется при первом же успешном входе.

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

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

Поток OAuth не завершён либо refresh-токен был стёрт. Выполните:

hermes portal

либо запустите hermes model и заново выберите Nous Portal.

Получили «re-authentication required» посреди сессии

Refresh-токен Portal был аннулирован (смена пароля, ручной отзыв или истечение сессии). Выполните hermes auth add nous — следующий запрос пойдёт с новыми учётными данными. Карантин на старом токене снимается автоматически при успешном повторном входе.

Нужна модель конкретного провайдера, которую Portal не показывает

Portal проксирует через OpenRouter, так что почти любая модель из тех, что поддерживает OpenRouter, доступна и здесь. Не видите нужную в /model? Попробуйте slug в стиле OpenRouter напрямую:

/model anthropic/claude-opus-4.6

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

Списания не появляются на моём аккаунте Portal

Начните с hermes portal info. Если там видно, что используется другой провайдер (Model: currently openrouter вместо using Nous as inference provider), локальный конфиг разошёлся с подпиской. Выполните hermes model, выберите Nous Portal — следующий запрос пойдёт через вашу подписку.

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

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