1 unstable release

0.1.0	Apr 17, 2026

#69 in Value formatting

Custom license

3MB
159K SLoC

labage

Estimate your biological age from blood biomarkers — 11 aging clocks, from Levine PhenoAge to GOLD BioAge.

Your chronological age says when you were born. Your biological age says how fast you are aging. labage computes both from the same blood panel your doctor already orders.

Why This Exists · Install · How It Works · Available Clocks · Quick Start · CLI Suite

Why This Exists

Aging is not one process. Dozens of systems decline at different rates in different organs. A single number, your age in years, tells you nothing about which ones are failing and which are fine.

Aging clocks fix that. They take routine blood markers (albumin, creatinine, glucose, CRP, white blood cells) and compute a biological age that predicts mortality and disease better than calendar age. The gap between your biological and chronological age, your age acceleration, is one of the most useful numbers in longevity medicine.

labage puts 11 published aging clocks into a single CLI. Three of them (PhenoAge, GOLD BioAge, Light BioAge) run on a standard blood panel. No special tests. No epigenetic arrays. Just the CBC and CMP you get at your annual physical.

Install

cargo install --git https://github.com/199-biotechnologies/labage-cli

Requires Rust 1.70+. No runtime dependencies.

How It Works

┌─────────────────────┐     ┌──────────────┐     ┌──────────────────┐     ┌────────────────────────┐
│  labstore SQLite DB  │────▶│  labage check │────▶│  labage compute  │────▶│  Biological age per    │
│  (~/.labstore/)      │     │  (feasibility)│     │  (run clocks)    │     │  clock + acceleration  │
└─────────────────────┘     └──────────────┘     └──────────────────┘     └────────────────────────┘

Store your lab results with labstore.
Check which clocks can run given your available biomarkers.
Compute biological age across every feasible clock.

Output goes to stdout as a human-readable table on TTY or as JSON when piped. Startup is under 2ms.

Available Clocks

Clock	Modality	Markers	What It Measures	Reference
PhenoAge	Blood	9 (albumin, creatinine, glucose, CRP, lymphocyte%, MCV, RDW, ALP, WBC)	Biological age via Gompertz mortality model	Levine et al. Aging 2018
GOLD BioAge	Blood	9 (creatinine, glucose, MCV, RDW, albumin, ALP, lymphocyte%, WBC, GGT)	Biological age from CBC/CMP	Hao et al. Adv Sci 2025
Light BioAge	Blood	3 (creatinine, glucose, CRP)	Minimal biological age clock	Hao et al. Adv Sci 2025
7-Biomarker Clock	Blood	6 (albumin, creatinine, HbA1c, HDL, triglycerides, ALT)	Mortality-anchored biological age	Lagger et al. Sci Rep 2025 + Levine 2018 method
KDM BioAge	Mixed	8 (albumin, ALP, BUN, creatinine, CRP, HbA1c, total cholesterol, SBP)	Biological age via Klemera-Doubal method	Klemera & Doubal 2006; Levine 2013
LinAge	Mixed	61 optional (BMI, SBP, DBP, hemoglobin, full panel)	Sex-specific linear aging clock	Sehgal et al. 2024
GrimAge2	Epigenetic	12 (DNAm surrogates + age + sex)	Mortality-predictive epigenetic age	Lu et al. Aging 2022
PhenoAge DNAm	Epigenetic	513 CpG sites	Epigenetic biological age	Levine et al. Aging 2018
iCAS-DNAmAge	Epigenetic	65 CpG sites	Chinese-population epigenetic clock	Zheng et al. Nat Aging 2024
DunedinPACE	Epigenetic	173 CpG sites	Pace of aging (years aged per year)	Belsky et al. eLife 2022
Organ Age	Proteomic	113 optional (SomaScan proteins)	Per-organ biological age for 11 organs	Oh et al. Nature 2023

Blood-based clocks (top 4 rows) run on standard bloodwork. No special tests needed.

Quick Start

List all available clocks

labage list

Check which clocks can run for a patient

labage check boris

This reads the latest lab session from labstore and shows feasibility: which clocks are ready, which are partial, and what markers are missing.

Compute biological age

# Run all feasible clocks
labage compute boris --all

# Run a specific clock
labage compute boris --clock phenoage

# JSON output for pipelines
labage compute boris --all --json

Machine-readable capabilities

labage agent-info

Returns a JSON manifest of commands, arguments, and output schemas. Built for AI agent consumption.

Part of the Longevity CLI Suite

labage is one tool in a set of composable Rust CLIs for clinical biomarker analysis. Each does one job. They connect through JSON pipes.

Tool	What It Does
labparse	Extract biomarkers from lab PDFs, CSVs, and text
labassess	Score biomarkers against longevity-optimal ranges
labstore	SQLite database for longitudinal patient tracking
labage	Biological aging clock estimation (you are here)

Built by 199 Biotechnologies and Paperfoot AI.

Contributing

Open an issue first. We review PRs but this is an opinionated codebase. If your change touches clock coefficients or scoring logic, include the source paper DOI.

License

Built by 199 Biotechnologies · Rust on the command line · Under 2ms startup

Dependencies

~28MB
~512K SLoC