Home

Minigraf Wiki

Welcome to the Minigraf wiki. Use the sidebar or the links below to navigate.

Tutorials

A step-by-step introduction to Minigraf's Datalog dialect, driven by a real-world e-commerce storyline. Each section builds on the last.

• Setup — Install Minigraf and load the Corestore dataset
• 1. Basic transact + query
• 2. :as-of — time travel by transaction time
• 3. :valid-at and :any-valid-time — time travel by valid time
• 4. Recursive rules
• 5. Negation — not and not-join
• 6. Aggregates, :with, and window functions
• 7. Expression clauses and predicates
• 8. Prepared queries with bind slots
• 9. Disjunction — or and or-join
• 10. User-defined functions
• 11. Marketplace — multi-seller queries

Cookbook

Problem-oriented recipes for common Minigraf patterns. Each recipe is self-contained: a one-line problem statement, the Datalog (or Rust API where needed), and brief notes.

• Graph Traversal Patterns — neighbors, transitive closure, reachability, leaf detection, degree, property graphs, edge reification
• Audit and Time-Travel Idioms — point-in-time, time-interval, time-point lookup, and time-interval lookup across both time axes
• Bitemporal Modeling — bounded facts, retroactive corrections, future-dating, overlapping periods, lifecycle end
• Application Workflow Patterns — agent memory, offline-first state, task DAGs, GraphRAG, multi-tenant fleet patterns

Pages

• Datalog Reference — Complete syntax reference: facts, queries, recursive rules, bi-temporal operators, value types, and the EDN command syntax
• Architecture — Module structure, EAV data model, file format (v7), WAL layout, storage internals, and cross-platform workspace crates
• Use Cases — Detailed guides for the three primary deployment targets: AI agents, mobile apps, and WASM/browser
• Comparison — Side-by-side comparison with XTDB, Cozo, Datomic, GraphLite, petgraph, IndraDB, SurrealDB, and time-series databases; temporal vs. time-series explainer
• Learning Resources — Curated links for Datalog, temporal databases, and SQLite internals
• Performance Tuning — cost model, configuration knobs, query patterns, and benchmark reference

Packages

Platform	Package
Rust	crates.io/crates/minigraf
Browser WASM	@minigraf/browser on npm
WASI (Node.js)	@minigraf/wasi on npm
Node.js	minigraf on npm
Python	minigraf on PyPI
Java/JVM	minigraf-jvm on Maven Central
Android, iOS, C, WASI binary	GitHub Releases

Quick links

• Repository
• README
• ROADMAP.md
• BENCHMARKS.md
• PHILOSOPHY.md
• CONTRIBUTING.md
• Demo: Temporal Reasoning — Working AI agent using Minigraf's bi-temporal model