mhctools
mhctools is a Python library for running MHC binding, presentation, immunogenicity, and antigen-processing predictors. It provides a common interface to tools such as NetMHCpan and MHCflurry, with results you can inspect in Python or export as a pandas DataFrame.
Read the getting started guide or browse the documentation.
Install and predict
pip install mhctools
mhctools fetch mhcflurry
from mhctools import MHCflurry
predictor = MHCflurry(alleles=["HLA-A*02:01", "HLA-B*07:02"])
results = predictor.predict(["SIINFEKL", "GILGFVFTL"])
for result in results:
affinity = result.affinity
if affinity is not None:
print(result.peptide, affinity.allele, affinity.value)
Each result corresponds to one input peptide. The affinity accessor selects
the strongest prediction across alleles, with IC50 in nM. Use
predict_dataframe() for a pandas table or predict_proteins() to scan protein
sequences. See results and DataFrames.
Most predictors need model weights or an external installation. Use
mhctools ls to locate models and mhctools predictors to check which can run.
The installation guide explains
downloads, optional backends, and licensing.
Guides
- Choosing a predictor and known limits
- Predictor matrix: Python classes, CLI names, inputs, and installation routes
- Recipes: protein scans, multiple samples, and table annotation
- Command line
- Peptidase activity, vaccine reports, and benchmarks
Development
./develop.sh
./lint.sh
./test.sh
See the testing guide and release instructions.
5 maintainers
Metadata
5 maintainers
Release files for mhctools 4.0.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 | |
|---|---|---|---|
| mhctools-4.0.1.tar.gz | 1.1 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| mhctools-4.0.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 2.0 MB
Release files / mhctools-4.0.1.tar.gz
| Download URL | mhctools-4.0.1.tar.gz |
|---|---|
| Size | 1.1 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
204edaf6afb3ace2734e439f5af77725ad92a92db2659c771f3f2a73f43bd7e3
|
|
BLAKE2b-256 checksum How to use checksums |
e187cd6f61043b6946f91387a920fe54497cc19283396052005e0a09dceb53f9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.6
|
Release files / mhctools-4.0.1-py3-none-any.whl
| Download URL | mhctools-4.0.1-py3-none-any.whl |
|---|---|
| Size | 876.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
88ac5bf3ce2dd6faddbc93ec1bf3e58a9173853772e57cba5f1dfa90603b08fe
|
|
BLAKE2b-256 checksum How to use checksums |
3d9f76c7b694a7153c55a8b0e3a3fe5c367be0369da7ad37af4ad45dd7be90a6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.6
|
