Py2neo is a comprehensive toolkit for working with Neo4j from within Python applications or from the command line.
Fetching latest commit…
Cannot retrieve the latest commit at this time.


Py2neo v4


Py2neo is a client library and toolkit for working with Neo4j from within Python applications and from the command line. The library wraps the official driver, adding support for HTTP, a higher level API, an OGM, admin tools, an interactive console, a Cypher lexer for Pygments and many other bells and whistles. Unlike previous releases, Py2neo v4 no longer requires HTTP and can work entirely through Bolt.


PyPI version Build Status Coverage Status

To install the latest stable version of py2neo, simply use pip:

$ pip install py2neo

Or to install the latest bleeding edge code directly from GitHub, use:

$ pip install git+

Note that code installed directly from GitHub is likely to be unstable. Your mileage may vary.


Python versions Neo4j versions

The following versions of Python and Neo4j are supported:

  • Python 2.7 / 3.4 / 3.5 / 3.6 / 3.7-dev / PyPy
  • Neo4j 3.0 / 3.1 / 3.2 / 3.3 / 3.4 (the latest point release of each version is recommended)

Note also that Py2neo is developed and tested under Linux using standard CPython distributions. While other operating systems and Python distributions may work, support for these is not available.


For more information, read the handbook.

To get in touch, contact me via email or on Twitter.