Release Artifacts
See supported platforms for compatibility.
Release Notes
New Features and Improvements
Core
[[nodiscard]] has been added to all PoseTree interface methods (e.g., get, set, remove, has). Callers that previously discarded these return values will now receive a compiler warning or error. See the Breaking Changes section below for migration guidance.
Operators/Resources/Conditions
FormatConverterOp and FormatConverterGpuResidentOp now accept "uyvy" as an in_dtype, in addition to the existing "yuyv". The new mode handles YUV 4:2:2 packed input with U/Cb-first byte order (e.g. from many CSI/MIPI camera sensors) and converts it to RGB888 via NPP's nppiCbYCr422ToRGB, removing the need to byte-reorder UYVY frames before format conversion.
Examples/Benchmarks
Holoviz module
- Improved error surfacing during Vulkan instance creation failure. Error messages now identify the specific layers and extensions that could not be loaded, making it easier to diagnose initialization failures on new or unusual hardware configurations.
- Holoviz now emits a warning when an
InputSpec with a higher bit-depth pixel format (e.g., 10-bit) is rendered to a lower bit-depth swapchain surface (e.g., an 8-bit surface). The warning identifies the format mismatch and the resulting bit-depth quantization.
Holoinfer module
Utils
HoloHub
Source build & Release Artifacts
- Holoscan Sensor Bridge dependency updated to 2.6.0 GA.
- Fixed the RAPIDS CMake download and setup procedure for source builds (resolved failures caused by an upstream API change in the RAPIDS CMake bootstrap URL).
Documentation
- The Holoscan SDK documentation has been migrated to a Fern-based build system, now published at docs.nvidia.com/holoscan/sdk-user-guide. The new system includes an AI-powered "Ask a question" assistant, a "View as Markdown" option on every page, and direct AI coding-assistant integrations ("Open in Claude", "Open in ChatGPT", "Connect to Cursor", "Connect to Claude Code") accessible from the "More actions" menu.
- Added a new Holoscan CLI Guide page documenting the
holoscan-cli PyPI package, an all-in-one command-line tool to discover, build, run, test, package, and lint Holoscan projects from source.
- Added a new JetPack Performance Tuning page with guidance on installing the real-time kernel and running with a minimal headless BSP to achieve lower, more predictable latency on Jetson developer kits.
Breaking Changes
- AJA capture setup guide moved to HoloHub. The
aja_setup.md page has been removed from the Holoscan SDK User Guide. Refer to HoloHub for AJA device setup documentation.
- Emergent Vision Technologies setup guide removed. The
emergent_setup.md page has been removed from the Holoscan SDK User Guide. Refer to the Emergent Vision Technologies documentation for camera setup instructions.
PoseTree interface methods are now [[nodiscard]]. All return values of PoseTree methods (e.g., get, set, remove, has) carry [[nodiscard]]. Code that called these methods without checking the returned expected_t value will now produce compiler warnings or errors. Update call sites to inspect or explicitly discard the return value (e.g., std::ignore = pose_tree.set(...)).- PDF documentation no longer published. The offline PDF user guide is no longer generated. Access the Holoscan SDK documentation online at docs.nvidia.com/holoscan/sdk-user-guide.
Bug fixes
Known Issues
| Issue |
Description |
| 6045751 |
The "python-api-system.test_multiple_run" test case is known to fail inconsistently (25% of runs) following PyTest refactoring noted above. |
| 6059987, 6154550 |
CUDA 13.2 forward compatibility is not available for some R580.00 drivers (IGX-SW 2.0) and the "cuda-compat-13-2" package is intentionally removed from the Holoscan SDK CUDA 13 build and development containers. Developers using Holoscan SDK with CUDA 13 containers can rely on CUDA 13 minor compatibility to develop and run on CUDA R580 drivers out of the box. The Holoscan SDK development container may launch with an expected 803 warning titled "WARNING: CUDA Minor Version Compatibility mode ENABLED." Some features may not be available under minor compatibility such as NVRTC SASS runtime compilation. Please refer to CUDA Compatibility documentation for more details. |
|
The PyTorch distribution embedded in the Holoscan SDK release container may encounter NVRTC PTX failures consistent with 6059987 above on R580 platforms (x86_64, Jetpack 7.1). Please upgrade to at least R595 drivers. |
| 6204001 |
The Holoscan Sensor Bridge TAO PeopleNet examples embedded in the Holoscan SDK development container artifact may fail on IGX Thor platforms with the message: "CUDA driver error 801 (CUDA_ERROR_NOT_SUPPORTED)". Root cause is under investigation. As a workaround, please install and use the latest Holoscan Sensor Bridge project outside of the container environment. |
| 6336980 |
./holohub setup fails on JetPack 7.2 (AGX Thor) and IGX OS 2.0 (IGX Thor) platforms. Running with sudo produces a PEP 668 "externally-managed-environment" error; running from a Python virtual environment fails with Permission denied while creating /opt/sccache. Workaround: for the sudo case, pass --break-system-packages via the env override: sudo env HOLOSCAN_CLI_INSTALL_ARGS='--break-system-packages --pre --extra-index-url https://pypi.nvidia.com holoscan-cli>4.2.0' ./holohub setup. For the virtual-environment case, pre-create the directory first: sudo mkdir -p /opt/sccache && ./holohub setup. |
