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

Install

Pick your options below and the command updates to match. The CLI installer downloads a portable Python runtime with uv (no system Python needed) and creates launchers and shortcuts; pip and uv install with a package manager you already have. Only the core medics package is installed — add extensions separately afterwards.

Install method

Your OS

Terminal

Python version

Desktop icon

Launch after install

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

Verify

After installing (either method), confirm the package and CLI are available:

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)
JupyterLab	Full JupyterLab web UI in a central tab. Its kernel runs MedICS's own Python environment, exposes the live workspace as `ws`, and needs no setup — notebooks, completions, and the debugger work out of the box.

JupyterLab is an optional extra. Install it into MedICS's environment to enable the tab; without it the tab opens and prints the install command instead of failing.