IDF install fail at "Building wheel for pydantic-core (pyproject.toml)" (IDFGH-16627)

[ammaree]

Answers checklist.

• I have read the documentation ESP-IDF Programming Guide and the issue is not addressed there.
• I have updated my IDF branch (master or release) to the latest version and checked that the issue is present there.
• I have searched the issue tracker for a similar issue and not found a similar issue.

IDF version.

v5.5.1

Operating System used.

macOS

How did you build your project?

Other (please specify in More Information)

If you are using Windows, please specify command line type.

None

What is the expected behavior?

Install to work successfully

What is the actual behavior?

`Building wheels for collected packages: pydantic-core
Building wheel for pydantic-core (pyproject.toml) ... error
error: subprocess-exited-with-error

× Building wheel for pydantic-core (pyproject.toml) did not run successfully.
│ exit code: 1
╰─> [136 lines of output]
Running maturin pep517 build-wheel -i /Users/andremaree/.espressif/python_env/idf5.5_py3.14_env/bin/python --compatibility off
Python reports SOABI: cpython-314-darwin
Computed rustc target triple: aarch64-apple-darwin
Installation directory: /Users/andremaree/Library/Caches/puccinialin
Rustup already downloaded
Installing rust to /Users/andremaree/Library/Caches/puccinialin/rustup
warn: It looks like you have an existing rustup settings file at:
warn: /Users/andremaree/.rustup/settings.toml
warn: Rustup will install the default toolchain as specified in the settings file,
warn: instead of the one inferred from the default host triple.
info: profile set to 'minimal'
info: default host triple is aarch64-apple-darwin
warn: Updating existing toolchain, profile choice will be ignored
info: syncing channel updates for 'stable-aarch64-apple-darwin'
info: default toolchain set to 'stable-aarch64-apple-darwin'
Checking if cargo is installed
cargo 1.90.0 (840b83a10 2025-07-30)
📦 Including license file LICENSE
🍹 Building a mixed python/rust project
🔗 Found pyo3 bindings
🐍 Found CPython 3.14 at /Users/andremaree/.espressif/python_env/idf5.5_py3.14_env/bin/python
📡 Using build options features, bindings from pyproject.toml
💻 Using MACOSX_DEPLOYMENT_TARGET=11.0 for aarch64-apple-darwin by default
Compiling proc-macro2 v1.0.86
Compiling unicode-ident v1.0.12
Compiling target-lexicon v0.13.2

... lots more, all OK, until ...

Compiling pyo3-macros v0.24.1
error: failed to run custom build command for pyo3-ffi v0.24.1

  Caused by:
    process didn't exit successfully: `/private/var/folders/3l/f38qk2dd6t15cjff23xfc0ww0000gn/T/pip-install-5pg_n16v/pydantic-core_83c51996167940608045f17d9c081e36/target/release/build/pyo3-ffi-3a915bcb0b4273f6/build-script-build` (exit status: 1)
    --- stdout
    cargo:rustc-check-cfg=cfg(Py_LIMITED_API)
    cargo:rustc-check-cfg=cfg(Py_GIL_DISABLED)
    cargo:rustc-check-cfg=cfg(PyPy)
    cargo:rustc-check-cfg=cfg(GraalPy)
    cargo:rustc-check-cfg=cfg(py_sys_config, values("Py_DEBUG", "Py_REF_DEBUG", "Py_TRACE_REFS", "COUNT_ALLOCS"))
    cargo:rustc-check-cfg=cfg(pyo3_disable_reference_pool)
    cargo:rustc-check-cfg=cfg(pyo3_leak_on_drop_without_reference_pool)
    cargo:rustc-check-cfg=cfg(Py_3_7)
    cargo:rustc-check-cfg=cfg(Py_3_8)
    cargo:rustc-check-cfg=cfg(Py_3_9)
    cargo:rustc-check-cfg=cfg(Py_3_10)
    cargo:rustc-check-cfg=cfg(Py_3_11)
    cargo:rustc-check-cfg=cfg(Py_3_12)
    cargo:rustc-check-cfg=cfg(Py_3_13)
    cargo:rustc-check-cfg=cfg(Py_3_14)
    cargo:rerun-if-env-changed=PYO3_CROSS
    cargo:rerun-if-env-changed=PYO3_CROSS_LIB_DIR
    cargo:rerun-if-env-changed=PYO3_CROSS_PYTHON_VERSION
    cargo:rerun-if-env-changed=PYO3_CROSS_PYTHON_IMPLEMENTATION
    cargo:rerun-if-env-changed=PYO3_PRINT_CONFIG
    cargo:rerun-if-env-changed=PYO3_USE_ABI3_FORWARD_COMPATIBILITY
  
    --- stderr
    error: the configured Python interpreter version (3.14) is newer than PyO3's maximum supported version (3.13)
    = help: please check if an updated version of PyO3 is available. Current version: 0.24.1
    = help: set PYO3_USE_ABI3_FORWARD_COMPATIBILITY=1 to suppress this check and build anyway using the stable ABI
  warning: build failed, waiting for other jobs to finish...
  💥 maturin failed
    Caused by: Failed to build a native library through cargo
    Caused by: Cargo build finished with "exit status: 101": `env -u CARGO MACOSX_DEPLOYMENT_TARGET="11.0" PYO3_BUILD_EXTENSION_MODULE="1" PYO3_ENVIRONMENT_SIGNATURE="cpython-3.14-64bit" PYO3_PYTHON="/Users/andremaree/.espressif/python_env/idf5.5_py3.14_env/bin/python" PYTHON_SYS_EXECUTABLE="/Users/andremaree/.espressif/python_env/idf5.5_py3.14_env/bin/python" "cargo" "rustc" "--features" "pyo3/extension-module" "--message-format" "json-render-diagnostics" "--manifest-path" "/private/var/folders/3l/f38qk2dd6t15cjff23xfc0ww0000gn/T/pip-install-5pg_n16v/pydantic-core_83c51996167940608045f17d9c081e36/Cargo.toml" "--release" "--lib" "--crate-type" "cdylib" "--" "-C" "link-arg=-undefined" "-C" "link-arg=dynamic_lookup" "-C" "link-args=-Wl,-install_name,@rpath/pydantic_core._pydantic_core.cpython-314-darwin.so"`
  Rust not found, installing into a temporary directory
  Error: command ['maturin', 'pep517', 'build-wheel', '-i', '/Users/andremaree/.espressif/python_env/idf5.5_py3.14_env/bin/python', '--compatibility', 'off'] returned non-zero exit status 1
  [end of output]

note: This error originates from a subprocess, and is likely not a problem with pip.
ERROR: Failed building wheel for pydantic-core
Failed to build pydantic-core
error: failed-wheel-build-for-install

× Failed to build installable wheels for some pyproject.toml based projects
╰─> pydantic-core
Traceback (most recent call last):
File "/Users/andremaree/DevSpace/z-sdk/esp-idf/tools/idf_tools.py", line 3606, in
main(sys.argv[1:])
~~~~^^^^^^^^^^^^^^
File "/Users/andremaree/DevSpace/z-sdk/esp-idf/tools/idf_tools.py", line 3596, in main
action_func(args)
~~~~~~~~~~~^^^^^^
File "/Users/andremaree/DevSpace/z-sdk/esp-idf/tools/idf_tools.py", line 2928, in action_install_python_env
subprocess.check_call(run_args, stdout=sys.stdout, stderr=sys.stderr, env=env_copy)
~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/Library/Frameworks/Python.framework/Versions/3.14/lib/python3.14/subprocess.py", line 419, in check_call
raise CalledProcessError(retcode, cmd)
subprocess.CalledProcessError: Command '['/Users/andremaree/.espressif/python_env/idf5.5_py3.14_env/bin/python', '-m', 'pip', 'install', '--no-warn-script-location', '-r', '/Users/andremaree/DevSpace/z-sdk/esp-idf/tools/requirements/requirements.core.txt', '--upgrade', '--constraint', '/Users/andremaree/.espressif/espidf.constraints.v5.5.txt', '--extra-index-url', 'https://dl.espressif.com/pypi']' returned non-zero exit status 1.`

