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.
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, you can update your policy settings for the current user only (see this guide) by running the following command first, and then re-running command 1. above:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

If you cannot or do not want to change your policy settings, try using winget instead:

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.

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. If you encounter any issues, please don't hesitate to reach out to us: email.bobiac@gmail.com.