Running Model Demos

This guide is for users who have installed the base Tenstorrent Software Stack. You’ll learn how to download and enter the containerized environment for model demos, run a basic operation to verify the environment is working, and find more complex model examples.

This guide demonstrates how to run the tt-metalium model demos using the tt-installer tool. The tt-installer can be used to download a container for running the tt-metalium demos. This container possesses a full build of the tt-metalium project, including the demo source code.


Before You Begin

Important

This guide assumes you have already installed the necessary system dependencies and drivers by following the Installing the Tenstorrent Software Stack guide.


Step 1: Download and Installing the Demos Container

The model demos are packaged in a dedicated container. This keeps the demo environment and its specific dependencies separate from your system.

Run the following command to add the models container to your existing Tenstorrent software installation.

/bin/bash -c "$(curl -fsSL https://github.com/tenstorrent/tt-installer/releases/latest/download/install.sh)" --no-install-kmd --no-install-hugepages --no-install-metalium-container --install-metalium-models-container --no-install-tt-flash --no-install-tt-topology --update-firmware="off" --reboot-option="never" --mode-non-interactive

Step 2: Starting the Container

To use the models container, execute this command to create an interactive shell with all configuration taken care of:

tt-metalium-models

Note

This container is ephemeral so all changes made inside will be lost when the container is stopped

Step 3: Run a simple program

To confirm that the environment is configured correctly and can access the hardware, run the simple test program. This program performs an exponentiation and a matrix multiplication operation on the device:

# this should be run inside the container
python ttnn/ttnn/examples/usage/run_op_on_device.py

Successful execution will complete without errors, confirming your setup is correct.

Step 4: Explore More Model Demos

This container includes demos for a wide variety of models. You can find instructions for each one in the tt-metal GitHub repository.

See the tt-metal models page for a full list and links to individual guides for models covering:

  • Large Language Models (LLMs)

  • Speech-To-Text

  • Diffusion

  • Image Classification

  • Vision Transformers

  • Object Detection

  • Image Segmentation

  • Natural Language Processors (NLPs)

Step 5: Exit the Container

When you are finished, exit the interactive shell.

exit

Need Additional Support?

If you encounter any issues, or have a question that isn’t covered in the documentation, please raise a support request. Our team will review your request and provide assistance.