Nuitka Blog - Posted in 2026

Nuitka Release 4.1

2026-06-16T00:00:00+02:00

This is to inform you about the new stable release of Nuitka. It is the extremely compatible Python compiler, “download now”.

This release adds many new features and corrections with a focus on async code compatibility, missing generics features, and Python 3.14 compatibility and Python compilation scalability yet again.

Bug Fixes

Python 3.14: Fix, decorators were breaking when disabling deferred annotations. (Fixed in 4.0.1 already.)
Fix, nested loops could have wrong traces lead to mis-optimization. (Fixed in 4.0.1 already.)
Plugins: Fix, run-time check of package configuration was incorrect. (Fixed in 4.0.1 already.)
Compatibility: Fix, __builtins__ lacked necessary compatibility in compiled functions. (Fixed in 4.0.1 already.)
Distutils: Fix, incorrect UTF-8 decoding was used for TOML input file parsing. (Fixed in 4.0.1 already.)
Fix, multiple hard value assignments could cause compile time crashes. (Fixed in 4.0.1 already.)
Fix, string concatenation was not properly annotating exception exits. (Fixed in 4.0.2 already.)
Windows: Fix, --verbose-output and --show-modules-output did not work with forward slashes. (Fixed in 4.0.2 already.)
Python 3.14: Fix, there were various compatibility issues including dictionary watchers and inline values. (Fixed in 4.0.2 already.)
Python 3.14: Fix, stack pointer initialization to localsplus was incorrect to avoid garbage collection issues. (Fixed in 4.0.2 already.)
Python 3.12+: Fix, generic type variable scoping in classes was incorrect. (Fixed in 4.0.2 already.)
Python 3.12+: Fix, there were various issues with function generics. (Fixed in 4.0.2 already.)
Python 3.8+: Fix, names in named expressions were not mangled. (Fixed in 4.0.2 already.)
Plugins: Fix, module checksums were not robust against quoting style of module-name entry in YAML configurations. (Fixed in 4.0.2 already.)
Plugins: Fix, doing imports in queried expressions caused corruption. (Fixed in 4.0.2 already.)
UI: Fix, support for uv_build in the --project option was broken. (Fixed in 4.0.2 already.)
Compatibility: Fix, names assigned in assignment expressions were not mangled. (Fixed in 4.0.2 already.)
Python 3.12+: Fix, there were still various issues with function generics. (Fixed in 4.0.3 already.)
Clang: Fix, debug mode was disabled for clang generally, but only ClangCL and macOS Clang didn’t want it. (Fixed in 4.0.3 already.)
Zig: Fix, --windows-console-mode=attach|disable was not working when using Zig. (Fixed in 4.0.3 already.)
macOS: Fix, yet another way self dependencies can look like, needed to have support added. (Fixed in 4.0.3 already.)
Python 3.12+: Fix, generic types in classes had bugs with multiple type variables. (Fixed in 4.0.3 already.)
Scons: Fix, repeated builds were not producing binary identical results. (Fixed in 4.0.3 already.)
Scons: Fix, compiling with newer Python versions did not fall back to Zig when the developer prompt MSVC was unusable, and error reporting could crash. (Fixed in 4.0.4 already.)
Zig: Fix, the workaround for Windows console mode attach or disable was incorrectly applied on non-Windows platforms. (Fixed in 4.0.4 already.)
Standalone: Fix, linking with Python Build Standalone failed because libHacl_Hash_SHA2 was not filtered out unconditionally. (Fixed in 4.0.4 already.)
Python 3.6+: Fix, exceptions like CancelledError thrown into an async generator awaiting an inner awaitable could be swallowed, causing crashes. (Fixed in 4.0.4 already.)
Fix, not all ordered set modules accepted generators for update. (Fixed in 4.0.5 already.)
Plugins: Disabled warning about rebuilding the pytokens extension module. (Fixed in 4.0.5 already.)
Standalone: Filtered libHacl_Hash_SHA2 from link libs unconditionally. (Fixed in 4.0.5 already.)
Debugging: Disabled unusable unicode consistency checks for Python versions 3.4 to 3.6. (Fixed in 4.0.5 already.)
Python3.12+ Avoided cloning call nodes on class level which caused issues with generic functions in combination with decorators. (Added in 4.0.5 already.)
Python 3.12+: Added support for generic type variables in async def functions. (Added in 4.0.5 already.)
UI: Fix, flushing outputs for prompts was not working in all cases when progress bars were enabled. (Fixed in 4.0.6 already.)
UI: Fix, unused variable warnings were missing at C compile time when using zig as a C compiler. (Fixed in 4.0.6 already.)
Scons: Fix, forced stdout and stderr paths as a feature was broken. (Fixed in 4.0.6 already.)
Fix, replacing a branch did not accurately track shared active variables causing optimization crashes. (Fixed in 4.0.7 already.)
macOS: Fix, failed to remove extended attributes because files need to be made writable first. (Fixed in 4.0.7 already.)
Fix, dict pop and setdefault using with := rewrites lacked exception-exit annotations for un-hashable keys. (Fixed in 4.0.8 already.)
Python 3.13: Fix, the __parameters__ attribute of generic classes was not working. (Fixed in 4.0.8 already.)
Python 3.11+: Fix, starred arguments were not working as type variables. (Fixed in 4.0.8 already.)
Python2: Fix, FileNotFoundError compatibility fallback handling was not working properly. (Fixed in 4.0.8 already.)
Compatibility: Fix, loop ownership check in value traces was missing, causing issues with nested loops.
Windows: Improved --windows-console-mode=attach to properly handle console handles, enabling cases like os.system to work nicely.
Python2: Fix, there was a compatibility issue where providing default values to the mkdtemp function was failing.
Windows: Fix, there were spurious issues with C23 embedding in 32-bit MinGW64 by switching to coff_obj resource mode for it as well.
Plugins: Fix, the post-import-code execution could fail because the triggering sub-package was not yet available in sys.modules.
UI: Fix, listing package DLLs with --list-package-dlls was broken due to recent plugin lifecycle changes.
UI: Fix, --list-package-exe was not working properly on non-Windows platforms failing to detect executable files correctly.
UI: Handled paths starting with {PROGRAM_DIR} the same as a relative path when parsing the --onefile-tempdir-spec option.
Plugins: Followed multiprocessing forkserver changes for newer Python versions.
Python 3.12+: Fix, generic class type parameters handling was incorrect.
Python 3.12: Fix, deferred evaluation of type aliases was failing.
Python 3.12+: Aligned sum built-in float summation with CPython’s compensated sum for better accuracy.
Python 3.10+: Fix, uncompiled coroutine throw() return handling was incorrect, restoring completed coroutine results via StopIteration.value rather than exposing them as ordinary return values to the outer await chain.
Python 3.13+: Fix, uncompiled coroutine cancel()/await suspension handling was incorrect, improved to ensure integration compatibility.
macOS: Made finding create-dmg more robustly by also checking the Homebrew path for Intel and from PATH properly.
Compatibility: Fix, class frames were not exposing frame locals.
UI: Detected static-libpython problems, which affected some forms of Anaconda.
Distutils: Rejected --project mixed with --main arguments as it is not useful.
macOS: Fix, zig from PATH or from ziglang was not being used.
Distutils: Fix, the wrong module-root config value was being checked for uv build backend.
macOS: Fix, was attempting to change removed (rejected) DLLs, which of course failed and errored out.
Python 3.14: Fix, tuple reuse was not fully compatible, potentially causing crashes due to outdated hash caches.
Fix, fake modules were still being attempted to located when imported by other code, which could conflict with existing modules.
Python 3.5+: Fix, failed to send uncompiled coroutines the sent in value in yield from.
Fix, older gcc compilers lacking newer intrinsic methods had compilation issues that needed to be addressed.
Standalone: Fix, multiphase module extension modules with post-load code were not working properly.
Fix, Avoid using the non-inline copy of pkg_resources with the inline copy of Jinja2. These could mismatch and cause errors.
Fix, loops could make releasing of previous values very unclear, causing optimization errors.
Fix, incbin resource mode was not working with old gcc C++ fallback.
Python 3.4 to 3.6: Fix, bytecode demotion was not working properly for these versions, also bytecode only files not working.
Plugins: Added a check for the broken patchelf versions 0.10 and 0.11 to prevent breaking Qt plugins.
Android: Allowed patchelf version 0.18 on Android.
Windows: Fix, the header path for self uninstalled Python was not detected correctly.
Release: Fix, inclusion of the pkg_resources inline copy for Python 2 to source distributions was missing.
UI: Detected the OBS versions of SUSE Linux better.
Suse: Allowed using patchelf 0.18.0 there too.
Python 3.11: Fix, package and module dicts were not aligned close enough to avoid a CPython bug.
Fix, unbound compiled methods could crash when called without an object passed.
Standalone: Fix, multiphase module extension modules with postload. (Fixed in 4.0.8 already.)
Onefile: Fix, while waiting for the child, it may already be terminated.
macOS: Removed existing absolute rpaths for Homebrew and MacPorts.
Python 3.14: Avoided warning in CPython headers.
Python 3.14: Followed allocator changes more closely.
Compatibility: Avoided using pkg_resources for Jinja2 template location for loading.
No-GIL: Applied some bug fixes to get basic things to work.

