tt-metal

tt-metal

:metal: TT-NN operator library, and TT-Metalium low level kernel programming model.

Stars: 1120

Visit
 screenshot

TT-NN is a python & C++ Neural Network OP library. It provides a low-level programming model, TT-Metalium, enabling kernel development for Tenstorrent hardware.

README:

tt-metal CI Ask DeepWiki

Hardware | Install | Discord | Join Us | Bounty $

ttnn logo

TT-NN is a Python & C++ Neural Network OP library.

API Reference | Model Demos

Quick Links

Featured Models

The Models team is focused on developing the following models to a customer-ready state. Ongoing work includes optimizations for performance, accuracy, and compatibility. Follow each model link for more details.

[!IMPORTANT] For a full model list see the Model Matrix, or visit the Developer Hub.

[!NOTE] Performance Metrics:

  • Time to First Token (TTFT) measures the time (in milliseconds) it takes to generate the first output token after input is received.
  • T/S/U (Tokens per Second per User): Represents the throughput of first-token generation after prefill. It is calculated as 1 / inter-token latency.
  • T/S (Tokens per Second): Represents total token throughput, calculated as T/S = T/S/U x batch size.
  • TP (Tensor Parallel) and DP (Data Parallel): Indicate the parallelization factors across multiple devices.
  • Reported LLM Performance: Based on an input sequence length of 128 tokens for all models.
  • Performance Data Source: Metrics were collected using the tt-metal model demos (linked above). Results may vary when using other runtimes such as the vLLM inference server.
Batch Hardware TTFT (MS) T/S/U Target
T/S/U
T/S TT-Metalium Release vLLM Tenstorrent Repo Release
32 Galaxy (Wormhole) 53 72.5 80 2268.8 v0.62.2 c348d08
Batch Hardware TTFT (MS) T/S/U Target
T/S/U
T/S TT-Metalium Release vLLM Tenstorrent Repo Release
32 QuietBox (Wormhole) 109 22.1 30 707.2 v0.59.0-rc52 f028da1

Blackhole software optimization is under active development. Please join us in shaping the future of open source AI!
[Discord] [Developer Hub]

For more information regarding vLLM installation and environment creation visit the Tenstorrent vLLM repository.

Model Updates

For the latest model updates and features, please see MODEL_UPDATES.md

Model Bring-Up and Testing

For information on initial model procedures, please see Model Bring-Up and Testing

TT-NN Tech Reports

Benchmarks


TT-Metalium logo

TT-Metalium is our low-level programming model, enabling kernel development for Tenstorrent hardware.

Programming Guide | API Reference

Getting started

Get started with simple kernels.

TT-Metalium Tech Reports

TT-Metalium Programming Examples

Hello World

Add Integers

Simple Tensor Manipulation

DRAM Data Movement

Eltwise

Matmul

Tools and Instruments

A comprehensive tool for visualizing and analyzing model execution, offering interactive graphs, memory plots, tensor details, buffer overviews, operation flow graphs, and multi-instance support with file or SSH-based report loading. Install via pip or build from source:

pip install ttnn-visualizer

Related Tenstorrent Projects

Latest Releases

Release Release Date
0.63.0 ETA Sep 15, 2025
0.62.2 Aug 20, 2025
0.61.0 Skipped
0.60.1 Jul 22, 2025
0.59.0 Jun 18, 2025
0.58.0 May 13, 2025
0.57.0 Apr 15, 2025
0.56.0 Mar 7, 2025

Visit the releases folder for details on releases, release notes, and estimated release dates.

Tenstorrent Bounty Program Terms and Conditions

This repo is a part of Tenstorrent’s bounty program. If you are interested in helping to improve tt-metal, please make sure to read the Tenstorrent Bounty Program Terms and Conditions before heading to the issues tab. Look for the issues that are tagged with both “bounty” and difficulty level!

License

TT-Metalium and TTNN are licensed under the Apache 2.0 License, as detailed in LICENSE and LICENSE_understanding.txt.

Some distributable forms of this project—such as manylinux-compliant wheels—may need to bundle additional libraries beyond the standard Linux system libraries. For example:

  • libnuma
  • libhwloc
  • openmpi (when built with multihost support)
  • libevent (when built with multihost support)

These libraries are bound by their own license terms.

For Tasks:

Click tags to check more tools for each tasks

For Jobs:

Alternative AI tools for tt-metal

Similar Open Source Tools

For similar tasks

For similar jobs