메뉴
Set up and verify remote connection to Tenstorrent hardware. Provides tools for running kernels, copying files, and reading logs on remote devices.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
File a bug report with a reproducer against Tenstorrent repos (tt-lang, tt-metal, tt-xla)
TTNN trace capture and replay for eliminating dispatch overhead. Essential for real-time inference and multi-chip performance.
Profile and optimize TT-Lang kernels for performance. Covers auto-profiling, perf summary, signposts, and optimization workflow.
Comprehensive TT-Lang DSL reference including programming model, APIs, hardware constraints, and guides for translating CUDA, Triton, PyTorch, or TTNN kernels
TTNN operations library reference for Tenstorrent hardware. Covers tensor APIs, ops catalog, model conversion from PyTorch, and memory/layout configuration.
SOC 직업 분류 기준
| name | tt-connect-remote-device |
| description | Set up and verify remote connection to Tenstorrent hardware. Provides tools for running kernels, copying files, and reading logs on remote devices. |
| user-invocable | true |
All tools are in the scripts/ directory relative to this skill. Invoke them with the full path.
Before doing anything else, run the smoke test to verify your remote setup:
<path-to>/tt-connect-remote-device/scripts/smoke-test.sh
If the smoke test fails, STOP. Do NOT continue. Ask the user to fix their remote setup first.
If the smoke test fails due to remote.conf not existing, STOP, offer to help them create it from scripts/remote.conf.example. Then work on getting the smoke test passing before exploring or continuing.
NOTE: flags on run-test.sh must come before the file argument. You can use --help if unsure on how to use.
NOTE: run-test.sh will copy the file. You do not need to copy the test file each time.
scripts/run-test.sh /path/to/kernel.py # Run in functional simulator (default)
scripts/run-test.sh --hw /path/to/kernel.py # Run on real hardware (final validation)
scripts/run-test.sh --hw --emit-runner /path/to.py # Run + emit C++ kernels and Python runner
scripts/copy-file.sh /path/to/file.py # Copy a file TO the remote
scripts/copy-from-remote.sh /remote/path ./local_dir/ # Copy a file FROM the remote
scripts/remote-run.sh <command> # Run an arbitrary command on the remote
By default, run-test.sh uses the functional simulator (ttlang-sim). Use --hw for real hardware. Iterate with the simulator first. Only move to --hw for final validation or if the simulator has a bug that blocks your work. Note: the simulator cannot run TT-Metal C++ programs, so export workflows always require --hw.
Reading remote logs (output is saved, not streamed):
scripts/remote-run.sh cat /tmp/ttlang_test_output.log # Full log
scripts/remote-run.sh tail -100 /tmp/ttlang_test_output.log # Last 100 lines
scripts/remote-run.sh cat /tmp/ttlang_test_output.log | grep -i "error" # Search log
scripts/remote-run.sh cat /tmp/ttlang_initial.mlir # Initial MLIR
scripts/remote-run.sh cat /tmp/ttlang_final.mlir # Final MLIR
NOTE: Grep with quoted patterns containing spaces does not work via remote-run.sh due to quoting through the SSH+docker chain. Always pipe through grep locally: remote-run.sh cat /path/to/file | grep "pattern"