Package Support

Standalone: Add support for newer paddle version. (Added in 4.0.1 already.)
Standalone: Add workaround for refcount checks of pandas. (Fixed in 4.0.1 already.)
Standalone: Add support for newer h5py version. (Added in 4.0.2 already.)
Standalone: Add support for newer scipy package. (Added in 4.0.2 already.)
Plugins: Revert accidental os.getenv over os.environ.get changes in anti-bloat configurations that stopped them from working. Affected packages are networkx, persistent, and tensorflow. (Fixed in 4.0.5 already.)
Standalone: Added missing DLLs for openvino. (Added in 4.0.7 already.)
Enhanced the package configuration YAML schema by adding the relative_to parameter for from_filenames DLL specification, avoiding error-prone purely relative paths.
Standalone: Fix, flet_desktop app assets were missing, now preserving the packaged runtime and sidecar DLLs.
Standalone: Added support for the tyro package.
Standalone: Added data files for the perfetto package.
Standalone: Added support for anyio process forking.
Standalone: Added support for the plotly.graph package.
Anaconda: Fix, dependencies for the numpy conda package on Windows were incorrect.
Plugins: Enhanced the auto-icon hack in PySide6 to use compatible class names.
Standalone: Fix, Qt libraries were duplicated with PySide6 WebEngine framework support on macOS.
Plugins: Fix, automatic detection of mypyc runtime dependencies was including all top level modules of the containing package by accident. (Fixed in 4.0.5 already.)
Anaconda: Fix, delvewheel plugin was not working with Python 3.8+. This enhances compatibility with installed PyPI packages that use it for their DLLs. (Fixed in 4.0.6 already.)
Plugins: Fix, our protection workaround could confuse methods used with PySide6.

