Skip to main content

DB API 2.0 driver for the Neo4j graph database.

Project description

Implements the Python DB API 2.0 for Neo4j, compatible with pyth 2.6, 2.7, 3.2 and 3.3.


pip install neo4jdb

Minimum viable snippet

import neo4j

connection = neo4j.connect("http://localhost:7474")

cursor = connection.cursor()
for name, age in cursor.execute("MATCH (n:User) RETURN, n.age"):
    print name, age


The library generally adheres to the DB API, please refer to the documentation for the DB API for detailed usage.

# Write statements
cursor.execute("CREATE (n:User {name:'Stevie Brook'}")
connection.commit() # Or connection.rollback()

# With positional parameters
cursor.execute("CREATE (n:User {name:{0}})", "Bob")

# With named parameters
cursor.execute("CREATE (n:User {name:{name}})", name="Bob")

Building & Testing

Neo4jDB uses paver as its build system. To install paver:

pip install paver

Then you can build Neo4jDB with:

paver build

And install it with:

paver install

Running tests requires a Neo4j server running on localhost. Paver can handle this for you:

paver start_server
paver nosetests
paver stop_server

Incompliance with the spec


The library delegates to Neo4j for parameter substitution, which means it does not use any of the standard parameter substitution types defined in the spec.

Instead it uses curly brackets with named and/or positional parameters:

{0} or {identifier}

Type system

Because the wire format for Neo4j is JSON, the library does not support the date or binary value types. This may change in the future as the wire format for Neo4j evolves.

In a similar vein, because Neo4j is a schema-optional database, it may return arbitrary types in each cell in the result table. As such, the description of the result table always marks each column type as neo4j.MIXED.

Project details

Release history Release notifications

History Node


History Node


History Node


History Node


History Node


History Node


This version
History Node


History Node


History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
neo4jdb-0.0.3.tar.gz (6.4 kB) Copy SHA256 hash SHA256 Source None Mar 22, 2014

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page