zeroclaw-labs/zeroclaw · error

Failed to build HTTP client for Piper TTS

Error message

Failed to build HTTP client for Piper TTS

What it means

PiperTtsProvider construction: the reqwest client for the local Piper TTS endpoint failed to build despite static settings. Treated as an invariant failure — without an HTTP client the TTS provider cannot function at all.

Solutions

  1. Verify system TLS certificates and HTTP client configuration, then restart the TTS service.
  2. Check proxy/environment settings that could prevent building the HTTP client.
Defensive patterns

Strategy: fallback

When it happens

Trigger: Thrown at crates/zeroclaw-channels/src/tts.rs:848 when the library encounters an invalid state.

Common situations: See trigger scenarios.


AI-assisted analysis of zeroclaw-labs/zeroclaw@88bb9c8533 (2026-08-23). Data as JSON: /api/errors/6268584e99c9a9ef. Report an issue: GitHub.

Appendix: source

Thrown at crates/zeroclaw-channels/src/tts.rs:848

    client: reqwest::Client,
    api_url: String,
}

impl PiperTtsProvider {
    /// Create a new Piper TTS model_provider from config. Falls back to
    /// `http://127.0.0.1:5000/v1/audio/speech` when no `api_url` is supplied.
    pub fn new(alias: &str, config: &TtsProviderConfig) -> Self {
        let api_url = config
            .uri
            .clone()
            .filter(|u| !u.trim().is_empty())
            .unwrap_or_else(|| "http://127.0.0.1:5000/v1/audio/speech".to_string());
        Self {
            alias: alias.to_string(),
            client: reqwest::Client::builder()
                .timeout(TTS_HTTP_TIMEOUT)
                .build()
                .expect("Failed to build HTTP client for Piper TTS"),
            api_url,
        }
    }
}

#[async_trait::async_trait]
impl TtsProvider for PiperTtsProvider {
    fn name(&self) -> &str {
        "piper"
    }

    fn output_format(&self) -> &str {
        // Piper's OpenAI-compatible server returns WAV when no response_format
        // is requested (the body below omits it).
        "wav"
    }

    async fn synthesize(&self, text: &str, voice: &str) -> Result<Vec<u8>> {

View on GitHub (pinned to 88bb9c8533)