Steps to reproduce.

1. Download new ESP-IDF (v5.5.1 or Master)
2. Run ./install.sh
3. Downloads all the tools
4. Error occur at "Building wheel for ..."

Build or installation Logs.

√ esp-idf % ./install.sh                                                                                                                                                                                         16:28:52
INFO: Using IDF_PATH '/Users/andremaree/DevSpace/z-sdk/esp-idf' for installation.
Detecting the Python interpreter
Checking "python3" ...
Python 3.14.0
"python3" has been detected
Checking Python compatibility
Installing ESP-IDF tools
Updating /Users/andremaree/.espressif/idf-env.json
Selected targets are: esp32h21, esp32s2, esp32c2, esp32c3, esp32, esp32s3, esp32h4, esp32c5, esp32p4, esp32c61, esp32c6, esp32h2
Current system platform: macos-arm64
Installing tools: xtensa-esp-elf-gdb, riscv32-esp-elf-gdb, xtensa-esp-elf, riscv32-esp-elf, esp32ulp-elf, openocd-esp32, esp-rom-elfs
Installing xtensa-esp-elf-gdb@16.2_20250324
Downloading https://github.com/espressif/binutils-gdb/releases/download/esp-gdb-v16.2_20250324/xtensa-esp-elf-gdb-16.2_20250324-aarch64-apple-darwin21.1.tar.gz
Destination: /Users/andremaree/.espressif/dist/xtensa-esp-elf-gdb-16.2_20250324-aarch64-apple-darwin21.1.tar.gz.tmp
Done
Extracting /Users/andremaree/.espressif/dist/xtensa-esp-elf-gdb-16.2_20250324-aarch64-apple-darwin21.1.tar.gz to /Users/andremaree/.espressif/tools/xtensa-esp-elf-gdb/16.2_20250324
Installing riscv32-esp-elf-gdb@16.2_20250324
Downloading https://github.com/espressif/binutils-gdb/releases/download/esp-gdb-v16.2_20250324/riscv32-esp-elf-gdb-16.2_20250324-aarch64-apple-darwin21.1.tar.gz
Destination: /Users/andremaree/.espressif/dist/riscv32-esp-elf-gdb-16.2_20250324-aarch64-apple-darwin21.1.tar.gz.tmp
Done
Extracting /Users/andremaree/.espressif/dist/riscv32-esp-elf-gdb-16.2_20250324-aarch64-apple-darwin21.1.tar.gz to /Users/andremaree/.espressif/tools/riscv32-esp-elf-gdb/16.2_20250324
Installing xtensa-esp-elf@esp-14.2.0_20241119
Downloading https://github.com/espressif/crosstool-NG/releases/download/esp-14.2.0_20241119/xtensa-esp-elf-14.2.0_20241119-aarch64-apple-darwin.tar.xz
Destination: /Users/andremaree/.espressif/dist/xtensa-esp-elf-14.2.0_20241119-aarch64-apple-darwin.tar.xz.tmp
Done
Extracting /Users/andremaree/.espressif/dist/xtensa-esp-elf-14.2.0_20241119-aarch64-apple-darwin.tar.xz to /Users/andremaree/.espressif/tools/xtensa-esp-elf/esp-14.2.0_20241119
Installing riscv32-esp-elf@esp-14.2.0_20241119
Downloading https://github.com/espressif/crosstool-NG/releases/download/esp-14.2.0_20241119/riscv32-esp-elf-14.2.0_20241119-aarch64-apple-darwin.tar.xz
Destination: /Users/andremaree/.espressif/dist/riscv32-esp-elf-14.2.0_20241119-aarch64-apple-darwin.tar.xz.tmp
Done
Extracting /Users/andremaree/.espressif/dist/riscv32-esp-elf-14.2.0_20241119-aarch64-apple-darwin.tar.xz to /Users/andremaree/.espressif/tools/riscv32-esp-elf/esp-14.2.0_20241119
Skipping esp32ulp-elf@2.38_20240113 (already installed)
Skipping openocd-esp32@v0.12.0-esp32-20250707 (already installed)
Skipping esp-rom-elfs@20241011 (already installed)
Installing Python environment and packages
Python 3.14.0
pip 25.2 from /Users/andremaree/.espressif/python_env/idf5.5_py3.14_env/lib/python3.14/site-packages/pip (python 3.14)
Downloading https://dl.espressif.com/dl/esp-idf/espidf.constraints.v5.5.txt
Destination: /Users/andremaree/.espressif/espidf.constraints.v5.5.txt.tmp
Done
Upgrading pip...
Requirement already satisfied: pip in /Users/andremaree/.espressif/python_env/idf5.5_py3.14_env/lib/python3.14/site-packages (25.2)
Upgrading setuptools...
Requirement already satisfied: setuptools in /Users/andremaree/.espressif/python_env/idf5.5_py3.14_env/lib/python3.14/site-packages (71.0.0)
Installing Python packages
 Constraint file: /Users/andremaree/.espressif/espidf.constraints.v5.5.txt
 Requirement files:
  - /Users/andremaree/DevSpace/z-sdk/esp-idf/tools/requirements/requirements.core.txt
