GelGenie

<p align="center"> <picture> <img alt="GelGenie logo" src="./logo/full_logo.png" width="50%" height="auto"> </picture> </p> <p align="center"> <em>One-click gel electrophoresis analysis.</em> </p> <div align="center">

</div>

---

Main code repository for GelGenie, an app that uses deep learning models to segment gel electrophoresis images and completely automate the gel analysis process. The repo is split into two:

• python-gelgenie contains a python package for preparing gel image datasets, creating segmentation architectures and training/evaluating deep learning models with PyTorch. More details on usage and installation in the python package README.
• qupath-gelgenie contains a QuPath extension that provides an easy-to-access interface for GelGenie models as well as a rich set of tools for analysing and exporting segmentation results.

GelGenie Feature Highlights:

• One-click segmentation of gel electrophoresis images
• General-purpose models that work with a wide range of gel conditions, imagers and stains
• Customisable band measurement, bar chart generation and normalisation
• Easy export to csv for further processing
• Scriptable interface for model inference and labelling
• Python environment for training new models and advanced features
• Open-source and configurable by everyone!

<div style="display: flex; flex-wrap: wrap; justify-content: space-around;" align="center"> <img src="/qupath-gelgenie/screenshots/example_inference_1.gif" alt="GelGenie in action" style="width: 60%; margin: 0.5%;"> <img src="./qupath-gelgenie/screenshots/s1.png" alt="GelGenie Screenshot 1" style="width: 47%; margin: 0.5%;"> <img src="./qupath-gelgenie/screenshots/s2.png" alt="GelGenie Screenshot 2" style="width: 47%; margin: 0.5%;"> <img src="./qupath-gelgenie/screenshots/s3.png" alt="GelGenie Screenshot 3" style="width: 47%; margin: 0.5%;"> <img src="./qupath-gelgenie/screenshots/s4.png" alt="GelGenie Screenshot 4" style="width: 47%; margin: 0.5%;"> </div>

Installing the QuPath GelGenie Extension

• First, install the latest version of QuPath (current v0.6.x), following the instructions for your operating system here.
• Next, download the latest version of the GelGenie extension from the releases page (make sure to only download the .jar file):

<p align="center"> <img src="./qupath-gelgenie/screenshots/release_download.png" alt="How to download GelGenie" width="500"> </p>

• Then drag & drop the downloaded .jar file onto the main QuPath window to install it:

<p align="center"> <img src="./qupath-gelgenie/screenshots/drag_n_drop.png" alt="Drag-n-drop installation" width="500"> </p>

• Finally, run GelGenie from the extensions menu:

<p align="center"> <img src="./qupath-gelgenie/screenshots/open_extension.png" alt="How to activate GelGenie" width="500"> </p>

Backwards Compatibility with QuPath v0.5.0-1

• If you are using QuPath v0.5.1 or v0.5.0, make sure to download GelGenie version v1.0.5.1 instead (here).

QuPath GelGenie Extension Tutorial/Manual

• For a comprehensive manual describing the installation and use of GelGenie, jump to the readme page here.
• A quick-start video showing how to install the app and the main features is available here: https://youtu.be/_HZyM8Shgc0.

Quick Access for Fiji/ImageJ Users (BioImage.IO)

• We've also provided our core models in BioImage.IO format for those more familiar with ImageJ. Check the instructions here for installing our models within ImageJ, and for a macro to help run and analyze images directly.

GelGenie's Python Environment and Training New Models (for developers)

Full documentation, Python installation instructions and more details are provided here Python Quick Start.

Acessing Pre-Trained Models (for developers)

All pre-trained models are available on HuggingFace. The main registry can be found at the link here. The QuPath GelGenie extension directly downloads the models from HuggingFace, with no user tweaking required.

Accessing Labelled Gel Datasets

All data can be downloaded in the original format used for training, validation and testing from our Zenodo upload with DOI 10.5281/zenodo.14641949.

Development & Support

The principal GelGenie researcher and developer is Matthew Aquilina, who built up the concept of gel electrophoresis segmentation and oversaw the project together with Katherine Dunn at the University of Edinburgh. The other developers/scientists who contributed to the project are:

• Nathan Wu - Gel labelling, lab data generation, data analysis and statistical pipeline development
• Kiros Kwan - Gel labelling, deep learning framework development and model training
• Filip Buŝić - Image analysis, classical segmentation algorithms and prototype GUI development
• James Dodd - Gel labelling, lab data generation, prototype testing and feedback
• Peter Bankhead - QuPath extension development, deep learning algorithms and java development guidance
• Alan O'Callaghan - QuPath extension development and java development guiidance
• Laura Nicolás-Sáenz - Clustering algorithm development
• We also received advice, gel data (thanks Arun, Stella, Yichen, Huangchen, Thomas, Joana and Ricarda!) and alpha testing feedback from other colleagues in both the University of Edinburgh and the Dana-Farber/Wyss Institute for which we are incredibly grateful!

The project was directly supported by both the School of Engineering (who funded Kiros and Filip) and the Precision Medicine Doctoral Training Programme at the University of Edinburgh (via Medical Research Council (MRC) grant number MR/N013166/1). The EDDIE compute cluster (from the Edinburgh Compute and Data Facility (ECDF)) was used to train the baseline machine learning models.

For more details of everyone's coding contributions, please check the graphs here.

Contributions from the open-source community are welcome! In particular, we are looking for help with introducing unit tests to both the Python and Java GelGenie packages!

Literature Citation

Our main manuscript has been published in Nature Communications, with DOI: https://doi.org/10.1038/s41467-025-59189-0

Bibtex citation details available below:

@article{aquilinaGelGenieAIpoweredFramework2025,
	title = {{GelGenie}: an {AI}-powered framework for gel electrophoresis image analysis},
	volume = {16},
	copyright = {All rights reserved},
	issn = {2041-1723},
	url = {https://doi.org/10.1038/s41467-025-59189-0},
	doi = {10.1038/s41467-025-59189-0},
	abstract = {Gel electrophoresis is a ubiquitous