Troubleshooting

A model download fails

• Try again. Downloads can be resumed, so starting the download again continues from where it stopped.
• Use the China mirror. If you are in mainland China, or Hugging Face is slow or blocked on your network, turn on the China mirror (hf-mirror.com) in the app's settings.
• Check your disk space. Make sure the drive with the app's data folder has enough free space for the model. The video model alone is about 30 GB. See Models for sizes and Getting Started for the folder location.
• Video model: check your token. LTX-2.5 needs a Hugging Face access token. Make sure you have entered a valid token in the app. The other models do not need one.

Windows SmartScreen blocks the installer

The Windows installer is not code-signed yet, so SmartScreen may show "Windows protected your PC". Click More info, then Run anyway.

Windows: GPU driver or Vulkan missing

On Windows, TopLocal Studio uses the GPU through Vulkan. The music and speech engine needs vulkan-1.dll, which is installed together with your GPU driver. If music or speech fails with a local engine error:

1. Download and install the latest driver for your GPU from NVIDIA, AMD or Intel.
2. Restart your computer.
3. Open TopLocal Studio again.

Your GPU must support Vulkan. The Windows build is still early, so if the problem continues after updating the driver, please report it on GitHub.

Generation is slow

How fast generation runs depends on your hardware. Some things that help:

• Use a smaller model. For example, FLUX.2 klein 4B instead of 9B for images, or Qwen3-ASR 0.6B instead of 1.7B for transcription.
• Lower the resolution. For video, 480p is faster than 720p.
• Make shorter clips. A 3-second video takes less time than an 8-second one.
• Close other heavy apps to free up memory for the model.

Reporting a problem

If your problem is not listed here, please open an issue on GitHub Issues. It helps to include:

• your operating system and version
• your computer's memory and, on Windows, your GPU model
• which module and model you were using
• what you did and what happened

For questions about your purchase, email support@localaicreator.com.