Skip to content

ODSC Immersive AI 2019 Tutorial

Jump to bottom
Samuel Hoffman edited this page Jun 26, 2019 · 3 revisions

Date: Fri, June 28, 2019

Time: 12:45 PM - 3:45 PM

Location: New York City, New York

Presenters: Samuel C. Hoffman, Kush R. Varshney, Yunfeng Zhang

Conference link

Attendees

Please join the slack channel dedicated to this tutorial

  1. Join the AIF360 slack channel: Instructions
  2. Subscribe to the #odsc-tutorial-2019 channel. You can do this by clicking on the "channels" word and searching for "odsc-tutorial-2019"

The slack channel contains important information to aid you with this hands-on tutorial, including the installation files we will be using for the tutorial. Thanks!

Installation guide

In the following, we will describe how to install the AI Fairness 360 (AIF360) toolkit on Windows, Linux, or MacOS systems for the purposes of the ODSC Immersive AI Session. Please ask any questions in the slack channel or to an instructor.

Prerequisites

  • Anaconda
  • Access to command prompt/terminal

This guide will only cover installation via Anaconda. See previous installation guides for other cases. To see if you already have Anaconda installed try

conda help

If not, download Miniconda from the link above.

Steps

  1. Create and activate a new conda environment
conda create -n aif360 python=3.5.6
conda activate aif360

(older versions of conda may use source activate aif360). The shell should now look like:

(aif360)$ _

To exit this environment, use:

conda deactivate

Do not deactivate until you are finished doing experiments with AIF360. The conda environment keeps dependencies we install separate from the rest of the machine so we can install and uninstall packages without affecting other projects. However, they will only be available when the environment is activated.

  1. Install the latest stable version of AIF360
pip install aif360
  1. Download the tutorial_files.zip from the #odsc-tutorial-2019 channel on slack.

Unzip it and enter the tutorial_files directory, i.e.:

Windows:

cd C:\Users\%USERNAME%\Downloads\tutorial_files

Linux/MacOS

cd ~/Downloads/tutorial_files
  1. Run the copy_datasets.py script which will copy the necessary datasets to the correct location in the AIF360 toolbox.
python copy_datasets.py

NOTE: By running this script, you acknowledge the responsibility for reading and abiding by any copyright/usage rules and restrictions as stated on the corresponding links:

  1. Install additional dependencies
pip install --upgrade numpy
pip install -r requirements.txt

Enjoy!

Clone this wiki locally