uv installation instructions


During BoBiAC, we will work with a package and project manager called uv.

To avoid delays—especially if you're using an institutional laptop with restricted permissions—we would like you to try to install uv in advance.

Please follow the instruction below depending on your operative system (Mac or Windows).

If you try all installation options below and consistently encounter issues related to institutional restrictions, such as blocked downloads or the need for administrator privileges, please reach out to your IT department to resolve the issue.
Once you have attempted the installation process, please let us know if it was successful or not by filling out this form.
Full uv installation instructions can be found here.

đź’» Mac Users


During the installation process, you might be asked to install Python 3 if it’s not already installed on your system. If prompted, please select “Yes” to proceed with the installation.

Open Terminal (found in Applications → Utilities → Terminal) and copy & paste one of the following commands and press enter:

1. Using curl:

curl -LsSf https://astral.sh/uv/install.sh | sh

2. If curl isn't available, use wget:

wget -qO- https://astral.sh/uv/install.sh | sh

To test whether the installation succeeded, please refer to Testing the uv Installation section below.


🪟 Windows Users


During the installation process, you might be asked to install Python 3 if it’s not already installed on your system. If prompted, please select “Yes” to proceed with the installation.

Open PowerShell (you can find it by searching for "PowerShell" in the Start menu), copy & paste one of the following commands and press enter:

1. First try the standalone installer:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

2. If you encounter execution policy issues and cannot or do not want to change your policy settings (see this guide), try using winget:

winget install --id=astral-sh.uv  -e

3. If neither of the above methods works, download uv directly from GitHub. In the "Download uv" section, choose the version that matches your system (e.g., x86 or x64 Windows).

To verify that the installation was successful, follow the instructions in the section below.


âś… Testing the uv Installation


To test the installation, in your Terminal (Mac Users) or PowerShell (Windows Users), simply type the following command and press enter:

uv

You should see the uv help message if the installation was successful.

uv help message

If the command is not recognized, try restarting your Terminal or PowerShell (close and reopen it) and run the command again.

Don't forget to let us know if you were successful or not at installation by filling out this form — simply answer yes or no so we can track how many of you were able to complete it successfully. Having uv set up ahead of time will ensure a smooth start to the course and allow us to focus fully on the content from day one.