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 索引进行向量搜索。为确保数据完整性，Wax 使用预写日志 (WAL) 与双页首标头以提升崩溃韧性。数据会以 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 集成：内建一流的 Model Context Protocol 服务器，将本地记忆连接至 AI 编码助理。
  • 零配置：基本运行不需服务器或外部依赖。