yams/docs/README.md

1.6 KiB

YAMS Documentation Index

Content-addressed storage with deduplication and semantic search.

Documentation Structure

  • Get Started: Installation, CLI, MCP integration
  • User Guides: Tutorials, embeddings, search
  • Admin: Operations, configuration, tuning
  • Developer: Contributing, build system, architecture
  • API: MCP tools, plugin specs
  • Hosting: Managed hosting, self-hosting

Plugin System

YAMS supports C-ABI plugins loaded from trusted directories.

Trust file: <data_dir>/plugins.trust (default: ~/.local/share/yams/plugins.trust)

Discovery paths:

  • YAMS_PLUGIN_DIR (exclusive if set)
  • $HOME/.local/lib/yams/plugins
  • /usr/local/lib/yams/plugins, /usr/lib/yams/plugins

CLI:

yams plugin scan
yams plugin trust add /usr/local/lib/yams/plugins
yams plugin load /path/to/plugin.so

See PLUGINS.md for details.

Build Options (Meson)

Option Default Description
build-cli true Build CLI binary
build-mcp-server true Build MCP server
build-tests false Build test suite
enable-pdf enabled PDF text extraction (qpdf)
enable-onnx enabled ONNX embedding models

See BUILD.md for full build instructions.