Setup with pip

Setup with pip#

pyinterp is published on PyPI as binary wheels for the most common platforms, so a plain pip install is usually all you need.

Pre-built wheels are available for:

  • Linux — manylinux_2_28 on x86_64 and aarch64 (glibc ≥ 2.28)

  • macOS — arm64 (Apple Silicon), deployment target 13.4

  • Windows — x86_64

A single wheel per platform serves CPython 3.12 and every later version: it targets the Python stable ABI (abi3) and gets the core of nanobind, the binding library, from the small nanobind-backend package, which pip installs with it. The free-threaded builds have their own wheels: one for 3.15t and later (abi3t), and one for 3.14t.

Install the latest release, or upgrade an existing installation:

pip install -U pyinterp

The xarray extra also installs xarray, needed by pyinterp.backends.xarray, the pyinterp accessor of data arrays and pyinterp.geohash.to_xarray():

pip install -U "pyinterp[xarray]"

The dask extra installs Dask, needed by the pyinterp.dask helpers; the extras can be combined:

pip install -U "pyinterp[xarray,dask]"

Pre-release builds (X.Y.ZrcN, X.Y.Z.devN) are uploaded to TestPyPI; you can try them with:

pip install --pre --index-url https://test.pypi.org/simple/ \
    --extra-index-url https://pypi.org/simple/ pyinterp

If no wheel matches your platform (for example a non-glibc Linux or 32-bit Windows), pip builds the library from source. This requires a C++23 compiler and Boost 1.90 or later; see Requirements. If the build fails, retry with increased verbosity to see the compiler output:

pip install -v pyinterp