Nous Portal

O Nous Portal é o gateway unificado de assinatura da Nous Research e o jeito recomendado de rodar o Hermes Agent. Um login OAuth substitui o malabarismo de contas separadas, chaves de API e relações de cobrança com cada laboratório de modelos, API de busca, gerador de imagem e provedor de navegador que você precisaria ligar na mão.

Se você só tem tempo para configurar uma coisa, configure esta. O caminho mais rápido:

hermes setup --portal

Esse único comando roda o OAuth do Portal, deixa você escolher um modelo da Nous, define a Nous como o seu provedor de inferência no config.yaml e liga o Tool Gateway. Logo depois já dá para rodar hermes chat.

Ainda não tem assinatura? portal.nousresearch.com/manage-subscription — assine e depois volte e rode o comando acima.

O que vem na assinatura

Mais de 300 modelos de fronteira, uma conta só

O Portal serve de intermediário para um catálogo curado de modelos agênticos de todo o ecossistema — cobrados na sua assinatura da Nous em vez de um saldo de crédito por laboratório.

Família	Modelos
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 (chat, veja o recado abaixo)
+ todo o resto	Mais de 280 modelos adicionais — a fronteira agêntica inteira

Nos bastidores, o Portal roteia cada modelo para o backend que melhor o atende — alguns modelos passam pelo OpenRouter, outros por provedores proprietários ou secundários, e o roteamento de um modelo pode mudar com o tempo. De um jeito ou de outro, tudo é cobrado na sua assinatura da Nous. Alterne entre o Claude Sonnet 4.6 para código e o Gemini 3 Pro para contexto longo com /model no meio da sessão — sem credencial nova, sem recarga, sem erro surpresa de saldo zerado.

observação

Como o roteamento é por modelo e nem sempre passa pelo OpenRouter, extensões de requisição específicas do OpenRouter (como preferências de roteamento em provider, roteamento fixo por session_id ou cache_control no nível de topo) não fazem parte do contrato de API do Portal e podem ser ignoradas, dependendo de qual backend serve o modelo.

O Tool Gateway da Nous

A mesma assinatura libera o Tool Gateway, que roteia as chamadas de ferramenta do Hermes Agent pela infraestrutura gerenciada pela Nous. Cinco backends, um login:

Ferramenta	Parceiro	O que faz
Busca e extração na web	Firecrawl	Busca e extração de página inteira em nível de agente. Sem chave de API do Firecrawl, sem ficar de babá do limite de taxa.
Geração de imagem	FAL	Nove modelos num endpoint só: 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.
Síntese de voz	OpenAI TTS	TTS de alta qualidade sem uma chave separada da OpenAI. Habilita o modo de voz nas plataformas de mensagem.
Automação de navegador na nuvem	Browser Use	Sessões de Chromium sem interface para browser_navigate, browser_click, browser_type e browser_vision. Sem precisar de conta na Browserbase.
Sandbox de terminal na nuvem	Modal	Sandboxes de terminal sem servidor para execução de código (complemento opcional).

Sem o gateway, ligar cada uma dessas coisas significa uma conta na Firecrawl, uma na FAL, uma na Browser Use, uma chave da OpenAI e uma conta na Modal — cinco cadastros separados, cinco painéis separados, cinco fluxos de recarga separados. Com o gateway, tudo passa por uma assinatura.

Também dá para ligar só ferramentas específicas do gateway (por exemplo, busca na web mas não geração de imagem) — veja Misturar o gateway com backends seus abaixo.

Nenhuma credencial nos seus dotfiles

Como tudo passa por uma sessão do Portal autenticada por OAuth, você não acumula um arquivo .env com uma dúzia de chaves de API de vida longa. O refresh token em ~/.hermes/auth.json é a única credencial em disco, e o Hermes cunha JWTs de vida curta a partir dele a cada requisição — veja Tratamento de tokens abaixo.

Paridade entre plataformas

O Windows nativo tem na configuração de chave de API por ferramenta o seu ponto mais áspero — criar uma conta na Firecrawl, uma na FAL, uma na Browser Use e uma chave da OpenAI a partir do Windows é a parte de maior atrito para ter um agente útil. Uma assinatura do Portal alisa isso: um OAuth cobre o modelo e toda ferramenta do gateway, então quem usa Windows tem a mesma experiência de quem usa macOS ou Linux, sem configurar quatro backends na mão.

Um recado sobre o Hermes 4

A família Hermes 4 da própria Nous Research (Hermes-4-70B, Hermes-4-405B) está disponível pelo Portal com preço bem descontado. São modelos de chat de fronteira com raciocínio híbrido — bons em matemática, ciências, seguir instruções, respeitar schema, interpretação de papéis e escrita longa.

