Skip to main content

Python API for adjudicating single transferable vote elections. Also contains basic web server to adjudicate results in CSV format.

Project description

PyPi Status Test Status Documentation Status

Python project for adjudicating ranked choice voting elections using the single transferable vote (STV) method. For more information on ranked choice voting, visit the FairVote website on RCV.

The project also contains a small flask server for adjudicating and visualizing election results from a CSV file. It is automatically deployed at at


  • General standards and APIs for voting data and vote tabulation.

  • Tabulation of ranked-choice elections using the single-transferable-vote (STV) method.

  • Support for both single-winner and multi-winner contests.

  • Generation of Sankey diagram showing the flow of vote counts through the rounds of a multi-round election.

  • Parser for converting Google Form based election output to voting data standard format.

  • Web server which processes CSV data output from a Google Form based election, and displays winners and a Sankey diagram.


Inspired by FairVote and CalRCV. FairVote’s examples were extremely helpful for development and correctness-testing.

This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pyrcv-1.0.3.tar.gz (24.5 kB view hashes)

Uploaded Source

Built Distribution

pyrcv-1.0.3-py2.py3-none-any.whl (14.7 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page