Skip to content

[3.14] Using Python on Windows: Free-threaded is supported from 3.14 (GH-139992) #140045

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Oct 13, 2025
+23 −38
Merged

[3.14] Using Python on Windows: Free-threaded is supported from 3.14 (GH-139992) #140045

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
61 changes: 23 additions & 38 deletions Doc/using/windows.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -60,7 +60,7 @@ packages.
.. _windows-path-mod:
.. _launcher:

Python Install Manager
Python install manager
======================

Installation
Expand Down Expand Up @@ -103,7 +103,7 @@ Windows Server 2019, please see :ref:`pymanager-advancedinstall` below for more
information.


Basic Use
Basic use
---------

The recommended command for launching Python is ``python``, which will either
Expand Down Expand Up @@ -193,7 +193,7 @@ installed if automatic installation is configured (most likely by setting
``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
Expand All @@ -218,7 +218,7 @@ override multiple settings at once. See :ref:`pymanager-config` below for more
information about these files.


Listing Runtimes
Listing runtimes
----------------

.. code::
Expand Down Expand Up @@ -259,7 +259,7 @@ For compatibility with the old launcher, the ``--list``, ``--list-paths``,
additional options, and will produce legacy formatted output.


Installing Runtimes
Installing runtimes
-------------------

.. code::
Expand Down Expand Up @@ -298,7 +298,7 @@ useful for embedding runtimes into larger applications.

.. _pymanager-offline:

Offline Installs
Offline installs
----------------

To perform offline installs of Python, you will need to first create an offline
Expand Down Expand Up @@ -330,7 +330,7 @@ In this way, Python runtimes can be installed and managed on a machine without
access to the internet.


Uninstalling Runtimes
Uninstalling runtimes
---------------------

.. code::
Expand Down Expand Up @@ -541,7 +541,7 @@ configuration option.

.. _pymanager-advancedinstall:

Advanced Installation
Advanced installation
---------------------

For situations where an MSIX cannot be installed, such as some older
Expand Down Expand Up @@ -635,7 +635,7 @@ the Store package in this way.

.. _pymanager-admin-config:

Administrative Configuration
Administrative configuration
----------------------------

There are a number of options that may be useful for administrators to override
Expand Down Expand Up @@ -726,17 +726,12 @@ directory containing the configuration file that specified them.

.. _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::
Expand Down Expand Up @@ -885,7 +880,7 @@ versions before providing updates to users.

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
Expand Down Expand Up @@ -989,12 +984,7 @@ for the 64-bit version, `www.nuget.org/packages/pythonx86
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>`_
Expand Down Expand Up @@ -1046,7 +1036,7 @@ please install Python 3.12.

.. _max-path:

Removing the MAX_PATH Limitation
Removing the MAX_PATH limitation
================================

Windows historically has limited path lengths to 260 characters. This meant that
Expand Down Expand Up @@ -1327,7 +1317,7 @@ installation". In this case:
* 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
Expand All @@ -1350,7 +1340,7 @@ After changing the above option, no further configuration is required.

.. _install-quiet-option:

Installing Without UI
Installing without UI
---------------------

All of the options available in the installer UI can also be specified from the
Expand Down Expand Up @@ -1499,7 +1489,7 @@ example file sets the same options as the previous example:

.. _install-layout-option:

Installing Without Downloading
Installing without downloading
------------------------------

As some features of Python are not included in the initial installer download,
Expand Down Expand Up @@ -1540,15 +1530,10 @@ settings and replace any that have been removed or modified.
: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
Expand Down Expand Up @@ -1580,7 +1565,7 @@ builds.
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
Expand Down Expand Up @@ -1732,7 +1717,7 @@ have the script specify the version which should be used.
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
Expand Down Expand Up @@ -1944,7 +1929,7 @@ should allow you to see what versions of Python were located, why 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),
Expand Down
Loading