Atualização Hermes v2026.7.7.2: Correção do WhatsApp, Estabilidade no Docker e Instalação Confiável

Esta atualização traz um polimento muito necessário para a experiência de instalação, além de correções importantes para WhatsApp e Docker. Vamos ver o que há de novo e como começar mais rápido do que nunca.

A Instalação Ficou Muito Mais Fácil

O objetivo principal desta atualização? Fazer você conversar com o Hermes em menos de dois minutos. Chega de brigar com dependências ou caçar pacotes ausentes. O instalador agora cuida de tudo automaticamente.

Instalação Rápida (Recomendada)

Opção 1: Instalador Desktop do Hermes (macOS/Windows)

Se você quer tanto a ferramenta de linha de comando quanto o aplicativo desktop, basta baixar o instalador Desktop do Hermes e executá-lo. Só isso.

Opção 2: Somente Linha de Comando

Prefere ficar no terminal? Execute um destes comandos:

Linux / macOS / WSL2 / Android (Termux):

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Windows (PowerShell nativo):

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

Quer o aplicativo desktop depois? Basta executar hermes desktop após a instalação via CLI.

O Que o Instalador Faz Por Você

Nada de configuração manual. O instalador cuida automaticamente de:

Python 3.11 (via uv, sem precisar de sudo)
Node.js v22 (para automação de navegador e a ponte do WhatsApp)
ripgrep (busca rápida de arquivos)
ffmpeg (conversão de áudio para TTS)
O clone do repositório e o ambiente virtual
Configuração global do comando hermes
Configuração do provedor de LLM

O único pré-requisito é o Git. No Linux, certifique-se de que curl e xz-utils também estejam disponíveis (sudo apt install curl xz-utils). Para o aplicativo desktop, você também precisará do build-essential (sudo apt install build-essential no Debian/Ubuntu).

Onde Ficam os Arquivos

Dependendo de como você instala, os arquivos vão para lugares diferentes:

Instalador	Código	Binário `hermes`	Dados
Por usuário	`~/.hermes/hermes-agent/`	`~/.local/bin/hermes`	`~/.hermes/`
Modo root	`/usr/local/lib/hermes-agent/`	`/usr/local/bin/hermes`	`/root/.hermes/`

O layout em modo root é ótimo para máquinas compartilhadas onde uma única instalação do sistema atende a todos. A configuração por usuário ainda fica em ~/.hermes/ de cada usuário.

Após a Instalação

Recarregue seu shell e comece a conversar:

source ~/.bashrc   # ou: source ~/.zshrc
hermes             # Comece a conversar!

Configure Seu Ambiente

Precisa ajustar algo depois? Use os comandos dedicados:

hermes model          # Escolha seu provedor de LLM e modelo
hermes tools          # Configure quais ferramentas estão habilitadas
hermes gateway setup  # Configure plataformas de mensagens
hermes config set     # Defina valores de configuração individuais
hermes config get     # Inspecione valores de configuração individuais
hermes setup          # Execute o assistente de configuração completo

Caminho Mais Rápido: Nous Portal

Uma única assinatura cobre 300+ modelos além do Tool Gateway (busca na web, geração de imagens, TTS, navegador em nuvem). Esqueça a bagunça de chaves por ferramenta:

hermes setup --portal

Isso faz login, define Nous como seu provedor e ativa o Tool Gateway em um único comando.

Migrando de Outra Máquina?

Não reconstrua tudo do zero. Restaure um backup completo com hermes import, ou traga um agente específico com hermes profile import. Observe que as exportações de perfil excluem credenciais por design, então use hermes backup para um backup completo.

E o Nix?

Nix não é mais um caminho de instalação explicitamente suportado (apenas melhor esforço). Se você já usa Nix, existe um caminho de configuração dedicado com um flake Nix e módulo declarativo NixOS. Consulte o guia de Configuração Nix & NixOS para mais detalhes.

Executando Sem Sudo

Executar o Hermes como um usuário dedicado sem privilégios (como uma conta de serviço systemd) é totalmente suportado. A única etapa que exige root é o passo --with-deps do Playwright para as bibliotecas do Chromium. O instalador detecta se o sudo está disponível e lida com isso de forma elegante.

Instalação para Desenvolvedores

Quer contribuir ou executar a partir de um branch específico? Clone o repositório e instale a partir do código-fonte — consulte a seção Configuração de Desenvolvimento no guia de Contribuição.

Essa é a reformulação da instalação em resumo. Configuração mais rápida, menos dores de cabeça e mais controle sobre onde as coisas ficam. Boas conversas!