handson-ml/README.md

Machine Learning Notebooks

This project aims at teaching you the fundamentals of Machine Learning in python.

Simply open the Jupyter notebooks you are interested in:

• using Binder:
  • this let's you experiment with the code examples
• or using jupyter.org's notebook viewer
  • note: github.com's notebook viewer also works but it is slower and the math formulas are not displayed correctly
• 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, and you're good to go! But if you insist, here's how to install these notebooks on your system.

Obviously, you will need git and python (2 or 3).

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 2, Ubuntu/Linux 64-bits, CPU-only.

Then install the required python packages using pip:

$ pip install -r requirements.txt

Finally, launch Jupyter:

$ jupyter notebook

This should start the Jupyter server locally, and open your browser. Click on index.ipynb to get started.