About
Nirvana (Nimble and Robust Variant Annotator) is an open-source bioinformatics tool developed by Illumina for annotating genetic variants identified in next-generation sequencing (NGS) workflows. It processes standard VCF (Variant Call Format) files and enriches them with annotations from industry-standard databases such as ClinVar, gnomAD, dbSNP, OMIM, 1000 Genomes, RefSeq, Ensembl, and more. Designed for clinical and research genomics pipelines, Nirvana delivers fast, accurate, and reproducible annotations across small variants (SNVs/indels), structural variants, copy number variants (CNVs), and repeat expansions. Its modular architecture supports custom annotation sources, enabling teams to integrate proprietary or institution-specific datasets. Nirvana supports AWS Lambda-based cloud deployments (via NirvanaLambda and related modules), making it suitable for scalable, cloud-native genomics workflows. It outputs JSON-formatted annotation results, which are easy to parse and integrate downstream. The tool is built with .NET/C# and targets bioinformaticians, clinical genomics labs, and developers building genomic analysis pipelines. Although the repository was archived by Illumina in April 2026, it remains a reference-quality open-source resource for variant annotation. It is widely used in academic research, clinical diagnostics, and large-scale population genomics studies.
Key Features
- Multi-Database Variant Annotation: Annotates VCF variants using ClinVar, gnomAD, dbSNP, 1000 Genomes, RefSeq, Ensembl, and other curated genomic databases in a single pass.
- Support for All Variant Types: Handles SNVs, indels, structural variants, copy number variants (CNVs), repeat expansions, and mitochondrial heteroplasmy variants.
- Cloud-Native Lambda Deployment: Includes AWS Lambda-compatible modules (NirvanaLambda, AnnotationLambda) for scalable, serverless genomics annotation in cloud environments.
- Custom Annotation Sources: Supports pluggable custom annotation datasets, allowing labs to integrate proprietary or institution-specific variant databases alongside public resources.
- JSON Output Format: Outputs richly structured JSON annotation results that are easy to parse, query, and integrate into downstream bioinformatics pipelines and reporting tools.
Use Cases
- Annotating somatic and germline variants from clinical NGS panels with ClinVar pathogenicity classifications and population frequency data.
- Integrating variant annotation into cloud-based genomics pipelines using AWS Lambda for scalable, on-demand processing.
- Supporting rare disease research by enriching VCF files with gene-disease associations and functional impact predictions.
- Building institutional genomics reporting systems that consume Nirvana's JSON output for automated variant interpretation.
- Population-scale genomics studies requiring fast, batch annotation of large VCF datasets across multiple samples.
Pros
- Clinical-Grade Accuracy: Developed by Illumina, a leading NGS company, with a focus on accuracy and reproducibility suitable for clinical genomics and diagnostics workflows.
- Comprehensive Annotation Coverage: Integrates a broad set of public genomic databases out of the box, reducing the need to manage multiple annotation tools separately.
- Cloud and On-Premises Flexibility: Supports both local execution and cloud-native AWS Lambda deployments, making it adaptable to various infrastructure setups.
- Open Source and Free: Freely available under an open-source license on GitHub, with no licensing costs for academic or commercial use.
Cons
- Repository Archived: Illumina archived the Nirvana repository in April 2026, meaning no new features, bug fixes, or database updates will be released going forward.
- .NET Dependency: Built on .NET/C#, which may require additional setup or runtime installation for teams whose infrastructure is primarily Python- or Java-based.
- Steep Learning Curve for New Users: Requires familiarity with VCF file formats, bioinformatics workflows, and genomic databases to configure and use effectively.
Frequently Asked Questions
What is Nirvana used for?
Nirvana is used to annotate genetic variants in VCF files with information from databases like ClinVar, gnomAD, and dbSNP, supporting clinical and research genomics pipelines.
Is Nirvana still actively maintained?
No. The Nirvana GitHub repository was archived by Illumina on April 20, 2026, and is now read-only. Existing releases and source code remain available but no further updates are expected.
What variant types does Nirvana support?
Nirvana supports SNVs, indels, structural variants, copy number variants (CNVs), repeat expansions, and mitochondrial heteroplasmy variants.
Can Nirvana run in the cloud?
Yes. Nirvana includes AWS Lambda-compatible modules (NirvanaLambda, AnnotationLambda, GeneAnnotationLambda) for serverless, scalable cloud deployments.
What programming language is Nirvana written in?
Nirvana is written in C# and runs on the .NET platform, requiring the .NET runtime to be installed on the target system.