Looking in indexes: https://pypi.org/simple, https://dl.espressif.com/pypi
Ignoring importlib_metadata: markers 'python_version < "3.8"' don't match your environment
Requirement already satisfied: setuptools in /Users/andremaree/.espressif/python_env/idf5.5_py3.14_env/lib/python3.14/site-packages (from -r /Users/andremaree/DevSpace/z-sdk/esp-idf/tools/requirements/requirements.core.txt (line 7)) (71.0.0)
Collecting packaging (from -r /Users/andremaree/DevSpace/z-sdk/esp-idf/tools/requirements/requirements.core.txt (line 8))
  Using cached packaging-25.0-py3-none-any.whl.metadata (3.3 kB)
Collecting click (from -r /Users/andremaree/DevSpace/z-sdk/esp-idf/tools/requirements/requirements.core.txt (line 11))
  Using cached https://dl.espressif.com/pypi/click/click-8.1.8-py3-none-any.whl (98 kB)
Collecting pyserial (from -r /Users/andremaree/DevSpace/z-sdk/esp-idf/tools/requirements/requirements.core.txt (line 12))
  Using cached https://dl.espressif.com/pypi/pyserial/pyserial-3.5-py2.py3-none-any.whl (90 kB)
Collecting cryptography (from -r /Users/andremaree/DevSpace/z-sdk/esp-idf/tools/requirements/requirements.core.txt (line 13))
  Using cached cryptography-44.0.3-cp39-abi3-macosx_10_9_universal2.whl.metadata (5.7 kB)
Collecting pyparsing (from -r /Users/andremaree/DevSpace/z-sdk/esp-idf/tools/requirements/requirements.core.txt (line 14))
  Using cached pyparsing-3.2.5-py3-none-any.whl.metadata (5.0 kB)
Collecting pyelftools (from -r /Users/andremaree/DevSpace/z-sdk/esp-idf/tools/requirements/requirements.core.txt (line 15))
  Using cached https://dl.espressif.com/pypi/pyelftools/pyelftools-0.32-py3-none-any.whl (188 kB)
Collecting idf-component-manager~=2.2 (from -r /Users/andremaree/DevSpace/z-sdk/esp-idf/tools/requirements/requirements.core.txt (line 16))
  Using cached idf_component_manager-2.4.1-py3-none-any.whl.metadata (9.5 kB)
Collecting esp-coredump (from -r /Users/andremaree/DevSpace/z-sdk/esp-idf/tools/requirements/requirements.core.txt (line 17))
  Using cached esp_coredump-1.14.0-py3-none-any.whl.metadata (5.2 kB)
Collecting esptool (from -r /Users/andremaree/DevSpace/z-sdk/esp-idf/tools/requirements/requirements.core.txt (line 18))
  Using cached esptool-4.10.0-py3-none-any.whl
Collecting esp-idf-kconfig (from -r /Users/andremaree/DevSpace/z-sdk/esp-idf/tools/requirements/requirements.core.txt (line 19))
  Using cached https://dl.espressif.com/pypi/esp-idf-kconfig/esp_idf_kconfig-2.5.0-py3-none-any.whl (143 kB)
Collecting esp-idf-monitor (from -r /Users/andremaree/DevSpace/z-sdk/esp-idf/tools/requirements/requirements.core.txt (line 20))
  Using cached esp_idf_monitor-1.8.0-py3-none-any.whl.metadata (11 kB)
