.. _windows-path-mod:
.. _launcher:
-Python Install Manager
+Python install manager
======================
Installation
information.
-Basic Use
+Basic use
---------
The recommended command for launching Python is ``python``, which will either
``pymanager exec`` forms of the command were used.
-Command Help
+Command help
------------
The ``py help`` command will display the full list of supported commands, along
information about these files.
-Listing Runtimes
+Listing runtimes
----------------
.. code::
additional options, and will produce legacy formatted output.
-Installing Runtimes
+Installing runtimes
-------------------
.. code::
.. _pymanager-offline:
-Offline Installs
+Offline installs
----------------
To perform offline installs of Python, you will need to first create an offline
access to the internet.
-Uninstalling Runtimes
+Uninstalling runtimes
---------------------
.. code::
.. _pymanager-advancedinstall:
-Advanced Installation
+Advanced installation
---------------------
For situations where an MSIX cannot be installed, such as some older
.. _pymanager-admin-config:
-Administrative Configuration
+Administrative configuration
----------------------------
There are a number of options that may be useful for administrators to override
.. _install-freethreaded-windows:
-Installing Free-threaded Binaries
+Installing free-threaded binaries
---------------------------------
-.. versionadded:: 3.13 (Experimental)
+.. versionadded:: 3.13
-.. note::
-
- Everything described in this section is considered experimental,
- and should be expected to change in future releases.
-
-Pre-built distributions of the experimental free-threaded build are available
+Pre-built distributions of the free-threaded build are available
by installing tags with the ``t`` suffix.
.. code::
The two recommended use cases for this distribution are described below.
-Python Application
+Python application
------------------
An application written in Python does not necessarily require users to be aware
Free-threaded packages
----------------------
-.. versionadded:: 3.13 (Experimental)
-
-.. note::
-
- Everything described in this section is considered experimental,
- and should be expected to change in future releases.
+.. versionadded:: 3.13
Packages containing free-threaded binaries are named
`python-freethreaded <https://www.nuget.org/packages/python-freethreaded>`_
.. _max-path:
-Removing the MAX_PATH Limitation
+Removing the MAX_PATH limitation
================================
Windows historically has limited path lengths to 260 characters. This meant that
* Shortcuts are available for all users
-Removing the MAX_PATH Limitation
+Removing the MAX_PATH limitation
--------------------------------
Windows historically has limited path lengths to 260 characters. This meant that
.. _install-quiet-option:
-Installing Without UI
+Installing without UI
---------------------
All of the options available in the installer UI can also be specified from the
.. _install-layout-option:
-Installing Without Downloading
+Installing without downloading
------------------------------
As some features of Python are not included in the initial installer download,
:ref:`launcher`, which has its own entry in Programs and Features.
-Installing Free-threaded Binaries
+Installing free-threaded binaries
---------------------------------
-.. versionadded:: 3.13 (Experimental)
-
-.. note::
-
- Everything described in this section is considered experimental,
- and should be expected to change in future releases.
+.. versionadded:: 3.13
To install pre-built binaries with free-threading enabled (see :pep:`703`), you
should select "Customize installation". The second page of options includes the
Free-threaded binaries are also available :ref:`on nuget.org <windows-nuget>`.
-Python Launcher for Windows (Deprecated)
+Python launcher for Windows (deprecated)
========================================
.. deprecated:: 3.14
The key benefit of this is that a single launcher can support multiple Python
versions at the same time depending on the contents of the first line.
-Shebang Lines
+Shebang lines
-------------
If the first line of a script file starts with ``#!``, it is known as a
particular version was chosen and the exact command-line used to execute the
target Python. It is primarily intended for testing and debugging.
-Dry Run
+Dry run
-------
If an environment variable :envvar:`!PYLAUNCHER_DRYRUN` is set (to any value),