New Features

UI: Added the --recommended-python-version option to display recommended Python versions for supported, working, or commercial usage.
UI: Add message to inform users about Nuitka[onefile] if compression is not installed. (Added in 4.0.1 already.)
UI: Add support for uv_build in the --project option. (Added in 4.0.1 already.)
Onefile: Allow extra includes as well. (Added in 4.0.2 already.)
UI: Add nuitka-project-set feature to define project variables, checking for collisions with reserved runtime variables. (Added in 4.0.2 already.)
Scons: Added new option to select --reproducible builds or not. (Added in 4.0.6 already.)
Python 3.10+: Added support for importlib.metadata.package_distributions(). (Added in 4.0.8 already.)
Plugins: Added support for the multiprocessing forkserver context. (Added in 4.0.8 already, for 4.1 Python 3.6 and earlier, as well as 3.14 support were added too.)
Reports: Added structured resource usage (rusage) performance information to compilation reports.
Reports: Included individual module-level C compiler caching (ccache/clcache) statistics in compilation reports.
Added support for detecting and correctly resolving the Python prefix for the PyEnv on Homebrew Python flavor.
macOS: Added support for rusage information for Scons.
UI: Added the __compiled__.extension_filename attribute to give the real filename of the containing extension module.
Windows: Added support for --clang or ARM. (Added in 4.0.8 already.)
Windows: Added support for resources names as not just integers, important when we copy them from template files.
MacPorts: Added basic support for this Python flavor. More work will be needed to get it to work fully though.

Optimization

Avoid including importlib._bootstrap and importlib._bootstrap_external. (Added in 4.0.1 already.)
Linux: Cached the syscall used for time keeping during compilation to avoid loading libc for each trace. (Added in 4.0.8 already.)
UI: Output a warning for modules that remain unfinished after the third optimization pass.
Added an extra micro pass trigger when new variables are introduced or variable usage changes severely, ensuring optimizations are fully propagated, avoiding unnecessary extra full passes.
Provided scripts to compile Python statically with PGO tailored for Nuitka on Linux, Windows, and macOS.
Added support for running the Data Composer tool from a compiled Nuitka binary without spawning an uncompiled Python process.
Enhanced the usage of vectorcall for PyCFunction objects by directly checking for its presence instead of relying purely on flags, allowing more frequent use of this faster execution path.
Cached frequently used declarations for top-level variables to speed up C code generation.
Sped up trace collection merging by avoiding unnecessary set creation and using a set instead of a list for escaped traces.
Optimized plugin hook execution by tracking overloaded methods and added an option to show plugin usage statistics.
Improved performance of module location by avoiding unnecessary module name reconstruction and redundant filesystem checks for pre-loaded packages.
Improved the caching of distribution name lookups to effectively avoid repeated IO operations across all package types.
Plugins: Cached callback plugin dispatch for onFunctionBodyParsing and onClassBodyParsing to skip argument computation when no plugin overrides them.
Python 3.13: Handled sub-packages of pathlib as hard modules.
Handled hard attributes through merge traces as well.
Made constant blobs more compact by avoiding repeated identifiers and unnecessary fields.
Enhanced Python compilation scripts further. (Fixed in 4.0.8 already.)
Recognized late incomplete variables better. (Fixed in 4.0.8 already.)
Made constant blobs more compact. (Fixed in 4.0.8 already.)
Optimized calls with only constant keywords and variable posargs too.

Anti-Bloat

