Nous Tool Gateway

Uma assinatura. Todas as ferramentas inclusas.

O Tool Gateway vem com toda assinatura paga do Nous Portal. Ele roteia as chamadas de ferramenta do Hermes — busca na web, geração de imagem, síntese de voz e automação de navegador na nuvem — por uma infraestrutura que a Nous já opera, para que você não precise criar conta na Firecrawl, na FAL, na OpenAI, na Browser Use nem em ninguém só para deixar o seu agente útil.

Assinar ou gerenciar a assinatura →

O que está incluso

	Ferramenta	O que você ganha
🔍	Busca e extração na web	Busca na web e extração de página inteira em nível de agente, via Firecrawl. Sem se preocupar com limite de taxa — o gateway cuida da escala.
🎨	Geração de imagem	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. Escolha por geração com uma flag, ou deixe o Hermes usar o FLUX 2 Klein por padrão.
🔊	Síntese de voz	Vozes do TTS da OpenAI ligadas à ferramenta text_to_speech. Solte notas de voz no Telegram, gere áudio para pipelines, narre qualquer coisa.
🌐	Automação de navegador na nuvem	Sessões de Chromium sem interface via Browser Use. browser_navigate, browser_click, browser_type, browser_vision — todos os primitivos que o agente usa, sem precisar de conta na Browserbase.

As quatro são cobradas conforme o uso na sua assinatura da Nous. Use qualquer combinação — rode o gateway para web e imagens mantendo a sua própria chave da ElevenLabs para TTS, ou roteie tudo pela Nous.

Por que isso existe

Montar um agente que de fato faz coisas significa costurar cinco assinaturas de API ou mais — cada uma com o próprio cadastro, limite de taxa, cobrança e manias. O gateway junta tudo numa conta só:

• Uma conta a pagar. Pague à Nous; o resto é com a gente.
• Um cadastro. Sem contas de Firecrawl, FAL, Browser Use ou de áudio da OpenAI para administrar.
• Uma chave. O seu OAuth do Nous Portal cobre toda ferramenta.
• Mesma qualidade. Os mesmos backends do caminho de chave direta — só que com a gente na frente.

Traga as suas próprias chaves quando quiser — por ferramenta, na hora que quiser. O gateway não é uma amarra, é um atalho.

Comece

Há três portas de entrada — escolha a que combina com o seu momento:

hermes setup --portal     # Instalação nova: OAuth da Nous + Nous como provedor + Tool Gateway ligado, de uma vez

hermes model              # Troca o seu provedor de inferência para o Nous Portal — aí o Hermes oferece ligar o gateway em todas as ferramentas

hermes tools              # Liga o gateway por ferramenta — escolha "Nous Subscription" em cada uma que quiser

O hermes setup --portal e o hermes model são os caminhos de tudo de uma vez: você entra uma vez e, se quiser, joga toda ferramenta para o gateway. O hermes tools é o caminho à la carte — ligue só as ferramentas que quiser, uma de cada vez.

Você não precisa entrar antes. No hermes tools, os backends gerenciados pela Nous (busca na web, imagem, vídeo, TTS, navegador) aparecem sempre, mesmo que você nunca tenha entrado no Nous Portal. Escolha um e o Hermes roda o login do Portal ali mesmo, se você ainda não estiver autenticado — sem precisar rodar hermes model antes. Se o seu OAuth da Nous já está ativo, escolher o backend o liga na hora, sem pergunta extra. Esse caminho só faz o login e liga a única ferramenta que você escolheu — ele não troca o seu provedor de inferência e não pergunta se você quer ligar o gateway em todas as outras ferramentas.

Confira a qualquer hora o que está ativo:

hermes portal info        # autenticação no Portal + resumo do roteamento do Tool Gateway
hermes portal tools       # catálogo do gateway com o roteamento atual de cada ferramenta
hermes status             # status completo do sistema (o Tool Gateway é uma das seções)

O hermes portal info mostra uma seção assim:

◆ Nous Tool Gateway
  Nous Portal     ✓ managed tools available
  Web tools       ✓ active via Nous subscription
  Image gen       ✓ active via Nous subscription
  TTS             ✓ active via Nous subscription
  Browser         ○ active via Browser Use key

