Início Rápido do Agente Hermes: Da Instalação aos Primeiros Passos

Por que o Hermes merece atenção

Se já instalou uma nova ferramenta de IA, viu o binário aparecer no seu PATH e ainda assim ficou com algo tecnicamente presente mas praticamente inútil, já compreende o problema que este guia de início rápido do Hermes Agent está a resolver. Uma instalação concluída apenas prova que os ficheiros foram copiados. Não prova que o agente consegue inspecionar um repositório, comunicar com um modelo real, usar ferramentas com segurança ou retomar o trabalho mais tarde.

É por isso que o Hermes merece atenção. Quando está a funcionar corretamente, deixa de parecer “ChatGPT num terminal” e começa a comportar-se como um agente operacional. Consegue inspecionar ficheiros, usar ferramentas de terminal, manter-se dentro de um espaço de trabalho e continuar a sessão em vez de agir como se cada prompt começasse do zero.

Isso torna-o adequado para programadores, utilizadores de self-hosting e utilizadores orientados para o terminal que querem ajuda com tarefas reais: resumir uma base de código, verificar um repositório numa máquina pessoal, ou executar num VPS pequeno da AlexHost, AvaHost ou qualquer outro fornecedor sem saltar diretamente para uma pilha de automação maior. No final deste guia, terá o Hermes instalado, configurado, testado numa primeira tarefa segura e retomado com sucesso.

O que é o Hermes — e o que este guia irá realmente ajudá-lo a fazer

Antes de executar qualquer comando, mantenha três termos separados. A maior parte da confusão na primeira execução vem de os fundir numa ideia vaga de “a IA”.

A tabela seguinte fornece o modelo mental de trabalho para este tutorial:

Este artigo visa apenas um estado de sucesso: uma única sessão Hermes segura e funcional que pode iniciar, testar e retomar. Não é um guia de implementação em produção. Não é uma visita completa às funcionalidades. É o caminho mais curto e fiável para “o Hermes funciona na minha máquina, e consigo prová-lo”.

📝 Nota: Instalar o Hermes não é o mesmo que configurar o Hermes. O binário pode estar presente e ainda assim ser inutilizável até executar hermes model e ligá-lo a um fornecedor e modelo.

Pode notar que a documentação oficial também oferece hermes setup. Isso é válido, mas este guia separa intencionalmente a instalação do hermes model para que possa ver exatamente onde ocorre o sucesso ou falha na maioria das primeiras execuções. Também mantemos a abordagem CLI clássica em primeiro lugar para reprodutibilidade, embora hermes –tui exista e utilize as mesmas sessões subjacentes. Fora do âmbito deste guia de início rápido: configuração de gateway, cron, MCP, rede de modelos locais, roteamento multi-fornecedor e proteção para produção.

Regras de segurança antes de dar ao Hermes acesso à shell

Antes de testar qualquer agente com acesso ao terminal, decida onde lhe é permitido errar. Para este artigo, isso significa uma máquina que não seja de produção, uma VM, um repositório descartável, ou no mínimo um espaço de trabalho de baixo risco onde um comando acidental não arruíne o seu dia.

⚠️ Aviso: Mantenha as aprovações no modo seguro predefinido durante todo este guia de início rápido, e não use –yolo. O Hermes pergunta antes de comandos arriscados; isso é uma funcionalidade de segurança, não um atrito inútil.

Use esta lista de verificação rápida antes de continuar:

• Comece numa máquina ou espaço de trabalho de baixo risco.
• Mantenha os prompts de aprovação ativados.
• Evite repositórios de produção pessoais para o primeiro teste.
• Espere que a tarefa de prova permaneça apenas de leitura.
• Trate os backends de terminal Docker e SSH como etapas de proteção posteriores, não como requisitos do primeiro dia.

A primeira tarefa de prova real neste guia fica dentro de ~/.hermes/hermes-agent, o que mantém a demonstração relevante para o Hermes enquanto evita projetos sensíveis. Assim que o fluxo CLI base estiver estável, pode avançar para um isolamento mais forte com Docker ou backends remotos. Na primeira hora, seguro e verificável é melhor do que ambicioso.

Antes de instalar: pré-requisitos, caminhos suportados e um problema com WSL2

