Installation

To install the latest version of the Python client, run:

pip install graphdatascience

Requirements

  • Check that client supports your Python environments.

    GDS Python Client Python environment

    2.0

    >= 3.10, < 3.15

    1.22

    >= 3.10, < 3.15

  • If you are running the GDS library locally or on a self-managed server, the Python client must support the GDS version. Aura Graph Analytics sessions always run on the latest GDS version.

    GDS Python Client GDS version

    2.0

    >= 2.13, < 2.28, < 2026.9

    1.22

    >= 2.6, < 2.28, < 2026.6

  • If the Neo4j Python driver is already installed on your system, make sure its version is compatible with the GDS Python client.

    GDS Python Client Neo4j Python Driver version

    2.0

    >= 5.26.0, < 7.0.0

    1.22

    >= 4.4.12, < 7.0.0

Optional dependencies

NetworkX graphs

Install the optional networkx dependency if you plan to load NetworkX graphs:

pip install "graphdatascience[networkx]"

OGB dataset

Install the optional ogb dependency if you plan to use the OGB dataset:

pip install "graphdatascience[ogb]"

Neo4j Python driver speedup extension

The graphdatascience library uses the Neo4j Python driver under the hood to communicate with Neo4j DBMSs. To use the Rust extension for better performance, you must install the optional rust_ext dependency:

pip install "graphdatascience[rust_ext]"

Depending on your system, you may need additional installation steps. See the Rust extension README for more details.