graphdblite 0.1.2

Embedded graph database with Cypher support

graphdblite

Embedded graph database with Cypher query support, backed by SQLite.

• Embedded. Single file, no server, no configuration — like SQLite.
• Graph-first. Cypher queries, adjacency-list storage, graph-aware query planning.
• Multi-process safe. Multiple processes can read and write concurrently. ACID via SQLite.
• openCypher TCK conformance: 100% (3895/3895 scenarios).

Install

pip install graphdblite

Pre-built wheels are published for Linux (glibc + musl, x86_64 + aarch64), macOS (x86_64 + aarch64), and Windows (x86_64).

Quick start

from graphdblite import Database

db = Database("my.db")

db.execute("CREATE (a:Person {name: 'Alice'})-[:KNOWS]->(b:Person {name: 'Bob'})")

results = db.query("MATCH (a)-[:KNOWS]->(b) RETURN a.name, b.name")
for row in results:
    print(row["a.name"], "→", row["b.name"])

Cypher coverage

MATCH (a:Person)-[:KNOWS]->(b:Person) WHERE a.age > 25 RETURN a.name, b.name
MATCH (a)-[:KNOWS*1..3]->(b) RETURN b                  // variable-length paths
MATCH p = shortestPath((a)-[:KNOWS*]->(b)) RETURN p    // shortest path
MERGE (n:Person {name: 'Alice'}) ON CREATE SET n.created = true

Clauses, expressions, 50+ functions, full reference: Cypher reference.

Documentation

• Python API: https://github.com/ds7n/graphdblite/blob/main/docs/python.md
• Architecture: https://github.com/ds7n/graphdblite/blob/main/docs/architecture.md
• Repository: https://github.com/ds7n/graphdblite
• Issues: https://github.com/ds7n/graphdblite/issues

License

MIT