Troubleshooting

The app does not start

Check that Windows detects your NVIDIA GPU and that the driver meets the requirements for your release. Run ILARIA_RVC_LOGS.bat from the extracted installation directory and look for the first error. A browser failure often comes after the real startup error in the console.

If the log says the port is already in use, check for another running copy of Ilaria RVC and close it before retrying. If startup succeeds but the browser stays blank, open http://127.0.0.1:6969 and check whether your release uses a different address.

A model does not appear

Check that you imported an inference export and that the release supports its architecture. Extract archives first if the importer cannot open them. Try selecting the model and converting with Index Ratio at zero, then add its matching index after the basic conversion works.

Converted audio sounds distorted

Try a short recording without clipping, music, or heavy processing. Compare using default settings, then adjust pitch and index strength separately.

Conversion or training runs out of GPU memory

Check for other GPU workloads. Try one short clip in inference first. For training, reduce the batch size and ensure you can save and resume the run before experimenting further. A smaller batch changes the number of optimizer steps per epoch, so compare runs using both measures.

Real-time output clicks or echoes

Check routing and audio-device sample rates. Use headphones and test locally before routing the output to a call. If the output drops samples, try a larger buffer before lowering latency again. Follow the real-time setup guide to test one link in the signal path at a time.

For help, share your app version, GPU model and the relevant error message through the contact page. Remove personal details from logs before sharing.