PlexPipe

PlexPipe turns raw multiplexed whole-slide images into quantitative single-cell data. It takes the individual analysis-ready TIFF files and moves them through five modular steps, from outlining regions of interest to a single-cell feature table ready for downstream analysis in the scverse ecosystem.

PlexPipe runs one step at a time, each driven by a single configuration file that holds the parameters for the whole workflow. Two steps, ROI definition and quality control, open a napari viewer, because they need a person to outline the regions of interest and mark imaging artefacts for exclusion.

The pipeline

Five stages, each demonstrated by a notebook in notebooks/:

1. ROI definition (interactive): find and outline the regions of interest in a whole-slide image, for example dearraying the cores of a tissue microarray. Notebook: 01_roi_definition_demo.ipynb.
2. ROI cutting: extract each ROI into its own SpatialData object. Notebook: 02_roi_cutting_demo.ipynb.
3. Quality control (interactive): mark imaging artefacts and tissue to exclude from analysis. Notebook: 03_QC_demo.ipynb.
4. Segmentation: enhance images and segment cells and nuclei into masks (Cellpose or InstanSeg). Notebook: 04_segmentation_demo.ipynb.
5. Quantification: measure per-cell marker intensities into an AnnData table. Notebook: 05_quantification_demo.ipynb.

Outputs are stored as SpatialData (Zarr) objects with AnnData tables, so results drop straight into scverse tools or the napari-spatialdata plugin for interactive exploration.

Installation

Install PlexPipe from PyPI, with every optional feature:

pip install "plex_pipe[all]"

or, with uv, uv pip install "plex_pipe[all]". This gives you the plex_pipe library and the plexpipe command.

To run the notebooks, clone the repository and sync the full environment:

git clone https://github.com/plexpipe/plex-pipe.git
cd plex-pipe
uv sync --extra all

--extra all installs every optional feature: the segmentation backends (Cellpose, InstanSeg, PyTorch), the napari GUI, Jupyter, and Globus transfer. On a Windows machine with an NVIDIA GPU you need a CUDA build of PyTorch, covered in the installation guide.

Supported platforms. Python 3.12–3.14 on Linux, Windows and Apple Silicon Macs. Install plex_pipe[all]; PyTorch comes from PyPI and matches your platform (CUDA on Linux, CPU on Windows, CPU + Metal/MPS on macOS). On Windows with an NVIDIA GPU, install a CUDA build of PyTorch yourself, or use uv sync --extra all-cuda in a clone (see the installation guide). Intel Macs are not supported: current PyTorch releases no longer include Intel-Mac builds.

Try it on example data

The notebooks run on a small example dataset, and the first notebook downloads it for you with fetch_example(), so you can go from a fresh clone to a running pipeline without hunting for data. The notebooks and the example configuration come with a clone of the repository; they are not part of the installed package.

Start with 01_roi_definition_demo.ipynb and work through to 05. Stages 1 and 3 open a napari window for the interactive steps; the rest run automatically from the shared configuration file.

Execution modes

For smaller datasets and prototyping, run the notebooks or standalone scripts locally. For large-scale parallel processing on HPC, use the Nextflow version, plex-pipe-nextflow.

Status

PlexPipe is in active development (alpha). Interfaces and the configuration schema may still change before a 1.0 release. Bug reports and feedback are welcome on the issue tracker.

Automatic ROI suggestion with SAM2 (Segment Anything Model 2) is optional and installed separately (Linux or WSL on Windows); ROIs can always be drawn by hand.

Used in

• Yang Y, Bukkuri A, Poe D, McLaughlin J, Hao S, Brown DD, Kedziora KM, Stallaert W. Distinct p21 dynamics drive alternative routes to whole-genome duplication through a common CDK4/6-dependent polyploid G0 state. bioRxiv [Preprint]. 2026 Jan 15:2026.01.15.699545. doi: 10.64898/2026.01.15.699545. PMID: 41648389; PMCID: PMC12871375.

Similar projects

PlexPipe is one of several open pipelines for turning multiplexed images into single-cell data:

• MCMICRO
• Harpy
• Sopa
• Spatialproteomics

PlexPipe's distinguishing emphasis is human-in-the-loop interaction. Two of its five steps, ROI definition and quality control, open a napari viewer so a scientist can outline regions of interest and annotate imaging artefacts directly, keeping expert judgement at the points in the workflow where it matters most.

License

Distributed under the terms of the BSD-3-Clause license.