Project Links

Meta

Author: Jim Kitchen, Michel Pelletier, suitesparse-graphblas contributors

Maintainer: Erik Welch, Jim Kitchen, Michel Pelletier, Adam Lugowski

Requires Python: >=3.11

Classifiers

Development Status

5 - Production/Stable

Environment

WebAssembly :: Emscripten

Operating System

MacOS :: MacOS X
POSIX :: Linux
Microsoft :: Windows

Programming Language

Python
Python :: 3
Python :: 3.11
Python :: 3.12
Python :: 3.13
Python :: 3.14
Python :: 3.15
Python :: 3 :: Only
Python :: Free Threading :: 2 - Beta

Intended Audience

Developers
Other Audience
Science/Research

Topic

Scientific/Engineering
Scientific/Engineering :: Information Analysis
Scientific/Engineering :: Mathematics
Software Development :: Libraries :: Python Modules

python-suitesparse-graphblas

Python CFFI Binding around SuiteSparse:GraphBLAS

This is a base package that exposes only the low level CFFI API bindings and symbols. This package is shared by the syntax bindings pygraphblas and python-graphblas.

Installation from pre-built wheels

Pre-built wheels for common platforms are available from PyPI and conda. These bundle a compiled copy of SuiteSparse:GraphBLAS.

pip install suitesparse-graphblas

conda install -c conda-forge python-suitesparse-graphblas

In the browser (Pyodide)

PyPI also has WebAssembly wheels for Pyodide 314 (Python 3.14) and 0.29.4 or later (Python 3.13), the pyemscripten platform of PEP 783. So, in Pyodide or JupyterLite (jupyterlite-pyodide-kernel 0.8 uses Pyodide 314):

import micropip
await micropip.install("suitesparse-graphblas")

Older versions of Pyodide don't recognize these wheels: micropip says it can't find a pure Python 3 wheel. GraphBLAS runs single-threaded in Pyodide, which has no threads (so no OpenMP).

Installation from source

If you wish to link against your own copy of SuiteSparse:GraphBLAS you may build from source.

Specify the location of your SuiteSparse:GraphBLAS installation in the GraphBLAS_ROOT environment variable then use the standard pip build from source mechanism. This location must contain include/GraphBLAS.h and lib/.

export GraphBLAS_ROOT="/path/to/graphblas"
pip install suitesparse-graphblas-*.tar.gz

You may also have to appropriately set LD_LIBRARY_PATH to find libgraphblas at runtime.

For example, to use Homebrew's SuiteSparse:GraphBLAS on macOS, with the sdist from PyPI, and with all dependencies using wheels:

GraphBLAS_ROOT="$(brew --prefix suitesparse)" pip install --no-binary suitesparse-graphblas suitesparse-graphblas

10.5.2.0 Oct 28, 2026

10.5.1.1 Oct 17, 2026

10.5.1.0 Sep 17, 2026

10.5.0.0 Aug 25, 2026

10.4.1.0 Aug 11, 2026

10.4.0.0 Aug 09, 2026

10.3.1.0 Mar 27, 2026

10.1.1.0 Sep 15, 2025

10.0.1.1 Mar 17, 2025

5.1.10.1 Oct 31, 2021

5.1.10.0 Oct 31, 2021

Wheel compatibility matrix

Platform	CPython 3.11	CPython 3.12	CPython 3.13	CPython 3.14	CPython 3.15	CPython (additional flags: t) 3.14	CPython (additional flags: t) 3.15	PyPy 3.11 (pp80)
macosx_14_0_x86_64
macosx_15_0_arm64
manylinux_2_27_aarch64
manylinux_2_27_x86_64
manylinux_2_28_aarch64
manylinux_2_28_x86_64
musllinux_1_2_x86_64
pyemscripten_2025_0_wasm32
pyemscripten_2026_0_wasm32
win_amd64