Hermes Agent: Instalação

Q: P: Como atualizar para a versão mais recente?

R: pip install --upgrade hermes-agent. Arquivos de configuração e dados de memória são preservados.

Última atualização: 2026-08-31

Instalar o Hermes Agent é como configurar um assistente de aprendizado no seu computador — instale uma vez, e ele estará sempre pronto para ajudar.

💡 Dica: A instalação via pip é recomendada por ser a mais simples e rápida. O Docker é ideal para deploys em servidor. A versão desktop é para usuários não técnicos.

📋 Pré-requisitos: Lição 1 — Introdução e Recursos Principais

1. O Que Você Vai Aprender

#	Conteúdo
❶	Requisitos de sistema e verificação de ambiente
❷	Instalação via pip (recomendada)
❸	Instalação via código-fonte
❹	Instalação via Docker
❺	Verificação de instalação e solução de problemas

2. História

(1) Problema: Não Consegue Configurar o Ambiente

Bob quer experimentar o Hermes Agent, mas a versão do Python está errada, há conflitos de dependências, problemas de permissão... passou uma tarde inteira e ainda não consegue rodar.

(2) Solução: Instalação em Três Passos

Alice conseguiu rodar em apenas três passos:

BASH

# 1. Verificar ambiente
python --version  # Python 3.10+

# 2. Instalar com um comando
pip install hermes-agent

# 3. Inicializar
hermes init

# Pronto! Comece a conversar
hermes chat

Bob seguiu os passos e estava funcionando em 5 minutos.

3. Requisitos de Sistema

(1) Requisitos Mínimos

Componente	Mínimo	Recomendado
Python	3.10	3.11+
RAM	4 GB	8 GB+
Disco	2 GB	10 GB+
SO	Linux/macOS/Windows	Linux/macOS

(2) Script de Verificação de Ambiente

BASH

# Verificação de ambiente com um comando
curl -sSL https://hermes.dev/check-env.sh | bash

PYTHON

# Ou verifique com Python
import sys
import platform

print(f"Python: {sys.version}")
print(f"Platform: {platform.system()} {platform.release()}")
print(f"Python >= 3.10: {sys.version_info >= (3, 10)}")

💻 Saída:

TEXT 📖 Somente leitura

Python: 3.11.5
Platform: Linux 6.1.0
Python >= 3.10: True

4. Métodos de Instalação

(1) Instalação via pip (Recomendada)

BASH

# Instalação básica
pip install hermes-agent

# Com suporte a todas as plataformas
pip install hermes-agent[all]

# Apenas plataformas específicas
pip install hermes-agent[telegram,discord]

# Com aceleração GPU (inferência de modelo local)
pip install hermes-agent[gpu]

Ferramentas CLI após instalação:

BASH

hermes --version     # Verificar versão
hermes init          # Inicializar configuração
hermes chat          # Iniciar conversa
hermes serve         # Iniciar servidor API
hermes platform list # Listar plataformas disponíveis

(2) Instalação via Código-Fonte

BASH

# Clonar repositório
git clone https://github.com/nous-research/hermes-agent.git
cd hermes-agent

# Criar ambiente virtual
python -m venv venv
source venv/bin/activate  # Linux/macOS
# venv\Scripts\activate   # Windows

# Instalar dependências
pip install -e ".[dev]"

# Verificar
hermes --version

(3) Instalação via Docker

BASH

# Baixar imagem oficial
docker pull nousresearch/hermes-agent:latest

# Executar (com chat interativo)
docker run -it \
  -v ~/.hermes:/root/.hermes \
  -e HERMES_MODEL=gpt-4o \
  nousresearch/hermes-agent:latest \
  hermes chat

# Usando docker-compose
curl -O https://hermes.dev/docker-compose.yml
docker-compose up -d

YAML

# docker-compose.yml
version: "3.8"
services:
  hermes:
    image: nousresearch/hermes-agent:latest
    volumes:
      - ./hermes-data:/root/.hermes
    environment:
      - HERMES_MODEL=gpt-4o
      - OPENAI_API_KEY=${OPENAI_API_KEY}
    ports:
      - "8080:8080"
    restart: unless-stopped

5. Inicialização

BASH

# Inicialização interativa
hermes init

# A inicialização perguntará:
? Select default model: gpt-4o
? Enter OpenAI API Key: sk-...
? Select storage location: ~/.hermes
? Enable telemetry: No
? Create example skills? Yes

