PDFs, notebooks, and setup instructions

Option 2: Run locally with Jupyter

Install Git and Python 3.10 or newer first. Clone the full repository so the notebooks can find their helper modules and datasets. Run these commands in a terminal on macOS or Linux:

git clone https://github.com/neonwatty/machine-learning-refined.git
cd machine-learning-refined
python3 -m venv .venv
.venv/bin/python -m pip install -r requirements.txt
.venv/bin/python -m notebook --ip=127.0.0.1

git clone https://github.com/neonwatty/machine-learning-refined.git
cd machine-learning-refined
py -3 -m venv .venv
.\.venv\Scripts\python.exe -m pip install -r requirements.txt
.\.venv\Scripts\python.exe -m notebook --ip=127.0.0.1

Open the local URL printed by Jupyter, including its sign-in token if requested. Browse to a notebook under notes/ or exercises/, select the environment’s Python kernel, and run its cells in order. Keep the terminal open while you work; stop the server with Ctrl+C when finished.

A missing module or data file usually means an environment or path needs attention. Check that you installed the repository’s requirements.txt in this environment and kept the repository folders intact. Some examples need additional tools such as FFmpeg for animation.