mirrors/uv
1
0
Fork 0
mirror of https://github.com/astral-sh/uv.git synced 2025-08-02 18:12:17 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 2

Stabilize addition of Python executables to the bin (#14626)

Browse source 
Closes https://github.com/astral-sh/uv/issues/14296

As mentioned in #14681, this does not stabilize the `--default`
behavior.
This commit is contained in:
Zanie Blue 2025-07-17 11:09:13 -05:00
parent ff30f14d50
commit 0077f2357f
8 changed files with 593 additions and 113 deletions
Download patch file Download diff file Expand all files Collapse all files

23
docs/guides/install-python.md
View file

@ -24,17 +24,24 @@ $ uv python install
Python does not publish official distributable binaries. As such, uv uses distributions from the Astral [`python-build-standalone`](https://github.com/astral-sh/python-build-standalone) project. See the [Python distributions](../concepts/python-versions.md#managed-python-distributions) documentation for more details.
Once Python is installed, it will be used by `uv` commands automatically.
Once Python is installed, it will be used by `uv` commands automatically. uv also adds the installed
version to your `PATH`:
!!! important
```console
$ python3.13
```
When Python is installed by uv, it will not be available globally (i.e. via the `python` command).
Support for this feature is in _preview_. See [Installing Python executables](../concepts/python-versions.md#installing-python-executables)
for details.
uv only installs a _versioned_ executable by default. To install `python` and `python3` executables,
include the experimental `--default` option:
You can still use
[`uv run`](../guides/scripts.md#using-different-python-versions) or
[create and activate a virtual environment](../pip/environments.md) to use `python` directly.
```console
$ uv python install --default
```
!!! tip
See the documentation on [installing Python executables](../concepts/python-versions.md#installing-python-executables)
for more details.
## Installing a specific version