cardio 2025.8.1

A simple web-based viewer for 3D and 4D ('cine') medical imaging data.

cardio

cardio is a simple web-based viewer for 3D and 4D ('cine') medical imaging data, built primarily on trame, vtk, and itk. cardio is able to render sequences of mesh files (e.g., \*.obj files), segmentation files (e.g. \*nii.gz files with discrete labels) and volume renderings of grayscale images (e.g. *.nii.gz files with continuous values). cardio is launched from the commandline and may be configured either directly from the commandline, via a static TOML configuration file, or a combination of the two.

Quickstart

Installation

$ cd /path/to/your/project
$ uv init
$ uv add cardio
$ . ./.venv/bin/activate
(project) cardio --version
cardio 2025.8.1

Developing

Ensuring you have all required dependencies:

$ uv sync --all-extras

Pre-commit checklist:

$ isort .
$ ruff format
$ pytest -v

Uploading:

$ bumpver update
$ uv build --no-sources
$ uv publish --token <pypi_api_key>