[BUG] <Local voice model does not working>

[syao2018]

Is there an existing issue for this?

• I have searched the existing issues

Current Behavior

'docker logs piper' shows error: 'ERROR:wyoming_piper.download:Failed to update voices list' when docker image started.

Expected Behavior

NONE

Steps To Reproduce

1. Environment: Raspberry Pi5, OS: trixie, docker 29.2.1
2. With local build docker image: git clone https://github.com/linuxserver/docker-piper.git
   cd docker-piper
   docker build
   --no-cache
   --pull
   -t lscr.io/linuxserver/qemu-static:latest .
3. Run: docker run -d \ --name=piper
   -e PUID=1000
   -e PGID=1000
   -e TZ=ASIA/Hongkong
   -e PIPER_VOICE=en_US-lessac-medium
   -p 10200:10200
   -v ./piper-data:/config
   --restart unless-stopped
   lscr.io/linuxserver/qemu-static:latest
4. See error with 'docker logs piper: ERROR:wyoming_piper.download:Failed to update voices list ...

Environment

- OS: Raspberry trixie
- How docker service was installed: local build image

CPU architecture

arm64

Docker creation

docker run -d \
  --name=piper \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=ASIA/Hongkong \
  -e PIPER_VOICE=en_US-lessac-medium \
  -p 10200:10200 \
  -v ./piper-data:/config \
  --restart unless-stopped \
  lscr.io/linuxserver/qemu-static:latest

Container logs

[migrations] started
[migrations] no migrations found
───────────────────────────────────────
  _____ __ __ _____ _____ _____ _____
 |     |  |  |   __|_   _|     |     |
 |   --|  |  |__   | | | |  |  | | | |
 |_____|_____|_____| |_| |_____|_|_|_|
       _____ __ __ _ __    ____
      | __  |  |  | |  |  |    \
      | __ -|  |  | |  |__|  |  |
      |_____|_____|_|_____|____/

  Based on images from linuxserver.io
───────────────────────────────────────

To support LSIO projects visit:
https://www.linuxserver.io/donate/

───────────────────────────────────────
GID/UID
───────────────────────────────────────

User UID:    1000
User GID:    1000
───────────────────────────────────────
Linuxserver.io version:
Build-date:
───────────────────────────────────────

[custom-init] No custom files found, skipping...
2026-02-23 05:00:25.088133191 [W:onnxruntime:Default, device_discovery.cc:211 DiscoverDevicesForPlatform] GPU device discovery failed: device_discovery.cc:91 ReadFileContents Failed to open file: "/sys/class/drm/card1/device/vendor"
ERROR:wyoming_piper.download:Failed to update voices list
Traceback (most recent call last):
  File "/usr/lib/python3.12/urllib/request.py", line 1344, in do_open
    h.request(req.get_method(), req.selector, req.data, headers,
  File "/usr/lib/python3.12/http/client.py", line 1356, in request
    self._send_request(method, url, body, headers, encode_chunked)
  File "/usr/lib/python3.12/http/client.py", line 1402, in _send_request
    self.endheaders(body, encode_chunked=encode_chunked)
  File "/usr/lib/python3.12/http/client.py", line 1351, in endheaders
    self._send_output(message_body, encode_chunked=encode_chunked)
  File "/usr/lib/python3.12/http/client.py", line 1111, in _send_output
    self.send(msg)
  File "/usr/lib/python3.12/http/client.py", line 1055, in send
    self.connect()
  File "/usr/lib/python3.12/http/client.py", line 1490, in connect
    super().connect()
  File "/usr/lib/python3.12/http/client.py", line 1021, in connect
    self.sock = self._create_connection(
                ^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/lib/python3.12/socket.py", line 852, in create_connection
    raise exceptions[0]
  File "/usr/lib/python3.12/socket.py", line 837, in create_connection
    sock.connect(sa)
OSError: [Errno 101] Network is unreachable

During handling of the above exception, another exception occurred:

Traceback (most recent call last):
  File "/lsiopy/lib/python3.12/site-packages/wyoming_piper/download.py", line 43, in get_voices
    with urlopen(_quote_url(voices_url)) as response:
         ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/lib/python3.12/urllib/request.py", line 215, in urlopen
    return opener.open(url, data, timeout)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/lib/python3.12/urllib/request.py", line 515, in open
    response = self._open(req, data)
               ^^^^^^^^^^^^^^^^^^^^^
  File "/usr/lib/python3.12/urllib/request.py", line 532, in _open
    result = self._call_chain(self.handle_open, protocol, protocol +
             ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/lib/python3.12/urllib/request.py", line 492, in _call_chain
    result = func(*args)
             ^^^^^^^^^^^
  File "/usr/lib/python3.12/urllib/request.py", line 1392, in https_open
    return self.do_open(http.client.HTTPSConnection, req,
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/lib/python3.12/urllib/request.py", line 1347, in do_open
    raise URLError(err)
urllib.error.URLError: <urlopen error [Errno 101] Network is unreachable>
INFO:__main__:Ready
Connection to localhost (127.0.0.1) 10200 port [tcp/*] succeeded!
[ls.io-init] done.

[github-actions]

Thanks for opening your first issue here! Be sure to follow the relevant issue templates, or risk having this issue marked as invalid.

[syao2018]

Did not mentioned that I have already put en_US-lessac-medium.onnx & en_US-lessac-medium.onnx.json under .piper-data/ folder when starting docker container.

[thespad]

There is a very specific flag for this exact use case:

-e LOCAL_ONLY= 	If set to true, or any other value, the container will not attempt to download models from HuggingFace and will only use locally-provided models.

[syao2018]

Thanks for the prompt reply @thespad !
I have set -e LOCAL_ONLY=true, the error message for downloading models from Huggingface has gone. but the piper-tts still does not work to provide 'voice' output. I tried command to test piper (I'm not sure it is the correct command):
'curl -X POST http://:10200
-H "Content-Type: application/json"
-d '{"text": "hello, welcome to use Piper TTS services"}'
--output test.wav'; but no output of test.wav, command ends up with 'hanging' there.

Sorry to bother you for help if here is the right place for asking. If not, just ignore, thanks again!

[thespad]

So bare in mind this is providing a wyoming protocol endpoint for piper, so you need to send the right payload if you're trying to test directly via curl. My instance is integrated with Home Assistant, which is where I run my tests from.

[syao2018]

Ok, thanks @thespad ! I will investigate the wyoming protocal; appreciate for your kindness support :-)