Fast, explainable, multi-tenant AI memory with single-call extraction and citation-backed claims.
-blue.svg){kind=icon}
Whimsync is a stateful, explainable memory and context layer designed for AI assistants, coding agents, and multi-tenant applications.
- Fast ingestion, single LLM understanding call: Ingest messages instantly and perform single-call extraction of claims, relationship edges, entity quintuplets, and mutations.
- Accurate relationship classification: Build structured relationship graphs (
UPDATES,EXTENDS,SUPPORTS,CONTRADICTS,DERIVES,MENTIONS) between claims and entities. - Real storage tiering (Hot / Warm / Cold): Query active memory inline from Postgres (
Hot), filter superseded/expired claims cleanly (Warm), and archive audit logs to object storage (Cold). - Explainable, citation-backed memory: Every extracted claim links directly to immutable character offsets in raw source
episodesvia authoritativeevidencerows. - Multi-tenant (personal + enterprise) support from day one: Enforce a unified org-and-namespace access control contract (
Every account is an org).
flowchart LR
A[Raw message] --> B[Store raw episode]
B --> C[Return 200 OK]
B --> D[BG Worker: single LLM call]
D --> E[Claims + edges + quintuplets + mutations]
E --> F[Embed claims]
F --> G[Store: status = pending_review]
G --> H[Mutation evaluation vs prior claims]
H --> I[Atomic flip: active / superseded]
- Language & Runtime: TypeScript on Bun
- API HTTP Layer: Hono
- Frontend Dashboard: Next.js (React)
- Primary Database: PostgreSQL +
pgvector - Queue & Worker Engine: Redis + BullMQ
- Cold Storage: MinIO (local) / Cloudflare R2 or AWS S3 (cloud)
Ensure you have Bun and Docker installed.
Start local PostgreSQL (pgvector), Redis, and MinIO containers in the background:
docker compose up -dbun installRun the Hono API server (apps/api) in development mode with hot reload:
bun run dev:apiThe API server will run locally at http://localhost:3000.
- WHIMSYNC.md: Canonical v1 Master Architectural Blueprint.
- PROGRESS.md: Development Roadmap & Milestone Tracker.
- .agents/AGENTS.md: Agent Commandments & Coding Standards.