Pi vs Hermes: uma sessão de programação contra um agente residente

Pi versus Hermes é uma comparação entre duas categorias diferentes de software, não entre duas CLIs de programação rivais. Pi é um harness interativo de programação no terminal que você inicia dentro de um diretório de projeto; Hermes Agent é um agente pessoal residente com arquivos de memória integrados, um agendador cron e canais de mensagens. Ambos são licenciados sob MIT, ambos custam $0 para instalar e ambos aceitam um endpoint de modelo de terceiros por meio de uma configuração documentada. A escolha real é entre uma sessão e uma residência — e, para muitas pessoas, a resposta é ambos.

Corrija os nomes primeiro, porque esta consulta gera muita confusão dos dois lados. Pi aqui é o agente de programação publicado em pi.dev pela Earendil Inc., repositório earendil-works/pi. Não é o Pi da Inflection AI em pi.ai, nem Raspberry Pi, nem Oh My Pi, um agente de programação separado de outro autor. Hermes aqui é NousResearch/hermes-agent. A própria página inicial da Nous Research lista Hermes 4 e Hermes Agent como dois produtos separados em dois domínios separados — Hermes 4 é a família de modelos de pesos abertos com preços de inferência por token; Hermes Agent é software gratuito. Nenhum valor do Hermes 4 aparece em qualquer parte desta página, porque o preço de um modelo não é o preço de um agente.

Qual escolher

O custo de migração é assimétrico e vale a pena calculá-lo antes de se comprometer. Migrar para o Pi é npm install -g @earendil-works/pi-coding-agent e um arquivo de configuração. Migrar para o Hermes Agent é executar um script de instalação que, de acordo com sua página de instalação, cuida de Python, Node.js, ripgrep e ffmpeg, do clone do repositório, de um ambiente virtual, do comando global hermes e da configuração do provedor — além de, se você quiser o aplicativo para desktop, uma verificação de plataforma: o instalador para macOS é documentado como exclusivo para Apple Silicon, com um instalador separado para Windows nativo, e a documentação lista o macOS em Intel como plataforma não compatível. Nenhuma versão mínima do macOS é publicada nessa página.

Uma armadilha de nomenclatura se aplica apenas ao Pi e altera silenciosamente o que você instala. O repositório mudou: uma solicitação para badlogic/pi-mono agora é resolvida para earendil-works/pi por meio do redirecionamento do próprio GitHub, e o pacote npm antigo @mariozechner/pi-coding-agent parou na versão 0.73.1 em 7 de maio de 2026 e traz um aviso de descontinuação apontando para o pacote da Earendil. Qualquer tutorial ou comparação escrito com os nomes antigos descreve software quatro meses desatualizado. Hermes Agent tem o problema oposto — dois números de versão para uma única versão, tratados abaixo.

Sessão versus residência, recurso por recurso

Lido nos dois repositórios e nos dois sites de documentação em 21 de setembro de 2026. Duas interpretações devem ser evitadas. As linhas "sem memória" e "sem mensagens" são ausências no índice oficial de documentação do Pi, não negativas do fornecedor — extensões de terceiros fornecem ambos. E as contagens de estrelas e issues nesses dois repositórios não são comparáveis: o README do Pi diz que novos issues e pull requests de novos colaboradores são fechados automaticamente por padrão, portanto os dois projetos estão medindo políticas diferentes, não qualidades de manutenção diferentes. A Nous Research também descreve Hermes Agent como o único agente com um loop de aprendizado integrado; esse é o texto do próprio README do fornecedor, e nenhum benchmark direto contra Pi foi encontrado de nenhuma das partes.

pi-hermes-memory é uma extensão do Pi, não o Hermes Agent

Esta é a confusão que a página existe para esclarecer. Pesquisar "pi hermes" exibe um pacote npm chamado pi-hermes-memory, e o nome parece indicar uma ponte entre os dois produtos. Não é isso.

O pacote é publicado por chandra447 — não pela Nous Research, nem pela Earendil — sob a licença MIT, na versão 0.9.9 publicada em 13 de setembro de 2026. A própria descrição no npm termina com as palavras "Ported from Hermes agent". O que ele faz é reimplementar uma camada de memória dentro do Pi: memória persistente, pesquisa de sessões com SQLite FTS5, varredura de segredos e skills procedurais. Instalá-lo com pi install npm:pi-hermes-memory dá ao Pi algo semelhante ao design de memória do Hermes. Nada em sua entrada no npm ou em sua listagem no catálogo descreve a instalação do Hermes Agent, a conexão a um Hermes Agent em execução ou a incorporação do gateway, canais, agendador ou sistema de aprovação do Hermes — o que é descrito é uma camada de memória para o Pi.

