The ImmuneML Ecosystem for Machine Learning Analysis of Adaptive Immune Receptor Repertoires

Adaptive immune receptor repertoires (AIRR) are key targets for biomedical research as they record past and ongoing adaptive immune responses. The capacity of machine learning (ML) to identify complex discriminative sequence patterns renders it an ideal approach for AIRR-based diagnostic and therapeutic discovery. To date, widespread adoption of AIRR ML has been inhibited by a lack of reproducibility, transparency, and interoperability. immuneML (immuneml.uio.no) addresses these concerns by implementing each step of the AIRR ML process in an extensible, open-source software ecosystem that is based on fully specified and shareable workflows. To facilitate widespread user adoption, immuneML is available as a command-line tool and through an intuitive Galaxy web interface, and extensive documentation of workflows is provided. We demonstrate the broad applicability of immuneML by (i) reproducing a large-scale study on immune state prediction, (ii) developing, integrating, and applying a novel deep learning method for antigen specificity prediction, and (iii) showcasing streamlined interpretability-focused benchmarking of AIRR ML.

Citing Articles

A comprehensive benchmarking for evaluating TCR embeddings in modeling TCR-epitope interactions.

Feng X, Huo M, Li H, Yang Y, Jiang Y, He L Brief Bioinform. 2025; 26(1).

PMID: 39883514 PMC: 11781202. DOI: 10.1093/bib/bbaf030.

The compositional behavior of the human T cell receptor repertoire in ovarian cancer compared to healthy donors.

Zuckerbrot-Schuldenfrei M, Zilberberg A, Efroni S Sci Data. 2025; 12(1):175.

PMID: 39880820 PMC: 11779844. DOI: 10.1038/s41597-024-04335-4.

Simulation of adaptive immune receptors and repertoires with complex immune information to guide the development and benchmarking of AIRR machine learning.

Chernigovskaya M, Pavlovic M, Kanduri C, Gielis S, Robert P, Scheffer L Nucleic Acids Res. 2025; 53(3).

PMID: 39873270 PMC: 11773363. DOI: 10.1093/nar/gkaf025.

Leveraging artificial intelligence and machine learning to accelerate discovery of disease-modifying therapies in type 1 diabetes.

Shapiro M, Tallon E, Brown M, Posgai A, Clements M, Brusko T Diabetologia. 2024; 68(3):477-494.

PMID: 39694914 PMC: 11832708. DOI: 10.1007/s00125-024-06339-6.

The Type 1 Diabetes T Cell Receptor and B Cell Receptor Repository in the AIRR Data Commons: a practical guide for access, use and contributions through the Type 1 Diabetes AIRR Consortium.

Hanna S, Bonami R, Corrie B, Westley M, Posgai A, Luning Prak E Diabetologia. 2024; 68(1):186-202.

PMID: 39467874 PMC: 11663175. DOI: 10.1007/s00125-024-06298-y.

References

Laustsen A, Greiff V, Karatt-Vellatt A, Muyldermans S, Jenkins T . Animal Immunization, in Vitro Display Technologies, and Machine Learning for Antibody Discovery. Trends Biotechnol. 2021; 39(12):1263-1273. DOI: 10.1016/j.tibtech.2021.03.003. View

Britanova O, Putintseva E, Shugay M, Merzlyak E, Turchaninova M, Staroverov D . Age-related decrease in TCR repertoire diversity measured with deep and normalized sequence profiling. J Immunol. 2014; 192(6):2689-98. DOI: 10.4049/jimmunol.1302064. View

. Software with impact. Nat Methods. 2014; 11(3):211. DOI: 10.1038/nmeth.2880. View

Bolotin D, Poslavsky S, Mitrophanov I, Shugay M, Mamedov I, Putintseva E . MiXCR: software for comprehensive adaptive immunity profiling. Nat Methods. 2015; 12(5):380-1. DOI: 10.1038/nmeth.3364. View

Rubelt F, Busse C, Bukhari S, Burckert J, Mariotti-Ferrandiz E, Cowell L . Adaptive Immune Receptor Repertoire Community recommendations for sharing immune-repertoire sequencing data. Nat Immunol. 2017; 18(12):1274-1278. PMC: 5790180. DOI: 10.1038/ni.3873. View

Briney B, Inderbitzin A, Joyce C, Burton D . Commonality despite exceptional diversity in the baseline human antibody repertoire. Nature. 2019; 566(7744):393-397. PMC: 6411386. DOI: 10.1038/s41586-019-0879-y. View

