安装

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

pip install graphdatascience

1. 系统要求

GDS Python 客户端依赖于 Python、Neo4j Python 驱动程序以及 GDS 库的服务器端安装（请参阅GDS 库安装说明）。Python 客户端支持以下版本的其他三个组件

Python 客户端 GDS 版本 Python 版本 Neo4j Python 驱动程序版本

1.15

>= 2.6, < 2.18

>= 3.9, < 3.13

>= 4.4.12, < 6.0.0

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 驱动程序与 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]