nox 2025.10.14

2025.10.14 🥧

on Python PyPI

This release updates the default for the GitHub Action to target the current range of recommended Pythons (3.10-3.14). There's now a mechanism to control if nox downloads Python (even when not using uv). Several fixes include better free-threading support, custom filenames in script mode, and support for GitHub Actions Windows ARM runners.

We'd like to thank the following folks who contributed to this release:

• @agriyakhetarpal (first contribution)
• @henryiii
• @IvanIsCoding (first contribution)
• @jbdyn (first contribution)
• @johnthagen
• @saucoide
• @shenxianpeng (first contribution)
• @Spacetown (first contribution)
• @zzzeek (first contribution)

Features:

• Add --download-python python option by @saucoide in #989
• Add session.env_dir to get the Path to the environment by @jbdyn in #974

Changes:

• GitHub Action 3.10-3.14 default by @henryiii in #1003
• Percolate the verbose global option to the silent argument for session installation commands, and document it by @agriyakhetarpal in #983
• Disallow abbreviated options by @henryiii in #973
• Log output of failed process by @jbdyn in #974
• Use a separate logging level (SESSION_INFO) for session info instead of warning by @Spacetown in #990

Bugfixes:

• Support scripts with custom names by @henryiii in #1007
• Correctly match free-threaded python versions by @zzzeek in #999
• Let uv replace the directory instead of deleting it ourselves by @henryiii in #981
• Tighten type for venv_backend by @henryiii in #967
• GitHub Actions Windows ARM support by @henryiii in #1002
• Show a warning (eventually error) if a duplicate session is encountered by @henryiii in #1013
• Fix validation error for nox.options.keywords by @henryiii in #1011

Documentation:

• Add --script to uv run inline metadata for nox-uv example by @johnthagen in #984
• Document nox-uv third party package by @johnthagen in #978
• Recommend --locked over --frozen for uv sync by @johnthagen in #972
• Tweak the grammar in a comment in tasks.py by @brettcannon in #987
• Add rustworkx as an example user by @IvanIsCoding in #975
• Update badge from black to ruff by @shenxianpeng in #971

Internal changes:

• Hide new coverage warning on 3.14 by @henryiii in #980
• Correct minimum versions and test by @henryiii in #962
• CI ensure there are no duplicate log handlers by @saucoide in #991
• Add 3.14 beta 1 support by @henryiii in #970
• Add better reprs for some internal classes by @henryiii in #966
• Drop Windows 2019 by @henryiii in #985
• Modernize and remove rc conda channel by @henryiii in #964
• Restore minimums test by @henryiii in #982
• Use dict instead of OrderedDict by @henryiii in #963
• Add conda marker to tests by @henryiii in #969
• Clear the registry in tests by @henryiii in #968