Neo4j Bolt Driver for Python
This repository contains the official Neo4j driver for Python.
Starting with 5.0, the Neo4j Drivers will be moving to a monthly release cadence. A minor version will be released on the last Friday of each month so as to maintain versioning consistency with the core product (Neo4j DBMS) which has also moved to a monthly cadence.
As a policy, patch versions will not be released except on rare occasions. Bug fixes and updates will go into the latest minor version and users should upgrade to that. Driver upgrades within a major version will never contain breaking API changes.
See also: https://neo4j.com/developer/kb/neo4j-supported-versions/
Python 3.13 supported (since driver version 5.26.0).
Python 3.12 supported (since driver version 5.14.0).
Python 3.11 supported (since driver version 5.3.0).
Python 3.10 supported.
Python 3.9 supported.
Python 3.8 supported.
Python 3.7 supported.
Installation
To install the latest stable version, use:
pip install neo4j
Alternative Installation for Better Performance
You may want to have a look at the available Rust extensions for this driver for better performance. The Rust extensions are not installed by default. For more information, see neo4j-rust-ext.
Quick Example
from neo4j import GraphDatabase, RoutingControl
URI = "neo4j://localhost:7687"
AUTH = ("neo4j", "password")
def add_friend(driver, name, friend_name):
driver.execute_query(
"MERGE (a:Person {name: $name}) "
"MERGE (friend:Person {name: $friend_name}) "
"MERGE (a)-[:KNOWS]->(friend)",
name=name, friend_name=friend_name, database_="neo4j",
)
def print_friends(driver, name):
records, _, _ = driver.execute_query(
"MATCH (a:Person)-[:KNOWS]->(friend) WHERE a.name = $name "
"RETURN friend.name ORDER BY friend.name",
name=name, database_="neo4j", routing_=RoutingControl.READ,
)
for record in records:
print(record["friend.name"])
with GraphDatabase.driver(URI, auth=AUTH) as driver:
add_friend(driver, "Arthur", "Guinevere")
add_friend(driver, "Arthur", "Lancelot")
add_friend(driver, "Arthur", "Merlin")
print_friends(driver, "Arthur")
Further Information
The Neo4j Operations Manual (docs on how to run a Neo4j server)
The Neo4j Python Driver Manual (good introduction to this driver)
Python Driver API Documentation (full API documentation for this driver)
Neo4j Cypher Cheat Sheet (summary of Cypher syntax - Neo4j’s graph query language)
Example Project (small web application using this driver)
GraphAcademy (interactive, free online trainings for Neo4j)
Driver Wiki (includes change logs)
Metadata
Release files for neo4j-driver 5.28.8
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| neo4j_driver-5.28.8.tar.gz | 234.2 kB | Without provenance | Details for neo4j_driver-5.28.8.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| neo4j_driver-5.28.8-py3-none-any.whl | Python 3 | none | any | Details for neo4j_driver-5.28.8-py3-none-any.whl |
Total release size: 549.1 kB
Release files / neo4j_driver-5.28.8.tar.gz
| Download URL | neo4j_driver-5.28.8.tar.gz |
|---|---|
| Size | 234.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
45343c698beee8943758d22e35c115f275776f3fdd3dc797b7bac940418eee3a
|
|
BLAKE2b-256 checksum How to use checksums |
2fb240b1dca7569870c89572ab275a836bfa3128f237af2b95e37a028d7f628e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.15
|
Release files / neo4j_driver-5.28.8-py3-none-any.whl
| Download URL | neo4j_driver-5.28.8-py3-none-any.whl |
|---|---|
| Size | 314.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
75e89176e21e901fa0d5e250afa2f0a2e5b7f271f8bbd678bdd2c183feb42611
|
|
BLAKE2b-256 checksum How to use checksums |
436f65abf5f46d9d8b1352a7656a712cf4ce0e7d0d231a478418f8447068ffc0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.15
|
Security for neo4j-driver 5.28.8
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.