Home

Awesome

English | 简体中文

<h1>📚 OpenVINO™ Notebooks</h1>

Apache License Version 2.0 CI CI

Note: This branch of the notebooks repository is deprecated and will be maintained until September 30, 2024. The new branch offers a better user experience and simplifies maintenance due to significant refactoring and a more preferred folder name structure. Please use the local README.md file and OpenVINO™ Notebooks at GitHub Pages to navigate through the content.

A collection of ready-to-run Jupyter notebooks for learning and experimenting with the OpenVINO™ Toolkit. The notebooks provide an introduction to OpenVINO basics and teach developers how to leverage our API for optimized deep learning inference.

🚀 Checkout interactive GitHub pages application for navigation between OpenVINO™ Notebooks content: OpenVINO™ Notebooks at GitHub Pages

notebooks-selector-preview

-----------------------------------------------------

Table of Contents

-----------------------------------------------------

<div id='-installation-guide'/>

📝 Installation Guide

OpenVINO Notebooks require Python and Git. To get started, select the guide for your operating system or environment:

WindowsUbuntumacOSRed HatCentOSAzure MLDockerAmazon SageMaker

-----------------------------------------------------

<div id='-getting-started'/>

🚀 Getting Started

Explore Jupyter notebooks using this page, select one related to your needs or give them all a try. Good Luck!

NOTE: The main branch of this repository was updated to support the new OpenVINO 2024.0 release. To upgrade to the new release version, please run pip install --upgrade -r requirements.txt in your openvino_env virtual environment. If you need to install for the first time, see the Installation Guide section below. If you wish to use the previous release version of OpenVINO, please checkout the 2023.3 branch. If you wish to use the previous Long Term Support (LTS) version of OpenVINO check out the 2022.3 branch.

If you need help, please start a GitHub Discussion.

If you run into issues, please check the troubleshooting section, FAQs or start a GitHub discussion.

Notebooks with binder logo and colab logo buttons can be run without installing anything. Binder and Google Colab are free online services with limited resources. For the best performance, please follow the Installation Guide and run the notebooks locally.

-----------------------------------------------------

<div id='-system-requirements'></div>

⚙️ System Requirements

The notebooks run almost anywhere — your laptop, a cloud VM, or even a Docker container. The table below lists the supported operating systems and Python versions.

Supported Operating SystemPython Version (64-bit)
Ubuntu 20.04 LTS, 64-bit3.8 - 3.11
Ubuntu 22.04 LTS, 64-bit3.8 - 3.11
Red Hat Enterprise Linux 8, 64-bit3.8 - 3.11
CentOS 7, 64-bit3.8 - 3.11
macOS 10.15.x versions or higher3.8 - 3.11
Windows 10, 64-bit Pro, Enterprise or Education editions3.8 - 3.11
Windows Server 2016 or higher3.8 - 3.11

-----------------------------------------------------

<div id='-run-the-notebooks'></div>

💻 Run the Notebooks

To Launch a Single Notebook

If you wish to launch only one notebook, like the Monodepth notebook, run the command below.

jupyter 201-vision-monodepth.ipynb

To Launch all Notebooks

jupyter lab notebooks

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

<img src="https://user-images.githubusercontent.com/15709723/120527271-006fd200-c38f-11eb-9935-2d36d50bab9f.gif">

-----------------------------------------------------

<div id='-cleaning-up'></div>

🧹 Cleaning Up

<div id='-shut-down-jupyter-kernel' markdown="1">
  1. Shut Down Jupyter Kernel

    To end your Jupyter session, press Ctrl-c. This will prompt you to Shutdown this Jupyter server (y/[n])? enter y and hit Enter.

</div> <div id='-deactivate-virtual-environment' markdown="1">
  1. Deactivate Virtual Environment

    To deactivate your virtualenv, simply run deactivate from the terminal window where you activated openvino_env. This will deactivate your environment.

    To reactivate your environment, run source openvino_env/bin/activate on Linux or openvino_env\Scripts\activate on Windows, then type jupyter lab or jupyter notebook to launch the notebooks again.

</div> <div id='-delete-virtual-environment' markdown="1">
  1. Delete Virtual Environment (Optional)

    To remove your virtual environment, simply delete the openvino_env directory:

</div> <div id='-on-linux-and-macos' markdown="1"> </div> <div id='-on-windows' markdown="1"> </div> <div id='-remove-openvino-env-kernel' markdown="1"> </div>

-----------------------------------------------------

<div id='-troubleshooting'></div>

⚠️ Troubleshooting

If these tips do not solve your problem, please open a discussion topic or create an issue!

-----------------------------------------------------

<div id='-contributors'></div>

🧑‍💻 Contributors

<a href="https://github.com/openvinotoolkit/openvino_notebooks/graphs/contributors"> <img src="https://contrib.rocks/image?repo=openvinotoolkit/openvino_notebooks" /> </a>

Made with contrib.rocks.

-----------------------------------------------------

<div id='-faq'></div>

❓ FAQ


* Other names and brands may be claimed as the property of others.