Clamp - Version Control for RAG

Git-like versioning for vector databases. Rollback your knowledge base without losing data.

Watch Clamp revert a poisoned RAG index instantly without re-embedding.

Install

pip install clamp-rag

Quick Start (CLI)

# Initialize Clamp
clamp init

# Create and commit a document
echo "Your document content" > docs.txt
clamp commit docs.txt my_group "Added initial docs"

# View commit history
clamp history my_group

# Check current version
clamp status my_group

# Checkout previous commit
clamp checkout my_group HEAD~1   # or use commit hash

# List all tracked groups
clamp groups

Why Clamp?

Vector DBs get stale when docs update. Old embeddings cause semantic conflicts in RAG retrieval.

Clamp adds git-style versioning:

• Commit your knowledge base
• Checkout any version instantly (no re-embed, no data copy, just metadata flags)
• Works on Qdrant (local sqlite history)

Python API

from qdrant_client import QdrantClient
from clamp import ClampClient

qdrant = QdrantClient("localhost", port=6333)
clamp_client = ClampClient(qdrant)

# Ingest with versioning
commit = clamp_client.ingest(
    collection="docs",
    group="my_group",
    documents=[{"text": "...", "vector": [...]}],
    message="Initial version"
)

# Rollback
clamp_client.rollback(collection="docs", group="my_group", commit_hash=commit)

# View history
clamp_client.history(group="my_group")

How It Works

• Versions stored as separate points in Qdrant
• Metadata tracks commit hashes and active state
• Rollback = flip active flags (instant, no data movement)
• Local SQLite stores commit history

Status

🚀 v1.2.0 - Beta. Qdrant support only.

Requirements

• Qdrant (local or cloud)
• Python 3.10+

License

MIT - see LICENSE for more details.