Pular para o conteúdo principal

Documentação oficial desta página · v0.20.6

Rodar o Hermes Agent com o Nous Portal

Este guia leva você do começo ao fim para rodar o Hermes Agent em uma assinatura do Nous Portal — da inscrição até a conferência de que toda ferramenta está roteando direito. Se você só quer o panorama do que é o Portal e do que vem na assinatura, veja a página de integração do Nous Portal. Esta página é o roteiro de tarefas.

Pré-requisitos​

  • Hermes Agent instalado (Início Rápido)
  • Um navegador na máquina que você está configurando (ou redirecionamento de porta por SSH — veja OAuth por SSH)
  • Cerca de 5 minutos

Você não precisa de: chave da OpenAI, chave da Anthropic, conta na Firecrawl, conta na FAL, conta no Browser Use nem qualquer outra credencial por fornecedor. É justamente esse o ponto.

1. Assine um plano​

Abra portal.nousresearch.com/manage-subscription, crie a conta e escolha um plano.

Já é assinante? Pule para o passo 2.

2. Rode a configuração de uma tacada​

hermes setup --portal

Esse único comando faz cinco coisas:

  1. Abre o seu navegador em portal.nousresearch.com para o login OAuth
  2. Guarda o token de renovação em ~/.hermes/auth.json
  3. Define model.provider: nous no ~/.hermes/config.yaml
  4. Escolhe um modelo agêntico padrão (anthropic/claude-sonnet-4.6 ou parecido)
  5. Liga o Tool Gateway para busca na web, geração de imagem, TTS e automação de navegador

Quando termina, você volta ao terminal pronto para conversar.

E se eu estiver conectado por SSH em um servidor?​

O OAuth precisa de um navegador, mas o callback de loopback roda na máquina em que o Hermes está rodando. Duas opções:

# Opção A: redirecionamento de porta por SSH (preferida)
ssh -N -L 8642:127.0.0.1:8642 usuario@host-remoto    # em um terminal local
hermes setup --portal                              # no remoto, abra a URL impressa no seu navegador local

# Opção B: login por código de dispositivo (funciona no Cloud Shell, Codespaces, EC2 Instance Connect)
hermes auth add nous --type oauth
# Depois rode `hermes setup --portal` de novo para ligar o provedor + gateway

Veja OAuth por SSH / Hosts Remotos para o passo a passo completo, incluindo cadeias de ProxyJump, mosh/tmux e as pegadinhas do ControlMaster.

3. Confirme que funcionou​

hermes portal info

Você deve ver:

  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

Se alguma linha mostrar algo diferente de "via Nous Portal", ou se a linha de autenticação disser "not logged in", vá para a Solução de problemas mais abaixo.

4. Rode a sua primeira conversa​

hermes chat

Tente algo que exercite tanto o modelo quanto o Tool Gateway:

Oi, busque na web por "Hermes Agent release notes" e resuma os 3 primeiros resultados.

Você deve ver o Hermes chamar web_search (com a Firecrawl por trás, pelo gateway) e responder com um resumo. Se a busca roda e a resposta faz sentido, acabou — o Portal está ligado de ponta a ponta.

5. Escolha o modelo que você realmente quer​

O hermes setup --portal deixa você escolher um modelo durante a configuração, mas a razão de ser da assinatura é o acesso ao catálogo inteiro — troque a qualquer momento com /model no meio da sessão:

/model anthropic/claude-sonnet-4.6     # melhor agêntico de uso geral
/model openai/gpt-5.4                  # raciocínio forte + chamada de ferramenta
/model google/gemini-2.5-pro           # janela de contexto enorme
/model deepseek/deepseek-v3.2          # programador de bom custo-benefício
/model anthropic/claude-opus-4.6       # peso-pesado para problemas difíceis

Ou abra o seletor para navegar:

/model

Para fixar outro padrão de forma permanente:

# no seu terminal, fora de qualquer sessão
hermes config set model.default anthropic/claude-sonnet-4.6

Não escolha o Hermes-4 para trabalho de agente​

O Hermes-4-70B e o Hermes-4-405B estão disponíveis no Portal com desconto grande, mas são modelos de conversa/raciocínio, não afinados para chamada de ferramenta. Eles vão penar em laços de agente com vários passos. Use-os para conversa e pesquisa pelo proxy de assinatura, a partir de ferramentas que não sejam de agente. Para o Hermes Agent em si, fique com os modelos agênticos de fronteira listados acima.

A própria página de informações do Portal traz esse aviso também — é a orientação oficial da Nous, não só uma opinião do lado do Hermes.

6. (Opcional) Ajuste o roteamento do Tool Gateway​

O gateway é opcional ferramenta por ferramenta, não tudo ou nada. Se você já tem conta na Browserbase e quer continuar usando ela, mas roteando busca na web e geração de imagem pela Nous, isso é suportado:

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

Essas linhas aparecem em hermes tools mesmo antes de você ter feito login no Nous Portal — se você escolher "Nous Subscription" sem uma sessão ativa, o Hermes roda o login do Portal ali mesmo (sem mudar o seu provedor de inferência nem as suas outras ferramentas).

Confira a sua combinação com:

hermes portal tools