Para a maioria dos utilizadores, a história de suporte é simples: Linux, macOS e WSL2 são os caminhos a considerar primeiro. O Windows nativo existe, mas ainda está em beta inicial, por isso se estiver no Windows, a recomendação prática continua a ser WSL2.

No Ubuntu 24.04 ou WSL2, comece por garantir que git e curl estão disponíveis:

Se a segunda linha devolver a string da sua distribuição mais a saída de versão funcional para ambas as ferramentas, os pré-requisitos base estão em ordem. No macOS, a verificação equivalente é geralmente apenas confirmar git –version e curl –version antes de usar o mesmo instalador do Hermes.

📝 Nota: O Windows nativo ainda é um caminho em beta inicial, por isso prefira WSL2 se estiver no Windows.
💡 Dica: No WSL2, mantenha o Hermes e os seus repositórios de trabalho sob ~ em vez de /mnt/c para evitar operações Git mais lentas e comportamento estranho nas permissões de ficheiros.

A boa notícia é que o Hermes não requer que monte manualmente uma pilha de dependências gigante primeiro. O instalador git oficial trata de uv, Python 3.11, Node.js 22, ripgrep e ffmpeg por si. O que deve ter pronto antes de o assistente de configuração iniciar é uma conta de fornecedor, ou pelo menos um plano testado para um endpoint personalizado. Além disso, escolha um modelo com pelo menos 64K de contexto: janelas de contexto menores tendem a falhar assim que o agente começa a carregar contexto de ficheiros, saída de ferramentas e instruções de múltiplos passos em conjunto.

Instalar o Hermes Agent com o caminho oficial de uma linha

Com os pré-requisitos resolvidos, execute o instalador oficial exatamente como documentado:

Isto é agora mais do que um simples passo de instalação. O Hermes deteta a plataforma, prepara as dependências de que necessita e continua imediatamente para o fluxo de configuração da primeira execução. No exemplo acima, o instalador deteta Linux, verifica uv, instala Python 3.11 onde necessário, prepara Node.js 22 para ferramentas de browser e constrói o ambiente de comando do Hermes.

Se a instalação for realizada como root, pode ver caminhos como /usr/local/bin/hermes, /usr/local/lib/hermes-agent e /root/.hermes/. Numa instalação de utilizador normal, espere a mesma estrutura no seu próprio diretório home.

O detalhe importante é que o instalador de uma linha avança diretamente para o assistente de configuração. Por outras palavras, a instalação e a configuração da primeira execução são um fluxo contínuo. Não trate o fim da instalação do pacote como a linha de chegada, porque o Hermes não é realmente útil até que este assistente de configuração seja concluído.

A primeira decisão é o fornecedor de inferência. Nesta execução, é selecionado o OpenRouter, que é uma primeira escolha prática porque dá acesso a um amplo catálogo de modelos através de uma conta de fornecedor. Se já usa um fornecedor suportado diferente, escolha esse em vez disso.

Assim que o fornecedor é escolhido, o Hermes pede a chave API correspondente. Neste exemplo, isso significa OPENROUTER_API_KEY. Cole a chave, prima Enter e o Hermes guarda-a para uso futuro.

Se ignorar este passo, o Hermes pode terminar a instalação, mas ainda não estará pronto para uma sessão de agente real. Teria de voltar e configurar o fornecedor mais tarde.

Após a chave ser guardada, o assistente avança para a seleção do modelo. Nesta execução, o modelo selecionado é deepseek/deepseek-v4-pro. Esse é um exemplo concreto válido, mas não é o único caminho: o assistente também permite introduzir um nome de modelo personalizado ou ignorar e manter o modelo atual se estiver a re-executar a configuração numa instalação existente.

Para uma primeira execução, a regra prática é simples: escolha um modelo ao qual já sabe que tem acesso e certifique-se de que tem contexto suficiente para trabalho real de agente. O Hermes é muito mais fiável com modelos que oferecem pelo menos uma janela de contexto de 64K. Janelas de contexto menores podem parecer bem num teste pequeno, mas falham assim que a saída de ferramentas, o contexto de ficheiros e as instruções de múltiplos passos começam a acumular-se.

Se quiser alterar esta escolha mais tarde, hermes model continua a ser a forma mais rápida de re-executar a seleção de fornecedor e modelo sem reinstalar nada.

