Você instala o Hermes em uma máquina nova, ou só quer sentir como ele é antes de comprar uma API key em qualquer lugar. A sequência antiga era: rodar hermes setup, criar conta em algum console de provider, copiar a chave, colar — quinze minutos de configuração antes de você ter dito uma única palavra ao agent.

Esse passo agora é opcional. O Hermes configura uma identidade Nous gratuita na inicialização, então você pode conversar com ele em um modelo padrão imediatamente, e fazer login depois, quando de fato quiser o catálogo completo e as ferramentas pagas.

O que acontece sem nada configurado

Na primeira inicialização, o Hermes passa alguns segundos configurando o free tier, exibido como «Setting up free inference…». Depois disso:

• a inferência roda em um único modelo chamado nous/welcome;
• o banner e hermes auth status mostram Nous · free tier · nous/welcome;
• hermes model lista uma linha Nous · free tier com esse único modelo.

Nenhum wizard aparece e nada é forçado. O hermes setup continua lá sempre que você quiser configurar um provider próprio.

Uma ressalva: o free tier ainda está sendo liberado aos poucos. Enquanto não estiver ativo para todos, nada disso acontece a menos que o processo tenha sido iniciado com HERMES_GUEST_ONBOARDING=1 em seu ambiente — e note que a variável só aceita 1; true não vale. Com ela não definida, uma instalação nova se comporta exatamente como antes: o seletor de provider da primeira execução.

O que o free tier dá e o que ele não dá

	Free tier	Depois de fazer login
Inferência	nous/welcome (um modelo)	Catálogo completo de modelos do Nous Portal
Connectors (Gmail, Linear, Notion, …)	Sim	Sim
Ferramentas pagas (busca na web, geração de imagem, TTS, navegador na nuvem)	Não	Sim, cobradas na sua assinatura
Créditos ou saldo	Nenhum	Sim

«Connectors» são as contas de terceiros que você vincula no portal Nous para que o agent possa agir dentro delas. Eles funcionam no free tier sem nenhum login — o que é grande parte da razão de o free tier existir.

O trabalho em segundo plano também roda no mesmo modelo: compactação de conversa, títulos de chat, entendimento de imagem e tarefas domésticas semelhantes passam todas por nous/welcome.

O free tier é o último recurso, nunca uma preferência. Qualquer provider que você configurar vence:

Você tem	A inferência roda em	Connectors
Nada	Free tier da Nous (nous/welcome)	Free tier
Uma API key no .env (OpenRouter, OpenAI, Anthropic, …)	Sua chave	Free tier
model.provider definido em config.yaml	Aquele provider	Free tier
Um login no Nous Portal	Nous Portal	Sua conta

Uma instalação que já tem um provider ainda configura o free tier uma vez na inicialização, para que os connectors tenham com o que se autenticar; seu provider continua fazendo a inferência, e um aviso único informa isso.

Dois detalhes que causam confusão fácil. Se model.default no config.yaml nomeia outra coisa enquanto o free tier está fazendo a inferência, o Hermes usa nous/welcome de qualquer forma e diz isso em uma linha. E se você pedir um modelo que o free tier não pode servir, ele não troca em silêncio — ele aponta um caminho:

gpt-5 needs a Nous account or an API key. Use /login to sign in, or /model to pick another provider.

Chamar uma ferramenta paga diz This needs a Nous account. Use /login to sign in. dentro de um chat, e indica hermes auth upgrade no terminal. O turno em si continua sem ela.

Quando você deve fazer login

Onde quer que o free tier esteja presente — incluindo instalações que rodam inferência com a própria chave — há duas formas de entrar.

A partir de um chat. Envie /login em uma mensagem direta (Telegram, Discord, Slack e outros; no Slack use /hermes login, e também funciona em uma sessão de chat da CLI). Precisa ser uma mensagem direta pareada: em outros lugares o Hermes responde Sign in from a direct message with Hermes. Você recebe três mensagens — o link de consentimento, o código de login em sua própria linha, e então um aviso de espera que começa com Do not share this code. Você pode continuar conversando enquanto o Hermes espera, e o resultado é enviado para a mesma DM. Rodar /login de novo substitui o código anterior.

A partir de um terminal.

hermes auth upgrade

Ele imprime uma URL e um código curto e abre o navegador, a menos que você passe --no-browser ou esteja em uma sessão SSH. Depois de confirmar no navegador, o terminal diz Signed in as [email protected]. Se seu modelo padrão era nous/welcome, uma segunda linha nomeia o modelo que sua conta agora usa.

A inferência passa para o catálogo da sua conta, as ferramentas pagas são liberadas, e hermes auth status para de mostrar a linha do free tier. Um modelo padrão que você mesmo escolheu é deixado como está.

