alterlab-borzoi
Predict genome-wide functional genomics tracks from DNA sequence with Borzoi (Linder 2025) — a sequence-to-function model outputting RNA-seq, CAGE, ATAC, and ChIP coverage across long context, used to score non-coding and regulatory variant effects. Use when predicting functional
Install
npx skills add https://github.com/AlterLab-IEU/AlterLab-Academic-Skills/tree/main/skills/bioinformatics/alterlab-borzoi
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install alterlab-ieu-alterlab-academic-skills@llmmart
git clone https://github.com/AlterLab-IEU/AlterLab-Academic-Skills.git
The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole alterlab-ieu/alterlab-academic-skills collection as a plugin from our marketplace. Git is the plain clone.
Skill manifest
Borzoi (sequence → function)
Overview
Borzoi (Linder et al. 2025; calico/borzoi) is a sequence-to-function deep-learning
model: given a DNA sequence over a long genomic context, it predicts genome-wide functional
tracks — RNA-seq, CAGE, ATAC-seq, and ChIP coverage across many assays/tissues. Its headline
use is non-coding variant effect scoring: run the reference and alternate alleles through
the model and compare predicted tracks to estimate a regulatory variant's impact on expression
or chromatin.
It predicts function from sequence; it does not look up known variants. For a variant's
population frequency use alterlab-gnomad; for clinical significance use alterlab-clinvar.
When to Use This Skill
Use this skill when the user wants to:
- Predict functional tracks (RNA-seq/CAGE/ATAC/ChIP) from a DNA sequence or locus.
- Score a non-coding / regulatory variant's predicted effect (ref vs. alt).
- Run in-silico mutagenesis to find driver bases in a regulatory element.
- Prioritize candidate regulatory variants by predicted functional impact.
Does NOT Trigger
| Scenario | Use instead |
|---|---|
| Look up a variant's population frequency | alterlab-gnomad |
| Look up a variant's clinical significance | alterlab-clinvar |
| Predict a protein-structure / coding effect | alterlab-alphafold |
| Single-cell foundation-model tasks | alterlab-scgpt |
| Standard variant calling from reads | alterlab-nf-core-sarek (or the relevant pipeline skill) |
Hand-off rule. When the request matches a row above, open your answer by naming that skill by its exact id (for example alterlab-gnomad) and saying in one line why it fits better, then stop applying this skill's procedure. Name it even when you also need to ask for missing input. If only part of the request is out of scope, name the skill for that part and do only the in-scope part. A brief general pointer is fine; the named skill does the work.
Core Capabilities
1. Track prediction from sequence
The quickest path is the PyTorch port, which loads ported weights straight from the Hub:
from borzoi_pytorch import Borzoi
# replicates 0-3, human by default; 'johahi/borzoi-replicate-0-mouse' for mouse heads
model = Borzoi.from_pretrained("johahi/borzoi-replicate-0").eval().cuda()
# one-hot encode the reference window around your locus, then:
# predictions = model(one_hot_batch) # (batch, tracks, bins)
The reference TensorFlow implementation (calico/borzoi on top of calico/baskerville)
is the source of truth for the published results and ships the variant-scoring and
interpretation tutorials. Either way: provide a genome window (coordinates + reference, or a
FASTA), one-hot encode it, and read predicted coverage across the output tracks.
2. Non-coding variant effect scoring
The core workflow: build the reference and alternate sequences for a variant, predict tracks for each, and quantify the difference (e.g. SAD/SED-style scores) to estimate the variant's regulatory effect. Prioritize candidates by the magnitude of predicted change.
3. In-silico mutagenesis
Systematically mutate bases across a regulatory element and read the predicted-track deltas to localize functionally important positions (motif/driver discovery).
4. GPU and dispatch
Borzoi takes long context and is GPU-heavy; genome-wide or many-variant scans should be
dispatched via alterlab-remote-compute (submit → poll → harvest). Flashzoi
(johahi/flashzoi-replicate-0..3, needs FlashAttention-2) is a drop-in ~3x faster variant at
comparable accuracy — worth it for large scans.
Resources
references/borzoi_usage.md— install/pinning, sequence extraction, predict calls, ref/alt variant scoring, in-silico mutagenesis, and Enformer lineage. Loaded on demand.
Part of the AlterLab Academic Skills suite.
Files (alterlab-academic-skills)
-
evals
-
fixtures
-
enhancer.fasta 688 B · in bundle
-
-
evals.json 2.9 KB
Loading…
-
-
references
-
borzoi_usage.md 3.9 KB
Loading…
-
-
SKILL.md 5.2 KB
--- name: alterlab-borzoi description: Predict genome-wide functional genomics tracks from DNA sequence with Borzoi (Linder 2025) — a sequence-to-function model outputting RNA-seq, CAGE, ATAC, and ChIP coverage across long context, used to score non-coding and regulatory variant effects. Use when predicting functional tracks from a DNA sequence, scoring a non-coding/regulatory variant's effect on expression or chromatin, or doing in-silico mutagenesis of a locus. To LOOK UP a variant's population frequency prefer alterlab-gnomad; for its clinical significance prefer alterlab-clinvar; for protein-structure effects prefer alterlab-alphafold; for single-cell foundation models prefer alterlab-scgpt. Part of the AlterLab Academic Skills suite. license: Apache-2.0 allowed-tools: Read Write Edit Bash(python:*) Bash(uv:*) compatibility: "Reference TensorFlow code (`calico/borzoi` + `calico/baskerville` from git, TF 2.15.x) or the PyTorch port `borzoi-pytorch` (0.5.1 as of 2026-09, Hugging Face weights), under `uv run python`. Weights cache after first download; a CUDA GPU is strongly recommended (~500 kb DNA context). Input: DNA (FASTA or coordinates + reference); output: multi-track coverage arrays. Dispatch large scans via alterlab-remote-compute." metadata: skill-author: AlterLab version: "1.1.0" last_updated: "2026-09-23" --- # Borzoi (sequence → function) ## Overview **Borzoi** (Linder et al. 2025; `calico/borzoi`) is a **sequence-to-function** deep-learning model: given a DNA sequence over a long genomic context, it predicts **genome-wide functional tracks** — RNA-seq, CAGE, ATAC-seq, and ChIP coverage across many assays/tissues. Its headline use is **non-coding variant effect scoring**: run the reference and alternate alleles through the model and compare predicted tracks to estimate a regulatory variant's impact on expression or chromatin. It **predicts** function from sequence; it does not *look up* known variants. For a variant's population frequency use `alterlab-gnomad`; for clinical significance use `alterlab-clinvar`. ## When to Use This Skill Use this skill when the user wants to: - Predict **functional tracks** (RNA-seq/CAGE/ATAC/ChIP) from a DNA sequence or locus. - Score a **non-coding / regulatory variant's** predicted effect (ref vs. alt). - Run **in-silico mutagenesis** to find driver bases in a regulatory element. - Prioritize candidate regulatory variants by predicted functional impact. ### Does NOT Trigger | Scenario | Use instead | |----------|-------------| | Look up a variant's **population frequency** | `alterlab-gnomad` | | Look up a variant's **clinical significance** | `alterlab-clinvar` | | Predict a **protein-structure** / coding effect | `alterlab-alphafold` | | Single-cell foundation-model tasks | `alterlab-scgpt` | | Standard variant calling from reads | `alterlab-nf-core-sarek` (or the relevant pipeline skill) | **Hand-off rule.** When the request matches a row above, open your answer by naming that skill by its exact id (for example `alterlab-gnomad`) and saying in one line why it fits better, then stop applying this skill's procedure. Name it even when you also need to ask for missing input. If only part of the request is out of scope, name the skill for that part and do only the in-scope part. A brief general pointer is fine; the named skill does the work. ## Core Capabilities ### 1. Track prediction from sequence The quickest path is the PyTorch port, which loads ported weights straight from the Hub: ```python from borzoi_pytorch import Borzoi # replicates 0-3, human by default; 'johahi/borzoi-replicate-0-mouse' for mouse heads model = Borzoi.from_pretrained("johahi/borzoi-replicate-0").eval().cuda() # one-hot encode the reference window around your locus, then: # predictions = model(one_hot_batch) # (batch, tracks, bins) ``` The reference TensorFlow implementation (`calico/borzoi` on top of `calico/baskerville`) is the source of truth for the published results and ships the variant-scoring and interpretation tutorials. Either way: provide a genome window (coordinates + reference, or a FASTA), one-hot encode it, and read predicted coverage across the output tracks. ### 2. Non-coding variant effect scoring The core workflow: build the **reference** and **alternate** sequences for a variant, predict tracks for each, and quantify the difference (e.g. SAD/SED-style scores) to estimate the variant's regulatory effect. Prioritize candidates by the magnitude of predicted change. ### 3. In-silico mutagenesis Systematically mutate bases across a regulatory element and read the predicted-track deltas to localize functionally important positions (motif/driver discovery). ### 4. GPU and dispatch Borzoi takes long context and is GPU-heavy; genome-wide or many-variant scans should be dispatched via `alterlab-remote-compute` (submit → poll → harvest). **Flashzoi** (`johahi/flashzoi-replicate-0..3`, needs FlashAttention-2) is a drop-in ~3x faster variant at comparable accuracy — worth it for large scans. ## Resources - `references/borzoi_usage.md` — install/pinning, sequence extraction, predict calls, ref/alt variant scoring, in-silico mutagenesis, and Enformer lineage. Loaded on demand. Part of the AlterLab Academic Skills suite.
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.