Instalar o Hermes Agent — Hermes Agent Lab

Instalação — Passo a Passo

Step 01

1. Executar o Instalador

Abra seu terminal e cole o comando. O instalador detecta seu sistema operacional e gerencia tudo automaticamente.

# macOS / Linux / WSL2

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

# Windows (PowerShell)

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

Step 02

2. Escolha seu Modelo

Após a instalação, escolha seu provedor LLM. Nous Portal (OAuth), OpenRouter, OpenAI, Anthropic, Gemini ou um endpoint personalizado.

# Choose your LLM provider interactively

hermes model

# Or use Nous Portal (OAuth, no API key needed)

hermes setup --portal

Step 03

3. Conecte suas Plataformas

Configure o gateway de mensagens para contatar seu agente pelo Telegram, Discord, Slack, WhatsApp ou Signal — tudo a partir de um processo de gateway unificado.

# Interactive gateway setup wizard

hermes gateway setup

# Start the messaging gateway

hermes gateway

Step 04

4. Comece a Conversar

Digite hermes no terminal e comece sua primeira conversa. O agente começa a aprender imediatamente — construindo memória e criando habilidades.

# Reload your shell first, then:

source ~/.bashrc # or: source ~/.zshrchermes

Pré-requisitos

Em plataformas não Windows, apenas o Git é necessário. No Linux, certifique-se de que curl e xz-utils estejam disponíveis. O instalador gerencia o resto automaticamente.

O que o Instalador Gerencia Automaticamente

Dependências auto-instaladas:

uv (gerenciador de pacotes Python), Python 3.11, Node.js v22, ripgrep (busca rápida de arquivos), ffmpeg (conversão de áudio)

Estrutura de Instalação

Onde os arquivos ficam após a instalação:

Tipo de instalação	Local do código	Binário	Diretório de dados
Usuário (git)	~/.hermes/hermes-agent/	~/.local/bin/hermes	~/.hermes/
Root (sudo)	/usr/local/lib/hermes-agent/	/usr/local/bin/hermes	/root/.hermes/

Caminho Mais Rápido: Nous Portal

Uma assinatura cobre mais de 300 modelos mais o Tool Gateway (busca na web, geração de imagens, TTS, navegador em nuvem). Execute hermes setup --portal para login OAuth + configuração do provedor + ativação do Tool Gateway em um único comando.

hermes setup --portal

Após a Instalação

Recarregue seu shell e comece a conversar

source ~/.bashrc # or: source ~/.zshrchermes # Start chatting!

Solução de Problemas

Problema	Solução
hermes: command not found	Recarregue seu shell (source ~/.bashrc ou source ~/.zshrc) ou verifique seu PATH.
API key not set	Execute hermes model para configurar seu provedor, ou hermes config set PROVIDER_API_KEY sua_chave.
Configuração perdida após atualização	Execute hermes config check e depois hermes config migrate.