Três limitações práticas, segundo sua própria listagem do catálogo consultada em 21 de setembro de 2026. Cada ciclo de revisão em segundo plano custa uma chamada completa à API de LLM por meio de um processo filho pi -p, o que representa uma cobrança recorrente de tokens, não uma conveniência gratuita. O histórico da sessão não pode ser pesquisado até ser indexado — a listagem oferece um comando /memory-index-sessions em massa ou a indexação automática no encerramento da sessão, portanto transcrições antigas precisam da importação única antes que a pesquisa possa alcançá-las. E seu tokenizador de trigramas limita a pesquisa de substrings CJK a consultas de três caracteres ou mais. A listagem mostrava aproximadamente 27.000 downloads por mês naquela consulta; essas contagens são dinâmicas e terão mudado. A própria documentação do Pi não recomenda nenhum pacote de memória, e nenhuma insígnia de análise, verificação ou endosso apareceu nas listagens do catálogo consultadas naquele dia — portanto, esta é uma opção popular da comunidade, não uma opção oficial.

Permissões são a diferença mais importante

Se você comparar apenas uma coisa, compare isto. O README do Pi afirma claramente que ele não inclui um sistema integrado de permissões para acesso ao sistema de arquivos, processos, rede ou credenciais e que, por padrão, é executado com as permissões do usuário e do processo que o iniciou. Sua página de segurança, reescrita na atualização da documentação do Pi de 22 de setembro de 2026, acrescenta que Pi "pode ler, alterar e executar arquivos com as permissões da conta que o iniciou, e não solicita aprovação antes de cada chamada de ferramenta", e lista a "ausência de um sandbox integrado" entre os comportamentos geralmente fora de seu limite de segurança. O único controle de confiança, defaultProjectTrust, determina se configurações e extensões locais do projeto são carregadas — não se uma ferramenta é executada. A página de conteinerização do Pi documenta quatro padrões de isolamento que você mesmo fornece — uma extensão Gondolin que encaminha ferramentas integradas para uma microVM local, Docker simples, o OpenShell controlado por políticas e Docker Sandboxes. Até a atualização, a página de segurança também explicava a decisão de design: um sandbox parcial no processo seria fácil de interpretar equivocadamente como um limite de segurança, embora ainda dependesse do shell do host, do sistema de arquivos, dos gerenciadores de pacotes, das credenciais e do código das extensões. A página atualizada remove essa justificativa e diz, em vez disso, que "A segurança vem da limitação dos arquivos, credenciais, processos e serviços de rede que o Pi pode acessar e afetar se uma ação gerada estiver errada ou for maliciosa", enquanto a política de segurança do repositório ainda diz que o agente de programação "intencionalmente não possui um sandbox". As extensões, vale observar, são executadas com todas as permissões do seu sistema.

Hermes Agent adota a posição oposta. Sua página de segurança documenta um prompt para comandos perigosos que oferece uma vez, sessão, sempre ou negar; escolher sempre grava o padrão em command_allowlist em ~/.hermes/config.yaml. approvals.mode aceita smart, o padrão, que usa uma LLM auxiliar para avaliar o risco e encaminha casos incertos; manual, que sempre solicita confirmação; e off, que desativa as verificações. Uma lista separada de negação de gravação de arquivos é aplicada antes da execução a diretórios de credenciais como ~/.ssh/, ~/.aws/ e ~/.kube/ e a armazenamentos de segredos incluindo .env, com ~/.ssh/config sujeito a aprovação, em vez de ser bloqueado de forma rígida, e um HERMES_WRITE_SAFE_ROOT opcional que confina as gravações a um único prefixo. A condição que deve ser preservada: essa mesma página diz que as verificações de comandos perigosos são ignoradas nos backends docker, singularity, modal, daytona e vercel_sandbox, porque o contêiner é tratado como o limite. "Hermes pergunta primeiro" é verdade em local e ssh, mas não é uma propriedade de toda configuração.

Apontando qualquer um dos dois para o mesmo endpoint

