tt-connect-remote-device

Establish remote connections to Tenstorrent hardware and run kernels, copy files, and read logs.

341|51|Updated Aug 22, 2024
One-click install
npx skills add https://github.com/tenstorrent/tt-forge --skill tt-connect-remote-device
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tt-connect-remote-device
Source: https://github.com/tenstorrent/tt-forge/tree/main/skills/tt-connect-remote-device
Command: npx skills add https://github.com/tenstorrent/tt-forge --skill tt-connect-remote-device

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires ssh, docker, scp, and includes scripts (resource) components.

What problem does it solve?

Set up and verify remote connections to Tenstorrent hardware, enabling running kernels, copying files, and reading logs across devices.

Core Features & Use Cases

  • Remote smoke tests: verify connectivity and basic toolchain using scripts/smoke-test.sh.
  • File transfer and remote execution: copy files to the remote and run commands via scripts (copy-file.sh, remote-run.sh).
  • Debugging and monitoring: read remote logs and ML/runner outputs to diagnose issues.

Quick Start

Run the smoke test to verify your remote setup before proceeding.

Frequently Asked Questions about tt-connect-remote-device

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I verify remote access to Tenstorrent hardware?

You can verify remote access to Tenstorrent hardware by running the smoke test script, which checks connectivity and validates the basic toolchain before executing kernels or copying files.

How do I run kernels and copy files to a remote device over SSH?

You can run kernels and copy files to a remote device over SSH using dedicated shell scripts for file transfer and remote command execution, configured via a remote.conf file.

What is the best way to read logs on remote hardware for debugging?

Reading logs on remote hardware involves establishing an SSH connection and executing retrieval commands to inspect ML runner outputs and diagnose issues across connected devices.

Do I need Docker and SCP to run remote execution tests on Tenstorrent hardware?

Yes, Docker and SCP are required dependencies to facilitate containerized environments and file transfers when setting up remote execution testing on Tenstorrent hardware.

Can I use this remote connection workflow to inspect ML runner outputs across multiple devices?

Yes, the remote connection workflow supports inspecting ML runner outputs and diagnosing issues across multiple hardware resources using configured remote access scripts.

Why is my remote smoke test not working on Tenstorrent hardware?

A failed remote smoke test usually indicates incorrect SSH connectivity settings or missing toolchain prerequisites, which the smoke test script checks before proceeding.