Something seems broken with the protobuf definitions (or more likely the pip requirements)

[Rudd-O]

aioesphomeapi/requirements/base.txt

Line 3 in ec6e820

protobuf>=4

says aioesphomeapi requires protobuf 4>, but this is not correct based on the actual observed results with protobuf 64 installed in the venv:

Jun 14 23:06:17 assistant hass[6700]: 2025-06-14 23:06:17.298 ERROR (ImportExecutor_0) [homeassistant.loader] Unexpected exception importing component homeassistant.components.esphome
Jun 14 23:06:17 assistant hass[6700]: Traceback (most recent call last):
Jun 14 23:06:17 assistant hass[6700]:   File "/opt/assistant/lib64/python3.13/site-packages/homeassistant/loader.py", line 1053, in _get_component
Jun 14 23:06:17 assistant hass[6700]:     ComponentProtocol, importlib.import_module(self.pkg_path)
Jun 14 23:06:17 assistant hass[6700]:                        ~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^
Jun 14 23:06:17 assistant hass[6700]:   File "/opt/assistant/lib64/python3.13/site-packages/homeassistant/util/loop.py", line 201, in protected_loop_func
Jun 14 23:06:17 assistant hass[6700]:     return func(*args, **kwargs)
Jun 14 23:06:17 assistant hass[6700]:   File "/usr/lib64/python3.13/importlib/__init__.py", line 88, in import_module
Jun 14 23:06:17 assistant hass[6700]:     return _bootstrap._gcd_import(name[level:], package, level)
Jun 14 23:06:17 assistant hass[6700]:            ~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Jun 14 23:06:17 assistant hass[6700]:   File "<frozen importlib._bootstrap>", line 1387, in _gcd_import
Jun 14 23:06:17 assistant hass[6700]:   File "<frozen importlib._bootstrap>", line 1360, in _find_and_load
Jun 14 23:06:17 assistant hass[6700]:   File "<frozen importlib._bootstrap>", line 1331, in _find_and_load_unlocked
Jun 14 23:06:17 assistant hass[6700]:   File "<frozen importlib._bootstrap>", line 935, in _load_unlocked
Jun 14 23:06:17 assistant hass[6700]:   File "<frozen importlib._bootstrap_external>", line 1026, in exec_module
Jun 14 23:06:17 assistant hass[6700]:   File "<frozen importlib._bootstrap>", line 488, in _call_with_frames_removed
Jun 14 23:06:17 assistant hass[6700]:   File "/opt/assistant/lib64/python3.13/site-packages/homeassistant/components/esphome/__init__.py", line 5, in <module>
Jun 14 23:06:17 assistant hass[6700]:     from aioesphomeapi import APIClient
Jun 14 23:06:17 assistant hass[6700]:   File "/opt/assistant/lib64/python3.13/site-packages/aioesphomeapi/__init__.py", line 2, in <module>
Jun 14 23:06:17 assistant hass[6700]:     from .api_pb2 import (  # type: ignore[attr-defined] # noqa: F401
Jun 14 23:06:17 assistant hass[6700]:     ...<2 lines>...
Jun 14 23:06:17 assistant hass[6700]:     )
Jun 14 23:06:17 assistant hass[6700]:   File "/opt/assistant/lib64/python3.13/site-packages/aioesphomeapi/api_pb2.py", line 16, in <module>
Jun 14 23:06:17 assistant hass[6700]:     from . import api_options_pb2 as api__options__pb2
Jun 14 23:06:17 assistant hass[6700]:   File "/opt/assistant/lib64/python3.13/site-packages/aioesphomeapi/api_options_pb2.py", line 16, in <module>
Jun 14 23:06:17 assistant hass[6700]:     from google.protobuf import descriptor_pb2 as google_dot_protobuf_dot_descriptor__pb2
Jun 14 23:06:17 assistant hass[6700]:   File "/opt/assistant/lib64/python3.13/site-packages/google/protobuf/descriptor_pb2.py", line 12, in <module>
Jun 14 23:06:17 assistant hass[6700]:     _runtime_version.ValidateProtobufRuntimeVersion(
Jun 14 23:06:17 assistant hass[6700]:     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~^
Jun 14 23:06:17 assistant hass[6700]:         _runtime_version.Domain.PUBLIC,
Jun 14 23:06:17 assistant hass[6700]:         ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Jun 14 23:06:17 assistant hass[6700]:     ...<4 lines>...
Jun 14 23:06:17 assistant hass[6700]:         'google/protobuf/descriptor.proto'
Jun 14 23:06:17 assistant hass[6700]:         ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Jun 14 23:06:17 assistant hass[6700]:     )
Jun 14 23:06:17 assistant hass[6700]:     ^
Jun 14 23:06:17 assistant hass[6700]:   File "/opt/assistant/lib64/python3.13/site-packages/google/protobuf/runtime_version.py", line 106, in ValidateProtobufRuntimeVersion
Jun 14 23:06:17 assistant hass[6700]:     _ReportVersionError(
Jun 14 23:06:17 assistant hass[6700]:     ~~~~~~~~~~~~~~~~~~~^
Jun 14 23:06:17 assistant hass[6700]:         'Detected mismatched Protobuf Gencode/Runtime major versions when'
Jun 14 23:06:17 assistant hass[6700]:         ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Jun 14 23:06:17 assistant hass[6700]:         f' loading {location}: gencode {gen_version} runtime {version}.'
Jun 14 23:06:17 assistant hass[6700]:         ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Jun 14 23:06:17 assistant hass[6700]:         f' Same major version is required. {error_prompt}'
Jun 14 23:06:17 assistant hass[6700]:         ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Jun 14 23:06:17 assistant hass[6700]:     )
Jun 14 23:06:17 assistant hass[6700]:     ^
Jun 14 23:06:17 assistant hass[6700]:   File "/opt/assistant/lib64/python3.13/site-packages/google/protobuf/runtime_version.py", line 50, in _ReportVersionError
Jun 14 23:06:17 assistant hass[6700]:     raise VersionError(msg)
Jun 14 23:06:17 assistant hass[6700]: google.protobuf.runtime_version.VersionError: Detected mismatched Protobuf Gencode/Runtime major versions when loading google/protobuf/descriptor.proto: gencode 6.31.1 runtime 5.29.2. Same major version is required. See Protobuf version guarantees at https://protobuf.dev/support/cross-version-runtime-guarantee.

