Python CI with uv

GitHub Actions Steps

Setup and Install

- uses: actions/checkout@v4

- name: Install uv
  uses: astral-sh/setup-uv@v7
  with:
    enable-cache: true
    python-version: "{PYTHON_VERSION}"

- name: Create venv and install dependencies
  run: |
    uv venv
    uv pip install {DEPENDENCIES}

Running Commands

After setup, use uv run to execute commands in the venv:

- name: Run command
  run: uv run {COMMAND}

Variables

Best Practices

• •enable-cache: true caches ~/.cache/uv automatically
• •uv venv creates .venv in workspace (isolated from system)
• •Use uv run to execute commands in the venv without explicit activation
• •setup-uv@v7 handles Python installation via python-version input