Repolode
aru-labs

aru-labs/lossless-memory

Memória de longo prazo local e baseada em arquivos para uma IA pessoal, que preserva cada linha bruta de conversa sem resumir e a indexa por horário.

Estrelas
146
Forks
13
Issues abertas
0
Último commit
há 29 dias

O que é?

lossless-memory armazena o histórico de conversas de uma IA pessoal em logs JSONL brutos com marcação de tempo, sem nunca resumi-los. Os registros são indexados no SQLite com FTS5 para busca exata por palavras e com sqlite-vec para busca semântica; os índices podem ser excluídos e recriados a qualquer momento a partir dos logs.

A recuperação começa pelo horário. Uma consulta como "ontem à noite, sobre o orçamento" é convertida em um intervalo de datas antes da classificação, e as linhas correspondentes são retornadas em ordem cronológica, com suas marcações de tempo. A busca semântica é usada apenas como alternativa quando o índice exato retorna poucos resultados dentro desse intervalo. Um índice separado, chamado LLL, registra marcadores de tópicos com marcação de tempo para que o modelo receba o tópico atual da conversa em cada turno.

O projeto funciona em uma única máquina para um único usuário, sem servidor nem componente na nuvem. As expressões de tempo são interpretadas em inglês e japonês, e um daemon reindexa, por padrão, os arquivos de log alterados a cada dez minutos.

Recursos principais

  • 01Armazena cada turno da conversa sem alterações em arquivos JSONL diários, com um esquema fixo de sete campos.
  • 02Interpreta expressões de tempo relativas e absolutas em inglês e japonês para restringir os intervalos de busca.
  • 03Combina a busca por palavras-chave do SQLite FTS5 com a busca semântica do sqlite-vec como alternativa.
  • 04Mantém um índice LLL de marcadores de tópicos com marcação de tempo, que podem ser inseridos no contexto do modelo.
  • 05Recria os índices a partir dos logs brutos e reindexa apenas os dias alterados por meio de um daemon em segundo plano.

Casos de uso

  • Dar a um assistente de IA pessoal auto-hospedado uma memória de longo prazo das conversas anteriores.
  • Consultar o que foi dito ou decidido em um dia ou intervalo de tempo específico.
  • Manter o tópico atual de um assistente durante a compactação da janela de contexto e após reinicializações da sessão.

Início rápido

  1. 1

    Clone o repositório

    git clone https://github.com/aru-labs/lossless-memory
  2. 2

    Acesse o diretório do projeto

    cd lossless-memory
  3. 3

    Instale o pacote em modo editável

    pip install -e .
  4. 4

    Copie o arquivo de configuração de exemplo e edite os nomes e caminhos, se quiser

    cp config.example.json config.json

Antes de usar

  • Foi projetado para um único usuário em uma única máquina; não oferece suporte a vários locatários.
  • As expressões de tempo relativo são analisadas apenas em inglês e japonês.
  • A busca semântica requer um modelo local de embeddings do sentence-transformers.
  • O desenvolvimento ficará pausado por um tempo.

Tópicos

Perguntas frequentes

O que é lossless-memory?
Memória de longo prazo local e baseada em arquivos para uma IA pessoal, que preserva cada linha bruta de conversa sem resumir e a indexa por horário. lossless-memory armazena o histórico de conversas de uma IA pessoal em logs JSONL brutos com marcação de tempo, sem nunca resumi-los. Os registros são indexados no SQLite com FTS5 para busca exata por palavras e com sqlite-vec para busca semântica; os índices podem ser excluídos e recriados a qualquer momento a partir dos logs.
lossless-memory é gratuito? Qual é a licença?
lossless-memory é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
lossless-memory ainda é mantido?
Manutenção ativa. O último commit de lossless-memory foi em 23 de set. de 2026.
Para que posso usar lossless-memory?
Dar a um assistente de IA pessoal auto-hospedado uma memória de longo prazo das conversas anteriores. Consultar o que foi dito ou decidido em um dia ou intervalo de tempo específico. Manter o tópico atual de um assistente durante a compactação da janela de contexto e após reinicializações da sessão.
Como instalar lossless-memory?
Clone o repositório: git clone https://github.com/aru-labs/lossless-memory Acesse o diretório do projeto: cd lossless-memory Instale o pacote em modo editável: pip install -e . Copie o arquivo de configuração de exemplo e edite os nomes e caminhos, se quiser: cp config.example.json config.json
Onde consigo lossless-memory?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/aru-labs/lossless-memory

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

Projetos relacionados