py-speech-gen 0.2.0

A Python library for generating synthetic speech datasets using TTS providers.

py-speech-gen

A Python library for generating synthetic speech datasets using TTS providers. Supports ElevenLabs, Piper TTS, and Google Cloud TTS out of the box, with an extensible provider system for adding custom backends.

Features

• Multi-provider support — ElevenLabs, Piper TTS, or your own custom provider
• Text preprocessing — cleaning, normalization, number-to-words, sentence segmentation
• Parameter randomization — per-sample variation for voice diversity
• Background noise injection — 8 synthetic noise types (white, pink, brown, traffic, cafe, home, crowd, mic)
• Flexible output formats — WAV, MP3, FLAC at configurable sample rates
• Reproducible generation — export/load configs for deterministic datasets
• Export options — JSON, CSV, pandas DataFrame

Installation

Basic install (core features only)

pip install py-speech-gen

The base installation includes text processing, dataset management, randomization, and noise mixing.

Install with TTS providers

# Piper TTS (local, offline)
pip install "py-speech-gen[piper]"

# ElevenLabs (cloud API)
pip install "py-speech-gen[elevenlabs]"

# Google Cloud TTS (cloud API)
pip install "py-speech-gen[googlecloud]"

# All providers
pip install "py-speech-gen[all]"

Requirements

• Python 3.11+
• For Piper TTS: ONNX Runtime (GPU or CPU variant)
• For ElevenLabs: valid API key
• For Google Cloud TTS: Google Cloud credentials and enabled Text-to-Speech API

Documentation

• Usage Guide — Quick start, examples, presets, and detailed API reference
• Create a Provider — Step-by-step guide to adding custom TTS providers
• Provider Documentation — Each provider has its own docs:
  • Piper TTS — local, offline TTS
  • ElevenLabs — cloud API with natural voices
  • Google Cloud TTS — cloud API with 40+ languages

Key Components

Component	Description
Providers	TTS backends (PiperProvider, ElevenLabsProvider, GoogleCloudProvider) implementing BaseProvider
DatasetGenerator	Orchestrator that manages generation across multiple providers
Dataset	Data model with save/load/export (JSON, CSV, pandas)
TextProcessor	Text cleaning, normalization, number-to-words, sentence segmentation
Randomizer	Per-sample parameter randomization for voice diversity
NoiseMixer	Background noise injection for realistic conditions

Running Tests

pip install "py-speech-gen[dev]"
pytest tests/ -v

License

MIT License — see LICENSE file for details.