https://github.com/betatim/lhcb-voting
Anonymous, verifiable elections over the web
https://github.com/betatim/lhcb-voting
Last synced: 2 months ago
JSON representation
Anonymous, verifiable elections over the web
- Host: GitHub
- URL: https://github.com/betatim/lhcb-voting
- Owner: betatim
- License: mit
- Created: 2015-02-27T11:10:36.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2015-03-01T07:02:57.000Z (over 10 years ago)
- Last Synced: 2025-04-02T16:43:46.825Z (6 months ago)
- Language: Python
- Homepage:
- Size: 148 KB
- Stars: 4
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# lhcb-voting
One stop shop for running an election over the web
This implements the election procedure used at
the LHCb experiment.
The election is fairly anonymous. The result can
be verified by every participant, the integrity
of the election relies on a large fraction of
voters checking that their vote was counted
correctly.
# Setting up an Election
To start a new election, create a google form like
[this one](https://docs.google.com/forms/d/1exEzNZVcNa3o4KL4CpJrOPfU84_rZKzvj7sMI4L3sIQ/viewform)
You need a field to enter the token, as well as
several multiple choice fields listing the
candidates. Your form should produce a results
spreadsheet similar to
[this one](https://docs.google.com/spreadsheets/d/1FUIG6S118rKZPwJsqSpWW9eZGn67lHdk8MyeJd2agRc/edit?usp=sharing).
Then edit `send_ballots.py` to include the email
addresses of all eligible voters, as well as
modifying the text of the email, link to the form,
etc, etc.
Afterwards run it, it will send one email to each
voter with instructions for them.
It will create a file named `valid_tokens.txt`
make sure to keep a copy as it will be needed
to verify the election and compute the result.
# Counting Votes
Once the election has finished, download the
results spreadsheet as CSV from Google Drive and
name it `election.csv`. Place it in the directory
together with `verify_election.py` and
`valid_tokens.txt`.
You shoud publish both `election.csv` and
`valid_tokens.txt`in a place accessible to all
participants. This will allow them to verify
that their vote was recorded correctly and thereby
verify the outcome of the election.
To count the votes run `verify_election.py`. It
will print the winner of each round, as well as
the overall winner.
It will perform at most 50 rounds of elimination
and stop if there is no winner by that time.
# A Voters Guide
You will receive an email with instructions.
Follow them. Protect your token, if someone
else obtains a copy they can cast votes in your
name. They can also reveal how you voted once
the election has ended.
You should obtain a copy of `election.csv` and
`valid_tokens.txt` once polling has ended. Use
them to verify that your vote was recorded
correctly. You can compute the outcome of
the election yourself with that information,
doing this will increase the credibility of
the election. See "Counting Votes" for how
to do this.
# Technical Details
To come, for the moment simply read the code.