Skip to content

YAMS — Yet Another Memory System

Persistent, searchable memory for your code, documents, and AI workflows. Store once, find anything, never lose context.

Latest tag builds.sr.ht status

Experimental Software

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


Why YAMS

  • Store anything, find it later. Content-addressed storage with automatic deduplication and compression.
  • Search by meaning, not just keywords. Hybrid full-text + vector embeddings.
  • Works with your tools. CLI, MCP server for AI assistants, C-ABI plugin architecture.

Quick Start

brew install trvon/yams/yams       # or see Install below
yams init
echo "hello world" | yams add - --tags demo
yams search hello

Use with AI Assistants

YAMS runs as an MCP server over stdio (JSON-RPC).

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

Full MCP setup: user_guide/mcp.md.

Install

Platform Command
macOS (Homebrew) brew install trvon/yams/yams
Debian / Ubuntu APT repo — see installation.md#apt
Fedora / RHEL DNF repo — see installation.md#dnf
Docker docker pull ghcr.io/trvon/yams:latest
From source See BUILD.md

Supported: Linux x86_64/ARM64, macOS x86_64/ARM64, Windows x86_64.

Resource URL
Full docs README.md
Benchmarks benchmarks/README.md
Roadmap roadmap.md
SourceHut https://sr.ht/~trvon/yams/
GitHub https://github.com/trvon/yams
Discord https://discord.gg/rTBmRHdTEc
License GPL-3.0-or-later