SuperLocalMemory — AI 에이전트를 위한 로컬 장기 기억

SuperLocalMemory는 무엇을 하는 도구인가요?

Qualixar의 SuperLocalMemory는 AI 에이전트를 위한 오픈 소스 메모리 시스템입니다. 연결된 도우미가 읽고 갱신하는 검색 가능한 프로젝트 노트라고 생각하면 쉽습니다. 오늘 저장한 기술적 결정이나 작업 규칙을 다음 세션에서 다시 찾아 배경 설명을 반복하는 일을 줄일 수 있습니다.

여러 편집기를 사용하는 개발자, 오래 이어지는 프로젝트를 관리하는 팀, 지식을 직접 보관하려는 사용자에게 적합합니다. 설치와 클라이언트 설정이 필요하며, 도우미가 실제로 메모리 도구를 호출해야 저장된 내용을 활용할 수 있습니다.

세션이 끝나도 프로젝트 결정을 유지하기

사실, 결정, 규칙, 절차를 다시 사용할 수 있는 기록으로 저장합니다. 검색은 의미와 키워드, 시간, 관계를 함께 고려하고 프로젝트나 기록 유형으로 범위를 좁힐 수 있습니다. 비슷한 문장의 다른 프로젝트 메모와 구분할 때 유용합니다.

정보가 바뀌면 이전 기록을 남긴 채 새 정보로 대체할 수 있습니다. 검토한 수정은 되돌릴 수 있고, 시간 기반 검색은 사건이 일어난 시점과 시스템이 알게 된 시점을 구분합니다. 검색 점수는 관련도를 나타내므로 사실의 정확도를 보증하는 수치로 받아들이면 안 됩니다.

첫 메모리를 저장하고 검색해 보기

공식 설치 안내에 따르면 npm 경로에는 Node.js 18 이상과 npm 9 이상이 필요합니다. pipx나 uv 경로는 Python 3.12–3.14를 지원합니다.

1. npm install -g superlocalmemory를 실행합니다.
2. slm setup에서 먼저 Mode A를 선택합니다.
3. slm remember "테스트 데이터베이스 포트는 5434입니다."처럼 민감하지 않은 정보를 저장합니다.
4. slm recall "테스트 데이터베이스 포트가 무엇인가요?"로 검색하고 실제 기록을 확인합니다.
5. slm status로 상태를 살펴본 뒤, 예를 들어 slm connect cursor로 지원 편집기를 연결합니다.

자동 수집을 켜기 전에 이 저장과 검색 과정을 확인하면 설정 오류를 찾기 쉽습니다. 플러그인, hooks와 MCP 설정은 클라이언트마다 다릅니다.

로컬 처리와 외부 전송 범위 선택하기

Mode A는 로컬 임베딩을 사용하며 기본 저장과 검색에 생성형 모델 제공자가 필요하지 않습니다. 다만 의존성과 모델을 처음 준비할 때는 다운로드가 필요합니다. Mode B는 Ollama 또는 호환 엔드포인트로 언어 모델 처리를 더합니다. 해당 엔드포인트가 같은 컴퓨터에서 실행되어야 처리도 로컬에 남습니다. Mode C는 질문과 메모리 텍스트를 설정한 제공자에게 보낼 수 있습니다.

모드별 네트워크 범위를 확인하세요. 데이터베이스가 로컬이어도 연결한 클라우드 도우미는 별도 데이터 흐름을 가집니다. 역할, 작업 공간, 보관 정책과 감사 기록은 관리 기능이며 법적 인증을 뜻하지 않습니다.

답변 검사와 문서 검색 활용하기

답변 검사는 검색된 기억이 질문에 실제로 답하는지 판단합니다. Laya는 Apple Silicon에서 실행되며 약 1.1 GB 모델을 내려받습니다. Jev는 사용자의 키와 동의로 켜는 온라인 선택 사항입니다. 보통 질문과 상위 기억 3개를 보내며, 추가 재정렬을 켜면 최대 20개를 다룹니다. 이 검사가 모든 잘못된 답변을 방지한다는 보장은 없습니다.

선택형 로컬 미디어 색인은 지원 이미지와 PDF 페이지를 OCR, 파일 및 페이지 참조와 함께 검색합니다. 기본적으로 꺼져 있고 16 GB 메모리와 추가 모델 다운로드가 필요합니다. 폴더와 Obsidian 저장소도 slm sources add로 읽기 전용 연결을 만들 수 있습니다. 미디어 색인은 Intel Mac이나 Windows on ARM을 지원하지 않습니다.

도구 연결, 비용과 실행 조건

지원 클라이언트는 통합 기능이나 MCP로 같은 저장소를 사용합니다. Web access는 OAuth와 앱별 읽기 또는 저장 권한으로 웹 앱을 연결합니다. 컴퓨터가 온라인이어야 하며, 데이터베이스는 로컬에 있어도 요청과 결과는 게이트웨이와 연결 앱을 거칩니다.

2026년 10월 18일 확인 기준 로컬 핵심 기능은 AGPL v3 라이선스로 무료입니다. 웹 접근에는 연결별 일일 무료 허용량이 있지만 확인한 페이지에서 모든 사용자에게 적용되는 구체적 숫자는 확인되지 않았습니다. 외부 모델, Jev와 AI 도구에는 별도 요금이 생길 수 있습니다. 사전 빌드 설치는 Apple Silicon, 64비트 Windows와 Linux를 지원하며 Intel Mac과 32비트 Windows용은 없습니다.

자주 묻는 질문

인터넷 없이 사용할 수 있나요?

모델과 의존성 준비가 끝나면 Mode A 핵심 기능은 로컬에서 동작할 수 있습니다. 웹 접근, 외부 제공자와 일부 도우미에는 연결이 필요합니다.

API 키나 구독이 꼭 필요한가요?

Mode A 로컬 핵심에는 필요하지 않습니다. Jev와 클라우드 제공자는 자신의 인증 정보를 사용하며 사용료가 별도로 발생할 수 있습니다.

여러 AI 도구가 같은 기억을 사용할 수 있나요?

지원 통합이나 MCP로 가능합니다. 프로필과 권한을 정한 뒤 한 클라이언트에서 저장한 기록을 다른 클라이언트에서 정확히 찾는지 시험하세요.

공식 자료

• 소스 코드와 문서: 라이선스와 연결 방법, 문제 보고.
• 일상 작업 흐름 예시: 저장, 교체와 검색 과정.
• 답변 검사 설명: Laya와 Jev의 조건 및 전송 데이터.