nousresearch/hermes-agentO agente que cresce com você
O agente de IA auto-melhorável criado pela . É 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.
| Uma interface de terminal real | TUI completo com edição multilinha, autocompletar de comandos com barra, histórico de conversas, interrupção e redirecionamento, e saída de ferramentas em streaming. |
| Vive onde você vive | Telegram, Discord, Slack, WhatsApp, Signal e CLI — tudo a partir de um único processo de gateway. Transcrição de notas de voz, continuidade de conversas entre plataformas. |
| Um ciclo de aprendizado fechado | Memória curada pelo agente com lembretes periódicos. Criação autônoma de habilidades após tarefas complexas. As habilidades se auto-melhoram durante o uso. Pesquisa de sessões FTS5 com sumarização por LLM para recordação entre sessões. Modelagem de usuário dialética com Honcho. Compatível com o padrão aberto agentskills.io. |
| Automações agendadas | Agendador cron integrado com entrega para qualquer plataforma. Relatórios diários, backups noturnos, auditorias semanais — tudo em linguagem natural, executado sem supervisão. |
| Delega e paraleliza | Gere subagentes isolados para fluxos de trabalho paralelos. Escreva scripts Python que chamam ferramentas via RPC, colapsando pipelines de múltiplas etapas em turnos de custo zero de contexto. |
| Roda em qualquer lugar, não só no seu laptop | Sete backends de terminal — local, Docker, SSH, Singularity, Modal, Daytona e Vercel Sandbox. Daytona e Modal oferecem persistência serverless — o ambiente do seu agente hiberna quando ocioso e desperta sob demanda, custando quase nada entre sessões. Execute-o em um VPS de US$ 5 ou em um cluster de GPUs. |
| Pronto para pesquisa | Geração de trajetórias em lote, compressão de trajetórias para treinar a próxima geração de modelos de chamada de ferramentas. |
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
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~/.hermescomo no Linux.
Após a instalação:
source ~/.bashrc # recarregue o shell (ou: source ~/.zshrc)
hermes # comece a conversar!
uv.exe como malwareSe 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:
Add-MpPreference -ExclusionPath "$env:LOCALAPPDATA\hermes\bin"uv e o hash muda a cada versãoPara mais contexto, veja os relatórios upstream da Astral: astral-sh/uv#13553, astral-sh/uv#15011, astral-sh/uv#10079.
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
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:
/model <nome>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.
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.
| Ação | CLI | Plataformas de mensagens |
|---|---|---|
| Começar a conversar | hermes | Execute hermes gateway setup + hermes gateway start, depois envie uma mensagem ao bot |
| Iniciar nova conversa | /new ou /reset | /new ou /reset |
| Mudar modelo | /model [provider:model] | /model [provider:model] |
| Definir uma personalidade | /personality [nome] | /personality [nome] |
| Repetir ou desfazer o último turno | /retry, /undo | /retry, /undo |
| Comprimir contexto / verificar uso | /compress, /usage, /insights [--days N] | /compress, /usage, /insights [days] |
| Navegar por habilidades | /skills ou /<nome-da-habilidade> | /<nome-da-habilidade> |
| Interromper o trabalho atual | Ctrl+C ou envie uma nova mensagem | /stop ou envie uma nova mensagem |
| Status específico da plataforma | /platforms | /status, /sethome |
Para as listas completas de comandos, veja o guia CLI e o guia do Messaging Gateway.
Toda a documentação está em hermes-agent.nousresearch.com/docs:
| Seção | O que é abordado |
|---|---|
| Quickstart | Instalação → configuração → primeira conversa em 2 minutos |
| CLI Usage | Comandos, atalhos de teclado, personalidades, sessões |
| Configuration | Arquivo de configuração, provedores, modelos, todas as opções |
| Messaging Gateway | Telegram, Discord, Slack, WhatsApp, Signal, Home Assistant |
| Security | Aprovação de comandos, pareamento por DM, isolamento de contêineres |
| Tools & Toolsets | 40+ ferramentas, sistema de toolsets, backends de terminal |
| Skills System | Memória procedural, Skills Hub, criação de habilidades |
| Memory | Memória persistente, perfis de usuário, melhores práticas |
| MCP Integration | Conecte qualquer servidor MCP para capacidades estendidas |
| Cron Scheduling | Tarefas agendadas com entrega por plataforma |
| Context Files | Contexto de projeto que molda cada conversa |
| Architecture | Estrutura do projeto, loop do agente, classes principais |
| Contributing | Configuração de desenvolvimento, processo de PR, estilo de código |
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:
~/.hermes/skills/openclaw-imports/--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.
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
MIT — veja LICENSE.
Criado pela Nous Research.
| CLI Reference | Todos os comandos e flags |
| Environment Variables | Referência completa de variáveis de ambiente |