🧠도구

OptMem: AI 에이전트를 위한 영구 메모리 시스템

단 426토큰의 프롬프트로 AI 에이전트에게 영구적인 기억을 제공하는 플러그 앤 플레이 도구

↗ 원본 링크
#메모리#AI에이전트#영구저장소#Python

OptMem이란?

OptMem은 AI 에이전트에게 세션을 넘어서는 영구적인 기억을 제공하는 도구입니다. 426토큰의 간단한 프롬프트와 스크립트만으로 즉시 사용할 수 있습니다.

주요 특징

▸
간단한 설치: 한 줄 명령어로 설치 완료
▸
영구 보존: 세션, 모델, 벤더 변경에도 기억 유지
▸
빠른 성능: 100만 개 메모리에서도 0.03초 응답
▸
의존성 없음: Python 3만 있으면 실행 가능

설치 방법

bash
curl -fsSL https://raw.githubusercontent.com/VictorTaelin/OptMem/main/install.sh | sh

설치 후 출력되는 ## Memory 블록을 에이전트의 AGENTS.md 파일 상단에 붙여넣으면 끝입니다.

핵심 명령어

▸`memo wake`: 메모리 읽기 (매 세션 첫 명령어)
▸`memo note "..."`: 메모리 기록 (1줄, 최대 280바이트)
▸`memo nap`: 병합 작업 수행
▸`memo recall <regex>`: 모든 메모리 검색
▸`memo zoom <lo>-<hi>`: 트리 노드 확장
▸`memo forget <lo>-<hi>`: 잘못된 요약 삭제

파일 구조

~/.optmem/
  memo          # 도구 (Python 3 파일)
  memory/
    LOG.txt     # 모든 메모리 (한 줄씩, 추가만 가능)
    TREE/       # 요약 캐시
    config      # 설정 파일

설정 커스터마이징

bash
memo config                  # 현재 설정 확인
memo config WAKE_LINES=300   # wake 출력 라인 수 변경

WAKE_LINES는 읽기 예산을 조절합니다. 기본값 96은 약 8k 토큰에 해당합니다.

작동 원리

1.세션 시작: memo wake로 메모리 활성화
2.작업 중: 새로운 정보를 memo note로 기록
3.주기적 정리: memo nap으로 메모리 병합
4.검색: memo recall로 과거 기억 조회

모든 메모리는 LOG.txt에 한 줄씩 추가되며, 절대 편집되지 않습니다. TREE 폴더의 요약은 캐시이므로 언제든 재구축 가능합니다.

장점

▸백그라운드 프로세스 없음
▸고정 폭 레코드로 빠른 조회
▸동기화 폴더나 Git 저장소에 보관 가능
▸AI 에이전트가 자신의 정체성과 과거 결정을 기억

OptMem은 AI 에이전트에게 진정한 연속성을 제공하는 혁신적인 메모리 솔루션입니다.