lightrag-snkv — embedded storage backend powered by SNKV database only

[hash-anu]

Hi LightRAG team,

I built a drop-in storage backend for LightRAG using SNKV — an embedded
SQLite B-Tree-based storage engine. Sharing here in case it's useful to others.

What it does

Replaces all four LightRAG storage backends (KV, vector, graph, doc status)
with two embedded SNKV files. No external server required.

Why it might interest you

• No external dependencies — no Redis, no Postgres, no Qdrant, no Neo4j.
  Just two files on disk. Install the repo and it works.
• Safe writes — every multi-step operation runs in a single SNKV
  transaction. The default backend has no such guarantee.
• Fast restarts — HNSW vector index is saved to a sidecar file and
  validated on open. Loads in milliseconds instead of rebuilding from scratch.
• Fewer files — everything collapses into snkv.db and snkv_vec.db.
  Easier to back up and move.

How to use it

Four lines of config change, nothing else in your existing code changes:

from lightrag_snkv import register
register()

rag = LightRAG(
    kv_storage="SNKVKVStorage",
    vector_storage="SNKVVectorStorage",
    graph_storage="SNKVGraphStorage",
    doc_status_storage="SNKVDocStatusStorage",
    ...
)

Full instructions and .env reuse guide: https://github.com/hash-anu/lightrag-snkv

Feedback welcome.