De seguida, o Hermes pergunta quanto da configuração mais ampla quer fazer agora. Para este guia de início rápido, a opção recomendada é a correta: configuração rápida.

Isso mantém o artigo focado no caminho essencial: fornecedor, modelo e as escolhas mínimas necessárias para tornar o Hermes utilizável.

O ecrã seguinte pergunta sobre o backend de terminal. Para uma primeira execução, mantenha o backend local atual para que o Hermes seja executado diretamente nesta máquina. Docker, SSH, Modal e outros backends são úteis mais tarde, mas adicionam complexidade antes mesmo de ter confirmado que o fluxo CLI base funciona.

O Hermes oferece então a configuração de plataforma de mensagens. Para este guia de início rápido, ignore-a. Isso mantém o guia centrado no fluxo principal do agente CLI, e pode adicionar Telegram, Discord ou outro caminho de mensagens mais tarde com hermes setup gateway.

Assim que o assistente termina, o Hermes mostra onde guardou os ficheiros importantes.

A divisão principal a recordar é simples: config.yaml contém definições não secretas, .env contém chaves API e outros segredos, e os diretórios de dados contêm sessões, registos e estado de execução relacionado. Nesta captura de ecrã, os caminhos estão sob /root/.hermes/ porque a instalação foi feita como root. Numa instalação de utilizador normal, leia esses caminhos como ~/.hermes/.

O Hermes imprime então o resumo curto de pronto a usar, incluindo os comandos que provavelmente usará primeiro.

Neste ponto, o Hermes está instalado e configurado. A próxima coisa a fazer é verificar se o ambiente está saudável antes de avançar para a primeira tarefa real:

hermes doctor deve confirmar o básico: sem avisos de segurança ativos, um ambiente Python funcional e os pacotes necessários presentes. Esse é o sinal de sucesso limpo que quer antes de continuar.

Se hermes ainda não estiver visível numa shell nova, recarregue a sua shell e verifique o caminho do comando antes de continuar. No Bash isso geralmente significa source ~/.bashrc; no Zsh, source ~/.zshrc. Se necessário, confirme o lançador com command -v hermes.

Com o Doctor a passar, a instalação não está apenas concluída — o Hermes está agora realmente pronto a usar.

Execute a sua primeira tarefa segura de agente

Com o Hermes agora instalado, configurado e verificado pelo hermes doctor, está pronto para a primeira demonstração real. O primeiro espaço de trabalho mais seguro e com alto sinal é o próprio diretório home do Hermes. Nesta execução, a instalação foi feita como root, por isso esse diretório é /root/.hermes. Numa instalação de utilizador normal, o mesmo local seria ~/.hermes.

Mova-se para esse diretório, confirme onde está e depois lance o Hermes:

Este é um bom primeiro espaço de trabalho porque já está presente, diretamente relacionado com a ferramenta que acabou de instalar e de baixo risco em comparação com colocar um agente num repositório pessoal ou de produção. O ecrã de arranque também é uma verificação de sanidade útil por si só: mostra o Hermes a lançar corretamente, o modelo ativo no rodapé e o facto de o agente já conseguir ver as suas ferramentas disponíveis e competências incluídas.

Se preferir a interface mais recente, hermes –tui ainda está disponível, mas este guia mantém a abordagem CLI clássica em primeiro lugar porque é mais fácil de reproduzir passo a passo e ambas as interfaces partilham as mesmas sessões.

Quando o Hermes abre, dê-lhe um prompt simples e apenas de leitura que lhe peça para inspecionar o espaço de trabalho atual e identificar o ponto de entrada. Neste exemplo, o prompt aponta explicitamente para /root/.hermes porque a instalação foi realizada como root. Numa instalação de utilizador normal, aponte para o seu próprio diretório ~/.hermes.

Use o seguinte prompt:

Summarize this repo in 5 bullets and tell me what the main entrypoint is: ~/.hermes

Este é exatamente o tipo de primeira tarefa que quer: segura, observável e fácil de verificar. Na captura de ecrã acima, o Hermes não adivinha. Começa a ler ficheiros concretos como config.yaml, SOUL.md e .install_method, procura ficheiros relacionados com o Hermes e inspeciona o caminho do lançador instalado. Essa atividade visível de ferramentas é a prova real de que o Hermes está a comportar-se como um agente em vez de uma caixa de chat de uso único.

