Bem-vindo à Instalação Mais Fácil Que Você Já Fez

Se você está adiando experimentar o Hermes Agent porque está preocupado com uma configuração complicada, pare por aí. O novo instalador faz quase tudo por você — e eu quero dizer tudo. Neste tutorial, vamos deixar você pronto para usar em menos de dois minutos, sem precisar de PhD em magia de terminal.

O Caminho Mais Rápido: Hermes Desktop

Para usuários de macOS e Windows, a maneira absolutamente mais fácil é baixar o instalador Hermes Desktop do nosso site. Baixe, execute e pronto. Ele instala tanto a ferramenta de linha de comando quanto o aplicativo desktop, então você tem o melhor dos dois mundos.

Somente Linha de Comando? Sem Problema

Prefere ficar no terminal? Você tem duas opções, dependendo do seu sistema operacional:

Linux / macOS / WSL2 / Android (Termux):

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

Windows (nativo) — execute no PowerShell:

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

Mudou de ideia e quer o aplicativo desktop depois? Basta executar hermes desktop e ele cuidará do resto.

O Que o Instalador Realmente Faz (Para Você Não Precisar)

Aqui está a mágica: o instalador cuida de tudo automaticamente. Chega de caçar dependências uma por uma. Ele configura:

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

A única coisa que você precisa ter instalado por conta própria é o Git (verifique com git --version). No Linux, certifique-se também de que curl e xz-utils estejam disponíveis. Para o aplicativo desktop, você vai querer o build-essential no Debian/Ubuntu.

Onde Tudo Fica Armazenado

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

Instalador	Código fica em	Binário `hermes`	Diretório de dados
Por usuário (instalador git)	`~/.hermes/hermes-agent/`	`~/.local/bin/hermes`	`~/.hermes/`
Modo root (`sudo curl … \| sudo bash`)	`/usr/local/lib/hermes-agent/`	`/usr/local/bin/hermes`	`/root/.hermes/`

O layout em modo root é perfeito para máquinas compartilhadas onde uma única instalação no sistema atende a todos. Sua configuração pessoal (autenticação, skills, sessões) continua segura na sua própria pasta ~/.hermes/.

Após a Instalação: Comece a Conversar!

Quando o instalador terminar, recarregue seu shell e mergulhe:

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

Quer ajustar as coisas 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: se você quiser pular totalmente a bagunça de chaves de API por ferramenta, use o Nous Portal. Uma única assinatura cobre mais de 300 modelos, além do Tool Gateway (busca na web, geração de imagens, TTS, navegador na nuvem). Configure tudo com um único comando:

hermes setup --portal

Isso faz login, define a Nous como seu provedor e ativa o Tool Gateway — tudo de uma vez.

Migrando de Outra Máquina?

Não reconstrua do zero. Restaure um backup completo com hermes import, ou traga um único agente com hermes profile import. Lembre-se: as exportações de perfil excluem credenciais por design, então para um backup de verdade, use hermes backup.

Um Aviso para Usuários de Nix

Nix não é mais um caminho de instalação oficialmente suportado (apenas melhor esforço). Se você já usa Nix, existe um guia de configuração dedicado com flake e módulo NixOS — confira a documentação de Nix & NixOS Setup.

Executando como Serviço do Sistema?

Quer executar o Hermes como um usuário dedicado sem privilégios (como uma conta hermes no systemd)? Totalmente suportado. O único passo que exige root é o --with-deps do Playwright para as bibliotecas do Chromium. O instalador detecta se o sudo está disponível e lida com isso com elegância.

É isso! Agora você está pronto para começar sua primeira conversa com o Hermes. No próximo tutorial, vamos explorar sua primeira sessão de chat e todas as coisas legais que você pode fazer. Até lá!