uncloseai-speech/speech.py

1387 lines
54 KiB
Python
Executable file

#!/usr/bin/env python3
import argparse
import asyncio
import contextlib
import gc
import os
import queue
import re
import subprocess
import sys
import threading
import time
import yaml
import json
from fastapi.responses import StreamingResponse
from loguru import logger
from openedai import OpenAIStub, BadRequestError, ServiceUnavailableError
from pydantic import BaseModel
from typing import Optional
import uvicorn
# Try to import XTTS dependencies (might not be available in minimal installations)
try:
import torch
from TTS.tts.configs.xtts_config import XttsConfig
from TTS.tts.models.xtts import Xtts
from TTS.utils.manage import ModelManager
from TTS.tts.layers.xtts.tokenizer import split_sentence
from langdetect import detect
XTTS_AVAILABLE = True
except ImportError:
XTTS_AVAILABLE = False
torch = None
XttsConfig = None
Xtts = None
ModelManager = None
split_sentence = None
detect = None
# Try to import Qwen3-TTS dependencies
try:
import torch
from qwen_tts import Qwen3TTSModel
QWEN_TTS_AVAILABLE = True
except ImportError:
QWEN_TTS_AVAILABLE = False
if torch is None:
try:
import torch
except ImportError:
torch = None
Qwen3TTSModel = None
# Try to import F5-TTS dependencies (SWivid/F5-TTS, MIT-licensed flow-matching TTS)
try:
import torch
from f5_tts.api import F5TTS
F5_TTS_AVAILABLE = True
except ImportError:
F5_TTS_AVAILABLE = False
if torch is None:
try:
import torch
except ImportError:
torch = None
F5TTS = None
@contextlib.asynccontextmanager
async def lifespan(app):
# Startup: Initialize voice caches in each worker process
global voice_to_model_cache, voices_cache
default_exists('config/pre_process_map.yaml')
default_exists('config/voice_to_speaker.yaml')
# Build voice-to-model cache for fast lookups
with open('config/voice_to_speaker.yaml', 'r', encoding='utf8') as file:
voice_map = yaml.safe_load(file)
for model_id, voices in voice_map.items():
if isinstance(voices, dict):
for voice_name in voices.keys():
# First match wins (for duplicate voice names across models)
if voice_name not in voice_to_model_cache:
voice_to_model_cache[voice_name] = model_id
print(f"Voice-to-model cache initialized with {len(voice_to_model_cache)} voices")
# Build voices cache for /v1/voices endpoint
models_data = []
for model_id, voices in voice_map.items():
if isinstance(voices, dict):
voice_list = list(voices.keys())
model_info = {
"id": model_id,
"object": "model",
"created": 1700000000,
"owned_by": "uncloseai",
"voices": voice_list,
"voice_count": len(voice_list)
}
# Add engine-specific metadata
if model_id == 'tts-1':
model_info["engine"] = "piper"
model_info["description"] = "Fast neural TTS with 100+ voices"
model_info["sample_rate"] = 22050
elif model_id == 'tts-1-hd':
model_info["engine"] = "xtts"
model_info["description"] = "High-quality voice cloning TTS"
model_info["sample_rate"] = 24000
elif model_id == 'tts-1-silero':
model_info["engine"] = "silero"
model_info["description"] = "Fast multilingual TTS (en, ru, de, es, fr)"
model_info["sample_rate"] = 48000
elif model_id == 'tts-1-kokoro':
model_info["engine"] = "kokoro"
model_info["description"] = "Lightweight decoder-only TTS (82M params)"
model_info["sample_rate"] = 24000
elif model_id == 'tts-1-qwen':
model_info["engine"] = "qwen3-tts"
model_info["description"] = "State-of-the-art TTS with voice cloning (1.7B params, 10 languages)"
model_info["sample_rate"] = 24000
elif model_id == 'tts-1-f5':
model_info["engine"] = "f5-tts"
model_info["description"] = "Flow-matching zero-shot voice cloning (336M params, MIT)"
model_info["sample_rate"] = 24000
models_data.append(model_info)
voices_cache = {
"object": "list",
"data": models_data
}
print(f"/v1/voices cache initialized with {len(models_data)} models")
yield
# Shutdown: Cleanup
gc.collect()
try:
import torch
if torch.cuda.is_available():
torch.cuda.empty_cache()
torch.cuda.ipc_collect()
except:
pass
# We return 'mps' but currently XTTS will not work with mps devices as the cuda support is incomplete
def auto_torch_device():
try:
import torch
return 'cuda' if torch.cuda.is_available() else 'mps' if ( torch.backends.mps.is_available() and torch.backends.mps.is_built() ) else 'cpu'
except:
return 'none'
app = OpenAIStub(lifespan=lifespan)
xtts = None
silero_model = None
silero_speakers = {}
kokoro_pipeline = None
kokoro_lang = None
qwen_model = None
qwen_voice_prompts = {} # Cache for voice clone prompts
f5_model = None
# Default args for worker processes (will be overridden in __main__)
class DefaultArgs:
xtts_device = None # Will be set after torch import
use_deepspeed = False
unload_timer = None
log_level = 'INFO'
host = '0.0.0.0'
port = 8000
preload = None
no_cache_speaker = False
args = DefaultArgs()
# Set default device after torch is available (for worker processes)
# Main process will override this in __main__ with argparse
if args.xtts_device is None:
try:
detected_device = auto_torch_device()
args.xtts_device = detected_device
logger.debug(f"Worker process initialized with device: {detected_device}")
except Exception as e:
logger.warning(f"Failed to detect torch device: {e}, falling back to CPU")
args.xtts_device = 'cpu'
# Voice-to-model lookup cache (loaded at startup)
voice_to_model_cache = {}
# Cached voice data for /v1/voices endpoint (loaded at startup)
voices_cache = None
# Semaphores to limit concurrent model loading (prevent thread pool exhaustion)
silero_load_semaphore = asyncio.Semaphore(1) # Only one Silero model load at a time
kokoro_load_semaphore = asyncio.Semaphore(1) # Only one Kokoro model load at a time
qwen_load_semaphore = asyncio.Semaphore(1) # Only one Qwen model load at a time
f5_load_semaphore = asyncio.Semaphore(1) # Only one F5-TTS model load at a time
def unload_model():
import torch, gc
global xtts
if xtts:
logger.info("Unloading model")
xtts.xtts.to('cpu') # this was required to free up GPU memory...
del xtts
xtts = None
gc.collect()
torch.cuda.empty_cache()
torch.cuda.ipc_collect()
class xtts_wrapper():
check_interval: int = 1 # too aggressive?
def __init__(self, model_name, device, model_path=None, unload_timer=None):
self.model_name = model_name
self.unload_timer = unload_timer
self.last_used = time.time()
self.timer = None
self.lock = threading.Lock()
logger.info(f"Loading model {self.model_name} to {device}")
if model_path is None:
model_path = ModelManager().download_model(model_name)[0]
config_path = os.path.join(model_path, 'config.json')
config = XttsConfig()
config.load_json(config_path)
self.xtts = Xtts.init_from_config(config)
self.xtts.load_checkpoint(config, checkpoint_dir=model_path, use_deepspeed=args.use_deepspeed) # XXX there are no prebuilt deepspeed wheels??
self.xtts = self.xtts.to(device=device)
self.xtts.eval()
if self.unload_timer:
logger.info(f"Setting unload timer to {self.unload_timer} seconds")
self.last_used = time.time()
self.check_idle()
def check_idle(self):
with self.lock:
if time.time() - self.last_used >= self.unload_timer:
print("Unloading TTS model due to inactivity")
unload_model()
else:
# Reschedule the check
self.timer = threading.Timer(self.check_interval, self.check_idle)
self.timer.daemon = True
self.timer.start()
def tts(self, text, language, audio_path, **hf_generate_kwargs):
with torch.no_grad():
self.last_used = time.time()
tokens = 0
try:
with self.lock:
logger.debug(f"generating [{language}]: {[text]}")
gpt_cond_latent, speaker_embedding = self.xtts.get_conditioning_latents(audio_path=audio_path) # not worth caching calls, it's < 0.001s after model is loaded
pcm_stream = self.xtts.inference_stream(text, language, gpt_cond_latent, speaker_embedding, **hf_generate_kwargs)
self.last_used = time.time()
while True:
with self.lock:
yield next(pcm_stream).cpu().numpy().tobytes()
self.last_used = time.time()
tokens += 1
except StopIteration:
pass
finally:
logger.debug(f"Generated {tokens} tokens in {time.time() - self.last_used:.2f}s @ {tokens / (time.time() - self.last_used):.2f} T/s")
self.last_used = time.time()
class silero_wrapper():
"""Wrapper for Silero TTS models
Silero torch.hub.load returns: (model, example_text)
The model has a method apply_tts(text, speaker, sample_rate)
"""
def __init__(self, language='en', speaker='v3_en', device='cpu'):
self.language = language
self.speaker = speaker
self.device = device
logger.info(f"Loading Silero model for {language} with speaker {speaker} on {device}")
import torch
try:
# torch.hub.load returns (model, example_text)
self.model, example_text = torch.hub.load(
repo_or_dir='snakers4/silero-models',
model='silero_tts',
language=language,
speaker=speaker,
verbose=False
)
logger.info(f"Model loaded, type: {type(self.model)}")
self.model.to(device) # Move to device (in-place for Silero)
self.sample_rate = 48000 # Silero uses 48kHz
logger.info(f"Successfully loaded Silero {language}/{speaker}, example: {example_text}")
except Exception as e:
logger.error(f"Failed to load Silero model: {e}")
raise
def tts(self, text, speaker_id='lj_16khz'):
"""Generate speech from text"""
import torch
logger.info(f"Silero tts() called: model={self.model}, speaker_id={speaker_id}")
if self.model is None:
raise RuntimeError("Silero model is None - model failed to load")
if not hasattr(self.model, 'apply_tts'):
logger.error(f"Model has no apply_tts method. Model type: {type(self.model)}, dir: {dir(self.model)}")
raise AttributeError(f"Silero model {type(self.model)} has no apply_tts method")
with torch.no_grad():
# Use model's apply_tts method
audio = self.model.apply_tts(
text=text,
speaker=speaker_id,
sample_rate=self.sample_rate
)
# audio is a tensor, convert to numpy float32
return audio.cpu().numpy().tobytes()
class kokoro_wrapper():
"""Wrapper for Kokoro TTS model
Kokoro is a lightweight decoder-only TTS model (82M params)
Output: 24kHz audio
"""
def __init__(self, lang_code='a', device='cpu'):
self.lang_code = lang_code
self.device = device
self.sample_rate = 24000 # Kokoro outputs 24kHz
logger.info(f"Loading Kokoro TTS pipeline for language '{lang_code}' on device '{device}'")
try:
from kokoro import KPipeline
import numpy as np
# KPipeline will use default repo_id if not specified
# Pass device to KPipeline (supports 'cpu' or 'cuda')
self.pipeline = KPipeline(lang_code=lang_code, device=device)
logger.info(f"Successfully loaded Kokoro pipeline for lang={lang_code} on {device}")
except Exception as e:
logger.error(f"Failed to load Kokoro model: {e}")
raise
def tts(self, text, voice='af_heart', speed=1.0):
"""Generate speech from text using Kokoro"""
import numpy as np
logger.info(f"Kokoro tts() called: text length={len(text)}, voice={voice}, speed={speed}")
try:
# Generate audio using Kokoro pipeline
generator = self.pipeline(text, voice=voice, speed=speed)
# Collect all audio chunks
audio_chunks = []
chunk_count = 0
for _, _, audio in generator:
if audio is not None and len(audio) > 0:
audio_chunks.append(audio)
chunk_count += 1
if chunk_count % 10 == 0:
logger.debug(f"Kokoro generated {chunk_count} chunks so far...")
# Concatenate all chunks
if len(audio_chunks) > 0:
full_audio = np.concatenate(audio_chunks)
logger.info(f"Kokoro generation complete: {chunk_count} chunks, {len(full_audio)} samples")
# Convert float32 numpy array to bytes
return full_audio.astype(np.float32).tobytes()
else:
logger.warning("Kokoro generated no audio")
return b''
except Exception as e:
logger.error(f"Kokoro TTS generation failed: {e}")
raise
class qwen3_wrapper():
"""Wrapper for Qwen3-TTS model
Qwen3-TTS is a state-of-the-art TTS with voice cloning:
- 1.7B parameters, 12Hz tokenizer
- 10 languages: zh, en, ja, ko, de, fr, ru, pt, es, it
- 97ms first-packet latency
- 3-second rapid voice cloning
Output: Variable sample rate (typically 24kHz)
"""
def __init__(self, model_name='Qwen/Qwen3-TTS-12Hz-1.7B-Base', device='cuda', dtype=None):
self.model_name = model_name
self.device = device
self.sample_rate = None # Set after first generation
self.voice_prompts = {} # Cache for reusable voice clone prompts
logger.info(f"Loading Qwen3-TTS model '{model_name}' on device '{device}'")
try:
import torch
from qwen_tts import Qwen3TTSModel
# Determine dtype
if dtype is None:
if device == 'cuda' and torch.cuda.is_available():
dtype = torch.bfloat16
else:
dtype = torch.float32
# Try to use flash attention if available
try:
self.model = Qwen3TTSModel.from_pretrained(
model_name,
device_map=device,
dtype=dtype,
attn_implementation="flash_attention_2",
)
logger.info(f"Loaded Qwen3-TTS with FlashAttention 2")
except Exception as fa_error:
logger.warning(f"FlashAttention 2 not available ({fa_error}), using default attention")
self.model = Qwen3TTSModel.from_pretrained(
model_name,
device_map=device,
dtype=dtype,
)
logger.info(f"Successfully loaded Qwen3-TTS model on {device}")
except Exception as e:
logger.error(f"Failed to load Qwen3-TTS model: {e}")
raise
def create_voice_prompt(self, ref_audio, ref_text, x_vector_only_mode=False):
"""Create a reusable voice clone prompt from reference audio/text.
Args:
ref_audio: Path to reference audio file, URL, or (numpy_array, sample_rate) tuple
ref_text: Text spoken in the reference audio
x_vector_only_mode: If True, use only speaker embedding (faster but lower quality)
Returns:
Voice clone prompt items for reuse
"""
logger.info(f"Creating voice clone prompt from ref_audio={ref_audio}, ref_text={ref_text[:50]}...")
return self.model.create_voice_clone_prompt(
ref_audio=ref_audio,
ref_text=ref_text,
x_vector_only_mode=x_vector_only_mode,
)
def tts(self, text, language='English', ref_audio=None, ref_text=None, voice_prompt=None):
"""Generate speech from text using voice cloning.
Args:
text: Text to synthesize (string or list of strings)
language: Language of the text
ref_audio: Path/URL to reference audio (if voice_prompt not provided)
ref_text: Text in reference audio (if voice_prompt not provided)
voice_prompt: Pre-computed voice clone prompt (for efficiency)
Returns:
Audio data as bytes (float32 PCM)
"""
import numpy as np
logger.info(f"Qwen3-TTS generating: text length={len(text)}, language={language}")
try:
if voice_prompt is not None:
# Use pre-computed voice prompt
wavs, sr = self.model.generate_voice_clone(
text=text,
language=language,
voice_clone_prompt=voice_prompt,
)
elif ref_audio is not None and ref_text is not None:
# Generate with inline reference
wavs, sr = self.model.generate_voice_clone(
text=text,
language=language,
ref_audio=ref_audio,
ref_text=ref_text,
)
else:
raise ValueError("Either voice_prompt or (ref_audio + ref_text) must be provided")
self.sample_rate = sr
logger.info(f"Qwen3-TTS generated {len(wavs)} audio segment(s) at {sr}Hz")
# Concatenate all wav segments and convert to bytes
if len(wavs) > 1:
full_audio = np.concatenate(wavs)
else:
full_audio = wavs[0]
return full_audio.astype(np.float32).tobytes()
except Exception as e:
logger.error(f"Qwen3-TTS generation failed: {e}")
raise
class f5_wrapper():
"""Wrapper for F5-TTS model (SWivid/F5-TTS, MIT)
Flow-matching zero-shot voice cloning:
- ~336M params, smaller than Qwen3-TTS (1.7B)
- 24kHz output, matches Qwen3-TTS sample rate
- Reference audio + transcript, no fine-tuning
- No temperature/top_p/top_k — uses cfg_strength + nfe_step instead
"""
def __init__(self, device='cuda'):
self.device = device
self.sample_rate = 24000 # f5_tts.infer.utils_infer.target_sample_rate
logger.info(f"Loading F5-TTS model on device '{device}'")
try:
from f5_tts.api import F5TTS
self.model = F5TTS(device=device)
logger.info(f"Successfully loaded F5-TTS model on {device}")
except Exception as e:
logger.error(f"Failed to load F5-TTS model: {e}")
raise
def tts(self, text, ref_audio, ref_text, speed=1.0, nfe_step=32, cfg_strength=2.0):
"""Generate speech from text using F5-TTS voice cloning.
Args:
text: Text to synthesize
ref_audio: Path to reference audio file
ref_text: Transcript of reference audio
speed: Speed multiplier (1.0 = normal)
nfe_step: Number of ODE steps (32 = default, balance quality/speed)
cfg_strength: Classifier-free guidance strength
Returns:
Audio data as bytes (float32 PCM at 24kHz)
"""
import numpy as np
logger.info(f"F5-TTS generating: text length={len(text)}")
try:
wav, sr, _spec = self.model.infer(
ref_file=ref_audio,
ref_text=ref_text,
gen_text=text,
nfe_step=nfe_step,
cfg_strength=cfg_strength,
speed=speed,
show_info=lambda *a, **k: None,
progress=None,
)
if hasattr(wav, 'detach'):
wav = wav.detach().to('cpu', dtype=torch.float32).numpy()
audio = np.asarray(wav, dtype=np.float32).flatten()
self.sample_rate = sr
logger.info(f"F5-TTS generated {len(audio)} samples at {sr}Hz")
return audio.tobytes()
except Exception as e:
logger.error(f"F5-TTS generation failed: {e}")
raise
def default_exists(filename: str):
if not os.path.exists(filename):
fpath, ext = os.path.splitext(filename)
basename = os.path.basename(fpath)
default = f"{basename}.default{ext}"
logger.info(f"{filename} does not exist, setting defaults from {default}")
with open(default, 'r', encoding='utf8') as from_file:
with open(filename, 'w', encoding='utf8') as to_file:
to_file.write(from_file.read())
# Read pre process map on demand so it can be changed without restarting the server
def preprocess(raw_input):
#logger.debug(f"preprocess: before: {[raw_input]}")
default_exists('config/pre_process_map.yaml')
with open('config/pre_process_map.yaml', 'r', encoding='utf8') as file:
pre_process_map = yaml.safe_load(file)
for a, b in pre_process_map:
raw_input = re.sub(a, b, raw_input)
raw_input = raw_input.strip()
#logger.debug(f"preprocess: after: {[raw_input]}")
return raw_input
def simple_sentence_split(text: str, max_length: int = 500) -> list[str]:
"""Split text into sentences for streaming TTS.
Splits on every sentence boundary (.!?) for immediate streaming.
Long sentences exceeding max_length are split at word boundaries.
"""
# Split on sentence boundaries, keeping the punctuation
parts = re.split(r'([.!?]+\s*)', text)
result = []
for i in range(0, len(parts), 2):
sentence = parts[i].strip()
punct = parts[i+1] if i+1 < len(parts) else ""
if not sentence:
continue
full_sentence = (sentence + punct).strip()
if full_sentence:
result.append(full_sentence)
# Split any sentences that exceed max_length at word boundaries
final_result = []
for sentence in result:
if len(sentence) <= max_length:
final_result.append(sentence)
else:
# Split at word boundaries
words = sentence.split()
chunk = ""
for word in words:
if len(chunk) + len(word) + 1 > max_length:
if chunk:
final_result.append(chunk.strip())
chunk = word
else:
chunk += " " + word if chunk else word
if chunk:
final_result.append(chunk.strip())
return final_result if final_result else [text]
# Auto-detect which model a voice belongs to (uses cached mapping)
def detect_model_from_voice(voice: str) -> str:
"""Find which model supports a given voice name.
Returns the first model that has this voice, or None if not found.
Uses voice_to_model_cache populated at startup for fast lookups.
"""
global voice_to_model_cache
return voice_to_model_cache.get(voice, None)
# Read voice map on demand so it can be changed without restarting the server
def map_voice_to_speaker(voice: str, model: str):
default_exists('config/voice_to_speaker.yaml')
with open('config/voice_to_speaker.yaml', 'r', encoding='utf8') as file:
voice_map = yaml.safe_load(file)
try:
return voice_map[model][voice]
except KeyError as e:
raise BadRequestError(f"Error loading voice: {voice}, KeyError: {e}", param='voice')
class GenerateSpeechRequest(BaseModel):
model: Optional[str] = None # Auto-detected from voice if not provided
input: str
voice: str = "alloy" # alloy, echo, fable, onyx, nova, and shimmer
response_format: str = "mp3" # mp3, opus, aac, flac
speed: float = 1.0 # 0.25 - 4.0
def build_ffmpeg_args(response_format, input_format, sample_rate):
# Convert the output to the desired format using ffmpeg
if input_format == 'WAV':
ffmpeg_args = ["ffmpeg", "-loglevel", "error", "-f", "WAV", "-i", "-"]
else:
ffmpeg_args = ["ffmpeg", "-loglevel", "error", "-f", input_format, "-ar", sample_rate, "-ac", "1", "-i", "-"]
if response_format == "mp3":
ffmpeg_args.extend(["-f", "mp3", "-c:a", "libmp3lame", "-ab", "64k"])
elif response_format == "opus":
ffmpeg_args.extend(["-f", "ogg", "-c:a", "libopus"])
elif response_format == "aac":
ffmpeg_args.extend(["-f", "adts", "-c:a", "aac", "-ab", "64k"])
elif response_format == "flac":
ffmpeg_args.extend(["-f", "flac", "-c:a", "flac"])
elif response_format == "wav":
ffmpeg_args.extend(["-f", "wav", "-c:a", "pcm_s16le"])
elif response_format == "webm":
ffmpeg_args.extend(["-f", "webm", "-c:a", "libopus"])
elif response_format == "pcm": # even though pcm is technically 'raw', we still use ffmpeg to adjust the speed
ffmpeg_args.extend(["-f", "s16le", "-c:a", "pcm_s16le"])
return ffmpeg_args
@app.get("/v1/models")
async def list_models():
"""List all available TTS models (OpenAI-compatible format)"""
# Return minimal OpenAI-compatible model list (no extra fields)
# tts-1-qwen and tts-1-f5 enabled by default
return {
"object": "list",
"data": [
{
"id": "tts-1-qwen",
"object": "model",
"created": 1700000000,
"owned_by": "uncloseai"
},
{
"id": "tts-1-f5",
"object": "model",
"created": 1700000000,
"owned_by": "uncloseai"
}
# Other models disabled by default:
# {
# "id": "tts-1",
# "object": "model",
# "created": 1700000000,
# "owned_by": "uncloseai"
# },
# {
# "id": "tts-1-hd",
# "object": "model",
# "created": 1700000000,
# "owned_by": "uncloseai"
# },
# {
# "id": "tts-1-silero",
# "object": "model",
# "created": 1700000000,
# "owned_by": "uncloseai"
# },
# {
# "id": "tts-1-kokoro",
# "object": "model",
# "created": 1700000000,
# "owned_by": "uncloseai"
# }
]
}
@app.get("/v1/voices")
async def list_voices():
"""List all available voices with model mapping and metadata (extended endpoint)"""
global voices_cache
# Return cached data if available
if voices_cache is not None:
return voices_cache
# This should never happen since cache is populated at startup,
# but provide fallback just in case
logger.warning("/v1/voices called but cache not initialized - loading now")
default_exists('config/voice_to_speaker.yaml')
with open('config/voice_to_speaker.yaml', 'r', encoding='utf8') as file:
voice_map = yaml.safe_load(file)
models_data = []
for model_id, voices in voice_map.items():
if isinstance(voices, dict):
voice_list = list(voices.keys())
# Add model metadata with extended info
model_info = {
"id": model_id,
"object": "model",
"created": 1700000000,
"owned_by": "uncloseai",
"voices": voice_list,
"voice_count": len(voice_list)
}
# Add engine-specific metadata
if model_id == 'tts-1':
model_info["engine"] = "piper"
model_info["description"] = "Fast neural TTS with 100+ voices"
model_info["sample_rate"] = 22050
elif model_id == 'tts-1-hd':
model_info["engine"] = "xtts"
model_info["description"] = "High-quality voice cloning TTS"
model_info["sample_rate"] = 24000
elif model_id == 'tts-1-silero':
model_info["engine"] = "silero"
model_info["description"] = "Fast multilingual TTS (en, ru, de, es, fr)"
model_info["sample_rate"] = 48000
elif model_id == 'tts-1-kokoro':
model_info["engine"] = "kokoro"
model_info["description"] = "Lightweight decoder-only TTS (82M params)"
model_info["sample_rate"] = 24000
elif model_id == 'tts-1-qwen':
model_info["engine"] = "qwen3-tts"
model_info["description"] = "State-of-the-art TTS with voice cloning (1.7B params, 10 languages)"
model_info["sample_rate"] = 24000
elif model_id == 'tts-1-f5':
model_info["engine"] = "f5-tts"
model_info["description"] = "Flow-matching zero-shot voice cloning (336M params, MIT)"
model_info["sample_rate"] = 24000
models_data.append(model_info)
voices_cache = {
"object": "list",
"data": models_data
}
return voices_cache
@app.post("/v1/audio/speech", response_class=StreamingResponse)
async def generate_speech(request: GenerateSpeechRequest):
global xtts, args
if len(request.input) < 1:
raise BadRequestError("Empty Input", param='input')
input_text = preprocess(request.input)
if len(input_text) < 1:
raise BadRequestError("Input text empty after preprocess.", param='input')
model = request.model
voice = request.voice
response_format = request.response_format.lower()
speed = request.speed
# Auto-detect model from voice if model not provided
if model is None:
detected_model = detect_model_from_voice(voice)
if detected_model:
logger.info(f"Auto-detected model '{detected_model}' for voice '{voice}'")
model = detected_model
else:
raise BadRequestError(f"Voice '{voice}' not found in any model. Please specify a model.", param='voice')
# Set the Content-Type header based on the requested format
if response_format == "mp3":
media_type = "audio/mpeg"
elif response_format == "opus":
media_type = "audio/ogg;codec=opus" # codecs?
elif response_format == "aac":
media_type = "audio/aac"
elif response_format == "flac":
media_type = "audio/x-flac"
elif response_format == "wav":
media_type = "audio/wav"
elif response_format == "webm":
media_type = "audio/webm;codecs=opus"
elif response_format == "pcm":
if model == 'tts-1': # piper
media_type = "audio/pcm;rate=22050"
elif model == 'tts-1-hd': # xtts
media_type = "audio/pcm;rate=24000"
elif model == 'tts-1-silero': # silero
media_type = "audio/pcm;rate=48000"
elif model == 'tts-1-kokoro': # kokoro
media_type = "audio/pcm;rate=24000"
elif model == 'tts-1-qwen': # qwen3-tts
media_type = "audio/pcm;rate=24000"
elif model == 'tts-1-f5': # f5-tts
media_type = "audio/pcm;rate=24000"
else:
raise BadRequestError(f"Invalid response_format: '{response_format}'", param='response_format')
ffmpeg_args = None
# Use piper for tts-1, and if xtts_device == none use for all models.
if model == 'tts-1' or args.xtts_device == 'none':
voice_map = map_voice_to_speaker(voice, 'tts-1')
try:
piper_model = voice_map['model']
except KeyError as e:
raise ServiceUnavailableError(f"Configuration error: tts-1 voice '{voice}' is missing 'model:' setting. KeyError: {e}")
speaker = voice_map.get('speaker', None)
# Use absolute path without data-dir when model path is absolute
if os.path.isabs(piper_model):
tts_args = ["piper", "--model", str(piper_model), "--output-raw"]
else:
tts_args = ["piper", "--model", str(piper_model), "--data-dir", "voices", "--download-dir", "voices", "--output-raw"]
if speaker:
tts_args.extend(["--speaker", str(speaker)])
if speed != 1.0:
tts_args.extend(["--length-scale", f"{1.0/speed}"])
# Debug logging
logger.info(f"Piper command: {' '.join(tts_args)}")
logger.info(f"Model file exists: {os.path.exists(piper_model)}")
tts_proc = subprocess.Popen(tts_args, stdin=subprocess.PIPE, stdout=subprocess.PIPE, stderr=subprocess.PIPE)
tts_proc.stdin.write(bytearray(input_text.encode('utf-8')))
tts_proc.stdin.close()
# Log any stderr output from Piper
if tts_proc.stderr:
def log_stderr():
stderr_output = tts_proc.stderr.read().decode('utf-8', errors='replace')
if stderr_output.strip():
logger.error(f"Piper stderr: {stderr_output}")
threading.Thread(target=log_stderr, daemon=True).start()
try:
with open(f"{piper_model}.json", 'r') as pvc_f:
conf = json.load(pvc_f)
sample_rate = str(conf['audio']['sample_rate'])
except:
sample_rate = '22050'
ffmpeg_args = build_ffmpeg_args(response_format, input_format="s16le", sample_rate=sample_rate)
# Pipe the output from piper/xtts to the input of ffmpeg
ffmpeg_args.extend(["-"])
ffmpeg_proc = subprocess.Popen(ffmpeg_args, stdin=tts_proc.stdout, stdout=subprocess.PIPE)
return StreamingResponse(content=ffmpeg_proc.stdout, media_type=media_type)
# Use xtts for tts-1-hd
elif model == 'tts-1-hd':
voice_map = map_voice_to_speaker(voice, 'tts-1-hd')
try:
tts_model = voice_map.pop('model')
speaker = voice_map.pop('speaker')
except KeyError as e:
raise ServiceUnavailableError(f"Configuration error: tts-1-hd voice '{voice}' is missing setting. KeyError: {e}")
if xtts and xtts.model_name != tts_model:
unload_model()
tts_model_path = voice_map.pop('model_path', None) # XXX changing this on the fly is ignored if you keep the same name
if xtts is None:
xtts = xtts_wrapper(tts_model, device=args.xtts_device, model_path=tts_model_path, unload_timer=args.unload_timer)
ffmpeg_args = build_ffmpeg_args(response_format, input_format="f32le", sample_rate="24000")
# tts speed doesn't seem to work well
speed = voice_map.pop('speed', speed)
if speed < 0.5:
speed = speed / 0.5
ffmpeg_args.extend(["-af", "atempo=0.5"])
if speed > 1.0:
ffmpeg_args.extend(["-af", f"atempo={speed}"])
speed = 1.0
# Pipe the output from piper/xtts to the input of ffmpeg
ffmpeg_args.extend(["-"])
language = voice_map.pop('language', 'auto')
if language == 'auto':
try:
language = detect(input_text)
if language not in [
'en', 'es', 'fr', 'de', 'it', 'pt', 'pl', 'tr',
'ru', 'nl', 'cs', 'ar', 'zh-cn', 'hu', 'ko', 'ja', 'hi'
]:
logger.debug(f"Detected language {language} not supported, defaulting to en")
language = 'en'
else:
logger.debug(f"Detected language: {language}")
except:
language = 'en'
logger.debug(f"Failed to detect language, defaulting to en")
comment = voice_map.pop('comment', None) # ignored.
hf_generate_kwargs = dict(
speed=speed,
**voice_map,
)
hf_generate_kwargs['enable_text_splitting'] = hf_generate_kwargs.get('enable_text_splitting', True) # change the default to true
if hf_generate_kwargs['enable_text_splitting']:
if language == 'zh-cn':
split_lang = 'zh'
else:
split_lang = language
all_text = split_sentence(input_text, split_lang, xtts.xtts.tokenizer.char_limits[split_lang])
else:
all_text = [input_text]
ffmpeg_proc = subprocess.Popen(ffmpeg_args, stdin=subprocess.PIPE, stdout=subprocess.PIPE)
in_q = queue.Queue() # speech pcm
ex_q = queue.Queue() # exceptions
def get_speaker_samples(samples: str) -> list[str]:
if os.path.isfile(samples):
audio_path = [samples]
elif os.path.isdir(samples):
audio_path = [os.path.join(samples, sample) for sample in os.listdir(samples) if os.path.isfile(os.path.join(samples, sample))]
if len(audio_path) < 1:
logger.error(f"No files found: {samples}")
raise ServiceUnavailableError(f"Invalid path: {samples}")
else:
logger.error(f"Invalid path: {samples}")
raise ServiceUnavailableError(f"Invalid path: {samples}")
return audio_path
def exception_check(exq: queue.Queue):
try:
e = exq.get_nowait()
except queue.Empty:
return
raise e
def generator():
# text -> in_q
audio_path = get_speaker_samples(speaker)
logger.debug(f"{voice} wav samples: {audio_path}")
try:
for text in all_text:
for chunk in xtts.tts(text=text, language=language, audio_path=audio_path, **hf_generate_kwargs):
exception_check(ex_q)
in_q.put(chunk)
except BrokenPipeError as e: # client disconnect lands here
logger.info("Client disconnected - 'Broken pipe'")
except Exception as e:
logger.error(f"Exception: {repr(e)}")
raise e
finally:
in_q.put(None) # sentinel
def out_writer():
# in_q -> ffmpeg
try:
while True:
chunk = in_q.get()
if chunk is None: # sentinel
break
ffmpeg_proc.stdin.write(chunk) # BrokenPipeError from here on client disconnect
except Exception as e: # BrokenPipeError
ex_q.put(e) # we need to get this exception into the generation loop
ffmpeg_proc.kill()
return
finally:
ffmpeg_proc.stdin.close()
generator_worker = threading.Thread(target=generator, daemon=True)
generator_worker.start()
out_writer_worker = threading.Thread(target=out_writer, daemon=True)
out_writer_worker.start()
def cleanup():
ffmpeg_proc.kill()
# Only delete workers if they were created
try:
del generator_worker
except NameError:
pass
try:
del out_writer_worker
except NameError:
pass
return StreamingResponse(content=ffmpeg_proc.stdout, media_type=media_type, background=cleanup)
# Use Silero for tts-1-silero
elif model == 'tts-1-silero':
global silero_model, silero_speakers
voice_map = map_voice_to_speaker(voice, 'tts-1-silero')
language = voice_map.get('language', 'en')
speaker_id = voice_map.get('speaker', 'en_0')
silero_speaker_key = voice_map.get('silero_speaker', 'v4_en')
# Create a unique key for this language+speaker combination
model_key = f"{language}_{silero_speaker_key}"
# Load Silero model if not already loaded or if language/speaker changed
if silero_model is None or silero_speakers.get('current') != model_key:
# Use semaphore to prevent multiple simultaneous model loads
async with silero_load_semaphore:
# Double-check after acquiring lock (another request may have loaded it)
if silero_model is None or silero_speakers.get('current') != model_key:
logger.info(f"Loading/switching Silero model to {language}/{silero_speaker_key}")
# Run blocking model initialization in thread pool to avoid blocking event loop
silero_model = await asyncio.to_thread(silero_wrapper, language=language, speaker=silero_speaker_key, device='cpu')
silero_speakers['current'] = model_key
# Generate audio (also blocking, so run in thread pool)
audio_data = await asyncio.to_thread(silero_model.tts, input_text, speaker_id=speaker_id)
# Silero outputs float32 PCM at 48000 Hz
ffmpeg_args = build_ffmpeg_args(response_format, input_format="f32le", sample_rate="48000")
# Apply speed adjustment if needed
if speed != 1.0:
ffmpeg_args.extend(["-af", f"atempo={speed}"])
ffmpeg_args.extend(["-"])
ffmpeg_proc = subprocess.Popen(ffmpeg_args, stdin=subprocess.PIPE, stdout=subprocess.PIPE)
ffmpeg_proc.stdin.write(audio_data)
ffmpeg_proc.stdin.close()
return StreamingResponse(content=ffmpeg_proc.stdout, media_type=media_type)
# Use Kokoro for tts-1-kokoro
elif model == 'tts-1-kokoro':
global kokoro_pipeline, kokoro_lang
voice_map = map_voice_to_speaker(voice, 'tts-1-kokoro')
lang_code = voice_map.get('lang_code', 'a')
kokoro_voice = voice_map.get('kokoro_voice', 'af_heart')
# Load Kokoro pipeline if not already loaded or if language changed
if kokoro_pipeline is None or kokoro_lang != lang_code:
# Use semaphore to prevent multiple simultaneous model loads
async with kokoro_load_semaphore:
# Double-check after acquiring lock (another request may have loaded it)
if kokoro_pipeline is None or kokoro_lang != lang_code:
# Run blocking model initialization in thread pool to avoid blocking event loop
# Use GPU if available, fallback to CPU only if explicitly disabled
device = args.xtts_device if args.xtts_device != 'none' else 'cpu'
logger.info(f"Loading/switching Kokoro pipeline to language '{lang_code}' on device '{device}'")
kokoro_pipeline = await asyncio.to_thread(kokoro_wrapper, lang_code=lang_code, device=device)
kokoro_lang = lang_code
# Split long text into sentences for streaming
sentences = simple_sentence_split(input_text, max_length=500)
logger.info(f"Split text into {len(sentences)} sentences for Kokoro streaming")
# Kokoro outputs float32 PCM at 24000 Hz
ffmpeg_args = build_ffmpeg_args(response_format, input_format="f32le", sample_rate="24000")
ffmpeg_args.extend(["-"])
ffmpeg_proc = subprocess.Popen(ffmpeg_args, stdin=subprocess.PIPE, stdout=subprocess.PIPE)
# Use threading approach like XTTS to ensure proper sequential processing
in_q = queue.Queue() # audio chunks
def generator():
"""Process sentences sequentially and feed to queue"""
try:
for idx, sentence in enumerate(sentences):
logger.debug(f"Processing sentence {idx+1}/{len(sentences)}: {len(sentence)} chars")
audio_bytes = kokoro_pipeline.tts(sentence, voice=kokoro_voice, speed=speed)
in_q.put(audio_bytes)
logger.debug(f"Kokoro: queued sentence {idx+1}/{len(sentences)}")
except Exception as e:
logger.error(f"Kokoro streaming error: {e}")
finally:
in_q.put(None) # sentinel
logger.info(f"Kokoro streaming complete: {len(sentences)} sentences processed")
def out_writer():
"""Write audio from queue to ffmpeg stdin"""
try:
while True:
chunk = in_q.get()
if chunk is None: # sentinel
break
ffmpeg_proc.stdin.write(chunk)
except Exception as e:
logger.error(f"Kokoro ffmpeg write error: {e}")
ffmpeg_proc.kill()
finally:
ffmpeg_proc.stdin.close()
generator_worker = threading.Thread(target=generator, daemon=True)
generator_worker.start()
out_writer_worker = threading.Thread(target=out_writer, daemon=True)
out_writer_worker.start()
return StreamingResponse(content=ffmpeg_proc.stdout, media_type=media_type)
# Use Qwen3-TTS for tts-1-qwen
elif model == 'tts-1-qwen':
global qwen_model, qwen_voice_prompts
if not QWEN_TTS_AVAILABLE:
raise ServiceUnavailableError("Qwen3-TTS is not available. Install with: pip install qwen-tts")
voice_map = map_voice_to_speaker(voice, 'tts-1-qwen')
ref_audio = voice_map.get('ref_audio')
ref_text = voice_map.get('ref_text')
language = voice_map.get('language', 'English')
# Load Qwen model if not already loaded
if qwen_model is None:
async with qwen_load_semaphore:
if qwen_model is None:
device = args.xtts_device if args.xtts_device != 'none' else 'cpu'
logger.info(f"Loading Qwen3-TTS model on device '{device}'")
qwen_model = await asyncio.to_thread(
qwen3_wrapper,
model_name='Qwen/Qwen3-TTS-12Hz-1.7B-Base',
device=device
)
# Create or retrieve cached voice prompt
voice_prompt = None
if ref_audio and ref_text:
cache_key = f"{voice}_{ref_audio}"
if cache_key not in qwen_voice_prompts:
logger.info(f"Creating voice prompt for '{voice}'")
qwen_voice_prompts[cache_key] = await asyncio.to_thread(
qwen_model.create_voice_prompt,
ref_audio=ref_audio,
ref_text=ref_text
)
voice_prompt = qwen_voice_prompts[cache_key]
else:
raise BadRequestError(f"Voice '{voice}' requires ref_audio and ref_text configuration", param='voice')
# Split text into sentences for streaming (first audio arrives faster)
sentences = simple_sentence_split(input_text, max_length=500)
logger.info(f"Split text into {len(sentences)} sentences for Qwen streaming")
# Qwen outputs float32 PCM at ~24kHz
ffmpeg_args = build_ffmpeg_args(response_format, input_format="f32le", sample_rate="24000")
# Apply speed adjustment if needed
if speed != 1.0:
ffmpeg_args.extend(["-af", f"atempo={speed}"])
ffmpeg_args.extend(["-"])
ffmpeg_proc = subprocess.Popen(ffmpeg_args, stdin=subprocess.PIPE, stdout=subprocess.PIPE)
# Use queue + threading for sentence-by-sentence streaming
in_q = queue.Queue()
def generator():
"""Process sentences sequentially and feed to queue"""
try:
for idx, sentence in enumerate(sentences):
logger.debug(f"Qwen processing sentence {idx+1}/{len(sentences)}: {len(sentence)} chars")
audio_bytes = qwen_model.tts(
text=sentence,
language=language,
voice_prompt=voice_prompt
)
in_q.put(audio_bytes)
logger.debug(f"Qwen: queued sentence {idx+1}/{len(sentences)}")
except Exception as e:
logger.error(f"Qwen streaming error: {e}")
finally:
in_q.put(None) # sentinel
logger.info(f"Qwen streaming complete: {len(sentences)} sentences processed")
def out_writer():
"""Write audio from queue to ffmpeg stdin"""
try:
while True:
chunk = in_q.get()
if chunk is None: # sentinel
break
ffmpeg_proc.stdin.write(chunk)
except Exception as e:
logger.error(f"Qwen ffmpeg write error: {e}")
ffmpeg_proc.kill()
finally:
ffmpeg_proc.stdin.close()
generator_worker = threading.Thread(target=generator, daemon=True)
generator_worker.start()
out_writer_worker = threading.Thread(target=out_writer, daemon=True)
out_writer_worker.start()
return StreamingResponse(content=ffmpeg_proc.stdout, media_type=media_type)
# Use F5-TTS for tts-1-f5
elif model == 'tts-1-f5':
global f5_model
if not F5_TTS_AVAILABLE:
raise ServiceUnavailableError("F5-TTS is not available. Install with: pip install f5-tts")
voice_map = map_voice_to_speaker(voice, 'tts-1-f5')
ref_audio = voice_map.get('ref_audio')
ref_text = voice_map.get('ref_text')
if not (ref_audio and ref_text):
raise BadRequestError(f"Voice '{voice}' requires ref_audio and ref_text configuration", param='voice')
# Load F5 model if not already loaded
if f5_model is None:
async with f5_load_semaphore:
if f5_model is None:
device = args.xtts_device if args.xtts_device != 'none' else 'cpu'
logger.info(f"Loading F5-TTS model on device '{device}'")
f5_model = await asyncio.to_thread(f5_wrapper, device=device)
# F5-TTS handles long text via internal chunking. Per-sentence splitting
# produces a ref-to-gen transition artifact at the start of EACH chunk
# (audible as gibberish/tinny prefix). Pass full text as one inference.
logger.info(f"F5-TTS processing {len(input_text)} chars as single inference")
# F5-TTS outputs float32 PCM at 24kHz
ffmpeg_args = build_ffmpeg_args(response_format, input_format="f32le", sample_rate="24000")
ffmpeg_args.extend(["-"])
ffmpeg_proc = subprocess.Popen(ffmpeg_args, stdin=subprocess.PIPE, stdout=subprocess.PIPE)
in_q = queue.Queue()
def generator():
"""Run F5-TTS once for the full input text"""
try:
audio_bytes = f5_model.tts(
text=input_text,
ref_audio=ref_audio,
ref_text=ref_text,
speed=speed,
)
in_q.put(audio_bytes)
except Exception as e:
logger.error(f"F5-TTS generation error: {e}")
finally:
in_q.put(None)
logger.info("F5-TTS generation complete")
def out_writer():
"""Write audio from queue to ffmpeg stdin"""
try:
while True:
chunk = in_q.get()
if chunk is None:
break
ffmpeg_proc.stdin.write(chunk)
except Exception as e:
logger.error(f"F5-TTS ffmpeg write error: {e}")
ffmpeg_proc.kill()
finally:
ffmpeg_proc.stdin.close()
generator_worker = threading.Thread(target=generator, daemon=True)
generator_worker.start()
out_writer_worker = threading.Thread(target=out_writer, daemon=True)
out_writer_worker.start()
return StreamingResponse(content=ffmpeg_proc.stdout, media_type=media_type)
else:
raise BadRequestError("No such model, must be tts-1-qwen (default), tts-1-f5, tts-1, tts-1-hd, tts-1-silero, or tts-1-kokoro.", param='model')
if __name__ == "__main__":
parser = argparse.ArgumentParser(
description='uncloseai-speech API Server',
formatter_class=argparse.ArgumentDefaultsHelpFormatter)
parser.add_argument('--xtts_device', action='store', default=auto_torch_device(), help="Set the device for the xtts model. The special value of 'none' will use piper for all models.")
parser.add_argument('--preload', action='store', default=None, help="Preload a model (Ex. 'xtts' or 'xtts_v2.0.2'). By default it's loaded on first use.")
parser.add_argument('--unload-timer', action='store', default=None, type=int, help="Idle unload timer for the XTTS model in seconds, Ex. 900 for 15 minutes")
parser.add_argument('--use-deepspeed', action='store_true', default=False, help="Use deepspeed with xtts (this option is unsupported)")
parser.add_argument('--no-cache-speaker', action='store_true', default=False, help="Don't use the speaker wav embeddings cache")
parser.add_argument('-W', '--workers', action='store', default=4, type=int, help="Number of uvicorn worker processes for concurrent request handling")
parser.add_argument('-P', '--port', action='store', default=8000, type=int, help="Server tcp port")
parser.add_argument('-H', '--host', action='store', default='0.0.0.0', help="Host to listen on, Ex. 0.0.0.0")
parser.add_argument('-L', '--log-level', default="INFO", choices=["DEBUG", "INFO", "WARNING", "ERROR", "CRITICAL"], help="Set the log level")
args = parser.parse_args()
logger.remove()
logger.add(sink=sys.stderr, level=args.log_level)
if args.preload and not XTTS_AVAILABLE:
logger.error("Cannot preload XTTS model - XTTS dependencies not available")
elif args.preload:
xtts = xtts_wrapper(args.preload, device=args.xtts_device, unload_timer=args.unload_timer)
# Register Qwen + F5 by default (other models disabled)
app.register_model('tts-1-qwen')
app.register_model('tts-1-f5')
# To enable other models, uncomment below:
# app.register_model('tts-1')
# app.register_model('tts-1-hd')
# app.register_model('tts-1-silero')
# app.register_model('tts-1-kokoro')
# Use multiple workers for true concurrency (each worker = separate process with own GIL)
# This prevents thread pool exhaustion and allows concurrent model loading
# Must use import string format for workers to function
uvicorn.run("speech:app", host=args.host, port=args.port, workers=args.workers, timeout_keep_alive=300)