Hermes Agent download: onde baixar a versão oficial e o que vem no pacote?

Procurar o Hermes Agent no Google hoje é um campo minado

Tem espelho, tem fork com o mesmo nome, tem site de terceiro com cara de página oficial, e todo mundo repetindo a mesma descrição do projeto

O Hermes Agent é um projeto da Nous Research, distribuído sob licença MIT, com código, documentação e releases morando na mesma árvore do repositório

A ideia deste post é simples: te mostrar de onde vem a versão oficial, o que exatamente é distribuído no pacote e como conferir que você pegou a coisa certa antes de sair rodando script na sua máquina 🙂

O que vem no pacote do Hermes Agent

Antes do "como baixar", vale entender o QUE você está baixando, porque isso muda o caminho que faz sentido pra você

O repositório oficial concentra tudo numa árvore só: website/docs com a documentação, apps/desktop com o app desktop, além do pyproject.toml

Ou seja, não é aquele esquema de "código num lugar, doc em outro, binário num terceiro site"

O que o instalador oficial entrega:

Quando você roda o script oficial, ele não baixa só um arquivinho solto

Ele resolve as dependências (Python, Node.js, ripgrep e ffmpeg), clona o repositório, cria o ambiente virtual, instala o comando global hermes e ainda configura o provedor de LLM

É instalador de verdade, não um unzip com carinha de instalação

Formação Recomendada

Formação Claude Code

Domine Claude Code do absoluto zero até o avançado

• 120 aulas
• 4 projetos
• 9h 45min

Conhecer formação

E o app desktop?

Existe um app desktop nativo oficial pra macOS, Windows e Linux, com UI própria pra chat, configuração e gerenciamento

Um detalhe importante pra não te iludir: no macOS 12+ e no Windows 10/11 você vive na janela mesmo, mas no Linux a instalação do app continua sendo via terminal, em qualquer distro

Aqui vem a parte que confunde muita gente: o desktop NÃO é um produto separado

Ele usa o mesmo núcleo e os mesmos dados do CLI: mesma config, mesmas chaves de API, mesmas sessões, mesmas skills e mesma memória do CLI

Se você conhece aqueles apps que são só uma casca em cima da linha de comando, a analogia serve bem aqui: instalar um não te obriga a abandonar o outro

Docker e uso como biblioteca:

Tem imagem Docker oficial também, a nousresearch/hermes-agent, que já vem com o ambiente montado: Python 3.13, Node.js, npm, Playwright, o código do agente e o dashboard embutido

E dá pra usar o Hermes como biblioteca Python dentro dos seus próprios scripts e aplicações, importando a classe AIAgent direto

Tome cuidado com uma expectativa errada: o Hermes empacota o uv como gerenciador do próprio ambiente Python e não publica pacote para instalação via requirements.txt

Não existe wheel nem source distribution suportados, então se você achar um pacote desses por aí, desconfie na hora

Como saber se você está baixando de uma fonte não oficial

O sintoma:

Você pesquisa, aparecem vários resultados com o mesmo nome e literalmente a mesma descrição, "The agent that grows with you"

Todos parecem oficiais, todos têm README bonito, todos mandam você rodar um comando

A causa:

O projeto é aberto, e isso é ótimo, só que abre espaço pra cópia

No SourceForge existe um projeto chamado hermes-agent.mirror, descrito como espelho exato do GitHub e SEM afiliação com o projeto

No próprio GitHub tem forks e organizações de nome parecido publicando o mesmo projeto com a mesma descrição, fora do repositório oficial: pyrate-llama/hermes-agent, Abelion512/hermes-agent, adybag14-cyber/hermes-agent e até uma organização chamada nousresearch-hermes-agent (repara no hífen, é isso que engana)

E ainda tem os sites de terceiros que falam do projeto fora do domínio oficial, tipo hermes-agent.org, hermes-ai.net e hermes-agent.ai

A solução:

Duas regras e acabou a dúvida

