debpalash / voicestudio

# Latest Electron release
curl -fsSL https://voicestudio.sh/install | sh

# A specific published Electron release (replace X.Y.Z)
curl -fsSL https://voicestudio.sh/install | sh -s -- --version X.Y.Z

# Build current main and install the desktop app
curl -fsSL https://voicestudio.sh/install | sh -s -- --main

# Uninstall the app, keeping your data
curl -fsSL https://voicestudio.sh/install | sh -s -- --uninstall

On Windows, run irm https://voicestudio.sh/install | iex in PowerShell.

If voicestudio.sh/install is unreachable or returns 404, run the same script straight from the repository, or clone it and run scripts/install.sh:

curl -fsSL https://raw.githubusercontent.com/debpalash/VoiceStudio/main/scripts/install.sh | sh

Release downloads require curl and a SHA-256 tool. --main requires Git, Node.js 22+, Bun, Rust/Cargo, and platform build tools; see installer prerequisites and behavior. The installer preserves your settings, projects, and models. Older versions must contain Electron packages; it never falls back to archived Tauri builds.

Or download from Releases (macOS .dmg, Windows .exe, Linux .AppImage or .deb) and follow your platform guide:

macOS · Windows · Linux · Docker

| Hardware | Support | |---|---| | NVIDIA GPU (Windows / Linux) | CUDA acceleration | | Apple Silicon | Metal (MPS) acceleration | | No dedicated GPU (Intel/AMD integrated graphics, older PCs) | Fully usable on the CPU, slower; setup installs the small CPU build of PyTorch (about 5 GB free disk) | | Windows on ARM (Snapdragon X etc.) | Experimental, validation pending: native ARM64 app, x64 Python backend under emulation, CPU only | | Intel Mac | App UI only; connect to a remote backend (why) |

Open Voice cloning, choose a voice or add a clean reference recording, enter your text, and generate. Install the required model when prompted. Hardware needs vary by engine; see performance.

Prerequisites

• Git
• curl (used by the Bun / uv / rustup install one-liners on macOS and Linux)
• Bun (frontend package manager)
• uv (Python environment manager)
• ffmpeg (audio/video processing)
• Rust / Cargo (native/desktop-bridge and its imported Rust modules)
• Python 3.11+ (requires-python in pyproject.toml; managed automatically by uv)

Linux desktop development needs the native helper libraries. On Debian or Ubuntu, install the same packages used by CI:

sudo apt-get update
sudo apt-get install -y \
  libasound2-dev libxdo-dev libxtst-dev libx11-dev libxkbcommon-dev \
  libwayland-dev libssl-dev pkg-config build-essential curl

See the Linux source-build guide for Fedora and Arch packages.

Clone & Run

git clone https://github.com/debpalash/VoiceStudio.git
cd VoiceStudio
bun install
bun run setup:api  # prepare Python dependencies before starting Electron
bun run dev

This launches Electron with hot reload. Run source dependency setup explicitly before launching; the supervisor manages backend startup; do not launch a second backend. See Electron setup. CPU-only Linux/Windows hosts automatically select CPU wheels; see CPU setup and overrides. When regenerating uv.lock for compute variants, preserve unrelated package versions: NumPy remains 2.0.2 on Python 3.12 Linux/Windows and 2.2.6 elsewhere. Validate both frozen CPU/CUDA exports with tests/test_cpu_install.py; a NumPy upgrade needs its own compatibility review.