Hermes Agent ☤

Hermes Agent | Hermes Desktop

O agente de IA auto-melhorável criado pela Nous Research. É o único agente com um ciclo de aprendizado integrado — ele cria habilidades a partir da experiência, melhora-as durante o uso, incentiva-se a persistir conhecimento, pesquisa suas próprias conversas passadas e constrói um modelo cada vez mais profundo de quem você é entre sessões. Execute-o em um VPS de US$ 5, um cluster de GPUs ou infraestrutura serverless que custa quase nada quando ociosa. Ele não está preso ao seu laptop — converse com ele pelo Telegram enquanto ele trabalha em uma VM na nuvem.

Use qualquer modelo que quiser — Nous Portal, OpenRouter, OpenAI, seu próprio endpoint e muitos outros. Alterne com hermes model — sem mudanças de código, sem dependência de fornecedor.

Instalação Rápida

Linux, macOS, WSL2, Termux

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

Windows (nativo, PowerShell)

Atenção: O Windows nativo executa o Hermes sem WSL — CLI, gateway, TUI e ferramentas funcionam nativamente. Se preferir usar WSL2, o comando de uma linha para Linux/macOS também funciona lá. Encontrou um bug? Por favor, registre issues.

Execute isto no PowerShell:

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

O instalador cuida de tudo: uv, Python 3.11, Node.js, ripgrep, ffmpeg, e um Git Bash portátil (MinGit, descompactado em %LOCALAPPDATA%\hermes\git — sem necessidade de administrador, completamente isolado de qualquer instalação de Git do sistema). O Hermes usa este Git Bash integrado para executar comandos de shell.

Se você já tem o Git instalado, o instalador o detecta e o usa em vez disso. Caso contrário, um download de ~45MB do MinGit é tudo o que você precisa — ele não tocará nem interferirá em nenhum Git do sistema.

Android / Termux: O caminho manual testado está documentado no guia Termux. No Termux, o Hermes instala um extra curado .[termux] porque o extra completo .[all] atualmente puxa dependências de voz incompatíveis com Android.

Windows: O Windows nativo é totalmente suportado — o comando de uma linha do PowerShell acima instala tudo. Se preferir usar WSL2, o comando Linux também funciona lá. A instalação nativa do Windows fica em %LOCALAPPDATA%\hermes; a instalação WSL2 fica em ~/.hermes como no Linux.

Após a instalação:

source ~/.bashrc    # recarregue o shell (ou: source ~/.zshrc)
hermes              # comece a conversar!

Solução de Problemas

Windows Defender ou antivírus marca uv.exe como malware

Se o seu antivírus (Bitdefender, Windows Defender, etc.) colocar em quarentena o uv.exe da pasta bin do Hermes (%LOCALAPPDATA%\hermes\bin\uv.exe), isso é um falso positivo. O arquivo é o uv da Astral — o gerenciador de pacotes Python em Rust que o Hermes inclui para gerenciar seu ambiente Python. Mecanismos de antivírus baseados em ML frequentemente sinalizam binários Rust não assinados que baixam e instalam pacotes.

Para verificar se sua cópia é autêntica:

# Instale o GitHub CLI se necessário
winget install --id GitHub.cli

# Faça login no GitHub
gh auth login

# Execute a verificação
$uv = "$env:LOCALAPPDATA\hermes\bin\uv.exe"
$ver = (& $uv --version).Split(' ')[1]
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
$zip = "$env:TEMP\uv.zip"
Invoke-WebRequest "https://github.com/astral-sh/uv/releases/download/$ver/uv-x86_64-pc-windows-msvc.zip" -OutFile $zip -UseBasicParsing
gh attestation verify $zip --repo astral-sh/uv
Expand-Archive $zip "$env:TEMP\uv_x" -Force
(Get-FileHash "$env:TEMP\uv_x\uv.exe").Hash -eq (Get-FileHash $uv).Hash

Se a atestação disser "Verification succeeded" e a última linha imprimir True, está tudo certo.

Para colocar o Hermes na lista de permissões:

• Windows Defender: Execute o PowerShell como Administrador → Add-MpPreference -ExclusionPath "$env:LOCALAPPDATA\hermes\bin"
• Bitdefender: Adicione uma exceção no console do Bitdefender (Protection > Antivirus > Settings > Manage Exceptions)
• Coloque a pasta na lista de permissões, não o hash do arquivo — o Hermes atualiza o uv e o hash muda a cada versão

Para mais contexto, veja os relatórios upstream da Astral: astral-sh/uv#13553, astral-sh/uv#15011, astral-sh/uv#10079.

Primeiros Passos

hermes              # CLI interativo — inicie uma conversa
hermes model        # Escolha seu provedor de LLM e modelo
hermes tools        # Configure quais ferramentas estão habilitadas
hermes config set   # Defina valores de configuração individuais
hermes config get   # Imprima valores de configuração individuais
hermes gateway      # Inicie o gateway de mensagens (Telegram, Discord, etc.)
hermes setup        # Execute o assistente de configuração completo (configura tudo de uma vez)
hermes claw migrate # Migre do OpenClaw (se você vem do OpenClaw)
hermes update       # Atualize para a versão mais recente
hermes doctor       # Diagnostique quaisquer problemas

