Skip to main content

CI Release Documentation DOI PyPI Downloads Stars

🐍 pyaging: a Python-based compendium of GPU-optimized aging clocks

pyaging is a cutting-edge Python package designed for the longevity research community, offering a comprehensive suite of GPU-optimized biological aging clocks.

Installation - Clock gallery - Search, cite, get metadata and clock parameters - Illumina Human Methylation Arrays - Illumina Mammalian Methylation Arrays - RRBS DNA methylation - Bulk histone mark ChIP-Seq - Bulk ATAC-Seq - Bulk RNA-Seq - Blood chemistry - CpGPTGrimAge3 - API Reference

With a growing number of aging clocks and biomarkers of aging, comparing and analyzing them can be challenging. pyaging simplifies this process, allowing researchers to input various molecular layers (DNA methylation, histone ChIP-Seq, ATAC-seq, transcriptomics, etc.) and quickly analyze them using multiple aging clocks, thanks to its GPU-backed infrastructure. This makes it an ideal tool for large datasets and multi-layered analysis.

📦 Installation

pyaging requires Python 3.11 or newer and is available on PyPI:

pip install pyaging

To use the histone mark clocks, install the optional pyBigWig dependency as well (not supported on Windows):

pip install pyaging[histone]

🚀 Quickstart

import pandas as pd
import pyaging as pya

pya.data.download_example_data("GSE139307")
df = pd.read_pickle("pyaging_data/GSE139307.pkl")

adata = pya.pp.df_to_adata(df)
pya.pred.predict_age(adata, ["Horvath2013", "AltumAge", "DunedinPACE"])
adata.obs.head()

Clock weights are downloaded on demand from per-clock repositories under the pyaging Hugging Face organization (example data comes from lucascamillomd/pyaging-data). Set the PYAGING_DATA_REVISION environment variable to a release tag (e.g. v0.3.1) to pin downloads to a specific data revision for reproducibility; it defaults to main, the live data release.

❓ Can't find an aging clock?

If you have recently developed an aging clock and would like it to be integrated into pyaging, please email me. I aim to incorporate it within one to two weeks! I'm also happy to adapt to any licensing terms for commercial entities.

💬 Community Discussion

For coding-related queries, feedback, and discussions, please visit our GitHub Issues page.

📝 Changelog

Notable changes, including breaking ones, are recorded in CHANGELOG.md. Per-version release artifacts and the commit log are on the GitHub Releases page.

📖 Citation

To cite pyaging, please use the following:

@article{de_Lima_Camillo_pyaging,
    author = {de Lima Camillo, Lucas Paulo},
    title = "{pyaging: a Python-based compendium of GPU-optimized aging clocks}",
    journal = {Bioinformatics},
    pages = {btae200},
    year = {2024},
    month = {04},
    issn = {1367-4811},
    doi = {10.1093/bioinformatics/btae200},
    url = {https://doi.org/10.1093/bioinformatics/btae200},
    eprint = {https://academic.oup.com/bioinformatics/advance-article-pdf/doi/10.1093/bioinformatics/btae200/57218155/btae200.pdf},
}

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pyaging-0.5.0.tar.gz (57.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

pyaging-0.5.0-py3-none-any.whl (65.9 kB view details)

Uploaded Python 3

File details

Details for the file pyaging-0.5.0.tar.gz.

File metadata

  • Download URL: pyaging-0.5.0.tar.gz
  • Upload date:
  • Size: 57.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for pyaging-0.5.0.tar.gz
Algorithm Hash digest
SHA256 abfffe7f1e35717b6cc9c0f2f1f114b3069cf061c398a4c19c9aeb761e973e78
MD5 106d07a296190bd6e9106c2a8f4a3ae7
BLAKE2b-256 4fdd1e8989095a93b1879c6d07d327b005fc1113b29f70de3b09aceb7eb2ab6b

See more details on using hashes here.

Provenance

The following attestation bundles were made for pyaging-0.5.0.tar.gz:

Publisher: release.yaml on lucascamillomd/pyaging

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file pyaging-0.5.0-py3-none-any.whl.

File metadata

  • Download URL: pyaging-0.5.0-py3-none-any.whl
  • Upload date:
  • Size: 65.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for pyaging-0.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 2e320ec447525c58fcd2b6375601d8454fbb93c4728f31bba72f704bc7195f2c
MD5 c2f83159c930fb281175bbe398346e38
BLAKE2b-256 c325878724d41f49583e5ba556dce2eb5c8e33e4ed3e86fc4ea8aefcf78e4d06

See more details on using hashes here.

Provenance

The following attestation bundles were made for pyaging-0.5.0-py3-none-any.whl:

Publisher: release.yaml on lucascamillomd/pyaging

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.5.1

2 files

This release

0.5.0 This release

2 files

0.4.0

2 files

0.3.1

2 files

0.3.0

2 files

0.2.0

2 files

0.1.30

2 files

0.1.29

2 files

0.1.28

2 files

0.1.27

2 files

0.1.25

2 files

0.1.24

2 files

0.1.23

2 files

0.1.22

2 files

0.1.21

2 files

0.1.20

2 files

0.1.19

2 files

0.1.18

2 files

0.1.17

2 files

0.1.16

2 files

0.1.15

2 files

0.1.14

2 files

0.1.13

2 files

0.1.12

2 files

0.1.11

2 files

0.1.10

2 files

0.1.9

2 files

0.1.8

2 files

0.1.7

2 files

0.1.6

2 files

0.1.5

2 files

0.1.4

2 files

0.1.3

2 files

0.1.2

2 files

0.1.1

2 files

0.1.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page