TT-Metalium
TT-Metalium is Tenstorrent’s open-source, low-level AI hardware SDK that provides a C++ API for writing kernels targeting Tensix processors, giving developers direct access to RISC-V cores, the Network-on-Chip (NoC), and Matrix/Vector engines.
Publisher review
TT-Metalium is Tenstorrent’s open-source, low-level AI hardware SDK that provides a C++ API for writing kernels targeting Tensix processors, giving developers direct access to RISC-V cores, the Network-on-Chip (NoC), and Matrix/Vector engines. It is designed for engineers who need full control over hardware and data movement — enabling custom kernel development, experimentation, and optimization for both ML and non-ML workloads. The SDK sits at the foundation of Tenstorrent’s software stack, below higher-level libraries like TTNN (which offers Python APIs for common ML operations) and TT-Forge/TT-MLIR (compilation frameworks for neural network deployment). It is best suited for advanced users comfortable with low-level programming and hardware architecture, as it exposes every detail of the Tensix core for fine-grained tuning.
TT-Metalium follows a bottom-up programming philosophy: start with a single Tensix core kernel, then schedule across multiple cores with synchronization, and finally scale to multi-device deployments. Operations typically use a three-stage pipeline — a reader kernel moves data from DRAM/SRAM into circular buffers, a compute kernel processes data using Matrix/Vector engines, and a writer kernel writes results back. Circular buffers act as FIFO structures enabling overlapped execution (fetching new data while compute processes previous data). The SDK includes features like reader, compute, and writer kernel abstractions, and supports custom fused kernels and tensor manipulations (TMs). The GitHub repository (tt-metal) has over 1,500 stars, 484 forks, and 27,463 commits as of June 2026, reflecting active development.
In the low-level AI hardware SDK market, TT-Metalium competes directly with NVIDIA's CUDA (proprietary, closed-source) and AMD's ROCm (open-source but less mature for AI). Unlike CUDA, which encrypts APIs and hides hardware details, TT-Metalium is fully open-source with no black boxes or hidden functions — developers can inspect and modify every layer. It also differs from Intel's oneAPI (which abstracts across hardware) by providing direct, unabstracted access to Tenstorrent's Tensix architecture. For non-ML workloads, it competes with general-purpose GPU compute frameworks like OpenCL, but TT-Metalium is purpose-built for Tenstorrent's specific hardware topology. Its openness is a differentiator against proprietary SDKs, but its ecosystem and community size are smaller than CUDA's.
The honest trade-offs: TT-Metalium requires deep knowledge of Tensix hardware details (RISC-V cores, NoC topology, memory hierarchy) and low-level C++ programming, making it unsuitable for beginners or rapid prototyping. The SDK is complex — developers must manually manage data movement, synchronization, and kernel orchestration, which increases development time compared to higher-level frameworks like PyTorch. Documentation, while improving, is still evolving (the docs site has a single guide with limited examples), and community support is primarily through a Discord server rather than extensive forums or tutorials. Finally, TT-Metalium is tied exclusively to Tenstorrent hardware (Grayskull, Wormhole, etc.), so code written for it cannot run on NVIDIA, AMD, or Intel GPUs without a complete rewrite.
How it works
-
C++ kernel API
Provides a C++ API for writing kernels that run on Tensix hardware, enabling direct control over computation and data movement.
-
Three-stage pipeline
Operations follow a reader-compute-writer pipeline using circular buffers as FIFOs, allowing overlapped execution for performance.
-
Full hardware control
Exposes RISC-V processors, NoC, and Matrix/Vector engines within Tensix cores for low-level optimization and tuning.
-
ML and non-ML support
Supports both machine learning workloads (e.g., matrix multiplication) and non-ML tasks (e.g., image resizing) on Tenstorrent hardware.
-
Host-kernel abstraction
Offers an abstraction layer between the host system (e.g., x86 CPU) and Tenstorrent devices for organizing host programs.
-
Custom kernel development
Allows writing custom fused kernels and tensor manipulations (TMs) for heavyweight optimization beyond pre-built libraries.
-
Open-source foundation
Sits at the base of Tenstorrent's software stack, with TTNN and TT-Forge built on top, and is fully open-source on GitHub.
Strengths and trade-offs
Strengths
- TT-Metalium is fully open-source with no encrypted APIs or hidden functions, allowing developers to inspect and modify every layer of the SDK.
- It provides direct access to RISC-V cores, NoC, and Matrix/Vector engines, enabling fine-grained optimization that is impossible with closed-source SDKs like CUDA.
- The three-stage pipeline with circular buffers supports overlapped execution, improving throughput for data-intensive operations on Tensix hardware.
- It supports both ML and non-ML workloads, making it versatile for custom kernel development beyond neural network inference and training.
Trade-offs
- Requires deep knowledge of Tensix hardware architecture (RISC-V, NoC, memory hierarchy) and low-level C++ programming, creating a steep learning curve for beginners.
- Developers must manually manage data movement, synchronization, and kernel orchestration, increasing development time compared to higher-level frameworks like PyTorch.
- Documentation is still evolving with limited examples and guides, and community support is primarily through Discord rather than extensive forums or tutorials.
- Code written for TT-Metalium is locked to Tenstorrent hardware (Grayskull, Wormhole) and cannot be ported to NVIDIA, AMD, or Intel GPUs without a complete rewrite.
Pricing context
Open source (free, no licensing fees; available on GitHub under an open-source license)
Getting started with TT-Metalium
-
Clone the repository
Clone the tt-metal repository from GitHub to your local machine. This gives you the full source code and build scripts needed to compile the SDK and start developing kernels for Tensix processors.
-
Set up build dependencies
Install required dependencies such as a C++ compiler, CMake, and Tenstorrent hardware drivers. Follow the build instructions in the repository's README to configure your environment for compiling TT-Metalium.
-
Compile the SDK
Run the build script (e.g., `make` or `cmake --build`) to compile TT-Metalium. This produces the libraries and tools needed to write and run kernels on your Tenstorrent device.
-
Write a single-core kernel
Create a C++ file that defines a simple kernel using the TT-Metalium API. Implement a reader, compute, and writer kernel to move data from DRAM to circular buffers, process it, and write results back.
-
Run the kernel on device
Compile your kernel code and execute it on a Tenstorrent device using the provided runtime. Verify output correctness and measure performance to confirm the pipeline works as expected.
Frequently Asked Questions
What is TT-Metalium and what does it do?
TT-Metalium is Tenstorrent's open-source, low-level AI hardware SDK. It provides a C++ API for writing kernels that run on Tensix processors, giving developers direct access to RISC-V cores, the Network-on-Chip, and Matrix/Vector engines for fine-grained optimization.
How does TT-Metalium compare to NVIDIA CUDA?
Unlike CUDA, which is proprietary and encrypts APIs, TT-Metalium is fully open-source with no hidden functions. Developers can inspect and modify every layer. However, TT-Metalium is tied exclusively to Tenstorrent hardware, while CUDA works across NVIDIA GPUs.
What are the key features of TT-Metalium?
Key features include a C++ kernel API, a three-stage reader-compute-writer pipeline with circular buffers for overlapped execution, full hardware control over RISC-V cores and NoC, support for ML and non-ML workloads, and custom kernel development for advanced optimization.
Is TT-Metalium suitable for beginners?
No, TT-Metalium requires deep knowledge of Tensix hardware architecture and low-level C++ programming. Developers must manually manage data movement and synchronization, making it unsuitable for beginners or rapid prototyping compared to higher-level frameworks like PyTorch.
What hardware does TT-Metalium support?
TT-Metalium is exclusively tied to Tenstorrent hardware, such as Grayskull and Wormhole processors. Code written for it cannot run on NVIDIA, AMD, or Intel GPUs without a complete rewrite, limiting portability across different platforms.
Is TT-Metalium free to use and open source?
Yes, TT-Metalium is open source and free with no licensing fees. It is available on GitHub under an open-source license, and developers can inspect and modify every layer of the SDK, unlike proprietary alternatives like CUDA.
Alternatives
How TT-Metalium compares
Direct head-to-head against 2 competitors. Picked by 7wData.
TT-Metalium
- Pricing
- Open source (free, no licensing fees; available on GitHub under an open-source license)
- Target
- TT-Metalium is Tenstorrent’s open-source, low-level AI hardware SDK that provides a C++ API for writing kernels targeting Tensix processors, giving developers direct access to RISC-V
- Strength
- TT-Metalium is fully open-source with no encrypted APIs or hidden functions, allowing developers to inspect and modify every layer of the SDK.
- Watch for
- Requires deep knowledge of Tensix hardware architecture (RISC-V, NoC, memory hierarchy) and low-level C++ programming, creating a steep learning curve for beginners.
CoreWeave
- Pricing
- H100 PCIe ~$4.76/hr per-hour billing
- Target
- Enterprise large-scale AI training and inference workloads
- Deployment
- Cloud, partial bare metal
- Strength
- 256+ GPU clusters for distributed training
- Watch for
- Higher per-hour pricing than bare metal alternatives
Lambda Labs
- Pricing
- H100 SXM ~$3.29/hr on-demand per-minute billing
- Target
- Research labs and teams needing reserved GPU capacity
- Deployment
- Cloud, partial bare metal
- Strength
- Clusters up to 2,000+ GPUs for large-scale training
- Watch for
- On-demand pricing higher than reserved; limited bare metal control
User reviews
No user reviews yet. Be the first to write one.
Sources
Reporting on this tool draws on these publicly available sources.