// readme

ttsim, a fast full-system simulator of Tenstorrent hardware

ttsim provides a virtual Wormhole, Blackhole, or Quasar device that can run on any Linux/x86_64 or Linux/aarch64 system (including Windows via WSL2 and macOS via UTM/QEMU), without Tenstorrent silicon required. It is slower than silicon but still fast enough that you can run interesting workloads with good productivity, allowing you to explore and experiment with Tenstorrent’s hardware and programming model before purchasing silicon.

Each simulator consists of a single libttsim.so file compiled for a specific chip architecture (Wormhole, Blackhole, or Quasar). This library exports a simple API that TT-Metalium knows how to communicate with.

Distribution

This repository contains the open-source ttsim source code for Wormhole and Blackhole, released under the Apache License 2.0. Prebuilt binaries for Wormhole, Blackhole, and Quasar for both Linux/x86_64 and Linux/aarch64 are also provided via GitHub Releases; Quasar is pre-silicon and ships as…