This project is aimed at providing an accessible and reproducible environment for a variety of machine learning toolkits, with a focus on deep learning toolkits. Instead of asking you to follow a set of complex setup instructions, ml-notebook asks you to wait while a tested, pre-built image is installed.
The following tools are available inside the Ubuntu 14.04 image, with Jupyter as an interface:
*These are requirements of other libraries, but also interesting in their own right.
This is only tested this on OSX. Something similar should work on Linux, and possibly Windows with some changes.
- Install Docker. On Mac, use Docker for Mac.
- Clone this repository.
git clone https://github.com/kylemcdonald/ml-notebook.git && cd ml-notebook
- (Optional) Run
./update.shNote: this downloads 2+GB of data and examples. If you just want to look around, browse ml-examples.
./run.shNote: this downloads another 2+GB of data, a pre-built image from Docker.
Ctrl-D to exit the ml-notebook Docker. If you accidentally close the Terminal, the Jupyter notebook will keep running in the background. Whenever you want to run the environment again, just call
./run.sh when ml-notebook is running in the background will restart ml-notebook.
Some of the deep learning toolkits are built based on Dockerfiles from Kaixhin.