macOS

Skip Steps 1 and 2 if you already installed Python3 and Git on Windows.

1. Install Python

• Download a Python installer from python.org. Choose Python 3.6, 3.7 or 3.8. For example, this 3.7 installer: https://www.python.org/ftp/python/3.7.9/python-3.7.9-macosx10.9.pkg
• Double click on the installer to run it, and follow the steps in the installer. Please read the "Important Information" displayed during installation for information about SSL/TLS certificate validation and the running the "Install Certificates.command". These certificates are required to run some of the notebooks.

2. Install Git

• Download Git from this link
• Double click on the installer to run it, and follow the steps in the installer.

3. Install the Notebooks

After installing Python 3 and Git, run each step below in a terminal. Note: If OpenVINO is installed globally, please do not run any of these commands in a terminal where setupvars.sh is sourced.

4. Create a Virtual Environment

Note: If you already installed openvino-dev and activated the openvino_env environment, you can skip to Step 6. If you use Anaconda, please see the Conda guide.

python3 -m venv openvino_env

5. Activate the Environment

openvino_env/bin/activate

6. Clone the Repository

git clone /~https://github.com/openvinotoolkit/openvino_notebooks.git
cd openvino_notebooks

7. Install the Packages

This step installs OpenVINO and dependencies like Jupyter Lab. First, upgrade pip to the latest version. Then, use pip's legacy dependency resolver to avoid dependency conflicts.

python -m pip install --upgrade pip
pip install -r requirements.txt --use-deprecated=legacy-resolver

8. Install the virtualenv Kernel in Jupyter

python -m ipykernel install --user --name openvino_env

9. Launch the Notebooks!

To launch a single notebook, like the Monodepth notebook

jupyter notebook notebooks/201-vision-monodepth/201-vision-monodepth.ipynb

To launch all notebooks in Jupyter Lab

jupyter lab notebooks

In Jupyter Lab, select a notebook from the file browser using the left sidebar. Each notebook is located in a subdirectory within the notebooks directory.

Troubleshooting

• If you have Apple M1, please see the community discussion page

• If you use Anaconda or Minoconda, see the Conda wiki page.