Fix, memory bloat occurred when C compiling sqlalchemy. (Fixed in 4.0.2 already.)
Avoid using pydoc in PySimpleGUI. (Added in 4.0.2 already.)
Avoided using doctest from zodbpickle. (Added in 4.0.5 already.)
Avoided inclusion of cython when using pyav. (Added in 4.0.7 already.)
Avoided including typing_extensions when using numpy. (Added in 4.0.7 already.)

Organizational

UI: Relocated the warning about the available source code of extension modules to be evaluated at a more appropriate time.
Debian: Remove recommendation for libfuse2 package as it is no longer useful.
Debian: Used platformdirs instead of appdirs.
Debugging: Removed Python 3.11+ restriction for clang-format as it is available everywhere, even Python 2.7, and we still want nicely formatted code when we read things. (Added in 4.0.6 already.)
Removed no longer useful inline copy of wax_off. We have our own stubs generator project.
Release: Added missing package to the CI container for building Nuitka Debian packages.
Developer: Updated AI instructions for creating Minimal Reproducible Examples (MRE) to skip unneeded C compilation.
Debugging: Added an internal function for checking if a string is a valid Python identifier.
AI: Added a task in Visual Studio Code to export the currently selected Python interpreter path to a file, making it available as “python” and “pip” matching the selected interpreter. This makes it easier to use a specific version with no instructions needed.
AI: Updated the rules to instruct AI to only generate useful comments that add context not present in the code.
Containers: Added template rendering support for Jinja2 (.j2) container files in our internal Podman tools.
Projects: Clarified the current status and rationale of Python 2.6 support in the developer manual.
Debugging: Added experimental flag --experimental=ignore-extra-micro-pass to allow ignoring extra micro pass detection.
Visual Code: Added integration scripts for bash and zsh autocompletion of Nuitka CLI options. These are now also integrated into Visual Studio Code terminal profiles and the Debian package.
RPM: Included the Python compile script for Linux.
RPM: Removed the requirement for distutils in the spec.

Tests

Install only necessary build tools for test cases.
Avoided spurious failures in reference counting tests due to Python internal caching differences. (Fixed in 4.0.3 already.)
Fix, the parsing of the compilation report for reflected tests was incorrect.
Python 3.14: Ignored a syntax error message change.
Python 3.14: Added test execution support options to the main test runner to use this version as well.
Fix, the runner binary path was mishandled for the third pass of reflected compilations.
Removed the usage of obsolete plugins in reflected compilation tests.
Debugging: Prevented boolean testing of namedtuples to avoid unexpected bugs.
Added the Test suffix to syntax test files and disabled “python” mode and spell checking for them to resolve issues reported in IDEs.
Fix, newline handling in diff outputs from the output comparison tool was incorrect.
Covered post-import-code functionality with a new subpackage test case.
Prevented the program test suite from running an unnecessary variant to save execution time.
macOS: Ignored differences from GUI framework error traces in headless runs in output comparisons.
Reflected test for Nuitka, where it compiles itself and compares its operation has been restored to functional state.
Used the new method to clear internal caches if available for reference counts.
Disabled running nested loops test with Python 2.6.
Containers: Detected Python 2 defaulting containers in Podman tooling.

Cleanups

UI: Fix, there was a double space in the Windows Runtime DLLs inclusion message. (Fixed in 4.0.1 already.)
Onefile: Separated files and defines for extra includes for onefile boot and Python build.
Scons: Provided nicer errors in case of “unset” variables being used, so we can tell it.
Refactored the process execution results to correctly utilize our namedtuples variant, that makes it easier to understand what code does with the results.
Quality: Enabled automatic conversion of em-dashes and en-dashes in code comments to the autoformat tool. AI won’t stop producing them and they can cause SyntaxError for older Python versions, nor is unnecessarily using UTF-8 welcome.
Ensured that cloned outline nodes are assigned their correct names immediately upon creation, that avoids inconsistencies during their creation.
Quality: Updated to the latest versions of black and adopted a faster isort execution by caching results.
Quality: Modified the PyLint wrapper to exit gracefully instead of raising an error when no matching files require checking.
Quality: Avoided checking YAML package configuration files twice, since autoformat already handles them.
Quality: Ensured that YAML package configuration checks output the original filename instead of the temporary one when a failure occurs.
Quality: Prevented pushing of tags from triggering git pre-push quality checks.
Quality: Silenced the output of optipng and jpegoptim during image optimization auto-formatting.
Visual Code: Added the generated Python alias path file to the ignore list.
Quality: Enabled auto-formatting for the Nuitka devcontainer configuration file.
Watch: Avoided absolute paths in compilation to make reports more comparable across machines.
Quality: Changed mdformat checks to run only once and silently.
Scons: Disabled format security errors in debug mode and moved Python-related warning disables into common build setup code.
Quality: Updated to the latest deepdiff version.
Scons: Avoided MSVC telemetry since it can produce outputs that break CI.
Debugging: Enhanced non-deployment handler for importing excluded modules.
Split import module finding functionality into more pieces for enhanced readability.
Debugging: Added more assertions for constants loading and checking.
macOS: Dropped the universal target arch.
Debugging: Added more traces for deep hash verification.

