Below we assume you have the default Python environment already configured on your computer and you intend to install graspy inside of it. If you want to create and work with Python virtual environments, please follow instructions on venv and virtual environments.

First, make sure you have the latest version of pip (the Python package manager) installed. If you do not, refer to the Pip documentation and install pip first.

Install the released version

Install the current release of graspy with pip:

$ pip install graspy

To upgrade to a newer release use the --upgrade flag:

$ pip install --upgrade graspy

If you do not have permission to install software systemwide, you can install into your user directory using the --user flag:

$ pip install --user graspy

Alternatively, you can manually download graspy from GitHub or PyPI. To install one of these versions, unpack it and run the following from the top-level source directory using the Terminal:

$ pip install .

Python package dependencies

GraSPy requires the following packages:

  • networkx
  • numpy
  • scikit-learn
  • scipy
  • seaborn

Hardware requirements

GraSPy package requires only a standard computer with enough RAM to support the in-memory operations.

OS Requirements

This package is supported for Linux and macOS. However, the package has been tested on the following systems:

  • Linux: N/A
  • macOS: N/A
  • Windows: N/A


GraSPy uses the Python pytest testing package. If you don't already have that package installed, follow the directions on the pytest homepage.