Skip to content

About

MEDical Image analysis with Machine Learning (MEDiml) is a user-friendly application that enables the standardized extraction of radiomics features from medical images and the integration of machine learning to enhance medical research.

Topics

Resources

Code of conduct

Contributing

Stars

3 stars

Watchers

1 watching

Forks

Repository files navigation

MEDical Image analysis with Machine Learning (MEDiml) / The Application

A desktop application for radiomics analysis.

Release Build Platforms License

   Documentation

   Website

   Paper (Submitted)

   Reference Manual


Table of Contents

Introduction

MEDiml-app puts the MEDiml Python package behind an interactive interface: the whole radiomics pipeline, from raw medical images to predictive models, runs from a single desktop app.

Radiomics turns medical images (CT, MR, PET, radiotherapy dose maps) into quantitative features that can feed predictive models of diagnosis, treatment response or outcome. Computing these features reproducibly is hard: the results depend on many preprocessing choices (voxel size, re-segmentation range, discretisation, filters), and the standardized tools that implement them, such as MEDiml, which follows the Image Biomarker Standardisation Initiative (IBSI), are programming libraries.

Many of the people who need radiomics features, such as clinicians, medical physicists and clinical researchers, do not program. MEDiml-app closes that gap. It lets them:


Convert data
Convert DICOM/NIfTI datasets to MEDiml format and validate them.

Configure settings
Use ready-to-use, editable and validated extraction settings.

Extract features
Extract radiomics and dosiomics features across a dataset.

Save results
Save results with their settings for reporting and reproducibility.

Build models
Apply machine learning models to extracted features.

Design workflows
Design and run workflows tailored to each study.

Tip

It also gives researchers who do program a fast way to prototype MEDiml settings before scripting them.

Installation

Desktop installer (recommended)

  1. Download MEDiml-app for your operating system. Installers are also available on GitHub Releases.
  2. Follow the Quick start guide to install the app and get started.

Supported operating systems

Operating system Installer
Windows 10 or 11 (64-bit) .exe
Ubuntu 22.04 or later (64-bit) .deb
macOS (Apple silicon) .dmg

Requirements

  • A 64-bit operating system from the list above.
  • An internet connection on first launch: the app downloads its own Python 3.9 environment (with MEDiml) into ~/.mediml/python, and MongoDB. No Python installation is needed beforehand.

Run from source

Build and run locally, including development setup and installer builds

Prerequisites: Git, Node.js 18 and Go 1.21 or later (Go 1.24 or later on macOS).

git clone https://github.com/MEDomicsLab/MEDiml-app.git
cd MEDiml-app

# 1. JavaScript dependencies
npm install

# 2. Go server (rebuild it after any change to go_server/)
cd go_server
go build main.go
cd ..

# 3. Start the app in development mode
npm run dev

Python environment: on first launch, the setup dialog installs Python 3.9 and the packages listed in pythonEnv/requirements.txt (MEDiml included) into a python/ folder in the repository, as well as MongoDB. If ~/.mediml/python already exists, for example from an installed copy of the app, it is used instead.

To build the installers yourself, run npm run build:win, npm run build:linux or npm run build:mac on the matching operating system. The files are written to build/dist/.

Proof of concept

New to MEDiml-app? Follow the Soft-Tissue Sarcoma proof of concept, an easy-to-follow guide to get familiar with the app. It walks through a full radiomics study for the early evaluation of lung metastasis risk, from feature extraction to model training and evaluation.

Its imaging data (PET, T1, T2FS and CT scans for each patient, derived from a public TCIA cohort) is published on Zenodo. You can download it from the app's home page, straight into your workspace under DATA/STS_POC.

Documentation

Getting help

Contributing

Contributions are welcome. See CONTRIBUTING.md and our Code of Conduct.

Citation

If you use MEDiml in your research, please cite it using:

@misc{loutfi2026mediml,
  title         = {{MEDical Image analysis with Machine Learning (MEDiml)}: Strategies for Simpler Radiomics},
  author        = {Ait Lhaj Loutfi, Mahdi and others},
  year          = {2026},
  eprint        = {2610.37715},
  archiveprefix = {arXiv},
  doi           = {10.48550/arXiv.2610.37715}
}

The MEDiml reference manual explains the radiomics concepts and workflow shared by the Python package and desktop application, including image preprocessing, feature extraction, predictive modelling and interpretation. It also covers the software architecture and installation, compares MEDiml with other tools, and illustrates its use on five oncological imaging cohorts.

License

MEDiml-app is released under the GNU General Public License v3.0.

About

MEDical Image analysis with Machine Learning (MEDiml) is a user-friendly application that enables the standardized extraction of radiomics features from medical images and the integration of machine learning to enhance medical research.

Topics

Resources

Code of conduct

Contributing

Stars

3 stars

Watchers

1 watching

Forks

Releases

Contributors

Languages