MRMhub is an open-source, one-stop framework for reproducible, automated processing of targeted metabolomics and lipidomics data acquired by liquid chromatography–mass spectrometry (LC–MS) in Multiple Reaction Monitoring (MRM) mode. Addressing well-known gaps in the robustness and scalability of existing software, it takes an experiment from raw instrument data to quality-controlled quantitative results, processing population-scale studies within minutes on standard hardware while recording a full digital footprint of every step for reproducibility and traceability. Built for both analytical and bioinformatics scientists, MRMhub provides modular functions and defined data structures that adapt to diverse study designs and data formats, supporting customizable, fully documented end-to-end workflows across two complementary modules:
- INTEGRATOR (the
MRMhubbinary) - a fast, memory-efficient, multithreaded standalone application for consensus-based peak integration across large analysis sequences, with per-feature integration settings. It reads mzML (vendor raw files converted via msconvert) and exports integrated peak areas that feed directly into QUANT or other post-processing tools. Learn more ↗ - QUANT (the
mrmhubR package) - a programmatic library for building tailored, reproducible post-processing and quality-control pipelines. It reads INTEGRATOR results directly, or feature-intensity data from other sources (CSV, mzTab-M, Skyline). Learn more ↗
-
INTEGRATOR: download the macOS or Windows build from Releases, but read the INTEGRATOR installation guide first (for first-launch security warnings and project setup).
-
QUANT: install from GitHub in a fresh RStudio/Positron session (requires R ≥ 4.1). Please read the QUANT installation guide first for full instructions and troubleshooting.
if (!require("pak")) install.packages("pak") pak::pak("SLINGhub/MRMhub") library(mrmhub)
→ Browse analyses - MRMhub-workflows ↗ shows annotated, end-to-end data-processing reports from large-scale lipidomics analyses and a fully quantitative assay.
→ Run the demo - download the latest release ↗ and follow the bundled readme.txt to process the demo project end-to-end with both modules.
- INTEGRATOR manual ↗ - https://slinghub.github.io/MRMhub/integrator/ (setup, input files, msconvert)
- QUANT R package docs ↗ - https://slinghub.github.io/MRMhub/quant/ (manual, tutorials, function reference)
INTEGRATOR runs as a desktop app (see Quick Start ↗). QUANT is an R package. The example below runs on the bundled demo data and can be extended in the same way to quantitation, drift/batch correction, QC metrics, and feature filtering:
library(mrmhub)
demo_file <- system.file("extdata", "MRMhub_demo.tsv", package = "mrmhub")
# `mexp` is the container holding all data and results across the script
mexp <- MRMhubExperiment() |>
import_data_mrmhub(path = demo_file, import_metadata = TRUE) |>
normalize_by_istd()
# Inspect ISTD-normalized signal for selected lipid classes (2 x 3 panel)
plot_runscatter(
mexp,
variable = "norm_intensity",
rows_page = 2, cols_page = 3,
include_feature_filter = "^(Cer|PC)" # names as a vector or regex
)
# Export a multi-sheet QC report
save_report_xlsx(mexp, path = "results.xlsx")- Bo Burla - bo.burla@nus.edu.sg
- Guo Shou Teo - guoshou@nus.edu.sg
- Hyungwon Choi - hyung_won_choi@nus.edu.sg
Bug reports and feature requests are welcome via GitHub issues. The project follows the Contributor Code of Conduct.
Burla B. et al. (2025). MRMhub: one-stop solution for automated processing of large-scale targeted metabolomics data. bioRxiv. doi:10.64898/2025.12.20.695370
Dual-licensed - non-commercial under GNU AGPLv3. For commercial use contact Jonathan Tan (jonathan_tan@nus.edu.sg).