opensutd / deeplearning-workshop-2019

IAP Workshop: Deep Learning

This repository contains the material for the Deep Learning Workshop conducted in the IAP 2019. The slides are also available at on Google Drive.

If you do not already have a workstation set up for Deep Learning, you may want to run the notebooks in Google Colab.

If you have a workstation or cloud instance set up for Deep Learning, our recommended way to run the notebooks is to run it in a Docker container nvaitc/ai-lab (learn more). For now, we will also assume that you are using Ubuntu 16.04 or 18.04, and have an NVIDIA GPU card in your workstation/instance. The instructions are below.

Using the Notebooks

A. Google Colab

1. Open Notebook in Colab

• Proceed to Google Colab and click the "GitHub" tab.
• Enter in the URL of this repository as follows and simply select which notebook you wish to open

• Change runtime type to GPU

• On the menu bar, go to Runtime > Run All

• Accept the usual warning, and you will be able to run the notebook
• All the notebooks should be able to run just fine, do open an issue if you face problems.

B. Workstation / Cloud Instance

1. Setting up CUDA, NVIDIA drivers, and Docker

sudo su root
curl https://getcuda.ml/ubuntu.sh | bash
# your computer will reboot
# after your computer reboots, add yourself to the docker group
# if you don't want to run docker with sudo
# you may need to log in and out again for this to take effect
sudo usermod -aG docker $USER

2. Pulling the nvaitc/ai-lab Docker image

• This container includes many data science, machine learning and deep learning packages that are preconfigured and ready to use.
• This is a 6GB download!
• Find out more about the image at its GitHub repository.

docker pull nvaitc/ai-lab:latest

3. Download the code labs

git clone https://github.com/OpenSUTD/deeplearning-workshop-2019
# take note of where you cloned the files to!
# we will assume it's at /home/$USER/deeplearning-workshop-2019

Alternatively, you may download this repository as a zip file from the GitHub web interface.

4. Start the container and mount the folder

Please change the path /home/$USER/deeplearning-workshop-2019 to where-ever you downloaded the files to in Step 3.

nvidia-docker run --rm -p 8888:8888 -v /home/$USER/deeplearning-workshop-2019:/home/jovyan/ nvaitc/ai-lab

This will output a chunk of output in the Terminal. Take note of the last few lines.

Open your web browser and point to localhost:8888. You will be asked to enter a token. This can be found in the last few lines of the Terminal output.

Workshop Authors

• Soh Jun De
• Aiden Chia
• Timothy Liu