diff --git a/docs/guides/tools.md b/docs/guides/tools.md index 9b128cdc0..a72ef1979 100644 --- a/docs/guides/tools.md +++ b/docs/guides/tools.md @@ -237,6 +237,33 @@ To instead upgrade all tools: $ uv tool upgrade --all ``` +## Requesting Python versions + +By default, uv will use your default Python interpreter (the first it finds) when when running, +installing, or upgrading tools. You can specify the Python interpreter to use with the `--python` +option. + +For example, to request a specific Python version when running a tool: + +```console +$ uvx --python 3.10 ruff +``` + +Or, when installing a tool: + +```console +$ uv tool install --python 3.10 ruff +``` + +Or, when upgrading a tool: + +```console +$ uv tool upgrade --python 3.10 ruff +``` + +For more details on requesting Python versions, see the +[Python version](../concepts/python-versions.md#requesting-a-version) concept page.. + ## Next steps To learn more about managing tools with uv, see the [Tools concept](../concepts/tools.md) page and