gi-promoter

Detect promoter regions in DNA sequences via the Genomic Intelligence promoter-prediction API.

1.1k|257|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/ClawBio/ClawBio --skill gi-promoter
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gi-promoter
Source: https://github.com/ClawBio/ClawBio/tree/main/skills/gi-promoter
Command: npx skills add https://github.com/ClawBio/ClawBio --skill gi-promoter

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests.

What problem does it solve?

Predicting promoter regions in a multi-kilobase DNA sequence normally requires GPU infrastructure, model weight downloads, tokenization, and windowing logic. This Skill replaces that setup with a single CLI call to the hosted Genomic Intelligence G0 transformer (GENA-LM BERT Large), returning per-window promoter probabilities and called regions in under a second.

Core Features & Use Cases

  • Hosted promoter inference: Submits a single-record FASTA (300–500,000 bp) to the /v1/tasks/promoter/predict endpoint, which windows the sequence internally with a 2000 bp context and 1000 bp stride.
  • Structured outputs: Writes a Markdown report with called promoter regions, a full JSON result envelope including rate-limit metadata, and a reproducibility bundle (command.sh + environment.json) for exact reruns.
  • Strand and length validation: Rejects out-of-bounds sequences locally, warns when input is shorter than the model context window, and documents that minus-strand genes must be reverse-complemented to gene-sense before submission.
  • Use Case: A researcher studying TP53 regulation runs the bundled demo on the 25.8 kbp TP53 locus to identify which windows cross the 0.5 promoter threshold, then chains the called regions into variant-annotation or gwas-lookup skills.

Quick Start

Run the gi-promoter skill with the --demo flag to predict promoter regions in the bundled TP53 FASTA sequence and write the report to an output directory.

Frequently Asked Questions about gi-promoter

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I predict promoter regions in a DNA sequence?

Run the gi-promoter CLI with a single-record FASTA file between 300 and 500,000 bp. The sequence is posted to the Genomic Intelligence /v1/tasks/promoter/predict endpoint, which windows it internally and returns per-window promoter probabilities plus called regions.

What model does the Genomic Intelligence promoter API use?

The default model is a GENA-LM BERT Large transformer with a 2000 bp context window and 1000 bp prediction stride. Shorter-context and DNABERT variants are also published; query GET /v1/tasks/promoter/models for the current list of model ids.

Do I need an API key for promoter prediction?

Yes, the skill requires a Genomic Intelligence partner key supplied via the --api-key flag or the GI_API_KEY environment variable. A shared hackathon-tier key ships in the repo's .env.example, and individual keys can be requested from [email protected].

Why does promoter prediction return no regions for my sequence?

An empty result often indicates wrong strand orientation, because the model is strand-sensitive and scores collapse below threshold on the genomic strand of minus-strand genes. Reverse-complement the sequence to gene-sense before submitting, and check that N-content is not dominating the region.

What are the sequence length limits for the promoter API?

Sequences must be 300 to 500,000 bp after whitespace stripping, enforced as minLength and maxLength on the request schema. Violations return a 422 validation_failed error, and the skill rejects out-of-bounds input locally before spending an API request.

Is it safe to upload patient genomic data to this API?

No, this skill performs remote inference, so submitted sequences traverse the hosted Genomic Intelligence endpoint. Do not submit identifiable patient data without an appropriate data-use agreement; the skill is intended for research and development use only.