Skip to main content

GPN — Genomic Pretrained Network

CI Documentation PyPI Python 3.13 License

Quick start · Model families · Demos · Documentation

GPN-Star architecture, evolutionary scales, and genomic prediction tasks

Code and resources for genomic language models GPN, GPN-MSA, PhyloGPN and GPN-Star.

Quick start

pip install gpn

Load GPN-Star, our latest model, with standard Transformers AutoClasses:

from gpn import register_auto_classes
from transformers import AutoModelForMaskedLM

register_auto_classes("star")
model = AutoModelForMaskedLM.from_pretrained("songlab/gpn-star-hg38-v100-200m")

Explore the GPN-Star models, alignments, scores, and benchmark datasets.

Model families

Model Paper Notes
GPN Benegas et al. 2023 Requires unaligned genomes
GPN-MSA Benegas et al. 2025 Requires aligned genomes for training and inference; deprecated in favor of GPN-Star
PhyloGPN Albors et al. 2025 Uses an alignment during training, but does not require it for inference or fine-tuning
GPN-Star Ye et al. 2025 Requires aligned genomes for training and inference

Command line

Install file-backed inference dependencies with pip install "gpn[inference]" or training dependencies with pip install "gpn[train]".

gpn ss {train,vep,logits,embedding} ...
gpn msa {vep,logits,embedding} ...
gpn star {train,vep,logits,embedding} ...

See the CLI guide for inputs, outputs, and multi-GPU inference.

Training

GPN and GPN-Star can be trained on prepared data using the maintained GPN and GPN-Star recipes.

Demos

Historical analyses

The paper analyses and retired research workflows are preserved in the analysis-archive-2026-08-18 archive.

Development and help

See the documentation, ask questions in Discussions, or report problems in Issues.

GPN is developed in the Song Lab at UC Berkeley and distributed under the MIT License.

Citation

GPN:

@article{benegas2023dna,
  title={DNA language models are powerful predictors of genome-wide variant effects},
  author={Benegas, Gonzalo and Batra, Sanjit Singh and Song, Yun S},
  journal={Proceedings of the National Academy of Sciences},
  volume={120},
  number={44},
  pages={e2311219120},
  year={2023},
  publisher={National Acad Sciences}
}

GPN-MSA:

@article{benegas2025dna,
  title={A DNA language model based on multispecies alignment predicts the effects of genome-wide variants},
  author={Benegas, Gonzalo and Albors, Carlos and Aw, Alan J and Ye, Chengzhong and Song, Yun S},
  journal={Nature Biotechnology},
  pages={1--6},
  year={2025},
  publisher={Nature Publishing Group US New York}
}

PhyloGPN:

@inproceedings{albors2025phylogenetic,
  title={A Phylogenetic Approach to Genomic Language Modeling},
  author={Albors, Carlos and Li, Jianan Canal and Benegas, Gonzalo and Ye, Chengzhong and Song, Yun S},
  booktitle={International Conference on Research in Computational Molecular Biology},
  pages={99--117},
  year={2025},
  organization={Springer}
}

GPN-Star:

@article{ye2025predicting,
  title={Predicting functional constraints across evolutionary timescales with phylogeny-informed genomic language models},
  author={Ye, Chengzhong and Benegas, Gonzalo and Albors, Carlos and Li, Jianan Canal and Prillo, Sebastian and Fields, Peter D and Clarke, Brian and Song, Yun S},
  journal={bioRxiv},
  pages={2025--09},
  year={2025},
  publisher={Cold Spring Harbor Laboratory}
}

Sorghum gene expression prediction:

@article{groover2026mapping,
  title={Mapping cis-regulatory mutations at scale in sorghum enables modulation of gene expression},
  author={Groover, Evan D and Ding, David and Wang, Flora Z and Benegas, Gonzalo and Rivera, Joseph and Schwartz, Shahar and Chen, Stephen and Moubarak, Michael F and Georgieva, Viktoriya and Lemaux, Peggy G and others},
  journal={Nature Biotechnology},
  pages={1--11},
  year={2026},
  publisher={Nature Publishing Group US New York}
}

Metadata

Release files for gpn 0.9.0

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

Source distribution (sdist)

Source distribution for gpn 0.9.0
File Size Uploaded
gpn-0.9.0.tar.gz 1.5 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for gpn 0.9.0
File Interpreter ABI Platform
gpn-0.9.0-py3-none-any.whl Python 3 none any Details

Total release size: 1.6 MB

Release files / gpn-0.9.0.tar.gz

Download URL gpn-0.9.0.tar.gz
Size 1.5 MB
Tags Source
SHA-256 checksum
How to use checksums
ad3c4ed9cc1013b26675b55f9f81b14329b5c4ef2344db1dd5d7725b52442316
BLAKE2b-256 checksum
How to use checksums
5929c36b87344b57397ca200d7e2cea8117c280ff308bb864231c4030322c1a6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 Aug 26, 2026.

Transparency log

Release files / gpn-0.9.0-py3-none-any.whl

Download URL gpn-0.9.0-py3-none-any.whl
Size 68.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
7a175368577a851593bacca774caa80da3185aea375a0ab25fcf12147ecddd47
BLAKE2b-256 checksum
How to use checksums
e7246150ccb0b8475cee9ea362e50ef122f7082becb6a7f5577bed4dd3e6a60f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 Aug 26, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

0.9.0 This release

2 release files

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