SynapseAI Software Stack Verification

This section provides the required instructions to verify the SynapseAI software already installed on the system. Start by determining what is already installed on the platform, then decide the next steps for installation. Refer to the Support Matrix for the list of supported and validated FW and SW components.

If you are just interested in running Habana’s docker images, refer to Pull Prebuilt Containers.


The versions listed in the Support Matrix are the validated configurations from Habana. Using configurations not tested by Habana may not be functional or performant.

Check Existing Software Installation

This section shows how to check the existing SW and FW components on the platform. In general, it is advised for a SW developer to use the Habana docker image to ensure SynapseAI SW and PyTorch/TensorFlow Frameworks are installed.

To verify the system software, run the following command:

apt list --installed | grep habana

If the installation is successful, you should see the habanalabs-dkms driver and the following software components at the root system. The habanalabs-rdma-core package is installed on Gaudi2 only.

 habanalabs-container-runtime/focal,now 1.12.1-10 amd64 [installed]
 habanalabs-dkms/focal,focal,now 1.12.1-10 all [installed]
 habanalabs-firmware/focal,now 1.12.1-10 amd64 [installed]
 habanalabs-firmware-odm/focal,now 1.12.1-10 amd64 [installed]
 habanalabs-firmware-tools/focal,now 1.12.1-10 amd64 [installed]
 habanalabs-graph/focal,now 1.12.1-10 amd64 [installed]
 habanalabs-rdma-core/now 1.12.1-10 all [installed]+
 habanalabs-qual/focal,now 1.12.1-10 amd64 [installed]
 habanalabs-thunk/focal,focal,now 1.12.1-10 all [installed]


In the Habana docker image, only the habanalabs-firmware-tools, habanalabs-graph, habanalabs-rdma-core, and habanalabs-thunk will be visible.

To verify the framework, PyTorch/TensorFlow, used on the system run the following command:

pip list | grep habana
habana-media-loader     1.12.1-10
habana-pyhlml           1.12.1-10
habana-torch-dataloader 1.12.1-10
habana-torch-plugin     1.12.1-10
lightning-habana        1.0.1
habana-horovod               1.12.1-10
habana-media-loader          1.12.1-10
habana-tensorflow            1.12.1-10

Next Steps

After verifying the installed versions, you can do the following: