Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

CLI Logo

CLI Tests Python Code style: black pypi License

A command line interface to query the MetaHQ database.

Key features

  • Query standardized and harmonized biomedical annotations
  • Access metadata for samples and studies in GEO and SRA
  • Convert annotations to labels
  • Fast execution time
  • Search for relevant ontology terms with free-text queries
  • Contribute new annotation sets to the database

Docs

Documentation: https://meta-hq.readthedocs.io/en/latest

Source Code: https://github.com/krishnanlab/meta-hq/tree/main/packages/cli

Installation and setup

To install:

pip install metahq-cli

Setup: This command must be run with every metahq-cli installation. The setup command downloads the MetaHQ database from Zenodo.

metahq setup --doi latest

Retrieve

Query the MetaHQ database to retrieve sample or study annotations for tissues, diseases, sex, and age.

metahq retrieve diseases --terms "MONDO:0004994,MONDO:0008903" \
--level sample --filters "species=human,tech=rnaseq,ecode=expert" \
--metadata "sample,series,platform,srp" --fmt parquet

Search

If you do not have ontology terms memorized off-hand, shame on you. However, you can cheat and run the following command to find the ontology term IDs most similar to a free-text query of a disease, tissue, or cell line.

metahq search --query "heart attack" --type disease --ontology MONDO

Supported

Run the following to view supported attributes, filters, formats, etc.

metahq supported

Metadata

Release files for metahq-cli 1.2.0rc2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for metahq-cli 1.2.0rc2
File Size Uploaded Provenance
metahq_cli-1.2.0rc2.tar.gz 24.3 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for metahq-cli 1.2.0rc2
File Interpreter ABI Platform
metahq_cli-1.2.0rc2-py3-none-any.whl Python 3 none any Details

Total release size: 55.5 kB

Release files / metahq_cli-1.2.0rc2.tar.gz

Download URL metahq_cli-1.2.0rc2.tar.gz
Size 24.3 kB
Tags Source
SHA-256 checksum
How to use checksums
f3c9a0e3e6566ddb43d855f4c98cde860d301aafe638a76aeb991130b0ddd250
BLAKE2b-256 checksum
How to use checksums
9f151db83b8f4efd52f6c2bcb0541de58526ac1db1aabd23c35b41ee66c42b9f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.2

Release files / metahq_cli-1.2.0rc2-py3-none-any.whl

Download URL metahq_cli-1.2.0rc2-py3-none-any.whl
Size 31.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
2b13a4c16a1f8c6efff55dff19b7047662137109f04f7d5d8f882372d9f70b0d
BLAKE2b-256 checksum
How to use checksums
0fa1d2c17b56f7900bda0652722ef7a08dece6aca01d6d70821ecf1498acd9d7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.2

Security for metahq-cli 1.2.0rc2

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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page