macOS

Skip Steps 1 and 2 if you already installed Python 3 and Git on macOS using the xcode-select --install command.

1. Install Python

• Download a Python installer from python.org. Choose Python 3.7, 3.8 or 3.9. 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

source openvino_env/bin/activate

6. Clone the Repository

Note: Using the --depth=1 option for git clone reduces download size.

git clone --depth=1 /~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, install the required dependencies.

python -m pip install --upgrade pip wheel setuptools
pip install -r requirements.txt

8. Launch the Notebooks on Chrome or Firefox!

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

• For the webcam notebooks, please use Chrome/Firefox as the browser. Otherwise, you will notice flickering with Safari.

• The built-in webcam performance is very poor and have significant drop frame issues. The workaround is to use other webcams or create a virtual webcam with OBS (https://obsproject.com/).

• If you have Apple M1, please see the community discussion page about using Rosetta* 2. For example, there are known issues with the use of model optimizer, and thus you may need to convert the model on x86 machines in prior.

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