GPU troubleshooting: Q4, Q8, and video memory
| Model | Indicative video memory | Use |
|---|---|---|
| Q4 | About 8 GB or more, depending on the card and context | Default setting to start with |
| Q8 | About 12 GB or more | May offer better fidelity when enough memory is available |
Common symptoms
- GPU test exits with code 2: check that the NVIDIA driver is installed and
nvidia-smidetects your card. - Out of memory or process stopped: choose Q4, close other apps using the GPU, and keep
max_loaded_models=1. - Hash check fails: run
verify-hashesagain. Do not substitute a different CUDA archive.
Checklist
- Update the NVIDIA driver.
- Check that the CUDA archive matches your system (Windows 12.4 or Linux 12.8).
- Run the Q4 model verification again.
- Make sure
health-checkpasses before restarting Song Maker.