Installation

Fiducio requires Python ≥ 3.10 and PyTorch ≥ 2.10.

From PyPI

Fiducio is published on PyPI:

pip install fiducio

or, in an existing uv application:

uv add fiducio

The core install depends only on numpy and torch.

From GitHub

To install the development version directly from the repository:

uv add "fiducio @ git+https://github.com/fiducio-ai/Fiducio.git"

Or with pip:

pip install "git+https://github.com/fiducio-ai/Fiducio.git"

Developing from a checkout

Use uv 0.12.3 and the committed uv.lock:

git clone https://github.com/fiducio-ai/Fiducio.git
cd Fiducio
uv sync --locked --extra docs --group build
uv run --no-sync pytest

The checkout defaults to Python 3.12 and CPU PyTorch for development and CI. The wheel does not impose that backend: applications using CUDA should install Fiducio into their own compatible PyTorch environment. The development lockfile is not inherited by downstream applications.

Optional extras

Heavy or domain-specific dependencies are kept out of the core install and loaded only when you ask for them:

Extra	Installs	For
fiducio[plots]	matplotlib	reliability-diagram plots
fiducio[docs]	MkDocs Material + mkdocstrings	building the docs
fiducio[dev]	pytest, ruff, mypy, build, matplotlib	development
fiducio[all]	all of the above	everything

pip install "fiducio[plots]"

A minimal install can import fiducio and use every calibrator and metric without matplotlib present; matplotlib is only needed for the optional plotting helpers.

Verifying the install

import fiducio
print(fiducio.__version__)
print(fiducio.registered_ids())