GitHub - project-minigraf/minigraf: Embedded graph memory for AI agents, mobile apps, and the browser.

Think SQLite, but for connected data with full history. Try it in your browser — no install needed → Watch time travel in the visualizer → Scrub transaction time and valid time, and see the graph change. Vision Minigraf is a single-file embedded graph database that lets you: ✅ Query relationships with Datalog - Recursive rules, natural graph traversal ✅ Time travel through history - Bi-temporal queries (transaction time + valid time) ✅ Window functions - sum/count/min/max/avg/rank/row-number :over (partition-by … :order-by …) in :find clauses ✅ Prepared statements - Parse + plan once with $slot bind tokens, execute thousands of times ✅ Embed anywhere - Native, WASM, mobile, IoT - one .graph file ✅ Zero configuration - Just Minigraf::open("data.graph") and you're done Status: See ROADMAP.md for planned work and current direction. Why Datalog? Datalog is fundamentally better for graphs than SQL-like languages: Recursive by design - Multi-hop traversals are natural, not an afterthought Simpler to implement - Smaller spec = more reliable, faster to production Perfect for temporal - Time is just another dimension in relations Proven at scale - 40+ years of research, production use (Datomic, XTDB) Graph-native - Facts (Entity-Attribute-Value) are literally edges LLM-friendly - The small, uniform grammar ([?e :attr ?v] patterns, no JOIN variants, no subquery nesting) is easy for AI coding assistants to generate correctly from a few examples; the entire language fits in a system prompt Installation [dependencies] minigraf = "2.0.2" Or via cargo: cargo add minigraf Requires Rust 1.89 or newer (the minimum supported Rust version, set in Cargo.toml).

Write or retract each value of a multi-valued attribute in its own call. The fix changes the file format and ships in v3.0.0. v2.x gets data-integrity and security fixes for 12 months after v3.0.0 ships. See the support policy. Quick Start use minigraf::{Minigraf, OpenOptions}; // Open or create a file-backed database let db = OpenOptions::new().path("myapp.graph").open()?; // Add facts db.execute(r#"(transact [[:alice :person/name "Alice"] [:alice :person/age 30] [:alice :friend :bob] [:bob :person/name "Bob"]])"#)?; // Query with Datalog let results = db.execute(r#" (query [:find ?friend-name :where [:alice :friend ?friend] [?friend :person/name ?friend-name]]) "#)?; // Explicit transaction — all-or-nothing let mut tx = db.begin_write()?; tx.execute(r#"(transact [[:alice :person/age 31]])"#)?; tx.commit()?; // Time travel — query as of past transaction counter db.execute("(query [:find ?age :as-of 1 :where [:alice :person/age ?age]])")?; // Recursive rule — transitive reachability db.execute(r#"(rule [(reachable ?a ?b) [?a :friend ?b]]) (rule [(reachable ?a ?b) [?a :friend ?m] (reachable ?m ?b)])"#)?; // Prepared statement — parse + plan once, execute many times use minigraf::BindValue; let pq = db.prepare("(query [:find ?name :as-of $tx :where [$entity :person/name ?name]])")?; let r1 = pq.execute(&[("tx", BindValue::TxCount(1)), ("entity", BindValue::Entity(alice_id))])?; let r2 = pq.execute(&[("tx", BindValue::TxCount(2)), ("entity", BindValue::Entity(bob_id))])?; cargo run # interactive Datalog REPL cargo test # run 1212 tests cargo run < demos/demo_recursive.txt # recursive rules demo Demo See a working implementation of temporal reasoning with Minigraf at github.com/adityamukho/temporal_reasoning — an AI agent that uses Minigraf's bi-temporal model to store, correct, and audit beliefs. The time travel visualizer runs Minigraf in your browser and draws its history. Step through transactions, move the valid-time cursor, and see each fact version on a bitemporal map. It opens .graph files too. For example, see a salary that was recorded wrong and then corrected.