Como Instalar o Hermes Agent no macOS, Linux e Windows

Este guia cobre a instalação do Hermes Agent nos três principais sistemas operativos. Ao final, terás o Hermes Agent a funcionar com o teu provider de IA preferido.

Pré-requisitos

• Python 3.10 ou superior
• Git
• Uma chave de API de um provider de IA (ou vontade de usar modelos locais)

Instalação no macOS

No macOS, tens duas opções: Homebrew ou instalação manual com pip.

Opção 1 — Homebrew (recomendado):

brew tap hermes-agent/tap
brew install hermes-agent

Opção 2 — Pip:

git clone https://github.com/HermesAgent/hermes-agent.git
cd hermes-agent
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
pip install -e .

Instalação no Linux

git clone https://github.com/HermesAgent/hermes-agent.git
cd hermes-agent
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
pip install -e .

Para distribuições baseadas em Debian/Ubuntu, certifica-te de que tens o Python 3.10+ instalado:

sudo apt update
sudo apt install python3 python3-pip python3-venv git

Instalação no Windows

1. Instala o Python 3.10+ a partir do python.org (marca "Add to PATH")
2. Instala o Git a partir do git-scm.com
3. Abre o PowerShell como administrador e executa:

git clone https://github.com/HermesAgent/hermes-agent.git
cd hermes-agent
python -m venv venv
.\venv\Scripts\activate
pip install -r requirements.txt
pip install -e .

Configuração de Providers

Após a instalação, cria um ficheiro .env na raiz do projeto com as tuas chaves de API:

OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...
GOOGLE_API_KEY=...
DEEPSEEK_API_KEY=...

Se quiseres usar modelos locais com Ollama:

brew install ollama  # macOS
# ou: curl -fsSL https://ollama.ai/install.sh | sh  # Linux
ollama pull llama3.1
ollama pull hermes-agent  # modelo otimizado

Verificar a Instalação

Executa o comando de teste:

hermes --version
hermes --help

Se vires a informação de versão e ajuda, a instalação está concluída. Recomenda-se também correr hermes status para confirmar que os providers configurados estão acessíveis antes de começares a trabalhar.

Resolução de Problemas Comuns

"Comando não encontrado"

Certifica-te de que o ambiente virtual está ativo (source venv/bin/activate no macOS/Linux, venv\Scripts\activate no Windows).

Erro de dependências

Algumas dependências podem exigir compilação. No macOS, instala as ferramentas de linha de comandos do Xcode: xcode-select --install. No Linux, sudo apt install build-essential.

Primeira Configuração

Com a instalação concluída, o próximo passo é fazer a configuração inicial. O Hermes Agent oferece um assistente que cria o ficheiro de configuração e te guia na escolha do provider:

1. Executa hermes init na pasta onde queres trabalhar — o comando cria a estrutura de diretórios e o ficheiro .env de exemplo.
2. Escolhe o provider principal (OpenAI, Anthropic, Gemini, DeepSeek ou local).
3. Introduz a chave de API quando solicitado. O assistente guarda-a no .env e mantém-na fora do controlo de versões.
4. Define o modelo predefinido. Podes deixar o valor padrão e alterar depois por tarefa.

Se preferires editar manualmente, os ficheiros ficam em ~/.hermes/ e podes ajustar modelos, temperatura e tempo limite de cada pedido.

Primeiro Agente

Para confirmares que tudo funciona, cria um agente simples e faz-lhe uma pergunta:

hermes agent new boas-vindas
hermes run boas-vindas "Olá, apresenta-te em duas frases"

Se a resposta aparecer sem erros, tens o pipeline completo a funcionar: o Hermes Agent comunicou com o provider, recebeu a resposta e devolveu-a no terminal.

Manutenção e Atualizações

Como é uma ferramenta em evolução rápida, é boa prática atualizar regularmente:

brew update && brew upgrade hermes-agent

Para instalações via git clone, entra na pasta do projeto, faz git pull e reinstala as dependências com pip install -r requirements.txt.

Requisitos Mínimos

Para uma experiência fluida, recomenda-se: um processador de 64 bits, pelo menos 4 GB de RAM (8 GB se usares modelos locais) e 2 GB de espaço livre em disco. O Hermes Agent corre em macOS 11+, distribuições Linux recentes e Windows 10+.

Não precisas de uma máquina potente para começar — o processamento mais pesado acontece na API do provider remoto. Só se quiseres correr modelos locais é que o hardware passa a importar, porque o modelo vive no teu computador.

Perguntas Frequentes

Posso ter vários providers ao mesmo tempo?

Sim. O Hermes Agent é multi-provider: podes definir vários providers e escolher o modelo ideal para cada skill ou tarefa, bastando indicar o provider no comando.

E se não quiser pagar por uma API?

Usa modelos locais com o Ollama. A instalação local é gratuita e os teus dados nunca saem do teu computador — um bom ponto de partida para testar.

O que devo fazer se a instalação falhar a meio?

Volta ao passo onde falhou e confirma os pré-requisitos (versão do Python, Git instalado e ambiente virtual ativo). Na maioria dos casos, o problema é uma dependência de sistema que falta instalar.

Conclusão

Instalar o Hermes Agent é rápido em qualquer sistema operativo, e a configuração inicial demora poucos minutos. Com o agente funcional, estás pronto para o passo seguinte: criar a tua primeira skill e começar a automatizar tarefas do dia a dia.