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.yaml work without retraining.
  • Another species or locus: train or fine-tune a model (alignair train, --init-from).
  • alignair info alignair4-igh-human prints 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

Downloads last month

-

Downloads are not tracked for this model. How to track
Inference Providers NEW
This model isn't deployed by any Inference Provider. πŸ™‹ Ask for provider support