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. Files, notes, code, PDFs — YAMS keeps one copy and retrieves it instantly.

  • Search by meaning, not just keywords. Hybrid search combines full-text indexing with vector embeddings so you can search by concept, not just exact text.

  • Works with your tools. CLI for scripts and automation. MCP server for AI assistants like Claude Desktop. Plugin architecture for custom integrations.

Quick Start

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

Use with AI Assistants

YAMS runs as an MCP server, giving AI assistants persistent memory with 3 composite tools (query, execute, session).

yams serve  # stdio transport

Add to your Claude Desktop config:

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

See the MCP guide for full setup and usage.

Install

Debian / Ubuntu (APT)

curl -fsSL https://repo.yamsmemory.ai/gpg.key \
  | sudo gpg --dearmor -o /usr/share/keyrings/yams.gpg

echo "deb [arch=amd64,arm64 signed-by=/usr/share/keyrings/yams.gpg] https://repo.yamsmemory.ai/aptrepo stable main" \
  | sudo tee /etc/apt/sources.list.d/yams.list
sudo apt-get update && sudo apt-get install yams

# Optional: start the packaged daemon service
sudo systemctl enable --now yams-daemon
yams daemon status

Fedora / RHEL (YUM / DNF)

Repo path caveat

The hosted YUM repository is documented here, but the current automated validation installs the published .rpm artifact directly rather than pulling it through the repo metadata.

sudo tee /etc/yum.repos.d/yams.repo <<'REPO'
[yams]
name=YAMS Repository
baseurl=https://repo.yamsmemory.ai/yumrepo/
enabled=1
gpgcheck=0
REPO
sudo dnf makecache && sudo dnf install yams

macOS (Homebrew)

brew install trvon/yams/yams

Other methods

Method Details
Docker docker run --rm -it ghcr.io/trvon/yams:latest --version
Direct download curl -fsSL https://repo.yamsmemory.ai/latest.json | jq .
Build from source See Installation

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

Resource URL
Roadmap What’s planned
SourceHut https://sr.ht/~trvon/yams/
GitHub https://github.com/trvon/yams
Discord https://discord.gg/rTBmRHdTEc
License GPL-3.0-or-later