Get Started

Up and running
in minutes

Install MedICS, verify your setup, and explore usage examples — everything you need to start analyzing medical images today.

Installation

How to install MedICS

bash 
pip install medics
🐍

Python ≥ 3.11

Required runtime environment

🔬

Scientific Stack

NumPy, SciPy, scikit-image, pydicom, h5py — auto-installed

💻

Cross-platform

Windows · macOS · Linux

Verify installation

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

Start in seconds

From launching the GUI to building your first extension.

01

Launch the GUI

# Via command line
medics

# As a Python module
python -m medics
02

Basic Workflow

  1. Open a folder — File → Open Folder or click the folder button in the file explorer dock.
  2. Import data — Open the ImportData toolbox; drag-and-drop image files/folders or browse for a DICOM series.
  3. Analyze — Write and run Python scripts in PyEditor or use the embedded Jupyter console.
  4. AI assistance — Open the Chat dock; ask questions, run code via skills, or retrieve docs via RAG.
  5. Save workspace — File → Save Workspace persists all variables to a .med (HDF5) file.
Next Steps

Where to go from here

🏥

Explore Platform Features

Learn about built-in toolboxes, the flexible UI engine, and workspace persistence.

Platform →
🤖

Set Up the AI Agent

Connect your preferred LLM provider and start chatting with your imaging data.

AI Agent →
🧩

Browse Extensions

Discover official and community extensions to extend MedICS for your workflow.

Extensions →
📋

View Changelog

See what's new in the latest release and what's coming next.

Changelog →