As ferramentas marcadas com "active via Nous subscription" estão passando pelo gateway. O resto está usando as suas próprias chaves.

Quem tem direito

O Tool Gateway é um recurso de assinatura paga. Contas gratuitas da Nous podem usar o Portal para inferência, mas não incluem as ferramentas gerenciadas — faça upgrade do seu plano para liberar o gateway.

Algumas contas também têm direito a um pool gratuito de ferramentas — uma pequena franquia de ferramentas gerenciadas que cobre chamadas do gateway sem assinatura paga. Quando existe um pool gratuito, o gateway o expõe e mostra um convite de configuração no primeiro uso, para que você possa aderir e começar a usar as ferramentas gerenciadas na hora.

A lista de ativação

Escolher um modelo da Nous (hermes model) apresenta uma lista de verificação com os backends do gateway, ferramenta por ferramenta. O comportamento dela respeita a sua configuração atual:

• Ferramentas que você apontou explicitamente para outro backend (por exemplo, web.backend: searxng, browser.cloud_provider: camofox) nunca são oferecidas — a sua escolha não pode ser sobrescrita por acidente.
• Ferramentas configuradas só por variáveis de ambiente (por exemplo, SEARXNG_URL, CAMOFOX_URL) são oferecidas desmarcadas, com um rótulo indicando que o seu backend será mantido.
• Só as ferramentas realmente não configuradas vêm marcadas de saída.
• As recusas grudam: se você enviar a lista com uma ferramenta desmarcada, ela não virá marcada nas próximas trocas de modelo da Nous (isso fica em tool_gateway_declined_tools, no config.yaml; marcá-la depois apaga a recusa).

Misture como quiser

O gateway é por ferramenta. Ligue só o que você quer:

• Tudo pela Nous — o mais fácil; uma assinatura e pronto.
• Gateway para web e imagens, TTS por sua conta — mantenha a sua voz da ElevenLabs e deixe a Nous cuidar do resto.
• Gateway só para o que você não tem chave — "eu já pago a Browserbase, mas não quero uma conta na Firecrawl" funciona direitinho.

Troque qualquer ferramenta a qualquer hora com:

hermes tools          # seletor interativo para cada categoria de ferramenta

Escolha a ferramenta e selecione Nous Subscription como provedor (ou qualquer provedor direto que você prefira). Não precisa editar configuração. Se você ainda não entrou no Nous Portal, escolher Nous Subscription dispara o login do Portal ali mesmo — não é preciso autenticar antes pelo hermes model.

Usar modelos de imagem individuais

A geração de imagem usa o FLUX 2 Klein 9B por padrão, por velocidade. Sobrescreva por chamada passando o ID do modelo à ferramenta image_generate:

Modelo	ID	Melhor para
FLUX 2 Klein 9B	fal-ai/flux-2/klein/9b	Rápido, bom padrão
FLUX 2 Pro	fal-ai/flux-2-pro	FLUX de maior fidelidade
Z-Image Turbo	fal-ai/z-image/turbo	Estilizado, rápido
Nano Banana Pro	fal-ai/nano-banana-pro	Google Gemini 3 Pro Image
GPT Image 1.5	fal-ai/gpt-image-1.5	Geração de imagem da OpenAI, texto+imagem
GPT Image 2	fal-ai/gpt-image-2	O mais recente da OpenAI
Ideogram V3	fal-ai/ideogram/v3	Adesão forte ao prompt + tipografia
Recraft V4 Pro	fal-ai/recraft/v4/pro/text-to-image	Estilo vetorial, design gráfico
Qwen Image	fal-ai/qwen-image	Multimodal da Alibaba

O conjunto muda com o tempo — hermes tools → Image Generation mostra a lista viva atual.

---

Referência de configuração

Quase ninguém precisa mexer nisto — o hermes model e o hermes tools cobrem todo fluxo de forma interativa. Esta seção é para quem escreve o config.yaml direto ou automatiza a instalação.

Uma chave de seleção por categoria de ferramenta