Summary

This release builds on the scalability improvements established in 4.0, with enhanced Python 3.14 support, expanded package compatibility, and significant optimization work.

The --project option seems usable now.

Python 3.14 support remains experimental, but only barely made the cut, and probably will get there in hotfixes. Some of the corrections came in so late before the release, that it was just not possible to feel good about declaring it fully supported just yet.

Nuitka Release 4.0

2026-04-22T19:03:00+02:00

This is to inform you about the new stable release of Nuitka. It is the extremely compatible Python compiler, “download now”.

This release is a major release with many new features and the long wanted improvements for scalability of the Python compilation.

Bug Fixes

Accelerated: The enhanced detection for uninstalled Anaconda and WinPython was not fully working. (Fixed in 2.8.1 already.)
Onefile: Fixed an issue in DLL mode where signal handlers were not being registered, which could prevent proper program termination on signals like CTRL-C. (Fixed in 2.8.1 already.)
Windows: Fixed incorrect handling of forward slashes in cache directory paths, which caused issues with Nuitka-Action. (Fixed in 2.8.1 already.)
UI: The --output-dir option was not being honored in accelerated mode when --output-filename was also provided. (Fixed in 2.8.2 already.)
UI: The --output-filename option help said it wouldn’t work for standalone mode when in fact it did for a while already. (Fixed in 2.8.2 already.)
Onefile: On Windows, fixed a crash when using --output-dir where it was checking for the wrong folder to exist. (Fixed in 2.8.2 already.)
macOS: Fixed a crash that could occur when many package-specific directories were used, which could lead to the otool command line being too long. (Fixed in 2.8.2 already.)
Standalone: For the “Python Build Standalone” flavor, ensured that debug builds correctly recognize all their specific built-in modules, preventing potential errors. (Fixed in 2.8.4 already.)
macOS: Fixed an issue where $ORIGIN r-paths were set but ended up unused, which in some cases caused errors by exhausting the header space and preventing the build entirely. (Fixed in 2.8.5 already.)
macOS: Fixed an issue to ensure the system xattr binary is used.

Otherwise, using arch -x86_64 python for compilation could fail when some packages are installed that provide xattr as well, because that might be an arm64 binary only and would not work. (Fixed in 2.8.5 already.)
UI: Fixed a misleading typo in the rejection message for unsupported Python 3.13.4. (Fixed in 2.8.5 already.)
Accelerated: The runner scripts .cmd or .sh now are also placed respecting the --output-filename and --output-dir options. (Fixed in 2.8.5 already.)
Plugins: Ensured that plugins detected by namespace usage are also activated in module mode. (Fixed in 2.8.5 already.)
Standalone: Fixed an issue where non-existent packages listed in top_level.txt files could cause errors during metadata collection. (Fixed in 2.8.6 already.)
Standalone: Corrected the classification of the site module, which was previously treated as a standard library module in some cases. (Fixed in 2.8.6 already.)
Windows: Ensured that temporary link libraries and export files created during compilation are properly deleted, preventing them from being included in the standalone distribution. (Fixed in 2.8.6 already.)
Python3.14: Adapted to core changes by no longer inlining hacl code for this version. (Fixed in 2.8.6 already.)
Python 3.14: Follow allocator changes and immortal flags changes.
Python 3.14: Follow GC changes for compiled frames as well.
Python 3.14: Catch attempts to clear a compiled suspended frame object.
Fixed a potential mis-optimization for uses of locals() when transforming the variable name reference call. (Fixed in 2.8.6 already.)
Module: Fixed pkgutil.iter_modules not working when loading a module into a namespace. (Fixed in 2.8.7 already.)
Reports: Fixed a crash when creating the compilation report before the source directory is created. (Fixed in 2.8.7 already.)
Standalone: Fixed ignoring of non-existent packages from top_level.txt for metadata. (Fixed in 2.8.7 already.)
UI: The --no-progress-bar option was not disabling the Scons progress bars. (Fixed in 2.8.7 already.)
UI: Fixed an exception in the tqdm progress bar during process shutdown. (Fixed in 2.8.7 already.)
Windows: Fixed incorrect sys.executable value in onefile DLL mode. (Fixed in 2.8.9 already.)
Python3.14: Added missing implicit dependency for _ctypes on Windows. (Fixed in 2.8.9 already.)
Python3.13+: Fixed missing export of PyInterpreter_* API.
Python3.14: Adapted to change in evaluation order of __exit__ and __enter__.
Multiprocessing: Fixed issue where sys.argv was not yet corrected when argparse was used early in spawned processes.
Scons: Fixed an issue where Zig was not used as a fallback when MinGW64 was present but unusable.
Windows: Made onefile binary work on systems without runtime DLLs installed as well.
Scons: Made tracing robust against threaded outputs.
Python3.12+: Enhanced workaround for loading of extension modules with sub-packages to cover more cases.
Scons: Fixed missing Zig version output.
Scons: Fixed Zig detection to enforce PATH or CC usage on macOS instead of download, since it’s not available.
UI: Fixed normalization of user paths, improving macOS support for reporting.
Linux: Fixed the workaround for the memset zero length warning, which was wrongly applied to Clang. Only GCC requires it, and Clang complained about it.
Linux: More robust fallback to g++ when gcc is too old for C11 support.
Compatibility: Fixed a bug where del of a subscript could cause wrong runtime behavior due to missing control flow escape annotations for the subscript value itself and the index.
macOS: Fixed an issue where Info.plist user-facing entitlements keys mapping to multiple internal entitlements were not handled correctly.
UI: Ensured tracing uses at least 80 characters for very narrow terminals to maintain readability.
Compatibility: Fixed an issue where nested loops could have incorrect traces, potentially leading to mis-optimizations.
Linux: Fixed an issue where _XOPEN_SOURCE was mistakenly appended for Clang, causing warnings.
Scons: Improved passed variables handling by detecting None or invalid types earlier.
Fixed a bug where propagating class dictionaries needed extra micro passes to ensure proper optimization of their traces for the new variables.
Scons: Fixed an issue with process spawning when using rusage capture.
Scons: Followed the file closing behavior of the standard communicate closer to avoid potential hangs.

