| 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