Docs: drivine.org, for Python, TypeScript, and Kotlin & Java.
▶ Watch Drivine in four and a half minutes: graph RAG on any database (4:26, with captions)
A graph database client for Python, supporting Neo4j, Memgraph, FalkorDB, Oracle (SQL/PGQ), Postgres and SQLite as graph stores, plus Amazon Neptune through the low-level API. Async first, with a sync API written from it, typed, and fast: one statement per round trip, no session cache, no lazy loading. It gives you two ways to work with a graph:
- PersistenceManager: a low-level API where you write the queries yourself.
- Object manager (
StatelessGraphObjectManager): a high-level API that maps Pydantic models, with a query DSL whose typed references are stubs generated from your models.
Cypher you write runs on Postgres, Oracle and SQLite too, compiled to SQL. 0.8 is an alpha release: the API may still change.
pip install "drivine[neo4j]" # Neo4j, Memgraph, Neptune
pip install "drivine[falkordb]" # FalkorDB
pip install "drivine[oracle]" # Oracle 23.9 or later, through python-oracledb in thin mode
pip install "drivine[postgres]" # Postgres 14 or later, through psycopg 3
pip install "drivine[sqlite]" # SQLite, a graph in a file, through apsw and the SQLite it bundles
pip install "drivine[neo4j,compiler]" # full-text search (load_matching) on a graph engine
Python 3.11 or newer. A SQLite store and what a transaction gives there are in Connecting.
The SQL stores' extras also install drivine-cypher-compiler, the shared Cypher compiler, a native wheel for Linux with
glibc (x86-64 and arm64), macOS on Apple Silicon and Windows x64. On an Intel Mac or musl Linux (Alpine) there is no
wheel, so a SQL store's extra doesn't install there; the graph engines' do. Full-text search (load_matching) is the
compiler's on every store: on a graph engine, add the compiler extra beside its own to search by text
(pip install "drivine[neo4j,compiler]"). See
Cypher on a relational database.
Describe the database in the environment (DATABASE_TYPE=NEO4J, DATABASE_HOST=localhost, DATABASE_USER,
DATABASE_PASSWORD), declare a fragment for a node, then save and load it, each in one statement:
import asyncio
from typing import Annotated
from drivine import DrivineAssembly, NodeFragment, NodeId, refs
class Person(NodeFragment, labels=["Person"]):
uuid: Annotated[str, NodeId()]
name: str
async def main() -> None:
async with DrivineAssembly() as drivine:
gom = drivine.graph_object_manager()
await gom.save(Person(uuid="p1", name="Ada"))
print(await gom.load_all(Person, where=refs(Person).name.eq("Ada")))
asyncio.run(main())Views that compose fragments and relationships, queries, transactions, schema and the sync API are in the full quick start and the pages after it.
- drivine.org/py: the full documentation.
- docs/ on GitHub: the same pages, as Markdown.
- RELEASING.md: how a release is made.
- Building and AGENTS.md: building and testing, and notes for contributors.
- Drivine and drivine4j are its TypeScript and Kotlin & Java twins, sharing its storage format.
Apache 2.0.