Package Support

Anti-Bloat: Avoided a warning during program shutdown when using a compiled xgboost package. (Fixed in 2.8.1 already.)
Standalone: Added support for the oracledb package. (Fixed in 2.8.2 already.)
macOS: Added support for newer PySide6 versions. (Fixed in 2.8.4 already.)
Standalone: Added support for including more metadata for the transformers package. (Fixed in 2.8.5 already.)
Standalone: Metadata from Nuitka Package Configuration is now only included if the corresponding package is part of the compilation. (Fixed in 2.8.5 already.)
Standalone: Added support for the win32ctypes package. (Fixed in 2.8.6 already.)
Standalone: Added support for newer versions of the dask package. (Fixed in 2.8.6 already.)
Standalone: Added support for the dataparser package. (Added in 2.8.7 already.)
Standalone: Added support for puremagic, pygments.lexers and tomli in standalone mode.
Standalone: Added automatic detection of mypyc runtime dependencies, no need to manually configure that anymore. Also our configuration was often only correct for a single OS, and single upstream versions which is now fixed for packages having it before.
Standalone: Added support for the newer av (PyAV) package version.
Standalone: Added support for the sentry_sdk, jedi, parso, and line_profiler packages.
Standalone: Added support for newer pandas versions.

New Features

UI: Added support for --project parameter to build using configuration from pyproject.toml (e.g. Poetry, Setuptools).

With this, you can simply run python -m nuitka --project --mode=onefile and it will use the pyproject.toml or setup.py/setup.cfg files to get the configuration and build the Nuitka binary.

Previously Nuitka could only be used for building wheels with build package, and for building wheels that is still the best way.

The --project option is currently compatible with build and poetry and detects the used build system automatically.
Zig: Added experimental support for using Zig project’s zig cc as a C compiler backend for Nuitka. This can be enabled by setting the CC environment variable to point to the zig or zig.exe executable.
Reports: Started capturing rusage for OSes that support it.
- Only POSIX-compliant OSes will do it (Linux, macOS, and all BSD variants), but Android does not.
- Not yet part of the actual report, as we need to figure out how to use and present the information.
Scons: Added experimental support for enabling Thin LTO with the Clang compiler.
Standalone: Honor --nofollow-import-to for stdlib modules as well.

This allows users to manually reduce standard library usage, but it can also cause crashes from extension modules not prepared for the absence of standard library modules.
Onefile: Allowed disabling the onefile timeout and hard killing on CTRL-C entirely by providing --onefile-child-grace-time=infinity.
Scons: Added newer inline copy of Scons which supports Visual Studio 2026. (Added in 2.8.7 already.)
Scons: Allowed using Python versions only partially supported for Nuitka with Scons. (Added in 2.8.7 already.)
UI: Added option --devel-profile-compilation for compile time profiling. Also renamed the old runtime profiling option --profile to --debug-profile-runtime, that is however still broken.
Reports: Including CPU instr and cycle counters in timing on native Linux.
- With appropriate configuration on Linux this allows to get at very precise timing configuration so we can judge even small compile time improvements correctly. We then don’t need many runs to average out noise from other effects.
- Don’t use wall clock but process time for steps that are not doing IO like module optimization for more accurate values otherwise, it is however not very accurate still.
Python3.12+: Added support for function type syntax (generics).
Python3.14: Added groundwork for deferred evaluation of function annotations.
Python3.14: Added support for uncompiled generator integration which is crucial for asyncio correctness and general usability with modern frameworks.
Debugging: Added --debug-self-forking to debug fork bombs.
Windows: Added --include-windows-runtime-dlls option to control inclusion of Windows C runtime DLLs. Defaults to auto.
Python 3.14: Added experimental support for deferred annotations.
Plugins: Added option --qt-debug-plugins for debugging Qt plugin loading.
DLLs: Added support for DLL tags to potentially control inclusion with more granularity.
macOS: Added support for many more protected resource entitlements (Siri, Bluetooth, HomeKit, etc.) to the bundle details.

