/ml4a-guides

practical guides, tutorials, and code samples for ml4a

Primary LanguageJupyter NotebookGNU General Public License v2.0GPL-2.0

ml4a-guides

These guides accompany the chapters of ml4a.github.io, providing a series of pre-baked code samples, IPython notebooks, and markdown-based tutorials guiding the interested reader in how to practically work with some of the algorithms described by ml4a.

The homepage for these is here, which contains an overview of the included guides and tutorials, as well as some additional (in-progress) materials to help you get setup.

Running the container

You can easily run these guides using Docker. With docker installed, run the following from inside the repo:

docker build -t genekogan/ml4a-guides .

Once the container has successfully built, you can launch it with:

./run.sh

A Jupyter Notebook should now be running inside of the docker container, accessible from your host machine at http://localhost:8888. From Jupyter browser page, navigate to wherever you cloned ml4a-guides to run the notebooks.

If that port is already occupied, you may recieve an error from the run.sh script. You can easily switch the port published to the docker instance like so:

JUPYTER_PORT=1337 ./run.sh # visit at http://localhost:1337 instead