MHCflurry
MHCflurry predicts which peptides are likely to be displayed by MHC class I molecules. It provides pretrained models for three related tasks:
- Binding affinity: how strongly a peptide binds an MHC allele.
- Antigen processing: whether cellular processing favors the peptide.
- Presentation: a combined score using binding and processing predictions.
You can use the released models from the command line or Python, scan proteins for candidate epitopes, or train models on your own data.
Quick start
Install MHCflurry 2.3.0 and download the pretrained presentation models:
pip install --upgrade "mhcflurry==2.3.1"
mhcflurry downloads fetch models_class1_presentation
Predict a few peptides:
mhcflurry predict \
--alleles HLA-A0201 HLA-A0301 \
--peptides SIINFEKL SIINFEKD SIINFEKQ \
--out predictions.csv
Or scan a protein sequence for candidate ligands:
mhcflurry predict-scan \
--sequences MFVFLVLLPLVSSQCVNLTTRTQLPPAYTNSFTRGVYYPDKVFRSSVLHS \
--alleles 'HLA-A*02:01' \
--out scan.csv
To try MHCflurry without installing anything, open the Colab notebook.
The historical mhcflurry-* command names remain supported for existing
scripts. See the 2.3.0 release notes for details.
Documentation
- Introduction and installation
- Command-line tutorial
- Python tutorial
- Training models
- Command reference
- API reference
Please file an issue if you have questions or encounter problems.
Citing MHCflurry
If you use MHCflurry in your research, please cite:
T. O'Donnell, A. Rubinsteyn, U. Laserson. "MHCflurry 2.0: Improved pan-allele prediction of MHC I-presented peptides by incorporating antigen processing," Cell Systems, 2020. https://doi.org/10.1016/j.cels.2020.06.010
T. O'Donnell, A. Rubinsteyn, M. Bonsack, A. B. Riemer, U. Laserson, and J. Hammerbacher, "MHCflurry: Open-Source Class I MHC Binding Affinity Prediction," Cell Systems, 2018. https://doi.org/10.1016/j.cels.2018.05.014
Development
Contributions are welcome. Start with CONTRIBUTING.md; the testing guide describes the fast local checks and full suite.
Docker
Run the latest image from Docker Hub:
docker run -p 9999:9999 --rm openvax/mhcflurry:latest
Then open http://localhost:9999 to use the included Jupyter environment. To
build the image from a checkout:
docker build -t mhcflurry:latest .
docker run -p 9999:9999 --rm mhcflurry:latest
More resources
1 maintainer
Metadata
1 maintainer
Release files for mhcflurry 2.3.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| mhcflurry-2.3.1.tar.gz | 748.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| mhcflurry-2.3.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.3 MB
Release files / mhcflurry-2.3.1.tar.gz
| Download URL | mhcflurry-2.3.1.tar.gz |
|---|---|
| Size | 748.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c6afd09ebd20112fcf248220d59a5575cd428ef2cfd3ac66b6c25da2a22dcb4f
|
|
BLAKE2b-256 checksum How to use checksums |
25ed0f4e9bc8890f9491dfec5791721ee7ad8e48f51da321beac4110293de36d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 28, 2026.
Transparency logRelease files / mhcflurry-2.3.1-py3-none-any.whl
| Download URL | mhcflurry-2.3.1-py3-none-any.whl |
|---|---|
| Size | 550.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
8239b2b3d8219858877189ec6869815ef20180e98dfad376a7d9076c7c7f6290
|
|
BLAKE2b-256 checksum How to use checksums |
146cc517e542574a41af8d0a15775015d1d647fdc99a9ac31b76c935d15d9232
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 28, 2026.
Transparency log
