Hermes Agent
NousResearch/hermes-agent
Agent autoaprendizado com memória persistente e automações agendadas
Ver no GitHubAgent 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-agent1 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
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~/.hermescomo 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
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ção | CLI | Plataformas de mensagens |
|---|---|---|
| Iniciar chat | hermes | Execute 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 atual | Ctrl+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ção | O que é coberto |
|---|---|
| Quickstart | Instalação → configuração → primeira conversa em 2 minutos |
| Uso do CLI | Comandos, atalhos de teclado, personalidades e sessões |
| Configuração | Arquivo de configuração, provedores, modelos e todas as opções |
| Gateway de Mensagens | Telegram, Discord, Slack, WhatsApp, Signal, Home Assistant |
| Segurança | Aprovação de comandos, pareamento DM, isolamento de contêineres |
| Ferramentas e Conjuntos de Ferramentas | 40+ ferramentas, sistema de conjuntos de ferramentas e backends de terminal |
| Sistema de Habilidades | Memória procedural, Skills Hub, criação de habilidades |
| Memória | Memória persistente, perfis de usuário e melhores práticas |
| Integração MCP | Conecte qualquer servidor MCP para capacidades estendidas |
| Agendamento Cron | Tarefas agendadas com entrega de plataforma |
| Arquivos de Contexto | Contexto do projeto que molda cada conversa |
| Arquitetura | Estrutura do projeto, loop do agente e classes principais |
| Contribuindo | Configuração de desenvolvimento, processo de PR e estilo de código |
| Referência CLI | Todos os comandos e flags |
| Variáveis de Ambiente | Referê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.