Collecting esp-idf-nvs-partition-gen (from -r /Users/andremaree/DevSpace/z-sdk/esp-idf/tools/requirements/requirements.core.txt (line 21))
  Using cached esp_idf_nvs_partition_gen-0.1.9-py3-none-any.whl.metadata (14 kB)
Collecting esp-idf-size (from -r /Users/andremaree/DevSpace/z-sdk/esp-idf/tools/requirements/requirements.core.txt (line 22))
  Using cached esp_idf_size-1.7.1-py3-none-any.whl.metadata (3.7 kB)
Collecting esp-idf-diag (from -r /Users/andremaree/DevSpace/z-sdk/esp-idf/tools/requirements/requirements.core.txt (line 23))
  Using cached esp_idf_diag-0.2.0-py3-none-any.whl.metadata (3.6 kB)
Collecting esp-idf-panic-decoder (from -r /Users/andremaree/DevSpace/z-sdk/esp-idf/tools/requirements/requirements.core.txt (line 24))
  Using cached esp_idf_panic_decoder-1.4.1-py3-none-any.whl.metadata (16 kB)
Collecting pyclang (from -r /Users/andremaree/DevSpace/z-sdk/esp-idf/tools/requirements/requirements.core.txt (line 25))
  Using cached pyclang-0.6.3-py3-none-any.whl.metadata (2.7 kB)
Collecting construct (from -r /Users/andremaree/DevSpace/z-sdk/esp-idf/tools/requirements/requirements.core.txt (line 26))
  Using cached https://dl.espressif.com/pypi/construct/construct-2.10.70-py3-none-any.whl (63 kB)
Collecting rich (from -r /Users/andremaree/DevSpace/z-sdk/esp-idf/tools/requirements/requirements.core.txt (line 27))
  Using cached rich-14.2.0-py3-none-any.whl.metadata (18 kB)
Collecting psutil (from -r /Users/andremaree/DevSpace/z-sdk/esp-idf/tools/requirements/requirements.core.txt (line 28))
  Using cached psutil-7.1.0-cp36-abi3-macosx_11_0_arm64.whl.metadata (23 kB)
Collecting freertos_gdb (from -r /Users/andremaree/DevSpace/z-sdk/esp-idf/tools/requirements/requirements.core.txt (line 31))
  Using cached https://dl.espressif.com/pypi/freertos-gdb/freertos_gdb-1.0.4-py3-none-any.whl (14 kB)
Collecting colorama (from idf-component-manager~=2.2->-r /Users/andremaree/DevSpace/z-sdk/esp-idf/tools/requirements/requirements.core.txt (line 16))
  Using cached https://dl.espressif.com/pypi/colorama/colorama-0.4.6-py2.py3-none-any.whl (25 kB)
Collecting ruamel.yaml (from idf-component-manager~=2.2->-r /Users/andremaree/DevSpace/z-sdk/esp-idf/tools/requirements/requirements.core.txt (line 16))
  Using cached ruamel.yaml-0.18.15-py3-none-any.whl.metadata (25 kB)
Collecting requests (from idf-component-manager~=2.2->-r /Users/andremaree/DevSpace/z-sdk/esp-idf/tools/requirements/requirements.core.txt (line 16))
  Using cached requests-2.32.5-py3-none-any.whl.metadata (4.9 kB)
Collecting requests-file (from idf-component-manager~=2.2->-r /Users/andremaree/DevSpace/z-sdk/esp-idf/tools/requirements/requirements.core.txt (line 16))
  Using cached https://dl.espressif.com/pypi/requests-file/requests_file-2.1.0-py2.py3-none-any.whl (4.2 kB)
Collecting requests-toolbelt (from idf-component-manager~=2.2->-r /Users/andremaree/DevSpace/z-sdk/esp-idf/tools/requirements/requirements.core.txt (line 16))
  Using cached https://dl.espressif.com/pypi/requests-toolbelt/requests_toolbelt-1.0.0-py2.py3-none-any.whl (54 kB)
Collecting tqdm (from idf-component-manager~=2.2->-r /Users/andremaree/DevSpace/z-sdk/esp-idf/tools/requirements/requirements.core.txt (line 16))
  Using cached https://dl.espressif.com/pypi/tqdm/tqdm-4.67.1-py3-none-any.whl (78 kB)
Collecting jsonref (from idf-component-manager~=2.2->-r /Users/andremaree/DevSpace/z-sdk/esp-idf/tools/requirements/requirements.core.txt (line 16))
  Using cached https://dl.espressif.com/pypi/jsonref/jsonref-1.1.0-py3-none-any.whl (9.4 kB)
Collecting pydantic!=2.12.0 (from idf-component-manager~=2.2->-r /Users/andremaree/DevSpace/z-sdk/esp-idf/tools/requirements/requirements.core.txt (line 16))
  Using cached pydantic-2.11.10-py3-none-any.whl.metadata (68 kB)
Collecting pydantic-core (from idf-component-manager~=2.2->-r /Users/andremaree/DevSpace/z-sdk/esp-idf/tools/requirements/requirements.core.txt (line 16))
  Downloading pydantic_core-2.41.4-cp314-cp314-macosx_11_0_arm64.whl.metadata (7.3 kB)
Collecting pydantic-settings (from idf-component-manager~=2.2->-r /Users/andremaree/DevSpace/z-sdk/esp-idf/tools/requirements/requirements.core.txt (line 16))
  Using cached pydantic_settings-2.11.0-py3-none-any.whl.metadata (3.4 kB)