Mesmo assim, eles não são recomendados para uso dentro do Hermes Agent. O Hermes 4 é afinado para chat e raciocínio, não para o laço rápido de chamada de ferramentas em que o agente se apoia. Use-os em fluxos de pesquisa ou pelo proxy de assinatura a partir de outras ferramentas — mas, para trabalho de agente, escolha um modelo agêntico de fronteira do catálogo:

/model anthropic/claude-sonnet-4.6     # melhor modelo agêntico de uso geral
/model openai/gpt-5.5-pro              # raciocínio forte + chamada de ferramentas
/model google/gemini-3-pro-preview     # janela de contexto enorme
/model deepseek/deepseek-v4-pro        # bom de código e barato

A própria página de informações de modelos do Portal traz o mesmo aviso, então isto não é opinião do lado do Hermes — é a orientação oficial da Nous Research.

Configuração

Instalação nova — um comando

hermes setup --portal

Isso roda a configuração inteira de uma vez:

1. Abre o seu navegador em portal.nousresearch.com para o login OAuth
2. Guarda o refresh token em ~/.hermes/auth.json
3. Deixa você escolher um modelo da Nous na lista curada (ou pular para manter o atual)
4. Define a Nous como o seu provedor de inferência em ~/.hermes/config.yaml (quando você escolhe um modelo)
5. Liga o Tool Gateway (roteamento de web, imagem, TTS e navegador)
6. Devolve você ao terminal pronto para o hermes chat

Se você ainda não tem assinatura, assine primeiro em portal.nousresearch.com/manage-subscription.

Instalação existente — acrescentar o Portal ao lado de outros provedores

Se você já tem o Hermes configurado com OpenRouter, Anthropic ou qualquer outro provedor e quer acrescentar o Portal ao lado deles:

hermes model
# escolha "Nous Portal" na lista de provedores
# o navegador abre, você entra, pronto

Os provedores que você já tinha continuam configurados. Dá para alternar entre eles com /model no meio da sessão ou com hermes model entre sessões — o Portal vira um dos provedores disponíveis, não o único.

Configuração sem interface / por SSH / remota

O OAuth precisa de um navegador, mas o retorno de chamada em loopback roda na máquina onde o Hermes está rodando. Para hosts remotos, veja OAuth por SSH e hosts remotos — os mesmos padrões que valem para qualquer outro provedor baseado em OAuth valem para o Portal (encaminhamento de porta com ssh -L).

Configuração de perfis

Se você usa perfis do Hermes, o refresh token do Portal é compartilhado automaticamente entre todos os perfis por um armazenamento comum de tokens. Faça login uma vez em qualquer perfil e o resto pega o token sozinho — sem repetir o fluxo de OAuth em cada perfil.

O Portal no dia a dia

Inspecionar o que está ligado

hermes portal            # entrar no Nous Portal + configurar (onboarding de uma vez)
hermes portal info       # status de login, dados da assinatura, roteamento de modelo e de gateway
hermes portal status     # apelido de `portal info`
hermes portal tools      # catálogo detalhado do Tool Gateway, com o roteamento de cada ferramenta
hermes portal open       # abrir a página de gestão da assinatura no navegador

O hermes portal (sem subcomando) é o apelido legível de hermes auth add nous --type oauth — ele faz o login, deixa você escolher um modelo da Nous, define a Nous como provedor de inferência e oferece a adesão ao Tool Gateway (idêntico ao hermes setup --portal, e o mesmo fluxo da Nous que a configuração rápida de primeira vez).

O hermes portal info dá a visão geral:

  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

Trocar de modelo

Dentro de uma sessão:

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

Ou abra o seletor:

/model
# setas do teclado, enter para escolher

Fora de uma sessão (o assistente completo de configuração, útil ao acrescentar um provedor novo):

hermes model

Misturar o gateway com backends seus

Se você já tem, digamos, uma conta na Browserbase e quer continuar usando enquanto roteia a busca na web e a geração de imagem pela Nous, isso é suportado. Use o hermes tools para escolher o backend de cada ferramenta:

hermes tools
# → Busca na web       → "Nous Subscription"
# → Geração de imagem  → "Nous Subscription"
# → Navegador          → "Browserbase"  (a sua chave atual)
# → TTS                → "Nous Subscription"

