| python-version | Version range or exact version of Python or PyPy to use, using SemVer's version range syntax. Reads from .python-version if unset. | — | — |
| python-version-file | File containing the Python version to use. Example: .python-version | — | — |
| cache | Used to specify a package manager for caching in the default directory. Supported values: pip, pipenv, poetry. | no | — |
| architecture | The target architecture (x86, x64) of the Python or PyPy interpreter. | — | — |
| check-latest | Set this option if you want the action to check for the latest available version that satisfies the version spec. | — | false |
| token | The token used to authenticate when fetching Python distributions from https://github.com/actions/python-versions. When running this action on github.com, the default value is sufficient. When running on GHES, you can pass a personal access token for github.com if you are experiencing rate limiting. | — | ${{ github.server_url == 'https://github.com' && github.token || '' }} |
| cache-dependency-path | Used to specify the path to dependency files. Supports wildcards or a list of file names for caching multiple dependencies. | — | — |
| update-environment | Set this option if you want the action to update environment variables. | — | true |
| cache-build | Whether to cache the built Python distribution to speed up successive runs (true or false, defaults to false). | no | false |
| allow-build | Set the behavior of the action when actions/setup-python fails and has to be built from source. Supported values: allow, info, warn, error, force. Default: warn | no | warn |
| allow-prereleases | When 'true', a version range passed to 'python-version' input will match prerelease versions if no GA versions are found. Only 'x.y' version range is supported for CPython. | — | false |
| freethreaded | When 'true', use the freethreaded version of Python. | — | false |
| pip-version | Used to specify the version of pip to install with the Python. Supported format: major[.minor][.patch]. | — | — |
| pip-install | Used to specify the packages to install with pip after setting up Python. Can be a requirements file or package names. | — | — |