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
- Verify system TLS certificates and HTTP client configuration, then restart the TTS service.
- 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)