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.

Reviewed by 7wData

On this page

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.

Get the AI & data signal, daily.

335k+ subscribers read this every morning. One email, both newsletters. Unsubscribe anytime.

How it works

  1. C++ kernel API

    Provides a C++ API for writing kernels that run on Tensix hardware, enabling direct control over computation and data movement.

  2. Three-stage pipeline

    Operations follow a reader-compute-writer pipeline using circular buffers as FIFOs, allowing overlapped execution for performance.

  3. Full hardware control

    Exposes RISC-V processors, NoC, and Matrix/Vector engines within Tensix cores for low-level optimization and tuning.

  4. 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.

  5. Host-kernel abstraction

    Offers an abstraction layer between the host system (e.g., x86 CPU) and Tenstorrent devices for organizing host programs.

  6. Custom kernel development

    Allows writing custom fused kernels and tensor manipulations (TMs) for heavyweight optimization beyond pre-built libraries.

  7. 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

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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.

This tool

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.

  1. github.com
  2. tenstorrent.com
  3. docs.tenstorrent.com
  4. github.com