Disease Normalizer
The Disease Normalizer resolves ambiguous references and descriptions of human diseases to consistently-structured, normalized terms. For concepts extracted from NCIt, Mondo Disease Ontology, The Human Disease Ontology, OMIM, and OncoTree, it designates a CURIE, and provides additional metadata like aliases and cross-references.
Documentation · Installation · API reference
Installation
The Disease Normalizer is available via PyPI:
python3 -m pip install disease-normalizer
See installation instructions in the documentation for a description of installation options and data setup requirements.
Examples
Use the live service to programmatically normalize disease terms, as in the following truncated example:
$ curl -s 'https://normalize.cancervariants.org/disease/normalize?q=liver%20cancer' | python -m json.tool
{
"query": "liver cancer",
"warnings": null,
"match_type": 80,
"disease": {
"conceptType": "Disease",
"primaryCoding": {
"id": "ncit:C34803",
"code": "C34803",
"system": "https://ncit.nci.nih.gov/ncitbrowser/ConceptReport.jsp?dictionary=NCI_Thesaurus&code=",
},
"id": "normalize.disease:liver%20cancer",
"name": "Primary Malignant Liver Neoplasm",
# ...
}
}
Or utilize the Python API for fast local access:
>>> from disease.query import QueryHandler
>>> from disease.database import create_db
>>> q = QueryHandler(create_db())
>>> result = q.normalize("NSCLC")
>>> result.disease.primaryCoding.id
'ncit:C2926'
Feedback and contributing
We welcome bug reports, feature requests, and code contributions from users and interested collaborators. The documentation contains guidance for submitting feedback and contributing new code.
3 maintainers
Metadata
3 maintainers
Release files for disease-normalizer 0.13.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 | |
|---|---|---|---|
| disease_normalizer-0.13.1.tar.gz | 331.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| disease_normalizer-0.13.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 391.5 kB
Release files / disease_normalizer-0.13.1.tar.gz
| Download URL | disease_normalizer-0.13.1.tar.gz |
|---|---|
| Size | 331.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3138c6e8e686d9af62e8ca6fdd2bab0df3fdb8c411d8969ca7893911b035c165
|
|
BLAKE2b-256 checksum How to use checksums |
0eafc0c9c1781963e1e262677efacb8d9e327885ad2fd574e29924ab5eac4353
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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 May 13, 2026.
Transparency logRelease files / disease_normalizer-0.13.1-py3-none-any.whl
| Download URL | disease_normalizer-0.13.1-py3-none-any.whl |
|---|---|
| Size | 59.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
5a472019071c6d3adcc4fe38fb3eaf3a3a5c2e919869b11d7a6856be44746e84
|
|
BLAKE2b-256 checksum How to use checksums |
61ba8861f083cfb2e045daf9c2a4e256d1ad16e35c493189a976c99097e20225
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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 May 13, 2026.
Transparency log
