Introduction

Installing

macOS and Linux

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

Windows

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

Convert a repo to use uv

# export existing environment
pip freeze > requirements.txt

# create a new uv project in the current directory
uv init .

# install the packages from requirements.txt
# only installs in environemnt won't touch pyproject.toml
uv add -r requirements.txt

Init venv on a freshly cloned repo

uv venv [venv_dir]

Activate venv

source .venv/bin/activate

Install dependencies

Install package from uv or pip into the current environment and pyproject.toml

uv add [package_name]
uv add -r requirements.txt

Install package into current environment only

uv pip install [package_name]
uv pip install -r requirements.txt