convez.ai
AgenteAutomaçãoAvançado
NousResearch

Hermes Agent

NousResearch/hermes-agent

Agent autoaprendizado com memória persistente e automações agendadas

Ver no GitHub
ExcelentePluginScore · de 0 a 100

Agent de IA autoaprendizado da Nous Research que cria e melhora habilidades através de experiência, com loop de aprendizado fechado. Roda em qualquer lugar (VPS, GPU cluster, serverless) e integra-se a múltiplas plataformas (Telegram, Discord, Slack, etc) com suporte a qualquer modelo de LLM.

Instalação

$npx convez-ai NousResearch/hermes-agent

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
264 mil
Forks
60 mil
Acompanhando
1,0 mil
Saúde
75%
Último commit
há 1 dia
Versão
v0.23.2
Issues abertas
54 mil
Contribuidores
1,5 mil

Casos de uso

  • Automação de tarefas recorrentes em múltiplas plataformas
  • Criação dinâmica de skills a partir de experiências prévias
  • Orquestração de workflows paralelos com subagents
  • Assistente persistente na nuvem acessível via Telegram/Discord/CLI

Veredito

Agent robusto com arquitetura genuinamente inovadora — loop de aprendizado real e persistência de conhecimento cross-session são diferenciais reais. Excelente para quem quer automação sofisticada e escalável, mas exige experiência em Python e infraestrutura.

README em português

Hermes Agent ☤

O agente de IA auto-melhorativo construído pela Nous Research. É o único agente com um loop de aprendizado embutido — ele cria habilidades a partir da experiência, as aprimora durante o uso, incentiva-se para persistir conhecimento, busca suas próprias conversas passadas e constrói um modelo profundo sobre quem você é ao longo das sessões. Execute-o em uma VPS de $5, um cluster de GPU ou infraestrutura serverless que custa quase nada quando ocioso. Não está atrelado ao seu laptop — converse com ele pelo Telegram enquanto ele trabalha em uma VM na nuvem.

Use qualquer modelo que desejar: Nous Portal, OpenRouter (200+ modelos), NovitaAI (nuvem nativa de IA para API de Modelos, Sandbox de Agentes e GPU Cloud), NVIDIA NIM (Nemotron), Xiaomi MiMo, z.ai/GLM, Kimi/Moonshot, MiniMax, Hugging Face, OpenAI ou seu próprio endpoint. Troque com hermes model — sem alterações de código, sem lock-in.


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 precisar do WSL — CLI, gateway, TUI e todas as ferramentas funcionam nativamente. Se preferir usar o WSL2, o comando de uma linha para Linux/macOS acima também funciona lá. Encontrou um bug? Por favor aberta issues.

Execute isso 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 para %LOCALAPPDATA%\hermes\git — sem necessidade de administrador, completamente isolado de qualquer instalação do sistema Git). O Hermes usa este Git Bash embutido para executar comandos de shell.

Se você já tiver o Git instalado, o instalador detecta e utiliza-o em vez disso. Caso contrário, um download MinGit de ~45MB é tudo que precisa — ele não tocará nem interferirá no seu sistema Git existente.

Android / Termux: O caminho manual testado está documentado na guia do 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 PowerShell acima instala tudo. Se preferir usar WSL2, o comando Linux também funciona lá. A instalação no Windows nativo fica em %LOCALAPPDATA%\hermes; instalações via WSL2 ficam em ~/.hermes como no Linux.

Após a instalação:

source ~/.bashrc    # reload shell (or: source ~/.zshrc)
hermes              # start chatting!

Começando

hermes              # Interactive CLI — start a conversation
hermes model        # Choose your LLM provider and model
hermes tools        # Configure which tools are enabled
hermes config set   # Set individual config values
hermes gateway      # Start the messaging gateway (Telegram, Discord, etc.)
hermes setup        # Run the full setup wizard (configures everything at once)
hermes claw migrate # Migrate from OpenClaw (if coming from OpenClaw)
hermes update       # Update to the latest version
hermes doctor       # Diagnose any issues

📖 Documentação completa →


Pule a coleta de chaves API — Nous Portal

O Hermes funciona com qualquer provedor que você desejar — isso não está mudando. Mas se preferir não coletar cinco chaves de API separadas para o modelo, busca na web, geração de imagens, TTS e um navegador em nuvem, Nous Portal cobre tudo sob uma única assinatura:

  • 300+ modelos — escolha qualquer um com /model <name>
  • Tool Gateway — busca na web (Firecrawl), geração de imagens (FAL), texto para fala (OpenAI) e navegador em nuvem (Browser Use), todos roteados através da sua assinatura. Sem contas extras.

