Install Cutlass.py

Install from PyPI

Cutlass.py is currently pre-release software, so include --pre:

python -m pip install --pre cutlass-py

Then import the module as cutlass:

import cutlass

Install from source

Source builds require Rust and maturin:

cd crates/cutlass-py
python3 -m venv .venv
source .venv/bin/activate
pip install maturin numpy
maturin develop --release

That builds and installs the native cutlass extension into the active virtual environment.

Supported Python and platforms

The package targets Python 3.9 and newer. The local packaging notes describe wheels for macOS Apple Silicon and Windows x64.

Export support follows the native encoder backends. Apple and Windows are the intended H.264/AAC MP4 targets in the Python binding; unsupported platforms raise until their backend lands.

Development checks

Run the Python API suite after developing the extension:

python -m pytest tests/ -q
python tests/smoke.py

For a quick end-to-end script, run:

python examples/tour.py

The tour expects sample media under the repo-local local-assets directory.