Installation#
System Requirements:#
NVIDIA Hopper H100 GPU or newer
GPU SKU with Confidential Compute(CC)
NVIDIA GPU driver installed
Compatibility#
Use the latest GPU verifier version for optimal compatibility with the most recent drivers.
For attestation-specific platforms like Blackwell, ensure device-specific CC-enabled drivers are installed (e.g., R575 for Blackwell).
Pre-requisites:#
Requires Python 3.8 or later.
Install#
Step 1: Elevate to Root User Privileges (Optional)#
If you want the verifier to set the GPU Ready State based on the Attestation results, you will need to elevate the user privileges to root before you execute the rest of the instructions. For use cases where the user does not intend to set the GPU Ready State (e.g., when using the Attestation SDK), you can install and run the Verifier tool without requiring sudo privileges.
sudo -i
Step 2: Create a new Python Virtual Environment#
python3 -m venv ./prodtest
source ./prodtest/bin/activate
Installation#
Method 1: Installation from Source#
git clone https://github.com/NVIDIA/nvtrust.git
cd nvtrust/guest_tools/gpu_verifiers/local_gpu_verifier
pip3 install .
python3 -m verifier.cc_admin
Method 2: From PyPI#
pip3 install nv-local-gpu-verifier
python3 -m verifier.cc_admin
Troubleshooting Installation Issues#
If you encounter any pip related issues while building the package, please execute the following commands to update to the latest versions of setuptools and pip
python3 -m pip install --upgrade setuptools pip install -U pip
If you encounter any permission issues while building the package, please execute the following commands and then build the package again
cd local_gpu_verifier rm -r build
If you encounter subprocess-related issues while installing the package similar to the below:
Installing build dependencies ... done Getting requirements to build wheel ... error error: subprocess-exited-with-error × Getting requirements to build wheel did not run successfully. │ exit code: 1 ╰─> [2 lines of output] running egg_info error: Cannot update time stamp of directory 'src/nv_local_gpu_verifier.egg-info' [end of output] note: This error originates from a subprocess and is likely not a problem with pip. error: subprocess-exited-with-error × Getting requirements to build wheel did not run successfully. │ exit code: 1 ╰─> See above for output.
Kindly follow the below steps and then re-try the installation:
rm -rf src/nv_local_gpu_verifier.egg-info rm -rf /build
If you encounter warning and installation issues similar to the below while installing the package:
WARNING: Ignoring invalid distribution ~v-local-gpu-verifier <site-package-directory>
Please execute the following commands to clean up packages that were not installed properly and then re-try the installation:rm -rf $(ls -l <site-packages-directory> | grep '~' | awk '{print $9}')