# Install vcfanno with Homebrew, apt

Annotate a VCF with other VCFs/BEDs/tabixed files. Version 0.3.9 via Homebrew; verified 2026-07-26. Also installable with debian: sudo apt install vcfanno.

## Install

```sh
sudo av install brew:vcfanno
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install vcfanno
```

  Evidence: local Homebrew formula metadata

### Linux

- Debian apt (92%):

```sh
sudo apt install vcfanno
```

  Evidence: Debian stable package indexes: vcfanno from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

## Package facts

- **Package key:** brew:vcfanno
- **Package manager:** Homebrew
- **Version:** 0.3.9
- **Source summary:** Annotate a VCF with other VCFs/BEDs/tabixed files
- **Homepage:** <https://genomebiology.biomedcentral.com/articles/10.1186/s13059-016-0973-5>
- **Repository:** <https://github.com/brentp/vcfanno>
- **Last updated:** 2026-07-26T00:30:00+02:00
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- vcfanno (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 0.3.9
## Project history and usage

vcfanno is a Go command-line tool for annotating VCF records with fields from other VCF, BED, BAM, or tabix-indexed files. It became notable in genomics workflows because it treats annotation as a configurable stream-processing problem: many external resources can be summarized and added to the INFO field of a query VCF.

### Project history

The first GitHub release, v0.0.1, was published on April 29, 2015. Early 2015 releases quickly added support for annotating variant ends, BED files, custom scripting, and an API, which matches the project's focus on flexible annotation rather than a fixed database.

Pedersen, Layer, and Quinlan published the vcfanno software paper in Genome Biology on June 1, 2016. The paper framed the problem as integrating genome annotations from diverse file formats and described vcfanno as extracting and summarizing attributes from multiple annotation files into the INFO column of the original VCF.

### Adoption history

The Genome Biology paper reported strong performance on whole-genome annotation workloads, including roughly 85,000 variants per second with 50 attributes from 17 commonly used annotation resources. That performance claim helped establish vcfanno as a practical tool for large human variant datasets as well as non-human species.

The project README asks users to cite the paper and shows active maintenance through many GitHub releases, including v0.3.9 in June 2026. It is also packaged by Bioconda and distribution package managers, which places it in the standard bioinformatics command-line ecosystem.

### How it is used

Users write a TOML configuration with one or more `[[annotation]]` blocks that name source files, fields or columns, operations, and output INFO names. vcfanno then streams a query VCF and writes an annotated VCF, commonly with `-p` for parallelism and optional Lua scripts for custom reductions.

Common tasks include overlaying population allele frequencies, conservation scores, ClinVar or ExAC-like annotations, BED-derived regional scores, BAM-derived coverage summaries, and structural-variant endpoint annotations onto a study VCF before filtering or interpretation.

### Why package nerds care

vcfanno matters to package people because it turns a pile of tabix-indexed genomics resources into a reproducible, reviewable config file and one CLI invocation. That is exactly the shape package managers like: a small binary that composes with bgzip/tabix, pipes, VCF validators, and downstream filters.

It also represents the post-VCF-standard tooling wave: once VCF became the lingua franca, the hard day-to-day problem shifted to attaching the right outside evidence to millions of variants quickly and repeatably.

### Timeline

- 2015-04-29: vcfanno v0.0.1 is published as the initial GitHub release.
- 2015-05-04: v0.0.2 adds support for annotating ends of variants such as CNVs and SVs.
- 2016-06-01: The Genome Biology vcfanno paper is published.
- 2026-06-16: GitHub lists v0.3.9 as the latest release.

### Related projects

- VCFtools and HTSlib provide the broader VCF and indexed-file ecosystem that vcfanno workflows build on.
- vcflib is a companion VCF-processing toolkit; the 2022 vcflib paper also points to vcfanno as a related tool for adding annotations from VCFs and BED files.
- GATK, FreeBayes, ExAC-style resources, ClinVar-style resources, and tabix-indexed annotation files are common upstream or companion inputs in vcfanno pipelines.

### Sources

- <https://api.github.com/repos/brentp/vcfanno/releases>
- <https://github.com/brentp/vcfanno>
- <https://link.springer.com/article/10.1186/s13059-016-0973-5>
- <https://pubmed.ncbi.nlm.nih.gov/27250555/>


## Security Notes

No matching local secret-handling manifest was found for vcfanno. Nucleus package metadata is still published here so future coverage has a stable package URL.


## Other Package-Manager Records

- Debian apt - vcfanno - 0.3.5+ds-2+b9: normalized package name match | Debian stable package indexes: vcfanno from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | annotate a VCF with other VCFs/BEDs/tabixed files | https://github.com/brentp/vcfanno
- Debian apt - vcfanno-examples - 0.3.5+ds-2: normalized package name match | Debian stable package indexes: vcfanno-examples from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | examples for vcfanno: annotate a VCF with other VCFs/BEDs/tabixed files | https://github.com/brentp/vcfanno
- Ubuntu apt - vcfanno - 0.3.5+ds-2: normalized package name match | Ubuntu 24.04 LTS package indexes: vcfanno from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | annotate a VCF with other VCFs/BEDs/tabixed files | https://github.com/brentp/vcfanno
- Ubuntu apt - vcfanno-examples - 0.3.5+ds-2: normalized package name match | Ubuntu 24.04 LTS package indexes: vcfanno-examples from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | examples for vcfanno: annotate a VCF with other VCFs/BEDs/tabixed files | https://github.com/brentp/vcfanno


## Combined YAML source

View the package source record on GitHub. [combined/vcfanno.yml](https://github.com/mxcl/pkgdb/blob/main/combined/vcfanno.yml)


## Sources

- pkg.so package database
- Geiger risk classifier
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph
