README.md

March 3, 2026 ยท View on GitHub

Tenstorrent AI Kernel-Mode Driver

Official Repository

https://github.com/tenstorrent/tt-kmd

Supported hardware:

  • Wormhole
  • Blackhole

The driver registers device files named /dev/tenstorrent/%d, one for each enumerated device.

Supported kernels:

Linux 5.4 or later. The driver is build-tested against mainline kernel versions from 5.4 through 6.18.

To install:

Pre-built .deb packages for Debian and Ubuntu are available at https://github.com/tenstorrent/tt-kmd/releases

For other distributions, install from source (see below).

To install from source:

  • You must have dkms installed.
    • apt install dkms (Debian, Ubuntu)
    • dnf install dkms (Fedora)
    • apk install akms (Alpine)
    • dnf install epel-release && dnf install dkms (Enterprise Linux based)
make dkms
  • For Alpine linux
make akms

With NixOS

  1. Add this repository as a nix flake input:
inputs.tt-kmd.url = "github:tenstorrent/tt-kmd";
  1. Add in the overlay:
nixpkgs.overlays = [ tt-kmd.overlays.default ];
  1. Add the package to the kernel modules and udev packages:
boot.extraModulePackages = [ config.boot.kernelPackages.tt-kmd ];
services.udev.packages = [ config.boot.kernelPackages.tt-kmd ];
  1. Rebuild: nixos-rebuild switch

To uninstall:

make dkms-remove
  • For Alpine linux
make akms-remove