Software Setup

Once your Tenstorrent hardware is physically set up, you’ll need to follow these steps in this order to update the firmware and install the necessary utilities.

Install Driver

Prerequisite

You must have DKMS (Dynamic Kernel Module Support) installed. In the terminal, enter the command appropriate to your Linux distro.

Linux Distro

Command

Debian, Ubuntu

apt install dkms

Fedora

dnf install dkms

Enterprise Linux based

dnf install epel-release && dnf install dkms

Installation

Install the driver (TT-KMD) by entering this series of commands in the terminal:

git clone https://github.com/tenstorrent/tt-kmd.git
cd tt-kmd
git checkout -b ttkmd-1.29 ttkmd-1.29
sudo dkms add .
sudo dkms install tenstorrent/1.29
sudo modprobe tenstorrent

Install TT-Flash

To install TT-Flash, the utility used to update firmware, enter this command in the terminal:

pip install git+https://github.com/tenstorrent/tt-flash.git

Update Firmware

To update the firmware for your Tenstorrent card, enter this series of commands in the terminal:

wget https://github.com/tenstorrent/tt-firmware/raw/main/fw_pack-80.10.0.0.fwbundle
tt-flash --fw-tar fw_pack-80.10.0.0.fwbundle

If this process worked, reboot the system and go to the next section.

If running this last command results in an error that says the firmware is too old, enter the following command:

tt-flash --fw-tar fw_pack-80.10.0.0.fwbundle --force

Then reboot the system.

Install Software Management Interface (TT-SMI)

Install the Tenstorrent Software Management Interface (TT-SMI) by entering this command in the terminal:

pip install git+https://github.com/tenstorrent/tt-smi

Run Software Management Interface (TT-SMI)

Run the TT-SMI tool by entering the command in the terminal:

tt-smi

If the tool runs without error, you’re ready to get started!

First 5 Things to Do

Now that your Tenstorrent Tensix Processor(s) up and running, there are two SDKs you can work with to familiarize yourself with the hardware and associated utilities and software. Each SDK lists five tasks to start with.