Folders and files

Name		Name	Last commit message	Last commit date
Latest commit History 1,712 Commits
.github		.github
benchkit		benchkit
bin		bin
docs		docs
src/neo4j		src/neo4j
testkit		testkit
testkitbackend		testkitbackend
tests		tests
.dockerignore		.dockerignore
.editorconfig		.editorconfig
.gitattributes		.gitattributes
.gitignore		.gitignore
.gitmodules		.gitmodules
.pre-commit-config.yaml		.pre-commit-config.yaml
.snyk		.snyk
CHANGELOG.md		CHANGELOG.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE.APACHE2.txt		LICENSE.APACHE2.txt
LICENSE.PYTHON.txt		LICENSE.PYTHON.txt
LICENSE.txt		LICENSE.txt
MANIFEST.in		MANIFEST.in
NOTICE.txt		NOTICE.txt
README.rst		README.rst
TESTING.md		TESTING.md
pyproject.toml		pyproject.toml
tox.ini		tox.ini

Repository files navigation

Neo4j Bolt Driver for Python

This repository contains the official Neo4j driver for Python.

Driver upgrades within a major version will never contain breaking API changes.

For version compatibility with Neo4j server, please refer to:https://neo4j.com/developer/kb/neo4j-supported-versions/

Python 3.13 supported.
Python 3.12 supported.
Python 3.11 supported.
Python 3.10 supported.

Installation

To install the latest stable version, use:

pip install neo4j

Note

neo4j-driver is the old name for this package. It is now deprecated andand will receive no further updates starting with 6.0.0. Make sure toinstallneo4j as shown above.

Alternative Installation for Better Performance

You may want to have a look at the available Rust extensions for this driverfor better performance. The Rust extensions are not installed by default. Formore information, seeneo4j-rust-ext.

Quick Example

fromneo4jimportGraphDatabase,RoutingControlURI="neo4j://localhost:7687"AUTH= ("neo4j","password")defadd_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",    )defprint_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,    )forrecordinrecords:print(record["friend.name"])withGraphDatabase.driver(URI,auth=AUTH)asdriver: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)
Neo4j Migration Guide