Collecting truststore (from idf-component-manager~=2.2->-r /Users/andremaree/DevSpace/z-sdk/esp-idf/tools/requirements/requirements.core.txt (line 16))
  Using cached truststore-0.10.4-py3-none-any.whl.metadata (4.4 kB)
Collecting cffi>=1.12 (from cryptography->-r /Users/andremaree/DevSpace/z-sdk/esp-idf/tools/requirements/requirements.core.txt (line 13))
  Using cached cffi-2.0.0-cp314-cp314-macosx_11_0_arm64.whl.metadata (2.6 kB)
Collecting pygdbmi>=0.9.0.2 (from esp-coredump->-r /Users/andremaree/DevSpace/z-sdk/esp-idf/tools/requirements/requirements.core.txt (line 17))
  Using cached https://dl.espressif.com/pypi/pygdbmi/pygdbmi-0.11.0.0-py3-none-any.whl (21 kB)
Collecting bitstring!=4.2.0,>=3.1.6 (from esptool->-r /Users/andremaree/DevSpace/z-sdk/esp-idf/tools/requirements/requirements.core.txt (line 18))
  Using cached https://dl.espressif.com/pypi/bitstring/bitstring-4.3.1-py3-none-any.whl (71 kB)
Collecting ecdsa>=0.16.0 (from esptool->-r /Users/andremaree/DevSpace/z-sdk/esp-idf/tools/requirements/requirements.core.txt (line 18))
  Using cached https://dl.espressif.com/pypi/ecdsa/ecdsa-0.19.1-py2.py3-none-any.whl (150 kB)
Collecting reedsolo<1.8,>=1.5.3 (from esptool->-r /Users/andremaree/DevSpace/z-sdk/esp-idf/tools/requirements/requirements.core.txt (line 18))
  Using cached https://dl.espressif.com/pypi/reedsolo/reedsolo-1.7.0-py3-none-any.whl (32 kB)
Collecting PyYAML>=5.1 (from esptool->-r /Users/andremaree/DevSpace/z-sdk/esp-idf/tools/requirements/requirements.core.txt (line 18))
  Using cached pyyaml-6.0.3-cp314-cp314-macosx_11_0_arm64.whl.metadata (2.4 kB)
Collecting intelhex (from esptool->-r /Users/andremaree/DevSpace/z-sdk/esp-idf/tools/requirements/requirements.core.txt (line 18))
  Using cached https://dl.espressif.com/pypi/intelhex/intelhex-2.3.0-py2.py3-none-any.whl (50 kB)
Collecting argcomplete>=3 (from esptool->-r /Users/andremaree/DevSpace/z-sdk/esp-idf/tools/requirements/requirements.core.txt (line 18))
  Using cached https://dl.espressif.com/pypi/argcomplete/argcomplete-3.6.2-py3-none-any.whl (43 kB)
Collecting markdown-it-py>=2.2.0 (from rich->-r /Users/andremaree/DevSpace/z-sdk/esp-idf/tools/requirements/requirements.core.txt (line 27))
  Using cached markdown_it_py-4.0.0-py3-none-any.whl.metadata (7.3 kB)
Collecting pygments<3.0.0,>=2.13.0 (from rich->-r /Users/andremaree/DevSpace/z-sdk/esp-idf/tools/requirements/requirements.core.txt (line 27))
  Using cached pygments-2.19.2-py3-none-any.whl.metadata (2.5 kB)
Collecting bitarray<4.0,>=3.0.0 (from bitstring!=4.2.0,>=3.1.6->esptool->-r /Users/andremaree/DevSpace/z-sdk/esp-idf/tools/requirements/requirements.core.txt (line 18))
  Using cached bitarray-3.7.2-cp314-cp314-macosx_11_0_arm64.whl.metadata (34 kB)
Collecting pycparser (from cffi>=1.12->cryptography->-r /Users/andremaree/DevSpace/z-sdk/esp-idf/tools/requirements/requirements.core.txt (line 13))
  Using cached pycparser-2.23-py3-none-any.whl.metadata (993 bytes)
Collecting six>=1.9.0 (from ecdsa>=0.16.0->esptool->-r /Users/andremaree/DevSpace/z-sdk/esp-idf/tools/requirements/requirements.core.txt (line 18))
  Using cached https://dl.espressif.com/pypi/six/six-1.17.0-py2.py3-none-any.whl (11 kB)
Collecting mdurl~=0.1 (from markdown-it-py>=2.2.0->rich->-r /Users/andremaree/DevSpace/z-sdk/esp-idf/tools/requirements/requirements.core.txt (line 27))
  Using cached https://dl.espressif.com/pypi/mdurl/mdurl-0.1.2-py3-none-any.whl (10.0 kB)
Collecting annotated-types>=0.6.0 (from pydantic!=2.12.0->idf-component-manager~=2.2->-r /Users/andremaree/DevSpace/z-sdk/esp-idf/tools/requirements/requirements.core.txt (line 16))
  Using cached https://dl.espressif.com/pypi/annotated-types/annotated_types-0.7.0-py3-none-any.whl (13 kB)
Collecting pydantic-core (from idf-component-manager~=2.2->-r /Users/andremaree/DevSpace/z-sdk/esp-idf/tools/requirements/requirements.core.txt (line 16))
  Using cached pydantic_core-2.33.2.tar.gz (435 kB)
  Installing build dependencies ... done
  Getting requirements to build wheel ... done
  Installing backend dependencies ... done
  Preparing metadata (pyproject.toml) ... done
