The client of GraphScope is distributed as a Python package. It manages a set of backend engines and the coordinator via containers.

In practice, GraphScope runs on clusters managed by Kubernetes. For quickly getting started, we set up a local Kubernetes cluster and take advantage of pre-built Docker images as follows.

To run GraphScope on your local computer, the following dependencies or tools are required.

  • Docker

  • Python 3.8 (with pip)

  • Local Kubernetes cluster set-up tool (e.g. Kind)

On Windows and macOS, you can follow the official guides to install them and enable Kubernetes in Docker. For Ubuntu/CentOS Linux distributions, we provide a script to install the above dependencies and prepare the environment. Alternatively, you may want to install WSL2 on Windows to use the script.

# run the environment preparing script.

Then the package can be easily installed using pip:

pip install graphscope

Or you can install the package from source

pip install 'git+'

If you have the .wheel package, you can install the package using

pip install graphscope-0.1.macosx-10.14-x86_64.tar.gz

To build the package from source code, please download the latest version from our repo with git:

git clone
git submodule update --init
cd python

Then install the package from source with the following command:

pip install -U -r requirements.txt
python install