Installation

Requirements

Python 3.10 or higher. pip installs the NumPy and audio_samples dependencies automatically.

Install from PyPI

pip install audio-samples-qoe

This pulls a pre-built wheel, so no Rust toolchain is needed.

Build from Source

Building from source requires a Rust toolchain (1.87 or newer) and maturin:

git clone https://github.com/jmg049/audio_samples_qoe
cd audio_samples_qoe
maturin develop --release

maturin develop builds the extension and installs it into the active virtual environment. The project is a single Rust crate; the Python bindings are compiled behind its python feature, and Scoreq behind its scoreq feature (which pulls in the ort ONNX Runtime dependency) — both are enabled automatically by the pyproject.toml maturin configuration. If Scoreq is unavailable after a custom build, it was built without the scoreq feature.