Python: Added support for @nuitka_ignore decorator to exclude functions from compilation.

@nuitka_ignore
def my_cpython_func():
    # This function is not compiled, but stays bytecode
    ...

UI: Added support for merging user and standard YAML Nuitka package configurations, currently only including proper merging of implicit imports.

Optimization

Avoid making duplicate hard imports by dropping assignments if the variable was already assigned to the same value.
Found previous assignment traces faster.
- The assignment and del nodes were using functions to find what they already knew from the last micro pass. The self.variable_trace already kept track of the previous value trace situation.
- For matching unescaped traces we will do similar, but it’s not really used right now, so make it only a TODO as that will eventually be very similar.
- Also speeds up the first micro pass even more, because it doesn’t have to search and do other things. If no previous trace exists, none is attempted to be used.
- Also the common check if no by-name uses or merges of a value occurred was always used inverted and now should be slightly faster to use and allow to short-circuit.
- While this accelerated the first micro pass by a lot for per-assignment work, it mainly means to cleanup the design such that traces are easier to re-recognize. And this is a first step with immediate impacts.
Much faster Python passes.
- The “Escape” and “Unknown” traces now have their own number spaces. This allows doing some quick checks for a trace without using the actual object, but just its number.
- Narrow the scope of variables to the outline scope that uses them, so that they don’t need to be dealt with in merging later code where they don’t ever change anymore and are not used at all.
- When checking for unused variables, do not ask the trace collection to filter its traces. Instead it works off the ones attached to the variable already. This avoids a lot of searching work. It also uses a method to decide if a trace constitutes usage rather than a long elif chain.
Faster variable trace maintenance.
- We now trace variables in trace collection as a dictionary per variable with a dictionary of the versions, this is closer to our frequent usage per variable.
- That makes it a lot easier to update variables after the tracing is finished to know their users and writers.
- Requires a lot less work, but also makes work less memory local such that the performance gain is relatively small despite less work being done.
- It also avoids having to maintain a per-variable set for its using scopes.
- Decide presence of writing traces for parameter variables faster.
Avoid unnecessary micro passes.
- Detect variable references discarded sooner for better micro-pass efficiency. We were spending an extra pass on the whole module to stabilize the variable usage, which can end up being a lot of work.
- After a module optimization pass found no changes, we no longer make an extra micro pass to avoid stabilization bugs, but only check against it not happening in debug mode. Depending on the number of micro passes, this can be a relatively high performance gain. For the telethon.tl.types module this was a 13% performance gain on top.
For “PASS 1” of telethon.tl.types, which has been one of the known troublemakers with many classes and type annotations, all changes combined improve the compilation time by 1500%.
Faster code generation.
- Indentation in generated C code is no longer performed to speed up code generation. To restore readability, use the new option --devel-generate-readable-code which will use clang-format to format the C code.
Recognized module variable usages inside outlined functions that are in a loop, which improves the effectiveness of caching at run-time. (Added in 2.8.6 already.)
Standalone: Partially solved a TODO of minimizing intermediate directories in r-paths of ELF platforms, by only putting them there if the directory they point to will contain DLLs or binaries. This removes unused elements and reduces r-path size.
Windows: Made the caching of external paths effective, which significantly speeds up DLL resolution in subsequent compilations. (Fixed in 2.8.6 already.)
macOS: Removed extended attributes from data files as well, improving performance. (Fixed in 2.8.7 already.)
Scons: Stopped detecting installed MinGW to avoid overhead as it is not supported. (Fixed in 2.8.9 already.)
Scons: Added caching for MSVC information to reduce compilation time and if already available, use that to detect Windows SDK location rather that using vswhere.exe each time.
Avoid computing large % string interpolations at compile time. These could cause constants to be included in the binary as a result.
Avoid including importlib._bootstrap and importlib._bootstrap_external as they are available as frozen modules.
Fixed un-hashable dictionary keys not being properly optimized, forcing runtime handling.

Anti-Bloat

Avoid including tzdata on non-Windows platforms. (Fixed in 2.8.7 already.)
Avoid including pyparsing.testing in the pyparsing package.
Added configuration to avoid compiled via C for large generated files for the sqlfluff package.

Organizational

UI: Don’t say --include-data-files-external doesn’t work in standalone mode.

It actually has worked for a while, and we since renamed that option, but the help still said it wouldn’t work in standalone mode.
Debugging: Added assertions for code object creation.

