코딩 에이전트의 세션 활동을 기록하고 AI로 압축한 뒤, 이후 세션에 관련 컨텍스트를 제공하는 지속성 메모리입니다.
aru-labs/lossless-memory
모든 대화 원문을 요약 없이 보관하고 시간순으로 색인하는, 개인용 AI를 위한 로컬 파일 기반 장기 메모리입니다.
- 스타
- 146
- 포크
- 13
- 열린 이슈
- 0
- 마지막 커밋
- 29일 전
어떤 프로젝트인가요?
lossless-memory는 개인용 AI의 대화 기록을 타임스탬프가 포함된 원본 JSONL 로그로 저장하며, 절대 요약하지 않습니다. 레코드는 정확한 단어 검색을 위한 FTS5와 의미 검색을 위한 sqlite-vec를 사용해 SQLite에 색인하며, 로그를 바탕으로 색인을 언제든 삭제하고 다시 만들 수 있습니다.
검색은 시간 범위를 먼저 따집니다. 예를 들어 "어제 저녁, 예산에 관해" 같은 질의는 순위를 매기기 전에 날짜 범위로 변환되며, 일치하는 대화 줄은 타임스탬프와 함께 시간순으로 반환됩니다. 해당 범위에서 정확 검색 결과가 너무 적을 때만 의미 검색을 대체 수단으로 사용합니다. 별도의 LLL 색인에는 타임스탬프가 포함된 주제 표시가 기록되어, 매 대화 차례마다 모델에 현재 대화 주제를 전달할 수 있습니다.
이 프로젝트는 서버나 클라우드 구성 요소 없이 한 대의 컴퓨터에서 한 명의 사용자를 위해 실행됩니다. 시간 표현은 영어와 일본어로 처리하며, 데몬은 기본적으로 10분마다 변경된 로그 파일을 다시 색인합니다.
핵심 기능
- 01모든 대화 차례를 고정된 7개 필드 스키마의 일별 JSONL 파일에 원문 그대로 저장합니다.
- 02영어와 일본어의 상대적·절대적 시간 표현을 해석해 검색 범위를 제한합니다.
- 03SQLite FTS5 키워드 검색과 대체 수단인 sqlite-vec 의미 검색을 결합합니다.
- 04타임스탬프가 포함된 주제 표시를 LLL 색인에 보관하고, 이를 모델 컨텍스트에 주입할 수 있습니다.
- 05원본 로그에서 색인을 다시 만들고, 백그라운드 데몬을 통해 변경된 날짜의 로그만 다시 색인합니다.
활용 사례
- 자체 호스팅하는 개인용 AI 어시스턴트에 과거 대화의 장기 메모리를 제공합니다.
- 특정 날짜나 시간 범위에 어떤 말을 했거나 어떤 결정을 내렸는지 찾아봅니다.
- 컨텍스트 윈도우 압축이나 세션 재시작 후에도 어시스턴트의 현재 주제를 유지합니다.
빠른 시작
- 1
저장소를 클론합니다
git clone https://github.com/aru-labs/lossless-memory - 2
프로젝트 디렉터리로 이동합니다
cd lossless-memory - 3
패키지를 editable 모드로 설치합니다
pip install -e . - 4
예제 설정 파일을 복사하고 원하는 경우 이름과 경로를 수정합니다
cp config.example.json config.json
사용 전 알아둘 점
- 단일 머신의 단일 사용자를 위해 설계되었으며, 멀티 테넌시는 지원하지 않습니다.
- 상대 시간 표현은 영어와 일본어로만 파싱됩니다.
- 시맨틱 검색을 사용하려면 로컬 sentence-transformers 임베딩 모델이 필요합니다.
- 개발이 당분간 중단됩니다.
토픽
자주 묻는 질문
- lossless-memory은(는) 무엇인가요?
- 모든 대화 원문을 요약 없이 보관하고 시간순으로 색인하는, 개인용 AI를 위한 로컬 파일 기반 장기 메모리입니다. lossless-memory는 개인용 AI의 대화 기록을 타임스탬프가 포함된 원본 JSONL 로그로 저장하며, 절대 요약하지 않습니다. 레코드는 정확한 단어 검색을 위한 FTS5와 의미 검색을 위한 sqlite-vec를 사용해 SQLite에 색인하며, 로그를 바탕으로 색인을 언제든 삭제하고 다시 만들 수 있습니다.
- lossless-memory은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- lossless-memory은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- lossless-memory은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. lossless-memory의 마지막 커밋은 2026년 9월 23일입니다.
- lossless-memory은(는) 어디에 사용할 수 있나요?
- 자체 호스팅하는 개인용 AI 어시스턴트에 과거 대화의 장기 메모리를 제공합니다. 특정 날짜나 시간 범위에 어떤 말을 했거나 어떤 결정을 내렸는지 찾아봅니다. 컨텍스트 윈도우 압축이나 세션 재시작 후에도 어시스턴트의 현재 주제를 유지합니다.
- lossless-memory는 어떻게 설치하나요?
- 저장소를 클론합니다: git clone https://github.com/aru-labs/lossless-memory 프로젝트 디렉터리로 이동합니다: cd lossless-memory 패키지를 editable 모드로 설치합니다: pip install -e . 예제 설정 파일을 복사하고 원하는 경우 이름과 경로를 수정합니다: cp config.example.json config.json
- lossless-memory은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/aru-labs/lossless-memory
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
코딩 에이전트를 위한 장기 메모리로, 로컬 SQLite 데이터베이스에 메모리를 저장하고 Claude Code, Codex, Cursor 및 기타 MCP 클라이언트에서 공유합니다.
코딩 에이전트 세션을 기록하고 재사용 가능한 스킬로 정리해 Claude Code, Codex, Cursor 등 여러 에이전트와 공유하는 자동 학습 메모리 계층입니다.
대화 기록을 원문 그대로 저장하고 의미 검색으로 찾아주는 로컬 우선 AI 메모리 시스템으로, MCP 서버와 CLI를 제공합니다.
AI 에이전트를 위한 로컬 우선 Markdown 기반 장기 메모리 계층으로, SQLite와 LanceDB 인덱스를 활용해 메모리를 편집 가능한 파일로 저장합니다.
Claude Code, Codex, OpenClaw 등 여러 AI 에이전트가 함께 사용하는, 로컬에서 직접 호스팅하는 개인용 영구 메모리 허브입니다.