Setup

Just like Rat-vcpkg and Rat-Containers, pyRat requires some setup in order to be built.

Hint

Setup and Build section cover the build part of pyRat wheels but do not concern the installation of the wheel itself.

If one already has a pyRat wheel available it does not require anything else than a compatible Python version:

python -m pip install ./pyrat-....whl

Prerequisites

In the end pyRat is yet another C++ project built on top of the Rat C++ libraries.

Building it thus requires the same tools used to build Rat in the first place:

  • Compilation toolchain

  • Dependencies

  • Header files

  • …

See also

pyRat links with Rat-Models (which transitively links with all other Rat libraries and their dependencies) thus requiring the same tooling.

Python wheels can then be built using the same environment.

Install UV

Note

If using Rat-Containers: rocky-cuda-pyrat already ships with UV.

In addition to the prerequisites one will need Python tooling for pyRat.

UV is required to easily manage different Python versions and build multiple wheels.

Important

Since pyRat ships C++ compiled code it is strongly coupled to Python’s C++ ABI which changes with each minor version.

This means that pyRat wheels compiled with Python v3.12.x will only work with Python v3.12.x and no other versions.

UV allows to easily switch Python versions allowing for broader Python coverage.