Skip to content


Repository files navigation


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.


convert 23andme or raw genotype calls into VCF format, with dbSNP annotations








No packages published