tt — the Tenstorrent CLI

One command for everything Tenstorrent.

tt is the single entry point to the Tenstorrent software stack. It either implements a function natively or delegates to an existing tool (tt-smi, tt-installer, etc.) behind a stable interface.

[!IMPORTANT] This is beta software. Expect breaking changes often as we add features. We welcome your feedback to help us improve tt-cli. If you have an issue or a comment, please don't hesitate to let us know through the GitHub issues page.

Quick start

Install with uv (recommended):

uv tool install tenstorrent
tt --help

(uv tool update-shell will make sure the tt binary is available on your PATH)

If you don't have uv, install it first:

curl -LsSf https://astral.sh/uv/install.sh | sh

You can also install the CLI with any pip-compatible tool, such as pipx. We highly recommend placing tt-cli in an isolated venv so it can safely update itself. For other installation methods, see DEVELOPERS.md.

Telemetry

Telemetry is opt-in: nothing is collected or sent unless you say so. tt asks once, on first interactive run, and doesn't bother you about it on later runs.

If you opt in, tt records command names, exit codes, coarse OS facts, and argument values only when they match a known list (e.g. catalog model names). We never send free-form arguments, paths, or static IDs. Exactly what is collected, every switch that controls it, and how delivery works: TELEMETRY.md.

If you change your mind about telemetry, use tt config set telemetry.enabled true or false. If you previously enabled telemetry, setting it to false opts you out and deletes anything not yet uploaded.

Example commands

This is not an exhaustive list. For the full list of commands and options in each group, add --help, e.g. tt model --help.

Interactive clients with tt launch

tt serve gives you an OpenAI-compatible endpoint; tt launch points a client at it. tt discovers what is running by asking the server itself (GET /v1/models) and configures the client's endpoint for you.

tt launch list                         # what can I connect, and is it usable now?
tt serve Qwen3-32B --port 8000         # in another terminal
tt launch openwebui --web-port 3080    # pull and run its container, after you confirm
tt launch stop openwebui               # stop it, keeping its data

Configuration

Configuration is TOML at ~/.config/tenstorrent/config.toml (XDG-compliant). tt config opens it with explanatory comments; edits preserve comments. Prefer tt config set <key> <value> over hand-editing: it puts the key in the correct table.

Contributing

We welcome contributions! Please see CONTRIBUTING.md for details on:

• Reporting bugs via GitHub Issues
• Submitting pull requests
• Code standards and SPDX header requirements
• Our weekly PR review cadence

License

This project is licensed under the Apache License 2.0 - see the LICENSE file for the overall license, except where specified.

For clarification on how the Apache 2.0 license applies to this project, including hardware and patent considerations, see LICENSE_understanding.txt.