Setup (Ubuntu)

Get Ubuntu (a Linux Distribution)

You will need Ubuntu 20.04. You can either either

1. Dual Boot your PC to Ubuntu (RECOMENDED)
   • Remember to have a USB stick of at least 8-16 GB
2. Use a VM (GOOD to START)

Robot Software is quite CPU/GPU heavy and you need a lot of system resources to run them. If you are using dual boot, ensure your computer meets the following requirements

• MACS ARE NOT SUPPORTED. Only PC with Nvidia GPU are supported
• Make sure its Ubuntu 20.04 LTS and not 18.04.5 LTS and not 22.04 LTS
• Make sure the Ubuntu storage size is at least 200GB.
• At least an 8 core machine with 16 GB RAM is needed
• GPU must be Nvidia based and capable of running CUDA (https://developer.nvidia.com/cuda-gpus#compute)
  • External Nvidia GPU might be an option (https://www.amazon.com/external-gpu/s?k=external+gpu)

For Dual Boot

• https://ubuntu.com/tutorials/create-a-usb-stick-on-windows
• https://ubuntu.com/tutorials/create-a-usb-stick-on-macos
• External Nvidia GPU for Mac https://support.apple.com/en-us/HT208544
• Ubuntu image to download https://releases.ubuntu.com/20.04/

Windows: WSL

• https://learn.microsoft.com/en-us/windows/wsl/install
• Enable virtualization for CPU in bios
• wsl --install -d Ubuntu-20.04
• wsl --set-default Ubuntu-20.04
• For setting up your .bashrc https://unix.stackexchange.com/questions/604670/bashrc-syntax-error-near-unexpected-token
• Reboot
• Should be able to go to Look at Setup (Pycharm) and select interpreter as WSL

Mac OS Docker Compose env

• Go to https://docs.docker.com/desktop/install/mac-install/ and install docker
• Go to Setup (Pycharm) and after installing choose the docker compose interpreter and select service soccerbot_no_cuda or soccerbot depending if you have a nvidia gpu
• Could also trying to install manually, but has not been done since you could install most of the ubuntu arm64 stuff.

Verify that your system will work

• Check that nvidia drivers are installed using nvidia-smi,
• If you haven't installed it, go to Software & Updates >> Additional Drivers and install the recommended NVIDIA driver
• Additional instructions here if that doesn't work https://linuxconfig.org/how-to-install-the-nvidia-drivers-on-ubuntu-20-04-focal-fossa-linux