Lythe G, Callard R, Hoare R, Molina-Paris C . How many TCR clonotypes does a body maintain?. J Theor Biol. 2015; 389:214-24. PMC: 4678146. DOI: 10.1016/j.jtbi.2015.10.016. View

Christophersen A, Raki M, Bergseng E, Lundin K, Jahnsen J, Sollid L . Tetramer-visualized gluten-specific CD4+ T cells in blood as a potential diagnostic marker for coeliac disease without oral gluten challenge. United European Gastroenterol J. 2014; 2(4):268-78. PMC: 4114117. DOI: 10.1177/2050640614540154. View

Sethna Z, Elhanati Y, Callan C, Walczak A, Mora T . OLGA: fast computation of generation probabilities of B- and T-cell receptor amino acid sequences and motifs. Bioinformatics. 2019; 35(17):2974-2981. PMC: 6735909. DOI: 10.1093/bioinformatics/btz035. View

10.

Springer I, Besser H, Tickotsky-Moskovitz N, Dvorkin S, Louzoun Y . Prediction of Specific TCR-Peptide Binding From Large Dictionaries of TCR-Peptide Pairs. Front Immunol. 2020; 11:1803. PMC: 7477042. DOI: 10.3389/fimmu.2020.01803. View

11.

Ostmeyer J, Christley S, Toby I, Cowell L . Biophysicochemical Motifs in T-cell Receptor Sequences Distinguish Repertoires from Tumor-Infiltrating Lymphocyte and Adjacent Healthy Tissue. Cancer Res. 2019; 79(7):1671-1680. PMC: 6445742. DOI: 10.1158/0008-5472.CAN-18-2292. View

12.

Schneider-Hohendorf T, Gorlich D, Savola P, Kelkka T, Mustjoki S, Gross C . Sex bias in MHC I-associated shaping of the adaptive immune system. Proc Natl Acad Sci U S A. 2018; 115(9):2168-2173. PMC: 5834686. DOI: 10.1073/pnas.1716146115. View

13.

Chen K, Cofer E, Zhou J, Troyanskaya O . Selene: a PyTorch-based deep learning library for sequence data. Nat Methods. 2019; 16(4):315-318. PMC: 7148117. DOI: 10.1038/s41592-019-0360-8. View

14.

Vamathevan J, Clark D, Czodrowski P, Dunham I, Ferran E, Lee G . Applications of machine learning in drug discovery and development. Nat Rev Drug Discov. 2019; 18(6):463-477. PMC: 6552674. DOI: 10.1038/s41573-019-0024-5. View

15.

Akbar R, Robert P, Pavlovic M, Jeliazkov J, Snapkov I, Slabodkin A . A compact vocabulary of paratope-epitope interactions enables predictability of antibody-antigen binding. Cell Rep. 2021; 34(11):108856. DOI: 10.1016/j.celrep.2021.108856. View

16.

Afgan E, Baker D, Batut B, van den Beek M, Bouvier D, cech M . The Galaxy platform for accessible, reproducible and collaborative biomedical analyses: 2018 update. Nucleic Acids Res. 2018; 46(W1):W537-W544. PMC: 6030816. DOI: 10.1093/nar/gky379. View

17.

Beshnova D, Ye J, Onabolu O, Moon B, Zheng W, Fu Y . De novo prediction of cancer-associated T cell receptors for noninvasive cancer detection. Sci Transl Med. 2020; 12(557). PMC: 7887928. DOI: 10.1126/scitranslmed.aaz3738. View

18.

Parameswaran P, Liu Y, Roskin K, Jackson K, Dixit V, Lee J . Convergent antibody signatures in human dengue. Cell Host Microbe. 2013; 13(6):691-700. PMC: 4136508. DOI: 10.1016/j.chom.2013.05.008. View

19.

Vujovic M, Degn K, Isa Marin F, Schaap-Johansen A, Chain B, Andresen T . T cell receptor sequence clustering and antigen specificity. Comput Struct Biotechnol J. 2020; 18:2166-2173. PMC: 7473833. DOI: 10.1016/j.csbj.2020.06.041. View

20.

Glanville J, Huang H, Nau A, Hatton O, Wagar L, Rubelt F . Identifying specificity groups in the T cell receptor repertoire. Nature. 2017; 547(7661):94-98. PMC: 5794212. DOI: 10.1038/nature22976. View