Troubleshooting

No SSH keys found

Screenshot 2025-01-30 at 1 55 10 PM

Check your local ssh agent has your ssh key by running:

ssh-add -L

If your key isn’t present, run the following on your local machine:

ssh-add

Unable to find Python modules

deactivate
rm -rf myenv

Then follow the steps for creating virtual environment and reinstalling dependencies

Missing distutils package

With the virtualenv activated run:

pip install --upgrade setuptools

Event synchronization is not supported during trace capture

Report generation in TTNN is not compatible with trace capture. If you see this error, it likely means that trace capture has been enabled in TTNN. This is not a setting in TT-Metal or TTNN, but rather a hard-coded value in several of the models and demos.

How trace capture is enabled depends on the model or demo. In some cases you will see enable_trace = True in the Python code. In other cases it may be enabled by a --enable_trace CLI arg. Some tests use the PyTest parametrize decorator to run the demo both with and without trace capture.

Models or demos that have trace capture enabled need to be modified to not use that feature in order for report generation to work.