AlignAIR pretrained models
Pretrained human models for AlignAIR: V(D)J allele assignment for IG and TCR repertoires. AlignAIR reads FASTA, FASTQ or a table and writes an AIRR rearrangement table that Change-O, TIgGER and SCOPer read as it is.
This repository is the catalog the AlignAIR command line reads from: registry.json lists every model and version,
and each <id>/<version>.alignair is a self-contained, pickle-free model file (weights, the germline set it calls from,
and its model card), with its card and reference manifest beside it.
Use it (no manual download)
pip install alignair
alignair predict --model alignair4-igh-human --input reads.fasta --out out.tsv
The first run downloads the model, checks its SHA-256 and caches it (~/.cache/alignair); later runs start at once.
Pin a version with --model alignair4-igh-human@1.0.0. To work offline, run alignair models get <id> first and then
predict with --offline. In Python: Aligner.from_pretrained("alignair4-igh-human").
The AlignAIR 4 models (version 1.0.0)
| Locus | Model id | Germline set | Allele names | Alleles V / D / J |
|---|---|---|---|---|
| IGH | alignair4-igh-human |
OGRDB human IGH (HUMAN_IGH_OGRDB) |
OGRDB | 198 / 33 / 7 |
| IGK | alignair4-igk-human |
OGRDB human IGK (HUMAN_IGK_OGRDB) |
OGRDB | 168 / β / 8 |
| IGL | alignair4-igl-human |
OGRDB human IGL (HUMAN_IGL_OGRDB) |
OGRDB | 181 / β / 10 |
| TRA | alignair4-tra-human |
IMGT human TRA (HUMAN_TCRA_IMGT) |
IMGT | 76 / β / 68 |
| TRB | alignair4-trb-human |
IMGT human TRB (HUMAN_TCRB_IMGT) |
IMGT | 98 / 3 / 16 |
| TRD | alignair4-trd-human |
IMGT human TRD (HUMAN_TCRD_IMGT) |
IMGT | 14 / 3 / 4 |
| TRG | alignair4-trg-human |
IMGT human TRG (HUMAN_TCRG_IMGT) |
IMGT | 20 / β / 6 |
- Your own germline set or a donor genotype: a model calls from the germline set it is given, so
--reference germline.fasta(novel alleles included) and--genotype donor.yamlwork without retraining. - Another species or locus: train or fine-tune a model (
alignair train,--init-from). alignair info alignair4-igh-humanprints a model's card: its germline set, alleles and training.
Choosing a model, every option and output column, and the comparison with IgBLAST are in the documentation.
AlignAIR 3 models
alignair-igh-human, alignair-igkl-human and alignair-tcrb-human (1.0.0) are the AlignAIR 3 models, kept for
alignair<4. AlignAIR 4 uses a new model format and does not run them.
Licence and citation
GPL-3.0-or-later, as AlignAIR. If you use AlignAIR, please cite:
Konstantinovsky T., Peres A., Eisenberg R., Polak P., Lindenbaum O., Yaari G. Enhancing sequence alignment of adaptive immune receptors through multi-task deep learning. Nucleic Acids Research 53(13), gkaf651 (2025). https://doi.org/10.1093/nar/gkaf651