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 can leverage minikube to 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

  • minikube

  • Python 3.8 (with pip)

On Windows and macOS, you can follow the official guides to install them. For 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 scripts.

# 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