# Holoscan SDK
The **Holoscan SDK Python Wheel** is part of [NVIDIA Holoscan](https://developer.nvidia.com/holoscan-sdk), the AI sensor processing platform that combines hardware systems for low-latency sensor and network connectivity, optimized libraries for data processing and AI, and core microservices to run streaming, imaging, and other applications, from embedded to edge to cloud. It can be used to build streaming AI pipelines for a variety of domains, including Medical Devices, High Performance Computing at the Edge, Industrial Inspection and more.
## Getting Started
Visit the Holoscan User Guide to [get started](https://docs.nvidia.com/holoscan/sdk-user-guide/getting_started.html) with the Holoscan SDK.
## Prerequisites
- Prerequisites for each supported platform are documented in [the user guide](https://docs.nvidia.com/holoscan/sdk-user-guide/sdk_installation.html#prerequisites). Note that the python wheels have a lot of optional dependencies which you may install manually based on your needs (see compatibility matrix at the bottom).
- The Holoscan SDK python wheels are only formally tested on Ubuntu 22.04. They are, however, expected to work on any Linux distribution with glibc 2.35 or above (see output of `ldd --version`) and CUDA Runtime 12.2 or above.
- Python: 3.9 to 3.12
## Troubleshooting
> Version 0.6.0 gets installed instead of the latest version
The latest version of the wheels were built and tested on Ubuntu 22.04 with glibc 2.35. You'll need to switch to a Linux distribution with a more recent version of glibc to use the Holoscan SDK python wheels 1.0 or above (check your version with `ldd --version`), or use the [Holoscan SDK NGC container](https://catalog.ngc.nvidia.com/orgs/nvidia/teams/clara-holoscan/containers/holoscan) instead.
> ```
> ERROR: Could not find a version that satisfies the requirement holoscan==<version>
> ERROR: No matching distribution found for holoscan==<version>
> ```
Same as above, OR incompatible python version.
> ```
> libc.so.6: version 'GLIBC_2.32 not found
> libstdc++.so.6: version `GLIBCXX_3.4.29` not found
> ```
Same as above.
> ```
> ImportError: libcudart.so.12: cannot open shared object file: No such file or directory
> ```
CUDA runtime is missing from your system (required even for CPU only pipelines).
- **x86_64**: Follow the official [installation steps](https://docs.nvidia.com/cuda/cuda-installation-guide-linux/index.html).
- Note: while Holoscan does not use the CUDA Python API, you could install the CUDA runtime python wheel if you prefer to use `pip` instead of installing it system-wide: `python3 -m pip install nvidia-cuda-runtime-cu12`. Before calling an Holoscan application, ensure to update your `LD_LIBRARY_PATH` environment variable to include the path to these CUDA libs, for example:
```sh
export CUDA_WHL_LIB_DIR=$(python3 -c 'import nvidia.cuda_runtime; print(nvidia.cuda_runtime.__path__[0])')/lib
export LD_LIBRARY_PATH="$CUDA_WHL_LIB_DIR:$LD_LIBRARY_PATH"
```
- **IGX Orin**: Ensure the [compute stack](https://docs.nvidia.com/igx-orin/user-guide/latest/base-os.html#installing-the-compute-stack) is installed.
- **Jetson**: Re-install [JetPack 6.0](https://developer.nvidia.com/embedded/jetpack).
> ```
> Error: libnvinfer.so.8: cannot open shared object file: No such file or directory
> ...
> Error: libnvonnxparser.so.8: cannot open shared object file: No such file or directory
> ```
TensorRT is missing from your system (note that it is only needed by the `holoscan.operators.InferenceOp` operator.).
- **x86_64**: Follow the official [installation steps](https://docs.nvidia.com/deeplearning/tensorrt/install-guide/index.html).
- Note: you can also install the TensorRT libraries python wheel if you prefer to use `pip` instead of installing it system-wide: `python3 -m pip install tensorrt-libs~=8.6.1 --index-url https://pypi.nvidia.com`. Before calling an Holoscan application, ensure to update your `LD_LIBRARY_PATH` environment variable to include the path to these TensorRT libs, for example:
```sh
export TRT_WHL_LIB_DIR=$(python3 -c 'import tensorrt_libs; print(tensorrt_libs.__path__[0])')
export CUDNN_WHL_LIB_DIR=$(python3 -c 'import nvidia.cudnn; print(nvidia.cudnn.__path__[0])')/lib
export CUBLAS_WHL_LIB_DIR=$(python3 -c 'import nvidia.cublas; print(nvidia.cublas.__path__[0])')/lib
export LD_LIBRARY_PATH="$TRT_WHL_LIB_DIR:$CUDNN_WHL_LIB_DIR:$CUBLAS_WHL_LIB_DIR:$LD_LIBRARY_PATH"
```
- **IGX Orin**: Ensure the [compute stack](https://docs.nvidia.com/igx-orin/user-guide/latest/base-os.html#installing-the-compute-stack) is installed.
- **Jetson**: Re-install [JetPack 6.0](https://developer.nvidia.com/embedded/jetpack).
> ```
> from pip._internal.models.scheme import SCHEME_KEYS
> ModuleNotFoundError: No module named 'pip'
> ...
> ImportError: libholoscan_core.so.2: cannot open shared object file: No such file or directory
> ```
Your version of `pip` is either too old (< 20.2) or you are trying to install `holoscan` with system `pip` which cannot be found to resolve the Holoscan library symlinks.
To resolve, either:
- install `holoscan` in a virtual environment, or
- uninstall `holoscan`, upgrade pip on your system with `python3 -m pip install --upgrade pip`, and reinstall `holoscan`
Raw data
{
"_id": null,
"home_page": "https://github.com/nvidia-holoscan",
"name": "holoscan",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "AI, CUDA, medical, streaming, HPC, nvidia",
"author": "NVIDIA Corporation",
"author_email": null,
"download_url": null,
"platform": null,
"description": "# Holoscan SDK\n\nThe **Holoscan SDK Python Wheel** is part of [NVIDIA Holoscan](https://developer.nvidia.com/holoscan-sdk), the AI sensor processing platform that combines hardware systems for low-latency sensor and network connectivity, optimized libraries for data processing and AI, and core microservices to run streaming, imaging, and other applications, from embedded to edge to cloud. It can be used to build streaming AI pipelines for a variety of domains, including Medical Devices, High Performance Computing at the Edge, Industrial Inspection and more.\n\n## Getting Started\n\nVisit the Holoscan User Guide to [get started](https://docs.nvidia.com/holoscan/sdk-user-guide/getting_started.html) with the Holoscan SDK.\n\n## Prerequisites\n\n- Prerequisites for each supported platform are documented in [the user guide](https://docs.nvidia.com/holoscan/sdk-user-guide/sdk_installation.html#prerequisites). Note that the python wheels have a lot of optional dependencies which you may install manually based on your needs (see compatibility matrix at the bottom).\n- The Holoscan SDK python wheels are only formally tested on Ubuntu 22.04. They are, however, expected to work on any Linux distribution with glibc 2.35 or above (see output of `ldd --version`) and CUDA Runtime 12.2 or above.\n- Python: 3.9 to 3.12\n\n## Troubleshooting\n\n> Version 0.6.0 gets installed instead of the latest version\n\nThe latest version of the wheels were built and tested on Ubuntu 22.04 with glibc 2.35. You'll need to switch to a Linux distribution with a more recent version of glibc to use the Holoscan SDK python wheels 1.0 or above (check your version with `ldd --version`), or use the [Holoscan SDK NGC container](https://catalog.ngc.nvidia.com/orgs/nvidia/teams/clara-holoscan/containers/holoscan) instead.\n\n> ```\n> ERROR: Could not find a version that satisfies the requirement holoscan==<version>\n> ERROR: No matching distribution found for holoscan==<version>\n> ```\n\nSame as above, OR incompatible python version.\n\n> ```\n> libc.so.6: version 'GLIBC_2.32 not found\n> libstdc++.so.6: version `GLIBCXX_3.4.29` not found\n> ```\n\nSame as above.\n\n> ```\n> ImportError: libcudart.so.12: cannot open shared object file: No such file or directory\n> ```\n\nCUDA runtime is missing from your system (required even for CPU only pipelines).\n\n- **x86_64**: Follow the official [installation steps](https://docs.nvidia.com/cuda/cuda-installation-guide-linux/index.html).\n - Note: while Holoscan does not use the CUDA Python API, you could install the CUDA runtime python wheel if you prefer to use `pip` instead of installing it system-wide: `python3 -m pip install nvidia-cuda-runtime-cu12`. Before calling an Holoscan application, ensure to update your `LD_LIBRARY_PATH` environment variable to include the path to these CUDA libs, for example:\n ```sh\n export CUDA_WHL_LIB_DIR=$(python3 -c 'import nvidia.cuda_runtime; print(nvidia.cuda_runtime.__path__[0])')/lib\n export LD_LIBRARY_PATH=\"$CUDA_WHL_LIB_DIR:$LD_LIBRARY_PATH\"\n ```\n- **IGX Orin**: Ensure the [compute stack](https://docs.nvidia.com/igx-orin/user-guide/latest/base-os.html#installing-the-compute-stack) is installed.\n- **Jetson**: Re-install [JetPack 6.0](https://developer.nvidia.com/embedded/jetpack).\n\n> ```\n> Error: libnvinfer.so.8: cannot open shared object file: No such file or directory\n> ...\n> Error: libnvonnxparser.so.8: cannot open shared object file: No such file or directory\n> ```\n\nTensorRT is missing from your system (note that it is only needed by the `holoscan.operators.InferenceOp` operator.).\n\n- **x86_64**: Follow the official [installation steps](https://docs.nvidia.com/deeplearning/tensorrt/install-guide/index.html).\n - Note: you can also install the TensorRT libraries python wheel if you prefer to use `pip` instead of installing it system-wide: `python3 -m pip install tensorrt-libs~=8.6.1 --index-url https://pypi.nvidia.com`. Before calling an Holoscan application, ensure to update your `LD_LIBRARY_PATH` environment variable to include the path to these TensorRT libs, for example:\n ```sh\n export TRT_WHL_LIB_DIR=$(python3 -c 'import tensorrt_libs; print(tensorrt_libs.__path__[0])')\n export CUDNN_WHL_LIB_DIR=$(python3 -c 'import nvidia.cudnn; print(nvidia.cudnn.__path__[0])')/lib\n export CUBLAS_WHL_LIB_DIR=$(python3 -c 'import nvidia.cublas; print(nvidia.cublas.__path__[0])')/lib\n export LD_LIBRARY_PATH=\"$TRT_WHL_LIB_DIR:$CUDNN_WHL_LIB_DIR:$CUBLAS_WHL_LIB_DIR:$LD_LIBRARY_PATH\"\n ```\n- **IGX Orin**: Ensure the [compute stack](https://docs.nvidia.com/igx-orin/user-guide/latest/base-os.html#installing-the-compute-stack) is installed.\n- **Jetson**: Re-install [JetPack 6.0](https://developer.nvidia.com/embedded/jetpack).\n\n> ```\n> from pip._internal.models.scheme import SCHEME_KEYS\n> ModuleNotFoundError: No module named 'pip'\n> ...\n> ImportError: libholoscan_core.so.2: cannot open shared object file: No such file or directory\n> ```\n\nYour version of `pip` is either too old (< 20.2) or you are trying to install `holoscan` with system `pip` which cannot be found to resolve the Holoscan library symlinks.\n\nTo resolve, either:\n\n- install `holoscan` in a virtual environment, or\n- uninstall `holoscan`, upgrade pip on your system with `python3 -m pip install --upgrade pip`, and reinstall `holoscan`\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "The Holoscan SDK: building high-performance AI streaming applications",
"version": "2.7.0",
"project_urls": {
"Documentation": "https://docs.nvidia.com/holoscan/sdk-user-guide/index.html",
"Homepage": "https://github.com/nvidia-holoscan",
"Issue Tracker": "https://github.com/nvidia-holoscan/holoscan-sdk/issues",
"Source": "https://github.com/nvidia-holoscan/holoscan-sdk"
},
"split_keywords": [
"ai",
" cuda",
" medical",
" streaming",
" hpc",
" nvidia"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "25c28344c4c09a0c465cff60243c762c68d74daba54d2c9d7eddad24107c0d08",
"md5": "c1ca2111d941e9c6f3f53d06954ae21d",
"sha256": "71712d5acf551383c9eae7b7e65bb28f352c7241106459b33f02b7d72ba497bc"
},
"downloads": -1,
"filename": "holoscan-2.7.0-cp310-cp310-manylinux_2_35_aarch64.whl",
"has_sig": false,
"md5_digest": "c1ca2111d941e9c6f3f53d06954ae21d",
"packagetype": "bdist_wheel",
"python_version": "cp310",
"requires_python": ">=3.9",
"size": 38993061,
"upload_time": "2024-12-03T00:31:20",
"upload_time_iso_8601": "2024-12-03T00:31:20.387157Z",
"url": "https://files.pythonhosted.org/packages/25/c2/8344c4c09a0c465cff60243c762c68d74daba54d2c9d7eddad24107c0d08/holoscan-2.7.0-cp310-cp310-manylinux_2_35_aarch64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "00a56dec9b6839e60604a852da9bf5defb8723eb35eb0e1ba0f6fe92dbf840a5",
"md5": "fae0795b9a86324f4ceea479eeb97b94",
"sha256": "371c99117835ea5f01f7cf3e324f5871e05b5ddef4b6638945a9e822c6efb8cf"
},
"downloads": -1,
"filename": "holoscan-2.7.0-cp310-cp310-manylinux_2_35_x86_64.whl",
"has_sig": false,
"md5_digest": "fae0795b9a86324f4ceea479eeb97b94",
"packagetype": "bdist_wheel",
"python_version": "cp310",
"requires_python": ">=3.9",
"size": 40956178,
"upload_time": "2024-12-03T00:31:26",
"upload_time_iso_8601": "2024-12-03T00:31:26.128349Z",
"url": "https://files.pythonhosted.org/packages/00/a5/6dec9b6839e60604a852da9bf5defb8723eb35eb0e1ba0f6fe92dbf840a5/holoscan-2.7.0-cp310-cp310-manylinux_2_35_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "8a7f87e04e0b8932fffb32a3a473392a068aaed56129de0aef4e2cdafa03bbd0",
"md5": "40320d45d74db86b8ac3df97d94ac634",
"sha256": "8fcf28d5dbfa0ac5e63ca15cf7b16701662387a67884c2db37a0f402562505e2"
},
"downloads": -1,
"filename": "holoscan-2.7.0-cp311-cp311-manylinux_2_35_aarch64.whl",
"has_sig": false,
"md5_digest": "40320d45d74db86b8ac3df97d94ac634",
"packagetype": "bdist_wheel",
"python_version": "cp311",
"requires_python": ">=3.9",
"size": 39021938,
"upload_time": "2024-12-03T00:31:31",
"upload_time_iso_8601": "2024-12-03T00:31:31.712331Z",
"url": "https://files.pythonhosted.org/packages/8a/7f/87e04e0b8932fffb32a3a473392a068aaed56129de0aef4e2cdafa03bbd0/holoscan-2.7.0-cp311-cp311-manylinux_2_35_aarch64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "212dac5333cb8b1bf1ae09ae529ddeb98a7f1a65a2e17c90cc138cc0a8d492f1",
"md5": "5588fba806f94e4a8bd83104a5eecc67",
"sha256": "614fb2fdb3f32c226cb4a0dcf3c264d4a05a30822a23360353eb794db8515429"
},
"downloads": -1,
"filename": "holoscan-2.7.0-cp311-cp311-manylinux_2_35_x86_64.whl",
"has_sig": false,
"md5_digest": "5588fba806f94e4a8bd83104a5eecc67",
"packagetype": "bdist_wheel",
"python_version": "cp311",
"requires_python": ">=3.9",
"size": 40987879,
"upload_time": "2024-12-03T00:31:36",
"upload_time_iso_8601": "2024-12-03T00:31:36.062889Z",
"url": "https://files.pythonhosted.org/packages/21/2d/ac5333cb8b1bf1ae09ae529ddeb98a7f1a65a2e17c90cc138cc0a8d492f1/holoscan-2.7.0-cp311-cp311-manylinux_2_35_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "4ddd0e40b678de0585b7e7765bb0bd43519a4497f3dd9d02818d03da0c938a91",
"md5": "c509afbbd2731a2bb82b0e69da50c8f0",
"sha256": "d6eac447ade55badd12862610def2a8407b7c51f4b3192a71af6f1c9b0b94f6b"
},
"downloads": -1,
"filename": "holoscan-2.7.0-cp312-cp312-manylinux_2_35_aarch64.whl",
"has_sig": false,
"md5_digest": "c509afbbd2731a2bb82b0e69da50c8f0",
"packagetype": "bdist_wheel",
"python_version": "cp312",
"requires_python": ">=3.9",
"size": 38992466,
"upload_time": "2024-12-03T00:31:40",
"upload_time_iso_8601": "2024-12-03T00:31:40.857988Z",
"url": "https://files.pythonhosted.org/packages/4d/dd/0e40b678de0585b7e7765bb0bd43519a4497f3dd9d02818d03da0c938a91/holoscan-2.7.0-cp312-cp312-manylinux_2_35_aarch64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "ee432214f4f802ada21f7341f27808bf7a1bacbb42c37e4b15ef0f031156656c",
"md5": "351f3d1e4096f584f75780f5511848b0",
"sha256": "d6db11d98e0b5c9f55ab267b9f58cbc3f79ddc6ad694e3bcc0912bae6647ea40"
},
"downloads": -1,
"filename": "holoscan-2.7.0-cp312-cp312-manylinux_2_35_x86_64.whl",
"has_sig": false,
"md5_digest": "351f3d1e4096f584f75780f5511848b0",
"packagetype": "bdist_wheel",
"python_version": "cp312",
"requires_python": ">=3.9",
"size": 40959909,
"upload_time": "2024-12-03T00:31:45",
"upload_time_iso_8601": "2024-12-03T00:31:45.461705Z",
"url": "https://files.pythonhosted.org/packages/ee/43/2214f4f802ada21f7341f27808bf7a1bacbb42c37e4b15ef0f031156656c/holoscan-2.7.0-cp312-cp312-manylinux_2_35_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "faf9dd69c8a9a35df8b1a2d031485d90dd72d22c480b072ae22daef84e9b10fe",
"md5": "9ebee9ac2c2e7d5ef560e33d73a61b69",
"sha256": "2a176ff2390cdb6eceac615e7d3becd1fa4636d6637038c7f2be836bacd8b076"
},
"downloads": -1,
"filename": "holoscan-2.7.0-cp39-cp39-manylinux_2_35_aarch64.whl",
"has_sig": false,
"md5_digest": "9ebee9ac2c2e7d5ef560e33d73a61b69",
"packagetype": "bdist_wheel",
"python_version": "cp39",
"requires_python": ">=3.9",
"size": 38997666,
"upload_time": "2024-12-03T00:31:49",
"upload_time_iso_8601": "2024-12-03T00:31:49.319197Z",
"url": "https://files.pythonhosted.org/packages/fa/f9/dd69c8a9a35df8b1a2d031485d90dd72d22c480b072ae22daef84e9b10fe/holoscan-2.7.0-cp39-cp39-manylinux_2_35_aarch64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "fe7ef74066d942f4c3c25ae370593b10260f5601744750d7f08bbffcd3d27571",
"md5": "b22689aba63a1b54076ea0b419f8378b",
"sha256": "85744ab08cd4f1e624f0bbcc704c53a28fc484340c3fc4d7b88e1024360b9c02"
},
"downloads": -1,
"filename": "holoscan-2.7.0-cp39-cp39-manylinux_2_35_x86_64.whl",
"has_sig": false,
"md5_digest": "b22689aba63a1b54076ea0b419f8378b",
"packagetype": "bdist_wheel",
"python_version": "cp39",
"requires_python": ">=3.9",
"size": 40961009,
"upload_time": "2024-12-03T00:31:53",
"upload_time_iso_8601": "2024-12-03T00:31:53.317995Z",
"url": "https://files.pythonhosted.org/packages/fe/7e/f74066d942f4c3c25ae370593b10260f5601744750d7f08bbffcd3d27571/holoscan-2.7.0-cp39-cp39-manylinux_2_35_x86_64.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-03 00:31:20",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "nvidia-holoscan",
"github_project": "holoscan-sdk",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "holoscan"
}
JSON
