Ferramentas & Conjuntos de Ferramentas — As Mãos da IA

Bem-vindo de volta à nossa série sobre o Hermes Agent! Da última vez, falamos sobre como as ferramentas são como as mãos da IA — elas permitem que seu agente realmente faça coisas em vez de apenas conversar sobre elas. Hoje, vamos garantir que essas mãos estejam conectadas. Isso significa instalar o Hermes Agent na sua máquina, de forma rápida e sem dor.

Instalação em Dois Minutos

A boa notícia: você não precisa ser um administrador de sistemas para começar. O Hermes Agent agora tem um instalador oficial para desktop no macOS e Windows. Basta acessar o site, baixar e executar. É isso — você estará conversando com seu agente em cerca de dois minutos.

Prefere a linha de comando? Sem problema. O script de instalação cuida de tudo para você:

# Linux / macOS / WSL2 / Android (Termux)
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Usuários do Windows têm um comando de uma linha no PowerShell:

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

E se você começar com a versão de linha de comando, mas depois quiser o aplicativo desktop, basta executar hermes desktop.

O Que Tem Por Baixo do Capô?

O instalador é um pouco mágico. Ele detecta e instala automaticamente tudo o que o Hermes precisa:

Python 3.11 (via uv, sem precisar de sudo)
Node.js v22 (para automação de navegador e WhatsApp)
ripgrep (para busca de arquivos super rápida)
ffmpeg (para conversão de áudio em text-to-speech)

Você não precisa instalar nada disso por conta própria. O único pré-requisito real é o Git — certifique-se de que git --version funciona. No Linux, instale também curl e xz-utils. Se você planeja usar o aplicativo desktop, vai querer o build-essential também.

Onde Tudo Fica?

O instalador é inteligente na hora de organizar os arquivos. Para uma instalação normal por usuário:

O código fica em ~/.hermes/hermes-agent/
O comando hermes é um link simbólico para ~/.local/bin/hermes
Seus dados (autenticação, skills, sessões) ficam em ~/.hermes/

Executando como root com sudo? Você terá o layout padrão FHS do Linux: código em /usr/local/lib/hermes-agent/, binário em /usr/local/bin/hermes. Isso é perfeito para máquinas compartilhadas, onde uma única instalação no sistema atende a todos.

Primeiros Passos Após a Instalação

Recarregue seu shell e pronto:

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

Quer ajustar algo depois? Existem comandos dedicados para isso:

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          # Ou execute o assistente de configuração completo

O Caminho Mais Rápido: Nous Portal

Aqui vai uma dica de profissional. Em vez de gerenciar chaves de API para cada ferramenta, experimente a configuração em um único comando:

hermes setup --portal

Isso faz login, define a Nous como seu provedor e ativa o Tool Gateway — que oferece busca na web, geração de imagens, TTS e um navegador em nuvem sob uma única assinatura. Chega de gerenciar chaves separadas para cada ferramenta.

Mudando para uma Nova Máquina?

Não reconstrua tudo do zero. Use hermes import para restaurar um backup completo, ou hermes profile import para trazer um único agente. Só lembre: exportações de perfil não incluem credenciais, então, para um backup de verdade, use hermes backup.

Um Aviso para Usuários de Nix

Se você usa Nix, saiba que ele não é mais um caminho de instalação oficialmente suportado — mas ainda existe um guia de configuração dedicado com um flake e módulo NixOS, caso precise.

Concluindo

É isso — o Hermes Agent agora está rodando na sua máquina, e as mãos da sua IA estão prontas para trabalhar. No próximo post, vamos mergulhar na configuração do seu primeiro conjunto de ferramentas e colocar essas mãos em ação.

Boas conversas!