Keep Hermes Fresh: Updating & Uninstalling Made Simple

Mantenha o Hermes Atualizado: Atualizar e Desinstalar de Forma Simples

Manter seu assistente de IA atualizado não deveria ser ciência de foguetes. Por isso, o Hermes Agent torna isso uma tarefa de um único comando. Vamos passar por tudo o que você precisa saber sobre atualizações — e o que acontece nos bastidores, para que você possa atualizar com total confiança.

A Atualização em Um Único Comando

Atualizar o Hermes é tão simples quanto:

hermes update

É isso. Esse único comando baixa o código mais recente, atualiza todas as dependências e até pergunta sobre novas opções de configuração adicionadas desde a sua última atualização. Sem precisar fuçar notas de versão, sem etapas manuais — apenas um comando limpo.

O Que Realmente Acontece Durante uma Atualização?

Você deve estar se perguntando: “O que realmente está acontecendo nos bastidores?” Aqui está o detalhamento amigável das seis etapas que o Hermes executa para manter você atualizado:

Snapshot pré-atualização — Antes de qualquer mudança, o Hermes salva um snapshot leve dos seus arquivos de estado importantes (dados de pareamento, jobs do cron, configuração e muito mais). Arquivos acima de 1 GiB são ignorados para que um banco de dados enorme nunca deixe tudo lento. Esse snapshot acontece para cada perfil da sua instalação, criando uma rede de segurança.
Git pull — O Hermes baixa o código mais recente do branch main e atualiza quaisquer submódulos.
Validação de sintaxe pós-pull + rollback automático — Aqui está a parte inteligente. Após o pull, o Hermes verifica se todos os nove arquivos críticos ainda são analisados corretamente. Se algo parecer quebrado (como um marcador de conflito de merge), ele reverte automaticamente para a versão anterior para que seu shell continue inicializável. Você pode simplesmente executar a atualização novamente quando a correção chegar ao upstream.
Instalação de dependências — Dependências novas ou alteradas são instaladas automaticamente.
Migração de configuração — O Hermes detecta novas opções de configuração e solicita que você as defina. Perdeu o aviso? Sem problemas — basta executar hermes config check para ver o que está faltando e depois hermes config migrate para adicioná-las interativamente.
Reinício automático do gateway — Os gateways em execução são atualizados para que o novo código entre em vigor imediatamente. Gateways gerenciados por serviço são reiniciados pelo gerenciador de serviços do sistema; os manuais são relançados automaticamente.

Atualizando a Partir de um Branch Diferente

Às vezes você quer testar um release candidate ou um branch de funcionalidade. O Hermes cuida disso:

hermes update --branch release-candidate
hermes update --check --branch experimental   # apenas visualize o quanto você está atrasado

Se seu checkout local estiver em um branch diferente, o Hermes automaticamente guarda qualquer trabalho não commitado, alterna para o branch de destino e faz o pull. Branches que não existem localmente são rastreados automaticamente a partir do remoto. E se um branch não existir em lugar nenhum? O Hermes falha de forma limpa e restaura suas alterações guardadas — você nunca fica na mão.

E Se Você Estiver Estacionado em um Branch de Funcionalidade?

Se você está em um branch de funcionalidade, o Hermes lida com isso com elegância:

Branch totalmente mesclado — O Hermes alterna você de volta para main e informa exatamente o que aconteceu.
Commits não mesclados, árvore limpa — A atualização prossegue para main mesmo assim (importante para atualizações não interativas, como o botão da área de trabalho), mas seus commits ficam intactos. O Hermes exibe um aviso bem visível nomeando seu branch e como voltar para ele.
Árvore suja (alterações não commitadas) — O Hermes não toca no seu trabalho. A atualização é marcada como SKIPPED com um aviso claro e os comandos exatos para resolver a situação.

Se você mantém deliberadamente um branch personalizado, defina updates.parked_branch_strategy: update_in_place no seu config.yaml. O Hermes então fará o merge de origin/main dentro do seu branch em vez de alternar para outro — seus commits sobrevivem e o código avança.

Desinstalando

Embora a atualização seja a estrela do show, desinstalar é igualmente simples. O processo remove o Hermes de forma limpa do seu sistema, para que você possa se despedir sem deixar bagunça digital para trás.

Considerações Finais

O Hermes Agent trata atualizações como uma experiência de primeira classe — segura, reversível e transparente. Os snapshots pré-atualização, o rollback automático em erros de sintaxe e o gerenciamento inteligente de branches significam que você pode atualizar com confiança, sabendo que seu assistente continuará funcionando não importa o que aconteça.

Então vá em frente — execute hermes update e deixe seu assistente de IA crescer junto com você. É a maneira mais fácil de ficar na vanguarda.