clude-local

clude-local

Local-first providers for Clude — SQLite storage + GTE-Small embeddings. Fully offline, zero API keys.

Install

npm install clude-local

Usage

import { SqliteProvider, GteSmallEmbeddings } from 'clude-local';

const storage = new SqliteProvider('./my-agent-memory.db');
const embeddings = new GteSmallEmbeddings(); // ~30MB download on first run

// Use with clude-brain
import { CludeEngine } from 'clude-brain';

const engine = new CludeEngine({ storage, embeddings });
await engine.store({ content: "User prefers dark mode", type: "semantic" });
const memories = await engine.recall({ query: "theme preferences" });

Why local?

• Zero API keys — no Supabase, no Voyage, no nothing
• Fully offline — works on a plane, in a bunker, wherever
• Fast — no network latency, sub-millisecond reads
• Private — your data never leaves your machine
• Free — no usage costs, no rate limits

Providers

SqliteProvider

SQLite-backed storage with in-memory vector index. Implements StorageProvider from clude-brain.

GteSmallEmbeddings

Local ONNX runtime using Xenova/gte-small (384 dimensions). Downloads ~30MB model on first run, fully offline after.

Part of the Clude ecosystem

• clude-brain — Core memory engine
• clude-cloud — Supabase + Voyage providers
• clude-local — This package. SQLite + local embeddings.
• clude — Python SDK

License

MIT — Pixl64 LLP