YAMS — Yet Another Memory System¶

Experimental Software

YAMS is under active development. Expect bugs and breaking changes. Wait for 1.0 for production use.

Content-addressed storage with deduplication, compression, full-text and vector search.

Features¶

Feature	Description
Content-addressed	SHA-256 hashing for immutable references
Deduplication	Rabin fingerprinting block-level dedupe
Search	FTS5 full-text + ONNX embedding vector search
Durability	WAL-backed, thread-safe, high-throughput
Interface	CLI and MCP server
Extensible	Plugin architecture

Platforms: Linux x86_64/ARM64, macOS x86_64/ARM64, Windows x86_64

brew install trvon/yams/yams
yams --version

# Linux/macOS
./setup.sh Release
meson compile -C build/release

# Windows (PowerShell)
./setup.ps1 Release
meson compile -C build/release

Requirements: GCC 13+, Clang 16+, or MSVC 2022+; meson, conan, ninja-build

See BUILD.md for details.

yams init
echo "hello world" | yams add - --tags demo
yams search hello --limit 5
yams list --limit 10

yams serve  # stdio transport

Config example:

{
  "mcpServers": {
    "yams": { "command": "yams", "args": ["serve"] }
  }
}

Section	Content
User Guide	CLI reference, search, configuration
Architecture	System design, daemon, search internals
API	MCP tools, REST endpoints
Developer	Building, testing, contributing
Benchmarks	Public benchmark runbooks and baseline reports