Skip to content convert 23andme or raw genotype calls into VCF format, with dbSNP annotations
Go Shell Makefile
Branch: develop
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
convert fixAllosome feature added Sep 5, 2019
reference update repo layout Jun 17, 2017
.gitattributes add reference, main, with broken zip input Jan 9, 2017
.gitignore update gitignore May 16, 2019
2vcf.go fixAllosome feature added Sep 5, 2019
Gopkg.lock add dep files May 14, 2019
Gopkg.toml add dep files May 14, 2019
LICENSE.txt add license.txt an update commands to remove default referecne path Aug 25, 2019
Makefile add link to readme Sep 16, 2019 update repo layout Jun 17, 2017


in order to improve individual sovereignty over genetic/genomic information, facilitate a deeper understanding of biology and computation, and promote shared meaning, provides 2vcf under the MIT license. 2vcf will convert raw genotype data exports from 23andme or into VCF format.

2vcf produces a VCF that contains annotations from dbSNP build 151 on GRCh37.p13. these annotations include allele frequencies from various sources including 1000 Genomes and ExAC, RefSeq gene annotations, and functional class of the variant.

the source VCF for dbSNP build 151 weighs in at around 15GB. the sites assayed by personal genomics companies are but a tiny fraction of the totality of dbSNP sites. so I make available a reference version of the dbSNP VCF which has been filtered down to those sites likely to be contained in your exported 23andme or exported raw data. for more details on which sites are included and why, see this writeup on the sources for 2vcf reference v2.0.


  1. download the appropriate binary for your architecture from the most recent github release. un-tar the contents after downloading.

  2. download the reference vcf

  3. download your raw genotype data from 23andme or Ancestry.

  4. now run the 2vcf binary with the appropriate options:

./2vcf conv 23andme --ref path/to/2vcf-v2.0.vcf.gz \
    --input path/to/my/raw/ \
    --output my-personal-annotated.vcf.gz

Please report any errors or difficulties with the utility.

You can’t perform that action at this time.