python-uv-ci

name	python-uv-ci
description	GitHub Actions workflow steps for Python projects using uv. Use this skill when generating CI workflows that need uv-based dependency installation with virtual environment.

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

Variable	Description	Default
{PYTHON_VERSION}	Python version	3.12
{DEPENDENCIES}	Space-separated packages	-
{COMMAND}	Command to run	-

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