Spaces:
Runtime error
Runtime error
[English](README.md) | 简体中文 | |
<h1 align="center">📚 OpenVINO™ Notebooks</h1> | |
[![Apache License Version 2.0](https://img.shields.io/badge/license-Apache_2.0-green.svg)](https://github.com/openvinotoolkit/openvino_notebooks/blob/latest/LICENSE) | |
[![CI](https://github.com/openvinotoolkit/openvino_notebooks/actions/workflows/treon_precommit.yml/badge.svg?event=push)](https://github.com/openvinotoolkit/openvino_notebooks/actions/workflows/treon_precommit.yml?query=event%3Apush) | |
[![CI](https://github.com/openvinotoolkit/openvino_notebooks/actions/workflows/docker.yml/badge.svg?event=push)](https://github.com/openvinotoolkit/openvino_notebooks/actions/workflows/docker.yml?query=event%3Apush) | |
在这里,我们提供了一些可以运行的Jupyter* notebooks,用于学习和尝试使用OpenVINO™开发套件。这些notebooks旨在向各位开发者提供OpenVINO基础知识的介绍,并教会大家如何利用我们的API来优化深度学习推理。 | |
🚀 您可以通过查看以下交互式的页面,对OpenVINO™ Notebooks的内容进行快速导览: | |
[OpenVINO™ Notebooks at GitHub Pages](https://openvinotoolkit.github.io/openvino_notebooks/) | |
[![notebooks-selector-preview](https://github.com/openvinotoolkit/openvino_notebooks/assets/41733560/a69efb78-1637-404c-b5ef-63974db2bf1b)](https://openvinotoolkit.github.io/openvino_notebooks/) | |
[![-----------------------------------------------------](https://user-images.githubusercontent.com/10940214/155750931-fc094349-b6ec-4e1f-9f9a-113e67941119.jpg)]() | |
## 目录 | |
- [目录](#目录) | |
- [📝 安装指南](#-安装指南) | |
- [🚀 开始](#-开始) | |
- [⚙️ 系统要求](#️-系统要求) | |
- [💻 运行Notebooks](#-运行notebooks) | |
- [启动单个Notebook](#启动单个notebook) | |
- [启动所有Notebooks](#启动所有notebooks) | |
- [🧹 清理](#-清理) | |
- [⚠️ 故障排除](#️-故障排除) | |
- [🧑💻 贡献者](#-贡献者) | |
- [❓ 常见问题解答](#-常见问题解答) | |
[![-----------------------------------------------------](https://user-images.githubusercontent.com/10940214/155750931-fc094349-b6ec-4e1f-9f9a-113e67941119.jpg)]() | |
<div id='-installation-guide'/> | |
## 📝 安装指南 | |
OpenVINO™ Notebooks需要预装Python和Git, 针对不同操作系统的安装参考以下英语指南: | |
| [Windows](https://github.com/openvinotoolkit/openvino_notebooks/wiki/Windows) | [Ubuntu](https://github.com/openvinotoolkit/openvino_notebooks/wiki/Ubuntu) | [macOS](https://github.com/openvinotoolkit/openvino_notebooks/wiki/macOS) | [Red Hat](https://github.com/openvinotoolkit/openvino_notebooks/wiki/Red-Hat-and-CentOS) | [CentOS](https://github.com/openvinotoolkit/openvino_notebooks/wiki/Red-Hat-and-CentOS) | [Azure ML](https://github.com/openvinotoolkit/openvino_notebooks/wiki/AzureML) | [Docker](https://github.com/openvinotoolkit/openvino_notebooks/wiki/Docker) | [Amazon SageMaker](https://github.com/openvinotoolkit/openvino_notebooks/wiki/SageMaker)| | |
| -------------------------------------------------------------------------------- | --------------------------------------------------------------------------- | ------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ | --------------------------------------------------------------------------- |--------------------------------------------------------------------------- | | |
[![-----------------------------------------------------](https://user-images.githubusercontent.com/10940214/155750931-fc094349-b6ec-4e1f-9f9a-113e67941119.jpg)]() | |
<div id='-getting-started'/> | |
## 🚀 开始 | |
使用这个 [页面](https://openvinotoolkit.github.io/openvino_notebooks/)来探索notebooks, 选择一个跟你需求相关的开始试试吧。祝你好运! | |
**注意: 这个仓库的main分支已经升级了对于OpenVINO 2024.0 release的支持.** 请运行在你的 `openvino_env`虚拟环境中,运行 `pip install --upgrade -r requirements.txt` 升级到最新版本. 如果这是您第一次安装OpenVINO™ Notebooks,请参考以下的 [安装指南](#-installation-guide)。 如果您想使用上一个OpenVINO版本, 请切换至[2023.3 分支](https://github.com/openvinotoolkit/openvino_notebooks/tree/2023.3). 如果您想使用上一个长期维护 (LTS) 的OpenVINO版本,请切换到 [2022.3 分支](https://github.com/openvinotoolkit/openvino_notebooks/tree/2022.3)。 | |
如果您有任何问题,可以开启一个 GitHub [讨论](https://github.com/openvinotoolkit/openvino_notebooks/discussions)。 | |
如果你遇到了问题,请查看[故障排除](#-troubleshooting), [常见问题解答](#-faq) 或者创建一个GitHub [讨论](https://github.com/openvinotoolkit/openvino_notebooks/discussions)。 | |
带有![binder 标签](https://mybinder.org/badge_logo.svg) 和[colab 标签](https://colab.research.google.com/assets/colab-badge.svg) 按键的Notebooks可以在无需安装的情况下运行。[Binder](https://mybinder.org/) 和[Google Colab](https://colab.research.google.com/)是基于有限资源的免费在线服务。 如果享有获得最佳性能体验,请遵循[安装指南](#-installation-guide)在本地运行Notebooks。 | |
[![-----------------------------------------------------](https://user-images.githubusercontent.com/10940214/155750931-fc094349-b6ec-4e1f-9f9a-113e67941119.jpg)]() | |
<div id='-system-requirements'/> | |
## ⚙️ 系统要求 | |
这些notebooks可以运行在任何地方,包括你的笔记本电脑,云VM,或者一个Docker容器。下表列出了所支持的操作系统和Python版本。 | |
| 支持的操作系统 | [Python Version (64-bit)](https://www.python.org/) | | |
| :--------------------------------------------------------- |:---------------------------------------------------| | |
| 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 | | |
[![-----------------------------------------------------](https://user-images.githubusercontent.com/10940214/155750931-fc094349-b6ec-4e1f-9f9a-113e67941119.jpg)](#) | |
<div id='-run-the-notebooks'/> | |
## 💻 运行Notebooks | |
### 启动单个Notebook | |
如果你希望启动单个的notebook(如:Monodepth notebook),运行以下命令: | |
```bash | |
jupyter vision-monodepth.ipynb | |
``` | |
### 启动所有Notebooks | |
```bash | |
jupyter lab notebooks | |
``` | |
在浏览器中,从Jupyter Lab侧边栏的文件浏览器中选择一个notebook文件,每个notebook文件都位于`notebooks` 目录中的子目录中。 | |
<img src="https://user-images.githubusercontent.com/15709723/120527271-006fd200-c38f-11eb-9935-2d36d50bab9f.gif"> | |
[![-----------------------------------------------------](https://user-images.githubusercontent.com/10940214/155750931-fc094349-b6ec-4e1f-9f9a-113e67941119.jpg)]() | |
<div id='-cleaning-up'/> | |
## 🧹 清理 | |
<div id='-shut-down-jupyter-kernel'> | |
1. 停止Jupyter Kernel | |
按 `Ctrl-c`结束 Jupyter session,会弹出一个提示框 `Shutdown this Jupyter server (y/[n])?`,您可以输入 `y` and 敲击 `Enter`回车。 | |
</div> | |
<div id='-deactivate-virtual-environment'> | |
2. 注销虚拟环境 | |
注销虚拟环境:只需在激活了`openvino_env`的终端窗口中运行 `deactivate`即可。 | |
重新激活环境:在Linux上运行 `source openvino_env/bin/activate` 或者在Windows上运行 `openvino_env\Scripts\activate` 即可,然后输入 `jupyter lab` 或 `jupyter notebook` 即可重新运行notebooks。 | |
</div> | |
<div id='-delete-virtual-environment' markdown="1"> | |
3. 删除虚拟环境 _(可选)_ | |
直接删除 `openvino_env` 目录即可删除虚拟环境: | |
</div> | |
<div id='-on-linux-and-macos' markdown="1"> | |
- On Linux and macOS: | |
```bash | |
rm -rf openvino_env | |
``` | |
</div> | |
<div id='-on-windows' markdown="1"> | |
- On Windows: | |
```bash | |
rmdir /s openvino_env | |
``` | |
</div> | |
<div id='-remove-openvino-env-kernel' markdown="1"> | |
- 从Jupyter中删除 `openvino_env` Kernel | |
```bash | |
jupyter kernelspec remove openvino_env | |
``` | |
</div> | |
[![-----------------------------------------------------](https://user-images.githubusercontent.com/10940214/155750931-fc094349-b6ec-4e1f-9f9a-113e67941119.jpg)]() | |
<div id='-troubleshooting'/> | |
## ⚠️ 故障排除 | |
如果以下方法无法解决您的问题,欢迎创建一个[讨论主题](https://github.com/openvinotoolkit/openvino_notebooks/discussions) | |
或[issue](https://github.com/openvinotoolkit/openvino_notebooks/issues)! | |
- 运行 `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。 | |
[![-----------------------------------------------------](https://user-images.githubusercontent.com/10940214/155750931-fc094349-b6ec-4e1f-9f9a-113e67941119.jpg)](#-contributors) | |
<div id='-contributors'/> | |
## 🧑💻 贡献者 | |
<a href="https://github.com/openvinotoolkit/openvino_notebooks/graphs/contributors"> | |
<img src="https://contrib.rocks/image?repo=openvinotoolkit/openvino_notebooks" /> | |
</a> | |
使用 [contributors-img](https://contrib.rocks)制作。 | |
[![-----------------------------------------------------](https://user-images.githubusercontent.com/10940214/155750931-fc094349-b6ec-4e1f-9f9a-113e67941119.jpg)]() | |
<div id='-faq'/> | |
## ❓ 常见问题解答 | |
* [OpenVINO支持哪些设备?](https://docs.openvino.ai/2024/openvino-workflow/running-inference/inference-devices-and-modes.html) | |
* [OpenVINO支持的第一代CPU是什么?](https://www.intel.com/content/www/us/en/developer/tools/openvino-toolkit/system-requirements.html) | |
* [在使用OpenVINO部署现实世界解决方案方面有没有成功的案例?](https://www.intel.com/content/www/us/en/internet-of-things/ai-in-production/success-stories.html) | |
--- | |
\*其他名称和品牌可能被视为他人的财产。 | |