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 はローカルかつ単一ファイルの AI エージェント用メモリ層を提供し、クラウドホストのベクトルデータベースや複雑な Docker 設定、API キーの必要性を排除します。エージェントはセッション間で永続的な長期メモリを保持でき、すべてのデータはユーザーのデバイス上に保存されるため、プライバシーと速度が確保されます。

How it works

Wax はドキュメント、埋め込みベクトル、構造化ナレッジを専用の .wax バイナリファイルに保存します。ハイブリッド検索アプローチを採用し、SQLite FTS5 による文字列検索と Metal 加速の HNSW インデックスによるベクトル検索を組み合わせます。データ整合性を保つため、WAL（Write‑Ahead Log）と二重ヘッダーページを使用してクラッシュ耐性を実現しています。ファイルサイズを小さく保つために LZ4 圧縮を行います。

Who it’s for

Swift 開発者：iOS または macOS アプリでオンデバイス RAG（Retrieval‑Augmented Generation）や永続的な 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 サーバーを搭載。
ゼロコンフィグ：基本的な動作にサーバーや外部依存は不要です。