SDK Installation

The section below refers to the installation of the Holoscan SDK referred to as the development stack, designed for the NVIDIA IGX Developer Kits, and for x86_64 Linux compute platforms, ideal for development and testing of the SDK.

• For RDMA Support (RoCE over ConnectX and/or GPUDirect RDMA), follow the instructions in the Enabling RDMA section.

• Additional software dependencies might be needed based on how you choose to install the SDK (see section below).

• Refer to the Additional Setup and Third-Party Hardware Setup sections for additional prerequisites.

Authentication

To access LWS2 installations, you will first need an API Key from NGC. Select NGC Catalog as one of the services. Your API key should begin with nvapi-.

If you plan to only use the docker container, skip to the installation section. If you plan to install the debian package or python wheel, you will need to configure buildauthcli and authxsentry:

1. These tools already come installed on IGX OS LWS2 (iGPU and dGPU). Run the following to install them on x86_64:

   Copy

   Copied!

               
   
               
   sudo wget <NEED_EXTERNAL_URL>/authxsentry -O /usr/bin/authxsentry
   wget <NEED_EXTERNAL_URL>/buildauthcli-linux-amd64-v2.0.tar.gz -O - | sudo tar -zx -C "/usr/bin/"
   sudo chmod +x /usr/bin/authxsentry
   sudo chmod +x /usr/bin/buildauth
           

2. On both IGX and x86_64, run authxsentry with the NGC CLI API key you generated above:

   Copy

   Copied!

               
   
               
   authxsentry <nvapi-xxx>
   # Successful setup will end with `Login complete.`
           

Installation

We provide multiple ways to install and run the Holoscan SDK:

            

            
docker login nvcr.io
# Username: $oauthtoken
# Password: <NGC API key>
        

            

            
sudo sed -i 's|^deb|#deb|g' /etc/apt/sources.list
echo """
deb [arch=amd64 trusted=yes] https://disthub.nvidia.com/artifactory/oss-lws-deb-stable jammy main
deb [arch=amd64 trusted=yes] https://disthub.nvidia.com/artifactory/nvaie-lws2-deb-stable lws lws2
""" | sudo tee /etc/apt/sources.list.d/lws2_amd64.list
        

            

            
sudo apt update
sudo apt install holoscan
        

            

            
export PYTHONPATH="/opt/nvidia/holoscan/python/lib"
        

            

            
echo """
[global]
index-url = https://disthub.nvidia.com/artifactory/api/pypi/nvaie-lws2-pypi-stable/simple
extra-index-url = https://disthub.nvidia.com/artifactory/api/pypi/oss-lws2-pypi-stable/simple
""" | sudo tee /etc/pip.conf
        

            

            
pip install holoscan
        

Not sure what to choose?

• The Holoscan container image on NGC it the safest way to ensure all the dependencies are present with the expected versions (including torch ⁸). It is the simplest way to run the embedded examples, while still allowing you to create your own C++ and Python Holoscan application on top of it. These benefits come with the standard inconvenience that exist when using Docker, such as more complex run instructions for proper configuration. Also, supporting Rivermax or the CLI require more work than the other solutions at this time.

• If you are confident in your ability to manage dependencies on your own in your host environment, the Holoscan Debian package should provide all the capabilities needed to use the Holoscan SDK.

• If you are not interested in the C++ API but just need to work in Python, you can use the Holoscan python wheels. While they are the easiest solution to get started, you might need additional work to setup your environment with adequate dependencies depending on your needs.

Need more control over the SDK?

The Holoscan SDK source repository is open-source and provides reference implementations as well as infrastructure for building the SDK yourself.