Home Assistant Voice Preview is an unusable mess.

2025-01-20

Shawn Wang

Home Assistant Voice Preview 根本不能用，爛得一塌糊塗

原文由 Shawn Wang 于 2025-01-20 發布，訂閱此部落格

我最近剛入手一台Home Assistant Voice。當時超興奮，想說可以把它當成能自己寫程式的 Alexa 來玩。

第一個問題——HA Voice 根本沒辦法獨立運作，它還得另外搭配一個 Home Assistant 實例。

好吧，沒關係。我還算懂點技術，應該搞得定。於是前往 HA 安裝說明。

Home Assistant 的問題

一進去它就先想賣我一台 Home Assistant Green。算了，我是沒興趣，但你們盡量賺吧。

對了，你們的購買按鈕現在是壞的，或許該去看一下。

我實在懶得等 Raspberry Pi 寄來，所以繼續往下滑。我手邊就有四台閒置的 Mac，或許可以用其中一台？啊，有 Mac 的安裝指南！

在 Mac 上安裝 Home Assistant

Mac 安裝頁面。

它要我做的第一件事就是下載「適當的映像檔」。為什麼不是 Docker image？或是那種可以直接掛載的東西？結果卻要我搞什麼 VM 的鬼東西？算了，去他的，晚點再來研究。（我後來才知道 VirtualBox 是一種特定類型的 VM hypervisor，但當時我根本不知道，或許應該加個下載 VirtualBox 的說明……）

這不是開源的嗎？難道不能直接從原始碼執行？看起來還有一個版本叫 Home Assistant Core，不錯嘛。

嗯……新款 Mac 已經沒有 apt-get 了。

沒關係，改用 brew 就好。安裝倒是成功了，不錯。

下一步：建立一個帳號。

靠北，這他媽是 Linux 的指南吧？到底有沒有人真的為 Mac 客製化過啊？

事實上，這些看起來全都是 Linux 那一套。

去他媽的，爛透了。

接著我試了這個：假設你已經安裝了 uv：

# be in some folder you like
uv venv
uv pip install homeassistant==2025.1.2 --prerelease=allow
uv run hass

第一次建置時我遇到了問題，顯然你得先執行「sudo softwareupdate --install "Command Line Tools for Xcode-16.2"」，否則就會出現這個錯誤

Unable to find configuration. Creating default one in /Users/shawnwang/.homeassistant
2025-01-19 16:33:27.267 WARNING (MainThread) [aiohttp_fast_zlib] zlib_ng and isal are not available, falling back to zlib, performance will be degraded.
2025-01-19 16:33:36.677 ERROR (SyncWorker_4) [homeassistant.util.package] Unable to install package pyspeex-noise==1.0.2: × Failed to download and build `pyspeex-noise==1.0.2`
  ╰─▶ Build backend failed to build wheel through `build_wheel` (exit status: 1)
      [stdout]
      running bdist_wheel
      running build
      running build_py
      building 'speex_noise_cpp' extension
      clang++ -fno-strict-overflow -Wsign-compare -Wunreachable-code -DNDEBUG -g -O3 -Wall -arch arm64 -mmacosx-version-min=11.0 ...
      [stderr]
      /Users/shawnwang/.cache/uv/sdists-v6/pypi/pyspeex-noise/1.0.2/OiKAa5C3V4L1j77Pq6j5d/src/speex/preprocess.cc:921:14: warning: code will never be executed [-Wunreachable-code]
      Compiling with an SDK that doesn't seem to exist: /Applications/Xcode_15.2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX14.2.sdk
      Please check your Xcode installation
      clang++: warning: no such sysroot directory: '/Applications/Xcode_15.2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX14.2.sdk'
      ld: library 'c++' not found
      clang++: error: linker command failed with exit code 1
      error: command '/usr/bin/clang++' failed with exit code 1
2025-01-19 16:34:07.135 ERROR (MainThread) [homeassistant.setup] Setup failed for 'cloud': Requirements for assist_pipeline not found: ['pyspeex-noise==1.0.2'].
2025-01-19 16:34:19.493 ERROR (MainThread) [homeassistant.setup] Error during setup of component conversation
Traceback (most recent call last):
  File "/Users/shawnwang/Desktop/Work/homeassistant/.venv/lib/python3.12/site-packages/homeassistant/setup.py", line 416, in _async_setup_component
    result = await task
  File "/Users/shawnwang/Desktop/Work/homeassistant/.venv/lib/python3.12/site-packages/homeassistant/components/conversation/__init__.py", line 246, in async_setup
    from homeassistant.components.assist_pipeline import (  # pylint: disable=import-outside-toplevel
  File "/Users/shawnwang/Desktop/Work/homeassistant/.venv/lib/python3.12/site-packages/homeassistant/components/assist_pipeline/pipeline.py", line 55, in <module>
    from .audio_enhancer import AudioEnhancer, EnhancedAudioChunk, MicroVadSpeexEnhancer
  File "/Users/shawnwang/Desktop/Work/homeassistant/.venv/lib/python3.12/site-packages/homeassistant/components/assist_pipeline/audio_enhancer.py", line 8, in <module>
    from pyspeex_noise import AudioProcessor
ModuleNotFoundError: No module named 'pyspeex_noise'
2025-01-19 16:34:19.497 ERROR (MainThread) [homeassistant.setup] Unable to set up dependencies of 'assist_pipeline'. Setup failed for dependencies: ['conversation']
2025-01-19 16:34:19.497 ERROR (MainThread) [homeassistant.setup] Setup failed for 'assist_pipeline': Could not setup dependencies: conversation
2025-01-19 16:34:19.886 ERROR (MainThread) [homeassistant.setup] Setup failed for 'mobile_app': Requirements for assist_pipeline not found: ['pyspeex-noise==1.0.2'].
2025-01-19 16:34:19.886 ERROR (MainThread) [homeassistant.setup] Unable to set up dependencies of 'default_config'. Setup failed for dependencies: ['assist_pipeline', 'cloud', 'conversation', 'mobile_app']
2025-01-19 16:34:19.886 ERROR (MainThread) [homeassistant.setup] Setup failed for 'default_config': Could not setup dependencies: assist_pipeline, cloud, conversation, mobile_app
2025-01-19 16:34:19.887 WARNING (MainThread) [homeassistant.bootstrap] Support for the running Python version 3.12.7 is deprecated and will be removed in Home Assistant 2025.2; Please upgrade Python to 3.13

這樣讓我進展了不少。不過因為 HA 裡一堆相依套件的關係，我還是卡住了，無法繼續：