Collecting typing-extensions>=4.12.2 (from pydantic!=2.12.0->idf-component-manager~=2.2->-r /Users/andremaree/DevSpace/z-sdk/esp-idf/tools/requirements/requirements.core.txt (line 16))
  Using cached typing_extensions-4.15.0-py3-none-any.whl.metadata (3.3 kB)
Collecting typing-inspection>=0.4.0 (from pydantic!=2.12.0->idf-component-manager~=2.2->-r /Users/andremaree/DevSpace/z-sdk/esp-idf/tools/requirements/requirements.core.txt (line 16))
  Using cached typing_inspection-0.4.2-py3-none-any.whl.metadata (2.6 kB)
Collecting python-dotenv>=0.21.0 (from pydantic-settings->idf-component-manager~=2.2->-r /Users/andremaree/DevSpace/z-sdk/esp-idf/tools/requirements/requirements.core.txt (line 16))
  Using cached python_dotenv-1.1.1-py3-none-any.whl.metadata (24 kB)
Collecting charset_normalizer<4,>=2 (from requests->idf-component-manager~=2.2->-r /Users/andremaree/DevSpace/z-sdk/esp-idf/tools/requirements/requirements.core.txt (line 16))
  Downloading charset_normalizer-3.4.4-cp314-cp314-macosx_10_13_universal2.whl.metadata (37 kB)
Collecting idna<4,>=2.5 (from requests->idf-component-manager~=2.2->-r /Users/andremaree/DevSpace/z-sdk/esp-idf/tools/requirements/requirements.core.txt (line 16))
  Using cached idna-3.11-py3-none-any.whl.metadata (8.4 kB)
Collecting urllib3<3,>=1.21.1 (from requests->idf-component-manager~=2.2->-r /Users/andremaree/DevSpace/z-sdk/esp-idf/tools/requirements/requirements.core.txt (line 16))
  Using cached https://dl.espressif.com/pypi/urllib3/urllib3-1.26.20-py2.py3-none-any.whl (144 kB)
Collecting certifi>=2017.4.17 (from requests->idf-component-manager~=2.2->-r /Users/andremaree/DevSpace/z-sdk/esp-idf/tools/requirements/requirements.core.txt (line 16))
  Using cached certifi-2025.10.5-py3-none-any.whl.metadata (2.5 kB)
