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
Requires Python 3.11 or later and pandas 3.x.
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.
Command line
Run mhctools --help to see commands and prediction options, or
mhctools --version to identify the installed release.
Enable Bash/zsh tab completion for this shell:
eval "$(register-python-argcomplete mhctools)"
Alternatively, run activate-global-python-argcomplete once and start a new
shell to enable completion for all participating OpenVax tools. See the
command-line guide for details.
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.8.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| mhctools-4.8.0.tar.gz | 1.2 MB | Without provenance | Details for mhctools-4.8.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| mhctools-4.8.0-py3-none-any.whl | Python 3 | none | any | Details for mhctools-4.8.0-py3-none-any.whl |
Total release size: 2.1 MB
Release files / mhctools-4.8.0.tar.gz
| Download URL | mhctools-4.8.0.tar.gz |
|---|---|
| Size | 1.2 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4ef269caf89995ddc1974a9d377d84df50344904eaa16fb3c4c9e83eb158b401
|
|
BLAKE2b-256 checksum How to use checksums |
9324bc997b6776d7899c6d2d44d977f66d358c0f963c84703067c9aaef891934
|
| 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.8.0-py3-none-any.whl
| Download URL | mhctools-4.8.0-py3-none-any.whl |
|---|---|
| Size | 902.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
e7e07ed351cfb76c06b14e5bf3bd77d94bcffbc9d358719a546c794b8f0a2e40
|
|
BLAKE2b-256 checksum How to use checksums |
eadb0395b4ca58119d22535608a1a9814c2f5598b7954e8f2082719ee7800a74
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.6
|
Security for mhctools 4.8.0
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.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
