The properly rendered version of this document can be found at Read The Docs.
If you are reading this on github, you should instead click here.
What’s a beacon? 
A beacon is a simple web service that answers questions of the form, “Do you have any genomes with an ‘A’ at position 100,735 on chromosome 3?” (or similar data). It responds simply with either “Yes” or “No.” This open web service is designed both to be technically simple (so it is easy to implement) and to mitigate risks associated with genomic data sharing.
We call these applications “Beacons” because, like the SETI project, many dedicated people have been scanning the universe of human research for signs of willing participants in far-reaching data sharing efforts, but despite many assurances of interest, it has remained a dark and quiet place. Once your “Beacon” is lit, you can start to take the next steps to add functionality to it, and finding the other groups who may help by following their Beacons.
There is an AppEngine implementation of the Beacon API from the Global Alliance for Genomics and Health written in Go. Here is an example query that is running against a private copy (for demonstration purposes) of the Illumina Platinum Genomes variants:
To turn on a beacon for your own data:
- First, load your data into Google Genomics. See Load Genomic Variants for more detail as to how to do this.
- Then follow the instructions on https://github.com/googlegenomics/beacon-go to deploy the AppEngine implementation of Beacon.