ESPHome 2026.7.0 wont update anything, Python version must be between 3.10 and 3.13 - have 3.14

HackerJL · July 16, 2026, 8:52pm

Odd one today, but I updated ESPHome to 2026.7.0, update went well, ESP32 devices show updates pending. I tell one to do the update, walk away like normal.

Came back, didnt update, so I went to the builder and did update to see the logs, this is what Im presented with.

INFO ESPHome 2026.7.0

INFO Reading configuration /config/esphome/plug2.yaml…

INFO Generating C++ source…

INFO Detected timezone ‘America/Regina’

INFO Compiling app… Build path: /data/build/keurig

Processing keurig (board: esp01_1m; framework: arduino; platform: platformio/[email protected])

ERROR: Python version must be between 3.10 and 3.13.

Current Python version: 3.14.6

Supported versions: 3.10, 3.11, 3.12, 3.13

neel-m · July 16, 2026, 9:07pm

The error message seems pretty clear. You have Python 3.14 and it isn’t supported.

This of course seemed strange that it didn’t warn you earlier.

This is the GitHub issue with a solution:

github.com/esphome/esphome

ESPHome 2026.7.0: captive_portal compile fails with Python version error on ESP8266

opened 06:05AM - 16 Jul 26 UTC

closed 11:33AM - 16 Jul 26 UTC

Jpsy

### The problem Using `captive_portal:` in combination with `esp8266:` raises a… Python version error when compiling (see log below). It works fine with `esp32:` though. ### Which version of ESPHome has the issue? 2026.7.0 ### What type of installation are you using? Home Assistant Add-on ### What platform are you using? ESP8266 ### Component causing the issue captive_portal ### YAML Config ```yaml esphome: name: "my-device-name" esp8266: board: esp8285 wifi: ssid: my_wifi_ssid password: my_wifi_password captive_portal: ``` ### Anything in the logs that might be useful for us? ```txt INFO ESPHome 2026.7.0 INFO Reading configuration /config/esphome/my-device-name.yaml... WARNING Captive portal is enabled but no WiFi AP is configured. The captive portal will not be accessible. Add 'ap:' to your WiFi configuration to enable the captive portal. INFO Generating C++ source... INFO Compiling app... Build path: /data/build/my-device-name Processing my-device-name (board: esp8285; framework: arduino; platform: platformio/[email protected]) -------------------------------------------------------------------------------- ERROR: Python version must be between 3.10 and 3.13. Current Python version: 3.14.6 Supported versions: 3.10, 3.11, 3.12, 3.13 ``` ### Additional information _No response_

Try clicking upper right menu → Firmware tasks → Reset Build Environment

Msperl · July 17, 2026, 12:40pm

I am seeing a similar issue, but only when building/updating a raspberry pico2 - esp32s3 builds work fine…

That is using homeassistant plus esphome add (iirc that is a docker image) on both at the latest version:

Processing xxxxx (board: rpipico2w; framework: arduino; platform: https://github.com/maxgerhardt/platform-raspberrypi.git#v1.4.0-gcc14-arduinopico460)
--------------------------------------------------------------------------------
ERROR: Python version must be between 3.10 and 3.13.
Current Python version: 3.14.6
Supported versions: 3.10, 3.11, 3.12, 3.13

Msperl · July 17, 2026, 12:49pm

Yes, but a reset solved the inconsist issue, which seem strange to be required…

bitrip · July 18, 2026, 10:26am

In ESPHome portal where you see your ESPHome devices click upper right menu → Firmware tasks → Reset Build Environment
Wait a moment until it’s finished, then update your devices again.

EDIT: Apologies, this solution was already posted

kartcon · July 19, 2026, 12:05am

@ neel-m
Thank you for the fix! It worked just fine and was something I would have never found on my own. This community rocks!!