Running the webapp locally

You can run the same webapp available online locally.

After installing Aequitas, run the following command in your terminal.

python -m serve

You should see th output:

* Running on http://127.0.0.1:5000/ (Press CTRL+C to quit)

Load data

Use the browse ... button to select a properly formated csv. (see input data) Hit upload.

Customize report

  • choose attributes

    • these are automatically pulled out from the CSV

  • choose reference group

    • majority: for a given attribute use the majority group

    • min metric: for a given attribute use the group with the lowest scores as a baseline

    • custom group: pick groups to serve as reference

  • choose metrics you care about

    • Equal Parity

    • Proportional Parity

    • False Positive Parity

    • False Negative Parity

  • choose fairness threshold

Get ‘The Bias Report’

The webapp returns descriptive interpretation of the results along with three sets of tables.

  • Fairness Measures Results

  • Bias Metrics Results

  • Group Metrics Results

More information about output here.