| # Problemas com Vulkan — Troubleshooting | |
| ## Erros Comuns | |
| ### Vulkan não detectado | |
| **Sintoma:** `vulkaninfo` retorna erro ou GPU não listada | |
| **Solução:** | |
| - Reinstalar driver AMD (versão 31.0.21924.61 confirmada estável) | |
| - Verificar se Vulkan Runtime está instalado junto com o SDK | |
| - Reiniciar após instalação do driver | |
| ### llama.cpp não usa GPU | |
| **Sintoma:** Processo rodando só na CPU, sem offload | |
| **Solução:** | |
| - Confirmar compilação com `-DGGML_VULKAN=ON` | |
| - Usar `-ngl 35` no comando de execução | |
| - Verificar output de inicialização: deve aparecer `ggml_vulkan: Found 1 Vulkan devices` | |
| ### Crash ao carregar modelo grande | |
| **Sintoma:** Processo encerra sem aviso ao carregar modelos >6GB | |
| **Solução:** | |
| - Reduzir `-ngl` (ex: de 35 para 20) | |
| - Usar `--ctx-size 1024` para economizar VRAM | |
| - Preferir quantizações menores (Q4_K_M em vez de Q8) | |
| ### Performance degradada após uso prolongado | |
| **Sintoma:** Tokens/s caindo progressivamente | |
| **Solução:** | |
| - Reiniciar o processo llama.cpp | |
| - Verificar temperatura da GPU (possível throttling) | |
| - Reduzir `--batch-size` | |
| ## Versões Estáveis Confirmadas | |
| - Driver AMD: 31.0.21924.61 | |
| - Vulkan SDK: 1.4.341.1 | |