Installation

From PyPI

When binary wheels are available:

pip install xls-python

From Source

Building from source requires:

  • Python ≥ 3.10

  • A C++20-capable compiler (GCC ≥ 11 or Clang ≥ 14)

  • Meson ≥ 1.0 and Ninja

git clone https://github.com/calad0i/pyxls.git
cd pyxls
pip install .

Note

for editable installs, use pip install --no-build-isolation -e ., otherwise meson import hooks won’t work correctly.

The build system (meson-python) compiles the C++ nanobind extension and links it against the prebuilt libxls.so bundled in the repository. No separate XLS build is required.

Runtime Requirements

  • Python ≥ 3.10

  • NumPy ≥ 2

Optional: DSLX Standard Library

Some DSLX functionality requires pointing to the XLS standard library path via the dslx_stdlib_path argument. The standard library is not bundled; refer to the XLS project for how to obtain it.