Installation

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

pip install graphdatascience

Compatibility matrix

The Python client version to install depends on the server-side installation of the GDS library, the Python environment, and the Neo4j Python Driver.

Python Client GDS version Python version Neo4j Python Driver version

1.23

>= 2.6, < 2.28, < 2026.6

>= 3.10, < 3.15

>= 4.4.12, < 7.0.0

1.22

>= 2.6, < 2.28, < 2026.6

>= 3.10, < 3.15

>= 4.4.12, < 7.0.0

1.21

>= 2.6, < 2.28, < 2026.4

>= 3.10, < 3.15

>= 4.4.12, < 7.0.0

1.20

>= 2.6, < 2.27

>= 3.10, < 3.15

>= 4.4.12, < 7.0.0

1.19

>= 2.6, < 2.25

>= 3.10, < 3.14

>= 4.4.12, < 7.0.0

1.18

>= 2.6, < 2.24

>= 3.10, < 3.14

>= 4.4.12, < 7.0.0

1.17

>= 2.6, < 2.21

>= 3.9, < 3.13

>= 4.4.12, < 6.0.0

1.16

>= 2.6, < 2.19

1.15

>= 2.6, < 2.18

1.14

>= 2.6, < 2.14

1.13

>= 2.6, < 2.14

1.12

>= 2.6, < 2.11

>= 3.8, < 3.13

1.11

>= 2.6, < 2.10

1.10

>= 2.4, < 2.7

>= 4.4.2, < 6.0.0

1.9

>= 2.4, < 2.6

>= 3.8, < 3.12

1.8

1.7

>= 2.3, < 2.5

>= 3.7, < 3.12

1.6

>= 2.2, < 2.4

>= 3.7, < 3.11

1.5

2.2

1.4

>= 2.1, < 2.3

1.3

2.1

>= 3.7, < 3.10

>= 4.4.2, < 5.0.0

1.2.0

>= 2.0, < 2.2

>= 3.6, < 3.10

1.1.0

1.0.0

2.0

Optional dependencies

NetworkX graphs

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

pip install "graphdatascience[networkx]"

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.

OGB dataset

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

pip install "graphdatascience[ogb]"