A simple GUI for stratification for sortition/citizens' assemblies.
Random stratified selection software
The app is built using eel - a framework that allows the GUI to be defined in HTML and CSS, but then some basic JavaScript can call Python and I can do the heavy lifting in Python.
First you need to have the following installed:
- git
- python 3.11 or 3.12
- pip
- a recent version of Chrome or Chromium
- poetry
When you first set up a development version, you need to clone this repo, open a terminal in the root of the repo and run:
poetry shell
pip install eel
pip install cvxpy
pip install gspread
pip install mip
pip install toml
pip install oauth2client
python script.py
At this point you should have a window pop up and be able to interact with it, either via uploading .csv files or else by reading directly from a google sheet.
You will only need to do those pip install commands when you first set up your development version. After that, simply run:
poetry shell
python script.py
The python command python script.py requires only:
- script.py
- stratification.py
- all of the files in the folder web
To use poetry (as we suggest above) to control dependencies, you need pyproject.toml
To create exectuables using pyinstaller (as we describe below), you need hook-mip.py to deal with this error.
You can download executables from the latest releases page.
If you want to make an executable yourself, use PyInstaller. The following set of commands, run in the root of the repo, create a single file executable in the folder dist.
git pull
poetry shell
python -m eel script.py web --additional-hooks-dir=. --onefile --noconsole
The resulting executable will work on any computer running the same operating system as yours, i.e. Windows, Mac OS or Linux. So if you run the above command on Linux, you can give the file to someone else running Linux. If the person who wants the app is running Windows, you need to run the above command on Windows.