| version | The version of uv to install e.g., `0.5.0` Defaults to the version in pyproject.toml or 'latest'. | — | "" |
| version-file | Path to a file containing the version of uv to install, e.g., uv.toml, pyproject.toml, .tool-versions, requirements.txt or uv.lock. Defaults to searching for uv.toml and if not found pyproject.toml. | — | "" |
| python-version | The version of Python to set UV_PYTHON to | no | — |
| activate-environment | Use uv venv to activate a venv ready to be used by later steps. | — | false |
| venv-path | Custom path for the virtual environment when using activate-environment. Defaults to '.venv' in the working directory. | — | "" |
| no-project | Pass --no-project when creating the venv with activate-environment. | — | false |
| working-directory | The directory to execute all commands in and look for files such as pyproject.toml | — | ${{ github.workspace }} |
| checksum | The checksum of the uv version to install | no | — |
| github-token | Used when downloading uv from GitHub releases. | no | ${{ github.token }} |
| enable-cache | Enable uploading of the uv cache | — | auto |
| cache-dependency-glob | Glob pattern to match files relative to the working directory to control the cache. | — | **/*requirements*.txt
**/*requirements*.in
**/*constraints*.txt
**/*constraints*.in
**/pyproject.toml
**/uv.lock
**/*.py.lock
|
| restore-cache | Whether to restore the cache if found. | — | true |
| save-cache | Whether to save the cache after the run. | — | true |
| cache-suffix | Suffix for the cache key | no | — |
| cache-local-path | Local path to store the cache. | — | "" |
| prune-cache | Prune cache before saving. | — | true |
| cache-python | Upload managed Python installations to the Github Actions cache. | — | false |
| ignore-nothing-to-cache | Ignore when nothing is found to cache. | — | false |
| ignore-empty-workdir | Ignore when the working directory is empty. | — | false |
| tool-dir | Custom path to set UV_TOOL_DIR to. | no | — |
| tool-bin-dir | Custom path to set UV_TOOL_BIN_DIR to. | no | — |
| manifest-file | URL to a custom manifest file in the astral-sh/versions format. | no | — |
| download-from-astral-mirror | Download uv from the Astral mirror instead of directly from GitHub Releases. | — | true |
| add-problem-matchers | Add problem matchers. | — | true |
| quiet | Suppress info-level log output. Only warnings and errors are shown. | — | false |
| resolution-strategy | Resolution strategy to use when resolving version ranges. 'highest' uses the latest compatible version, 'lowest' uses the oldest compatible version. | — | highest |