Cada categoria de ferramenta tem uma única chave de seleção de provedor, gravada pelo seletor do hermes tools (ou pela interface do desktop). Escolher a linha Nous Subscription guarda o valor nous, que roteia aquela categoria pelo Tool Gateway gerenciado. Escolher uma linha de chave própria guarda o nome do fornecedor (fal, openai, firecrawl, browser-use, …), que vai direto com as suas credenciais:

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

image_gen:
  provider: nous         # geração de imagem pelo Tool Gateway

tts:
  provider: nous         # TTS pelo Tool Gateway

stt:
  provider: nous         # fala para texto pelo Tool Gateway

browser:
  cloud_provider: nous   # navegador na nuvem pelo Tool Gateway

O runtime sempre usa a seleção gravada — a presença de uma credencial nunca escolhe nem redireciona uma categoria. Uma FAL_KEY largada no .env é ignorada enquanto image_gen.provider: nous; do outro lado, image_gen.provider: fal sem uma FAL_KEY definida produz um erro claro em vez de recair em silêncio para o gateway:

image_gen is configured to use fal (set via hermes tools), but FAL_KEY is not set. Run 'hermes tools' to change it.

Categorias que você nunca configurou (nenhuma chave de seleção jamais gravada) detectam sozinhas a partir das credenciais disponíveis, como antes. Mas, uma vez que existe uma seleção, acrescentar uma chave ao .env não muda a rota — só o hermes tools (ou editar a chave de seleção) muda.

Voltar para as suas próprias chaves

hermes tools    # escolha a ferramenta → selecione um provedor direto (por exemplo, Firecrawl)

Ou defina a chave de seleção direto:

web:
  backend: firecrawl   # agora o Hermes usa a FIRECRAWL_API_KEY do .env

Flag antiga use_gateway (descontinuada)

Versões antigas do Hermes usavam um booleano use_gateway: true por ferramenta para rotear pelo gateway. Essa flag é legada: ela não é mais gravada, e o seletor do hermes tools a remove da configuração da categoria quando reescreve a seleção. Configurações antigas que ainda contêm use_gateway: true são interpretadas na leitura como a seleção nous, então as instalações existentes continuam funcionando. Não defina use_gateway em configurações novas — escolha o provedor no hermes tools.

Gateway auto-hospedado (avançado)

Rodando o seu próprio gateway compatível com o da Nous? Sobrescreva os endpoints em ~/.hermes/.env:

TOOL_GATEWAY_DOMAIN=seu-dominio.exemplo.com
TOOL_GATEWAY_SCHEME=https
TOOL_GATEWAY_USER_TOKEN=seu-token        # normalmente preenchido sozinho pelo login do Portal
FIRECRAWL_GATEWAY_URL=https://...         # sobrescreve um endpoint específico

Esses botões existem para infraestruturas sob medida (implantações corporativas, ambientes de desenvolvimento). Quem só assina nunca os define.

Perguntas frequentes

Funciona com o Telegram / Discord / os outros gateways de mensagem?

Sim. O Tool Gateway atua na camada de execução de ferramentas, não na CLI. Toda interface capaz de chamar uma ferramenta — CLI, Telegram, Discord, Slack, IRC, Teams, o servidor de API, qualquer uma — se beneficia dele de forma transparente.

O que acontece se a minha assinatura vencer?

As ferramentas roteadas pelo gateway param de funcionar até você renovar ou trocar por chaves de API diretas pelo hermes tools. O Hermes mostra um erro claro apontando para o portal.

Dá para ver o consumo ou o custo por ferramenta?

Dá — o painel do Nous Portal abre o consumo por ferramenta, então você vê o que está puxando a sua conta.

O Modal (terminal sem servidor) está incluso?

O Modal está disponível como complemento opcional pela assinatura da Nous, e não faz parte do pacote padrão do Tool Gateway. Configure-o com hermes setup terminal ou direto no config.yaml quando quiser um sandbox remoto para executar shell.

Preciso apagar as minhas chaves de API atuais ao ligar o gateway?

Não — deixe-as no .env. Enquanto a seleção de uma ferramenta for Nous Subscription, as chaves diretas daquela ferramenta são simplesmente ignoradas. Escolha o provedor direto de novo no hermes tools e as suas chaves voltam a ser a fonte. O gateway não é uma amarra.

---