Blog
Prompt caching no Hermes: o TTL que decide quanto pagas
A v0.23.3 põe o prompt_caching.cache_ttl em auto por omissão, junta keep-alives que aquecem o cache durante pausas e tool runs longos, e compacta a conversa antes de o cache expirar. É a diferença entre reler a conversa a preço cheio ou não.
A tua subscrição do Nous Portal como endpoint OpenAI em qualquer app
O hermes proxy expõe a subscrição do Nous Portal ou da xAI como endpoint OpenAI-compatível, sem API key estática. Como ligar Open WebUI, Karakeep ou OpenViking, e o pitfall de segurança que quase ninguém vê.
Cron sem LLM: watchdogs que correm só um script e não gastam um token
O modo no-agent do cron do Hermes corre um script em cada tick e entrega o stdout no Telegram, Discord, Slack ou Signal. Sem chamada ao modelo, zero tokens por tick.
Fallback providers no Hermes: manter o agente de pé quando o modelo cai
Como funciona a cadeia de fallback entre fornecedores no Hermes, como se configura no config.yaml ou com hermes fallback, e o que o novo hermes fallback check valida antes de precisares dela.
Processos em segundo plano no Hermes: menos polling, menos custo
A v0.23.0 tornou o trabalho em segundo plano mais simples no Hermes: comandos com & no fim passam a correr sozinhos e a conclusão chega ao agente sem verificações repetidas.
hermes send: notificações sem gateway, sem LLM e sem colar tokens
O hermes send transforma qualquer script num notificador multiplataforma: reutiliza as credenciais do gateway, dispensa LLM e devolve exit codes a sério. Guia prático, com exemplos e pitfalls.
Visão no Hermes: colar imagens no terminal e escolher quem as vê
O Hermes já aceita imagens coladas no CLI, mas o interessante vem depois: encaminhamento entre modelos com e sem visão, limites de custo por embed e reenvio de imagens em turnos seguintes. Com SSH e SVG como armadilhas pelo meio.
Compactação preparada: o Hermes escreve o resumo antes de precisares dele
A v0.23.0 traz compression.prepare_ahead, que escreve o próximo resumo de compactação em segundo plano. A compactação deixa de pausar o turno à espera do resumo.
Hermes entrega ficheiros gerados como anexos no chat
O Deliverable Mode do Hermes permite entregar ficheiros gerados pelo agente como anexos na conversa. Como se pede e quais são os limites.
Custos e limites de gasto nas ferramentas MCP pagas
A v0.23.0 do Hermes permite declarar o preço de cada ferramenta MCP e pôr um orçamento por conversa, com pedido de aprovação antes de o ultrapassar.
Hermes Webapp: o Desktop inteiro do agente num browser
O Hermes Webapp é o Desktop completo do Hermes servido no browser a partir do próprio gateway. Uma aba chega para ter chat, Kanban e configuração.
`/rewind`: voltar atrás na conversa com o Hermes
O Hermes v0.23.0 traz o /rewind — um selector de prompts anteriores que te deixa editar e reenviar, ou fazer fork da conversa a partir de qualquer ponto, sem perder o histórico.
Vozes dinâmicas com ElevenLabs: o agente Hermes escolhe a voz certa
Com ElevenLabs, o Hermes pode pesquisar a Voice Library e escolher uma voz diferente para cada texto — ideal para personagens, narrações e tom variado sem sair do chat.
Group Chats: a sala onde os Bots deliberam (v0.22.7)
O Hermes ganhou salas de grupo no Bot Mode: dois a seis perfis partilham uma conversa, respondem em rondas de turnos e o gateway mantém tudo a correr mesmo com o Desktop fechado.
Hermes webapp: o Desktop inteiro numa aba do browser
O gateway serve o workspace do Desktop a um browser comum — sessões, ficheiros, Git e terminal rail, na mesma fila do CLI e das mensagens. Não é o Web Dashboard, e o link de sessão dura 60 segundos.
Remote Config: o config.yaml deixa de viver no disco
O Hermes passa a poder servir a config de cada perfil a partir de um plano central, com chaves travadas por nível e arranque que falha em vez de adivinhar. É para frotas, e inverte a regra que este blog sempre deu como certa.
Refresh-prompts: a sessão que já está a correr apanha os ficheiros novos
Editaste o SOUL.md, instalaste uma skill ou mudaste o AGENTS.md e a conversa continua a responder como antes. O refresh-prompts faz cada sessão a correr reconstruir o system prompt no turno seguinte, sem perder o histórico.
Cron no Hermes: o fuso do job e o slot que não se perde
O cron do Hermes ganhou duas afinações por job: --timezone prende a expressão ao relógio de uma zona IANA e --grace-minutes decide quanto tempo um slot perdido ainda é recuperado. Chegaram à linha main a 26 de outubro e entram na v0.23.0.
Slash commands de plugin: quando o comando te faz uma pergunta
Um plugin pode registar os seus próprios comandos de sessão com ctx.register_command, e desde a v0.22.5 esse comando pode pedir-te uma escolha com ctx.ask_choice. A assinatura, as superfícies, o problema do handler assíncrono e o padrão que o advanced-delegation já usa.
Migrar do OpenClaw para o Hermes: o import mudou de casa
O hermes import-agent leva a persona, as memórias, as skills, o modelo e os canais do OpenClaw para o perfil Hermes, mas desde a v0.22.5 vive no plugin oficial agent-importers. Como se instala, o que passa, a allowlist dos segredos e o que fica por arrumar.
bubblewrap: uma sandbox por comando, sem Docker
O backend bubblewrap corre cada comando de terminal e de execute_code na sua própria sandbox bwrap, na tua máquina: root read-only, working directory escrevível e sem imagem nem daemon.
Hermes como servidor MCP: o agente do outro lado do protocolo
O plugin mcp-serve expõe as conversas do Hermes como ferramentas MCP para o Claude Code, Cursor ou Codex — e com --tools empresta-lhes as ferramentas do agente.
Hooks: os quatro sistemas onde se pendura código no Hermes
Gateway hooks, plugin hooks, shell hooks e outbound webhooks: onde se declara cada um, onde corre e o que consegue bloquear. A tabela que resolve a confusão dos nomes parecidos.
/loop: o vigia da sessão, com hora marcada
O /loop re-executa um prompt numa cadência dentro da sessão em que estás, com intervalo fixo ou a ritmo próprio, e pára quando o trabalho acabar. A peça que faltava entre o /goal e o cron.
Rotas de delegação: o subagente certo, no modelo certo
delegation.backend no Hermes v0.22.5: model_map e profile_routes deixam o agente escolher, tarefa a tarefa, que modelo ou perfil corre o subagente.
hermes usage: ler as janelas de quota antes de bater na parede
O hermes usage mostra as janelas do provider sem abrir sessão, e o --json dá o mesmo a um script. Como ler os limites, o que fazer quando a janela fecha e porque é que o cron deve estacionar o job em vez de falhar de hora a hora.
Plugins no Hermes: instalar não é ativar (e atualizar não é git pull)
O hermes plugins junta catálogo revisto, pin por commit e atualização num só sítio. Mas um plugin instalado não carrega nada por si, e num install de catálogo o update nunca faz git pull. Os três estados, o que a atualização preserva e onde o modelo de confiança acaba.
Mixture of Agents: vários a aconselhar, um a agir (e a pagar)
O Hermes pode juntar vários modelos — uns aconselham, um age. O custo vai quase todo para o agregador. Como configurar, usar e não pagar o dobro.
Subagentes em direto: ver o que fazem e corrigir o rumo a meio
A v0.22.0 pôs os subagentes à vista acima da caixa de escrita: tarefas, tempo decorrido e atividade recente, com teclas para dar uma orientação nova ou parar só o trabalhador que se perdeu.
Local Models, o Hermes com llama.cpp na tua máquina
Desde a v0.22.0 o Hermes instala e gere o llama.cpp por ti, mede cada modelo contra a tua GPU e RAM e trata da memória sozinho. Sem conta, sem API key, e nada sai do computador depois do download.
Connectors: o Hermes trabalha dentro das apps que já usas
Desde a v0.22.0 o agente entra no Linear, Notion, Slack e companhia pelo tool gateway da Nous: pedes uma app, fazes login uma vez no browser e as ferramentas ficam prontas no mesmo turno. Dá para ligar várias contas da mesma app, gerir tudo em hermes connectors e começar sem conta Nous.
hermes pm — o gestor de pacotes unificado (que não atualiza o Hermes)
O hermes pm passou a gerir os binários e os ambientes Python do Hermes: versões fixadas, downloads verificados por hash e gerações que só entram em serviço depois de validadas. Não é o atualizador da aplicação, e há quatro comandos que vale a pena conhecer.
Context References: o @ que anexa ficheiros e diffs à mensagem
Escreves a referência dentro da mensagem — @file:, @diff, @url: — e o Hermes lê o ficheiro, o diff ou a página antes de a entregar ao agente, numa secção Attached Context. O que existe, os limites de tamanho e o que fica de fora por segurança.
Importar o setup do Claude Code (e do Codex CLI) com import-agent
O hermes import-agent leva o CLAUDE.md, as regras de permissões, os servidores MCP e as skills do Claude Code ou do Codex CLI para o Hermes, com pré-visualização antes de tocar no disco e um modo de sincronização que corre sozinho. O que passa, o que nunca passa e os pormenores que mordem.
Curator: a manutenção das skills que o agente escreve sozinho
O Hermes guarda uma skill sempre que resolve um problema novo e nada arruma essa biblioteca depois. O curator passa-lhe por cima em background, marca o que está parado como stale, arquiva o que já não usas e, se quiseres, funde sobreposições. Sem apagar nada.
Canais de atualização no Hermes: stable e main
O hermes update deixou de arrastar cada commit do main e passou a seguir releases publicadas. Como trocar de canal, o que acontece a quem já estava à frente da última release e os casos em que o canal vem fixo no pacote.
Heartbeat: uma instrução recorrente que vive dentro da conversa
O cron cria uma sessão nova a cada disparo; o /heartbeat faz o contrário. Deixa uma instrução recorrente dentro da conversa onde já estás, a disparar entre turnos, com o mesmo contexto e a mesma cache de prompt.
Transcrição em directo: o Hermes escreve enquanto falas
O streaming STT mostra a transcrição enquanto ditas na CLI, TUI e Desktop. Como activar, que providers o suportam e quando entra o fallback.
Git worktrees no Hermes: um checkout por agente
Dois agentes no mesmo repositório reescrevem os ficheiros um do outro. Com git worktrees, cada sessão do Hermes ganha o seu próprio branch e diretório de trabalho, seja com /worktree new a meio da sessão ou com a flag -w no arranque.
Kanban: o quadro de tarefas durável entre perfis do Hermes
O Kanban do Hermes é uma fila de trabalho em SQLite partilhada por todos os perfis: cada tarefa tem um assignee, um estado e dependências, e o dispatcher do gateway lança os workers. É o que o delegate_task não faz — trabalho que sobrevive a reinícios e passa de perfil em perfil.
Tool Search: o agente procura ferramentas em vez de as carregar todas
Com muitos servidores MCP ou plugins, os schemas das ferramentas ocupam uma fatia grande do contexto em cada turno. O Tool Search troca-as por três ferramentas-ponte e carrega cada schema só quando é preciso — com tiers, orçamento de listing e trade-offs que valem a pena conhecer.
Language Packs: o Hermes fala 17 línguas — e o português que traz é do Brasil
O Hermes traduz o texto estático da interface e essa lista é plugável: um plugin sem código Python, ou um único ficheiro YAML, põe o CLI, o TUI e o Desktop em português de Portugal. O catálogo pt que vem de fábrica é português do Brasil, e o alias pt-pt não o corrige.
Bot Screen: um desktop por bot, com o humano a poder assumir
Num host headless, cada bot ganha o seu próprio desktop Xfce transmitido para o Hermes Desktop: vês o que ele faz, assumes o teclado e o rato para resolver um login ou um CAPTCHA, e devolves-lhe o controlo.
Quem pode falar com o teu agente: allowlists, pairing e o decline nas DMs
Sem allowlists, o gateway do Hermes nega toda a gente. E para quem fica de fora há três respostas possíveis: um código de emparelhamento, silêncio, ou uma recusa educada que a v0.21.4 acrescentou.
state.db: o WAL, quem o segura e a recusa que salva as conversas
O Hermes guarda todas as conversas num único SQLite por perfil, com um log de escrita ao lado. Quando dois processos se atravessam, ele recusa escrever de propósito — e há uma correção de três passos.
LSP: o agente escreve código e ouve o language server
O Hermes corre pyright, rust-analyzer, tsserver e mais como language servers de fundo e só te mostra os erros que a edição introduziu. Lint de sintaxe e diagnósticos semânticos, em dois canais.
Passwords & Logins: o agente entra nos sites sem nunca ver a tua palavra-passe
O cofre de credenciais do Hermes guarda logins, cartões e moradas cifrados na máquina e injeta-os na página, sem o modelo ver um único segredo. Cartões, só depois de confirmares.
Checkpoints e /rollback: a rede de segurança antes de o agente mexer nos teus ficheiros
Antes de um write_file, de um patch ou de um rm destrutivo, o Hermes tira um snapshot do diretório de trabalho para um git-sombra. O /rollback repõe o estado sem tocar no teu repositório.
Webhooks: dar ao agente um endereço para o acordar de fora
O Hermes recebe eventos externos por HTTP: rotas com HMAC, filtros, debounce, entrega direta e disparo de cron jobs.
Bot Mode: no Hermes, um Bot é um perfil
O Bot Mode dá cara, nome e rotinas aos perfis do Hermes na app Desktop — mas por baixo não inventa nada: um Bot é um perfil, e o terminal vê exatamente o mesmo.
Parar um perfil sem parar o gateway: parking no multiplexer
Como tirar um perfil do ar (bots e cron) sem tocar no gateway anfitrião do Hermes, e como voltar a servi-lo.
/goal: objetivos persistentes no Hermes
Um objetivo que sobrevive entre turnos, um modelo juiz que decide se está cumprido e um orçamento de turnos para não andar às voltas. Como funciona o /goal do Hermes.
Skills sempre à mão: o skills.auto_load do Hermes
Pinà skills no arranque de todas as novas sessões do Hermes com uma linha no config.yaml — do CLI ao Telegram ao cron.
Slash commands: a referência dos comandos de chat do Hermes
Do /new ao /quit: o que cada slash command do Hermes faz, onde funciona (CLI, TUI, Telegram, Discord), as flags que valem a pena e os pormenores que a referência oficial não põe em relevo.
Stream-json: o progresso do Hermes em JSON linha a linha
O Hermes 0.21.4 estreia saída JSONL na linha de comandos: um evento JSON por linha, com ferramentas, tokens e exit codes, para scripts, CI e pipelines.
Bem-vindos ao Keryx: um blog sobre o agente Hermes
Arranca hoje o Keryx, um blog dedicado ao Hermes Agent. Um artigo por dia, uma funcionalidade de cada vez, sempre com exemplos práticos.