ESPhome error when installing

Getting this error. Can anyone help? Thanks

Creating a new virtual environment for IDF Python dependencies using uv
Using Python 3.12.10 environment at: /root/.platformio/penv/.espidf-5.5.1
Installing ESP-IDF’s Python dependencies with uv
Using Python 3.12.10 environment at: /root/.platformio/penv/.espidf-5.5.1
Resolved 27 packages in 257ms
Building ruamel-yaml-clibz==0.3.4
Downloading pydantic-core (1.9MiB)
Downloading cryptography (4.0MiB)
Downloaded pydantic-core
Downloaded cryptography
× Failed to build ruamel-yaml-clibz==0.3.4
├─▶ The build backend returned an error
╰─▶ Call to setuptools.build_meta:__legacy__.build_wheel failed (exit
status: 1)

  [stdout]
  running bdist_wheel
  running build
  running build_ext
  building '_ruamel_yaml_clibz' extension
  creating build/temp.linux-x86_64-cpython-312
  gcc -fno-strict-overflow -Wsign-compare -DNDEBUG -g -O3
  -Wall -fPIC -I/root/.cache/uv/builds-v0/.tmpVHRpzL/include
  -I/usr/local/include/python3.12 -c _ruamel_yaml_clibz.c -o
  build/temp.linux-x86_64-cpython-312/_ruamel_yaml_clibz.o

  [stderr]
  /root/.cache/uv/builds-v0/.tmpVHRpzL/lib/python3.12/site-packages/setuptools/_distutils/dist.py:289:
  UserWarning: Unknown distribution option: 'build_zig'
    warnings.warn(msg)
  error: command 'gcc' failed: No such file or directory

  hint: This usually indicates a problem with the package or the build
  environment.

help: ruamel-yaml-clibz (v0.3.4) was included because
idf-component-manager (v2.4.3) depends on ruamel-yaml (v0.19.0)
which depends on ruamel-yaml-clibz
*** Error 1
Reading CMake configuration…
– Found Git: /usr/bin/git (found version “2.39.5”)
– git rev-parse returned ‘fatal: not a git repository (or any parent up to mount point /)
Stopping at filesystem boundary (GIT_DISCOVERY_ACROSS_FILESYSTEM not set).’
– Minimal build - OFF
– The C compiler identification is GNU 14.2.0
– The CXX compiler identification is GNU 14.2.0
– The ASM compiler identification is GNU
– Found assembler: /data/cache/platformio/packages/toolchain-xtensa-esp-elf/bin/xtensa-esp32s3-elf-gcc
– Detecting C compiler ABI info
– Detecting C compiler ABI info - done
– Check for working C compiler: /data/cache/platformio/packages/toolchain-xtensa-esp-elf/bin/xtensa-esp32s3-elf-gcc - skipped
– Detecting C compile features
– Detecting C compile features - done
– Detecting CXX compiler ABI info
– Detecting CXX compiler ABI info - done
– Check for working CXX compiler: /data/cache/platformio/packages/toolchain-xtensa-esp-elf/bin/xtensa-esp32s3-elf-g++ - skipped
– Detecting CXX compile features
– Detecting CXX compile features - done
– Building ESP-IDF components for target esp32s3
– Configuring incomplete, errors occurred!

fatal: not a git repository (or any parent up to mount point /)
Stopping at filesystem boundary (GIT_DISCOVERY_ACROSS_FILESYSTEM not set).
CMake Error at /data/cache/platformio/packages/framework-espidf/tools/cmake/build.cmake:629 (message):
/root/.platformio/penv/.espidf-5.5.1/bin/python: Error while finding module
specification for ‘idf_component_manager.prepare_components’
(ModuleNotFoundError: No module named ‘idf_component_manager’)

Call Stack (most recent call first):
/data/cache/platformio/packages/framework-espidf/tools/cmake/project.cmake:740 (idf_build_process)
CMakeLists.txt:3 (project)

========================= [FAILED] Took 78.67 seconds =========================
:question:

1 Like

Since the ESPHome Device Builder 2025.12.3 update, getting this failure when trying to update one of my modules (but not the others)

CMake Error at /data/cache/platformio/packages/framework-espidf/tools/cmake/build.cmake:629 (message):
  /root/.platformio/penv/.espidf-5.5.1/bin/python: Error while finding module

EDIT: I think I skipped an update or two, so probably did not start with 2025.12.3

