English | 简体中文

📚 OpenVINO™ Notebooks

在这里，我们提供了一些可以运行的Jupyter* notebooks，用于学习和尝试使用OpenVINO™开发套件。这些notebooks旨在向各位开发者提供OpenVINO基础知识的介绍，并教会大家如何利用我们的API来优化深度学习推理。

🚀 您可以通过查看以下交互式的页面，对OpenVINO™ Notebooks的内容进行快速导览： OpenVINO™ Notebooks at GitHub Pages

📝 安装指南

OpenVINO™ Notebooks需要预装Python和Git，针对不同操作系统的安装参考以下英语指南:

Windows	Ubuntu	macOS	Red Hat	CentOS	Azure ML	Docker	Amazon SageMaker

🚀 开始

使用这个页面来探索notebooks, 选择一个跟你需求相关的开始试试吧。祝你好运！

注意: 这个仓库的main分支已经升级了对于OpenVINO 2024.0 release的支持. 请运行在你的 openvino_env虚拟环境中，运行 pip install --upgrade -r requirements.txt 升级到最新版本. 如果这是您第一次安装OpenVINO™ Notebooks，请参考以下的安装指南。如果您想使用上一个OpenVINO版本, 请切换至2023.3 分支. 如果您想使用上一个长期维护 (LTS) 的OpenVINO版本，请切换到 2022.3 分支。

如果您有任何问题，可以开启一个 GitHub 讨论。

如果你遇到了问题，请查看故障排除, 常见问题解答或者创建一个GitHub 讨论。

带有和colab 标签按键的Notebooks可以在无需安装的情况下运行。Binder 和Google Colab是基于有限资源的免费在线服务。如果享有获得最佳性能体验，请遵循安装指南在本地运行Notebooks。

⚙️ 系统要求

这些notebooks可以运行在任何地方，包括你的笔记本电脑，云VM，或者一个Docker容器。下表列出了所支持的操作系统和Python版本。

支持的操作系统	Python Version (64-bit)
Ubuntu 20.04 LTS, 64-bit	3.8 - 3.11
Ubuntu 22.04 LTS, 64-bit	3.8 - 3.11
Red Hat Enterprise Linux 8, 64-bit	3.8 - 3.11
CentOS 7, 64-bit	3.8 - 3.11
macOS 10.15.x versions or higher	3.8 - 3.11
Windows 10, 64-bit Pro, Enterprise or Education editions	3.8 - 3.11
Windows Server 2016 or higher	3.8 - 3.11

💻 运行Notebooks

启动单个Notebook

如果你希望启动单个的notebook（如：Monodepth notebook），运行以下命令：

jupyter vision-monodepth.ipynb

启动所有Notebooks

jupyter lab notebooks

在浏览器中，从Jupyter Lab侧边栏的文件浏览器中选择一个notebook文件，每个notebook文件都位于notebooks 目录中的子目录中。

🧹 清理

停止Jupyter Kernel

按 Ctrl-c结束 Jupyter session，会弹出一个提示框 Shutdown this Jupyter server (y/[n])?，您可以输入 y and 敲击 Enter回车。

注销虚拟环境

注销虚拟环境：只需在激活了openvino_env的终端窗口中运行 deactivate即可。

重新激活环境：在Linux上运行 source openvino_env/bin/activate 或者在Windows上运行 openvino_env\Scripts\activate 即可，然后输入 jupyter lab 或 jupyter notebook 即可重新运行notebooks。

删除虚拟环境 (可选)

直接删除 openvino_env 目录即可删除虚拟环境：

On Linux and macOS:
```
rm -rf openvino_env
```

On Windows:
```
rmdir /s openvino_env
```

从Jupyter中删除 openvino_env Kernel
```
jupyter kernelspec remove openvino_env
```

⚠️ 故障排除

如果以下方法无法解决您的问题，欢迎创建一个讨论主题或issue!

运行 python check_install.py 可以帮助检查一些常见的安装问题，该脚本位于openvino_notebooks 目录中。记得运行该脚本之前先激活 openvino_env 虚拟环境。
如果出现 ImportError ，请检查是否安装了 Jupyter Kernel。如需手动设置kernel，从 Jupyter Lab 或 Jupyter Notebook 的_Kernel->Change Kernel_菜单中选择openvino_env内核。
如果OpenVINO是全局安装的，不要在执行了setupvars.bat或setupvars.sh的终端中运行安装命令。
对于Windows系统，我们建议使用_Command Prompt (cmd.exe)，而不是_PowerShell。

🧑‍💻 贡献者

使用 contributors-img制作。

❓ 常见问题解答

*其他名称和品牌可能被视为他人的财产。