📖 Documentação completa →

Pule a coleta de chaves de API — Nous Portal

O Hermes funciona com qualquer provedor que você quiser — isso não muda. Mas se você prefere não coletar cinco chaves de API separadas para o modelo, pesquisa na web, geração de imagens, TTS e um navegador em nuvem, o Nous Portal cobre todos eles com uma única assinatura:

• 300+ modelos — escolha qualquer um deles com /model <nome>
• Tool Gateway — pesquisa na web (Firecrawl), geração de imagens (FAL), texto-para-fala (OpenAI), navegador em nuvem (Browser Use), tudo roteado pela sua assinatura. Sem contas extras.

Um único comando a partir de uma instalação nova:

hermes setup --portal

Isso faz login via OAuth, define Nous como seu provedor e ativa o Tool Gateway. Verifique o que está conectado a qualquer momento com hermes portal info. Detalhes completos na página de documentação do Tool Gateway.

Você ainda pode trazer suas próprias chaves por ferramenta sempre que quiser — o gateway é por backend, não tudo-ou-nada.

Referência Rápida: CLI vs Mensagens

O Hermes tem dois pontos de entrada: inicie a interface de terminal com hermes, ou execute o gateway e converse com ele pelo Telegram, Discord, Slack, WhatsApp, Signal ou Email. Uma vez em uma conversa, muitos comandos com barra são compartilhados entre ambas as interfaces.

Para as listas completas de comandos, veja o guia CLI e o guia do Messaging Gateway.

Documentação

Toda a documentação está em hermes-agent.nousresearch.com/docs:

Migrando do OpenClaw

Se você vem do OpenClaw, o Hermes pode importar automaticamente suas configurações, memórias, habilidades e chaves de API.

Durante a primeira configuração: O assistente de configuração (hermes setup) detecta automaticamente ~/.openclaw e oferece a migração antes do início da configuração.

A qualquer momento após a instalação:

hermes claw migrate              # Migração interativa (preset completo)
hermes claw migrate --dry-run    # Pré-visualize o que seria migrado
hermes claw migrate --preset user-data   # Migre sem segredos
hermes claw migrate --overwrite  # Sobrescreva conflitos existentes

O que é importado:

• SOUL.md — arquivo de persona
• Memórias — entradas de MEMORY.md e USER.md
• Habilidades — habilidades criadas pelo usuário → ~/.hermes/skills/openclaw-imports/
• Lista de permissões de comandos — padrões de aprovação
• Configurações de mensagens — configurações de plataforma, usuários permitidos, diretório de trabalho
• Chaves de API — segredos na lista de permissões (Telegram, OpenRouter, OpenAI, Anthropic, ElevenLabs)
• Ativos de TTS — arquivos de áudio do workspace
• Instruções do workspace — AGENTS.md (com --workspace-target)

Veja hermes claw migrate --help para todas as opções, ou use a habilidade openclaw-migration para uma migração interativa guiada por agente com pré-visualizações de dry-run.

Contribuindo

Aceitamos contribuições! Veja o Guia de Contribuição para configuração de desenvolvimento, estilo de código e processo de PR.

Início rápido para contribuidores — use o instalador padrão e depois trabalhe a partir do checkout git completo que ele cria em $HERMES_HOME/hermes-agent (geralmente ~/.hermes/hermes-agent). Isso corresponde ao layout usado por hermes update, o venv gerenciado, dependências preguiçosas, gateway e ferramentas de documentação.

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
cd "${HERMES_HOME:-$HOME/.hermes}/hermes-agent"
uv pip install -e ".[all,dev]"
scripts/run_tests.sh

Fallback de clone manual (para clones descartáveis/CI onde você intencionalmente não quer o layout de instalação gerenciada):

Crie o venv fora da árvore de código-fonte clonada — um venv dentro do diretório a partir do qual o agente opera pode ser apagado por um comando de caminho relativo que o agente executa contra seu próprio checkout, destruindo o runtime em execução no meio da sessão.

curl -LsSf https://astral.sh/uv/install.sh | sh
uv venv ~/.hermes/venvs/hermes-dev --python 3.11
source ~/.hermes/venvs/hermes-dev/bin/activate
uv pip install -e ".[all,dev]"
scripts/run_tests.sh

Comunidade

• 💬 Discord
• 📚 Skills Hub
• 🐛 Issues
• 🔌 computer-use-linux — Servidor MCP de controle de desktop Linux para Hermes e outros hosts MCP, com árvores de acessibilidade AT-SPI, entrada Wayland/X11, capturas de tela e direcionamento de janelas do compositor.
• 🔌 HermesClaw — Ponte comunitária para WeChat: Execute o Hermes Agent e o OpenClaw na mesma conta do WeChat.

Licença

MIT — veja LICENSE.

Criado pela Nous Research.