Using cached idf_component_manager-2.4.1-py3-none-any.whl (172 kB)
Using cached packaging-25.0-py3-none-any.whl (66 kB)
Using cached cryptography-44.0.3-cp39-abi3-macosx_10_9_universal2.whl (6.7 MB)
Using cached pyparsing-3.2.5-py3-none-any.whl (113 kB)
Using cached esp_coredump-1.14.0-py3-none-any.whl (42 kB)
Using cached esp_idf_monitor-1.8.0-py3-none-any.whl (54 kB)
Using cached esp_idf_panic_decoder-1.4.1-py3-none-any.whl (21 kB)
Using cached esp_idf_nvs_partition_gen-0.1.9-py3-none-any.whl (22 kB)
Using cached esp_idf_size-1.7.1-py3-none-any.whl (82 kB)
Using cached esp_idf_diag-0.2.0-py3-none-any.whl (23 kB)
Using cached pyclang-0.6.3-py3-none-any.whl (12 kB)
Using cached rich-14.2.0-py3-none-any.whl (243 kB)
Using cached pygments-2.19.2-py3-none-any.whl (1.2 MB)
Using cached psutil-7.1.0-cp36-abi3-macosx_11_0_arm64.whl (246 kB)
Using cached bitarray-3.7.2-cp314-cp314-macosx_11_0_arm64.whl (144 kB)
Using cached cffi-2.0.0-cp314-cp314-macosx_11_0_arm64.whl (181 kB)
Using cached markdown_it_py-4.0.0-py3-none-any.whl (87 kB)
Using cached pydantic-2.11.10-py3-none-any.whl (444 kB)
Using cached pyyaml-6.0.3-cp314-cp314-macosx_11_0_arm64.whl (173 kB)
Using cached typing_extensions-4.15.0-py3-none-any.whl (44 kB)
Using cached typing_inspection-0.4.2-py3-none-any.whl (14 kB)
Using cached pycparser-2.23-py3-none-any.whl (118 kB)
Using cached pydantic_settings-2.11.0-py3-none-any.whl (48 kB)
Using cached python_dotenv-1.1.1-py3-none-any.whl (20 kB)
Using cached requests-2.32.5-py3-none-any.whl (64 kB)
Downloading charset_normalizer-3.4.4-cp314-cp314-macosx_10_13_universal2.whl (207 kB)
Using cached idna-3.11-py3-none-any.whl (71 kB)
Using cached certifi-2025.10.5-py3-none-any.whl (163 kB)
Using cached ruamel.yaml-0.18.15-py3-none-any.whl (119 kB)
Using cached truststore-0.10.4-py3-none-any.whl (18 kB)
Building wheels for collected packages: pydantic-core
  Building wheel for pydantic-core (pyproject.toml) ... error
  error: subprocess-exited-with-error
  
  × Building wheel for pydantic-core (pyproject.toml) did not run successfully.
  │ exit code: 1
  ╰─> [136 lines of output]
      Running `maturin pep517 build-wheel -i /Users/andremaree/.espressif/python_env/idf5.5_py3.14_env/bin/python --compatibility off`
      Python reports SOABI: cpython-314-darwin
      Computed rustc target triple: aarch64-apple-darwin
      Installation directory: /Users/andremaree/Library/Caches/puccinialin
      Rustup already downloaded
      Installing rust to /Users/andremaree/Library/Caches/puccinialin/rustup
      warn: It looks like you have an existing rustup settings file at:
      warn: /Users/andremaree/.rustup/settings.toml
      warn: Rustup will install the default toolchain as specified in the settings file,
      warn: instead of the one inferred from the default host triple.
      info: profile set to 'minimal'
      info: default host triple is aarch64-apple-darwin
      warn: Updating existing toolchain, profile choice will be ignored
      info: syncing channel updates for 'stable-aarch64-apple-darwin'
      info: default toolchain set to 'stable-aarch64-apple-darwin'
      Checking if cargo is installed
      cargo 1.90.0 (840b83a10 2025-07-30)
      📦 Including license file `LICENSE`
      🍹 Building a mixed python/rust project
      🔗 Found pyo3 bindings
      🐍 Found CPython 3.14 at /Users/andremaree/.espressif/python_env/idf5.5_py3.14_env/bin/python
      📡 Using build options features, bindings from pyproject.toml
      💻 Using `MACOSX_DEPLOYMENT_TARGET=11.0` for aarch64-apple-darwin by default
         Compiling proc-macro2 v1.0.86
         Compiling unicode-ident v1.0.12
         Compiling target-lexicon v0.13.2
         Compiling python3-dll-a v0.2.13
         Compiling once_cell v1.19.0
         Compiling stable_deref_trait v1.2.0
         Compiling autocfg v1.3.0
         Compiling writeable v0.5.5
         Compiling litemap v0.7.3
         Compiling libc v0.2.155
         Compiling heck v0.5.0
         Compiling version_check v0.9.5
         Compiling icu_locid_transform_data v1.5.0
         Compiling rustversion v1.0.17
         Compiling icu_properties_data v1.5.0
         Compiling smallvec v1.14.0
         Compiling cfg-if v1.0.0
         Compiling utf8_iter v1.0.4
         Compiling utf16_iter v1.0.5
         Compiling icu_normalizer_data v1.5.0
         Compiling memchr v2.7.4
         Compiling radium v0.7.0
         Compiling write16 v1.0.0
         Compiling static_assertions v1.1.0
         Compiling ahash v0.8.11
         Compiling serde v1.0.218
         Compiling num-traits v0.2.19
         Compiling memoffset v0.9.1
         Compiling lexical-util v1.0.6
         Compiling tap v1.0.1
         Compiling zerocopy v0.7.34
         Compiling wyz v0.5.1
         Compiling funty v2.0.0
         Compiling serde_json v1.0.140
         Compiling aho-corasick v1.1.3
         Compiling unindent v0.2.3
         Compiling hashbrown v0.14.5
         Compiling regex-syntax v0.8.5
         Compiling lexical-parse-integer v1.0.5
         Compiling indoc v2.0.5
         Compiling percent-encoding v2.3.1
         Compiling equivalent v1.0.1
         Compiling indexmap v2.2.6
         Compiling form_urlencoded v1.2.1
         Compiling lexical-parse-float v1.0.5
         Compiling itoa v1.0.11
         Compiling bitvec v1.0.1
         Compiling ryu v1.0.18
         Compiling base64 v0.22.1
         Compiling uuid v1.16.0
         Compiling hex v0.4.3
         Compiling regex-automata v0.4.8
         Compiling num-integer v0.1.46
         Compiling num-bigint v0.4.6
         Compiling regex v1.11.1
         Compiling getrandom v0.2.15
         Compiling quote v1.0.36
         Compiling syn v2.0.82
         Compiling pyo3-build-config v0.24.1
         Compiling synstructure v0.13.1
         Compiling zerofrom-derive v0.1.4
         Compiling yoke-derive v0.7.4
         Compiling zerovec-derive v0.10.3
         Compiling displaydoc v0.2.5
         Compiling icu_provider_macros v1.5.0
         Compiling serde_derive v1.0.218
         Compiling strum_macros v0.26.4
         Compiling enum_dispatch v0.3.13
         Compiling pyo3-ffi v0.24.1
         Compiling pyo3-macros-backend v0.24.1
         Compiling pyo3 v0.24.1
         Compiling jiter v0.9.0
         Compiling pydantic-core v2.33.2 (/private/var/folders/3l/f38qk2dd6t15cjff23xfc0ww0000gn/T/pip-install-5pg_n16v/pydantic-core_83c51996167940608045f17d9c081e36)
         Compiling zerofrom v0.1.4
         Compiling strum v0.26.3
         Compiling pyo3-macros v0.24.1
      error: failed to run custom build command for `pyo3-ffi v0.24.1`
      
      Caused by:
        process didn't exit successfully: `/private/var/folders/3l/f38qk2dd6t15cjff23xfc0ww0000gn/T/pip-install-5pg_n16v/pydantic-core_83c51996167940608045f17d9c081e36/target/release/build/pyo3-ffi-3a915bcb0b4273f6/build-script-build` (exit status: 1)
        --- stdout
        cargo:rustc-check-cfg=cfg(Py_LIMITED_API)
        cargo:rustc-check-cfg=cfg(Py_GIL_DISABLED)
        cargo:rustc-check-cfg=cfg(PyPy)
        cargo:rustc-check-cfg=cfg(GraalPy)
        cargo:rustc-check-cfg=cfg(py_sys_config, values("Py_DEBUG", "Py_REF_DEBUG", "Py_TRACE_REFS", "COUNT_ALLOCS"))
        cargo:rustc-check-cfg=cfg(pyo3_disable_reference_pool)
        cargo:rustc-check-cfg=cfg(pyo3_leak_on_drop_without_reference_pool)
        cargo:rustc-check-cfg=cfg(Py_3_7)
        cargo:rustc-check-cfg=cfg(Py_3_8)
        cargo:rustc-check-cfg=cfg(Py_3_9)
        cargo:rustc-check-cfg=cfg(Py_3_10)
        cargo:rustc-check-cfg=cfg(Py_3_11)
        cargo:rustc-check-cfg=cfg(Py_3_12)
        cargo:rustc-check-cfg=cfg(Py_3_13)
        cargo:rustc-check-cfg=cfg(Py_3_14)
        cargo:rerun-if-env-changed=PYO3_CROSS
        cargo:rerun-if-env-changed=PYO3_CROSS_LIB_DIR
        cargo:rerun-if-env-changed=PYO3_CROSS_PYTHON_VERSION
        cargo:rerun-if-env-changed=PYO3_CROSS_PYTHON_IMPLEMENTATION
        cargo:rerun-if-env-changed=PYO3_PRINT_CONFIG
        cargo:rerun-if-env-changed=PYO3_USE_ABI3_FORWARD_COMPATIBILITY
      
        --- stderr
        error: the configured Python interpreter version (3.14) is newer than PyO3's maximum supported version (3.13)
        = help: please check if an updated version of PyO3 is available. Current version: 0.24.1
        = help: set PYO3_USE_ABI3_FORWARD_COMPATIBILITY=1 to suppress this check and build anyway using the stable ABI
      warning: build failed, waiting for other jobs to finish...
      💥 maturin failed
        Caused by: Failed to build a native library through cargo
        Caused by: Cargo build finished with "exit status: 101": `env -u CARGO MACOSX_DEPLOYMENT_TARGET="11.0" PYO3_BUILD_EXTENSION_MODULE="1" PYO3_ENVIRONMENT_SIGNATURE="cpython-3.14-64bit" PYO3_PYTHON="/Users/andremaree/.espressif/python_env/idf5.5_py3.14_env/bin/python" PYTHON_SYS_EXECUTABLE="/Users/andremaree/.espressif/python_env/idf5.5_py3.14_env/bin/python" "cargo" "rustc" "--features" "pyo3/extension-module" "--message-format" "json-render-diagnostics" "--manifest-path" "/private/var/folders/3l/f38qk2dd6t15cjff23xfc0ww0000gn/T/pip-install-5pg_n16v/pydantic-core_83c51996167940608045f17d9c081e36/Cargo.toml" "--release" "--lib" "--crate-type" "cdylib" "--" "-C" "link-arg=-undefined" "-C" "link-arg=dynamic_lookup" "-C" "link-args=-Wl,-install_name,@rpath/pydantic_core._pydantic_core.cpython-314-darwin.so"`
      Rust not found, installing into a temporary directory
      Error: command ['maturin', 'pep517', 'build-wheel', '-i', '/Users/andremaree/.espressif/python_env/idf5.5_py3.14_env/bin/python', '--compatibility', 'off'] returned non-zero exit status 1
      [end of output]
  
  note: This error originates from a subprocess, and is likely not a problem with pip.
  ERROR: Failed building wheel for pydantic-core