Um comando após uma instalação fresca:

hermes setup --portal

Isso faz o login via OAuth, define a Nous como seu provedor e ativa o Tool Gateway. Verifique sempre o que está conectado 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 quando quiser — o gateway é por backend, não tudo ou nada.

Referência Rápida: CLI vs Mensagens

O Hermes possui dois pontos de entrada: inicie a interface do terminal com hermes, ou execute o gateway e converse com ele via Telegram, Discord, Slack, WhatsApp, Signal ou E-mail. Uma vez dentro de uma conversa, muitos comandos slash são compartilhados entre ambas as interfaces.

AçãoCLIPlataformas de mensagens
Iniciar chathermesExecute hermes gateway setup + hermes gateway start, depois envie uma mensagem ao bot
Iniciar conversa nova/new ou /reset/new ou /reset
Alterar modelo/model [provider:model]/model [provider:model]
Definir personalidade/personality [name]/personality [name]
Retentar ou desfazer a última rodada/retry, /undo/retry, /undo
Comprimir contexto / verificar uso/compress, /usage, /insights [--days N]/compress, /usage, /insights [days]
Navegar por habilidades/skills ou /<skill-name>/<skill-name>
Interromper trabalho atualCtrl+C ou enviar uma nova mensagem/stop ou enviar 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 Gateway de Mensagens.

Documentação

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

SeçãoO que é coberto
QuickstartInstalação → configuração → primeira conversa em 2 minutos
Uso do CLIComandos, atalhos de teclado, personalidades e sessões
ConfiguraçãoArquivo de configuração, provedores, modelos e todas as opções
Gateway de MensagensTelegram, Discord, Slack, WhatsApp, Signal, Home Assistant
SegurançaAprovação de comandos, pareamento DM, isolamento de contêineres
Ferramentas e Conjuntos de Ferramentas40+ ferramentas, sistema de conjuntos de ferramentas e backends de terminal
Sistema de HabilidadesMemória procedural, Skills Hub, criação de habilidades
MemóriaMemória persistente, perfis de usuário e melhores práticas
Integração MCPConecte qualquer servidor MCP para capacidades estendidas
Agendamento CronTarefas agendadas com entrega de plataforma
Arquivos de ContextoContexto do projeto que molda cada conversa
ArquiteturaEstrutura do projeto, loop do agente e classes principais
ContribuindoConfiguração de desenvolvimento, processo de PR e estilo de código
Referência CLITodos os comandos e flags
Variáveis de AmbienteReferência completa das variáveis de ambiente

Migrando do OpenClaw

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

Durante a configuração inicial: O assistente de instalação (hermes setup) detecta automaticamente ~/.openclaw e oferece para migrar antes que a configuração comece.

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

hermes claw migrate              # Interactive migration (full preset)
hermes claw migrate --dry-run    # Preview what would be migrated
hermes claw migrate --preset user-data   # Migrate without secrets
hermes claw migrate --overwrite  # Overwrite existing conflicts

O que é importado:

  • SOUL.md — arquivo de persona
  • Memórias — entradas MEMORY.md e USER.md
  • Habilidades — habilidades criadas pelo usuário → ~/.hermes/skills/openclaw-imports/
  • Lista branca de comandos — padrões de aprovação
  • Configurações de mensagens — configurações da plataforma, usuários permitidos e diretório de trabalho
  • Chaves API — segredos na lista branca (Telegram, OpenRouter, OpenAI, Anthropic, ElevenLabs)
  • Ativos 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 migeração interativa guiada por agente com prévia em modo de teste.


Contribuindo

Bem-vindas 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 colaboradores — clone e execute com setup-hermes.sh:

git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent
./setup-hermes.sh     # installs uv, creates venv, installs .[all], symlinks ~/.local/bin/hermes
./hermes              # auto-detects the venv, no need to `source` first

Caminho manual (equivalente ao acima):

curl -LsSf https://astral.sh/uv/install.sh | sh
uv venv .venv --python 3.11
source .venv/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 targeting de janelas do compositor.
  • 🔌 HermesClaw — ponte WeChat da comunidade: Execute o Hermes Agent e o OpenClaw na mesma conta WeChat.

Licença

MIT — veja LICENSE.

Construído por Nous Research.

Ver o original no GitHub

Bom para

Relacionados