kvs

Overview ¶

Package kvs provides a KVS-backed Provider implementation using omnistorage-core.

This provider stores memories as JSON blobs in a key-value store, supporting SQLite, Redis, and in-memory backends via omnistorage-core/kvs.

Key Format ¶

Memories are stored with keys in the format:

{prefix}:{tenant_id}:{subject_id}:{memory_id}

This allows efficient listing by tenant and subject.

Semantic Search ¶

Since KVS backends don't support vector search natively, this provider performs in-memory similarity search by loading matching memories and computing cosine similarity on their embeddings.

Usage ¶

import (
    "github.com/plexusone/omnimemory"
    "github.com/plexusone/omnimemory/core"
    "github.com/plexusone/omnimemory/provider/kvs"
    kvsmemory "github.com/plexusone/omnistorage-core/kvs/backend/memory"
)

func main() {
    // Create a KVS backend
    store := kvsmemory.New()

    // Create the provider
    provider, err := kvs.NewProvider(core.ProviderConfig{
        Options: map[string]any{
            "store": store,
            "key_prefix": "memories",
        },
    }, embedder)
}