Get started — MedICS

Requirements

Windows, macOS, or Linux
CLI installer: a network connection — Python is downloaded for you
pip install: Python 3.11 or later
Scientific stack (NumPy, SciPy, scikit-image, pydicom, h5py, PySide6, and others) — installed automatically with the package

CLI installer

A single install.bat (Windows) or install.sh (macOS/Linux) script downloads a portable Python runtime with uv, lets you choose an install folder and extensions in the terminal, then creates launchers and shortcuts. A network connection is required. No system Python is needed.

Windows

curl -L -o "%TEMP%\medics-install.bat" https://medical-image-computing-suite.github.io/installer/install.bat && "%TEMP%\medics-install.bat"

macOS and Linux

curl -fsSL https://medical-image-computing-suite.github.io/installer/install.sh | bash

Install with pip

If Python 3.11+ is already on your PATH, you can install MedICS without the CLI installer.

From PyPI

pip install medics

Verify

python -c "import medics; print(medics.__version__)"
medics --help

Launch

medics
# or
python -m medics

Useful CLI commands:

medics                              Start the application
medics --create-ext [NAME] [DIR]    Scaffold a new extension
medics --build-ext [OPTIONS]        Build an extension wheel
medics --version, -V                Print the installed version
medics --help                       Show CLI help

Toolboxes

Toolbox	Role
PyEditor	Python IDE: syntax highlighting, completions, AST outline, integrated terminal, run against the Jupyter kernel
ImportData	Unified importer for DICOM, TIFF/PNG/JPEG, HDF5, MAT, NumPy, CSV, and related formats; background workers with progress
FilePreview	Read-only preview of text, code, markdown, spreadsheets, 2-D images, and volumetric data (DICOM series, stacked TIFF)