We were getting assertions from Python when built with Zig, and these are supposed to provide those as well.
Debugging: In case of tool commands failing, output the too long command line if that was the error given.
Anti-Bloat: Don’t allow custom nofollow modes, point the user to the correct option instead. This was never needed, but two ways of providing this user decision make no sense.
UI: The help text for --include-data-files-external was updated to reflect that it works in standalone mode. (Fixed in 2.8.5 already.)
Release: Use lowercase names for source archives in PyPI uploads. (Fixed in 2.8.7 already.)
Quality: Fixed an issue where “assume yes” was not being passed for downloads in the commit hook.
UI: Improved wording for missing C compiler message.
Debugging: More clear verbose trace for dropped expressions.
Debugging: Output what module had extra changes during debug extra micro pass.
Quality: Manage more development tools (clang-format, etc.) via private pip space for better consistency and isolation.
AI: Enhanced pull request template with directions for AI-driven PRs.
AI: Added agent command create-mre to assist in creating a minimal reproduction example (MRE).
User Manual: Added documentation about redistribution requirements for Python 3.12-3.14.
Quality: Added --un-pushed argument to auto-format tool for checking only un-pushed changes.
Scons: Improved error message to point to Zig support if no C compiler is found.
MonolithPy: Follow rename of our Python fork to MonolithPy to avoid confusion with the Nuitka compiler project itself.
Scons: Prefer English output and warn user for missing English language pack with MSVC in case or outputs being made.
UI: When running non-interactively, print the default response that is assumed for user queries to stdout as well, so it becomes visible in the logs.
UI: Warn when using protected resources options without standalone/bundle mode enabled on macOS.
Reports: Sort DLLs and entry points in compilation reports by destination path for deterministic output.
Quality: Skip files with spell-checker: disable in codespell checks.
Release: Avoid compiling bytecode for inline copies that are not compatible with the running Python version during install.
Visual Studio: Ignored names in backticks and code blocks in ReST for spelling checks.
Actions: Ensured compilation reports are always recorded, even in case of errors, as they are most useful then.
AI: Added a workflow create-mre to assist in creating a Minimal Reproducible Example from a larger file triggering a Nuitka bug. This has guidance on avoiding standalone mode and instructions for reducing code to just produce a MRE that is really small.
AI: Added a workflow fix-module-not-found-error for solving simple ModuleNotFoundError at runtime errors.
AI: Added further strategies for Minimal Reproducible Example (MRE) reduction to the agent workflow.
UI: Reject input paths from standard library locations to prevent compiling files from there as main files.

Tests

Added support for --all with --max-failures option to the test runner to stop after a specified number of failures, or just run all tests and output the failed tests in the end.

Also the tests specified can be a glob pattern, to match multiple tests, not just a test name.

Added examples to the help output of the runner to guide the usage of the developers.
Ignore multiline source code outputs of Python3.14 in tracebacks for output comparison, Nuitka won’t do those.
Added test cases for poetry and distutils. Also verify that standalone mode works with --project for the supported build systems.
Made the distutils tests cases much more consistent.
Watch: Improved binary name detection from compilation reports for better mode support beyond standalone mode.
Allow downloading tools (like clang-format) for all test cases.
Added options to enforce Zig or Clang usage for C compiling.
Suppress pip output when not running interactively to avoid test output differences.
Added nuitka.format and nuitka.package_config to self-compilation tests.
Added colorization to test comparison diffs if a tty is available.
Avoided using --nofollow-imports in tests as some Python flavors do not work with it when using --mode=standalone.

Cleanups

Moved options to new nuitka.options package.
Python3.14: Fixed a type mismatch warning seen with MSVC. (Fixed in 2.8.9 already.)
Massive amounts of spelling cleanups. Correct spelling is more and more places allows identification of bugs more immediately, therefore these are very worthwhile.
Code cleanup and style improvements in Errors and OutputDirectories modules.
Replaced usages of os.environ.get with os.getenv for consistency and denser code.
Moved MSVC re-dist detection to DllDependenciesWin32.
Release: Don’t install zstandard by default anymore.
UI: Tone down complaint about checksum mismatches.
Static source files are now provided by Nuitka directly.
Renamed C function modulecode_ to module_code_ for consistency.

Summary

This release is finally a break-through for scalability. We will continue the push for scalability in the next release as well, but with more of a focus on the C compilation step, to generate C code that is easier for the backend compiler.

Also, this release finally addresses many usability problems. The non-deployment hooks for imports not found, that were actively excluded, are one such thing. The start of --project enables far easier adoption of Nuitka for existing projects.

Other huge improvements are related to generics, they are now much better support, closing gaps in the Python3.12 support.

The onefile DLL mode as used on Windows is finally perfect and should have no issues anymore, while enabling big future improvements.

Unfortunately 3.14 support is not yet ready and will have to be delayed until the next release.