Você instala o Hermes Desktop num notebook novo e o entrega a um colega que nunca usou um agente. Em vez de dizer olá, ele encontra uma tela de ajustes: escolha um provider, cole uma API key, escolha um modelo, escolha uma cor de accent e um layout, marque quais apps conectar, marque quais plugins instalar. Na quarta decisão ele já parou de ler. Você também já passou por isso — quis testar uma ferramenta e gastou meia hora configurando antes. A versão antiga pedia umas dez coisas antes de retrucar uma única palavra, e nada naquela tela dizia a um novato quais delas realmente importavam.

Essa tela sumiu na v0.22.0. Abra o app desktop num computador onde o Hermes nunca foi usado e ele inicia um curto chat de configuração guiado: um card por vez, cada um pedindo uma coisa. Veja o que ele pergunta, como funciona o teste gratuito por trás dele e o que a nova ferramenta set_theme acrescenta.

A primeira execução agora é uma conversa

A primeira execução antiga era uma página de ajustes que você encarava de uma vez. Agora é uma conversa de ida e volta, um card por pergunta:

• seu nome;
• uma cor de accent e um layout;
• quais apps conectar;
• quais plugins instalar.

Quando os cards terminam, ele faz um tour rápido e então oferece até quatro primeiras tarefas já escolhidas para você — selecionadas a partir das respostas que você acabou de dar. Você não precisa inventar o seu próprio “e agora?”; você começa de algo concreto.

A conversa inteira roda num modelo de teste gratuito, nous/welcome, então um novato conversa com o Hermes antes de ter uma API key. E você nunca fica preso a terminá-la: Skip setup encerra a qualquer momento, e Settings → Run onboarding again a traz de volta sempre que você quiser rever.

set_theme: mude a aparência de qualquer chat

A cor de accent, o modo claro ou escuro e o layout que você escolheu no chat continuam editáveis depois, sem passar pelos ajustes. Esta release dá ao agente uma ferramenta set_theme (fonte: tools/set_theme_tool.py, e listada na referência oficial de ferramentas).

Ela cobre exatamente três coisas: a cor de accent (uma amostra predefinida ou qualquer valor #rrggbb), o modo (claro, escuro ou sistema) e o layout. Chamada sem argumentos, ela mostra um seletor. Como é uma ferramenta de chat comum, dizer algo como “deixa violeta, modo escuro” em qualquer chat do desktop resolve — sem caçar menus, sem janela de preferências separada.

O teste gratuito: converse primeiro, decida sobre a chave depois

O nous/welcome é um teste único, contado uma vez por usuário do sistema operacional, e seus limites são estreitos o bastante para valer detalhar:

• uma primeira instalação do desktop que não tem provider configurado nem conta Nous é o caso que recebe o modelo gratuito;
• o CLI, a TUI e o gateway de mensagens não recebem modelo gratuito nem conta;
• a antiga variável de ambiente HERMES_GUEST_ONBOARDING não existe mais.

O que o plano gratuito não faz é fingir. Não existe caminho em que um limite engula um pedido em silêncio: quando o rate limit gratuito é atingido, o turno termina na hora e avisa quando ele reinicia. Toda falha do plano gratuito vem com um código de erro mais uma frase simples explicando o que aconteceu, e quem está no plano gratuito vê um aviso de Termos e Privacidade, então ninguém fica no escuro sobre estar num teste ou numa configuração paga.

Um ponto que vale ser preciso, porque surpreende: este teste está atrelado à primeira execução do app desktop. Não é um modo geral sem chave para o Hermes. O CLI, a TUI e o gateway de mensagens não recebem o modelo gratuito nem uma conta, então um script que chama o hermes na mesma máquina não está coberto pelo teste que você acabou de aceitar no app.

Para transformar essa identidade de teste numa conta Nous de verdade, um comando resolve — e seus apps conectados vêm junto:

# transforma a identidade gratuita de uso único numa conta Nous completa
# (os apps conectados são mantidos)
hermes auth upgrade

Dentro de qualquer chat ou DM de mensagens, /login faz a mesma coisa.

Quando você não vai ver este chat

A conversa de primeira execução cobre uma situação — local, novinha em folha — e é honesta ao não ir além disso:

• Instalações existentes não a recebem de novo;
• backends remotos (SSH, URL, Cloud) não recebem o chat de primeira execução automaticamente;
• o antigo fluxo de setup-profile e o comando /initiate-setup foram removidos, então um tutorial antigo que manda digitá-lo agora não aponta para nada.

Refazendo o fluxo e colocando-o na frente de outra pessoa

Nada nesse chat é de uso único. Skip setup o fecha onde você estiver, e Settings → Run onboarding again o traz de volta depois — útil quando você já conectou algumas contas e quer rever as perguntas de apps e plugins com mais clareza sobre o que está respondendo. Como o fluxo pertence a um computador que nunca rodou o Hermes, a forma de conduzir um colega por ele é exatamente a situação do início deste post: entregue a ele uma máquina que nunca teve o app. Numa máquina que você já usa, o tour e as primeiras tarefas sugeridas não fazem mais parte do caminho, e nenhuma quantidade de cliques nos ajustes vai fazê-los aparecer.

Duas ofertas menores que vêm depois dos cards

Dois momentos relacionados da primeira execução vale conhecer, sem exagerar no que são. Primeiro, se a máquina consegue rodar o modelo local recomendado, ela recebe uma oferta única de configuração para instalar um. Segundo, Settings → Providers → Local Models instala e mantém o llama.cpp com o engine que combina com o seu hardware (CPU, CUDA, Metal, Vulkan, ROCm) e avalia cada modelo do catálogo em relação à sua GPU e RAM, para você não ficar adivinhando quais realmente vão rodar. Do lado do terminal, hermes model agora inclui uma entrada Local models no seletor de modelos.

Se você está configurando plugins e não uma máquina, o guia de plugins do desktop explica o que um plugin pode fazer depois de instalado.

Onde isso foi lançado

O chat de configuração, o set_theme e o teste gratuito em torno deles chegam na v0.22.0, “The Threshold Release”. A janela que ela agrega vai da v0.21.1 à v0.21.7: cerca de 24.200 commits, aproximadamente 6.080 PRs mesclados, uns 15.600 arquivos alterados e em torno de 2.520 contribuidores. As notas de release completas da v0.22.0 têm o resto.

Para começar de uma instalação limpa e ver o fluxo você mesmo, o guia de instalação cobre todas as plataformas. Se a sua dúvida de verdade é se dá para começar sem nenhuma API key, o guia do plano gratuito vai mais fundo, e a oferta de modelo local acima está em modelos locais e recomendações de hardware.