Estrutura de diretórios após inicialização:

~/.hermes/
├── config.yaml        # Arquivo de configuração principal
├── models.yaml        # Configuração de modelos
├── memory/            # Armazenamento de memória
│   ├── working/       # Memória de trabalho
│   ├── long_term/     # Memória de longo prazo
│   └── user_models/   # Modelos de usuário
├── skills/            # Armazenamento de habilidades
│   ├── built_in/      # Habilidades integradas
│   └── custom/        # Habilidades personalizadas
├── tools/             # Ferramentas personalizadas
├── plugins/           # Plugins
└── logs/              # Logs

6. Verificação de Instalação

BASH

# Verificação completa
hermes doctor

# Exemplo de saída:
# ✅ Python 3.11.5
# ✅ Hermes Agent v1.0.0
# ✅ Config file exists
# ✅ Memory system OK
# ✅ Skill engine OK
# ✅ Tools registered: 72
# ✅ Model connection: gpt-4o (OK)
# ✅ Storage space: 8.2 GB available

Experimente: Primeira Conversa

BASH

hermes chat

> Hello, I'm Hermes!
> I remember information about you (nothing yet, but I'll learn!)
> Try telling me your name and preferences.

me: I'm Alice, I'm a frontend developer, I like TypeScript and React

> Got it! From now on I'll remember:
> - Your name is Alice
> - Frontend developer
> - Prefer TypeScript + React
> What can I help you with?

7. Problemas Comuns de Instalação

Problema	Causa	Solução
`pip install` falha	Versão do Python muito antiga	Atualize para Python 3.10+
Permission denied	Permissões de diretório do sistema	Use `--user` ou ambiente virtual
Conflito de dependências	Conflitos de versão com outros pacotes	Use `venv` para isolamento
Docker não inicia	Docker não instalado/em execução	Instale o Docker Desktop
Invalid API Key	Key expirada ou formato incorreto	Verifique a Key em `config.yaml`
Falha na inicialização da memória	Permissões de diretório	`chmod 755 ~/.hermes`

BASH

# Reinstalação limpa
pip uninstall hermes-agent -y
rm -rf ~/.hermes
pip install hermes-agent
hermes init

❓ Perguntas Frequentes

P: Posso instalar no Windows? R: Sim. O Hermes suporta Windows 10/11. WSL2 ou PowerShell 7+ recomendado. Alguns recursos (como ferramentas Shell) funcionam melhor no WSL2.

P: Preciso de GPU? R: Não. GPU é necessária apenas para inferência de modelo local (via Ollama/vLLM). O uso de API na nuvem não requer GPU.

P: Pode coexistir com outros projetos Python? R: Use um ambiente virtual (venv/conda) para evitar conflitos de dependências. O Hermes não afetará dependências de outros projetos.

P: Como atualizar para a versão mais recente? R: pip install --upgrade hermes-agent. Arquivos de configuração e dados de memória são preservados.

P: Quanto espaço ocupa? R: Instalação base ~200 MB, com dependências ~500 MB. Dados de memória e habilidades crescem com o uso, tipicamente 10-50 MB por mês.

P: Roda no Raspberry Pi? R: Raspberry Pi 4 (4GB) pode rodar, mas apenas com modelos na nuvem. Inferência de modelo local requer hardware mais potente.

📖 Resumo

Três métodos de instalação: pip (recomendado), código-fonte, Docker
pip em uma linha: pip install hermes-agent[all]
hermes init para configuração interativa, cria estrutura de diretórios automaticamente
hermes doctor verifica sucesso da instalação
Ambientes virtuais previnem conflitos de dependências; Docker para deploys em servidor

📝 Exercícios

Básico (⭐): Instale o Hermes Agent no seu computador, execute hermes doctor e confirme todos os ✅.
Intermediário (⭐⭐): Implante o Hermes Agent usando Docker com armazenamento persistente, garantindo que os dados sobrevivam a reinicializações.
Avançado (⭐⭐⭐): Escreva um script de instalação automatizado que detecte o ambiente, selecione o método de instalação e configure automaticamente para deploy com um clique.

Equipe Técnica Web-Tutorial

Uma plataforma de tutoriais mantida por diversos desenvolvedores. Cada tutorial é escrito e revisado por profissionais da área correspondente. Trabalhamos para manter nosso conteúdo preciso e confiável — se encontrar algum problema, avise-nos.

Sobre Nós