Source Code Deployment (MacOS/Linux/Windows)

We recommend using uv for installation. If you don't have uv yet, see the official installation guide

Windows users can also check this guide to install uv and ffmpeg

---

1. Prerequisites

macOS — Install the required libraries:

brew install libsndfile
brew install ffmpeg
brew install git
brew install python@3.10

Linux — Install ffmpeg>=6:

sudo yum install -y ffmpeg
# or
sudo apt-get install ffmpeg

Windows — Download ffmpeg>=6 and place ffmpeg.exe and ffprobe.exe in the code directory/ffmpeg folder. Download address: https://www.gyan.dev/ffmpeg/builds/ffmpeg-release-full.7z

---

2. Clone the Repository

Create a folder without spaces or Chinese characters, then run:

git clone https://github.com/jianchang512/pyvideotrans
cd pyvideotrans

Alternatively, go to https://github.com/jianchang512/pyvideotrans, click the green Code button to download the source code, extract it, and navigate to the directory containing sp.py.

---

3. Install Dependencies

uv sync

This may take several minutes depending on your network. Users in mainland China can use a mirror for faster installation:

uv sync --index https://mirrors.aliyun.com/pypi/simple/

Optional extras:

Command	What it installs
uv sync --all-extra	All optional channels + WebUI
uv sync --extra qwentts	Qwen-TTS only
uv sync --extra qwenasr	Qwen-ASR only
uv sync --extra mosstts	MOSS-TTS only
uv sync --extra chatterbox	ChatterBox only
uv sync --extra webui	WebUI interface only

---

4. Launch

Desktop GUI:

uv run sp.py

WebUI (browser-based):

uv run webui.py