Um fato operacional vale mais do que o restante desta tabela, e é por isso que uma única chave de gateway não significa uma única configuração. Nenhum dos dois produtos documenta uma URL base definida para o protocolo Anthropic. Até a atualização da documentação em 22 de setembro de 2026, a documentação de modelos do Pi mostrava ambas as formas em seus exemplos de anthropic-messages — uma https://proxy.example.com somente com a origem em um lugar e https://proxy.example.com/v1 em outros — e a atualização removeu ambas sem resolver a questão, uma lacuna que o preço do Pi já observa. No Kunavo, a origem é a forma que funciona: clientes no estilo Anthropic acrescentam /v1/messages por conta própria, portanto um sufixo /v1 produz um caminho duplicado e um 404. Do lado do Hermes, o guia de API personalizada do Hermes marca a URL base anthropic_messages como não verificada e orienta você a tentar ambas as formas; nada encontrado hoje a resolve, portanto essa ressalva permanece, em vez de ser silenciosamente transformada em certeza aqui. O caminho compatível com OpenAI é o mais simples dos dois lados. A documentação da URL base aborda essa armadilha em detalhes.

Mais um limite, porque é a única barreira de plano encontrada em qualquer dos lados. A página do Tool Gateway afirma que o Tool Gateway é um recurso de assinatura paga, e a página de preços do Nous Portal mostra o plano Free sem uso de ferramentas hospedadas. Essa barreira abrange a camada de ferramentas hospedadas — pesquisa e extração na web, geração de imagens, saída de voz e automação de navegador na nuvem — e não o agente, o sistema de memória, os canais, o agendador, o sistema de aprovação ou a capacidade de apontar o Hermes para seu próprio endpoint. O Kunavo não oferece nenhum modelo de conversão de texto em fala, conversão de fala em texto ou embeddings, portanto essas categorias do gateway não têm equivalente algum no Kunavo; a alternativa documentada é por ferramenta, definindo web.backend, image_gen.provider, tts.provider ou browser.cloud_provider para sua própria conta de fornecedor. A mesma página também afirma que algumas contas recebem uma pequena cota de ferramentas gerenciadas sem assinatura paga, sem publicar tamanho ou critérios de elegibilidade — é algo real, mas não um plano gratuito. Nenhuma barreira equivalente foi encontrada no lado do Pi: o pi.dev não publicou nenhum preço ou plano pago de qualquer tipo quando consultado em 21 de setembro de 2026.

Duas informações do Nous Portal divergem entre páginas oficiais, e este guia não as unificará: a página de preços do portal anuncia "200+ Models" em cada plano pago, enquanto a página da documentação do Hermes sobre o Nous Portal afirma que os créditos cobrem mais de 300 modelos de fronteira. Os planos publicados em 21 de setembro de 2026 eram Free a $0, Plus a $20 por mês com $22 em créditos mensais, Super a $100 com $110 e Ultra a $200 com $220, cada um descrito como oferecendo um bônus de créditos de 10 por cento com limite de rollover. Esses créditos são saldo da loja para inferência, não um desconto sobre as tarifas de tabela.

Quanto custa o mesmo trabalho em cada um

Ambos os clientes custam $0, portanto a comparação trata do que cada um acrescenta à fatura de tokens. Estas são estimativas ilustrativas de tokens, não custos medidos de tarefas nem um teto de cobrança. Suponha uma alteração delimitada em um repositório, enviando 400.000 tokens de entrada não armazenados em cache e recebendo 25.000 tokens de saída, sem leituras de cache, gravações de cache, imagens ou cobranças de ferramentas externas. As tarifas são os preços atuais do catálogo do Kunavo por milhão de tokens.

Essa coluna é idêntica por design: o mesmo modelo fazendo o mesmo trabalho gera a mesma cobrança de qualquer forma. A diferença estrutural é a linha de memória, e ela segue em direções opostas. A documentação de memória do Hermes descreve o conteúdo da memória como sendo inserido no prompt do sistema no início da sessão, sem uma chamada de LLM para recuperá-lo, e informa os limites dos dois arquivos como aproximadamente 800 e 500 tokens. O Pi não tem equivalente integrado, e a extensão que adiciona um cobra uma chamada completa de LLM por ciclo de revisão. Suponha 20 sessões em um mês para a inserção e 30 ciclos de revisão com 12.000 tokens de entrada e 600 de saída cada para a extensão — o formato do ciclo é uma suposição para ilustração, não uma medição.

