@equationalapplications/react-llm-wiki

In-browser LLM memory for React web apps. Bring your own SQLite adapter (e.g., sql.js WebAssembly) for a complete, zero-server RAG experience.

📖 Docs · GitHub · ScopeLab · WikiDemo · Changelog · Issues

Inspired by Andrej Karpathy's LLM Wiki memory spec.

📖 Documentation: equationalapplications.github.io/expo-llm-wiki/packages/react. Start with the React quickstart, or see the hooks reference.

Features

• Runs in the browser. SQLite compiled to WebAssembly (sql.js) means no server is needed. Any other SQLiteAdapter works too.
• Reactive reads. useMemoryRead refetches when the entity, query or options change.
• Mutation hooks. useWikiWrite, useWikiIngest, useWikiForget, useWikiMaintenance, useWikiExport and more.
• GraphRAG. useWikiTraversal plus formatGraphContext for prompt-ready graph context, and useOntologyManifest / useSetOntologyManifest for seeded ontologies.
• Live job status with useEntityStatus.
• Everything in core, re-exported in full.

Installation

npm install @equationalapplications/react-llm-wiki sql.js

Peer dependency: react >=17. Requires Node.js 20 or later for tooling and server-side use.

Quick look

import { useMemoryRead } from '@equationalapplications/react-llm-wiki';

// Inside a <WikiProvider wiki={wiki}> tree:
function Preferences() {
  const { data, isPending, error } = useMemoryRead('user-123', 'preferences');
  if (isPending) return <p>Loading…</p>;
  if (error) return <p>{error.message}</p>;
  return <ul>{data?.facts.map((f) => <li key={f.id}>{f.title}</li>)}</ul>;
}

The React quickstart shows the sql.js adapter and WikiProvider setup. Not using React? See vanilla JavaScript.

Monorepo Ecosystem

License

MIT

Made with ❤️ by Equational Applications LLC. https://equationalapplications.com/