Skip to content

CongraphDB Documentation

"SQLite for Graphs" — A high-performance, embedded graph database for Node.js built with Rust

CongraphDB is an embedded, serverless graph database designed for local-first applications. Built with Rust for memory safety and extreme performance, it provides a native Node.js bindings layer via napi-rs.

What's New in v0.1.9

  • Algorithm Streaming API — Stream processing for large-scale graph computations
  • WRITE Clause Support — Direct write operations within Cypher queries
  • Graph Algorithms — Parallel Spectral Clustering, Infomap, and SLPA for community detection
  • Comprehensive Graph Algorithm API — CALL syntax for unified algorithm interface
  • Optimistic Concurrency Control — Serializable snapshot isolation for high-concurrency workloads
  • JavaScript Schema API — Native interfaces for schema management from Node.js

See the Changelog for full release notes.

Quick Start

npm install congraphdb

const { Database } = require('congraphdb');

// Create or open a database
const db = new Database('./my-graph.cgraph');
db.init();

// Create a connection
const conn = db.createConnection();

// Define schema
await conn.query(`
  CREATE NODE TABLE User(name STRING, age INT64, PRIMARY KEY (name))
`);

await conn.query(`
  CREATE REL TABLE Knows(FROM User TO User, since INT64)
`);

// Insert data
await conn.query(`
  CREATE (alice:User {name: 'Alice', age: 30})
         -[:Knows {since: 2020}]->
         (bob:User {name: 'Bob', age: 25})
`);

// Query
const result = await conn.query(`
  MATCH (u:User)-[k:Knows]->(f:User)
  WHERE u.name = 'Alice'
  RETURN u.name, k.since, f.name
`);

// Get all results
const rows = result.getAll();
for (const row of rows) {
  console.log(row);
}

db.close();

Features

  • :rocket: Embedded & Serverless — No separate database process. Store data locally in a single .cgraph file.
  • :zap: High Performance — Rust-powered with memory-mapped I/O, columnar storage, and vectorized execution.
  • :mag: Cypher Query Language — Support for Cypher graph query syntax.
  • :robot: AI-Ready — Built-in HNSW index for vector similarity search on embeddings.
  • :package: Easy Distribution — Prebuilt binaries for Windows, macOS, and Linux via npm.
  • :moneybag: ACID Transactions — Serializable transactions with write-ahead logging.
  • :lock: Memory Safe — Built with Rust — no segfaults, no memory leaks.

Resources

Status

CongraphDB is currently in alpha development (v0.1.9). The core storage engine, transaction system, and a robust Cypher/JavaScript query interface are implemented, with features like graph algorithms, optimistic concurrency control, WRITE clause support, and streaming API fully supported.

License

MIT License — see LICENSE file for details.