A adesão ao Tool Gateway é por ferramenta, não é tudo ou nada. Os backends gerenciados aparecem no hermes tools esteja você logado ou não no Nous Portal — se você escolher "Nous Subscription" antes de autenticar, o Hermes roda o login do Portal ali mesmo (sem mudar o seu provedor de inferência nem mexer nas suas outras ferramentas). Veja a documentação do Tool Gateway para a matriz completa de configuração por ferramenta.

Gestão da assinatura

Gerencie o seu plano, veja o consumo ou faça upgrade/cancelamento a qualquer hora:

• Web: portal.nousresearch.com/manage-subscription
• Atalho na CLI: hermes portal open (abre a mesma página no seu navegador padrão)

Referência de configuração

Depois do hermes setup --portal, o ~/.hermes/config.yaml vai ficar assim:

model:
  provider: nous
  default: anthropic/claude-sonnet-4.6     # ou o modelo que você escolheu
  base_url: https://inference-api.nousresearch.com/v1

Os ajustes do Tool Gateway ficam nas seções das respectivas ferramentas — cada categoria tem uma única chave de seleção, e escolher Nous Subscription no hermes tools (ou no hermes setup --portal) grava o valor nous:

web:
  backend: nous          # busca/extração na web passam pelo Tool Gateway

image_gen:
  provider: nous

tts:
  provider: nous

browser:
  cloud_provider: nous

O runtime sempre segue a seleção gravada — chaves de API diretas deixadas no .env são ignoradas enquanto a categoria estiver em nous, e escolher um provedor direto (por exemplo, image_gen.provider: fal) sem a chave dele produz um erro claro em vez de redirecionar em silêncio pelo gateway. (Configurações antigas usavam a flag use_gateway: true; ela é lida como equivalente a nous, mas não é mais gravada.)

O refresh token do OAuth fica guardado à parte, em ~/.hermes/auth.json (não no config.yaml — credenciais e configuração ficam separadas de propósito).

Tratamento de tokens

O Hermes cunha um JWT de vida curta a partir do refresh token guardado do Portal a cada chamada de inferência, em vez de reaproveitar uma chave de API de vida longa. O ciclo de vida do token é totalmente automático — renovar, cunhar, tentar de novo num 401 passageiro — e você nunca o vê.

Se o Portal invalida o refresh token (troca de senha, revogação manual, sessão expirada), o refresh token inválido é posto de quarentena localmente para que o Hermes pare de reenviá-lo e você não veja uma enxurrada de 401 iguais. A próxima chamada mostra uma mensagem clara de "re-authentication required". Rode hermes auth add nous para entrar de novo; a quarentena some no primeiro login bem sucedido.

Solução de problemas

O hermes portal info mostra "not logged in"

Você não completou o fluxo de OAuth, ou o seu refresh token foi apagado. Rode:

hermes portal

ou use hermes model e escolha o Nous Portal de novo.

Recebi uma mensagem de "re-authentication required" no meio da sessão

O seu refresh token do Portal foi invalidado (troca de senha, revogação manual ou sessão expirada). Rode hermes auth add nous e a sua próxima requisição vai usar as novas credenciais. Qualquer quarentena do token antigo some sozinha quando o login dá certo.

Quero usar um modelo específico de provedor que o Portal não expõe

O Portal roteia cada modelo para um backend adequado — alguns pelo OpenRouter, outros por provedores proprietários ou secundários —, então a maioria dos modelos que o OpenRouter suporta costuma estar disponível. Se um modelo específico não aparece no /model, tente o slug no estilo do OpenRouter direto:

/model anthropic/claude-opus-4.6

Se um modelo realmente estiver faltando, abra uma issue — nós trazemos o catálogo do Portal para o Hermes, e uma lacuna costuma ser uma configuração de roteamento que dá para atualizar.

As cobranças não aparecem na minha conta do Portal

Confira o hermes portal info primeiro — se ele mostra que você está usando outro provedor (Model: currently openrouter em vez de using Nous as inference provider), a sua configuração local saiu do lugar. Rode hermes model, escolha o Nous Portal, e a próxima requisição vai passar pela sua assinatura.

Veja também

• Tool Gateway — detalhes completos de cada ferramenta do gateway, configuração por ferramenta e preços
• Proxy de assinatura — use a sua assinatura do Portal a partir de ferramentas fora do Hermes (outros agentes, scripts, clientes de terceiros)
• Modo de voz — conversas por voz usando o TTS da OpenAI pelo Portal
• Provedores de IA — o catálogo completo de provedores, se você quiser comparar alternativas
• OAuth por SSH — login a partir de hosts remotos ou de ambientes só com navegador
• Perfis — várias configurações do Hermes compartilhando um login do Portal

---