- C++ 50.5%
- Python 44.8%
- C 3.2%
- Shell 0.6%
- CMake 0.5%
- Other 0.3%
c01887f34a
Some checks failed
runner-failure-report.yaml / [Cleanup] Adding `UnitMeshFixture` to modernize single-device tests (#52222) (push) Failing after 0s
Merge Gate / static-checks (push) Has been cancelled
Merge Gate / docker-images (push) Has been cancelled
Merge Gate / check-harbor (push) Has been cancelled
Merge Gate / find-changes (push) Has been cancelled
Merge Gate / build (push) Has been cancelled
Merge Gate / build-tsan (push) Has been cancelled
Merge Gate / build-asan (push) Has been cancelled
PR Gate / check-harbor (push) Has been cancelled
Merge Gate / build-sweeps (push) Has been cancelled
Merge Gate / resolve-docker-pull-refs (push) Has been cancelled
Merge Gate / resolve-docker-pull-refs-tsan (push) Has been cancelled
Merge Gate / resolve-docker-pull-refs-asan (push) Has been cancelled
Merge Gate / runtime-smoke-tests (push) Has been cancelled
Merge Gate / runtime-basic-tests (push) Has been cancelled
Merge Gate / triage-tests (push) Has been cancelled
Merge Gate / ttnn-smoke-tests (push) Has been cancelled
Merge Gate / ttnn-basic-tests (push) Has been cancelled
Merge Gate / ttnn-merge-gate-tests (push) Has been cancelled
Merge Gate / models-smoke-tests (push) Has been cancelled
Merge Gate / train-merge-gate-tests (push) Has been cancelled
Merge Gate / scaleout-unit-tests (push) Has been cancelled
Merge Gate / scaleout-cpu-only-unit-tests (push) Has been cancelled
Merge Gate / resolve-docker-pull-refs-llk (push) Has been cancelled
Merge Gate / Build Quasar Perf (push) Has been cancelled
Merge Gate / llk-unit-tests (push) Has been cancelled
Merge Gate / Merge Gate Status (push) Has been cancelled
Compute Public API Surface / compute_and_notify (push) Has been cancelled
PR Gate / build-docker-images (push) Has been cancelled
PR Gate / resolve-docker-pull-refs (push) Has been cancelled
PR Gate / asan-build (push) Has been cancelled
PR Gate / find-changed-files (push) Has been cancelled
PR Gate / runtime-smoke-tests (push) Has been cancelled
PR Gate / ttnn-smoke-tests (push) Has been cancelled
PR Gate / build-docs (push) Has been cancelled
PR Gate / runtime-examples (push) Has been cancelled
PR Gate / ttnn-examples (push) Has been cancelled
Sanity tests / t3000-apc-fast-tests (push) Has been cancelled
PR Gate / model-charts-sync (push) Has been cancelled
PR Gate / code-analysis (push) Has been cancelled
PR Gate / llk-label-pr (push) Has been cancelled
PR Gate / copilot-pr-labeler (push) Has been cancelled
PR Gate / llk-smoke-tests (push) Has been cancelled
PR Gate / llk-build-quasar (push) Has been cancelled
PR Gate / PR Gate Status (push) Has been cancelled
Sanity tests / check-harbor (push) Has been cancelled
Sanity tests / build-artifact (push) Has been cancelled
Sanity tests / resolve-artifacts (push) Has been cancelled
Sanity tests / resolve-docker-pull-refs (push) Has been cancelled
Sanity tests / tests-to-run (push) Has been cancelled
Sanity tests / ttnn-sanity-tests (push) Has been cancelled
Sanity tests / ops-sanity-tests (push) Has been cancelled
Sanity tests / ttsim-sanity-tests (push) Has been cancelled
Sanity tests / runtime-sim-sanity-tests (push) Has been cancelled
### PR Category Cleanup, Test Only ### Summary This PR provides a pattern for removing legacy `IDevice` and `Buffer` usage in tests on the example of test_matmul_single_tile_output_in_l1. Single-device tests can use new `UnitMeshFixture` and its methods to run programs and do read/write on a unit `MeshBuffer` instead of `Buffer`. `MeshBuffer::create` can be used to create buffers instead of `CreateBuffer`, and there's no need for the complex device access `devices_[0]->get_devices()[0]`. ### Notes for reviewers ### CI Status _Auto-generated on every push. Badges update live. Click a badge to filter runs by this branch._ - [](https://github.com/tenstorrent/tt-metal/actions/workflows/sanity-tests.yaml?query=branch:obacherikov-unit-mesh-fixture) - [](https://github.com/tenstorrent/tt-metal/actions/workflows/runtime-sanity-tests.yaml?query=branch:obacherikov-unit-mesh-fixture) - [](https://github.com/tenstorrent/tt-metal/actions/workflows/blackhole-sanity-tests.yaml?query=branch:obacherikov-unit-mesh-fixture) - [](https://github.com/tenstorrent/tt-metal/actions/workflows/tt-metal-l2-nightly.yaml?query=branch:obacherikov-unit-mesh-fixture) - [](https://github.com/tenstorrent/tt-metal/actions/workflows/all-model-tests.yaml?query=branch:obacherikov-unit-mesh-fixture) - [](https://github.com/tenstorrent/tt-metal/actions/workflows/pipeline-select.yaml?query=branch:obacherikov-unit-mesh-fixture) - [](https://github.com/tenstorrent/tt-metal/actions/workflows/pipeline-select-t3k.yaml?query=branch:obacherikov-unit-mesh-fixture) - [](https://github.com/tenstorrent/tt-metal/actions/workflows/pipeline-select-galaxy.yaml?query=branch:obacherikov-unit-mesh-fixture) |
||
|---|---|---|
| .cursor | ||
| .github | ||
| cmake | ||
| contributing | ||
| dockerfile | ||
| docs | ||
| infra | ||
| model_tracer | ||
| models | ||
| releases | ||
| scripts | ||
| tech_reports | ||
| tests | ||
| third_party | ||
| tools | ||
| tt-train | ||
| tt_metal | ||
| tt_stl | ||
| ttnn | ||
| .clang-format | ||
| .clang-format-ignore | ||
| .clang-tidy | ||
| .codechecker.json | ||
| .codechecker.skiplist | ||
| .gersemirc | ||
| .git-blame-ignore-revs | ||
| .gitattributes | ||
| .gitignore | ||
| .gitmodules | ||
| .pre-commit-config.yaml | ||
| .yamllint | ||
| build_metal.sh | ||
| CMakeLists.txt | ||
| CMakePresets.json | ||
| CODE_OF_CONDUCT.md | ||
| conftest.py | ||
| CONTRIBUTING.md | ||
| create_venv.sh | ||
| install_dependencies.sh | ||
| INSTALLING.md | ||
| LICENSE | ||
| LICENSE_understanding.txt | ||
| MANIFEST.in | ||
| METALIUM_GUIDE.md | ||
| NOTICE | ||
| pyproject.toml | ||
| pytest.ini | ||
| README.md | ||
| setup.py | ||
Hardware | Install | Discord | Join Us | Bounty $
TT-NN is a Python & C++ Neural Network OP library.
Featured Models
The Models team is focused on developing the following models, optimizing them 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.
Llama 3.3 70B (TP=32)
| 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.65.0-rc7 | 59be953 |
Qwen 2.5 7B (TP=2)
| Batch | Hardware | TTFT (MS) | T/S/U | Target T/S/U |
T/S | TT-Metalium Release | vLLM Tenstorrent Repo Release |
|---|---|---|---|---|---|---|---|
| 32 | n300 (Wormhole) | 109 | 22.1 | 30 | 707.2 | v0.62.0-rc35 | ced0161 |
Qwen 2.5 72B (TP=8)
| Batch | Hardware | TTFT (MS) | T/S/U | Target T/S/U |
T/S | TT-Metalium Release | vLLM Tenstorrent Repo Release |
|---|---|---|---|---|---|---|---|
| 32 | QuietBox (Wormhole) | 223 | 15.4 | 20 | 492.8 | v0.62.0-rc25 | e7c329b |
Whisper (distil-large-v3)
| Batch | Hardware | TTFT (MS) | T/S/U | Target T/S/U |
T/S | TT-Metalium Release |
|---|---|---|---|---|---|---|
| 1 | n150 (Wormhole) | 163 | 105.0 | 45 | 105.0 | v0.65.0-dev20251208 |
| 1 | p150 (Blackhole) | 63 | 263.4 | 263.4 | v0.65.0-dev20251208 |
Mixtral 8x7B (TP=8)
| Batch | Hardware | TTFT (MS) | T/S/U | Target T/S/U |
T/S | TT-Metalium Release |
|---|---|---|---|---|---|---|
| 32 | QuietBox (Wormhole) | 122 | 24.9 | 33 | 796.8 | v0.62.0-dev20251015 |
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 TT plugin README.
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
- Advanced Performance Optimizations for Models (updated March 4th, 2025)
- ViT Implementation in TT-NN on GS (updated Sept 22nd, 2024)
- LLMs Bring up in TT-NN (updated Oct 29th, 2024)
- CNN Bring up & Optimization in TT-NN (updated Jan 22nd, 2025)
Benchmarks
- Matrix Multiply FLOPS on Wormhole and Blackhole (updated June 17th, 2025)
TT-Metalium is our low-level programming model, enabling kernel development for Tenstorrent hardware.
Getting started
Get started with simple kernels.
TT-Metalium Tech Reports
- Matrix Engine (updated Sept 6th, 2024)
- Data Formats (updated Sept 7th, 2024)
- Reconfiguring Data Formats (updated Oct 17th, 2024)
- Handling special floating-point numbers (updated Oct 5th, 2024)
- Allocator (Updated Dec 19th, 2024)
- Tensor Layouts (updated Sept 6th, 2024)
- Saturating DRAM Bandwidth (updated Sept 6th, 2024)
- Flash Attention on Wormhole (updated Sept 6th, 2024)
- CNNs on TT Architectures (updated Sept 6th, 2024)
- Ethernet and Multichip Basics (Updated Sept 20th, 2024)
- Blackhole Bring-Up Programming Guide (Updated Dec 18th, 2024)
- Sub-Devices (Updated Jan 7th, 2025)
Scaleout Tech Reports
- Programming Mesh of Devices (Scale-Up) (updated Jan 6th, 2026)
- CCL Performance Tuning Tips (updated Jul 10th, 2026)
- Programming Multiple Meshes (Scale-Out) (updated Jan 19th, 2026)
- TT-Fabric Architecture (updated Dec 1st, 2025)
- TT-Distributed Architecture (updated Oct 20th, 2025)
TT-Metalium Programming Examples
Hello World
Add Integers
Simple Tensor Manipulation
DRAM Data Movement
Eltwise
Matmul
- Matmul OP on a Single_core
- Matmul OP on Multi_core (Basic)
- Matmul Multi_core Reuse (Optimized)
- Matmul Multi_core Multi-Cast (Optimized)
Tools and Instruments
TT-NN Visualizer
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.
TT-Exalens
The TT-Exalens repository describes TT-Lensium, a low-level debugging tool for Tenstorrent hardware. It allows developers to access and communicate with Wormhole and Blackhole devices.
TT-SMI
The TT-SMI repository describes the Tenstorrent System Management Interface. This command line utility can interact with Tenstorrent devices on host. TT-SMI provides an easy to use interface displaying device, telemetry, and firmware information.
Model Explorer
The Model Explorer is an intuitive and hierarchical visualization tool using model graphs. It organizes model operations into nested layers and provides features for model exploration and debugging.
Tracy Profiler
The Tracy Profiler is a real-time nanosecond resolution, remote telemetry, hybrid frame, and sampling tool. Tracy supports profiling CPU, GPU, memory allocation, locks, context switches, and more.
Device Print Debug
DPRINT can print variables, addresses, and circular buffer data from kernels to the host terminal or log file. This feature is useful for debugging issues with kernels.
Watcher
Watcher monitors firmware and kernels for common programming errors, and overall device status. If an error or hang occurs, Watcher displays log data of that occurrence.
Inspector
Inspector provides insights into host runtime. It logs necessary data for investigation and allows queries to host runtime data.
Related Tenstorrent Projects
Latest Releases
| Release | Release Date | FW Version | KMD Version | SMI Version |
|---|---|---|---|---|
| 0.68.0 | ETA Apr 30, 2026 | 19.2.0 | 2.5.0 | 3.0.38 |
| 0.67.4 | Mar 30, 2026 | 19.2.0 | 2.5.0 | 3.0.38 |
| 0.67.0 | Mar 25, 2026 | 19.2.0 | 2.5.0 | 3.0.38 |
| 0.66.0 | Feb 18, 2026 | 19.2.0 | 2.5.0 | 3.0.38 |
| 0.65.1 | Jan 12, 2026 | 19.2.0 | 2.5.0 | 3.0.38 |
| 0.65.0 | Dec 15, 2025 | 19.2.0 | 2.5.0 | 3.0.38 |
| 0.64.5 | Dec 1, 2025 | 18.12.0 | 2.4.1 | 3.0.32 |
| 0.64.4 | Nov 24, 2025 | 18.12.0 | 2.4.1 | 3.0.32 |
| 0.64.3 | Nov 14, 2025 | 18.12.0 | 2.4.1 | 3.0.32 |
| 0.64.0 | Oct 29, 2025 | 18.12.0 | 2.4.1 | 3.0.32 |
| 0.63.0 | Sep 22, 2025 | 18.8.0 | 2.3.0 | 3.0.28 |
| 0.62.2 | Aug 20, 2025 | 18.6.0 | 2.0.0 | 3.0.20 |
| 0.61.0 | Skipped | - | - | - |
| 0.60.1 | Jul 22, 2025 | 18.6.0 | 2.0.0 | 3.0.20 |
| 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.