nousresearch/hermes-agentO agente que cresce com você
<p align="center">
<img src="https://assets.kitploit.com/production/public/readmes/7225/75e85ef6fecf5a6227985f2082e5b35331fceff4d8db03720c82a7d9ee8b7eea.png" alt="Hermes Agent" width="100%">
</p>
# Hermes Agent ☤
<p align="center">
<a href="https://hermes-agent.nousresearch.com/">Hermes Agent</a> | <a href="https://hermes-agent.nousresearch.com/">Hermes Desktop</a>
</p>
<p align="center">
<a href="https://hermes-agent.nousresearch.com/docs/"><img src="https://img.shields.io/badge/Docs-hermes--agent.nousresearch.com-FFD700?style=for-the-badge" alt="Documentação"></a>
<a href="https://discord.gg/NousResearch"><img src="https://img.shields.io/badge/Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Discord"></a>
<a href="https://github.com/NousResearch/hermes-agent/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-green?style=for-the-badge" alt="Licença: MIT"></a>
<a href="https://nousresearch.com"><img src="https://img.shields.io/badge/Built%20by-Nous%20Research-blueviolet?style=for-the-badge" alt="Criado por Nous Research"></a>
<a href="https://github.com/nousresearch/hermes-agent/blob/main/README.zh-CN.md"><img src="https://img.shields.io/badge/Lang-%E4%B8%AD%E6%96%87-red?style=for-the-badge" alt="中文"></a>
<a href="https://github.com/nousresearch/hermes-agent/blob/main/README.ur-pk.md"><img src="https://img.shields.io/badge/Lang-%D8%A7%D8%B1%D8%AF%D9%88-green?style=for-the-badge" alt="اردو"></a>
<a href="https://github.com/nousresearch/hermes-agent/blob/main/README.es.md"><img src="https://img.shields.io/badge/Lang-Espa%C3%B1ol-orange?style=for-the-badge" alt="Español"></a>
</p>
**O agente de IA autoaperfeiçoável criado pela [Nous Research](https://nousresearch.com).** É o único agente com um ciclo de aprendizado integrado — ele cria habilidades a partir da experiência, aprimora-as durante o uso, incentiva a si mesmo a persistir conhecimento, busca em suas próprias conversas passadas e constrói um modelo cada vez mais profundo de quem você é ao longo das sessões. Execute-o em um VPS de US$ 5, em um cluster de GPUs ou em 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](https://portal.nousresearch.com), OpenRouter, OpenAI, seu próprio endpoint e [muitos outros](https://hermes-agent.nousresearch.com/docs/integrations/providers). Troque com `hermes model` — sem alterações de código, sem aprisionamento tecnológico.
<table>
<tr><td><b>Uma interface de terminal de verdade</b></td><td>TUI completa com edição multilinha, autocompletar de comandos com barra, histórico de conversas, interromper-e-redirecionar e saída de ferramentas em streaming.</td></tr>
<tr><td><b>Vive onde você vive</b></td><td>Telegram, Discord, Slack, WhatsApp, Signal e CLI — tudo a partir de um único processo de gateway. Transcrição de memorandos de voz, continuidade de conversas entre plataformas.</td></tr>
<tr><td><b>Um ciclo de aprendizado fechado</b></td><td>Memória curada pelo agente com incentivos periódicos. Criação autônoma de habilidades após tarefas complexas. As habilidades se autoaperfeiçoam durante o uso. Busca de sessões com FTS5 com sumarização por LLM para recordação entre sessões. Modelagem dialética de usuário com <a href="https://github.com/plastic-labs/honcho">Honcho</a>. Compatível com o padrão aberto <a href="https://agentskills.io">agentskills.io</a>.</td></tr>
<tr><td><b>Automações agendadas</b></td><td>Agendador cron integrado com entrega em qualquer plataforma. Relatórios diários, backups noturnos, auditorias semanais — tudo em linguagem natural, executando sem supervisão.</td></tr>
<tr><td><b>Delega e paraleliza</b></td><td>Gere subagentes isolados para fluxos de trabalho paralelos. No Desktop, escolha o provedor, o modelo e os limites deles em Configurações → Modelo → Subagentes e depois Aplique a rota completa. Escreva scripts Python que chamam ferramentas via RPC, reduzindo pipelines de várias etapas a turnos com custo de contexto zero.</td></tr>
<tr><td><b>Executa em qualquer lugar, não só no seu laptop</b></td><td>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.</td></tr>
<tr><td><b>Pronto para pesquisa</b></td><td>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.</td></tr>
</table>
---
## Instalação Rápida
### Linux, macOS, WSL2
```bash
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 o WSL2, o comando único para Linux/macOS acima também funciona lá. Encontrou um bug? Por favor, [abra uma issue](https://github.com/NousResearch/hermes-agent/issues).
Execute isto no PowerShell:
```powershell
iex (irm https://hermes-agent.nousresearch.com/install.ps1)
```
O instalador de origem delega Python 3.14, Node.js, npm, ripgrep, FFmpeg e dependências Python ao PM. Se o Git estiver ausente, ele prepara o arquivo verificado do Git para Windows no armazenamento de ferramentas do Hermes. Ele não substitui o seu Git do sistema. Consulte [métodos de instalação](https://hermes-agent.nousresearch.com/docs/getting-started/installation) para o pacote separado MSIX/App Installer e sua propriedade de atualização.
> **Android / Termux:** Um repositório APT assinado está disponível para dispositivos aarch64, com um canal `stable` (versões com tag) e um canal de pré-lançamento `canary`. O pacote inclui Python, Node.js e a TUI. Use o [guia do Termux](https://hermes-agent.nousresearch.com/docs/getting-started/termux), não o script de instalação para desktop/servidor.
>
> **Windows:** O Windows nativo é totalmente suportado — o one-liner do PowerShell acima instala tudo. Se preferir usar o WSL2, o comando Linux também funciona lá. A instalação nativa do Windows fica em `%LOCALAPPDATA%\hermes`; a instalação via WSL2 fica em `~/.hermes` como no Linux.
Após a instalação:
```bash
source ~/.bashrc # reload shell (or: source ~/.zshrc)
hermes # start chatting!
```
### Solução de problemas
#### Windows Defender ou antivírus sinaliza `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`), trata-se de 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 costumam sinalizar binários Rust não assinados que baixam e instalam pacotes.
**Para verificar se a sua cópia é autêntica:**
```powershell
# Install GitHub CLI if needed
winget install --id GitHub.cli
# Login to GitHub
gh auth login
# Run verification
$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 na lista de permissões a **pasta**, não o hash do arquivo — o Hermes atualiza o `uv` e o hash muda a cada versão
Para mais contexto, consulte os relatórios upstream da Astral: [astral-sh/uv#13553](https://github.com/astral-sh/uv/issues/13553), [astral-sh/uv#15011](https://github.com/astral-sh/uv/issues/15011), [astral-sh/uv#10079](https://github.com/astral-sh/uv/issues/10079).
---
## Primeiros Passos
```bash
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 config get # Print 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 →](https://hermes-agent.nousresearch.com/docs/)**
---
## Evite a coleta de chaves de API — Nous Portal
O Hermes funciona com qualquer provedor que você quiser — isso não vai mudar. Mas se você preferir não coletar cinco chaves de API separadas para o modelo, pesquisa na web, geração de imagens, TTS e um navegador na nuvem, o **[Nous Portal](https://portal.nousresearch.com)** cobre todos eles com uma única assinatura:
- **Mais de 300 modelos** — escolha qualquer um deles com `/model <name>`
- **Tool Gateway** — pesquisa na web, geração de imagens (FAL), conversão de texto em fala (OpenAI), navegador na nuvem (Browser Use), tudo roteado pela sua assinatura. Sem contas extras.
Um comando a partir de uma instalação nova:
```bash
hermes setup --portal
```
Isso faz login via OAuth, define Nous como seu provedor e ativa o Tool Gateway. Verifique o que está configurado a qualquer momento com `hermes portal info`. Detalhes completos na [página de documentação do Tool Gateway](https://hermes-agent.nousresearch.com/docs/user-guide/features/tool-gateway).
Você ainda pode usar suas próprias chaves por ferramenta sempre que quiser — o gateway é por backend, não é tudo ou nada.
---
## Referência Rápida: CLI vs Mensageria
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 de barra são compartilhados entre as duas interfaces.
| Ação | CLI | Plataformas de mensageria |
| ------------------------------ | --------------------------------------------- | -------------------------------------------------------------------------------- |
| Iniciar conversa | `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 uma personalidade | `/personality [name]` | `/personality [name]` |
| Repetir ou desfazer o último turno | `/retry`, `/undo` | `/retry`, `/undo` |
| Comprimir contexto / verificar uso | `/compress`, `/usage`, `/insights [--days N]` | `/compress`, `/usage`, `/insights [days]` |
| Navegar pelas skills | `/skills` ou `/<skill-name>` | `/<skill-name>` |
| 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, consulte o [guia da CLI](https://hermes-agent.nousresearch.com/docs/user-guide/cli) e o [guia do Messaging Gateway](https://hermes-agent.nousresearch.com/docs/user-guide/messaging).
---
## Documentação
Toda a documentação está em **[hermes-agent.nousresearch.com/docs](https://hermes-agent.nousresearch.com/docs/)**:
| Seção | O que é abordado |
| --------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
| [Quickstart](https://hermes-agent.nousresearch.com/docs/getting-started/quickstart) | Instalação → configuração → primeira conversa em 2 minutos |
| [CLI Usage](https://hermes-agent.nousresearch.com/docs/user-guide/cli) | Comandos, atalhos de teclado, personalidades, sessões |
| [Configuration](https://hermes-agent.nousresearch.com/docs/user-guide/configuration) | Arquivo de configuração, provedores, modelos, todas as opções |
| [Messaging Gateway](https://hermes-agent.nousresearch.com/docs/user-guide/messaging) | Telegram, Discord, Slack, WhatsApp, Signal, Home Assistant |
| [Security](https://hermes-agent.nousresearch.com/docs/user-guide/security) | Aprovação de comandos, emparelhamento de DM, isolamento de contêiner |
| [Tools & Toolsets](https://hermes-agent.nousresearch.com/docs/user-guide/features/tools) | Mais de 40 ferramentas, sistema de toolsets, backends de terminal |
| [Skills System](https://hermes-agent.nousresearch.com/docs/user-guide/features/skills) | Memória procedural, Skills Hub, criação de skills |
| [Memory](https://hermes-agent.nousresearch.com/docs/user-guide/features/memory) | Memória persistente, perfis de usuário, boas práticas |
| [MCP Integration](https://hermes-agent.nousresearch.com/docs/user-guide/features/mcp) | Conecte qualquer servidor MCP para capacidades estendidas |
| [Cron Scheduling](https://hermes-agent.nousresearch.com/docs/user-guide/features/cron) | Tarefas agendadas com entrega por plataforma |
| [Context Files](https://hermes-agent.nousresearch.com/docs/user-guide/features/context-files) | Contexto do projeto que molda cada conversa |
| [Architecture](https://hermes-agent.nousresearch.com/docs/developer-guide/architecture) | Estrutura do projeto, loop do agente, classes principais |
| [Contributing](https://hermes-agent.nousresearch.com/docs/developer-guide/contributing) | Configuração de desenvolvimento, processo de PR, estilo de código |
| [CLI Reference](https://hermes-agent.nousresearch.com/docs/reference/cli-commands) | Todos os comandos e flags |
| [Environment Variables](https://hermes-agent.nousresearch.com/docs/reference/environment-variables) | Referência completa de variáveis de ambiente |
---
## Migrando do OpenClaw
Se você vem do OpenClaw, o Hermes pode importar automaticamente suas configurações, memórias, skills e chaves de API.
**Durante a configuração inicial:** 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:**
```bash
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 de MEMORY.md e USER.md
- **Skills** — skills 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)
- **Recursos de TTS** — arquivos de áudio do workspace
- **Instruções do workspace** — AGENTS.md (com `--workspace-target`)
Consulte `hermes claw migrate --help` para todas as opções, ou use a skill `openclaw-migration` para uma migração interativa guiada por agente com pré-visualizações de simulação.
---
## Contribuindo
Aceitamos contribuições! Consulte o [Guia de Contribuição](https://hermes-agent.nousresearch.com/docs/developer-guide/contributing) para configuração de desenvolvimento, estilo de código e processo de PR.
Comece pelo [fluxo de trabalho do desenvolvedor PM](https://github.com/nousresearch/hermes-agent/blob/main/website/docs/reference/package-management.md#developer-workflow)
para ativação, uso diário, alterações de dependências e saída do ambiente.
A [Configuração de Desenvolvimento](https://github.com/nousresearch/hermes-agent/blob/main/CONTRIBUTING.md#development-setup) cobre o ambiente de teste separado e os comandos de verificação.
---
## Comunidade
- 💬 [Discord](https://discord.gg/NousResearch)
- 📚 [Skills Hub](https://agentskills.io)
- 🐛 [Issues](https://github.com/NousResearch/hermes-agent/issues)
- 🔌 [computer-use-linux](https://github.com/avifenesh/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](https://github.com/AaronWong1999/hermesclaw) — Ponte comunitária para WeChat: execute o Hermes Agent e o OpenClaw na mesma conta do WeChat.
---
## Licença
MIT — consulte [LICENSE](https://github.com/nousresearch/hermes-agent/blob/main/LICENSE).
Criado por [Nous Research](https://nousresearch.com).