SDKs & packages

Packages

npm provides the typed TypeScript client and native server launcher. PyPI provides the typed Python client. The repository's Go module wraps go-redis with typed memory methods. Other languages use raw commands; see client libraries.

TypeScript

npm install klyro-db@0.1.1

import { createClient } from "klyro-db";

const klyro = createClient();

await klyro.memory.create("user:123", { mode: "HYBRID", dim: 3 });
await klyro.memory.add("user:123", {
  text: "User prefers PostgreSQL for backend projects.",
  vector: [0.12, 0.81, 0.43],
  meta: { type: "preference" },
  importance: 0.85,
});

const hits = await klyro.memory.query("user:123", {
  text: "preferred database?",
  vector: [0.10, 0.79, 0.46],
  topK: 5,
});

Client options

createClient() returns an ioredis client, so ordinary Redis methods retain their upstream types. Klyro's 15 memory commands live under client.memory. Use client.memoryBuffer when IDs, text, or metadata contain arbitrary bytes. Both memory surfaces encode number arrays and Float32Array values as little-endian float32 vectors; returned vectors are Float32Array values.

TypeScript result shapes

Records expose id, optional text, importance, millisecond created_at and updated_at timestamps, and pttl in milliseconds. Requested metadata is a Map. Search hits add score, while withScores adds the keyword, vector, and recency components.

Python

pip install klyro-db==0.1.1

from klyro_db import Klyro, MemoryAdd, MemoryCreate, MemoryQuery

klyro = Klyro(host="localhost", port=7171)

klyro.memory.create("user:123", MemoryCreate(mode="HYBRID", dim=3))
klyro.memory.add("user:123", MemoryAdd(
    text="User prefers PostgreSQL for backend projects.",
    vector=[0.12, 0.81, 0.43],
    metadata={"type": "preference"},
    importance=0.85,
))

hits = klyro.memory.query("user:123", MemoryQuery(
    text="preferred database?",
    vector=[0.10, 0.79, 0.46],
    top_k=5,
))

Klyro subclasses redis-py's Redis, so standard commands remain available on the same object. Its memoryproperty provides typed dataclasses and decoded replies for every current MEM.* command. The distribution includes a py.typed marker for mypy, Pyright, and compatible editors. Vector sequences are encoded as little-endian float32 bytes and decoded to tuples. Timestamps and pttl are milliseconds; TTL and half-life inputs are seconds.

Go

go get github.com/Hitesh-s0lanki/klyro/go

import klyro "github.com/Hitesh-s0lanki/klyro/go"

db := klyro.NewClient(nil)

db.Memory.Create(ctx, "user:123", klyro.CreateOptions{
  Mode: klyro.Hybrid,
  Dim: 3,
})
db.Memory.Add(ctx, "user:123", klyro.AddOptions{
  Text: "User prefers PostgreSQL for backend projects.",
  Vector: []float32{0.12, 0.81, 0.43},
})

hits, err := db.Memory.Query(ctx, "user:123", klyro.QueryOptions{
  Text: "preferred database?",
  Vector: []float32{0.10, 0.79, 0.46},
  SearchOptions: klyro.SearchOptions{TopK: 5},
})

NewClient embeds the go-redis universal client, so its standard commands remain available. Typed memory methods live under client.Memory. Use klyro.Wrap to add them to an existing go-redis client.

Go option zero values

Go uses zero values to mean “not supplied”: an empty mode defaults to HYBRID, an empty metric defaults to COSINE, and zero values for TopK, TTL, and HalfLife are omitted. Use pointers for optional importance and weights. Calling Expire(ctx, key, id, 0) is the explicit exception: it is sent to the server and clears a record deadline.

Client construction

All typed memory functions

The names differ by language, but each row calls the same server command. TypeScript methods return promises; Python methods are synchronous; Go methods receive a context and return a value plus an error.

Options shared by the functions

Decoded result types

What an SDK adds over raw commands

• Typed records. Metadata as an object rather than repeated META field value triples.
• Vector marshalling. A number array becomes float32 bytes without you reaching for struct.pack or Float32Array.
• Parsed results. WITHSCORES comes back as a score object rather than a flat array to index by position.
• Structured filters. Pass filter objects or dataclasses instead of assembling repeated protocol tokens. The server remains the authority for field, operator, and value validation.

Important behavior

• NX and XX failures are server errors, not null results.
• MEM.MGET preserves input order and returns null entries for missing IDs.
• MEM.SCAN returns a cursor; continue until it is "0".
• NOTEXT omits text. Metadata and vectors are only present when requested.
• Memory helpers issue individual commands. Use the underlying client for pipelines or transactions.