1. Repositório: só NousResearch/hermes-agent no GitHub, com o dono escrito exatamente assim, sem hífen no meio da organização
2. Script: só o domínio hermes-agent.nousresearch.com

Antes de colar qualquer comando no terminal, olhe o DONO do repositório e o DOMÍNIO da URL do script

É o mesmo cuidado que a gente já precisa ter na hora de baixar um modelo de IA, onde a cópia parece idêntica e você só descobre a diferença depois

Um ponto justo: nem tudo que é não oficial é ruim

Existe um diretório independente da comunidade, o 0xNyk/awesome-hermes-agent, com skills, plugins e provedores de memória, e ele mesmo se declara não oficial

Isso é honesto e é bem diferente de um espelho se passando pela origem, beleza?

Formas de baixar o Hermes Agent: qual escolher

Todos os caminhos abaixo são oficiais, o que muda é o que cada um entrega

Se você só quer VER a ferramenta rodando, script oficial e pronto

Se você quer mexer no código, clone manual

O que você precisa antes de instalar

Nada de PC da Nasa aqui, mas alguns requisitos são duros

• Python 3.11 ou superior, esse é o piso da linguagem
• Dependências que o instalador resolve por você: Python, Node.js, ripgrep e ffmpeg
• Um provedor de LLM configurado, coisa que o próprio instalador te guia a fazer no final
• Um modelo com no mínimo 64.000 tokens de contexto

Esse último é o que mais pega gente desprevenida

O Hermes REJEITA modelos com contexto menor logo na inicialização

Ou seja, não adianta escolher aquele modelo minúsculo pra economizar: ele nem sobe

Passo a passo: baixar e instalar o Hermes Agent

Bora pra parte prática 😀

Escolha o caminho que combina com a sua máquina e siga só ele

1. Linux e macOS: rode o script oficial

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

O instalador grava o launcher do comando num caminho fixo: ~/.local/bin/hermes

É ali que o hermes mora, e saber isso evita aquele desespero de "instalei e sumiu"

A lógica é a mesma de qualquer gerenciador que instala binário em pasta própria, tipo onde o npm salva os pacotes quando você instala global

Erro comum deste passo: colar o comando com a URL de outro domínio que você achou num site de terceiro

Confira o domínio antes de dar Enter, é literalmente um script executando na sua máquina

2. Windows: rode o script no PowerShell

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

O instalador adiciona %LOCALAPPDATA%\hermes\hermes-agent\venv\Scripts ao PATH do usuário

Erro comum deste passo: continuar na MESMA janela do terminal depois de instalar

Janelas já abertas não recebem a mudança de PATH, então abra uma nova janela do PowerShell ou uma aba nova do Windows Terminal

3. Windows: use os parâmetros do install.ps1 se precisar

O script aceita parâmetros pra controlar a instalação: -NoVenv, -SkipSetup, -Branch e -IncludeDesktop

São úteis quando você quer pular o assistente de setup, apontar pra outro branch ou já trazer o desktop junto

4. Windows: primeiro lançamento do Hermes Desktop

Se você for pelo app desktop no Windows, o instalador dele chama o install.ps1 por baixo no primeiro lançamento pra provisionar as dependências: Python (via uv), Node e PortableGit

Erro comum deste passo: achar que o app travou no primeiro boot

Ele está provisionando ambiente, não é tela congelada

5. Instalação manual, pra quem vai mexer no código

git clone https://github.com/NousResearch/hermes-agent
cd hermes-agent
uv pip install -e ".[all,dev]"

O fluxo documentado é esse: clonar o repositório, criar o venv com Python 3.11 e instalar em modo editável

Erro comum deste passo: tentar instalar via requirements.txt ou procurar um pacote pronto

Não existe wheel nem source distribution suportados, o gerenciamento é com uv mesmo

6. Confira qual versão entrou

hermes --version

Esse é o comando documentado pra saber o que você tem instalado

A versão mais recente publicada nas releases do repositório oficial é a v0.20.0, com a tag v2026.8.3, publicada em 03/08/2026 e apelidada de "The Herald Release"

