christopherkarani/Wax

Single-file memory layer for AI agents, sub mili-second RAG on Apple Silicon. Metal Optimized On-Device. No Server. No API. One File. Pure Swift

What it solves

Wax는 로컬 단일 파일 메모리 레이어를 제공하여 클라우드 기반 벡터 데이터베이스, 복잡한 Docker 설정, API 키가 필요하지 않게 합니다. 에이전트는 세션 간에 지속적인 장기 메모리를 유지할 수 있으며, 모든 데이터가 사용자의 디바이스에 저장되어 프라이버시와 속도가 보장됩니다.

How it works

Wax는 문서, 임베딩, 구조화된 지식을 전용 .wax 바이너리 파일에 저장합니다. 하이브리드 검색 방식을 사용해 SQLite FTS5를 통한 텍스트 검색과 Metal 가속 HNSW 인덱스를 통한 벡터 검색을 결합합니다. 데이터 무결성을 위해 WAL(Write‑Ahead Log)과 이중 헤더 페이지를 사용해 충돌 복원력을 높였습니다. 파일 크기를 작게 유지하기 위해 LZ4 압축을 적용합니다.

Who it’s for

Swift 개발자: iOS 또는 macOS 앱에서 온‑디바이스 RAG(검색 강화 생성) 또는 지속적인 AI 메모리가 필요한 경우.
CLI 파워 유저: 스크립트 가능한 명령줄 메모리 스토어를 원하는 개발자.
AI 에이전트 사용자: Claude Code, Cursor, Windsurf 등 어시스턴트를 사용하며 Model Context Protocol(MCP)을 통해 에이전트가 세션 간 컨텍스트와 결정을 기억하도록 하고 싶은 사람.

Highlights

단일 파일 저장: 모든 메모리가 하나의 .wax 파일에 묶여 있어 iCloud 또는 AirDrop을 통해 쉽게 동기화 및 전송할 수 있습니다.
Apple Silicon 네이티브: M 시리즈 하드웨어에 최적화되어 매우 낮은 리콜 레이턴시(~6ms p95)를 달성합니다.
하이브리드 검색: 의미(벡터) 검색과 결정적(텍스트) 검색 모드를 모두 지원합니다.
MCP 통합: 로컬 메모리를 AI 코딩 어시스턴트에 연결하는 일류 Model Context Protocol 서버를 포함합니다.
제로 설정: 기본 운영에 서버나 외부 종속성이 필요하지 않습니다.