Duas coisas que vale saber de antemão:

1. Uma conta por instalação. /login vincula toda a instalação à conta que aprova o código: sua inferência, seus connectors, todo chat que ela atende. Em um gateway onde várias pessoas podem mandar DM para o bot, defina allow_admin_from para a plataforma, de modo que só um operador possa rodá-lo.
2. hermes auth add nous --type oauth também faz login, mas substitui o free tier de vez e não leva seus connectors junto. Use /login, ou hermes auth upgrade, quando você tem connectors que quer manter.

Os quatro lugares onde o desktop mostra isso

O app desktop roda no mesmo free tier, exposto em quatro pontos:

Onde	O que você vê
Primeira inicialização	Uma tela de prontidão: «Hermes is ready.» com o modelo padrão nous/welcome, um selo Free tier e Begin; «Sign in with a Nous account instead» e «Other providers» ficam logo abaixo. Aparece uma vez.
Primeira inicialização com sua própria API key já presente	Uma faixa única acima do composer: «Free Nous inference and connectors are now available.» com um seletor de modelo, login e dispensar
Barra de status	Um chip Nous · free tier · nous/welcome com um selo Sign in, ocultável pelo menu de clique com o botão direito da barra
Configurações › Billing	«You’re on the Nous free tier» com um botão de login; o resumo mostra Plano «Free tier», Modelo nous/welcome, Connectors «Included» — sem saldo e nada a pagar

A CLI e o desktop leem o mesmo estado local, então os avisos únicos são compartilhados: ver um na CLI significa que você não o verá de novo no desktop para aquela identidade, e vice-versa.

Como desativar

hermes config set nous.guest false

nous.guest é uma configuração normal do config.yaml (padrão true), não uma variável de ambiente. Com ela desligada: sem inferência gratuita, sem connectors livres de login, sem linha de free tier no hermes model, e uma instalação nova recebe a oferta de hermes setup. Uma conta Nous logada, suas próprias API keys e qualquer outro provider funcionam exatamente como antes.

Uma nota de privacidade que vale explicitar: o free tier precisa de uma identidade para autenticação e limitação de taxa, então na primeira vez que uma é necessária o Hermes cria uma identidade anônima no portal Nous e guarda a credencial no seu diretório Hermes, compartilhada entre os profiles sob ele. Ela não contém endereço de e-mail, nome nem qualquer outro dado pessoal, e expira após 14 dias sem uso — o Hermes cria uma nova de forma transparente. Fazer login move seus connectors vinculados para sua conta; definir nous.guest como false significa que nenhuma identidade é criada ou usada.

O que os erros significam

Sintoma	O que significa	O que fazer
O primeiro comando diz It looks like Hermes isn't configured yet e oferece hermes setup	O free tier não pôde ser configurado em alguns segundos: offline, não aberto no portal, ou limitado por taxa	Volte a ficar online e tente de novo, ou rode hermes setup e adicione um provider. Nada fica pela metade
Nous free tier is not open on this portal.	O portal para o qual o Hermes aponta não está oferecendo o free tier (por exemplo, depois de definir HERMES_PORTAL_BASE_URL)	Faça login com uma conta, remova o override ou adicione sua própria chave
Nous free tier is rate limited; try again shortly.	O portal está limitando novas configurações de free tier	Espere alguns minutos, ou adicione sua própria chave
This needs a Nous account.	Você chamou uma ferramenta paga estando no free tier	/login em um chat, hermes auth upgrade em um terminal, ou configure essa ferramenta com sua própria chave em hermes tools
O seletor mostra apenas nous/welcome em Nous	Esperado no free tier	Faça login para o catálogo completo, ou adicione a chave de outro provider
O free tier parou de funcionar depois de duas semanas ausente	A identidade anônima expirou e é substituída na próxima inicialização	Nada — só inicie o Hermes de novo. Connectors vinculados antes da pausa precisam ser vinculados de novo, a menos que você tivesse feito login

A versão curta

O free tier sabe o que é: uma forma de sair do lugar, não um plano de longo prazo. Para quem está experimentando o Hermes pela primeira vez, ele remove todos os passos entre instalar e ter uma conversa funcionando. Para quem já tem um provider, ele resolve silenciosamente a autenticação dos connectors. E quando você precisar do catálogo maior ou de ferramentas conectadas à web, um login de um minuto continua de onde parou.

Para começar do zero, veja o guia de instalação. A superfície completa de comandos para contas está na referência do hermes auth, a troca de modelo e provider está em hermes model, e mudanças recentes de plataforma e modelo estão nas notas de versão.