tinyhumansai/openhuman · error

[voice-install:piper] auto-install on custom voice failed:

Error message

[voice-install:piper] auto-install on custom voice failed:

What it means

The automatic Piper TTS voice installation triggered by entering a custom voice name failed. When the user types a non-preset voice id in the custom voice field, the panel attempts to auto-install that voice; this warn records the failure, so the custom voice stays configured but has no installed artifact and TTS will fall back or error when it is used.

Source

Thrown at app/src/components/settings/panels/VoicePanel.tsx:1100

                            {v.label}
                          </option>
                        ))}
                        <option value="__custom__">{t('voice.providers.customVoiceOption')}</option>
                      </SettingsSelect>
                      {!PIPER_VOICE_PRESET_IDS.some(v => v === ttsVoice) && (
                        <SettingsTextField
                          aria-label={t('voice.providers.customVoiceAria')}
                          data-testid="tts-voice-input"
                          value={ttsVoice}
                          placeholder={t('voice.providers.customVoicePlaceholder')}
                          disabled={isSavingProviders}
                          onChange={e => setTtsVoice(e.target.value)}
                          onBlur={() => {
                            if (ttsVoice && ttsVoice !== voiceStatus?.tts_voice_id) {
                              void persistProviders({ tts_voice: ttsVoice });
                              void installPiper({ voiceId: ttsVoice }).catch(err =>
                                console.warn(
                                  '[voice-install:piper] auto-install on custom voice failed:',
                                  err
                                )
                              );
                            }
                          }}
                          className="mt-1 w-full"
                        />
                      )}
                      <p className="text-[11px] text-content-muted mt-0.5">
                        {t('voice.providers.piperVoicesDesc')}
                      </p>
                    </label>
                  )}

                  {/* ElevenLabs voice picker — shown when ElevenLabs is selected for TTS */}
                  {ttsProvider === 'elevenlabs' && (
                    <label className="block space-y-1">
                      <span className="text-xs font-medium text-content-muted dark:text-content-secondary">

View on GitHub (pinned to 7491200858)

Solutions

1. Check the warned error — a custom voice id that does not exist in the Piper voice catalog fails deterministically
2. Confirm the exact voice id spelling against the Piper voice catalog naming
3. Retry the install once the id is corrected or the network/download issue is resolved
4. Fall back to a preset voice if the custom voice cannot be installed

When it happens

Trigger: Thrown at app/src/components/settings/panels/VoicePanel.tsx:1100 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of tinyhumansai/openhuman@7491200858 (2026-08-17). Data as JSON: /api/errors/7241c66693341df4. Report an issue: GitHub.