I’m getting this exact same error, though I should mention my current version is 2025.12.0 so I can’t say for sure that this is new based on version 2025.12.3.

I got the same error when trying to build firmware for a Christmas garland. Very frustrating.

Same error here trying to flash a esp32 C3 supermini in the esphome addon. On the version 2025.12.3 of the esphome device builder

Actually, I think I skipped an update or two, so I shouldn’t have said it started with 2025.12.3. Updated post.

Same error here, this project was working a couple of days ago.

Keeping an eye out. Looks like the error I am getting:

INFO ESPHome 2025.12.3
INFO Reading configuration /config/esphome/ble-relay-backyard.yaml...
INFO Generating C++ source...
INFO Setting CONFIG_LWIP_MAX_SOCKETS to 14 (registered: api=4, captive_portal=4, mdns=2, ota=1, web_server=3)
INFO Compiling app... Build path: /data/build/ble-relay-backyard
Processing ble-relay-backyard (board: esp32dev; framework: espidf; platform: https://github.com/pioarduino/platform-espressif32/releases/download/55.03.31-2/platform-espressif32.zip)
--------------------------------------------------------------------------------
HARDWARE: ESP32 240MHz, 320KB RAM, 4MB Flash
 - contrib-piohome @ 3.4.4 
 - framework-espidf @ 3.50501.0 (5.5.1) 
 - tool-cmake @ 4.0.3 
 - tool-esp-rom-elfs @ 2024.10.11 
 - tool-esptoolpy @ 5.1.0 
 - tool-mklittlefs @ 3.2.0 
 - tool-ninja @ 1.13.1 
 - tool-scons @ 4.40801.0 (4.8.1) 
 - toolchain-xtensa-esp-elf @ 14.2.0+20241119
Reading CMake configuration...
-- git rev-parse returned 'fatal: not a git repository (or any parent up to mount point /)
Stopping at filesystem boundary (GIT_DISCOVERY_ACROSS_FILESYSTEM not set).'
-- Minimal build - OFF
-- Building ESP-IDF components for target esp32
-- Configuring incomplete, errors occurred!

fatal: not a git repository (or any parent up to mount point /)
Stopping at filesystem boundary (GIT_DISCOVERY_ACROSS_FILESYSTEM not set).
CMake Error at /data/cache/platformio/packages/framework-espidf/tools/cmake/build.cmake:629 (message):
  /root/.platformio/penv/.espidf-5.5.1/bin/python: Error while finding module
  specification for 'idf_component_manager.prepare_components'
  (ModuleNotFoundError: No module named 'idf_component_manager')

Call Stack (most recent call first):
  /data/cache/platformio/packages/framework-espidf/tools/cmake/project.cmake:740 (idf_build_process)
  CMakeLists.txt:3 (project)



========================== [FAILED] Took 8.93 seconds ==========================

Very often the best thing to do is to clear the build cache and try again. I use ESPHome on my development machine from the command line, so I’m not sure how you do that with the addon. I did a quick search, and it looks like there might be a button near the top of the ESPHome page that says something like “Clean All.”

Did the clean all and still receive the same error. But as a positive i gained like 12gb of space back on my VM which was running low on space. So that’s a plus.

Same here, different devices too

I have just started receiving the same error. (Was all good yesterday.)

I have tried Clean All, just in case, but the same error occurs.

The error from package https://pypi.org/project/ruamel.yaml/ is probably related to the announcement in the last 24 hours regarding naming and compiling.

This has been fixed in the ESPHome Dockerfile here: [docker] Add build-essential to fix ruamel.yaml 0.19.0 compilation (#… · esphome/esphome@4633803 · GitHub

I don’t know if the Docker image has rebuilt yet.

This has been fixed in 2025.12.4 - released about 30 minutes ago. There is already a new docker container availble.

3 Likes

Hi, New here. Getting the same error at 7:30pm EST after Clean All. Help?
EDIT: Ok sorry, i installed the ESPHome Builder Beta which was newer, and it seems to be working.
Thanks!

Wait for the update it fixes it.

It sure did, thanks!

Have got same issue. “Problem” with ruamel-yaml-clibz==0.3.4 which need gcc and python3-dev packages installed in your system.
Resolved on my Ubuntu by next commands:

sudo apt install gcc-x86-64-linux-gnu
sudo apt install python3-dev

You need to find how to install “gcc” into your system
Then clean project and run again

esphome clean-all esp32-example.yaml
esphome run esp32-example.yaml
1 Like