AlphaGenome at TACC
Last update: August 11, 2026
AlphaGenome is Google DeepMind's unified DNA sequence model for regulatory variant-effect prediction and studying genome function. It analyzes DNA sequences of up to 1 million base pairs and produces predictions at single base-pair resolution across many modalities, including gene expression, splicing, chromatin accessibility, and contact maps. The model is described in the Nature paper and the source code is available on GitHub; see also the official AlphaGenome documentation.
At TACC, AlphaGenome is provided as a containerized environment module on Vista and Stampede3. The container bundles Python, JAX with GPU support, and the AlphaGenome code; you provide your own model weights and run predictions with a short Python script through the run_alphagenome command.
Note
AlphaGenome runs on GPU nodes (Vista Grace-Hopper, Stampede3 H100). You use its Python API, either interactively or from a script. The module wraps this in a run_alphagenome command.
Installations at TACC
Important
To run AlphaGenome at TACC you must obtain the model weights yourself by accepting DeepMind's non-commercial AlphaGenome Model Terms of Use. TACC cannot distribute the model weights. See Access below.
Table 1. Installations at TACC
| HPC Resource | Latest Version |
|---|---|
| Vista | AlphaGenome: v0.3.0 Reference: /scratch/tacc/apps/bio/alphagenome/0.3.0/referenceExamples: /scratch/tacc/apps/bio/alphagenome/0.3.0/examplesModule: /scratch/tacc/apps/bio/alphagenome/modulefiles |
| Stampede3 | AlphaGenome: v0.3.0 Reference: /scratch/tacc/apps/bio/alphagenome/0.3.0/referenceExamples: /scratch/tacc/apps/bio/alphagenome/0.3.0/examplesModule: /scratch/tacc/apps/bio/alphagenome/modulefiles |
| Horizon | Coming soon |
Access
Because of AlphaGenome's licensing restrictions, users must obtain the model weights directly from Google DeepMind. To obtain and stage the weights:
- Accept the AlphaGenome Model Terms of use from Kaggle or Hugging Face.
- Download all five AlphaGenome models. The per-fold tarball is the easiest format to download.
-
Extract them into a directory you own (your
$WORKis recommended), with one subdirectory per fold:$WORK/alphagenome/models/ ├── all_folds/ ├── fold_0/ ├── fold_1/ ├── fold_2/ └── fold_3/
Note
TACC cannot distribute the AlphaGenome model weights. Each user must download their own after accepting the model terms.
Running AlphaGenome
AlphaGenome has no dedicated command-line tool. Instead you use its Python API — either interactively or from a script — and run it with run_alphagenome, which executes Python inside a container on the GPU. run_alphagenome my_script.py runs a script; run_alphagenome with no argument opens an interactive Python session.
Load the module
module use /scratch/tacc/apps/bio/alphagenome/modulefiles
module load alphagenome/0.3.0-ctr
export AG_MODELS_DIR=$WORK/alphagenome/models # your own weights (see Access)
The module sets these variables for you:
| Variable | Meaning |
|---|---|
AG_REFERENCE_DIR |
Shared genome reference files (set by TACC) |
AG_EXAMPLES_DIR |
Example scripts, including variant_pred.py |
AG_IMAGE |
Path to the container image |
AG_MODELS_DIR |
You set this — your downloaded weights |
Run module help alphagenome at any time for a summary.
Directory Structure
We recommend working from $SCRATCH. A typical layout:
alphagenome_project/
├── my_analysis.py
└── slurm_jobs/
└── alphagenome.slurm
Writing an analysis script
A complete working example is provided at $AG_EXAMPLES_DIR/variant_pred.py. Copy it as a starting point:
cp $AG_EXAMPLES_DIR/variant_pred.py .
It reads AG_MODELS_DIR and AG_REFERENCE_DIR from the environment, builds the model, scores a variant, and writes a plot (pv.png). The essential structure:
import os
import jax
# Initialize the GPU and fail loudly if we somehow landed on CPU (10-100x slower).
assert jax.devices()[0].platform == "gpu", f"Expected a GPU, got {jax.devices()}"
from alphagenome.data import genome
from alphagenome_research.model import dna_model
MODELS = os.environ["AG_MODELS_DIR"]
REF = os.environ["AG_REFERENCE_DIR"]
model = dna_model.create(
checkpoint_path=os.path.join(MODELS, "all_folds") + "/",
organism_settings={
dna_model.Organism.HOMO_SAPIENS: dna_model.OrganismSettings(
fasta_path=f"{REF}/gencode/hg38/GRCh38.p13.genome.fa",
gtf_feather_path=f"{REF}/gencode/hg38/gencode.v46.annotation.gtf.gz.feather",
# ... (see the full example for all reference paths) ...
),
},
device=jax.local_devices()[0],
)
# ... build a genome.Interval / genome.Variant and call model.predict_variant(...) ...
For the full API and more examples, see the official AlphaGenome documentation and the quick-start notebook.
Interactive development (idev)
Grab a GPU node with idev (queue gh on Vista, h100 on Stampede3), load the module, and set your weights:
login1$ idev -p gh -N 1 -t 01:00:00 # request 1 Vista Grace-Hopper GPU node for 1 hour
...
c123-456$ module use /scratch/tacc/apps/bio/alphagenome/modulefiles
c123-456$ module load alphagenome/0.3.0-ctr
c123-456$ export AG_MODELS_DIR=$WORK/alphagenome/models
From there you can work interactively:
# Open an interactive Python session inside the container (no argument):
run_alphagenome
Batch jobs (SLURM)
An example job script is provided in $AG_EXAMPLES_DIR. A minimal batch job:
Vista
Modify the following job script for use on Stampede3.
#!/bin/bash
#SBATCH -J alphagenome
#SBATCH -o alphagenome.%j.out
#SBATCH -e alphagenome.%j.err
#SBATCH -p gh # Vista Grace-Hopper GPU queue
#SBATCH -N 1
#SBATCH -n 1
#SBATCH -t 01:00:00
#SBATCH -A your-project # your allocation
module use /scratch/tacc/apps/bio/alphagenome/modulefiles
module load alphagenome/0.3.0-ctr
export AG_MODELS_DIR=$WORK/alphagenome/models
cp $AG_EXAMPLES_DIR/variant_pred.py .
run_alphagenome variant_pred.py
Large sequences: unified memory (Vista)
On Vista's GH200, you can let the GPU spill to host RAM for very long sequences by setting and exporting the following environment variables prior to running run_alphagenome:
export XLA_PYTHON_CLIENT_PREALLOCATE=false
export TF_FORCE_UNIFIED_MEMORY=true
export XLA_CLIENT_MEM_FRACTION=3.2
Stampede3
Modify the following job script for use on Stampede3.
#!/bin/bash
#SBATCH -J alphagenome
#SBATCH -o alphagenome.%j.out
#SBATCH -e alphagenome.%j.err
#SBATCH -p h100 # Stampede3 H100 GPU queue
#SBATCH -N 1
#SBATCH -n 1
#SBATCH -t 01:00:00
#SBATCH -A your-project # <-- your allocation
module use /scratch/tacc/apps/bio/alphagenome/modulefiles
module load alphagenome/0.3.0-ctr
export AG_MODELS_DIR=$WORK/alphagenome/models
cp $AG_EXAMPLES_DIR/variant_pred.py .
run_alphagenome variant_pred.py
Submit your job script on the command-line:
$ sbatch alphagenome.slurm
Program outputs, such as pv.png, are written to the directory you submitted from.
Citation
If you use AlphaGenome at TACC in your research, please cite:
Avsec, Ž., Latysheva, N., Cheng, J. et al. Advancing regulatory variant effect prediction with AlphaGenome. Nature 649, 1206–1218 (2026). https://doi.org/10.1038/s41586-025-10014-0
and acknowledge:
The authors acknowledge the Texas Advanced Computing Center (TACC) at The University of Texas at Austin for providing computational resources that have contributed to the research results reported within this paper. URL: http://www.tacc.utexas.edu