Building with Meson

Note: this is for early adopters. It has been tested on Linux and macOS, and with Python 3.10-3.12. There is one CI job to keep the build stable. This may have rough edges, please open an issue if you run into a problem.

Developer build

Install build tools: Use one of:

mamba env create -f environment.yml && mamba activate numpy-dev
python -m pip install -r requirements/build_requirements.txt Note: also make sure you have pkg-config and the usual system dependencies for NumPy

Then install spin:

python -m pip install spin

Compile and install: spin build

This builds in the build/ directory, and installs into the build-install directory.

Then run the test suite or a shell via spin:

spin test
spin ipython

Alternatively, to use the package, add it to your PYTHONPATH:

export PYTHONPATH=${PWD}/build/lib64/python3.10/site-packages  # may vary
pytest --pyargs numpy

pip install

Note that pip will use the default build system, which is now Meson. Commands such as pip install . or pip install --no-build-isolation . will work as expected, as does building an sdist or wheel with python -m build, or pip install -e . --no-build-isolation for an editable install. For a more complete developer experience than editable installs, consider using spin instead though (see above).

Workaround for a hiccup on Fedora

Fedora does not distribute openblas.pc. Install the following file in ~/lib/pkgconfig/openblas.pc:

prefix=/usr
includedir=${prefix}/include
libdir=${prefix}/lib64

Name: openblas
Description: OpenBLAS is an optimized BLAS library based on GotoBLAS2 1.13 BSD version
Version: 0.3.19
Cflags: -I${includedir}/openblas
Libs: -L${libdir} -lopenblas

Then build with:

spin build -- -Dpkg_config_path=${HOME}/lib/pkgconfig