Install PaddleSpeech

Install PaddleSpeech in a dedicated virtual environment because PaddlePaddle, audio libraries, and model packages have strict version requirements.

python -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip setuptools wheel

Install the PaddlePaddle build that matches the operating system, Python version, CPU or GPU, CUDA, and cuDNN environment. Then install PaddleSpeech:

pip install paddlespeech

Verify the installation with a small command or Python import before downloading large models:

python -c "import paddle; import paddlespeech; print(paddle.__version__)"

When installation fails, capture the complete pip resolver output, Python version, architecture, GPU driver, and CUDA versions. Avoid mixing Conda and system packages unpredictably. Model downloads may require substantial disk space, and audio features may require FFmpeg, PortAudio, or system codec libraries.