hermes-memory-pgvector 1.0.2 já está disponível, com controlos mais rigorosos tanto no código como nos ficheiros que os utilizadores instalam a partir do PyPI. A suíte da base de dados em execução passa 789 testes sem qualquer teste ignorado. Todas as instruções executáveis do pacote de runtime estão cobertas, e ambos os arquivos publicados dispõem agora de proveniência verificável.
Esta versão surge na sequência do nosso artigo da versão 1.0, que introduziu a interface pública estável do projeto. A versão 1.0.2 mantém essa interface e o esquema da base de dados inalterados, ao mesmo tempo que torna mais rigoroso o processo de publicação das alterações.
Memória partilhada para agentes que cooperam
O plugin dá ao hermes-agent da Nous Research uma camada de armazenamento em PostgreSQL e pgvector. Os agentes continuam a utilizar a ferramenta de memória integrada. O provider espelha essas escritas e armazena passagens de conversa com conteúdo relevante para recuperação semântica.
A memória permanece restrita ao tema atual do agente, exceto se for explicitamente solicitada a recuperação entre temas. Os embeddings são processados sem um LLM no caminho crítico da memória, e as escritas são colocadas em fila para que o thread do agente não tenha de esperar por operações de embedding ou de base de dados.
Cobertura de testes com um mínimo imposto
Os novos testes cobrem operações de armazenamento e condições de corrida, isolamento de identidades, recuperação, manutenção pela linha de comandos, erros HTTP, encerramento do writer e falhas no limite da integração com o host.
Os resultados medidos são:
- 789 testes aprovados, com zero testes ignorados na suíte em execução.
- 100% de cobertura de instruções em todos os seis módulos de runtime.
- 99.66% de cobertura de branches, ou 99.92% de cobertura combinada de instruções e branches.
- Um limite mínimo de 99.5% de cobertura combinada imposto na CI em execução.
Dois resultados de branches continuam visíveis no relatório. Um exigiria um ciclo de tentativas com zero iterações, embora tente sempre pelo menos uma vez. O outro exigiria que o texto de delegação gerado fosse vazio ou ruído, embora inclua sempre um prefixo fixo de delegação. Não foi excluído código de runtime para aumentar a percentagem.
A cobertura regista os caminhos que os testes exercitaram; não prova que um programa não tenha bugs. Os testes precisam de asserções úteis e casos de falha realistas. A suíte é executada com PostgreSQL 16, 17 e 18, juntamente com testes unitários de Python 3.11, 3.12 e 3.13 e verificações de conformidade do upstream com versões fixadas.
Duas falhas ficam agora contidas no provider
Os testes revelaram dois pontos em que uma exceção podia escapar para o loop do agente: construir o repositório da base de dados durante a inicialização e agendar uma escrita de memória através do writer em segundo plano.
A versão 1.0.2 captura e regista ambas. Uma falha na construção do repositório deixa o provider indisponível; uma falha no enfileiramento degrada o hook de escrita. Nenhum dos caminhos acrescenta trabalho síncrono de embedding ou de base de dados ao thread do agente.
As regras do Ruff, os hooks de commit locais, as verificações de proteção do ramo principal e as verificações de versão e configuração impõem agora as mesmas exigências antes da publicação das alterações.
Rastreie o pacote que instala
Tanto o wheel como o arquivo de origem no PyPI têm atestados de publicação criados através do Trusted Publishing. O GitHub também regista a proveniência da compilação de ambos os ficheiros. O fluxo de publicação da versão verifica o conteúdo dos arquivos em relação à cópia de trabalho do código-fonte antes de os carregar.
Verificámos ambos os atestados do PyPI em relação ao repositório e confirmámos que os ficheiros do PyPI têm os mesmos hashes que os ficheiros anexos à versão no GitHub.
A proveniência permite ao leitor verificar de onde veio um ficheiro. Complementa a revisão de código e os testes; não certifica que o código esteja correto.
Atualize para 1.0.2
No ambiente Python que executa o seu agente:
python -m pip install --upgrade hermes-memory-pgvector==1.0.2
Reinicie os processos Hermes que carregam o provider e, em seguida, execute hermes memory status. Não há novas migrações nem alterações de esquema entre 1.0.1 e 1.0.2. Para uma instalação nova ou uma implantação mais antiga, siga as instruções de instalação e atualização do repositório.
- Versão no PyPI e proveniência dos ficheiros
- Versão no GitHub
- Código-fonte e instruções de instalação
- Registo de alterações
O projeto é de código aberto sob a licença BSD-3-Clause; os direitos de autor pertencem à Green Yoga Inc.
