Checklist

Use this checklist to ensure a successful Cloud AI SDK installation.

Before You Begin

Task

Reference

Verify hardware meets minimum requirements

Hardware Requirements

Confirm OS is supported

Supported OS

Ensure Python 3.10 is installed

Prerequisites

Local Server Installation

Task

Reference

Enable 32 MSIs in BIOS (Intel VT-d or AMD IOMMU)

MSI Configuration

Download Platform SDK from QPM

Download SDKs

Download Apps SDK from QPM

Download SDKs

Install Platform SDK

Platform SDK

Install Apps SDK

Apps SDK

Add user to qaic group

See command below

Verify card health

Verification

Add user to qaic group:

sudo usermod -aG qaic $USER
newgrp qaic  # Apply immediately without logout

Virtual Machine Installation

Task

Reference

Configure PCIe passthrough on hypervisor

Hypervisors

Enable MSIs in BIOS and hypervisor

MSI Configuration

Install and configure hypervisor

Hypervisors

Launch VM with supported OS

Supported OS

Install SDKs inside VM

SDK Installation

Verify card health

Verification

Docker Installation

Task

Reference

Install Platform SDK on host

Platform SDK

Build Docker image with Apps SDK

Docker Setup

Start container with device access

Docker Setup

Verify card health inside container

Verification