NervusDB v2

Rust-embedded, crash-safe property graph database with Cypher subset – like SQLite for graphs.

A production-ready embedded graph database succeeding KùzuDB. Features: single-writer + snapshot readers, CSR storage, crash-safe WAL, and a curated Cypher subset for real-world workloads.

Quick Start

Rust

use nervusdb_v2::Db;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    // Open or create database
    let db = Db::open_paths(["/tmp/demo.ndb"]).unwrap();

    // Write data
    db.execute(
        "CREATE (a {name: 'Alice'})-[:1 {weight: 0.5}]->(b {name: 'Bob'})",
        None,
    ).unwrap();

    // Query data
    let results = db.query(
        "MATCH (a)-[:1]->(b) WHERE a.name = 'Alice' RETURN a, b LIMIT 10",
        None,
    ).unwrap();

    for record in results {
        println!("{:?}", record);
    }

    Ok(())
}

CLI

# Create database and write data
nervusdb-cli v2 write --db /tmp/demo --cypher "CREATE (a {name: 'Alice'})-[:1]->(b {name: 'Bob'})"

# Query data (NDJSON output)
nervusdb-cli v2 query --db /tmp/demo --cypher "MATCH (a)-[:1]->(b) RETURN a, b"

Supported Cypher Subset

See docs/reference/cypher_support.md for full details.

Architecture

• Storage: Two-file format (.ndb page store + .wal redo log)
• Transaction: Single Writer + Snapshot Readers
• Layout: MemTable (delta) + Immutable CSR segments + Compaction
• API: nervusdb-v2 crate with GraphStore trait

Why NervusDB?

NervusDB is positioned as the spiritual successor to KùzuDB for the Rust ecosystem, with a focus on production-hardened storage and minimal dependencies.

Installation

From Source

cargo install nervusdb-cli

From Crates.io

cargo add nervusdb-v2

From GitHub Releases

Download prebuilt binaries from Releases.

Development

# Format check
cargo fmt --all -- --check

# Lint
cargo clippy --workspace --all-targets -- -W warnings

# Tests
cargo test --workspace

# Benchmark
./scripts/v2_bench.sh

Resources

• User Guide
• CLI Reference
• API Documentation
• Design Documents

License

AGPL-3.0