安装

要安装最新部署的 Python 客户端版本，请运行

pip install graphdatascience

1. 系统要求

GDS Python 客户端依赖于 Python、Neo4j Python Driver，以及服务器端已安装的 GDS 库（参见 GDS 库的安装说明）。Python 客户端支持以下三个组件的相应版本

Python 客户端 GDS 版本 Python 版本 Neo4j Python Driver 版本

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

2. 版本管理

为了让 Python 客户端用户更方便，我们的目标是运行 pip install --upgrade graphdatascience 后能够获得一个支持所有当前支持的 GDS 库版本（从 2.0 开始）的客户端版本。

Python 客户端遵循 语义化版本控制。

Python 客户端的版本与 GDS 库的版本并不一一对应。例如，Python 客户端版本 X.Y 并不一定与 GDS 库版本 X.Y 兼容。相反，Python 客户端可能独立发布，需要查阅上文的 系统要求 来判断客户端版本是否与服务器上的 GDS 库兼容。

3. 可选依赖

graphdatascience 库的某些功能需要额外的依赖。这些依赖默认不安装，因为

  • 它们可能体积较大，而所提供的功能并非每位库用户都需要，或者

  • 它们可能需要除 pip install 之外的额外系统特定安装步骤。

本节概述了如何安装这些额外依赖以及它们提供的功能。

3.1. Neo4j Python 驱动加速扩展

graphdatascience 库在底层使用 Neo4j Python Driver 与 Neo4j DBMS 进行通信。要启用由 Neo4j Python 驱动 Rust 扩展 提供的驱动加速，需要安装可选的 rust_ext 依赖

pip install graphdatascience[rust_ext]

虽然不太可能，但根据你的系统，可能需要额外的步骤。如果出现这种情况，这些步骤已在 Neo4j Python 驱动 Rust 扩展 README 中说明。

3.2. OGB 数据集加载

要使用 graphdatascience 的 便捷 OGB 数据集加载功能，需要安装可选的 ogb 依赖

pip install graphdatascience[ogb]

3.3. NetworkX 图加载

要使用 graphdatascience 的 便捷 NetworkX 图加载功能，需要安装可选的 networkx 依赖

pip install graphdatascience[networkx]