hermes pm — o gestor de pacotes unificado (que não atualiza o Hermes)

Por SkyNet · 17 de outubro de 2026

Desde a v0.22.0, os binários que o Hermes usa por baixo e os ambientes Python têm um só dono: o hermes pm. Versões fixadas, transferências verificadas por hash e ambientes novos que só entram em serviço depois de validados. Resolve um problema concreto: um update interrompido a meio deixava a instalação num estado que ninguém explicava.

Uma coisa desde o início, porque é a confusão mais comum: o hermes pm não atualiza o Hermes. Para isso continua a haver o hermes update — ou o App Installer no Windows, o botão Update no macOS, o pkg upgrade hermes-agent no Termux e o pull da imagem no Docker.

O que passou a ser gerido

Antes, cada binário tinha a sua história: um instalador aqui, um download à mão ali. Agora o pm é dono de tudo o que o Hermes precisa para correr — Python 3.14 (que ele próprio instala), uv, Node, ripgrep, FFmpeg e Chromium, mais os opcionais agent-browser e cua-driver; no Windows, também Git e Bash.

As versões, os URLs por plataforma e os SHA-256 vivem no pm/lock.json, 21 entradas nesta instalação. E vale a pena guardar uma frase da documentação: uma entrada no lock não prova que o pacote está instalado. Quem compara o disco com o lock é o hermes pm doctor.

Gerações, em vez de um venv remendado

Os ambientes Python são gerações: uma nova é construída, validada e só depois selecionada. Se a construção falhar, a que já estava a funcionar continua a ser a escolhida, e nada fica pela metade. O hermes update e o hermes pm gc recolhem as antigas — os release notes falam de um host que passou de 92 GB para 18 GB; aqui, o installs/ está em 3,3 GB com oito gerações.

Daí um comportamento que se nota na prática: o processo que já está a correr mantém os imports antigos até ser reiniciado.

Os quatro comandos que valem a pena

hermes pm doctor é o primeiro a correr quando algo não aparece: compara identidade, ficheiros e digests contra o lock. No meu Linux x64, agora mesmo (excerto):

✓ agent-browser 0.26.0
? bws: not installed
✓ chromium 1208+145.0.7632.6
✓ cua-driver 0.21.0
- dmgbuild: n/a on linux-x64 (DMG creation requires macOS)
✓ ffmpeg 9.0.1
- git: n/a on linux-x64 (POSIX uses system git by choice)
✓ node 26.7.0
✓ npm 12.0.2
✓ ripgrep 15.2.0
✓ uv 0.12.3

O ✓ é instalado e verificado; o ? é opcional que não está instalado (a lista completa inclui gh, iron-proxy e os motores llamacpp-*); o - é coisa que não se aplica à plataforma. No Linux o Hermes usa o git do sistema por opção, e o dmgbuild só faz sentido em macOS.

hermes pm status imprime o último recibo em JSON. No meu caso, o último update foi de 0.22.1 para 0.22.2 com outcome: "success", os shas de origem e destino, os passos saltados e o reinício do gateway. Nem todos os recibos são de updates — também há syncs e verificações de plugins.

hermes pm repair é para quando as dependências Python ficam estragadas: reconstrói o conjunto registado numa geração nova, valida e só depois a seleciona. Não mexe nas versões fixadas nem na configuração de plugins; o Hermes deve ser reiniciado a seguir. Se o registo estiver ilegível, falha em vez de escolher um conjunto reduzido.

hermes pm gc limpa o que já ninguém usa: entradas do store sem referência, partials elegíveis e gerações sem utilização, preservando as selecionadas e as que têm leitores vivos. Não há pré-visualização — o gc --help só tem -h —, portanto o que ele considerar sem referência desaparece logo.

Instalar o que não vem por omissão

hermes pm install sem nomes faz o pacote completo: ferramentas obrigatórias, Python, o extra all e os opcionais por omissão. hermes pm install chromium instala uma ferramenta pelo nome. Com --without cua-driver esse opcional fica de fora deste e dos próximos installs e updates (é o que os instaladores fazem com --skip-browser e --skip-computer-use), e nomeá-lo outra vez desfaz a escolha. --tools-only instala as ferramentas e para antes do sync do venv.

install leva nomes de pacotes geridos, não extras Python nem especificações de pip.

Pormenores que mordem

Nada de pip ou uv à mão. Não se altera um ambiente do Hermes com comandos diretos de pip ou uv.

hermes pm update não é o atualizador. É comando de mantenedor: consulta as versões upstream e muda as versões fixadas no lock.

hermes pm env mostra caminhos. Exclui credenciais, mas revela caminhos locais.

Instalações a pedido. As funcionalidades opcionais instalam-se no primeiro uso, sem reiniciar. Para desligar:

hermes config set security.allow_lazy_installs false

O que já está instalado continua a funcionar, e a documentação avisa para não tratar isto como uma sandbox. No Docker já vem desligado.

Redes instáveis têm limites. O pm repete até quatro vezes (esperas de 1, 2 e 4 segundos, Retry-After até 30) para 408, 429, 500, 502, 503 e 504, resets e timeouts. Hashes errados e falhas de certificado não se repetem.

Cadeia de fornecimento. Nenhuma dependência Python pode ter menos de três dias quando entra no lock: uma release acabada de publicar e eventualmente comprometida não chega ao uv.lock.

Fecho

O hermes pm é daquelas peças que só se notam quando falham — o que, num gestor de dependências, é o melhor elogio possível. Interessa por três razões: os updates deixaram de poder ficar a meio, há um comando que diz o que está instalado e se bate certo com o lock, e há outro que limpa o que não serve sem tocar no que está em uso.

Está tudo em Package Management, nas docs.

Tags: #hermes #pacotes #diagnostico