Cumulus Library UMLS
An installation of the Unified Medical Language System® RxNorm dataset. Part of the SMART on FHIR Cumulus Project
For more information, browse the documentation.
Usage
In order to use RxNorm, you'll need to get an API key for access from the National Library of Medicine, which you can sign up for here.
You can then install this module by running pip install cumulus-library-rxnorm.
This will add an rxnorm target to cumulus-library. You'll need to pass your
API key via the --umls-key CLI flag, or set the UMLS_API_KEY environment variable
to the key you received from NIH.
We download a file from NIH, extract it, create parquet files for Athena, and then upload it.
We try to preserve some of those artifacts along the way to make rebuilds faster. If you need
to force recreation from scratch, the --force-upload CLI flag will handle this.
Note: This study is explicitly namespaced in its own schema, rxnorm. Make sure your
database is not using this schema for another use. Do not create tables inside this
schema by another means.
Licensing details
The cumulus-library-rxnorm study is provided as a convenience to install the
UMLS RxNorm dataset, but is not shipped with said dataset. It will
require an API key to download the data from NIH directly.
As a reminder, the RxNorm terms of service provides several restrictions on this usage of this data (including distributing the dataset). When you sign up for a UMLS key, you are assuming responsibility for complying with these terms, or an alternate licensing agreement with the owners of the RxNorm data if you are provided with one.
NIH Requried Disclaimer
This product uses publicly available data courtesy of the U.S. National Library of Medicine (NLM), National Institutes of Health, Department of Health and Human Services; NLM is not responsible for the product and does not endorse or recommend this or any other product.
Citations
Bodenreider O. The Unified Medical Language System (UMLS): integrating biomedical terminology. Nucleic Acids Res. 2004 Jan 1;32(Database issue):D267-70. doi: 10.1093/nar/gkh061. PubMed PMID: 14681409; PubMed Central PMCID: PMC308795.
Nelson SJ, Zeng K, Kilbourne J, Powell T, Moore R. Normalized names for clinical drugs: RxNorm at 6 years. J Am Med Inform Assoc. 2011 Jul-Aug;18(4)441-8. doi: 10.1136/amiajnl-2011-000116. Epub 2011 Apr 21. PubMed PMID: 21515544; PubMed Central PMCID: PMC3128404.
Metadata
Release files for cumulus-library-rxnorm 1.0.2
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 |
|---|---|---|---|---|
| cumulus_library_rxnorm-1.0.2.tar.gz | 5.5 kB | With provenance | Details for cumulus_library_rxnorm-1.0.2.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| cumulus_library_rxnorm-1.0.2-py3-none-any.whl | Python 3 | none | any | Details for cumulus_library_rxnorm-1.0.2-py3-none-any.whl |
Total release size: 11.4 kB
Release files / cumulus_library_rxnorm-1.0.2.tar.gz
| Download URL | cumulus_library_rxnorm-1.0.2.tar.gz |
|---|---|
| Size | 5.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b903034d7fc080a5ce49d248554a7ab54b88e9f479d3695a000db534f8c8b146
|
|
BLAKE2b-256 checksum How to use checksums |
93242a47e4e42442da51caff8b8140e4ab44dec62637aeb05bb636c8049763b7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
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 Oct 21, 2026.
Transparency logRelease files / cumulus_library_rxnorm-1.0.2-py3-none-any.whl
| Download URL | cumulus_library_rxnorm-1.0.2-py3-none-any.whl |
|---|---|
| Size | 5.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
114786370960271ea9e3984abdc0412b318ff42836836df8c4efece056afd565
|
|
BLAKE2b-256 checksum How to use checksums |
7e8e64a9fc392502dfb4dd89c97894905fd1209b958706fe4a6a3df8769fc6d0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
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 Oct 21, 2026.
Transparency logSecurity for cumulus-library-rxnorm 1.0.2
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.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for cumulus_library_rxnorm-1.0.2.tar.gz
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 Oct 21, 2026.
Transparency logA 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.
