This guide explains how to install UV, set up Python 3.11, and manage dependencies for your project.

UV is a fast, modern Python package and environment manager. To install it, run the following command in your terminal:

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

After installation, restart your terminal or run the command displayed at the end of the installer (usually something like source ~/.profile or source ~/.bashrc) so the uv command becomes available.

You can verify the installation with:

uv --version

UV can manage multiple Python versions for you. To install Python 3.11, run:

uv python install 3.11

Then confirm the version is available:

uv python list

If you want to make Python 3.11 the default for this project:

uv python pin 3.11

uv pip install .

If you need to add a new dependency:

uv add <package-name>

You have two options when working in your project environment:

source .venv/bin/activate

Then you can run your scripts normally:

python script.py

Run scripts directly using UV without manually activating the environment:

uv run python script.py

You can also use it for other Python commands, like:

uv run pytest
uv run jupyter notebook