Failed to build pydantic-core
error: failed-wheel-build-for-install

× Failed to build installable wheels for some pyproject.toml based projects
╰─> pydantic-core
Traceback (most recent call last):
  File "/Users/andremaree/DevSpace/z-sdk/esp-idf/tools/idf_tools.py", line 3606, in <module>
    main(sys.argv[1:])
    ~~~~^^^^^^^^^^^^^^
  File "/Users/andremaree/DevSpace/z-sdk/esp-idf/tools/idf_tools.py", line 3596, in main
    action_func(args)
    ~~~~~~~~~~~^^^^^^
  File "/Users/andremaree/DevSpace/z-sdk/esp-idf/tools/idf_tools.py", line 2928, in action_install_python_env
    subprocess.check_call(run_args, stdout=sys.stdout, stderr=sys.stderr, env=env_copy)
    ~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/Library/Frameworks/Python.framework/Versions/3.14/lib/python3.14/subprocess.py", line 419, in check_call
    raise CalledProcessError(retcode, cmd)
subprocess.CalledProcessError: Command '['/Users/andremaree/.espressif/python_env/idf5.5_py3.14_env/bin/python', '-m', 'pip', 'install', '--no-warn-script-location', '-r', '/Users/andremaree/DevSpace/z-sdk/esp-idf/tools/requirements/requirements.core.txt', '--upgrade', '--constraint', '/Users/andremaree/.espressif/espidf.constraints.v5.5.txt', '--extra-index-url', 'https://dl.espressif.com/pypi']' returned non-zero exit status 1.
?1 esp-idf %

Diagnostic report archive.

No response

More Information.

No response

[dobairoland]

@ammaree We will try to reproduce & fix this on macOS. This seems to be the issue:

error: the configured Python interpreter version (3.14) is newer than PyO3's maximum supported version (3.13)

Can you keep using Python 3.13 until we resolve this?

Or if you keep using Python 3.14 then please try this suggestion for workaround:

= help: set PYO3_USE_ABI3_FORWARD_COMPATIBILITY=1 to suppress this check and build anyway using the stable ABI

[ammaree]

Reverted back to 3.9.6 couple of hours ago by simply deleting everything 3.14 related. Problem gone.

Guess my projects won't compile with master (have not used for a while) since Python 3.9.6 error came up when I tried to use updated latest master.

No problem for now, will simply stick to v5.5

[dobairoland]

Yes, ESP-IDF v6.0 will require Python 3.10 or newer.

We will fix this compatibility issue with Python 3.14 soon. We already reproduced it and found a suitable way to do it.