Você vai ver o roteamento de cada ferramenta — via Nous Portal para as que passam pela assinatura, e o nome do parceiro (browserbase, firecrawl etc.) para as que usam as suas próprias chaves.

7. (Opcional) Habilite o modo de voz​

Como o Tool Gateway inclui o TTS da OpenAI, o modo de voz funciona sem uma chave separada da OpenAI:

hermes setup tts
# → escolha "Nous Subscription" para o TTS
# → escolha um backend de fala para texto (o faster-whisper local é gratuito, sem configuração)

Depois, em qualquer sessão de plataforma de mensagens (Telegram, Discord, Signal etc.), mande uma mensagem de voz: o Hermes transcreve, responde e devolve com voz sintetizada — tudo na sua assinatura do Portal.

8. (Opcional) Cron e fluxos sempre ligados​

A assinatura do Portal funciona para tarefas de cron e processamento em lote do mesmo jeito que funciona para conversa interativa — o token de renovação do OAuth é reaproveitado automaticamente. Nada a configurar; basta agendar as tarefas de cron e elas serão cobradas na sua assinatura.

hermes cron create "0 9 * * *" \
  "Busque na web as principais notícias de IA e resuma as 5 mais importantes" \
  --name "Notícias diárias de IA"

A tarefa de cron roda sozinha e chama o modelo, a busca na web e a sumarização, tudo pela sua assinatura do Portal.

Perfis e ambientes com vários usuários​

Se você usa perfis do Hermes (por exemplo, uma configuração separada por projeto), o token de renovação do Portal é compartilhado automaticamente entre todos os perfis, por um repositório de tokens comum. Faça login uma vez em qualquer perfil e os demais aproveitam.

Em ambientes de time, onde várias pessoas compartilham uma máquina, cada pessoa tem a própria conta do Portal → cada diretório home guarda o seu próprio ~/.hermes/auth.json → nada de token compartilhado entre usuários. Essa é a fronteira certa.

Solução de problemas​

hermes portal info mostra "not logged in" depois do hermes setup --portal​

O fluxo de OAuth não terminou. Rode de novo:

hermes portal

Se o seu navegador não abre ou o callback falha, você provavelmente está em um host remoto ou sem interface gráfica — veja OAuth por SSH para as saídas com redirecionamento de porta.

"Model: currently openrouter" (ou outro provedor) em vez de "using Nous as inference provider"​

A sua configuração local ficou fora de sincronia. O OAuth funcionou, mas o model.provider continua apontando para outro provedor. Corrija:

hermes config set model.provider nous

Ou de forma interativa:

hermes model
# escolha Nous Portal

Confira de novo com hermes portal info.

Ferramentas do Tool Gateway mostrando nomes de parceiros em vez de "via Nous Portal"​

A configuração por ferramenta está sobrepondo o gateway. Rode:

hermes tools
# escolha "Nous Subscription" para cada ferramenta que você quer roteada pelo gateway

Algumas pessoas misturam de propósito — por exemplo, roteando a web pela Nous mas usando a própria chave da Browserbase para o navegador. Se é intencional, deixe como está. Se não, este comando resolve.

"Re-authentication required" no meio da sessão​

O seu token de renovação do Portal foi invalidado (troca de senha, revogação manual, sessão expirada). O token agora fica em quarentena local para que o Hermes não fique repetindo a tentativa sem parar. Basta fazer login de novo:

hermes auth add nous

A quarentena é liberada automaticamente quando o novo login dá certo.

O modelo que eu quero não está no seletor do /model​

O catálogo do Portal se baseia na lista de modelos da OpenRouter (mais de 300), somada a modelos servidos por provedores proprietários ou secundários. Se um modelo está faltando, tente digitar o slug no estilo da OpenRouter direto:

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

Se o modelo estiver mesmo indisponível, abra uma issue — a maioria das lacunas é configuração de roteamento que dá para atualizar.

A cobrança não aparece na minha conta do Portal​

O hermes portal info diz se você está de fato roteando pelo Portal ou por outro provedor. Causas comuns:

  • model.provider definido como openrouter/anthropic/etc. em vez de nous
  • Uma falha de renovação do OAuth que caiu em outro provedor configurado
  • Vários perfis do Hermes e você está usando o errado (confira com hermes profile list)

Quero revogar tudo e começar do zero​

hermes auth logout nous       # apaga o token de renovação local
# Depois rode a configuração de novo ou remova a assinatura na interface web do Portal

O que você ganha com isso, em números diretos​

Sem o PortalCom o Portal
1× chave da OpenRouter / Anthropic / OpenAI no .env1× token de renovação do OAuth, nenhuma chave no .env
1× chave da Firecrawl para a webWeb roteada pelo gateway
1× chave da FAL para geração de imagemGeração de imagem roteada pelo gateway
1× chave do Browser Use / Browserbase para o navegadorNavegador roteado pelo gateway
1× chave da OpenAI para TTS / modo de vozTTS roteado pelo gateway
5 painéis, recargas e faturas separados1 assinatura, 1 fatura
Entre máquinas: replicar todas as 5 chavesEntre máquinas: refazer o OAuth uma vez

É esse o acordo. Se você já usa mais de dois desses serviços, a assinatura se paga.

Veja também​