donkeycar-rl-autoresearch/agent/TROUBLESHOOT.md

DonkeyCar RL Automation Troubleshooting

Fast Checklist

• Unity sim blank? Ensure no stuck Python RL script is running (ps aux | grep donkeycar_sb3_runner)
• Always call env.close() in the RL script!
• Wait at least 2 seconds between batch jobs
• Restart Unity sim from Windows if stuck
• Check network (port 9091 must be listening in Windows, reachable from WSL)

If you get stuck:

1. Stop all batch jobs in WSL
2. Fully quit and restart Unity DonkeyCar Simulator on Windows
3. Wait, then start the batch again
4. If failure occurs immediately, ensure sim is in correct mode (Remote/SocketAPI)
5. Confirm you are not running the same Python process in two places at once

Automated Batches Work When…

• Each RL process runs multiple episodes and exits cleanly
• Each process calls env.close() before exit
• Batch script sleeps ~2 seconds between runs