Um resultado saudável deve voltar com um resumo concreto ligado ao espaço de trabalho e um ponto de entrada verificável. Nesta execução, o Hermes identifica o wrapper de comando instalado em /usr/local/bin/hermes, explica que leva ao ponto de entrada CLI Python e resume o ambiente Hermes circundante em cinco pontos.

Esse é o sinal de sucesso a procurar. A resposta é específica, fundamentada em ficheiros que o Hermes realmente inspecionou e fácil de verificar contra o que já pode ver no disco. Não trate o resultado como magia — compare o resumo com os ficheiros visíveis e a estrutura de diretórios. Para uma primeira demonstração, seguro e verificável é muito melhor do que vistoso.

Retome a sessão e confirme que a configuração realmente funciona

O guia de início rápido não está terminado quando o Hermes responde uma vez. Está terminado quando confirma que a sessão pode ser retomada.

Use o comando de retoma abaixo; -c é a forma abreviada para a mesma ação:

O resultado esperado é que o Hermes reabra a sessão mais recente ou lhe dê um resumo que claramente pertence à tarefa que acabou de executar. Isso importa porque prova que o Hermes não está a agir como um chat descartável de uso único. Está a manter uma sessão de trabalho durável à qual pode regressar.

Use esta lista de verificação de sucesso compacta antes de avançar:

• Hermes instalado e verificado
• Fornecedor configurado
• Primeira resposta limpa
• Primeira tarefa de repositório concluída
• Sessão retomada com sucesso

Se a retoma não funcionar, primeiro certifique-se de que está a usar o mesmo perfil, depois verifique as sessões disponíveis com hermes sessions list. Assim que hermes –continue funcionar, tem a linha de base completa que este tutorial do Hermes Agent pretendia estabelecer.

O que experimentar a seguir quando o fluxo de trabalho base funcionar

Assim que o chat base estiver estável, adicione apenas uma nova camada de cada vez.

💡 Dica: Resista à tentação de ativar todas as funcionalidades avançadas imediatamente. Estabilize primeiro um fluxo de trabalho limpo, depois expanda deliberadamente.

Aqui está o menu curto de próximos passos sensatos:

• Experimente hermes –tui se quiser a interface de terminal mais recente sobre o mesmo modelo de sessão.
• Execute hermes setup mais tarde se quiser o assistente de configuração mais amplo após compreender o básico manualmente.
• Explore hermes gateway setup se o seu próximo objetivo for a integração com plataformas de mensagens.
• Reveja hermes tools e hermes skills quando quiser expansão controlada de capacidades.
• Mude para um backend de terminal Docker ou SSH se o agente começar a tocar em sistemas de maior risco.
• Use a documentação oficial para fornecedores personalizados e endpoints de modelos locais assim que o caminho hospedado já estiver a funcionar.

Se quiser ideias de acompanhamento para uso real, aqui estão algumas boas para pesquisar a seguir: notas de integração de base de código, elaboração de changelogs, planeamento seguro de refatoração, explicação de ficheiros de configuração, resumos de revisão de pull requests, listas de verificação de manutenção de VPS, elaboração de runbooks de implementação, prompts de triagem de registos e identificação de lacunas na documentação.

Para caminhos mais aprofundados, ligue para fora em vez de estender este guia de início rápido num segundo artigo: o guia de início rápido, a documentação de instalação, o guia CLI e o guia de segurança são as próximas paragens certas.

Agora tem um guia de início rápido do Hermes seguro e funcional

O marco importante não é que o Hermes foi instalado. O marco importante é que o Hermes se tornou útil. Tem agora uma linha de base verificada: o binário está presente, o fornecedor está configurado, a primeira resposta funcionou, a primeira tarefa segura foi concluída e a sessão foi retomada depois.

Este é o lugar certo para parar e celebrar a conquista. Mantenha as aprovações ativas, expanda uma camada de cada vez e avance para um isolamento mais forte quando o agente começar a fazer trabalho de maior risco. Se eventualmente executar o Hermes numa estação de trabalho pessoal, numa máquina de laboratório ou num VPS da AlexHost, AvaHost ou qualquer outro lugar, a regra mantém-se: ganhe confiança em pequenos passos.