https://protobuf.dev/support/cross-version-runtime-guarantee/ says generated code and runtime must be same major version.

Yes, I should clarify: I manually installed protobuf 4 because some other project requires it — but, still, if your code has been generating the definitions using protogen version 6, your dependency is incorrectly specified and you must require protobuf version 6.

[Rudd-O]

The reason I noticed the protobuf 6 requirement is that the pyatv integration requires protobuf 6, and perhaps that is why that is getting installed under the venv.

[bdraco]

Files are generated with proto 4. We should probably bump to proto 5 though at some point

aioesphomeapi/aioesphomeapi/api_pb2.py

Line 5 in ec6e820

# Protobuf Python Version: 4.25.5

[bdraco]

With protobuf's newer version guarantee requirements, the pin should like be >=4,<6

[bdraco]

We should move to protobuf 5 and set the pin to >=5,<7 which will prevent future issues

[jonwaland]

just adding:
I just upgraded from 2025.5.3 to 2025.6.1 and had loads of Protobuf errors.

UserWarning: Protobuf gencode version 5.29.2 is exactly one major version older than the runtime version 6.31.1 at goo
gle/protobuf/descriptor.proto. Please update the gencode to avoid compatibility violations in the next runtime release.

I forced an upgrade to 6.31.1, and now most of the errors are gone, excluding aioesphomeapi :

2025-06-17 14:59:36.017 ERROR (MainThread) [homeassistant.setup] Setup failed for 'esphome': Unable to import component: No module named 'aioesphomeapi'
Traceback (most recent call last):
  File "/srv/homeassistant/lib/python3.13/site-packages/homeassistant/setup.py", line 344, in _async_setup_component
    component = await integration.async_get_component()
                ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/srv/homeassistant/lib/python3.13/site-packages/homeassistant/loader.py", line 1013, in async_get_component
    self._component_future.result()
    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~^^
  File "/srv/homeassistant/lib/python3.13/site-packages/homeassistant/loader.py", line 993, in async_get_component
    comp = await self.hass.async_add_import_executor_job(
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
        self._get_component, True
        ^^^^^^^^^^^^^^^^^^^^^^^^^
    )
    ^
  File "/usr/lib/python3.13/concurrent/futures/thread.py", line 59, in run
    result = self.fn(*self.args, **self.kwargs)
  File "/srv/homeassistant/lib/python3.13/site-packages/homeassistant/loader.py", line 1053, in _get_component
    ComponentProtocol, importlib.import_module(self.pkg_path)
                       ~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^
  File "/srv/homeassistant/lib/python3.13/site-packages/homeassistant/util/loop.py", line 201, in protected_loop_func
    return func(*args, **kwargs)
  File "/usr/lib/python3.13/importlib/__init__.py", line 88, in import_module
    return _bootstrap._gcd_import(name[level:], package, level)
           ~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "<frozen importlib._bootstrap>", line 1387, in _gcd_import
  File "<frozen importlib._bootstrap>", line 1360, in _find_and_load
  File "<frozen importlib._bootstrap>", line 1331, in _find_and_load_unlocked
  File "<frozen importlib._bootstrap>", line 935, in _load_unlocked
  File "<frozen importlib._bootstrap_external>", line 1026, in exec_module
  File "<frozen importlib._bootstrap>", line 488, in _call_with_frames_removed
  File "/srv/homeassistant/lib/python3.13/site-packages/homeassistant/components/esphome/__init__.py", line 5, in <module>
    from aioesphomeapi import APIClient
ModuleNotFoundError: No module named 'aioesphomeapi'

FYI

(homeassistant) homeassistant@jonlabnuc:~/.homeassistant$ pip show protobuf
Name: protobuf
Version: 5.29.2
Summary:
Home-page: https://developers.google.com/protocol-buffers/
Author: protobuf@googlegroups.com
Author-email: protobuf@googlegroups.com
License: 3-Clause BSD License
Location: /srv/homeassistant/lib/python3.13/site-packages
Requires:
Required-by: aioesphomeapi, androidtvremote2, gassist-text, gflanguages, ghome-foyer-api, pyatv, PyChromecast

UPDATE:

rolled back to HASS 2025.5.3, aioesphomeapi 30.1.0 and protobuf 5.29.2