handson-ml/README.md

3.0 KiB

Machine Learning Notebooks

Gitter Binder

This project aims at teaching you the fundamentals of Machine Learning in python. It contains the example code from my O'Reilly book Hands-on Machine Learning with Scikit-Learn and TensorFlow:

book

Simply open the Jupyter notebooks you are interested in:

  • using Binder: launch binder
    • this let's you experiment with the code examples
  • or using jupyter.org's notebook viewer
  • or by cloning this repository and running Jupyter locally
    • if you prefer this option, follow the installation instructions below.

Installation

No installation is required, just click the launch binder button above, this creates a new VM with everything you need already preinstalled, so you'll be good to go in a just a few seconds! But if you insist, here's how to install these notebooks on your own system.

Obviously, you will need git and python (python 3 is recommended, but python 2 should work as well).

First, clone this repository:

$ cd {your development directory}
$ git clone https://github.com/ageron/handson-ml.git
$ cd handson-ml

If you want an isolated environment, you can use virtualenv:

$ virtualenv env
$ source ./env/bin/activate

There are different packages for TensorFlow, depending on your platform. Please edit requirements.txt using your favorite editor, and make sure only the right one for your platform is uncommented. Default is Python 3.5, Ubuntu/Linux 64-bits, CPU-only.

Then install the required python packages using pip:

$ pip install --upgrade -r requirements.txt

If you want to install the Jupyter extensions, run the following command:

$ jupyter contrib nbextension install --user

Then you can activate an extension, such as the Table of Contents (2) extension:

$ jupyter nbextension enable toc2/main

Finally, launch Jupyter:

$ jupyter notebook

This should start the Jupyter server locally, and open your browser. If your browser does not open automatically, visit localhost:8888. Click on index.ipynb to get started. You can visit http://localhost:8888/nbextensions to activate and configure Jupyter extensions.

That's it! Have fun learning ML.