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.
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 (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 -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/toc2
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.