From 34a041a8a3afc004b5efe7ed53b8ee4a7c571afa Mon Sep 17 00:00:00 2001 From: Karol Blaszczak Date: Thu, 20 Apr 2023 14:09:32 +0200 Subject: [PATCH] [DOCS] bring back conda guide 23.0 (#17030) --- .../installing-openvino-brew.md | 18 ++-- .../installing-openvino-conda.md | 100 ++++++++++++++++-- .../installing-openvino-linux-header.md | 38 ++++--- .../installing-openvino-macos.md | 8 +- .../installing-openvino-windows-header.md | 24 +++-- 5 files changed, 146 insertions(+), 42 deletions(-) diff --git a/docs/install_guides/installing-openvino-brew.md b/docs/install_guides/installing-openvino-brew.md index 8b4ef71da3a..4dd5e758183 100644 --- a/docs/install_guides/installing-openvino-brew.md +++ b/docs/install_guides/installing-openvino-brew.md @@ -2,19 +2,25 @@ @sphinxdirective -With the OpenVINO™ 2022.3 release, you can install OpenVINO Runtime on macOS and Linux via `Homebrew `_. OpenVINO™ Development Tools can be installed via PyPI only. See :ref:`Installing Additional Components ` for more information. +.. note:: -See the `Release Notes `_ for more information on updates in the latest release. + Installing OpenVINO Runtime from Homebrew is recommended for C++ developers. + If you work with Python, consider :doc:`installing OpenVINO from PyPI ` -Installing OpenVINO Runtime from Homebrew is recommended for C++ developers. If you are working with Python, the PyPI package has everything needed for Python development and deployment on CPU and GPUs. Visit the :doc:`Install OpenVINO from PyPI ` page for instructions on how to install OpenVINO Runtime for Python using PyPI. + The current Homebrew package provides inference support for CPU only. -.. note:: - Only CPU is supported for inference if you install OpenVINO via HomeBrew. +You can use `Homebrew `_ to install OpenVINO Runtime on macOS and Linux. +OpenVINO™ Development Tools can be installed via PyPI only. +See `Installing Additional Components <#optional-installing-additional-components>`__ for more information. + +See the `Release Notes `_ +for more information on updates in the latest release. .. warning:: - By downloading and using this container and the included software, you agree to the terms and conditions of the `software license agreements `_. + By downloading and using this container and the included software, you agree to the terms and conditions of the + `software license agreements `_. @endsphinxdirective diff --git a/docs/install_guides/installing-openvino-conda.md b/docs/install_guides/installing-openvino-conda.md index a80c482cdec..b1b194d0853 100644 --- a/docs/install_guides/installing-openvino-conda.md +++ b/docs/install_guides/installing-openvino-conda.md @@ -1,10 +1,96 @@ -# Install OpenVINO™ Runtime from Anaconda Cloud +# Install OpenVINO™ Runtime from Conda Forge {#openvino_docs_install_guides_installing_openvino_conda} -* [Install OpenVINO Runtime from an Archive File](installing-openvino-from-archive-linux.md) -* [Install OpenVINO from PyPI](installing-openvino-pip.md) -* [Install OpenVINO with Docker](installing-openvino-docker-linux.md) -* [Build From Source](https://github.com/openvinotoolkit/openvino/wiki/BuildingCode) +@sphinxdirective -The other installation methods are temporarily unavailable. +.. note:: + + Installing OpenVINO Runtime from Conda Forge is recommended for C++ developers, as it provides only the C++ Runtime API. + If you work with Python, consider :doc:`installing OpenVINO from PyPI ` + + The current Anaconda package does not provide support for GPU inference. + +.. tab:: System Requirements + + | Full requirement listing is available in: + | `System Requirements Page `__ + +.. comment to publish in the future, when gpu support comes back: + + .. tab:: Processor Notes + + | Not all Intel CPUs include integrated graphics processors. + | See `Product Specifications `__ for information about your hardware. + +.. tab:: Software + + There are many ways to work with Conda. Before you proceed, learn more about it on the + `Anaconda distribution page `__ + + +Installing OpenVINO Runtime with Anaconda Package Manager +############################################################ + +1. Set up the Anaconda environment (Python 3.7 used as an example): + + .. code-block:: sh + + conda create --name py37 python=3.7 + + .. code-block:: sh + + conda activate py37 + +2. Update it to the latest version: + + .. code-block:: sh + + conda update --all + +3. Install the OpenVINO Runtime package: + + .. code-block:: sh + + conda install -c conda-forge openvino=2022.3.0 + + Congratulations! You have finished installing OpenVINO Runtime. + + +Uninstalling OpenVINO™ Runtime +########################################################### + +Once OpenVINO Runtime is installed via Conda, you can remove it using the following command, +with the proper OpenVINO version number: + +.. code-block:: sh + + conda remove openvino=2022.3.0 + + +What's Next? +############################################################ + +Now that you've installed OpenVINO Runtime, you are ready to run your own machine learning applications! +To learn more about how to integrate a model in OpenVINO applications, try out some tutorials and sample applications. + +Try the :doc:`C++ Quick Start Example ` for step-by-step instructions +on building and running a basic image classification C++ application. + +.. image:: https://user-images.githubusercontent.com/36741649/127170593-86976dc3-e5e4-40be-b0a6-206379cd7df5.jpg + :width: 400 + +Visit the :doc:`Samples ` page for other C++ example applications to get you started with OpenVINO, such as: + +* `Basic object detection with the Hello Reshape SSD C++ sample `__ +* `Automatic speech recognition C++ sample `__ + + +Additional Resources +########################################################### + +* `OpenVINO Runtime Conda Forge `__ +* :doc:`OpenVINO™ Toolkit Samples Overview ` +* `OpenVINO Installation Selector Tool `__ + + +@endsphinxdirective -For a full selection of distribution channels, see the [OpenVINO Installation Selector Tool](https://www.intel.com/content/www/us/en/developer/tools/openvino-toolkit/download.html) \ No newline at end of file diff --git a/docs/install_guides/installing-openvino-linux-header.md b/docs/install_guides/installing-openvino-linux-header.md index 8f6a77f2d05..4e31eba5a81 100644 --- a/docs/install_guides/installing-openvino-linux-header.md +++ b/docs/install_guides/installing-openvino-linux-header.md @@ -6,22 +6,28 @@ :maxdepth: 3 :hidden: - From Archive - From PyPI - From APT - From YUM - Using HomeBrew - Using Docker + Use Archive + Use PyPI + Use APT + Use YUM + Use Conda Forge + Use HomeBrew + Use Docker + + +If you want to install OpenVINO™ Runtime on your Linux machine, these are your options: + +* :doc:`Install OpenVINO Runtime using an Archive File ` +* :doc:`Install OpenVINO using PyPI ` +* :doc:`Install OpenVINO Runtime using from APT ` +* :doc:`Install OpenVINO Runtime using from YUM ` +* :doc:`Install OpenVINO Runtime using Conda Forge ` +* :doc:`Install OpenVINO Runtime using HomeBrew ` +* :doc:`Install OpenVINO using Docker ` + +For a full selection of distribution channels, see the +`OpenVINO Installation Selector Tool `__ + @endsphinxdirective -If you want to install OpenVINO™ Runtime on your Linux machine, there are a few ways to accomplish this. We prepared the following options for you: - -* [Install OpenVINO Runtime from an Archive File](installing-openvino-from-archive-linux.md) -* [Install OpenVINO from PyPI](installing-openvino-pip.md) -* [Install OpenVINO Runtime from APT](installing-openvino-apt.md) -* [Install OpenVINO Runtime from YUM](installing-openvino-yum.md) -* [Install OpenVINO Runtime via HomeBrew](installing-openvino-brew.md) -* [Install OpenVINO with Docker](installing-openvino-docker-linux.md) - -For a full selection of distribution channels, see the [OpenVINO Installation Selector Tool](https://www.intel.com/content/www/us/en/developer/tools/openvino-toolkit/download.html) diff --git a/docs/install_guides/installing-openvino-macos.md b/docs/install_guides/installing-openvino-macos.md index 06fc2969dff..ba4c632df16 100644 --- a/docs/install_guides/installing-openvino-macos.md +++ b/docs/install_guides/installing-openvino-macos.md @@ -1,10 +1,10 @@ # Install OpenVINO™ Runtime for macOS from Installer -Currently only the following ways are provided to install OpenVINO™: +Currently only the following ways are provided to install OpenVINO™ on macOS: -* [Install OpenVINO Runtime from an Archive File](installing-openvino-from-archive-macos.md) -* [Install OpenVINO Runtime via HomeBrew](installing-openvino-brew.md) -* [Install OpenVINO from PyPI](installing-openvino-pip.md) +* [Install OpenVINO Runtime using an Archive File](installing-openvino-from-archive-macos.md) +* [Install OpenVINO Runtime using HomeBrew](installing-openvino-brew.md) +* [Install OpenVINO using PyPI](installing-openvino-pip.md) * [Build From Source](https://github.com/openvinotoolkit/openvino/wiki/BuildingCode) The other installation methods are temporarily unavailable. diff --git a/docs/install_guides/installing-openvino-windows-header.md b/docs/install_guides/installing-openvino-windows-header.md index 2b0489fd384..7517bd51987 100644 --- a/docs/install_guides/installing-openvino-windows-header.md +++ b/docs/install_guides/installing-openvino-windows-header.md @@ -6,16 +6,22 @@ :maxdepth: 3 :hidden: - From Archive - From PyPI - Using Docker + Use Archive + Use PyPI + Use Conda Forge + Use Docker + + +If you want to install OpenVINO™ Runtime on Windows, you have the following options: + +* :doc:`Install OpenVINO Runtime using an Archive File ` +* :doc:`Install OpenVINO Runtime using PyPI ` +* :doc:`Install OpenVINO Runtime using Conda Forge ` +* :doc:`Install OpenVINO using Docker ` + +For a full selection of distribution channels, +see the `OpenVINO Installation Selector Tool `__ @endsphinxdirective -If you want to install OpenVINO™ Runtime on Windows, you have the following options: -* [Install OpenVINO Runtime from an Archive File](installing-openvino-from-archive-windows.md) -* [Install OpenVINO from PyPI](installing-openvino-pip.md) -* [Install OpenVINO with Docker](installing-openvino-docker-windows.md) - -For a full selection of distribution channels, see the [OpenVINO Installation Selector Tool](https://www.intel.com/content/www/us/en/developer/tools/openvino-toolkit/download.html)