Skip to main content

open-source software for tallying ranked-choice voting elections

Project description


|Build Status|

OpenRCV is an open source software project for tallying ranked-choice
voting elections like instant runoff voting and the single transferable

It is distributed for free on
`PyPI <>`__ and the source code is
hosted on `GitHub <>`__. It is
licensed under a permissive open source license. See the
`License <>`__ section for
details on the license.

**Note: this software is not yet usable.**


- Tested against the publicly available test cases in the
`open-rcv-tests <>`__
- Exposes both a command-line API and a Python API.
- The command-line API returns results as JSON to allow
interoperability with other tools (e.g. to use a different results


OpenRCV can be run using Python 3.4.

If you do not already have Python 3.4, you can download it
`here <>`__.



$ pip install openrcv

Running It


$ rcvcount ELECTION.blt

Testing It


$ python -m unittest discover openrcv


To contribute to the project, see the
`Contributing <>`__


This project is licensed under the permissive MIT license. See the
`LICENSE <>`__
file for the actual license wording.


Chris Jerdonek (

.. |Build Status| image::

Project details

Download files

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

Files for OpenRCV, version 0.0.1-alpha
Filename, size File type Python version Upload date Hashes
Filename, size OpenRCV-0.0.1-alpha.tar.gz (14.8 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page