Nenhum dos dois números é grande, e esse é o ponto: a memória não é onde está o dinheiro em nenhum dos lados, então escolha pelo comportamento, não por esta linha. Dois custos ficam completamente fora da aritmética. O Hermes Agent foi projetado para rodar no seu laptop — o README sugere uma VPS barata ou hospedagem serverless — portanto pode surgir uma cobrança de hospedagem que o Pi nunca cria. E, se você entrar no Pi com uma assinatura do Claude, a documentação do próprio provedor do Pi afirmava, até a atualização da documentação em 22 de setembro de 2026 remover a frase, que o uso por um harness de terceiros consome uso adicional e é cobrado por token, em vez de usar os limites do plano Claude; o aviso exibido pelo Pi quando um modelo da Anthropic é executado com autenticação de assinatura ainda diz isso, em seu código-fonte na v0.99.2. Essa é a caracterização do Pi sobre a cobrança de outro fornecedor, portanto confirme-a na sua própria conta.

No lado do Kunavo, o valor do catálogo é um piso de cobrança, não um teto: quando o upstream informa sua cobrança, a fatura é o maior valor entre o custo do catálogo e o custo do upstream multiplicado pela margem aplicável. O mínimo é um aporte pré-pago de $10, que é o dinheiro necessário para financiar uma chave, não uma taxa de tarefa ou uma assinatura — consulte faturamento. A tarifa mais barata listada e a tarefa concluída mais barata são questões distintas; um modelo menor que precise de três tentativas pode custar mais do que um que conclua a alteração de uma vez.

Executando ambos e quando migrar

Esses dois não precisam ser uma escolha entre um ou outro, e as árvores de configuração deixam isso claro: o Pi lê ~/.pi/agent/, o Hermes Agent lê ~/.hermes/, e nenhum dos dois documenta estado compartilhado. O Hermes também isola por perfil — hermes -p work lê seu próprio diretório de memórias — portanto um ambiente de trabalho e um pessoal não precisam compartilhar contexto.

Migre para o Hermes Agent quando o que você continua querendo é algo autônomo: trabalho agendado, uma resposta de um aplicativo de mensagens ou um agente que se lembre de uma decisão explicada na semana passada sem que você precise colá-la novamente. Migre para o Pi quando o trabalho for código supervisionado em um repositório e o processo contínuo for uma sobrecarga que você não quer operar. Adicione a extensão de memória do Pi somente depois de calcular o custo de seus ciclos de revisão, e nunca presumindo que ela transforma o Pi no Hermes Agent. E, se o motivo da mudança for realmente o acesso a modelos, e não o fluxo de trabalho, nenhuma migração é necessária: ambos os produtos alcançam o mesmo endpoint por meio de configuração documentada.

Independentemente de qual você testar, trate toda configuração nesta página como lida na documentação do fornecedor, não como comprovada. Mantenha uma rota funcional disponível, execute uma tarefa delimitada e depois reconcilie a leitura de custos do próprio agente com a cobrança efetivamente registrada pela sua conta do provedor — a aritmética de um agente sobre tokens informados é uma estimativa, não um livro-caixa. Para os detalhes no nível do protocolo, API compatível com OpenAI explica o que a superfície compatível inclui; preços do Hermes Agent e preços do Pi apresentam o quadro completo de cobrança de cada produto. Quando estiver pronto para financiar uma chave para qualquer um deles, crie uma conta no Kunavo.

Perguntas frequentes

Verificado em 21 de setembro de 2026: a API do GitHub para os dois repositórios, o README bruto do Pi, os documentos de sessões, provedores e conteinerização, o pi.dev e sua documentação de modelos e catálogo de pacotes, as entradas do registro npm para os dois pacotes do Pi e para pi-hermes-memory, as páginas de instalação, início rápido, suporte a plataformas, memória, mensagens, segurança, configuração de modelos, perfis, Nous Portal e Tool Gateway em hermes-agent.nousresearch.com, além de portal.nousresearch.com e nousresearch.com. A documentação de modelos do Pi foi relida em 1º de outubro de 2026 para sua lista de api e exemplos de base-URL anthropic-messages, ambos removidos pela atualização da documentação em 22 de setembro de 2026. No mesmo dia, o README, a página de segurança e a política de segurança do repositório do Pi foram relidos para as afirmações sobre permissões e sandbox; sua referência RPC e o código-fonte na v0.99.2 foram relidos para as unidades e faixas de custo e os valores de api, além da linha de uso adicional em comparação com o aviso do terminal nesse código-fonte. Contagens de estrelas, contadores de downloads e totais de pacotes e plataformas são instantâneos de um único dia e variam. As tarifas do Kunavo são exibidas a partir do catálogo atual, e todo valor em dólar aqui é uma aritmética ilustrativa de tokens, não um custo medido de tarefa. Nem o Pi nem o Hermes Agent foram testados em tempo de execução contra o Kunavo neste trabalho, e nenhuma afirmação de compatibilidade é feita para qualquer um deles.