Repolode
Enviar
caspianmoon

caspianmoon/memoripy

Runtime local de memória para agentes de IA, com foco em evidências: filtra gravações, acompanha mudanças nos fatos ao longo do tempo e explica cada resultado recuperado.

Alternativa open source a:Mem0

Ver no GitHub
Estrelas
692
Forks
57
Issues abertas
3
Último commit
há 3 meses

O que é?

Memoripy é uma camada local de memória para agentes de IA. Em vez de armazenar tudo o que um agente vê, aplica uma política de admissão antes de gravar, rejeitando ou colocando em quarentena ruído, possíveis segredos e instruções inseridas em conteúdo não confiável. Os registros são bitemporais e versionados, então um fato alterado, como um novo endereço, substitui o anterior, enquanto as evidências históricas continuam disponíveis para consulta.

A recuperação combina várias estratégias independentes, incluindo correspondência lexical BM25, similaridade semântica, sobreposição de entidades e correspondência temporal, usando fusão por reciprocidade de posições (reciprocal-rank fusion). Cada resultado inclui um recibo que mostra quais estratégias o encontraram, sua posição em cada uma e seu escopo, além de citações que apontam para o material de origem. As memórias podem ser delimitadas por usuário, agente, execução, projeto, organização e namespace.

O projeto inclui uma CLI para auditar um repositório existente em busca de duplicatas, conflitos, evidências ausentes e ciclos de feedback, além de um executor de contratos de memória, um serviço HTTP opcional, um servidor MCP e um gateway multi-tenant auto-hospedado com uma interface de inspeção. O núcleo não exige dependências de terceiros, e provedores de LLM ou de embeddings são opcionais.

Recursos principais

  • 01A política de admissão rejeita, adia ou coloca em quarentena gravações automáticas antes que cheguem ao armazenamento persistente.
  • 02O histórico de versões bitemporal e imutável permite consultar fatos atuais e históricos separadamente.
  • 03A recuperação combina várias estratégias e anexa um recibo e citações a cada resultado.
  • 04Isolamento de escopo por usuário, agente, execução, projeto, organização e namespace.
  • 05Comandos de auditoria, inspeção, avaliação e recuperação na CLI para manter um repositório de memórias.
  • 06Servidor MCP oficial e serviço HTTP com autenticação por bearer token.

Casos de uso

  • Dar a um agente pessoal ou voltado para clientes uma memória persistente que se atualiza quando os fatos mudam.
  • Auditar o repositório de memórias existente de um agente em busca de registros desatualizados, duplicados ou sem respaldo antes da migração.
  • Hospedar memórias de agentes por tenant atrás de um gateway autenticado com interface de inspeção.
  • Conectar um cliente compatível com MCP a um repositório de memórias local usando tokens com escopo delimitado.

Início rápido

  1. 1

    Instalar v4 a partir do código-fonte

    pip install "git+https://github.com/caspianmoon/memoripy.git@v4"
  2. 2

    Criar um armazenamento Memory e registrar um fato em Python

Antes de usar

  • O v4 é desenvolvido em uma branch, e a versão estável do PyPI ainda pode apontar para a API antiga.
  • A instalação a partir do código-fonte requer git e deve ser feita de um repositório hospedado no Git, não de um pacote publicado.

Em coleções

Memória de longo prazo para agentes de IAFrameworks e apps de agentes de IA open sourceServidores MCP

Tópicos

#ai-agents#llm#memory#rag#mcp#retrieval#audit#python#ai#memory-management

Perguntas frequentes

O que é memoripy?
Runtime local de memória para agentes de IA, com foco em evidências: filtra gravações, acompanha mudanças nos fatos ao longo do tempo e explica cada resultado recuperado. Memoripy é uma camada local de memória para agentes de IA. Em vez de armazenar tudo o que um agente vê, aplica uma política de admissão antes de gravar, rejeitando ou colocando em quarentena ruído, possíveis segredos e instruções inseridas em conteúdo não confiável. Os registros são bitemporais e versionados, então um fato alterado, como um novo endereço, substitui o anterior, enquanto as evidências históricas continuam disponíveis para consulta.
memoripy é gratuito? Qual é a licença?
memoripy é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
memoripy ainda é mantido?
Atualizado nos últimos 6 meses. O último commit de memoripy foi em 17 de ago. de 2026.
Para que posso usar memoripy?
Dar a um agente pessoal ou voltado para clientes uma memória persistente que se atualiza quando os fatos mudam. Auditar o repositório de memórias existente de um agente em busca de registros desatualizados, duplicados ou sem respaldo antes da migração. Hospedar memórias de agentes por tenant atrás de um gateway autenticado com interface de inspeção. Conectar um cliente compatível com MCP a um repositório de memórias local usando tokens com escopo delimitado.
Como instalar memoripy?
Instalar v4 a partir do código-fonte: pip install "git+https://github.com/caspianmoon/memoripy.git@v4" Criar um armazenamento Memory e registrar um fato em Python
Onde consigo memoripy?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/caspianmoon/memoripy

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados