Microsoft Defending Democracy Program: ElectionGuard Python

๐Ÿ—ณ ElectionGuard Python

Github Package Action Language grade: Python Total alerts Documentation Status license

This repository is a "reference implementation" of ElectionGuard written in Python 3. This implementation can be used to conduct End-to-End Verifiable Elections as well as privacy-enhanced risk-limiting audits. Components of this library can also be used to construct "Verifiers" to validate the results of an ElectionGuard election.

๐Ÿ“ In This Repository

File/folder Description
docs Documentation for using the library
src/electionguard Source code to the ElectionGuard library
src/electionguardtest sample data and generators for testing
stubs Type annotations for external libraries
tests Tests to exercise this codebase Guidelines for contributing This README file
LICENSE The license for ElectionGuard-Python.

โ“ What Is ElectionGuard?

ElectionGuard is an open source software development kit (SDK) that makes voting more secure, transparent and accessible. The ElectionGuard SDK leverages homomorphic encryption to ensure that votes recorded by electronic systems of any type remain encrypted, secure, and secret. Meanwhile, ElectionGuard also allows verifiable and accurate tallying of ballots by any 3rd party organization without compromising secrecy or security.

Learn More in the ElectionGuard Repository

๐Ÿฆธ How Can I use ElectionGuard?

ElectionGuard supports a variety of use cases. The Primary use case is to generate verifiable end-to-end (E2E) encrypted elections. The Electionguard process can also be used for other use cases such as privacy enhanced risk-limiting audits (RLAs).

๐Ÿ’ป Requirements

๐Ÿš€ Quick Start

Using make, the entire GitHub Action workflow can be run with one command:


The unit and integration tests can also be run with make:

make test

A complete end-to-end election example can be run independently by executing:

make test-example

For more detailed build and run options, see the documentation.

๐Ÿ“„ Documentation


Step-by-Step Process:

  1. Configure Election
  2. Key Ceremony
  3. Encrypt Ballots
  4. Cast and Spoil
  5. Decrypt Tally
  6. Publish and Verify


Electionguard would love for you to ask questions out in the open using GitHub Issues. If you really want to email the ElectionGuard team, reach out at