> For the complete documentation index, see [llms.txt](https://help.connected.illumina.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.connected.illumina.com/annotation/introduction/readme.md). # Welcome **DRAGEN Annotation** (previously known as Illumina Connected Annotation and Nirvana) is a software tool that provides translational research-grade variant annotation from AI models and traditional sources for genomic data. It annotates SNVs, MNVs, insertions, deletions, indels, STRs, gene fusions, and structural variants, including CNVs. You can run it as a standalone package or embed it in larger workflows. Inputs are VCF files. Outputs are structured JSON or optional VCF. JSON is the default and most complete output format. VCF output supports a reduced annotation set. ### Start here To get started, select the guide for your version:
Cover image
Current — v4.0 — recommended for new deploymentsScreenshot 2026-09-29 at 1.24.21 PM.pngv4.0
Previous — v3.27 — maintained documentationScreenshot 2026-09-29 at 1.24.25 PM.pngv3.27
### What does DRAGEN Annotation annotate? DRAGEN Annotation uses Sequence Ontology consequences to describe transcript impact.
Variant consequence overview

Transcript consequences are reported using Sequence Ontology terms.

### Software Download Please visit [DRAGEN Annotation](https://developer.illumina.com/illumina-connected-annotations). ### Reference genome support DRAGEN Annotation supports `GRCh37.p13` and `GRCh38.p14`. We recommend using `GRCh38.p14` for any new work. See specific versioned user guides for details on supported reference genomes. ### Supplementary annotations DRAGEN Annotation adds external data sources for variant and gene context. Content is available in two tiers: * **Basic** — available without a premium license * **Professional** — requires a license For licensing details, see [Licensed Content](/annotation/v3.27/introduction/licensedcontent.md). For access, contact `annotation_support@illumina.com`.
Data SourceAvailability
COSMICProfessional
OMIMProfessional
✨ PrimateAI-3DProfessional
✨ PromoterAIProfessional
✨ SpliceAIProfessional
✨ SpliceAI2Professional
1000 Genomes ProjectBasic
ABraOMBasic
AlphaMissenseBasic
Amino Acid ConservationBasic
Cancer HotspotsBasic
ClinGenBasic
ClinVarBasic
ClinVar PreviewBasic
DANNBasic
dbSNPBasic
DECIPHERBasic
FusionCatcherBasic
GERPBasic
GME VariomeBasic
gnomADBasic
Mitochondrial HeteroplasmyBasic
MITOMAPBasic
MultiZ 100 WayBasic
PhyloP PrimateBasic
REVELBasic
TOPMedBasic
--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://help.connected.illumina.com/annotation/introduction/readme.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.