Skip to content
Implementation of provably Rawlsian fair ML algorithms for contextual bandits.
Jupyter Notebook TeX Python Makefile
Branch: master
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
figures_T_50x
figures_d_50x
figures_k_50x
paper
references
.gitignore
Horses.ipynb
NYSE.ipynb
Provably Fair Machine Learning.ipynb
README.md
RidgeFair.ipynb
Yahoo Testing.ipynb
Yahoo.ipynb
evaluation_T.py
evaluation_d.py
evaluation_k.py
fairml.py
requirements.txt

README.md

Rawlsian Fair Machine Learning for Contextual Bandits

Implementation and evaluation of provably Rawlsian fair ML algorithms for contextual bandits.

Related Work/Citations:

Installation Instructions

(Option 1) Setting Up virtualenv

OSX

Install Python 3 from package. This allows you to run python3 and pip3. Software is installed into /Library/Frameworks/Python.framework/Versions/3.x/bin/.

Install virtualenv for Python 3 for the user only (which is placed into ~/Library/Python/3.x/bin):

$ pip3 install --user virtualenv

Create the following alias in your ~/.bash_profile:

$ echo "alias virtualenv3='~/Library/Python/3.x/bin/virtualenv'" >> ~/.bash_profile

Create a local virtualenv and activate it:

$ virtualenv3 fairml
$ source fairml/bin/activate

With the virtualenv active, install the project requirements into your virtualenv:

$ pip install -r requirements.txt

Create a Python kernel for Jupyter that uses your virtualenv:

$ python -m ipykernel install --user --name=fairml

You can then launch Jupyter using jupyter notebook from inside the project directory and change the kernel to fairml.

(Option 2) Using Docker

You can install Docker and use a standard configuration such as all-spark-notebook to run the project files.

You can’t perform that action at this time.