Se o número que apareceu aí for muito diferente do que está nas releases oficiais, é bom desconfiar da fonte de onde você baixou

Como foi instalar o Hermes Agent na prática

No vídeo abaixo eu instalo o Hermes Agent do zero numa VPS, direto pelo terminal do painel do provedor, sem interface gráfica nenhuma

O que mais me chamou atenção foi o tamanho do processo: na demonstração foram praticamente 2 comandos, um pra baixar os arquivos do repositório e outro pra executar o script, que ainda instalou os pacotes que faltavam na máquina

Quando terminou, o assistente de setup abriu sozinho, sem eu precisar rodar mais nada

Escolhi o quick setup, gerei uma chave de API nova só pro Hermes (com nome, limite de crédito e expiração) e selecionei um modelo gratuito, então deu pra ver a ferramenta rodando sem pagar pelo modelo

Depois pedi pro agente olhar a própria máquina: disco em 8% de uso e 7 GB de memória disponível, com resposta rápida

E quando fui olhar o sistema de memória, eram 2 arquivos separados, um do agente e um do usuário, mais uma busca de sessão em banco local pra não sobrecarregar esses arquivos

Detalhe que eu gostei: pedi uma busca web, o primeiro mecanismo respondeu bloqueado e o agente trocou de buscador sozinho pra concluir

Em outra ferramenta que eu já usava, eu precisava configurar uma API de busca separada pra isso funcionar

No vídeo dá pra acompanhar a instalação inteira, o setup guiado, a escolha do provider e os primeiros testes com o agente já rodando

Ainda assim, vale o de sempre: leia a documentação oficial como fonte principal, acima de tutorial de YouTube, incluindo os meus 😛

Problemas comuns depois do download

"hermes não é reconhecido" no Windows:

Sintoma: você instalou, o script terminou certinho, mas o terminal jura que o comando não existe

Causa: o instalador adiciona %LOCALAPPDATA%\hermes\hermes-agent\venv\Scripts ao PATH do usuário, e janelas já abertas não recebem essa mudança

Solução: abra uma nova janela do PowerShell ou uma aba nova do Windows Terminal

Como prevenir: feche o terminal antigo assim que a instalação terminar, sempre

Modelo rejeitado logo no startup:

Sintoma: o Hermes recusa o modelo na hora de iniciar

Causa: o requisito mínimo é de 64.000 tokens de contexto, e modelos menores são rejeitados no startup

Solução: escolha um modelo que atenda esse mínimo no seu provedor

Como prevenir: confira a janela de contexto ANTES de fechar a configuração do provider, não depois

Instalação desatualizada:

Sintoma: comportamento estranho, ou hermes --version mostrando algo bem atrás das releases do repositório

Solução: rode o comando oficial de atualização

hermes update

Ele puxa o código novo e atualiza as dependências

Como prevenir: dá uma olhada nas releases do repositório de vez em quando, o ritmo de publicação é visível ali

Alguma coisa quebrada e você não sabe o quê:

Existe um comando de diagnóstico da instalação

hermes doctor

Rode ele antes de sair reinstalando tudo, é bem mais rápido que apagar e começar do zero

Conclusão

Resumindo o que importa sobre Hermes Agent download: origem oficial é uma só, o repositório NousResearch/hermes-agent no GitHub e o domínio hermes-agent.nousresearch.com

Espelho no SourceForge, fork de nome parecido e site de terceiro podem até servir o mesmo conteúdo, mas você não tem como garantir isso, e script rodando na sua máquina não é lugar pra apostar

O próximo passo depois de instalar é curto: rode hermes --version pra confirmar o que entrou e hermes doctor pra ver se está tudo redondo

Depois é só acompanhar as releases do repositório, que estão em ritmo bem ativo (a v0.20.0, tag v2026.8.3, sucedeu a v0.19.1, tag v2026.7.30)

Instala, testa e tira a sua própria conclusão, é o melhor jeito de saber se a ferramenta serve pro seu fluxo

até o próximo post! =)