fix: address review feedback — race condition, GPU safety, task GC

- Add threading lock to get_tts_backend_for_engine() to prevent race
  condition where concurrent requests could create duplicate backend
  instances (double-checked locking pattern)
- Fix LuxTTS generate: call .detach().cpu() before .numpy() so it
  works on GPU/MPS devices, not just CPU
- Store background download tasks in a module-level set to prevent
  garbage collection before completion (asyncio.create_task fire-and-
  forget pattern)
- Deduplicate cache_key computation in LuxTTS create_voice_prompt
- Prefix unused sr variable with underscore

.dockerignore

@@ -1,55 +0,0 @@
-# Dependencies
-node_modules/
-__pycache__/
-*.pyc
-*.pyo
-*.pyd
-.Python
-env/
-venv/
-
-# Build outputs
-build/
-*.egg-info/
-.eggs/
-target/
-
-# Keep web/dist for the Docker image
-!web/dist
-
-# Development
-.git/
-.github/
-.vscode/
-.idea/
-*.swp
-*.swo
-*~
-
-# Data and logs
-data/
-*.log
-*.sqlite
-*.db
-
-# OS
-.DS_Store
-Thumbs.db
-
-# Documentation
-docs/
-landing/
-mlx-test/
-
-# Test files
-*.test.ts
-*.test.tsx
-*.spec.ts
-*.spec.tsx
-
-# Keep these out
-.env
-.env.local
-*.pem
-*.key
-credentials.json

.github/workflows/build-cuda.yml

@@ -0,0 +1,73 @@
+name: Build CUDA Backend
+
+on:
+  workflow_dispatch:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  build-cuda-windows:
+    runs-on: windows-latest
+    permissions:
+      contents: write
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+          cache: "pip"
+
+      - name: Install Python dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install pyinstaller
+          pip install -r backend/requirements.txt
+
+      - name: Install PyTorch with CUDA 12.1
+        run: |
+          pip install torch --index-url https://download.pytorch.org/whl/cu121 --force-reinstall --no-deps
+          pip install torchaudio --index-url https://download.pytorch.org/whl/cu121
+
+      - name: Verify CUDA support in torch
+        run: |
+          python -c "import torch; print(f'CUDA available in build: {torch.cuda.is_available()}'); print(f'CUDA version: {torch.version.cuda}')"
+
+      - name: Build CUDA server binary
+        shell: bash
+        working-directory: backend
+        run: python build_binary.py --cuda
+
+      - name: Split binary for GitHub Releases
+        shell: bash
+        run: |
+          python scripts/split_binary.py \
+            backend/dist/voicebox-server-cuda.exe \
+            --output release-assets/
+
+      - name: Upload split parts to GitHub Release
+        if: startsWith(github.ref, 'refs/tags/')
+        uses: softprops/action-gh-release@v1
+        with:
+          files: |
+            release-assets/voicebox-server-cuda.part*.exe
+            release-assets/voicebox-server-cuda.sha256
+            release-assets/voicebox-server-cuda.manifest
+          draft: true
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Upload binary as workflow artifact (for testing)
+        uses: actions/upload-artifact@v4
+        with:
+          name: voicebox-server-cuda-windows
+          path: backend/dist/voicebox-server-cuda.exe
+          retention-days: 7
+
+  # Linux CUDA build can be added later with:
+  # build-cuda-linux:
+  #   runs-on: ubuntu-22.04
+  #   ...

.github/workflows/build-windows.yml

@@ -0,0 +1,63 @@
+name: Build Windows
+
+on:
+  workflow_dispatch:
+
+jobs:
+  build-windows:
+    permissions:
+      contents: write
+    runs-on: windows-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+          cache: "pip"
+
+      - name: Install Python dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install pyinstaller
+          pip install -r backend/requirements.txt
+
+      - name: Build Python server
+        shell: bash
+        run: |
+          cd backend
+          python build_binary.py
+
+          PLATFORM=$(rustc --print host-tuple)
+          mkdir -p ../tauri/src-tauri/binaries
+          cp dist/voicebox-server.exe ../tauri/src-tauri/binaries/voicebox-server-${PLATFORM}.exe
+          echo "Built voicebox-server-${PLATFORM}.exe"
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
+
+      - name: Install Rust stable
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Rust cache
+        uses: swatinem/rust-cache@v2
+        with:
+          workspaces: "./tauri/src-tauri -> target"
+
+      - name: Install dependencies
+        run: bun install
+
+      - uses: tauri-apps/tauri-action@v0
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          projectPath: tauri
+          tagName: v__VERSION__
+          releaseName: "voicebox v__VERSION__ (test build)"
+          releaseBody: "Test build for audio export fix"
+          releaseDraft: true
+          prerelease: true
+          args: ""
+          includeUpdaterJson: false

.github/workflows/release.yml

@@ -6,151 +6,7 @@ on:
     tags:
       - "v*"
 
-env:
-  PROVIDER_VERSION: "1.0.0"
-
 jobs:
-  # ============================================
-  # Build TTS Providers (uploaded to R2, not GitHub)
-  # ============================================
-  build-providers:
-    runs-on: ${{ matrix.platform }}
-    strategy:
-      fail-fast: false
-      matrix:
-        include:
-          # PyTorch CPU provider (Windows)
-          - platform: "windows-latest"
-            provider: "pytorch-cpu"
-            python-version: "3.12"
-          # PyTorch CUDA provider (Windows) - large binary, uploaded to R2
-          - platform: "windows-latest"
-            provider: "pytorch-cuda"
-            python-version: "3.12"
-          # PyTorch CPU provider (Linux)
-          - platform: "ubuntu-22.04"
-            provider: "pytorch-cpu"
-            python-version: "3.12"
-          # PyTorch CUDA provider (Linux) - large binary, uploaded to R2
-          - platform: "ubuntu-22.04"
-            provider: "pytorch-cuda"
-            python-version: "3.12"
-          # PyTorch CPU provider (macOS Apple Silicon)
-          - platform: "macos-latest"
-            provider: "pytorch-cpu"
-            python-version: "3.12"
-          # PyTorch CPU provider (macOS Intel)
-          - platform: "macos-15-intel"
-            provider: "pytorch-cpu"
-            python-version: "3.12"
-
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Install dependencies (ubuntu only)
-        if: matrix.platform == 'ubuntu-22.04'
-        run: |
-          sudo apt-get update
-          sudo apt-get install -y llvm-dev
-
-      - name: Setup Python
-        uses: actions/setup-python@v5
-        with:
-          python-version: ${{ matrix.python-version }}
-          cache: "pip"
-
-      - name: Install CPU-only torch (Linux)
-        if: matrix.provider == 'pytorch-cpu' && matrix.platform == 'ubuntu-22.04'
-        run: |
-          python -m pip install --upgrade pip
-          pip install pyinstaller
-          pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cpu
-          pip install -r providers/pytorch-cpu/requirements.txt
-          pip install -r backend/requirements.txt
-
-      - name: Install Python dependencies (CPU - non-Linux)
-        if: matrix.provider == 'pytorch-cpu' && matrix.platform != 'ubuntu-22.04'
-        run: |
-          python -m pip install --upgrade pip
-          pip install pyinstaller
-          pip install -r providers/pytorch-cpu/requirements.txt
-          pip install -r backend/requirements.txt
-
-      - name: Install Python dependencies (CUDA)
-        if: matrix.provider == 'pytorch-cuda'
-        run: |
-          python -m pip install --upgrade pip
-          pip install pyinstaller
-          pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu121
-          pip install -r providers/pytorch-cuda/requirements.txt
-          pip install -r backend/requirements.txt
-
-      - name: Build provider binary
-        shell: bash
-        run: |
-          cd providers/${{ matrix.provider }}
-          python build.py
-
-      - name: Package provider for distribution
-        shell: bash
-        run: |
-          cd providers/${{ matrix.provider }}/dist
-
-          # Add platform suffix for archive name
-          if [ "${{ matrix.platform }}" == "windows-latest" ]; then
-            ARCHIVE_NAME="tts-provider-${{ matrix.provider }}-windows.zip"
-            # On Windows, zip the directory
-            powershell Compress-Archive -Path "tts-provider-${{ matrix.provider }}/*" -DestinationPath "$ARCHIVE_NAME"
-          elif [ "${{ matrix.platform }}" == "macos-latest" ]; then
-            ARCHIVE_NAME="tts-provider-${{ matrix.provider }}-macos-arm64.tar.gz"
-            tar -czf "$ARCHIVE_NAME" tts-provider-${{ matrix.provider }}/
-          elif [ "${{ matrix.platform }}" == "macos-15-intel" ]; then
-            ARCHIVE_NAME="tts-provider-${{ matrix.provider }}-macos-x64.tar.gz"
-            tar -czf "$ARCHIVE_NAME" tts-provider-${{ matrix.provider }}/
-          else
-            ARCHIVE_NAME="tts-provider-${{ matrix.provider }}-linux.tar.gz"
-            tar -czf "$ARCHIVE_NAME" tts-provider-${{ matrix.provider }}/
-          fi
-
-          echo "Created archive: $ARCHIVE_NAME"
-          ls -lh "$ARCHIVE_NAME"
-
-      - name: Upload provider to R2
-        shell: bash
-        env:
-          R2_ACCESS_KEY_ID: ${{ secrets.R2_ACCESS_KEY_ID }}
-          R2_SECRET_ACCESS_KEY: ${{ secrets.R2_SECRET_ACCESS_KEY }}
-          R2_ENDPOINT: ${{ secrets.R2_ENDPOINT }}
-        run: |
-          # Install AWS CLI (compatible with R2)
-          pip install awscli
-
-          # Configure AWS CLI for R2
-          aws configure set aws_access_key_id $R2_ACCESS_KEY_ID
-          aws configure set aws_secret_access_key $R2_SECRET_ACCESS_KEY
-          aws configure set region auto
-
-          # Determine archive name based on platform
-          if [ "${{ matrix.platform }}" == "windows-latest" ]; then
-            ARCHIVE_NAME="tts-provider-${{ matrix.provider }}-windows.zip"
-          elif [ "${{ matrix.platform }}" == "macos-latest" ]; then
-            ARCHIVE_NAME="tts-provider-${{ matrix.provider }}-macos-arm64.tar.gz"
-          elif [ "${{ matrix.platform }}" == "macos-15-intel" ]; then
-            ARCHIVE_NAME="tts-provider-${{ matrix.provider }}-macos-x64.tar.gz"
-          else
-            ARCHIVE_NAME="tts-provider-${{ matrix.provider }}-linux.tar.gz"
-          fi
-
-          # Upload to R2 (bucket: voicebox)
-          aws s3 cp "providers/${{ matrix.provider }}/dist/$ARCHIVE_NAME" \
-            "s3://voicebox/providers/v${{ env.PROVIDER_VERSION }}/$ARCHIVE_NAME" \
-            --endpoint-url "$R2_ENDPOINT"
-
-          echo "Uploaded $ARCHIVE_NAME to R2"
-
-  # ============================================
-  # Build Main App (without bundled TTS on Win/Linux)
-  # ============================================
   release:
     permissions:
       contents: write
@@ -158,22 +14,18 @@ jobs:
       fail-fast: false
       matrix:
         include:
-          # macOS Apple Silicon - MLX bundled (works out of the box)
           - platform: "macos-latest"
             args: "--target aarch64-apple-darwin"
             python-version: "3.12"
             backend: "mlx"
-          # macOS Intel - PyTorch bundled (smaller user base, keep simple)
           - platform: "macos-15-intel"
             args: "--target x86_64-apple-darwin"
             python-version: "3.12"
             backend: "pytorch"
-          # Linux - No TTS bundled, providers downloaded separately
-          - platform: "ubuntu-22.04"
-            args: ""
-            python-version: "3.12"
-            backend: "none"
-          # Windows - PyTorch CPU bundled (works out of the box)
+          # - platform: 'ubuntu-22.04'
+          #   args: ''
+          #   python-version: '3.12'
+          #   backend: 'pytorch'
           - platform: "windows-latest"
             args: ""
             python-version: "3.12"
@@ -188,7 +40,7 @@ jobs:
         if: matrix.platform == 'ubuntu-22.04'
         run: |
           sudo apt-get update
-          sudo apt-get install -y libwebkit2gtk-4.1-dev libappindicator3-dev librsvg2-dev patchelf llvm-dev libasound2-dev
+          sudo apt-get install -y libwebkit2gtk-4.1-dev libappindicator3-dev librsvg2-dev patchelf llvm-dev
 
       - name: Install LLVM (macOS)
         if: matrix.platform == 'macos-latest' || matrix.platform == 'macos-15-intel'
@@ -203,27 +55,23 @@ jobs:
           python-version: ${{ matrix.python-version }}
           cache: "pip"
 
-      - name: Install Python dependencies (with TTS)
-        if: matrix.backend != 'none'
+      - name: Install Python dependencies
         run: |
           python -m pip install --upgrade pip
           pip install pyinstaller
           pip install -r backend/requirements.txt
 
-      - name: Install Python dependencies (without TTS)
-        if: matrix.backend == 'none'
-        run: |
-          python -m pip install --upgrade pip
-          pip install pyinstaller
-          # Install base requirements without PyTorch/Qwen-TTS
-          pip install fastapi uvicorn sqlalchemy librosa soundfile numpy httpx
-          pip install huggingface_hub  # For Whisper downloads
-
       - name: Install MLX dependencies (Apple Silicon only)
         if: matrix.backend == 'mlx'
         run: |
           pip install -r backend/requirements-mlx.txt
 
+      # - name: Install PyTorch with CUDA (Windows only)
+      #   if: matrix.platform == 'windows-latest'
+      #   run: |
+      #     pip install torch --index-url https://download.pytorch.org/whl/cu121 --force-reinstall --no-deps
+      #     pip install torchvision torchaudio --index-url https://download.pytorch.org/whl/cu121
+
       - name: Build Python server (Linux/macOS)
         if: matrix.platform != 'windows-latest'
         run: |
@@ -300,84 +148,13 @@ jobs:
             See the assets below to download and install this version.
 
             ### Installation
-            - **macOS (Apple Silicon)**: Download the `aarch64.dmg` file - uses MLX for fast native inference (works out of the box)
+            - **macOS (Apple Silicon)**: Download the `aarch64.dmg` file - uses MLX for fast native inference
             - **macOS (Intel)**: Download the `x64.dmg` file - uses PyTorch
-            - **Windows**: Download the `.msi` installer - requires downloading a TTS provider on first use
-            - **Linux**: Download the `.AppImage` or `.deb` package - requires downloading a TTS provider on first use
-
-            ### TTS Providers
-            Windows and Linux users will be prompted to download a TTS provider on first launch:
-            - **Windows**: PyTorch CPU (~300MB) or PyTorch CUDA (~2.4GB for NVIDIA GPUs)
-            - **Linux**: PyTorch CUDA (~2.4GB) - requires NVIDIA GPU
+            - **Windows**: Download the `.msi` installer
+            - **Linux**: Download the `.AppImage` or `.deb` package
 
             The app includes automatic updates - future updates will be installed automatically.
           releaseDraft: true
           prerelease: false
           args: ${{ matrix.args }}
           includeUpdaterJson: true
-
-  # ============================================
-  # Build and Push Docker Images
-  # ============================================
-  docker:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-      packages: write
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@v3
-
-      - name: Login to GitHub Container Registry
-        uses: docker/login-action@v3
-        with:
-          registry: ghcr.io
-          username: ${{ github.actor }}
-          password: ${{ secrets.GITHUB_TOKEN }}
-
-      - name: Setup Bun
-        uses: oven-sh/setup-bun@v2
-
-      - name: Install dependencies and build web UI
-        run: |
-          bun install
-          cd web
-          bun run build
-
-      - name: Extract version from tag
-        id: version
-        run: |
-          if [[ $GITHUB_REF == refs/tags/v* ]]; then
-            VERSION=${GITHUB_REF#refs/tags/v}
-          else
-            VERSION="dev"
-          fi
-          echo "version=$VERSION" >> $GITHUB_OUTPUT
-
-      - name: Build and push CPU image
-        uses: docker/build-push-action@v5
-        with:
-          context: .
-          file: ./Dockerfile
-          platforms: linux/amd64,linux/arm64
-          push: true
-          tags: |
-            ghcr.io/jamiepine/voicebox:latest
-            ghcr.io/jamiepine/voicebox:${{ steps.version.outputs.version }}
-          cache-from: type=gha
-          cache-to: type=gha,mode=max
-
-      - name: Build and push CUDA image
-        uses: docker/build-push-action@v5
-        with:
-          context: .
-          file: ./Dockerfile.cuda
-          platforms: linux/amd64
-          push: true
-          tags: |
-            ghcr.io/jamiepine/voicebox:latest-cuda
-            ghcr.io/jamiepine/voicebox:${{ steps.version.outputs.version }}-cuda
-          cache-from: type=gha
-          cache-to: type=gha,mode=max

.gitignore

@@ -15,7 +15,6 @@ dist/
 build/
 *.egg-info/
 *.egg
-*.spec
 target/
 *.app
 *.dmg

CONTRIBUTING.md

@@ -14,19 +14,16 @@ Thank you for your interest in contributing to Voicebox! This document provides
 ### Prerequisites
 
 - **[Bun](https://bun.sh)** - Fast JavaScript runtime and package manager
-
   ```bash
   curl -fsSL https://bun.sh/install | bash
   ```
 
 - **[Python 3.11+](https://python.org)** - For backend development
-
   ```bash
   python --version  # Should be 3.11 or higher
   ```
 
 - **[Rust](https://rustup.rs)** - For Tauri desktop app (installed automatically by Tauri CLI)
-
   ```bash
   rustc --version  # Check if installed
   ```
@@ -35,51 +32,65 @@ Thank you for your interest in contributing to Voicebox! This document provides
 
 ### Development Setup
 
-**Using the Makefile (recommended for macOS/Linux):** Run `make setup` to install all dependencies, then `make dev` to start development servers. See `make help` for all available commands.
+**Using `just` (recommended):**
+
+Install [just](https://github.com/casey/just) (`brew install just` or `cargo install just`), then:
+
+```bash
+just setup   # creates venv, installs Python + JS deps
+just dev     # starts backend + desktop app in one terminal
+```
+
+Other useful commands:
+
+```bash
+just dev-web       # backend + web app (no Tauri/Rust build)
+just dev-backend   # backend only
+just kill          # stop all dev processes
+just clean-all     # nuke everything and start fresh
+just --list        # see all available commands
+```
+
+**Using the Makefile:** Run `make setup` then `make dev`. See `make help` for all commands.
 
 **Manual setup (required for Windows):**
 
 1. **Fork and clone the repository**
-
    ```bash
    git clone https://github.com/YOUR_USERNAME/voicebox.git
    cd voicebox
    ```
 
 2. **Install JavaScript dependencies**
-
    ```bash
    bun install
    ```
-
    This installs dependencies for:
-
    - `app/` - Shared React frontend
    - `tauri/` - Tauri desktop wrapper
    - `web/` - Web deployment wrapper
 
 3. **Set up Python backend**
-
    ```bash
    cd backend
-
+   
    # Create virtual environment
    python -m venv venv
-
+   
    # Activate virtual environment
    source venv/bin/activate  # On macOS/Linux
    # or
    venv\Scripts\activate  # On Windows
-
+   
    # Install Python dependencies
    pip install -r requirements.txt
-
+   
    # Install MLX dependencies (Apple Silicon only - for faster inference)
    # On Apple Silicon, this enables native Metal acceleration
    if [[ $(uname -m) == "arm64" ]]; then
      pip install -r requirements-mlx.txt
    fi
-
+   
    # Install Qwen3-TTS (required for voice synthesis)
    pip install git+https://github.com/QwenLM/Qwen3-TTS.git
    ```
@@ -89,24 +100,19 @@ Thank you for your interest in contributing to Voicebox! This document provides
    Development requires two terminals: one for the Python backend, one for the Tauri app.
 
    **Terminal 1: Backend server** (start this first)
-
    ```bash
    cd backend
    source venv/bin/activate  # Activate venv if not already active
    bun run dev:server
    # Or manually: uvicorn main:app --reload --port 17493
    ```
-
    Backend will be available at `http://localhost:17493`
 
    **Terminal 2: Desktop app**
-
    ```bash
    bun run dev
    ```
-
    This will:
-
    - Create a placeholder sidecar binary (for Tauri compilation)
    - Start Vite dev server on port 5173
    - Launch Tauri window pointing to localhost:5173
@@ -117,133 +123,26 @@ Thank you for your interest in contributing to Voicebox! This document provides
    > The bundled server binary is only used in production builds.
 
    **Optional: Web app**
-
    ```bash
    bun run dev:web
    ```
-
    Web app will be available at `http://localhost:5174`
 
 ### Model Downloads
 
 Models are automatically downloaded from HuggingFace Hub on first use:
-
 - **Whisper** (transcription): Auto-downloads on first transcription
 - **Qwen3-TTS** (voice cloning): Auto-downloads on first generation (~2-4GB)
 
 First-time usage will be slower due to model downloads, but subsequent runs will use cached models.
 
-### TTS Provider Development
-
-Voicebox uses a modular provider system to support different inference backends. Understanding this architecture is important when working on TTS features.
-
-#### Provider Types
-
-**Bundled Providers** — Included with the app binary:
-
-- `apple-mlx` — Bundled with macOS Apple Silicon builds (`.dmg` for aarch64)
-  - Uses MLX for native Metal acceleration
-  - Configured in `.github/workflows/release.yml` with `backend: "mlx"`
-
-**Hybrid Provider:**
-
-- `pytorch-cpu` — Can be bundled OR downloaded depending on platform
-  - **Bundled** with Windows and macOS Intel builds
-    - macOS Intel: `.dmg` for x64 with `backend: "pytorch"`
-    - Windows: `.exe` installer with PyTorch CPU included
-  - **Downloaded** on first use for Linux builds (~300MB)
-  - Falls back to bundled version if external binary not found
-
-**External-Only Providers:**
-
-- `pytorch-cuda` — NVIDIA GPU-accelerated provider (~2.4GB)
-  - Windows/Linux only (no NVIDIA GPUs on macOS)
-  - Downloaded on demand, not bundled
-  - Optional for users with CUDA-capable GPUs
-
-#### Provider Architecture
-
-```
-backend/providers/
-├── __init__.py         # ProviderManager - lifecycle management
-├── base.py             # TTSProvider protocol
-├── bundled.py          # BundledProvider - wraps built-in backends
-├── local.py            # LocalProvider - wraps external subprocess
-├── installer.py        # Download and install external providers
-└── types.py            # Provider type definitions
-
-providers/
-├── pytorch-cpu/        # External PyTorch CPU provider
-│   ├── main.py         # FastAPI server
-│   ├── build.py        # PyInstaller build script
-│   └── build_and_install.py  # Build and install locally
-└── pytorch-cuda/       # External PyTorch CUDA provider
-    ├── main.py
-    ├── build.py
-    └── build_and_install.py
-```
-
-**How it works:**
-
-1. **Bundled providers** run in-process within the main backend
-2. **External providers** run as separate subprocess servers
-3. **LocalProvider** communicates with external providers via HTTP
-4. **ProviderManager** handles starting/stopping and health checks
-
-#### Building Providers Locally
-
-When developing provider features, you'll need to build and test external providers:
-
-**Build a single provider:**
-
-```bash
-cd providers/pytorch-cpu
-python build_and_install.py
-```
-
-**Build all providers:**
-
-```bash
-bun run build:providers
-```
-
-This script:
-
-- Builds the provider binary with PyInstaller
-- Detects your platform (Windows/macOS/Linux)
-- Copies to the correct location:
-  - macOS: `~/Library/Application Support/voicebox/providers/`
-  - Windows: `%APPDATA%\voicebox\providers\`
-  - Linux: `~/.local/share/voicebox/providers/`
-- Sets executable permissions on Unix
-
-**Testing provider changes:**
-
-1. Make changes to `providers/pytorch-cpu/main.py`
-2. Run `bun run build:providers`
-3. Restart the Voicebox app
-4. Select the provider in Settings → TTS Provider
-
-#### Provider Binary Distribution
-
-For production releases, provider binaries are:
-
-1. Built by GitHub Actions for all platforms
-2. Uploaded to Cloudflare R2 at `downloads.voicebox.sh/providers/v{VERSION}/`
-3. Downloaded on-demand by users based on their platform and GPU
-
-See `.github/workflows/release.yml` for the build matrix.
-
 ### Building
 
 **Build everything (recommended):**
-
 ```bash
 bun run build
 ```
-
 This automatically:
-
 1. Builds the Python server binary (`./scripts/build-server.sh`)
 2. Builds the Tauri desktop app (`cd tauri && bun run tauri build`)
 
@@ -252,23 +151,13 @@ Creates platform-specific installers (`.dmg`, `.msi`, `.AppImage`) in `tauri/src
 **Note:** The build process detects your platform and includes the appropriate backend (MLX for Apple Silicon, PyTorch for others).
 
 **Build server binary only:**
-
 ```bash
 bun run build:server
 # or
 ./scripts/build-server.sh
 ```
-
 Creates platform-specific binary in `tauri/src-tauri/binaries/`
 
-**Build provider binaries (for development):**
-
-```bash
-bun run build:providers
-```
-
-Builds all external provider binaries and installs them to the system provider directory. See [TTS Provider Development](#tts-provider-development) for details.
-
 **Building with local Qwen3-TTS development version:**
 
 If you're actively developing or modifying the Qwen3-TTS library, set the `QWEN_TTS_PATH` environment variable to point to your local clone:
@@ -281,41 +170,34 @@ bun run build:server
 This makes PyInstaller use your local qwen-tts version instead of the pip-installed package. Useful when testing changes to the TTS library before they're published to PyPI or when using an editable install (`pip install -e`).
 
 **Build web app:**
-
 ```bash
 cd web
 bun run build
 ```
-
 Output in `web/dist/`
 
 ### Generate OpenAPI Client
 
 After starting the backend server:
-
 ```bash
 ./scripts/generate-api.sh
 ```
-
 This downloads the OpenAPI schema and generates the TypeScript client in `app/src/lib/api/`
 
 ### Convert Assets to Web Formats
 
 To optimize images and videos for the web, run:
-
 ```bash
 bun run convert:assets
 ```
 
 This script:
-
 - Converts PNG → WebP (better compression, same quality)
 - Converts MOV → WebM (VP9 codec, smaller file size)
 - Processes files in `landing/public/` and `docs/public/`
 - **Deletes original files** after successful conversion
 
 **Requirements:** Install `webp` and `ffmpeg`:
-
 ```bash
 brew install webp ffmpeg
 ```
@@ -362,7 +244,6 @@ git push origin feature/your-feature-name
 ```
 
 Then create a pull request on GitHub with:
-
 - Clear description of changes
 - Screenshots (for UI changes)
 - Reference to related issues
@@ -508,23 +389,21 @@ Currently, testing is primarily manual. When adding tests:
 Releases are managed by maintainers:
 
 1. **Bump version using bumpversion:**
-
    ```bash
    # Install bumpversion (if not already installed)
    pip install bumpversion
-
+   
    # Bump patch version (0.1.0 -> 0.1.1)
    bumpversion patch
-
+   
    # Or bump minor version (0.1.0 -> 0.2.0)
    bumpversion minor
-
+   
    # Or bump major version (0.1.0 -> 1.0.0)
    bumpversion major
    ```
-
+   
    This automatically:
-
    - Updates version numbers in all files (`tauri.conf.json`, `Cargo.toml`, all `package.json` files, `backend/main.py`)
    - Creates a git commit with the version bump
    - Creates a git tag (e.g., `v0.1.1`, `v0.2.0`)
@@ -532,7 +411,6 @@ Releases are managed by maintainers:
 2. **Update CHANGELOG.md** with release notes
 
 3. **Push commits and tags:**
-
    ```bash
    git push
    git push --tags

Dockerfile

@@ -1,43 +0,0 @@
-# Base Dockerfile for Voicebox (CPU-only)
-# For GPU support, use Dockerfile.cuda
-
-FROM python:3.12-slim
-
-# Prevent interactive prompts during build
-ENV DEBIAN_FRONTEND=noninteractive
-ENV TZ=UTC
-
-WORKDIR /app
-
-# Install system dependencies
-RUN apt-get update && apt-get install -y \
-    ffmpeg \
-    curl \
-    tzdata \
-    && rm -rf /var/lib/apt/lists/*
-
-# Copy backend
-COPY backend/ /app/backend/
-COPY providers/ /app/providers/
-
-# Copy pre-built web UI
-COPY web/dist/ /app/web/dist/
-
-# Install Python dependencies (without PyTorch - will be downloaded via provider system)
-RUN python -m pip install --upgrade pip && \
-    pip install --no-cache-dir \
-    fastapi uvicorn[standard] pydantic sqlalchemy alembic \
-    librosa soundfile numpy python-multipart Pillow \
-    huggingface_hub transformers accelerate
-
-# Create data directory for profiles/generations
-RUN mkdir -p /app/data
-
-# Health check
-HEALTHCHECK --interval=30s --timeout=10s --retries=3 --start-period=40s \
-  CMD curl -f http://localhost:8000/health || exit 1
-
-EXPOSE 8000
-
-# Run server with web UI
-CMD ["uvicorn", "backend.main:app", "--host", "0.0.0.0", "--port", "8000"]

Dockerfile.cuda

@@ -1,58 +0,0 @@
-# Dockerfile for Voicebox with NVIDIA GPU support (CUDA)
-
-FROM nvidia/cuda:12.1.1-runtime-ubuntu22.04
-
-# Prevent interactive prompts during build
-ENV DEBIAN_FRONTEND=noninteractive
-ENV TZ=UTC
-
-WORKDIR /app
-
-# Install Python 3.12
-RUN apt-get update && apt-get install -y \
-    software-properties-common \
-    && add-apt-repository ppa:deadsnakes/ppa \
-    && apt-get update && apt-get install -y \
-    python3.12 \
-    python3.12-dev \
-    python3.12-venv \
-    ffmpeg \
-    curl \
-    tzdata \
-    && rm -rf /var/lib/apt/lists/*
-
-# Set Python 3.12 as default and bootstrap pip
-RUN update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.12 1 && \
-    update-alternatives --install /usr/bin/python python /usr/bin/python3.12 1 && \
-    python3.12 -m ensurepip --upgrade && \
-    python3.12 -m pip install --upgrade pip
-
-# Copy backend
-COPY backend/ /app/backend/
-COPY providers/ /app/providers/
-
-# Copy pre-built web UI
-COPY web/dist/ /app/web/dist/
-
-# Install PyTorch with CUDA support first
-RUN pip install --no-cache-dir \
-    torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu121
-
-# Install remaining dependencies
-RUN pip install --no-cache-dir \
-    fastapi uvicorn[standard] pydantic sqlalchemy alembic \
-    transformers accelerate huggingface_hub \
-    librosa soundfile numpy python-multipart Pillow \
-    qwen-tts
-
-# Create data directory
-RUN mkdir -p /app/data
-
-# Health check
-HEALTHCHECK --interval=30s --timeout=10s --retries=3 --start-period=40s \
-  CMD curl -f http://localhost:8000/health || exit 1
-
-EXPOSE 8000
-
-# Run server with web UI
-CMD ["uvicorn", "backend.main:app", "--host", "0.0.0.0", "--port", "8000"]

README.md

@@ -76,39 +76,16 @@ Download a voice model, clone any voice from a few seconds of audio, and compose
 
 ## Download
 
-### Desktop App
+Voicebox is available now for macOS and Windows.
 
-| Platform              | Download                                                                                                                    |
-| --------------------- | --------------------------------------------------------------------------------------------------------------------------- |
-| macOS (Apple Silicon) | [Download latest release](https://github.com/jamiepine/voicebox/releases/latest)   |
-| macOS (Intel)         | [Download latest release](https://github.com/jamiepine/voicebox/releases/latest)           |
-| Windows (MSI)         | [Download latest release](https://github.com/jamiepine/voicebox/releases/latest) |
-| Windows (Setup)       | [Download latest release](https://github.com/jamiepine/voicebox/releases/latest) |
-| Linux (AppImage)      | [Download latest release](https://github.com/jamiepine/voicebox/releases/latest) |
-| Linux (Deb)           | [Download latest release](https://github.com/jamiepine/voicebox/releases/latest) |
+| Platform | Download |
+|----------|----------|
+| macOS (Apple Silicon) | [Voicebox_aarch64.app.tar.gz](https://github.com/jamiepine/voicebox/releases/latest/download/Voicebox_aarch64.app.tar.gz) |
+| macOS (Intel) | [Voicebox_x64.app.tar.gz](https://github.com/jamiepine/voicebox/releases/latest/download/Voicebox_x64.app.tar.gz) |
+| Windows (MSI) | [Latest Windows MSI](https://github.com/jamiepine/voicebox/releases/latest) |
+| Windows (Setup) | [Latest Windows Setup](https://github.com/jamiepine/voicebox/releases/latest) |
 
-### Docker
-
-Run Voicebox with the web UI in Docker - perfect for servers and headless deployments:
-
-```bash
-# CPU-only (supports amd64 and arm64)
-docker run -p 8000:8000 -v voicebox-data:/app/data \
-  ghcr.io/jamiepine/voicebox:latest
-
-# NVIDIA GPU (recommended for performance)
-docker run --gpus all -p 8000:8000 -v voicebox-data:/app/data \
-  ghcr.io/jamiepine/voicebox:latest-cuda
-```
-
-Or use Docker Compose:
-```bash
-docker compose up -d
-```
-
-Open http://localhost:8000 to access the web UI.
-
-See [Docker Deployment Guide](docs/overview/docker.mdx) for cloud deployments, GPU setup, and more.
+> **Linux builds coming soon** — Currently blocked by GitHub runner disk space limitations.
 
 ---
 
@@ -160,10 +137,9 @@ Create multi-voice narratives, podcasts, and conversations with a timeline-based
 
 ### Flexible Deployment
 
-- **Desktop app** — Native apps for macOS, Windows, and Linux
-- **Docker** — Deploy to servers with the web UI included
-- **Remote mode** — Connect desktop app to a remote GPU server
-- **Cloud ready** — Deploy to AWS, GCP, DigitalOcean, or any cloud provider
+- **Local mode** — Everything runs on your machine
+- **Remote mode** — Connect to a GPU server on your network
+- **One-click server** — Turn any machine into a Voicebox server
 
 ---
 
@@ -200,17 +176,17 @@ Full API documentation available at `http://localhost:8000/docs` when running.
 
 ## Tech Stack
 
-| Layer            | Technology                                          |
-| ---------------- | --------------------------------------------------- |
-| Desktop App      | Tauri (Rust)                                        |
-| Frontend         | React, TypeScript, Tailwind CSS                     |
-| State            | Zustand, React Query                                |
-| Backend          | FastAPI (Python)                                    |
-| Voice Model      | Qwen3-TTS (PyTorch or MLX)                          |
-| Transcription    | Whisper (PyTorch or MLX)                            |
+| Layer | Technology |
+|-------|------------|
+| Desktop App | Tauri (Rust) |
+| Frontend | React, TypeScript, Tailwind CSS |
+| State | Zustand, React Query |
+| Backend | FastAPI (Python) |
+| Voice Model | Qwen3-TTS (PyTorch or MLX) |
+| Transcription | Whisper (PyTorch or MLX) |
 | Inference Engine | MLX (Apple Silicon) / PyTorch (Windows/Linux/Intel) |
-| Database         | SQLite                                              |
-| Audio            | WaveSurfer.js, librosa                              |
+| Database | SQLite |
+| Audio | WaveSurfer.js, librosa |
 
 **Why this stack?**
 
@@ -218,26 +194,6 @@ Full API documentation available at `http://localhost:8000/docs` when running.
 - **FastAPI** — Async Python with automatic OpenAPI schema generation
 - **Type-safe end-to-end** — Generated TypeScript client from OpenAPI spec
 
-### TTS Provider Architecture
-
-Voicebox uses a modular provider system to support different inference backends:
-
-- **`apple-mlx`** — Bundled with macOS Apple Silicon builds
-
-  - Uses MLX with native Metal acceleration (4-5x faster)
-  - Works out of the box, no download required
-
-- **`pytorch-cpu`** — Universal CPU provider (bundled or downloaded)
-
-  - Bundled with Windows and macOS Intel builds
-  - Downloaded on first use for Linux (~300MB)
-
-- **`pytorch-cuda`** — Optional NVIDIA GPU-accelerated provider
-  - Windows/Linux only (~2.4GB)
-  - 4-5x faster inference on CUDA-capable GPUs
-
-macOS and Windows builds work out of the box with bundled providers. Linux users download a provider on first launch. The app automatically detects your hardware and recommends the best option. All downloadable providers are distributed via Cloudflare R2 for fast, global delivery.
-
 ---
 
 ## Roadmap
@@ -246,13 +202,13 @@ Voicebox is the beginning of something bigger. Here's what's coming:
 
 ### Coming Soon
 
-| Feature                 | Description                                        |
-| ----------------------- | -------------------------------------------------- |
-| **Real-time Synthesis** | Stream audio as it generates, word by word         |
-| **Conversation Mode**   | Multi-speaker dialogues with automatic turn-taking |
-| **Voice Effects**       | Pitch shift, reverb, M3GAN-style effects           |
-| **Timeline Editor**     | Audio studio with word-level precision editing     |
-| **More Models**         | XTTS, Bark, and other open-source voice models     |
+| Feature | Description |
+|---------|-------------|
+| **Real-time Synthesis** | Stream audio as it generates, word by word |
+| **Conversation Mode** | Multi-speaker dialogues with automatic turn-taking |
+| **Voice Effects** | Pitch shift, reverb, M3GAN-style effects |
+| **Timeline Editor** | Audio studio with word-level precision editing |
+| **More Models** | XTTS, Bark, and other open-source voice models |
 
 ### Future Vision
 
@@ -269,45 +225,23 @@ Voicebox aims to be the **one-stop shop for everything voice** — cloning, synt
 
 See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed setup and contribution guidelines.
 
-**Using the Makefile (recommended):** Run `make help` to see all available commands for setup, development, building, and testing.
-
 ### Quick Start
 
-**With Makefile (Unix/macOS/Linux):**
-
 ```bash
-# Clone the repo
-git clone https://github.com/voicebox-sh/voicebox.git
+git clone https://github.com/jamiepine/voicebox.git
 cd voicebox
 
-# Setup everything
-make setup
-
-# Start development
-make dev
+just setup   # creates Python venv, installs all deps
+just dev     # starts backend + desktop app
 ```
 
-**Manual setup (all platforms):**
+Install [just](https://github.com/casey/just): `brew install just` or `cargo install just`. Run `just --list` to see all commands.
 
-```bash
-# Clone the repo
-git clone https://github.com/voicebox-sh/voicebox.git
-cd voicebox
+Also available via Makefile: `make setup && make dev` (run `make help` for all commands).
 
-# Install dependencies
-bun install
-
-# Install Python dependencies
-cd backend && pip install -r requirements.txt && cd ..
-
-# Start development
-bun run dev
-```
-
-**Prerequisites:** [Bun](https://bun.sh), [Rust](https://rustup.rs), [Python 3.11+](https://python.org).
-
-**Performance:**
+**Prerequisites:** [Bun](https://bun.sh), [Rust](https://rustup.rs), [Python 3.11+](https://python.org), [XCode on macOS](https://developer.apple.com/xcode/).
 
+**Performance:** 
 - **Apple Silicon (M1/M2/M3)**: Uses MLX backend with native Metal acceleration for 4-5x faster inference
 - **Windows/Linux/Intel Mac**: Uses PyTorch backend (CUDA GPU recommended, CPU supported but slower)
 

app/package.json

@@ -17,10 +17,6 @@
     "@dnd-kit/sortable": "^10.0.0",
     "@dnd-kit/utilities": "^3.2.2",
     "@hookform/resolvers": "^3.9.0",
-    "@hugeicons/core-free-icons": "^3.1.1",
-    "@hugeicons/react": "^1.1.4",
-    "@iconify-json/svg-spinners": "^1.2.4",
-    "@iconify/react": "^6.0.2",
     "@radix-ui/react-alert-dialog": "^1.1.1",
     "@radix-ui/react-avatar": "^1.1.0",
     "@radix-ui/react-dialog": "^1.1.1",
@@ -28,7 +24,6 @@
     "@radix-ui/react-label": "^2.1.0",
     "@radix-ui/react-popover": "^1.1.1",
     "@radix-ui/react-progress": "^1.1.0",
-    "@radix-ui/react-radio-group": "^1.2.0",
     "@radix-ui/react-scroll-area": "^1.1.0",
     "@radix-ui/react-select": "^2.1.1",
     "@radix-ui/react-separator": "^1.1.0",
@@ -48,6 +43,7 @@
     "clsx": "^2.1.1",
     "date-fns": "^3.6.0",
     "framer-motion": "^12.29.0",
+    "lucide-react": "^0.454.0",
     "motion": "^12.29.0",
     "react": "^18.3.0",
     "react-dom": "^18.3.0",

app/src/App.tsx

@@ -40,7 +40,7 @@ function App() {
   const serverStartingRef = useRef(false);
 
   // Automatically check for app updates on startup and show toast notifications
-  useAutoUpdater(true);
+  useAutoUpdater({ checkOnMount: true, showToast: true });
 
   // Sync stored setting to Rust on startup
   useEffect(() => {
@@ -82,7 +82,8 @@ function App() {
       console.log('Dev mode: Skipping auto-start of server (run it separately)');
       setServerReady(true); // Mark as ready so UI doesn't show loading screen
       // Mark that server was not started by app (so we don't try to stop it on close)
-      (window as any).__voiceboxServerStartedByApp = false;
+      // @ts-expect-error - adding property to window
+      window.__voiceboxServerStartedByApp = false;
       return;
     }
 
@@ -102,12 +103,14 @@ function App() {
         useServerStore.getState().setServerUrl(serverUrl);
         setServerReady(true);
         // Mark that we started the server (so we know to stop it on close)
-        (window as any).__voiceboxServerStartedByApp = true;
+        // @ts-expect-error - adding property to window
+        window.__voiceboxServerStartedByApp = true;
       })
       .catch((error) => {
         console.error('Failed to auto-start server:', error);
         serverStartingRef.current = false;
-        (window as any).__voiceboxServerStartedByApp = false;
+        // @ts-expect-error - adding property to window
+        window.__voiceboxServerStartedByApp = false;
       });
 
     // Cleanup: stop server on actual unmount (not StrictMode remount)

app/src/components/AudioPlayer/AudioPlayer.tsx

@@ -1,6 +1,5 @@
 import { useQuery } from '@tanstack/react-query';
-import { HugeiconsIcon } from '@hugeicons/react';
-import { PauseIcon, PlayIcon, RepeatIcon, VolumeHighIcon, VolumeMuteIcon, Cancel01Icon } from '@hugeicons/core-free-icons';
+import { Pause, Play, Repeat, Volume2, VolumeX, X } from 'lucide-react';
 import { useEffect, useMemo, useRef, useState } from 'react';
 import WaveSurfer from 'wavesurfer.js';
 import { Button } from '@/components/ui/button';
@@ -460,7 +459,7 @@ export function AudioPlayer() {
     // Use double requestAnimationFrame to ensure DOM is fully rendered
     let rafId1: number;
     let rafId2: number;
-    let timeoutId: ReturnType<typeof setTimeout> | null = null;
+    let timeoutId: number | null = null;
 
     rafId1 = requestAnimationFrame(() => {
       rafId2 = requestAnimationFrame(() => {
@@ -833,7 +832,7 @@ export function AudioPlayer() {
             className="shrink-0"
             title={duration === 0 && !isLoading ? 'Audio not loaded' : ''}
           >
-            {isPlaying ? <HugeiconsIcon icon={PauseIcon} size={20} className="h-5 w-5" /> : <HugeiconsIcon icon={PlayIcon} size={20} className="h-5 w-5" />}
+            {isPlaying ? <Pause className="h-5 w-5" /> : <Play className="h-5 w-5" />}
           </Button>
 
           {/* Waveform */}
@@ -874,7 +873,7 @@ export function AudioPlayer() {
             className={isLooping ? 'text-primary' : ''}
             title="Toggle loop"
           >
-            <HugeiconsIcon icon={RepeatIcon} size={16} className="h-4 w-4" />
+            <Repeat className="h-4 w-4" />
           </Button>
 
           {/* Volume Control */}
@@ -885,7 +884,7 @@ export function AudioPlayer() {
               onClick={() => setVolume(volume > 0 ? 0 : 1)}
               className="h-8 w-8"
             >
-              {volume > 0 ? <HugeiconsIcon icon={VolumeHighIcon} size={16} className="h-4 w-4" /> : <HugeiconsIcon icon={VolumeMuteIcon} size={16} className="h-4 w-4" />}
+              {volume > 0 ? <Volume2 className="h-4 w-4" /> : <VolumeX className="h-4 w-4" />}
             </Button>
             <Slider
               value={[volume * 100]}
@@ -904,7 +903,7 @@ export function AudioPlayer() {
             className="shrink-0"
             title="Close player"
           >
-            <HugeiconsIcon icon={Cancel01Icon} size={20} className="h-5 w-5" />
+            <X className="h-5 w-5" />
           </Button>
         </div>
       </div>

app/src/components/AudioTab/AudioTab.tsx

@@ -1,6 +1,5 @@
 import { useMutation, useQuery, useQueryClient } from '@tanstack/react-query';
-import { HugeiconsIcon } from '@hugeicons/react';
-import { CheckmarkCircle01Icon, CheckmarkCircle02Icon, Edit01Icon, Add01Icon, SpeakerIcon, Delete01Icon } from '@hugeicons/core-free-icons';
+import { Check, CheckCircle2, Edit, Plus, Speaker, Trash2 } from 'lucide-react';
 import { useState } from 'react';
 import { Badge } from '@/components/ui/badge';
 import { Button } from '@/components/ui/button';
@@ -125,6 +124,13 @@ export function AudioTab() {
     );
   }
 
+  const handleChannelDelete = async (e, channelId) => {
+    e.stopPropagation();
+    if (await confirm('Delete this channel?')) {
+      deleteChannel.mutate(channelId);
+    }
+  }
+
   const allChannels = channels || [];
   const allDevices = devices || [];
   const selectedChannel = selectedChannelId
@@ -136,7 +142,7 @@ export function AudioTab() {
       <div className="flex items-center justify-between mb-6 shrink-0">
         <h2 className="text-2xl font-bold">Audio Channels</h2>
         <Button onClick={() => setCreateDialogOpen(true)}>
-          <HugeiconsIcon icon={Add01Icon} size={16} className="h-4 w-4 mr-2" />
+          <Plus className="h-4 w-4 mr-2" />
           New Channel
         </Button>
       </div>
@@ -151,13 +157,13 @@ export function AudioTab() {
         >
           {allChannels.length === 0 ? (
             <div className="flex flex-col items-center justify-center py-12 border-2 border-dashed border-muted rounded-md">
-              <HugeiconsIcon icon={SpeakerIcon} size={48} className="h-12 w-12 text-muted-foreground mb-4" />
+              <Speaker className="h-12 w-12 text-muted-foreground mb-4" />
               <p className="text-muted-foreground mb-4">
                 No audio channels yet. Create your first channel to route voices to specific
                 devices.
               </p>
               <Button onClick={() => setCreateDialogOpen(true)}>
-                <HugeiconsIcon icon={Add01Icon} size={16} className="h-4 w-4 mr-2" />
+                <Plus className="h-4 w-4 mr-2" />
                 Create Channel
               </Button>
             </div>
@@ -179,7 +185,7 @@ export function AudioTab() {
                       <div className="flex-1 min-w-0">
                         <div className="flex items-center gap-2 mb-3">
                           <div className="h-8 w-8 rounded-lg bg-muted flex items-center justify-center shrink-0">
-                            <HugeiconsIcon icon={SpeakerIcon} size={16} className="h-4 w-4 text-muted-foreground" />
+                            <Speaker className="h-4 w-4 text-muted-foreground" />
                           </div>
                           <div className="flex items-center gap-2 min-w-0">
                             <h3 className="font-semibold text-base truncate">{channel.name}</h3>
@@ -236,20 +242,15 @@ export function AudioTab() {
                               setEditingChannel(channel.id);
                             }}
                           >
-                            <HugeiconsIcon icon={Edit01Icon} size={16} className="h-4 w-4" />
+                            <Edit className="h-4 w-4" />
                           </Button>
                           <Button
                             variant="ghost"
                             size="sm"
                             className="h-8 w-8 p-0"
-                            onClick={(e) => {
-                              e.stopPropagation();
-                              if (confirm('Delete this channel?')) {
-                                deleteChannel.mutate(channel.id);
-                              }
-                            }}
+                            onClick={(e) => handleChannelDelete(e, channel.id)}
                           >
-                            <HugeiconsIcon icon={Delete01Icon} size={16} className="h-4 w-4" />
+                            <Trash2 className="h-4 w-4" />
                           </Button>
                         </div>
                       )}
@@ -326,10 +327,10 @@ export function AudioTab() {
                           isConnected ? 'bg-accent border-accent' : 'border-muted-foreground/30',
                         )}
                       >
-                        {isConnected && <HugeiconsIcon icon={CheckmarkCircle01Icon} size={12} className="h-3 w-3 text-accent-foreground" />}
+                        {isConnected && <Check className="h-3 w-3 text-accent-foreground" />}
                       </div>
                     ) : device.is_default ? (
-                      <HugeiconsIcon icon={CheckmarkCircle02Icon} size={16} className="h-4 w-4 text-primary shrink-0" />
+                      <CheckCircle2 className="h-4 w-4 text-primary shrink-0" />
                     ) : null}
                     <span className={cn('truncate flex-1', device.is_default && 'font-medium')}>
                       {device.name}
@@ -340,7 +341,7 @@ export function AudioTab() {
             </div>
           ) : (
             <div className="flex flex-col items-center justify-center py-12 border-2 border-dashed border-muted rounded-md">
-              <HugeiconsIcon icon={CheckmarkCircle02Icon} size={48} className="h-12 w-12 text-muted-foreground mb-4" />
+              <CheckCircle2 className="h-12 w-12 text-muted-foreground mb-4" />
               <p className="text-muted-foreground text-center">
                 {platform.metadata.isTauri ? 'No audio devices found' : 'Audio device selection requires Tauri'}
               </p>
@@ -495,7 +496,7 @@ function CreateChannelDialog({ open, onOpenChange, devices, onCreate }: CreateCh
                           setSelectedDevices(selectedDevices.filter((id) => id !== deviceId))
                         }
                       >
-                        <HugeiconsIcon icon={Delete01Icon} size={12} className="h-3 w-3" />
+                        <Trash2 className="h-3 w-3" />
                       </Button>
                     </div>
                   );
@@ -603,7 +604,7 @@ function EditChannelDialog({
                           setSelectedDevices(selectedDevices.filter((id) => id !== deviceId))
                         }
                       >
-                        <HugeiconsIcon icon={Delete01Icon} size={12} className="h-3 w-3" />
+                        <Trash2 className="h-3 w-3" />
                       </Button>
                     </div>
                   );
@@ -649,7 +650,7 @@ function EditChannelDialog({
                           setSelectedVoices(selectedVoices.filter((id) => id !== profileId))
                         }
                       >
-                        <HugeiconsIcon icon={Delete01Icon} size={12} className="h-3 w-3" />
+                        <Trash2 className="h-3 w-3" />
                       </Button>
                     </div>
                   );

app/src/components/Generation/FloatingGenerateBox.tsx

@@ -1,8 +1,6 @@
-import { SparklesIcon, TextSquareIcon } from '@hugeicons/core-free-icons';
-import { HugeiconsIcon } from '@hugeicons/react';
-import { Icon } from '@iconify/react';
 import { useMatchRoute } from '@tanstack/react-router';
 import { AnimatePresence, motion } from 'framer-motion';
+import { Loader2, SlidersHorizontal, Sparkles } from 'lucide-react';
 import { useEffect, useRef, useState } from 'react';
 import { Button } from '@/components/ui/button';
 import { Form, FormControl, FormField, FormItem, FormMessage } from '@/components/ui/form';
@@ -300,13 +298,13 @@ export function FloatingGenerateBox({
                   <Button
                     type="submit"
                     disabled={isPending || !selectedProfileId}
-                    className="h-10 w-10 rounded-full bg-accent hover:bg-accent/90 hover:scale-105 text-accent-foreground shadow-lg transition-all duration-200"
+                    className="h-10 w-10 rounded-full bg-accent hover:bg-accent/90 hover:scale-105 text-accent-foreground shadow-lg hover:shadow-accent/50 transition-all duration-200"
                     size="icon"
                   >
                     {isPending ? (
-                      <Icon icon="svg-spinners:ring-resize" className="h-4 w-4 animate-spin" />
+                      <Loader2 className="h-4 w-4 animate-spin" />
                     ) : (
-                      <HugeiconsIcon icon={SparklesIcon} size={16} className="h-4 w-4" />
+                      <Sparkles className="h-4 w-4" />
                     )}
                   </Button>
                   <span className="pointer-events-none absolute bottom-full left-1/2 -translate-x-1/2 mb-2 whitespace-nowrap rounded-md bg-popover px-3 py-1.5 text-xs text-popover-foreground border border-border opacity-0 transition-opacity group-hover:opacity-100 z-[9999]">
@@ -318,7 +316,7 @@ export function FloatingGenerateBox({
                   </span>
                 </div>
                 <AnimatePresence>
-                  {isExpanded && (
+                  {isExpanded && form.watch('engine') !== 'luxtts' && (
                     <motion.div
                       initial={{ opacity: 0, scale: 0.8 }}
                       animate={{ opacity: 1, scale: 1 }}
@@ -339,7 +337,7 @@ export function FloatingGenerateBox({
                               : 'bg-card border border-border hover:bg-background/50',
                           )}
                         >
-                          <HugeiconsIcon icon={TextSquareIcon} size={16} className="h-4 w-4" />
+                          <SlidersHorizontal className="h-4 w-4" />
                         </Button>
                         <span className="pointer-events-none absolute bottom-full left-1/2 -translate-x-1/2 mb-2 whitespace-nowrap rounded-md bg-popover px-3 py-1.5 text-xs text-popover-foreground border border-border opacity-0 transition-opacity group-hover:opacity-100 z-[9999]">
                           Fine tune instructions
@@ -404,30 +402,41 @@ export function FloatingGenerateBox({
                     )}
                   />
 
-                  <FormField
-                    control={form.control}
-                    name="modelSize"
-                    render={({ field }) => (
-                      <FormItem className="flex-1 space-y-0">
-                        <Select onValueChange={field.onChange} defaultValue={field.value}>
-                          <FormControl>
-                            <SelectTrigger className="h-8 text-xs bg-card border-border rounded-full hover:bg-background/50 transition-all">
-                              <SelectValue />
-                            </SelectTrigger>
-                          </FormControl>
-                          <SelectContent>
-                            <SelectItem value="1.7B" className="text-xs text-muted-foreground">
-                              Qwen3-TTS 1.7B
-                            </SelectItem>
-                            <SelectItem value="0.6B" className="text-xs text-muted-foreground">
-                              Qwen3-TTS 0.6B
-                            </SelectItem>
-                          </SelectContent>
-                        </Select>
-                        <FormMessage className="text-xs" />
-                      </FormItem>
-                    )}
-                  />
+                  <FormItem className="flex-1 space-y-0">
+                    <Select
+                      value={
+                        form.watch('engine') === 'luxtts'
+                          ? 'luxtts'
+                          : `qwen:${form.watch('modelSize') || '1.7B'}`
+                      }
+                      onValueChange={(value) => {
+                        if (value === 'luxtts') {
+                          form.setValue('engine', 'luxtts');
+                        } else {
+                          const [, modelSize] = value.split(':');
+                          form.setValue('engine', 'qwen');
+                          form.setValue('modelSize', modelSize as '1.7B' | '0.6B');
+                        }
+                      }}
+                    >
+                      <FormControl>
+                        <SelectTrigger className="h-8 text-xs bg-card border-border rounded-full hover:bg-background/50 transition-all">
+                          <SelectValue />
+                        </SelectTrigger>
+                      </FormControl>
+                      <SelectContent>
+                        <SelectItem value="qwen:1.7B" className="text-xs text-muted-foreground">
+                          Qwen3-TTS 1.7B
+                        </SelectItem>
+                        <SelectItem value="qwen:0.6B" className="text-xs text-muted-foreground">
+                          Qwen3-TTS 0.6B
+                        </SelectItem>
+                        <SelectItem value="luxtts" className="text-xs text-muted-foreground">
+                          LuxTTS
+                        </SelectItem>
+                      </SelectContent>
+                    </Select>
+                  </FormItem>
                 </div>
               </motion.div>
             </AnimatePresence>

app/src/components/Generation/GenerationForm.tsx

@@ -1,6 +1,4 @@
-import { Mic01Icon } from '@hugeicons/core-free-icons';
-import { HugeiconsIcon } from '@hugeicons/react';
-import { Icon } from '@iconify/react';
+import { Loader2, Mic } from 'lucide-react';
 import { Button } from '@/components/ui/button';
 import { Card, CardContent, CardHeader, CardTitle } from '@/components/ui/card';
 import {
@@ -48,11 +46,7 @@ export function GenerationForm() {
               <FormLabel>Voice Profile</FormLabel>
               {selectedProfile ? (
                 <div className="mt-2 p-3 border rounded-md bg-muted/50 flex items-center gap-2">
-                  <HugeiconsIcon
-                    icon={Mic01Icon}
-                    size={16}
-                    className="h-4 w-4 text-muted-foreground"
-                  />
+                  <Mic className="h-4 w-4 text-muted-foreground" />
                   <span className="font-medium">{selectedProfile.name}</span>
                   <span className="text-sm text-muted-foreground">{selectedProfile.language}</span>
                 </div>
@@ -82,29 +76,67 @@ export function GenerationForm() {
               )}
             />
 
-            <FormField
-              control={form.control}
-              name="instruct"
-              render={({ field }) => (
-                <FormItem>
-                  <FormLabel>Delivery Instructions (optional)</FormLabel>
-                  <FormControl>
-                    <Textarea
-                      placeholder="e.g. Speak slowly with emphasis, Warm and friendly tone, Professional and authoritative..."
-                      className="min-h-[80px]"
-                      {...field}
-                    />
-                  </FormControl>
-                  <FormDescription>
-                    Natural language instructions to control speech delivery (tone, emotion, pace).
-                    Max 500 characters
-                  </FormDescription>
-                  <FormMessage />
-                </FormItem>
-              )}
-            />
+            {form.watch('engine') !== 'luxtts' && (
+              <FormField
+                control={form.control}
+                name="instruct"
+                render={({ field }) => (
+                  <FormItem>
+                    <FormLabel>Delivery Instructions (optional)</FormLabel>
+                    <FormControl>
+                      <Textarea
+                        placeholder="e.g. Speak slowly with emphasis, Warm and friendly tone, Professional and authoritative..."
+                        className="min-h-[80px]"
+                        {...field}
+                      />
+                    </FormControl>
+                    <FormDescription>
+                      Natural language instructions to control speech delivery (tone, emotion,
+                      pace). Max 500 characters
+                    </FormDescription>
+                    <FormMessage />
+                  </FormItem>
+                )}
+              />
+            )}
 
             <div className="grid gap-4 md:grid-cols-3">
+              <FormItem>
+                <FormLabel>Model</FormLabel>
+                <Select
+                  value={
+                    form.watch('engine') === 'luxtts'
+                      ? 'luxtts'
+                      : `qwen:${form.watch('modelSize') || '1.7B'}`
+                  }
+                  onValueChange={(value) => {
+                    if (value === 'luxtts') {
+                      form.setValue('engine', 'luxtts');
+                    } else {
+                      const [, modelSize] = value.split(':');
+                      form.setValue('engine', 'qwen');
+                      form.setValue('modelSize', modelSize as '1.7B' | '0.6B');
+                    }
+                  }}
+                >
+                  <FormControl>
+                    <SelectTrigger>
+                      <SelectValue />
+                    </SelectTrigger>
+                  </FormControl>
+                  <SelectContent>
+                    <SelectItem value="qwen:1.7B">Qwen3-TTS 1.7B</SelectItem>
+                    <SelectItem value="qwen:0.6B">Qwen3-TTS 0.6B</SelectItem>
+                    <SelectItem value="luxtts">LuxTTS</SelectItem>
+                  </SelectContent>
+                </Select>
+                <FormDescription>
+                  {form.watch('engine') === 'luxtts'
+                    ? 'Fast, English-focused'
+                    : 'Multi-language, two sizes'}
+                </FormDescription>
+              </FormItem>
+
               <FormField
                 control={form.control}
                 name="language"
@@ -130,29 +162,6 @@ export function GenerationForm() {
                 )}
               />
 
-              <FormField
-                control={form.control}
-                name="modelSize"
-                render={({ field }) => (
-                  <FormItem>
-                    <FormLabel>Model Size</FormLabel>
-                    <Select onValueChange={field.onChange} defaultValue={field.value}>
-                      <FormControl>
-                        <SelectTrigger>
-                          <SelectValue />
-                        </SelectTrigger>
-                      </FormControl>
-                      <SelectContent>
-                        <SelectItem value="1.7B">Qwen TTS 1.7B (Higher Quality)</SelectItem>
-                        <SelectItem value="0.6B">Qwen TTS 0.6B (Faster)</SelectItem>
-                      </SelectContent>
-                    </Select>
-                    <FormDescription>Larger models produce better quality</FormDescription>
-                    <FormMessage />
-                  </FormItem>
-                )}
-              />
-
               <FormField
                 control={form.control}
                 name="seed"
@@ -179,7 +188,7 @@ export function GenerationForm() {
             <Button type="submit" className="w-full" disabled={isPending || !selectedProfileId}>
               {isPending ? (
                 <>
-                  <Icon icon="svg-spinners:ring-resize" className="mr-2 h-4 w-4 animate-spin" />
+                  <Loader2 className="mr-2 h-4 w-4 animate-spin" />
                   Generating...
                 </>
               ) : (

app/src/components/History/HistoryTable.tsx

@@ -1,13 +1,12 @@
 import {
-  Archive01Icon,
-  Delete01Icon,
-  Download01Icon,
-  MoreHorizontalIcon,
-  PlayIcon,
-  WaveIcon,
-} from '@hugeicons/core-free-icons';
-import { HugeiconsIcon } from '@hugeicons/react';
-import { Icon } from '@iconify/react';
+  AudioWaveform,
+  Download,
+  FileArchive,
+  Loader2,
+  MoreHorizontal,
+  Play,
+  Trash2,
+} from 'lucide-react';
 import { useEffect, useRef, useState } from 'react';
 import { Button } from '@/components/ui/button';
 import {
@@ -55,9 +54,7 @@ export function HistoryTable() {
   const [importDialogOpen, setImportDialogOpen] = useState(false);
   const [selectedFile, setSelectedFile] = useState<File | null>(null);
   const [deleteDialogOpen, setDeleteDialogOpen] = useState(false);
-  const [generationToDelete, setGenerationToDelete] = useState<{ id: string; name: string } | null>(
-    null,
-  );
+  const [generationToDelete, setGenerationToDelete] = useState<{ id: string; name: string } | null>(null);
   const limit = 20;
   const { toast } = useToast();
 
@@ -225,10 +222,7 @@ export function HistoryTable() {
   if (isLoading && page === 0) {
     return (
       <div className="flex items-center justify-center h-full">
-        <Icon
-          icon="svg-spinners:ring-resize"
-          className="h-8 w-8 animate-spin text-muted-foreground"
-        />
+        <Loader2 className="h-8 w-8 animate-spin text-muted-foreground" />
       </div>
     );
   }
@@ -274,11 +268,7 @@ export function HistoryTable() {
                 >
                   {/* Waveform icon */}
                   <div className="flex items-center shrink-0">
-                    <HugeiconsIcon
-                      icon={WaveIcon}
-                      size={20}
-                      className="h-5 w-5 text-muted-foreground"
-                    />
+                    <AudioWaveform className="h-5 w-5 text-muted-foreground" />
                   </div>
 
                   {/* Left side - Meta information */}
@@ -320,35 +310,36 @@ export function HistoryTable() {
                           className="h-8 w-8"
                           aria-label="Actions"
                         >
-                          <HugeiconsIcon icon={MoreHorizontalIcon} size={16} className="h-4 w-4" />
+                          <MoreHorizontal className="h-4 w-4" />
                         </Button>
                       </DropdownMenuTrigger>
                       <DropdownMenuContent align="end">
                         <DropdownMenuItem
                           onClick={() => handlePlay(gen.id, gen.text, gen.profile_id)}
                         >
-                          <HugeiconsIcon icon={PlayIcon} size={16} className="mr-2 h-4 w-4" />
+                          <Play className="mr-2 h-4 w-4" />
                           Play
                         </DropdownMenuItem>
                         <DropdownMenuItem
                           onClick={() => handleDownloadAudio(gen.id, gen.text)}
                           disabled={exportGenerationAudio.isPending}
                         >
-                          <HugeiconsIcon icon={Download01Icon} size={16} className="mr-2 h-4 w-4" />
+                          <Download className="mr-2 h-4 w-4" />
                           Export Audio
                         </DropdownMenuItem>
                         <DropdownMenuItem
                           onClick={() => handleExportPackage(gen.id, gen.text)}
                           disabled={exportGeneration.isPending}
                         >
-                          <HugeiconsIcon icon={Archive01Icon} size={16} className="mr-2 h-4 w-4" />
+                          <FileArchive className="mr-2 h-4 w-4" />
                           Export Package
                         </DropdownMenuItem>
                         <DropdownMenuItem
                           onClick={() => handleDeleteClick(gen.id, gen.profile_name)}
                           disabled={deleteGeneration.isPending}
+                          className="text-destructive focus:text-destructive"
                         >
-                          <HugeiconsIcon icon={Delete01Icon} size={16} className="mr-2 h-4 w-4" />
+                          <Trash2 className="mr-2 h-4 w-4" />
                           Delete
                         </DropdownMenuItem>
                       </DropdownMenuContent>
@@ -361,12 +352,7 @@ export function HistoryTable() {
             {/* Load more trigger element */}
             {hasMore && (
               <div ref={loadMoreRef} className="flex items-center justify-center py-4">
-                {isFetching && (
-                  <Icon
-                    icon="svg-spinners:ring-resize"
-                    className="h-6 w-6 animate-spin text-muted-foreground"
-                  />
-                )}
+                {isFetching && <Loader2 className="h-6 w-6 animate-spin text-muted-foreground" />}
               </div>
             )}
 
@@ -385,8 +371,7 @@ export function HistoryTable() {
           <DialogHeader>
             <DialogTitle>Delete Generation</DialogTitle>
             <DialogDescription>
-              Are you sure you want to delete this generation from "{generationToDelete?.name}"?
-              This action cannot be undone.
+              Are you sure you want to delete this generation from "{generationToDelete?.name}"? This action cannot be undone.
             </DialogDescription>
           </DialogHeader>
           <DialogFooter>

app/src/components/MainEditor/MainEditor.tsx

@@ -1,5 +1,4 @@
-import { HugeiconsIcon } from '@hugeicons/react';
-import { SparklesIcon, Upload01Icon } from '@hugeicons/core-free-icons';
+import { Sparkles, Upload } from 'lucide-react';
 import { useRef, useState } from 'react';
 import { FloatingGenerateBox } from '@/components/Generation/FloatingGenerateBox';
 import { HistoryTable } from '@/components/History/HistoryTable';
@@ -90,7 +89,7 @@ export function MainEditor() {
             <h2 className="text-2xl font-bold">Voicebox</h2>
             <div className="flex gap-2">
               <Button variant="outline" onClick={handleImportClick}>
-                <HugeiconsIcon icon={Upload01Icon} size={16} className="mr-2 h-4 w-4" />
+                <Upload className="mr-2 h-4 w-4" />
                 Import Voice
               </Button>
               <input
@@ -101,7 +100,7 @@ export function MainEditor() {
                 className="hidden"
               />
               <Button onClick={() => setDialogOpen(true)}>
-                <HugeiconsIcon icon={SparklesIcon} size={16} className="mr-2 h-4 w-4" />
+                <Sparkles className="mr-2 h-4 w-4" />
                 Create Voice
               </Button>
             </div>

app/src/components/ServerSettings/DataFolders.tsx

@@ -1,112 +0,0 @@
-import { Folder01Icon, FolderOpenIcon } from '@hugeicons/core-free-icons';
-import { HugeiconsIcon } from '@hugeicons/react';
-import { Icon } from '@iconify/react';
-import { Button } from '@/components/ui/button';
-import { Card, CardContent, CardDescription, CardHeader, CardTitle } from '@/components/ui/card';
-import { Input } from '@/components/ui/input';
-import { useSystemFolders } from '@/lib/hooks/useSystemFolders';
-import { usePlatform } from '@/platform/PlatformContext';
-
-interface FolderRowProps {
-  label: string;
-  description: string;
-  path: string | undefined;
-  isLoading: boolean;
-  canOpen: boolean;
-  onOpen: () => void;
-}
-
-function FolderRow({ label, description, path, isLoading, canOpen, onOpen }: FolderRowProps) {
-  return (
-    <div className="space-y-1.5">
-      <div className="flex items-center justify-between">
-        <div>
-          <div className="text-sm font-medium">{label}</div>
-          <div className="text-xs text-muted-foreground">{description}</div>
-        </div>
-        {canOpen && path && (
-          <Button
-            variant="outline"
-            size="sm"
-            onClick={onOpen}
-            disabled={isLoading || !path}
-            className="shrink-0"
-          >
-            <HugeiconsIcon icon={FolderOpenIcon} size={16} className="h-4 w-4 mr-2" />
-            Open
-          </Button>
-        )}
-      </div>
-      <Input
-        value={isLoading ? 'Loading...' : path || 'Not available'}
-        readOnly
-        className="font-mono text-xs text-muted-foreground select-all cursor-text"
-      />
-    </div>
-  );
-}
-
-export function DataFolders() {
-  const { data: folders, isLoading, error } = useSystemFolders();
-  const platform = usePlatform();
-  const isTauri = platform.metadata.isTauri;
-
-  const handleOpenFolder = async (path: string | undefined) => {
-    if (!path) return;
-    const success = await platform.filesystem.openFolder(path);
-    if (!success && isTauri) {
-      console.error('Failed to open folder:', path);
-    }
-  };
-
-  return (
-    <Card>
-      <CardHeader>
-        <CardTitle className="flex items-center gap-2">
-          <HugeiconsIcon icon={Folder01Icon} size={20} className="h-5 w-5" />
-          Data Folders
-        </CardTitle>
-        <CardDescription>
-          {isTauri
-            ? 'Click "Open" to view folders in your file explorer, or copy the paths below.'
-            : 'These are the server-side folder paths where your data is stored.'}
-        </CardDescription>
-      </CardHeader>
-      <CardContent className="space-y-4">
-        {error ? (
-          <div className="flex items-center gap-2 text-sm text-destructive">
-            <Icon icon="lucide:alert-circle" className="h-4 w-4" />
-            <span>Failed to load folder paths: {error.message}</span>
-          </div>
-        ) : (
-          <>
-            <FolderRow
-              label="App Data"
-              description="Voices, generations, and app database"
-              path={folders?.data_dir}
-              isLoading={isLoading}
-              canOpen={isTauri}
-              onOpen={() => handleOpenFolder(folders?.data_dir)}
-            />
-            <FolderRow
-              label="Models"
-              description="Downloaded AI models from HuggingFace Hub"
-              path={folders?.models_dir}
-              isLoading={isLoading}
-              canOpen={isTauri}
-              onOpen={() => handleOpenFolder(folders?.models_dir)}
-            />
-            <FolderRow
-              label="Providers"
-              description="External TTS provider binaries (PyTorch CPU/CUDA)"
-              path={folders?.providers_dir}
-              isLoading={isLoading}
-              canOpen={isTauri}
-              onOpen={() => handleOpenFolder(folders?.providers_dir)}
-            />
-          </>
-        )}
-      </CardContent>
-    </Card>
-  );
-}

app/src/components/ServerSettings/GpuAcceleration.tsx

@@ -0,0 +1,387 @@
+import { useQuery, useQueryClient } from '@tanstack/react-query';
+import { AlertCircle, Cpu, Download, Loader2, RotateCw, Trash2, Zap } from 'lucide-react';
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { Badge } from '@/components/ui/badge';
+import { Button } from '@/components/ui/button';
+import { Card, CardContent, CardHeader, CardTitle } from '@/components/ui/card';
+import { Progress } from '@/components/ui/progress';
+import { apiClient } from '@/lib/api/client';
+import type { CudaDownloadProgress } from '@/lib/api/types';
+import { useServerHealth } from '@/lib/hooks/useServer';
+import { usePlatform } from '@/platform/PlatformContext';
+import { useServerStore } from '@/stores/serverStore';
+
+type RestartPhase = 'idle' | 'stopping' | 'waiting' | 'ready';
+
+export function GpuAcceleration() {
+  const platform = usePlatform();
+  const queryClient = useQueryClient();
+  const serverUrl = useServerStore((state) => state.serverUrl);
+  const { data: health } = useServerHealth();
+
+  const [restartPhase, setRestartPhase] = useState<RestartPhase>('idle');
+  const [error, setError] = useState<string | null>(null);
+  const [downloadProgress, setDownloadProgress] = useState<CudaDownloadProgress | null>(null);
+  const healthPollRef = useRef<ReturnType<typeof setInterval> | null>(null);
+
+  // Query CUDA backend status
+  const {
+    data: cudaStatus,
+    isLoading: cudaStatusLoading,
+    refetch: refetchCudaStatus,
+  } = useQuery({
+    queryKey: ['cuda-status', serverUrl],
+    queryFn: () => apiClient.getCudaStatus(),
+    refetchInterval: cudaStatusLoading ? false : 10000,
+    retry: 1,
+    enabled: !!health, // Only fetch when backend is reachable
+  });
+
+  // Derived state
+  const isCurrentlyCuda = health?.backend_variant === 'cuda';
+  const cudaAvailable = cudaStatus?.available ?? false;
+  const cudaDownloading = cudaStatus?.downloading ?? false;
+
+  // Clean up health poll on unmount
+  useEffect(() => {
+    return () => {
+      if (healthPollRef.current) {
+        clearInterval(healthPollRef.current);
+        healthPollRef.current = null;
+      }
+    };
+  }, []);
+
+  // SSE progress tracking during download
+  useEffect(() => {
+    if (!cudaDownloading || !serverUrl) {
+      return;
+    }
+
+    const eventSource = new EventSource(`${serverUrl}/backend/cuda-progress`);
+
+    eventSource.onmessage = (event) => {
+      try {
+        const data = JSON.parse(event.data) as CudaDownloadProgress;
+        setDownloadProgress(data);
+
+        if (data.status === 'complete') {
+          eventSource.close();
+          setDownloadProgress(null);
+          refetchCudaStatus();
+        } else if (data.status === 'error') {
+          eventSource.close();
+          setError(data.error || 'Download failed');
+          setDownloadProgress(null);
+          refetchCudaStatus();
+        }
+      } catch (e) {
+        console.error('Error parsing CUDA progress event:', e);
+      }
+    };
+
+    eventSource.onerror = () => {
+      eventSource.close();
+    };
+
+    return () => {
+      eventSource.close();
+    };
+  }, [cudaDownloading, serverUrl, refetchCudaStatus]);
+
+  // Start aggressive health polling during restart
+  const startHealthPolling = useCallback(() => {
+    if (healthPollRef.current) return;
+
+    healthPollRef.current = setInterval(async () => {
+      try {
+        const result = await apiClient.getHealth();
+        if (result.status === 'healthy') {
+          // Server is back up
+          if (healthPollRef.current) {
+            clearInterval(healthPollRef.current);
+            healthPollRef.current = null;
+          }
+          setRestartPhase('ready');
+          // Invalidate all queries to refresh UI
+          queryClient.invalidateQueries();
+          // Reset after a moment
+          setTimeout(() => setRestartPhase('idle'), 2000);
+        }
+      } catch {
+        // Server still down, keep polling
+      }
+    }, 1000);
+  }, [queryClient]);
+
+  const handleDownload = async () => {
+    setError(null);
+    try {
+      await apiClient.downloadCudaBackend();
+      refetchCudaStatus();
+    } catch (e: unknown) {
+      const msg = e instanceof Error ? e.message : 'Failed to start download';
+      if (msg.includes('already downloaded')) {
+        refetchCudaStatus();
+      } else {
+        setError(msg);
+      }
+    }
+  };
+
+  const handleRestart = async () => {
+    setError(null);
+    setRestartPhase('stopping');
+
+    try {
+      setRestartPhase('waiting');
+      startHealthPolling();
+      await platform.lifecycle.restartServer();
+      // Invoke resolved — server is likely ready. Stop polling and refresh.
+      if (healthPollRef.current) {
+        clearInterval(healthPollRef.current);
+        healthPollRef.current = null;
+      }
+      setRestartPhase('ready');
+      queryClient.invalidateQueries();
+      setTimeout(() => setRestartPhase('idle'), 2000);
+    } catch (e: unknown) {
+      setRestartPhase('idle');
+      if (healthPollRef.current) {
+        clearInterval(healthPollRef.current);
+        healthPollRef.current = null;
+      }
+      setError(e instanceof Error ? e.message : 'Restart failed');
+    }
+  };
+
+  const handleSwitchToCpu = async () => {
+    // To switch to CPU: delete the CUDA binary, then restart.
+    // start_server always prefers CUDA if present, so we must remove it first.
+    setError(null);
+    setRestartPhase('stopping');
+
+    try {
+      await apiClient.deleteCudaBackend();
+      setRestartPhase('waiting');
+      startHealthPolling();
+      await platform.lifecycle.restartServer();
+      // Invoke resolved — server is likely ready
+      if (healthPollRef.current) {
+        clearInterval(healthPollRef.current);
+        healthPollRef.current = null;
+      }
+      setRestartPhase('ready');
+      queryClient.invalidateQueries();
+      setTimeout(() => setRestartPhase('idle'), 2000);
+    } catch (e: unknown) {
+      setRestartPhase('idle');
+      if (healthPollRef.current) {
+        clearInterval(healthPollRef.current);
+        healthPollRef.current = null;
+      }
+      setError(e instanceof Error ? e.message : 'Failed to switch to CPU');
+      refetchCudaStatus();
+    }
+  };
+
+  const handleDelete = async () => {
+    setError(null);
+    try {
+      await apiClient.deleteCudaBackend();
+      refetchCudaStatus();
+    } catch (e: unknown) {
+      setError(e instanceof Error ? e.message : 'Failed to delete CUDA backend');
+    }
+  };
+
+  const formatBytes = (bytes: number): string => {
+    if (bytes === 0) return '0 B';
+    const k = 1024;
+    const sizes = ['B', 'KB', 'MB', 'GB'];
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+    return `${(bytes / k ** i).toFixed(1)} ${sizes[i]}`;
+  };
+
+  // Don't render until health data is available
+  if (!health) return null;
+
+  // If the system already has native GPU (MPS, etc.), only show info - no CUDA needed
+  const hasNativeGpu =
+    health.gpu_available &&
+    !isCurrentlyCuda &&
+    health.gpu_type &&
+    !health.gpu_type.includes('CUDA');
+
+  return (
+    <Card>
+      <CardHeader>
+        <CardTitle className="flex items-center gap-2">
+          <Zap className="h-4 w-4" />
+          GPU Acceleration
+        </CardTitle>
+      </CardHeader>
+      <CardContent className="space-y-4">
+        {/* Current status */}
+        <div className="flex items-center justify-between">
+          <div className="space-y-1">
+            <div className="text-sm font-medium">Backend</div>
+            <div className="text-sm text-muted-foreground">
+              {isCurrentlyCuda ? 'CUDA (GPU accelerated)' : 'CPU'}
+            </div>
+          </div>
+          <Badge variant={isCurrentlyCuda ? 'default' : 'secondary'}>
+            {isCurrentlyCuda ? (
+              <>
+                <Zap className="h-3 w-3 mr-1" /> CUDA
+              </>
+            ) : (
+              <>
+                <Cpu className="h-3 w-3 mr-1" /> CPU
+              </>
+            )}
+          </Badge>
+        </div>
+
+        {/* GPU info from health */}
+        {health.gpu_type && (
+          <div className="space-y-1">
+            <div className="text-sm font-medium">GPU</div>
+            <div className="text-sm text-muted-foreground">{health.gpu_type}</div>
+            {health.vram_used_mb != null && (
+              <div className="text-xs text-muted-foreground">
+                VRAM: {health.vram_used_mb.toFixed(0)} MB used
+              </div>
+            )}
+          </div>
+        )}
+
+        {/* Native GPU detected - no CUDA download needed */}
+        {hasNativeGpu && (
+          <div className="p-3 rounded-lg bg-accent/10 border border-accent/20">
+            <div className="text-sm">
+              Your system uses <strong>{health.gpu_type}</strong> for acceleration. No additional
+              downloads needed.
+            </div>
+          </div>
+        )}
+
+        {/* CUDA download section - only show when native GPU is NOT detected (i.e., Windows/Linux NVIDIA users) */}
+        {!hasNativeGpu && (
+          <>
+            {/* Download progress */}
+            {cudaDownloading && downloadProgress && (
+              <div className="space-y-2">
+                <div className="flex items-center justify-between text-sm">
+                  <div className="flex items-center gap-2">
+                    <Loader2 className="h-4 w-4 animate-spin" />
+                    <span>{downloadProgress.filename || 'Downloading CUDA backend...'}</span>
+                  </div>
+                  {downloadProgress.total > 0 && (
+                    <span className="text-muted-foreground">
+                      {downloadProgress.progress.toFixed(1)}%
+                    </span>
+                  )}
+                </div>
+                {downloadProgress.total > 0 && (
+                  <>
+                    <Progress value={downloadProgress.progress} className="h-2" />
+                    <div className="text-xs text-muted-foreground">
+                      {formatBytes(downloadProgress.current)} /{' '}
+                      {formatBytes(downloadProgress.total)}
+                    </div>
+                  </>
+                )}
+              </div>
+            )}
+
+            {/* Restart in progress */}
+            {restartPhase !== 'idle' && (
+              <div className="flex items-center gap-2 p-3 rounded-lg bg-primary/5 border">
+                <Loader2 className="h-4 w-4 animate-spin" />
+                <span className="text-sm">
+                  {restartPhase === 'stopping' && 'Stopping server...'}
+                  {restartPhase === 'waiting' && 'Restarting server...'}
+                  {restartPhase === 'ready' && 'Server restarted successfully!'}
+                </span>
+              </div>
+            )}
+
+            {/* Error display */}
+            {error && (
+              <div className="flex items-center gap-2 text-sm text-destructive">
+                <AlertCircle className="h-4 w-4 shrink-0" />
+                <span>{error}</span>
+              </div>
+            )}
+
+            {/* Actions */}
+            {restartPhase === 'idle' && !cudaDownloading && (
+              <div className="space-y-2">
+                {/* Not downloaded yet - show download button */}
+                {!cudaAvailable && (
+                  <div className="space-y-3">
+                    <p className="text-sm text-muted-foreground">
+                      Download the CUDA backend (~2.4 GB) for NVIDIA GPU acceleration. Requires an
+                      NVIDIA GPU with CUDA support.
+                    </p>
+                    <Button onClick={handleDownload} className="w-full" size="sm">
+                      <Download className="h-4 w-4 mr-2" />
+                      Download CUDA Backend
+                    </Button>
+                  </div>
+                )}
+
+                {/* Downloaded but not active - show switch button */}
+                {cudaAvailable && !isCurrentlyCuda && platform.metadata.isTauri && (
+                  <div className="space-y-3">
+                    <p className="text-sm text-muted-foreground">
+                      CUDA backend is downloaded and ready. Restart the server to enable GPU
+                      acceleration.
+                    </p>
+                    <Button onClick={handleRestart} className="w-full" size="sm">
+                      <RotateCw className="h-4 w-4 mr-2" />
+                      Switch to CUDA Backend
+                    </Button>
+                  </div>
+                )}
+
+                {/* Currently active - show switch back to CPU */}
+                {isCurrentlyCuda && platform.metadata.isTauri && (
+                  <div className="space-y-3">
+                    <p className="text-sm text-muted-foreground">
+                      Running with CUDA GPU acceleration. Switch back to CPU if needed (you can
+                      re-download later).
+                    </p>
+                    <Button
+                      onClick={handleSwitchToCpu}
+                      variant="outline"
+                      className="w-full"
+                      size="sm"
+                    >
+                      <RotateCw className="h-4 w-4 mr-2" />
+                      Switch to CPU Backend
+                    </Button>
+                  </div>
+                )}
+
+                {/* Delete option when downloaded (and not active) */}
+                {cudaAvailable && !isCurrentlyCuda && (
+                  <Button
+                    onClick={handleDelete}
+                    variant="ghost"
+                    className="w-full text-muted-foreground hover:text-destructive"
+                    size="sm"
+                  >
+                    <Trash2 className="h-4 w-4 mr-2" />
+                    Remove CUDA Backend
+                  </Button>
+                )}
+              </div>
+            )}
+          </>
+        )}
+      </CardContent>
+    </Card>
+  );
+}

app/src/components/ServerSettings/ModelManagement.tsx

@@ -1,7 +1,5 @@
-import { Delete01Icon, Download01Icon } from '@hugeicons/core-free-icons';
-import { HugeiconsIcon } from '@hugeicons/react';
-import { Icon } from '@iconify/react';
 import { useMutation, useQuery, useQueryClient } from '@tanstack/react-query';
+import { ChevronDown, ChevronUp, Download, Loader2, RotateCcw, Trash2, X } from 'lucide-react';
 import { useCallback, useState } from 'react';
 import {
   AlertDialog,
@@ -18,6 +16,7 @@ import { Button } from '@/components/ui/button';
 import { Card, CardContent, CardDescription, CardHeader, CardTitle } from '@/components/ui/card';
 import { useToast } from '@/components/ui/use-toast';
 import { apiClient } from '@/lib/api/client';
+import type { ActiveDownloadTask } from '@/lib/api/types';
 import { useModelDownloadToast } from '@/lib/hooks/useModelDownloadToast';
 
 export function ModelManagement() {
@@ -25,6 +24,9 @@ export function ModelManagement() {
   const queryClient = useQueryClient();
   const [downloadingModel, setDownloadingModel] = useState<string | null>(null);
   const [downloadingDisplayName, setDownloadingDisplayName] = useState<string | null>(null);
+  const [consoleOpen, setConsoleOpen] = useState(false);
+  const [dismissedErrors, setDismissedErrors] = useState<Set<string>>(new Set());
+  const [localErrors, setLocalErrors] = useState<Map<string, string>>(new Map());
 
   const { data: modelStatus, isLoading } = useQuery({
     queryKey: ['modelStatus'],
@@ -37,19 +39,60 @@ export function ModelManagement() {
     refetchInterval: 5000, // Refresh every 5 seconds
   });
 
+  const { data: activeTasks } = useQuery({
+    queryKey: ['activeTasks'],
+    queryFn: () => apiClient.getActiveTasks(),
+    refetchInterval: 5000,
+  });
+
+  // Build a map of errored downloads for quick lookup, excluding dismissed ones
+  // Merge server errors with locally captured SSE errors
+  const erroredDownloads = new Map<string, ActiveDownloadTask>();
+  if (activeTasks?.downloads) {
+    for (const dl of activeTasks.downloads) {
+      if (dl.status === 'error' && !dismissedErrors.has(dl.model_name)) {
+        // Prefer locally captured error (from SSE) over server error
+        const localErr = localErrors.get(dl.model_name);
+        erroredDownloads.set(dl.model_name, localErr ? { ...dl, error: localErr } : dl);
+      }
+    }
+  }
+  // Also add locally captured errors that aren't in server response yet
+  for (const [modelName, error] of localErrors) {
+    if (!erroredDownloads.has(modelName) && !dismissedErrors.has(modelName)) {
+      erroredDownloads.set(modelName, {
+        model_name: modelName,
+        status: 'error',
+        started_at: new Date().toISOString(),
+        error,
+      });
+    }
+  }
+
+  const errorCount = erroredDownloads.size;
+
   // Callbacks for download completion
   const handleDownloadComplete = useCallback(() => {
     console.log('[ModelManagement] Download complete, clearing state');
     setDownloadingModel(null);
     setDownloadingDisplayName(null);
     queryClient.invalidateQueries({ queryKey: ['modelStatus'] });
+    queryClient.invalidateQueries({ queryKey: ['activeTasks'] });
   }, [queryClient]);
 
-  const handleDownloadError = useCallback(() => {
-    console.log('[ModelManagement] Download error, clearing state');
-    setDownloadingModel(null);
-    setDownloadingDisplayName(null);
-  }, []);
+  const handleDownloadError = useCallback(
+    (error: string) => {
+      console.log('[ModelManagement] Download error, clearing state');
+      if (downloadingModel) {
+        setLocalErrors((prev) => new Map(prev).set(downloadingModel, error));
+        setConsoleOpen(true);
+      }
+      setDownloadingModel(null);
+      setDownloadingDisplayName(null);
+      queryClient.invalidateQueries({ queryKey: ['activeTasks'] });
+    },
+    [queryClient, downloadingModel],
+  );
 
   // Use progress toast hook for the downloading model
   useModelDownloadToast({
@@ -69,6 +112,12 @@ export function ModelManagement() {
 
   const handleDownload = async (modelName: string) => {
     console.log('[Download] Button clicked for:', modelName, 'at', new Date().toISOString());
+    // Clear any previous dismissal so fresh errors can appear
+    setDismissedErrors((prev) => {
+      const next = new Set(prev);
+      next.delete(modelName);
+      return next;
+    });
 
     // Find display name
     const model = modelStatus?.models.find((m) => m.model_name === modelName);
@@ -89,6 +138,7 @@ export function ModelManagement() {
       // Download initiated successfully - state will be cleared when SSE reports completion
       // or by the polling interval detecting the model is downloaded
       queryClient.invalidateQueries({ queryKey: ['modelStatus'] });
+      queryClient.invalidateQueries({ queryKey: ['activeTasks'] });
     } catch (error) {
       console.error('[Download] Download failed:', error);
       setDownloadingModel(null);
@@ -101,6 +151,61 @@ export function ModelManagement() {
     }
   };
 
+  const cancelMutation = useMutation({
+    mutationFn: (modelName: string) => apiClient.cancelDownload(modelName),
+    onSuccess: async () => {
+      await queryClient.invalidateQueries({ queryKey: ['modelStatus'], refetchType: 'all' });
+      await queryClient.invalidateQueries({ queryKey: ['activeTasks'], refetchType: 'all' });
+    },
+  });
+
+  const handleCancel = (modelName: string) => {
+    // Snapshot previous state for rollback
+    const prevDismissed = dismissedErrors;
+    const prevLocalErrors = localErrors;
+    const prevDownloadingModel = downloadingModel;
+    const prevDownloadingDisplayName = downloadingDisplayName;
+
+    // Optimistically hide the error and suppress downloading state in UI
+    setDismissedErrors((prev) => new Set(prev).add(modelName));
+    setLocalErrors((prev) => {
+      const next = new Map(prev);
+      next.delete(modelName);
+      return next;
+    });
+    if (downloadingModel === modelName) {
+      setDownloadingModel(null);
+      setDownloadingDisplayName(null);
+    }
+
+    cancelMutation.mutate(modelName, {
+      onError: () => {
+        // Rollback optimistic updates on failure
+        setDismissedErrors(prevDismissed);
+        setLocalErrors(prevLocalErrors);
+        setDownloadingModel(prevDownloadingModel);
+        setDownloadingDisplayName(prevDownloadingDisplayName);
+        toast({
+          title: 'Cancel failed',
+          description: 'Could not cancel the download task.',
+          variant: 'destructive',
+        });
+      },
+    });
+  };
+
+  const clearAllMutation = useMutation({
+    mutationFn: () => apiClient.clearAllTasks(),
+    onSuccess: async () => {
+      setDismissedErrors(new Set());
+      setLocalErrors(new Map());
+      setDownloadingModel(null);
+      setDownloadingDisplayName(null);
+      await queryClient.invalidateQueries({ queryKey: ['modelStatus'], refetchType: 'all' });
+      await queryClient.invalidateQueries({ queryKey: ['activeTasks'], refetchType: 'all' });
+    },
+  });
+
   const deleteMutation = useMutation({
     mutationFn: async (modelName: string) => {
       console.log('[Delete] Deleting model:', modelName);
@@ -116,14 +221,11 @@ export function ModelManagement() {
       });
       setDeleteDialogOpen(false);
       setModelToDelete(null);
-      // Invalidate AND explicitly refetch to ensure UI updates
-      // Using refetchType: 'all' ensures we refetch even if the query is stale
       console.log('[Delete] Invalidating modelStatus query');
       await queryClient.invalidateQueries({
         queryKey: ['modelStatus'],
         refetchType: 'all',
       });
-      // Also explicitly refetch to guarantee fresh data
       console.log('[Delete] Explicitly refetching modelStatus query');
       await queryClient.refetchQueries({ queryKey: ['modelStatus'] });
       console.log('[Delete] Query refetched');
@@ -155,10 +257,7 @@ export function ModelManagement() {
       <CardContent className="space-y-4">
         {isLoading ? (
           <div className="flex items-center justify-center py-8">
-            <Icon
-              icon="svg-spinners:ring-resize"
-              className="h-6 w-6 animate-spin text-muted-foreground"
-            />
+            <Loader2 className="h-6 w-6 animate-spin text-muted-foreground" />
           </div>
         ) : modelStatus ? (
           <div className="space-y-4">
@@ -183,13 +282,47 @@ export function ModelManagement() {
                         });
                         setDeleteDialogOpen(true);
                       }}
+                      onCancel={() => handleCancel(model.model_name)}
                       isDownloading={downloadingModel === model.model_name}
+                      isCancelling={
+                        cancelMutation.isPending && cancelMutation.variables === model.model_name
+                      }
+                      isDismissed={dismissedErrors.has(model.model_name)}
+                      erroredDownload={erroredDownloads.get(model.model_name)}
                       formatSize={formatSize}
                     />
                   ))}
               </div>
             </div>
 
+            {/* LuxTTS Models */}
+            {modelStatus.models.some((m) => m.model_name.startsWith('luxtts')) && (
+              <div>
+                <h3 className="text-sm font-semibold mb-3 text-muted-foreground">LuxTTS Models</h3>
+                <div className="space-y-2">
+                  {modelStatus.models
+                    .filter((m) => m.model_name.startsWith('luxtts'))
+                    .map((model) => (
+                      <ModelItem
+                        key={model.model_name}
+                        model={model}
+                        onDownload={() => handleDownload(model.model_name)}
+                        onDelete={() => {
+                          setModelToDelete({
+                            name: model.model_name,
+                            displayName: model.display_name,
+                            sizeMb: model.size_mb,
+                          });
+                          setDeleteDialogOpen(true);
+                        }}
+                        isDownloading={downloadingModel === model.model_name}
+                        formatSize={formatSize}
+                      />
+                    ))}
+                </div>
+              </div>
+            )}
+
             {/* Whisper Models */}
             <div>
               <h3 className="text-sm font-semibold mb-3 text-muted-foreground">
@@ -211,12 +344,79 @@ export function ModelManagement() {
                         });
                         setDeleteDialogOpen(true);
                       }}
+                      onCancel={() => handleCancel(model.model_name)}
                       isDownloading={downloadingModel === model.model_name}
+                      isCancelling={
+                        cancelMutation.isPending && cancelMutation.variables === model.model_name
+                      }
+                      isDismissed={dismissedErrors.has(model.model_name)}
+                      erroredDownload={erroredDownloads.get(model.model_name)}
                       formatSize={formatSize}
                     />
                   ))}
               </div>
             </div>
+
+            {/* Console Panel */}
+            {errorCount > 0 && (
+              <div className="border rounded-lg overflow-hidden">
+                <div className="flex items-center justify-between px-3 py-1.5 bg-muted/50 text-xs font-medium text-muted-foreground">
+                  <button
+                    type="button"
+                    onClick={() => setConsoleOpen((v) => !v)}
+                    className="flex items-center gap-2 hover:text-foreground transition-colors"
+                  >
+                    {consoleOpen ? (
+                      <ChevronUp className="h-3.5 w-3.5" />
+                    ) : (
+                      <ChevronDown className="h-3.5 w-3.5" />
+                    )}
+                    <span>Problems</span>
+                    <Badge variant="destructive" className="text-[10px] h-4 px-1.5 rounded-full">
+                      {errorCount}
+                    </Badge>
+                  </button>
+                  <Button
+                    size="sm"
+                    variant="ghost"
+                    className="h-6 px-2 text-xs text-muted-foreground hover:text-foreground"
+                    onClick={() => clearAllMutation.mutate()}
+                    disabled={clearAllMutation.isPending}
+                  >
+                    <RotateCcw className="h-3 w-3 mr-1" />
+                    Clear All
+                  </Button>
+                </div>
+                {consoleOpen && (
+                  <div className="bg-[#1e1e1e] text-[#d4d4d4] p-3 max-h-48 overflow-auto font-mono text-xs leading-relaxed">
+                    {Array.from(erroredDownloads.entries()).map(([modelName, dl]) => (
+                      <div key={modelName} className="mb-2 last:mb-0">
+                        <span className="text-[#f44747]">[error]</span>{' '}
+                        <span className="text-[#569cd6]">{modelName}</span>
+                        {dl.error ? (
+                          <>
+                            {': '}
+                            <span className="text-[#ce9178] whitespace-pre-wrap break-all">
+                              {dl.error}
+                            </span>
+                          </>
+                        ) : (
+                          <>
+                            {': '}
+                            <span className="text-[#808080]">
+                              No error details available. Try downloading again.
+                            </span>
+                          </>
+                        )}
+                        <div className="text-[#6a9955] mt-0.5">
+                          started at {new Date(dl.started_at).toLocaleString()}
+                        </div>
+                      </div>
+                    ))}
+                  </div>
+                )}
+              </div>
+            )}
           </div>
         ) : null}
       </CardContent>
@@ -250,7 +450,7 @@ export function ModelManagement() {
             >
               {deleteMutation.isPending ? (
                 <>
-                  <Icon icon="svg-spinners:ring-resize" className="h-4 w-4 mr-2 animate-spin" />
+                  <Loader2 className="h-4 w-4 mr-2 animate-spin" />
                   Deleting...
                 </>
               ) : (
@@ -275,17 +475,32 @@ interface ModelItemProps {
   };
   onDownload: () => void;
   onDelete: () => void;
+  onCancel: () => void;
   isDownloading: boolean; // Local state - true if user just clicked download
+  isCancelling: boolean;
+  isDismissed: boolean;
+  erroredDownload?: ActiveDownloadTask;
   formatSize: (sizeMb?: number) => string;
 }
 
-function ModelItem({ model, onDownload, onDelete, isDownloading, formatSize }: ModelItemProps) {
+function ModelItem({
+  model,
+  onDownload,
+  onDelete,
+  onCancel,
+  isDownloading,
+  isCancelling,
+  isDismissed,
+  erroredDownload,
+  formatSize,
+}: ModelItemProps) {
   // Use server's downloading state OR local state (for immediate feedback before server updates)
-  const showDownloading = model.downloading || isDownloading;
+  // Suppress downloading if user just dismissed/cancelled this model
+  const showDownloading = (model.downloading || isDownloading) && !erroredDownload && !isDismissed;
 
   return (
     <div className="flex items-center justify-between p-3 border rounded-lg">
-      <div className="flex-1">
+      <div className="flex-1 min-w-0">
         <div className="flex items-center gap-2">
           <span className="font-medium text-sm">{model.display_name}</span>
           {model.loaded && (
@@ -293,21 +508,41 @@ function ModelItem({ model, onDownload, onDelete, isDownloading, formatSize }: M
               Loaded
             </Badge>
           )}
-          {/* Only show Downloaded if actually downloaded AND not downloading */}
-          {model.downloaded && !model.loaded && !showDownloading && (
+          {model.downloaded && !model.loaded && !showDownloading && !erroredDownload && (
             <Badge variant="secondary" className="text-xs">
               Downloaded
             </Badge>
           )}
+          {erroredDownload && (
+            <Badge variant="destructive" className="text-xs">
+              Error
+            </Badge>
+          )}
         </div>
-        {model.downloaded && model.size_mb && !showDownloading && (
+        {model.downloaded && model.size_mb && !showDownloading && !erroredDownload && (
           <div className="text-xs text-muted-foreground mt-1">
             Size: {formatSize(model.size_mb)}
           </div>
         )}
       </div>
-      <div className="flex items-center gap-2">
-        {model.downloaded && !showDownloading ? (
+      <div className="flex items-center gap-2 shrink-0 ml-2">
+        {erroredDownload ? (
+          <div className="flex items-center gap-2">
+            <Button size="sm" onClick={onDownload} variant="outline">
+              <Download className="h-4 w-4 mr-2" />
+              Retry
+            </Button>
+            <Button
+              size="sm"
+              onClick={onCancel}
+              variant="ghost"
+              disabled={isCancelling}
+              title="Dismiss error"
+            >
+              <X className="h-4 w-4" />
+            </Button>
+          </div>
+        ) : model.downloaded && !showDownloading ? (
           <div className="flex items-center gap-2">
             <div className="flex items-center gap-1 text-sm text-muted-foreground">
               <span>Ready</span>
@@ -319,17 +554,28 @@ function ModelItem({ model, onDownload, onDelete, isDownloading, formatSize }: M
               disabled={model.loaded}
               title={model.loaded ? 'Unload model before deleting' : 'Delete model'}
             >
-              <HugeiconsIcon icon={Delete01Icon} size={16} className="h-4 w-4" />
+              <Trash2 className="h-4 w-4" />
             </Button>
           </div>
         ) : showDownloading ? (
-          <Button size="sm" variant="outline" disabled>
-            <Icon icon="svg-spinners:ring-resize" className="h-4 w-4 mr-2 animate-spin" />
-            Downloading...
-          </Button>
+          <div className="flex items-center gap-2">
+            <Button size="sm" variant="outline" disabled>
+              <Loader2 className="h-4 w-4 mr-2 animate-spin" />
+              Downloading...
+            </Button>
+            <Button
+              size="sm"
+              onClick={onCancel}
+              variant="ghost"
+              disabled={isCancelling}
+              title="Cancel download"
+            >
+              <X className="h-4 w-4" />
+            </Button>
+          </div>
         ) : (
           <Button size="sm" onClick={onDownload} variant="outline">
-            <HugeiconsIcon icon={Download01Icon} size={16} className="h-4 w-4 mr-2" />
+            <Download className="h-4 w-4 mr-2" />
             Download
           </Button>
         )}

app/src/components/ServerSettings/ModelProgress.tsx

@@ -1,6 +1,4 @@
-import { CancelCircleIcon } from '@hugeicons/core-free-icons';
-import { HugeiconsIcon } from '@hugeicons/react';
-import { Icon } from '@iconify/react';
+import { Loader2, XCircle } from 'lucide-react';
 import { useEffect, useState } from 'react';
 import { Card, CardContent, CardHeader, CardTitle } from '@/components/ui/card';
 import { Progress } from '@/components/ui/progress';
@@ -14,11 +12,7 @@ interface ModelProgressProps {
   isDownloading?: boolean;
 }
 
-export function ModelProgress({
-  modelName,
-  displayName,
-  isDownloading = false,
-}: ModelProgressProps) {
+export function ModelProgress({ modelName, displayName, isDownloading = false }: ModelProgressProps) {
   const [progress, setProgress] = useState<ModelProgressType | null>(null);
   const serverUrl = useServerStore((state) => state.serverUrl);
 
@@ -80,12 +74,10 @@ export function ModelProgress({
   const getStatusIcon = () => {
     switch (progress.status) {
       case 'error':
-        return (
-          <HugeiconsIcon icon={CancelCircleIcon} size={16} className="h-4 w-4 text-destructive" />
-        );
+        return <XCircle className="h-4 w-4 text-destructive" />;
       case 'downloading':
       case 'extracting':
-        return <Icon icon="svg-spinners:ring-resize" className="h-4 w-4 animate-spin" />;
+        return <Loader2 className="h-4 w-4 animate-spin" />;
       default:
         return null;
     }

app/src/components/ServerSettings/ProviderSettings.tsx

@@ -1,400 +0,0 @@
-import { Delete01Icon, Download01Icon } from '@hugeicons/core-free-icons';
-import { HugeiconsIcon } from '@hugeicons/react';
-import { Icon } from '@iconify/react';
-import { useMutation, useQuery, useQueryClient } from '@tanstack/react-query';
-import { useCallback, useState } from 'react';
-import {
-  AlertDialog,
-  AlertDialogAction,
-  AlertDialogCancel,
-  AlertDialogContent,
-  AlertDialogDescription,
-  AlertDialogFooter,
-  AlertDialogHeader,
-  AlertDialogTitle,
-} from '@/components/ui/alert-dialog';
-import { Button } from '@/components/ui/button';
-import { Card, CardContent, CardDescription, CardHeader, CardTitle } from '@/components/ui/card';
-import { Label } from '@/components/ui/label';
-import { RadioGroup, RadioGroupItem } from '@/components/ui/radio-group';
-import { useToast } from '@/components/ui/use-toast';
-import { apiClient } from '@/lib/api/client';
-import { useModelDownloadToast } from '@/lib/hooks/useModelDownloadToast';
-
-const isMacOS = () => navigator.platform.toLowerCase().includes('mac');
-const isWindows = () => navigator.platform.toLowerCase().includes('win');
-const getPlatformName = () => {
-  if (isMacOS()) return 'macOS';
-  if (isWindows()) return 'Windows';
-  return 'Linux';
-};
-
-type ProviderType =
-  | 'auto'
-  | 'apple-mlx'
-  | 'bundled-pytorch'
-  | 'pytorch-cpu'
-  | 'pytorch-cuda'
-  | 'remote'
-  | 'openai';
-
-export function ProviderSettings() {
-  const { toast } = useToast();
-  const queryClient = useQueryClient();
-  const [downloadingProvider, setDownloadingProvider] = useState<string | null>(null);
-
-  const { data: providersData, isLoading } = useQuery({
-    queryKey: ['providers'],
-    queryFn: async () => {
-      return await apiClient.listProviders();
-    },
-    refetchInterval: 5000,
-  });
-
-  const { data: activeProvider } = useQuery({
-    queryKey: ['activeProvider'],
-    queryFn: async () => {
-      return await apiClient.getActiveProvider();
-    },
-    refetchInterval: 5000,
-  });
-
-  // Callbacks for download completion
-  const handleDownloadComplete = useCallback(() => {
-    setDownloadingProvider(null);
-    queryClient.invalidateQueries({ queryKey: ['providers'] });
-  }, [queryClient]);
-
-  const handleDownloadError = useCallback(() => {
-    setDownloadingProvider(null);
-  }, []);
-
-  // Use progress toast hook for the downloading provider
-  useModelDownloadToast({
-    modelName: downloadingProvider || '',
-    displayName: downloadingProvider || '',
-    enabled: !!downloadingProvider,
-    onComplete: handleDownloadComplete,
-    onError: handleDownloadError,
-  });
-
-  const [deleteDialogOpen, setDeleteDialogOpen] = useState(false);
-  const [providerToDelete, setProviderToDelete] = useState<string | null>(null);
-
-  const downloadMutation = useMutation({
-    mutationFn: async (providerType: string) => {
-      return await apiClient.downloadProvider(providerType);
-    },
-    onSuccess: (_, providerType) => {
-      setDownloadingProvider(providerType);
-      queryClient.invalidateQueries({ queryKey: ['providers'] });
-    },
-    onError: (error: Error) => {
-      toast({
-        title: 'Download failed',
-        description: error.message,
-        variant: 'destructive',
-      });
-    },
-  });
-
-  const startMutation = useMutation({
-    mutationFn: async (providerType: string) => {
-      return await apiClient.startProvider(providerType);
-    },
-    onSuccess: () => {
-      queryClient.invalidateQueries({ queryKey: ['activeProvider'] });
-      toast({
-        title: 'Provider started',
-        description: 'The provider has been started successfully',
-      });
-    },
-    onError: (error: Error) => {
-      toast({
-        title: 'Failed to start provider',
-        description: error.message,
-        variant: 'destructive',
-      });
-    },
-  });
-
-  const deleteMutation = useMutation({
-    mutationFn: async (providerType: string) => {
-      return await apiClient.deleteProvider(providerType);
-    },
-    onSuccess: () => {
-      queryClient.invalidateQueries({ queryKey: ['providers'] });
-      toast({
-        title: 'Provider deleted',
-        description: 'The provider has been deleted successfully',
-      });
-    },
-    onError: (error: Error) => {
-      toast({
-        title: 'Failed to delete provider',
-        description: error.message,
-        variant: 'destructive',
-      });
-    },
-  });
-
-  const handleDownload = async (providerType: string) => {
-    downloadMutation.mutate(providerType);
-  };
-
-  const handleStart = async (providerType: string) => {
-    startMutation.mutate(providerType);
-  };
-
-  const handleDelete = (providerType: string) => {
-    setProviderToDelete(providerType);
-    setDeleteDialogOpen(true);
-  };
-
-  const confirmDelete = () => {
-    if (providerToDelete) {
-      deleteMutation.mutate(providerToDelete);
-      setDeleteDialogOpen(false);
-      setProviderToDelete(null);
-    }
-  };
-
-  if (isLoading) {
-    return (
-      <Card>
-        <CardHeader>
-          <CardTitle>TTS Provider</CardTitle>
-          <CardDescription>Choose how Voicebox generates speech</CardDescription>
-        </CardHeader>
-        <CardContent>
-          <div className="flex items-center justify-center py-8">
-            <Icon icon="svg-spinners:ring-resize" className="h-6 w-6 animate-spin" />
-          </div>
-        </CardContent>
-      </Card>
-    );
-  }
-
-  const installedProviders = providersData?.installed || [];
-
-  // Determine current active provider
-  const currentProvider = activeProvider?.provider;
-  console.log('currentProvider', currentProvider);
-  const selectedProvider = currentProvider as ProviderType;
-
-  const isStarting = startMutation.isPending;
-
-  return (
-    <>
-      <Card>
-        <CardHeader>
-          <CardTitle>TTS Provider</CardTitle>
-          <CardDescription>Choose how Voicebox generates speech.</CardDescription>
-        </CardHeader>
-        <CardContent className="relative">
-          {isStarting && (
-            <div className="absolute inset-0 bg-background/80 backdrop-blur-sm flex items-center justify-center z-10 rounded-lg">
-              <div className="flex items-center gap-2 text-muted-foreground">
-                <Icon icon="svg-spinners:ring-resize" className="h-5 w-5" />
-                <span>Starting provider...</span>
-              </div>
-            </div>
-          )}
-          <RadioGroup
-            value={selectedProvider}
-            onValueChange={(value) => handleStart(value)}
-            disabled={isStarting}
-          >
-            {/* PyTorch CUDA */}
-            <div className="flex items-center justify-between py-2">
-              <div className={`flex items-center space-x-3 flex-1 ${isMacOS() || !installedProviders.includes('pytorch-cuda') ? 'opacity-50' : ''}`}>
-                <RadioGroupItem value="pytorch-cuda" id="cuda" disabled={isMacOS() || isStarting || !installedProviders.includes('pytorch-cuda')} />
-                <Label
-                  htmlFor="cuda"
-                  className={`flex-1 ${isMacOS() || isStarting || !installedProviders.includes('pytorch-cuda') ? 'cursor-not-allowed' : 'cursor-pointer'}`}
-                >
-                  <div className="font-medium">PyTorch CUDA</div>
-                  <div className="text-sm text-muted-foreground">
-                    NVIDIA GPU-accelerated provider
-                  </div>
-                </Label>
-              </div>
-              <div className="flex items-center gap-2">
-                {isMacOS() && (
-                  <>
-                    <span className="text-xs text-muted-foreground">2.4GB</span>
-                    <Button size="sm" variant="secondary" disabled>
-                      Not Available on macOS
-                    </Button>
-                  </>
-                )}
-                {!isMacOS() && !installedProviders.includes('pytorch-cuda') && (
-                  <>
-                    <span className="text-xs text-muted-foreground">2.4GB</span>
-                    <Button
-                      onClick={() => handleDownload('pytorch-cuda')}
-                      size="sm"
-                      variant="outline"
-                      disabled={downloadingProvider === 'pytorch-cuda' || isStarting}
-                      className="shrink-0"
-                    >
-                      {downloadingProvider === 'pytorch-cuda' ? (
-                        <Icon icon="svg-spinners:ring-resize" className="h-4 w-4 animate-spin" />
-                      ) : (
-                        <>
-                          <HugeiconsIcon icon={Download01Icon} size={16} className="h-4 w-4 mr-2" />
-                          Download
-                        </>
-                      )}
-                    </Button>
-                  </>
-                )}
-                {installedProviders.includes('pytorch-cuda') && (
-                  <Button
-                    onClick={() => handleDelete('pytorch-cuda')}
-                    size="sm"
-                    variant="outline"
-                    disabled={isStarting}
-                    className="shrink-0"
-                  >
-                    <HugeiconsIcon icon={Delete01Icon} size={16} className="h-4 w-4 mr-2" />
-                    Uninstall
-                  </Button>
-                )}
-              </div>
-            </div>
-
-            {/* PyTorch CPU */}
-            <div className="flex items-center justify-between py-2">
-              <div className={`flex items-center space-x-3 flex-1 ${!installedProviders.includes('pytorch-cpu') ? 'opacity-50' : ''}`}>
-                <RadioGroupItem value="pytorch-cpu" id="cpu" disabled={isStarting || !installedProviders.includes('pytorch-cpu')} />
-                <Label
-                  htmlFor="cpu"
-                  className={`flex-1 ${isStarting || !installedProviders.includes('pytorch-cpu') ? 'cursor-not-allowed' : 'cursor-pointer'}`}
-                >
-                  <div className="font-medium">PyTorch CPU</div>
-                  <div className="text-sm text-muted-foreground">
-                    Works on any system, slower inference
-                  </div>
-                </Label>
-              </div>
-              <div className="flex items-center gap-2">
-                {!installedProviders.includes('pytorch-cpu') && (
-                  <>
-                    <span className="text-xs text-muted-foreground">242MB</span>
-                    <Button
-                      onClick={() => handleDownload('pytorch-cpu')}
-                      size="sm"
-                      variant="outline"
-                      disabled={downloadingProvider === 'pytorch-cpu' || isStarting}
-                      className="shrink-0"
-                    >
-                      {downloadingProvider === 'pytorch-cpu' ? (
-                        <Icon icon="svg-spinners:ring-resize" className="h-4 w-4 animate-spin" />
-                      ) : (
-                        <>
-                          <HugeiconsIcon icon={Download01Icon} size={16} className="h-4 w-4 mr-2" />
-                          Download
-                        </>
-                      )}
-                    </Button>
-                  </>
-                )}
-                {installedProviders.includes('pytorch-cpu') && (
-                  <Button
-                    onClick={() => handleDelete('pytorch-cpu')}
-                    size="sm"
-                    variant="outline"
-                    disabled={isStarting}
-                    className="shrink-0"
-                  >
-                    <HugeiconsIcon icon={Delete01Icon} size={16} className="h-4 w-4 mr-2" />
-                    Uninstall
-                  </Button>
-                )}
-              </div>
-            </div>
-
-            {/* MLX bundled (macOS Apple Silicon only) */}
-            <div className="flex items-center justify-between py-2">
-              <div className={`flex items-center space-x-3 flex-1 ${!isMacOS() ? 'opacity-50' : ''}`}>
-                <RadioGroupItem value="apple-mlx" id="mlx" disabled={isStarting || !isMacOS()} />
-                <Label
-                  htmlFor="mlx"
-                  className={`flex-1 ${isStarting || !isMacOS() ? 'cursor-not-allowed' : 'cursor-pointer'}`}
-                >
-                  <div className="font-medium">Apple MLX</div>
-                  <div className="text-sm text-muted-foreground">
-                    {isMacOS()
-                      ? 'Bundled with this version, optimized for Apple Silicon'
-                      : 'Only available on Apple Silicon'}
-                  </div>
-                </Label>
-              </div>
-              {!isMacOS() && (
-                <Button size="sm" variant="secondary" disabled>
-                  Not Available on {getPlatformName()}
-                </Button>
-              )}
-            </div>
-
-            {/* Remote */}
-            <div className="flex items-center justify-between py-2">
-              <div className="flex items-center space-x-3 flex-1 opacity-50">
-                <RadioGroupItem value="remote" id="remote" disabled />
-                <Label htmlFor="remote" className="flex-1 cursor-not-allowed">
-                  <div className="font-medium">Remote Server</div>
-                  <div className="text-sm text-muted-foreground">
-                    Connect to your own TTS server
-                  </div>
-                </Label>
-              </div>
-              <Button size="sm" variant="secondary" disabled>
-                Coming Soon
-              </Button>
-            </div>
-
-            {/* OpenAI */}
-            <div className="flex items-center justify-between py-2">
-              <div className="flex items-center space-x-3 flex-1 opacity-50">
-                <RadioGroupItem value="openai" id="openai" disabled />
-                <Label htmlFor="openai" className="flex-1 cursor-not-allowed">
-                  <div className="font-medium">OpenAI API</div>
-                  <div className="text-sm text-muted-foreground">Use OpenAI's TTS API</div>
-                </Label>
-              </div>
-              <Button size="sm" variant="secondary" disabled>
-                Coming Soon
-              </Button>
-            </div>
-          </RadioGroup>
-          <p className="text-xs text-muted-foreground mt-5">
-            Note: PyTorch and MLX use different versions of the same model. When switching between
-            them, you will need to redownload the model.
-          </p>
-        </CardContent>
-      </Card>
-
-      <AlertDialog open={deleteDialogOpen} onOpenChange={setDeleteDialogOpen}>
-        <AlertDialogContent>
-          <AlertDialogHeader>
-            <AlertDialogTitle>Delete Provider</AlertDialogTitle>
-            <AlertDialogDescription>
-              Are you sure you want to delete {providerToDelete}? This will remove the provider
-              binary from your system. You can download it again later if needed.
-            </AlertDialogDescription>
-          </AlertDialogHeader>
-          <AlertDialogFooter>
-            <AlertDialogCancel>Cancel</AlertDialogCancel>
-            <AlertDialogAction
-              onClick={confirmDelete}
-              className="bg-destructive text-destructive-foreground"
-            >
-              Delete
-            </AlertDialogAction>
-          </AlertDialogFooter>
-        </AlertDialogContent>
-      </AlertDialog>
-    </>
-  );
-}

app/src/components/ServerSettings/ServerStatus.tsx

@@ -1,6 +1,4 @@
-import { CancelCircleIcon } from '@hugeicons/core-free-icons';
-import { HugeiconsIcon } from '@hugeicons/react';
-import { Icon } from '@iconify/react';
+import { Loader2, XCircle } from 'lucide-react';
 import { Badge } from '@/components/ui/badge';
 import { Card, CardContent, CardHeader, CardTitle } from '@/components/ui/card';
 import { useServerHealth } from '@/lib/hooks/useServer';
@@ -34,12 +32,12 @@ export function ServerStatus() {
 
         {isLoading ? (
           <div className="flex items-center gap-2">
-            <Icon icon="svg-spinners:ring-resize" className="h-4 w-4 animate-spin" />
+            <Loader2 className="h-4 w-4 animate-spin" />
             <span className="text-sm">Checking connection...</span>
           </div>
         ) : error ? (
           <div className="flex items-center gap-2">
-            <HugeiconsIcon icon={CancelCircleIcon} size={16} className="h-4 w-4 text-destructive" />
+            <XCircle className="h-4 w-4 text-destructive" />
             <span className="text-sm text-destructive">Connection failed: {error.message}</span>
           </div>
         ) : health ? (

app/src/components/ServerSettings/UpdateStatus.tsx

@@ -1,5 +1,4 @@
-import { HugeiconsIcon } from '@hugeicons/react';
-import { AlertCircleIcon, Download01Icon, Refresh01Icon } from '@hugeicons/core-free-icons';
+import { AlertCircle, Download, RefreshCw } from 'lucide-react';
 import { useEffect, useState } from 'react';
 import { Badge } from '@/components/ui/badge';
 import { Button } from '@/components/ui/button';
@@ -37,21 +36,21 @@ export function UpdateStatus() {
             variant="outline"
             size="sm"
           >
-            <HugeiconsIcon icon={Refresh01Icon} size={16} className={`h-4 w-4 mr-2 ${status.checking ? 'animate-spin' : ''}`} />
+            <RefreshCw className={`h-4 w-4 mr-2 ${status.checking ? 'animate-spin' : ''}`} />
             Check for Updates
           </Button>
         </div>
 
         {status.checking && (
           <div className="flex items-center gap-2 text-sm text-muted-foreground">
-            <HugeiconsIcon icon={Refresh01Icon} size={16} className="h-4 w-4 animate-spin" />
+            <RefreshCw className="h-4 w-4 animate-spin" />
             Checking for updates...
           </div>
         )}
 
         {status.error && (
           <div className="flex items-center gap-2 text-sm text-destructive">
-            <HugeiconsIcon icon={AlertCircleIcon} size={16} className="h-4 w-4" />
+            <AlertCircle className="h-4 w-4" />
             {status.error}
           </div>
         )}
@@ -66,7 +65,7 @@ export function UpdateStatus() {
               <Badge>New</Badge>
             </div>
             <Button onClick={downloadAndInstall} className="w-full" size="sm">
-              <HugeiconsIcon icon={Download01Icon} size={16} className="h-4 w-4 mr-2" />
+              <Download className="h-4 w-4 mr-2" />
               Download Update
             </Button>
           </div>
@@ -76,7 +75,7 @@ export function UpdateStatus() {
           <div className="space-y-2">
             <div className="flex items-center justify-between text-sm">
               <div className="flex items-center gap-2">
-                <HugeiconsIcon icon={Download01Icon} size={16} className="h-4 w-4" />
+                <Download className="h-4 w-4" />
                 Downloading update...
               </div>
               {status.downloadProgress !== undefined && (
@@ -110,7 +109,7 @@ export function UpdateStatus() {
               your convenience.
             </div>
             <Button onClick={restartAndInstall} className="w-full" size="sm">
-              <HugeiconsIcon icon={Refresh01Icon} size={16} className="h-4 w-4 mr-2" />
+              <RefreshCw className="h-4 w-4 mr-2" />
               Restart Now
             </Button>
           </div>

app/src/components/ServerTab/ServerTab.tsx

@@ -1,6 +1,5 @@
 import { ConnectionForm } from '@/components/ServerSettings/ConnectionForm';
-import { DataFolders } from '@/components/ServerSettings/DataFolders';
-import { ProviderSettings } from '@/components/ServerSettings/ProviderSettings';
+import { GpuAcceleration } from '@/components/ServerSettings/GpuAcceleration';
 import { ServerStatus } from '@/components/ServerSettings/ServerStatus';
 import { UpdateStatus } from '@/components/ServerSettings/UpdateStatus';
 import { usePlatform } from '@/platform/PlatformContext';
@@ -13,8 +12,7 @@ export function ServerTab() {
         <ConnectionForm />
         <ServerStatus />
       </div>
-      <ProviderSettings />
-      <DataFolders />
+      {platform.metadata.isTauri && <GpuAcceleration />}
       {platform.metadata.isTauri && <UpdateStatus />}
       <div className="py-8 text-center text-sm text-muted-foreground">
         Created by{' '}

app/src/components/Sidebar.tsx

@@ -1,14 +1,5 @@
-import {
-  Book01Icon,
-  Mic01Icon,
-  PackageIcon,
-  ServerStack01Icon,
-  SpeakerIcon,
-  VolumeHighIcon,
-} from '@hugeicons/core-free-icons';
-import { HugeiconsIcon } from '@hugeicons/react';
-import { Icon } from '@iconify/react';
 import { Link, useMatchRoute } from '@tanstack/react-router';
+import { Box, BookOpen, Loader2, Mic, Server, Speaker, Volume2 } from 'lucide-react';
 import voiceboxLogo from '@/assets/voicebox-logo.png';
 import { cn } from '@/lib/utils/cn';
 import { useGenerationStore } from '@/stores/generationStore';
@@ -19,12 +10,12 @@ interface SidebarProps {
 }
 
 const tabs = [
-  { id: 'main', path: '/', icon: VolumeHighIcon, label: 'Generate' },
-  { id: 'stories', path: '/stories', icon: Book01Icon, label: 'Stories' },
-  { id: 'voices', path: '/voices', icon: Mic01Icon, label: 'Voices' },
-  { id: 'audio', path: '/audio', icon: SpeakerIcon, label: 'Audio' },
-  { id: 'models', path: '/models', icon: PackageIcon, label: 'Models' },
-  { id: 'server', path: '/server', icon: ServerStack01Icon, label: 'Server' },
+  { id: 'main', path: '/', icon: Volume2, label: 'Generate' },
+  { id: 'stories', path: '/stories', icon: BookOpen, label: 'Stories' },
+  { id: 'voices', path: '/voices', icon: Mic, label: 'Voices' },
+  { id: 'audio', path: '/audio', icon: Speaker, label: 'Audio' },
+  { id: 'models', path: '/models', icon: Box, label: 'Models' },
+  { id: 'server', path: '/server', icon: Server, label: 'Server' },
 ];
 
 export function Sidebar({ isMacOS }: SidebarProps) {
@@ -51,7 +42,9 @@ export function Sidebar({ isMacOS }: SidebarProps) {
           const Icon = tab.icon;
           // For index route, use exact match; for others, use default matching
           const isActive =
-            tab.path === '/' ? matchRoute({ to: '/' }) : matchRoute({ to: tab.path });
+            tab.path === '/'
+              ? matchRoute({ to: '/', exact: true })
+              : matchRoute({ to: tab.path });
 
           return (
             <Link
@@ -65,7 +58,7 @@ export function Sidebar({ isMacOS }: SidebarProps) {
               title={tab.label}
               aria-label={tab.label}
             >
-              <HugeiconsIcon icon={Icon} size={20} className="h-5 w-5" />
+              <Icon className="h-5 w-5" />
             </Link>
           );
         })}
@@ -82,7 +75,7 @@ export function Sidebar({ isMacOS }: SidebarProps) {
             isPlayerVisible ? 'mb-[120px]' : 'mb-0',
           )}
         >
-          <Icon icon="svg-spinners:ring-resize" className="h-6 w-6 text-accent animate-spin" />
+          <Loader2 className="h-6 w-6 text-accent animate-spin" />
         </div>
       )}
     </div>

app/src/components/StoriesTab/StoryChatItem.tsx

@@ -1,7 +1,7 @@
 import { useSortable } from '@dnd-kit/sortable';
 import { CSS } from '@dnd-kit/utilities';
-import { HugeiconsIcon } from '@hugeicons/react';
-import { DragDropVerticalIcon, MoreHorizontalIcon, PlayIcon, Delete01Icon } from '@hugeicons/core-free-icons';
+import { GripVertical, Mic, MoreHorizontal, Play, Trash2 } from 'lucide-react';
+import { useState } from 'react';
 import { Button } from '@/components/ui/button';
 import {
   DropdownMenu,
@@ -10,10 +10,10 @@ import {
   DropdownMenuTrigger,
 } from '@/components/ui/dropdown-menu';
 import { Textarea } from '@/components/ui/textarea';
-import { ProfileAvatar } from '@/components/VoiceProfiles/ProfileAvatar';
 import type { StoryItemDetail } from '@/lib/api/types';
 import { cn } from '@/lib/utils/cn';
 import { useStoryStore } from '@/stores/storyStore';
+import { useServerStore } from '@/stores/serverStore';
 
 interface StoryChatItemProps {
   item: StoryItemDetail;
@@ -35,6 +35,10 @@ export function StoryChatItem({
   isDragging,
 }: StoryChatItemProps) {
   const seek = useStoryStore((state) => state.seek);
+  const serverUrl = useServerStore((state) => state.serverUrl);
+  const [avatarError, setAvatarError] = useState(false);
+
+  const avatarUrl = `${serverUrl}/profiles/${item.profile_id}/avatar`;
 
   // Check if this item is currently playing based on timecode
   const itemStartMs = item.start_time_ms;
@@ -70,18 +74,27 @@ export function StoryChatItem({
           className="shrink-0 cursor-grab active:cursor-grabbing touch-none text-muted-foreground hover:text-foreground transition-colors"
           {...dragHandleProps}
         >
-          <HugeiconsIcon icon={DragDropVerticalIcon} size={20} className="h-5 w-5" />
+          <GripVertical className="h-5 w-5" />
         </button>
       )}
 
       {/* Voice Avatar */}
       <div className="shrink-0">
-        <ProfileAvatar
-          profileId={item.profile_id}
-          size="lg"
-          grayscale={!isCurrentlyPlaying}
-          alt={`${item.profile_name} avatar`}
-        />
+        <div className="h-10 w-10 rounded-full bg-muted flex items-center justify-center overflow-hidden">
+          {!avatarError ? (
+            <img
+              src={avatarUrl}
+              alt={`${item.profile_name} avatar`}
+              className={cn(
+                'h-full w-full object-cover transition-all duration-200',
+                !isCurrentlyPlaying && 'grayscale'
+              )}
+              onError={() => setAvatarError(true)}
+            />
+          ) : (
+            <Mic className="h-5 w-5 text-muted-foreground" />
+          )}
+        </div>
       </div>
 
       {/* Content */}
@@ -106,16 +119,16 @@ export function StoryChatItem({
         <DropdownMenu>
           <DropdownMenuTrigger asChild>
             <Button variant="ghost" size="icon" className="h-8 w-8" aria-label="Actions">
-              <HugeiconsIcon icon={MoreHorizontalIcon} size={16} className="h-4 w-4" />
+              <MoreHorizontal className="h-4 w-4" />
             </Button>
           </DropdownMenuTrigger>
           <DropdownMenuContent align="end">
             <DropdownMenuItem onClick={handlePlay}>
-              <HugeiconsIcon icon={PlayIcon} size={16} className="mr-2 h-4 w-4" />
+              <Play className="mr-2 h-4 w-4" />
               Play from here
             </DropdownMenuItem>
             <DropdownMenuItem onClick={onRemove} className="text-destructive focus:text-destructive">
-              <HugeiconsIcon icon={Delete01Icon} size={16} className="mr-2 h-4 w-4" />
+              <Trash2 className="mr-2 h-4 w-4" />
               Remove from Story
             </DropdownMenuItem>
           </DropdownMenuContent>

app/src/components/StoriesTab/StoryContent.tsx

@@ -13,8 +13,7 @@ import {
   sortableKeyboardCoordinates,
   verticalListSortingStrategy,
 } from '@dnd-kit/sortable';
-import { HugeiconsIcon } from '@hugeicons/react';
-import { Download01Icon, Add01Icon } from '@hugeicons/core-free-icons';
+import { Download, Plus } from 'lucide-react';
 import { useEffect, useMemo, useRef, useState } from 'react';
 import { Button } from '@/components/ui/button';
 import { Input } from '@/components/ui/input';
@@ -272,7 +271,7 @@ export function StoryContent() {
           <Popover open={isAddOpen} onOpenChange={setIsAddOpen}>
             <PopoverTrigger asChild>
               <Button variant="outline" size="sm">
-                <HugeiconsIcon icon={Add01Icon} size={16} className="mr-2 h-4 w-4" />
+                <Plus className="mr-2 h-4 w-4" />
                 Add
               </Button>
             </PopoverTrigger>
@@ -317,7 +316,7 @@ export function StoryContent() {
               onClick={handleExportAudio}
               disabled={exportAudio.isPending}
             >
-              <HugeiconsIcon icon={Download01Icon} size={16} className="mr-2 h-4 w-4" />
+              <Download className="mr-2 h-4 w-4" />
               Export Audio
             </Button>
           )}

app/src/components/StoriesTab/StoryList.tsx

@@ -1,6 +1,5 @@
-import { HugeiconsIcon } from '@hugeicons/react';
-import { Add01Icon, Book01Icon, MoreHorizontalIcon, PencilIcon, Delete01Icon } from '@hugeicons/core-free-icons';
-import { useState, useMemo } from 'react';
+import { Plus, BookOpen, MoreHorizontal, Pencil, Trash2 } from 'lucide-react';
+import { useState } from 'react';
 import {
   AlertDialog,
   AlertDialogAction,
@@ -30,7 +29,7 @@ import { Input } from '@/components/ui/input';
 import { Label } from '@/components/ui/label';
 import { Textarea } from '@/components/ui/textarea';
 import { useToast } from '@/components/ui/use-toast';
-import { useStories, useCreateStory, useUpdateStory, useDeleteStory, useStory } from '@/lib/hooks/useStories';
+import { useStories, useCreateStory, useUpdateStory, useDeleteStory } from '@/lib/hooks/useStories';
 import { cn } from '@/lib/utils/cn';
 import { formatDate } from '@/lib/utils/format';
 import { useStoryStore } from '@/stores/storyStore';
@@ -39,8 +38,6 @@ export function StoryList() {
   const { data: stories, isLoading } = useStories();
   const selectedStoryId = useStoryStore((state) => state.selectedStoryId);
   const setSelectedStoryId = useStoryStore((state) => state.setSelectedStoryId);
-  const trackEditorHeight = useStoryStore((state) => state.trackEditorHeight);
-  const { data: currentStory } = useStory(selectedStoryId);
   const createStory = useCreateStory();
   const updateStory = useUpdateStory();
   const deleteStory = useDeleteStory();
@@ -57,16 +54,6 @@ export function StoryList() {
   const [newStoryDescription, setNewStoryDescription] = useState('');
   const { toast } = useToast();
 
-  // Calculate bottom padding to account for FloatingGenerateBox and StoryTrackEditor
-  const hasTrackEditor = currentStory && currentStory.items.length > 0;
-  const bottomPadding = useMemo(() => {
-    // FloatingGenerateBox height (~100px) + gap (24px)
-    const generateBoxHeight = 124;
-    // Track editor height when visible
-    const editorHeight = hasTrackEditor ? trackEditorHeight + 24 : 0;
-    return generateBoxHeight + editorHeight;
-  }, [hasTrackEditor, trackEditorHeight]);
-
   const handleCreateStory = () => {
     if (!newStoryName.trim()) {
       toast({
@@ -190,19 +177,16 @@ export function StoryList() {
       <div className="flex items-center justify-between mb-4 px-1">
         <h2 className="text-2xl font-bold">Stories</h2>
         <Button onClick={() => setCreateDialogOpen(true)} size="sm">
-          <HugeiconsIcon icon={Add01Icon} size={16} className="mr-2 h-4 w-4" />
+          <Plus className="mr-2 h-4 w-4" />
           New Story
         </Button>
       </div>
 
       {/* Story List */}
-      <div 
-        className="flex-1 min-h-0 overflow-y-auto space-y-2"
-        style={{ paddingBottom: `${bottomPadding}px` }}
-      >
+      <div className="flex-1 min-h-0 overflow-y-auto space-y-2">
         {storyList.length === 0 ? (
           <div className="text-center py-12 px-5 border-2 border-dashed border-muted rounded-2xl text-muted-foreground">
-            <HugeiconsIcon icon={Book01Icon} size={48} className="h-12 w-12 mx-auto mb-4 opacity-50" />
+            <BookOpen className="h-12 w-12 mx-auto mb-4 opacity-50" />
             <p className="text-sm">No stories yet</p>
             <p className="text-xs mt-2">Create your first story to get started</p>
           </div>
@@ -243,19 +227,19 @@ export function StoryList() {
                       className="h-8 w-8 opacity-0 group-hover:opacity-100 transition-opacity"
                       onClick={(e) => e.stopPropagation()}
                     >
-                      <HugeiconsIcon icon={MoreHorizontalIcon} size={16} className="h-4 w-4" />
+                      <MoreHorizontal className="h-4 w-4" />
                     </Button>
                   </DropdownMenuTrigger>
                   <DropdownMenuContent align="end">
                     <DropdownMenuItem onClick={() => handleEditClick(story)}>
-                      <HugeiconsIcon icon={PencilIcon} size={16} className="mr-2 h-4 w-4" />
+                      <Pencil className="mr-2 h-4 w-4" />
                       Edit
                     </DropdownMenuItem>
                     <DropdownMenuItem
                       onClick={() => handleDeleteClick(story.id)}
                       className="text-destructive focus:text-destructive"
                     >
-                      <HugeiconsIcon icon={Delete01Icon} size={16} className="mr-2 h-4 w-4" />
+                      <Trash2 className="mr-2 h-4 w-4" />
                       Delete
                     </DropdownMenuItem>
                   </DropdownMenuContent>

app/src/components/StoriesTab/StoryTrackEditor.tsx

@@ -1,15 +1,14 @@
-import { HugeiconsIcon } from '@hugeicons/react';
 import {
-  Copy01Icon,
-  DragDropHorizontalIcon,
-  RemoveIcon,
-  PauseIcon,
-  PlayIcon,
-  Add01Icon,
-  Scissor01Icon,
-  SquareIcon,
-  Delete01Icon,
-} from '@hugeicons/core-free-icons';
+  Copy,
+  GripHorizontal,
+  Minus,
+  Pause,
+  Play,
+  Plus,
+  Scissors,
+  Square,
+  Trash2,
+} from 'lucide-react';
 import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
 import WaveSurfer from 'wavesurfer.js';
 import { Button } from '@/components/ui/button';
@@ -724,7 +723,7 @@ export function StoryTrackEditor({ storyId, items }: StoryTrackEditorProps) {
           onMouseDown={handleResizeStart}
           aria-label="Resize track editor"
         >
-          <HugeiconsIcon icon={DragDropHorizontalIcon} size={12} className="h-3 w-3 text-muted-foreground/50 group-hover:text-muted-foreground" />
+          <GripHorizontal className="h-3 w-3 text-muted-foreground/50 group-hover:text-muted-foreground" />
         </button>
 
         {/* Toolbar */}
@@ -738,7 +737,7 @@ export function StoryTrackEditor({ storyId, items }: StoryTrackEditorProps) {
               onClick={handlePlayPause}
               title="Play/Pause (Space)"
             >
-              {isCurrentlyPlaying ? <HugeiconsIcon icon={PauseIcon} size={16} className="h-4 w-4" /> : <HugeiconsIcon icon={PlayIcon} size={16} className="h-4 w-4" />}
+              {isCurrentlyPlaying ? <Pause className="h-4 w-4" /> : <Play className="h-4 w-4" />}
             </Button>
             <Button
               variant="ghost"
@@ -747,7 +746,7 @@ export function StoryTrackEditor({ storyId, items }: StoryTrackEditorProps) {
               onClick={handleStop}
               disabled={!isCurrentlyPlaying}
             >
-              <HugeiconsIcon icon={SquareIcon} size={12} className="h-3 w-3" />
+              <Square className="h-3 w-3" />
             </Button>
             <span className="text-xs text-muted-foreground tabular-nums ml-2">
               {formatTime(currentTimeMs)} / {formatTime(totalDurationMs)}
@@ -764,7 +763,7 @@ export function StoryTrackEditor({ storyId, items }: StoryTrackEditorProps) {
                 onClick={handleSplit}
                 title="Split at playhead (S)"
               >
-                <HugeiconsIcon icon={Scissor01Icon} size={16} className="h-4 w-4" />
+                <Scissors className="h-4 w-4" />
               </Button>
               <Button
                 variant="ghost"
@@ -773,7 +772,7 @@ export function StoryTrackEditor({ storyId, items }: StoryTrackEditorProps) {
                 onClick={handleDuplicate}
                 title="Duplicate (Cmd/Ctrl+D)"
               >
-                <HugeiconsIcon icon={Copy01Icon} size={16} className="h-4 w-4" />
+                <Copy className="h-4 w-4" />
               </Button>
               <Button
                 variant="ghost"
@@ -782,7 +781,7 @@ export function StoryTrackEditor({ storyId, items }: StoryTrackEditorProps) {
                 onClick={handleDelete}
                 title="Delete (Delete/Backspace)"
               >
-                <HugeiconsIcon icon={Delete01Icon} size={16} className="h-4 w-4" />
+                <Trash2 className="h-4 w-4" />
               </Button>
             </div>
           )}
@@ -791,10 +790,10 @@ export function StoryTrackEditor({ storyId, items }: StoryTrackEditorProps) {
           <div className="flex items-center gap-2">
             <span className="text-xs text-muted-foreground">Zoom:</span>
             <Button variant="ghost" size="icon" className="h-6 w-6" onClick={handleZoomOut}>
-              <HugeiconsIcon icon={RemoveIcon} size={12} className="h-3 w-3" />
+              <Minus className="h-3 w-3" />
             </Button>
             <Button variant="ghost" size="icon" className="h-6 w-6" onClick={handleZoomIn}>
-              <HugeiconsIcon icon={Add01Icon} size={12} className="h-3 w-3" />
+              <Plus className="h-3 w-3" />
             </Button>
           </div>
         </div>
@@ -838,7 +837,7 @@ export function StoryTrackEditor({ storyId, items }: StoryTrackEditorProps) {
               type="button"
               className="h-6 border-b bg-muted/20 sticky top-0 z-10 cursor-pointer text-left"
               style={{ width: `${timelineWidth}px` }}
-              onClick={(e) => handleTimelineClick(e as unknown as React.MouseEvent<HTMLDivElement>)}
+              onClick={handleTimelineClick}
               aria-label="Seek timeline"
             >
               {timeMarkers.map((ms) => (
@@ -879,7 +878,7 @@ export function StoryTrackEditor({ storyId, items }: StoryTrackEditorProps) {
               <button
                 type="button"
                 className="absolute inset-0 z-0 cursor-pointer"
-                onClick={(e) => handleTimelineClick(e as unknown as React.MouseEvent<HTMLDivElement>)}
+                onClick={handleTimelineClick}
                 aria-label="Seek timeline"
               />
 

app/src/components/VoiceProfiles/AudioSampleRecording.tsx

@@ -1,5 +1,4 @@
-import { HugeiconsIcon } from '@hugeicons/react';
-import { Mic01Icon, PauseIcon, PlayIcon, SquareIcon } from '@hugeicons/core-free-icons';
+import { Mic, Pause, Play, Square } from 'lucide-react';
 import { memo, useEffect, useState } from 'react';
 import { Visualizer } from 'react-sound-visualizer';
 import { Button } from '@/components/ui/button';
@@ -59,6 +58,7 @@ export function AudioSampleRecording({
   // Request microphone access when component mounts
   useEffect(() => {
     if (!showWaveform) return;
+    if (!navigator.mediaDevices || !navigator.mediaDevices.getUserMedia) return;
 
     let stream: MediaStream | null = null;
 
@@ -96,7 +96,7 @@ export function AudioSampleRecording({
                 size="lg"
                 className="relative z-10 flex items-center gap-2"
               >
-                <HugeiconsIcon icon={Mic01Icon} size={20} className="h-5 w-5" />
+                <Mic className="h-5 w-5" />
                 Start Recording
               </Button>
               <p className="relative z-10 text-sm text-muted-foreground text-center">
@@ -123,7 +123,7 @@ export function AudioSampleRecording({
                 onClick={onStop}
                 className="relative z-10 flex items-center gap-2 bg-accent text-accent-foreground hover:bg-accent/90"
               >
-                <HugeiconsIcon icon={SquareIcon} size={16} className="h-4 w-4" />
+                <Square className="h-4 w-4" />
                 Stop Recording
               </Button>
               <p className="relative z-10 text-sm text-muted-foreground text-center">
@@ -135,13 +135,13 @@ export function AudioSampleRecording({
           {file && !isRecording && (
             <div className="flex flex-col items-center justify-center gap-4 p-4 border-2 border-primary rounded-lg bg-primary/5 min-h-[180px]">
               <div className="flex items-center gap-2">
-                <HugeiconsIcon icon={Mic01Icon} size={20} className="h-5 w-5 text-primary" />
+                <Mic className="h-5 w-5 text-primary" />
                 <span className="font-medium">Recording complete</span>
               </div>
               <p className="text-sm text-muted-foreground text-center">File: {file.name}</p>
               <div className="flex gap-2">
                 <Button type="button" size="icon" variant="outline" onClick={onPlayPause}>
-                  {isPlaying ? <HugeiconsIcon icon={PauseIcon} size={16} className="h-4 w-4" /> : <HugeiconsIcon icon={PlayIcon} size={16} className="h-4 w-4" />}
+                  {isPlaying ? <Pause className="h-4 w-4" /> : <Play className="h-4 w-4" />}
                 </Button>
                 <Button
                   type="button"
@@ -150,7 +150,7 @@ export function AudioSampleRecording({
                   disabled={isTranscribing}
                   className="flex items-center gap-2"
                 >
-                  <HugeiconsIcon icon={Mic01Icon} size={16} className="h-4 w-4" />
+                  <Mic className="h-4 w-4" />
                   {isTranscribing ? 'Transcribing...' : 'Transcribe'}
                 </Button>
                 <Button

app/src/components/VoiceProfiles/AudioSampleSystem.tsx

@@ -1,5 +1,4 @@
-import { HugeiconsIcon } from '@hugeicons/react';
-import { Mic01Icon, DeskIcon, PauseIcon, PlayIcon, SquareIcon } from '@hugeicons/core-free-icons';
+import { Mic, Monitor, Pause, Play, Square } from 'lucide-react';
 import { Button } from '@/components/ui/button';
 import { FormControl, FormItem, FormMessage } from '@/components/ui/form';
 import { formatAudioDuration } from '@/lib/utils/audio';
@@ -36,7 +35,7 @@ export function AudioSampleSystem({
           {!isRecording && !file && (
             <div className="flex flex-col items-center justify-center gap-4 p-4 border-2 border-dashed rounded-lg min-h-[180px]">
               <Button type="button" onClick={onStart} size="lg" className="flex items-center gap-2">
-                <HugeiconsIcon icon={DeskIcon} size={20} className="h-5 w-5" />
+                <Monitor className="h-5 w-5" />
                 Start Capture
               </Button>
               <p className="text-sm text-muted-foreground text-center">
@@ -61,7 +60,7 @@ export function AudioSampleSystem({
                 variant="destructive"
                 className="flex items-center gap-2"
               >
-                <HugeiconsIcon icon={SquareIcon} size={16} className="h-4 w-4" />
+                <Square className="h-4 w-4" />
                 Stop Capture
               </Button>
               <p className="text-sm text-muted-foreground text-center">
@@ -73,13 +72,13 @@ export function AudioSampleSystem({
           {file && !isRecording && (
             <div className="flex flex-col items-center justify-center gap-4 p-4 border-2 border-primary rounded-lg bg-primary/5 min-h-[180px]">
               <div className="flex items-center gap-2">
-                <HugeiconsIcon icon={DeskIcon} size={20} className="h-5 w-5 text-primary" />
+                <Monitor className="h-5 w-5 text-primary" />
                 <span className="font-medium">Capture complete</span>
               </div>
               <p className="text-sm text-muted-foreground text-center">File: {file.name}</p>
               <div className="flex gap-2">
                 <Button type="button" size="icon" variant="outline" onClick={onPlayPause}>
-                  {isPlaying ? <HugeiconsIcon icon={PauseIcon} size={16} className="h-4 w-4" /> : <HugeiconsIcon icon={PlayIcon} size={16} className="h-4 w-4" />}
+                  {isPlaying ? <Pause className="h-4 w-4" /> : <Play className="h-4 w-4" />}
                 </Button>
                 <Button
                   type="button"
@@ -88,7 +87,7 @@ export function AudioSampleSystem({
                   disabled={isTranscribing}
                   className="flex items-center gap-2"
                 >
-                  <HugeiconsIcon icon={Mic01Icon} size={16} className="h-4 w-4" />
+                  <Mic className="h-4 w-4" />
                   {isTranscribing ? 'Transcribing...' : 'Transcribe'}
                 </Button>
                 <Button

app/src/components/VoiceProfiles/AudioSampleUpload.tsx

@@ -1,5 +1,4 @@
-import { HugeiconsIcon } from '@hugeicons/react';
-import { Mic01Icon, PauseIcon, PlayIcon, Upload01Icon } from '@hugeicons/core-free-icons';
+import { Mic, Pause, Play, Upload } from 'lucide-react';
 import { useRef, useState } from 'react';
 import { Button } from '@/components/ui/button';
 import { FormControl, FormItem, FormMessage } from '@/components/ui/form';
@@ -90,7 +89,7 @@ export function AudioSampleUpload({
                   onClick={() => fileInputRef.current?.click()}
                   className="flex items-center gap-2"
                 >
-                  <HugeiconsIcon icon={Upload01Icon} size={20} className="h-5 w-5" />
+                  <Upload className="h-5 w-5" />
                   Choose File
                 </Button>
                 <p className="text-sm text-muted-foreground text-center">
@@ -100,7 +99,7 @@ export function AudioSampleUpload({
             ) : (
               <>
                 <div className="flex items-center gap-2">
-                  <HugeiconsIcon icon={Upload01Icon} size={20} className="h-5 w-5 text-primary" />
+                  <Upload className="h-5 w-5 text-primary" />
                   <span className="font-medium">File uploaded</span>
                 </div>
                 <p className="text-sm text-muted-foreground text-center">File: {file.name}</p>
@@ -112,7 +111,7 @@ export function AudioSampleUpload({
                     onClick={onPlayPause}
                     disabled={isValidating}
                   >
-                    {isPlaying ? <HugeiconsIcon icon={PauseIcon} size={16} className="h-4 w-4" /> : <HugeiconsIcon icon={PlayIcon} size={16} className="h-4 w-4" />}
+                    {isPlaying ? <Pause className="h-4 w-4" /> : <Play className="h-4 w-4" />}
                   </Button>
                   <Button
                     type="button"
@@ -121,7 +120,7 @@ export function AudioSampleUpload({
                     disabled={isTranscribing || isValidating || isDisabled}
                     className="flex items-center gap-2"
                   >
-                    <HugeiconsIcon icon={Mic01Icon} size={16} className="h-4 w-4" />
+                    <Mic className="h-4 w-4" />
                     {isTranscribing ? 'Transcribing...' : 'Transcribe'}
                   </Button>
                   <Button

app/src/components/VoiceProfiles/ProfileAvatar.tsx

@@ -1,80 +0,0 @@
-import { HugeiconsIcon } from '@hugeicons/react';
-import { Mic01Icon } from '@hugeicons/core-free-icons';
-import { useState } from 'react';
-import { cn } from '@/lib/utils/cn';
-import { useServerStore } from '@/stores/serverStore';
-
-interface ProfileAvatarProps {
-  profileId: string;
-  avatarPath?: string | null;
-  size?: 'sm' | 'md' | 'lg' | 'xl';
-  grayscale?: boolean;
-  className?: string;
-  alt?: string;
-}
-
-const sizeClasses = {
-  sm: 'h-6 w-6',
-  md: 'h-8 w-8',
-  lg: 'h-10 w-10',
-  xl: 'h-24 w-24',
-};
-
-const iconSizes = {
-  sm: 14,
-  md: 16,
-  lg: 20,
-  xl: 40,
-};
-
-const iconClassNames = {
-  sm: 'h-3.5 w-3.5',
-  md: 'h-4 w-4',
-  lg: 'h-5 w-5',
-  xl: 'h-10 w-10',
-};
-
-export function ProfileAvatar({
-  profileId,
-  avatarPath,
-  size = 'md',
-  grayscale = false,
-  className,
-  alt = 'Profile avatar',
-}: ProfileAvatarProps) {
-  const [avatarError, setAvatarError] = useState(false);
-  const serverUrl = useServerStore((state) => state.serverUrl);
-
-  // If avatarPath is explicitly null or empty string, don't try to load avatar
-  // Otherwise, always try to load (avatarPath might not be available in all contexts)
-  const avatarUrl =
-    avatarPath === null || avatarPath === '' ? null : `${serverUrl}/profiles/${profileId}/avatar`;
-
-  return (
-    <div
-      className={cn(
-        sizeClasses[size],
-        'rounded-full bg-muted flex items-center justify-center shrink-0 overflow-hidden',
-        className,
-      )}
-    >
-      {avatarUrl && !avatarError ? (
-        <img
-          src={avatarUrl}
-          alt={alt}
-          className={cn(
-            'h-full w-full object-cover transition-all duration-200',
-            grayscale && 'grayscale',
-          )}
-          onError={() => setAvatarError(true)}
-        />
-      ) : (
-        <HugeiconsIcon
-          icon={Mic01Icon}
-          size={iconSizes[size]}
-          className={cn(iconClassNames[size], 'text-muted-foreground')}
-        />
-      )}
-    </div>
-  );
-}

app/src/components/VoiceProfiles/ProfileCard.tsx

@@ -1,5 +1,4 @@
-import { HugeiconsIcon } from '@hugeicons/react';
-import { Download01Icon, Edit01Icon, Delete01Icon } from '@hugeicons/core-free-icons';
+import { Download, Edit, Mic, Trash2 } from 'lucide-react';
 import { useState } from 'react';
 import { Badge } from '@/components/ui/badge';
 import { Button } from '@/components/ui/button';
@@ -13,10 +12,10 @@ import {
   DialogHeader,
   DialogTitle,
 } from '@/components/ui/dialog';
-import { ProfileAvatar } from '@/components/VoiceProfiles/ProfileAvatar';
 import type { VoiceProfileResponse } from '@/lib/api/types';
 import { useDeleteProfile, useExportProfile } from '@/lib/hooks/useProfiles';
 import { cn } from '@/lib/utils/cn';
+import { useServerStore } from '@/stores/serverStore';
 import { useUIStore } from '@/stores/uiStore';
 
 interface ProfileCardProps {
@@ -25,15 +24,19 @@ interface ProfileCardProps {
 
 export function ProfileCard({ profile }: ProfileCardProps) {
   const [deleteDialogOpen, setDeleteDialogOpen] = useState(false);
+  const [avatarError, setAvatarError] = useState(false);
   const deleteProfile = useDeleteProfile();
   const exportProfile = useExportProfile();
   const setEditingProfileId = useUIStore((state) => state.setEditingProfileId);
   const setProfileDialogOpen = useUIStore((state) => state.setProfileDialogOpen);
   const selectedProfileId = useUIStore((state) => state.selectedProfileId);
   const setSelectedProfileId = useUIStore((state) => state.setSelectedProfileId);
+  const serverUrl = useServerStore((state) => state.serverUrl);
 
   const isSelected = selectedProfileId === profile.id;
 
+  const avatarUrl = profile.avatar_path ? `${serverUrl}/profiles/${profile.id}/avatar` : null;
+
   const handleSelect = () => {
     setSelectedProfileId(isSelected ? null : profile.id);
   };
@@ -69,13 +72,21 @@ export function ProfileCard({ profile }: ProfileCardProps) {
       >
         <CardHeader className="p-3 pb-2">
           <CardTitle className="flex items-center gap-1.5 text-base font-medium">
-            <ProfileAvatar
-              profileId={profile.id}
-              avatarPath={profile.avatar_path}
-              size="sm"
-              grayscale={!isSelected}
-              alt={`${profile.name} avatar`}
-            />
+            <div className="h-6 w-6 rounded-full bg-muted flex items-center justify-center shrink-0 overflow-hidden">
+              {avatarUrl && !avatarError ? (
+                <img
+                  src={avatarUrl}
+                  alt={`${profile.name} avatar`}
+                  className={cn(
+                    'h-full w-full object-cover transition-all duration-200',
+                    !isSelected && 'grayscale',
+                  )}
+                  onError={() => setAvatarError(true)}
+                />
+              ) : (
+                <Mic className="h-3.5 w-3.5 text-muted-foreground" />
+              )}
+            </div>
             <span className="break-words">{profile.name}</span>
           </CardTitle>
         </CardHeader>
@@ -90,13 +101,13 @@ export function ProfileCard({ profile }: ProfileCardProps) {
           </div>
           <div className="flex gap-0.5 justify-end items-end mt-auto">
             <CircleButton
-              icon={(props) => <HugeiconsIcon icon={Download01Icon} size={14} {...props} />}
+              icon={Download}
               onClick={handleExport}
               disabled={exportProfile.isPending}
               aria-label="Export profile"
             />
             <CircleButton
-              icon={(props) => <HugeiconsIcon icon={Edit01Icon} size={14} {...props} />}
+              icon={Edit}
               onClick={(e) => {
                 e.stopPropagation();
                 handleEdit();
@@ -104,7 +115,7 @@ export function ProfileCard({ profile }: ProfileCardProps) {
               aria-label="Edit profile"
             />
             <CircleButton
-              icon={(props) => <HugeiconsIcon icon={Delete01Icon} size={14} {...props} />}
+              icon={Trash2}
               onClick={handleDeleteClick}
               disabled={deleteProfile.isPending}
               aria-label="Delete profile"

app/src/components/VoiceProfiles/ProfileForm.tsx

@@ -1,6 +1,5 @@
 import { zodResolver } from '@hookform/resolvers/zod';
-import { HugeiconsIcon } from '@hugeicons/react';
-import { Edit02Icon, Mic01Icon, DeskIcon, Upload01Icon, Cancel01Icon } from '@hugeicons/core-free-icons';
+import { Edit2, Mic, Monitor, Upload, X } from 'lucide-react';
 import { useEffect, useRef, useState } from 'react';
 import { useForm } from 'react-hook-form';
 import * as z from 'zod';
@@ -44,7 +43,7 @@ import {
 } from '@/lib/hooks/useProfiles';
 import { useSystemAudioCapture } from '@/lib/hooks/useSystemAudioCapture';
 import { useTranscription } from '@/lib/hooks/useTranscription';
-import { formatAudioDuration, getAudioDuration } from '@/lib/utils/audio';
+import { convertToWav, formatAudioDuration, getAudioDuration } from '@/lib/utils/audio';
 import { usePlatform } from '@/platform/PlatformContext';
 import { useServerStore } from '@/stores/serverStore';
 import { type ProfileFormDraft, useUIStore } from '@/stores/uiStore';
@@ -506,10 +505,23 @@ export function ProfileForm() {
           language: data.language,
         });
 
+        // Convert non-WAV uploads to WAV so the backend can always use soundfile.
+        // Recorded audio is already WAV (from useAudioRecording's convertToWav call).
+        let fileToUpload: File = sampleFile;
+        if (!sampleFile.type.includes('wav') && !sampleFile.name.toLowerCase().endsWith('.wav')) {
+          try {
+            const wavBlob = await convertToWav(sampleFile);
+            const wavName = sampleFile.name.replace(/\.[^.]+$/, '.wav');
+            fileToUpload = new File([wavBlob], wavName, { type: 'audio/wav' });
+          } catch {
+            // If browser can't decode the format, send the original and let the backend try.
+          }
+        }
+
         try {
           await addSample.mutateAsync({
             profileId: profile.id,
-            file: sampleFile,
+            file: fileToUpload,
             referenceText: referenceText,
           });
 
@@ -636,7 +648,7 @@ export function ProfileForm() {
                     setSampleMode('record');
                   }}
                 >
-                  <HugeiconsIcon icon={Cancel01Icon} size={12} className="h-3 w-3 mr-1" />
+                  <X className="h-3 w-3 mr-1" />
                   Discard
                 </Button>
               </div>
@@ -669,16 +681,16 @@ export function ProfileForm() {
                           className={`grid w-full ${platform.metadata.isTauri && isSystemAudioSupported ? 'grid-cols-3' : 'grid-cols-2'}`}
                         >
                           <TabsTrigger value="upload" className="flex items-center gap-2">
-                            <HugeiconsIcon icon={Upload01Icon} size={16} className="h-4 w-4 shrink-0" />
+                            <Upload className="h-4 w-4 shrink-0" />
                             Upload
                           </TabsTrigger>
                           <TabsTrigger value="record" className="flex items-center gap-2">
-                            <HugeiconsIcon icon={Mic01Icon} size={16} className="h-4 w-4 shrink-0" />
+                            <Mic className="h-4 w-4 shrink-0" />
                             Record
                           </TabsTrigger>
                           {platform.metadata.isTauri && isSystemAudioSupported && (
                             <TabsTrigger value="system" className="flex items-center gap-2">
-                              <HugeiconsIcon icon={DeskIcon} size={16} className="h-4 w-4 shrink-0" />
+                              <Monitor className="h-4 w-4 shrink-0" />
                               System Audio
                             </TabsTrigger>
                           )}
@@ -799,7 +811,7 @@ export function ProfileForm() {
                                     className="h-full w-full object-cover"
                                   />
                                 ) : (
-                                  <HugeiconsIcon icon={Mic01Icon} size={40} className="h-10 w-10 text-muted-foreground" />
+                                  <Mic className="h-10 w-10 text-muted-foreground" />
                                 )}
                               </div>
                               <button
@@ -807,7 +819,7 @@ export function ProfileForm() {
                                 onClick={() => avatarInputRef.current?.click()}
                                 className="absolute inset-0 rounded-full bg-accent/60 opacity-0 group-hover:opacity-100 transition-opacity flex items-center justify-center cursor-pointer"
                               >
-                                <HugeiconsIcon icon={Edit02Icon} size={24} className="h-6 w-6 text-accent-foreground" />
+                                <Edit2 className="h-6 w-6 text-accent-foreground" />
                               </button>
                               {(avatarPreview || editingProfile?.avatar_path) && (
                                 <button
@@ -816,7 +828,7 @@ export function ProfileForm() {
                                   disabled={deleteAvatar.isPending}
                                   className="absolute bottom-0 right-0 h-6 w-6 rounded-full bg-background/60 backdrop-blur-sm text-muted-foreground flex items-center justify-center hover:bg-background/80 hover:text-foreground transition-colors shadow-sm border border-border/50"
                                 >
-                                  <HugeiconsIcon icon={Cancel01Icon} size={14} className="h-3.5 w-3.5" />
+                                  <X className="h-3.5 w-3.5" />
                                 </button>
                               )}
                             </div>

app/src/components/VoiceProfiles/ProfileList.tsx

@@ -1,5 +1,4 @@
-import { HugeiconsIcon } from '@hugeicons/react';
-import { Mic01Icon, SparklesIcon } from '@hugeicons/core-free-icons';
+import { Mic, Sparkles } from 'lucide-react';
 import { Button } from '@/components/ui/button';
 import { Card, CardContent } from '@/components/ui/card';
 import { useProfiles } from '@/lib/hooks/useProfiles';
@@ -31,12 +30,12 @@ export function ProfileList() {
         {allProfiles.length === 0 ? (
           <Card>
             <CardContent className="flex flex-col items-center justify-center py-12">
-              <HugeiconsIcon icon={Mic01Icon} size={48} className="h-12 w-12 text-muted-foreground mb-4" />
+              <Mic className="h-12 w-12 text-muted-foreground mb-4" />
               <p className="text-muted-foreground mb-4">
                 No voice profiles yet. Create your first profile to get started.
               </p>
               <Button onClick={() => setDialogOpen(true)}>
-                <HugeiconsIcon icon={SparklesIcon} size={16} className="mr-2 h-4 w-4" />
+                <Sparkles className="mr-2 h-4 w-4" />
                 Create Voice
               </Button>
             </CardContent>

app/src/components/VoiceProfiles/SampleList.tsx

@@ -1,5 +1,4 @@
-import { HugeiconsIcon } from '@hugeicons/react';
-import { CheckmarkCircle01Icon, Edit01Icon, PauseIcon, PlayIcon, Add01Icon, Delete01Icon, VolumeHighIcon, Cancel01Icon } from '@hugeicons/core-free-icons';
+import { Check, Edit, Pause, Play, Plus, Trash2, Volume2, X } from 'lucide-react';
 import { useEffect, useRef, useState } from 'react';
 import { Button } from '@/components/ui/button';
 import { CircleButton } from '@/components/ui/circle-button';
@@ -104,7 +103,7 @@ function MiniSamplePlayer({ audioUrl }: MiniSamplePlayerProps) {
           onClick={handlePlayPause}
           disabled={isLoading}
         >
-          {isPlaying ? <HugeiconsIcon icon={PauseIcon} size={14} className="h-3.5 w-3.5" /> : <HugeiconsIcon icon={PlayIcon} size={14} className="h-3.5 w-3.5 ml-0.5" />}
+          {isPlaying ? <Pause className="h-3.5 w-3.5" /> : <Play className="h-3.5 w-3.5 ml-0.5" />}
         </Button>
 
         <div className="flex-1 min-w-0 flex items-center gap-2">
@@ -130,7 +129,7 @@ function MiniSamplePlayer({ audioUrl }: MiniSamplePlayerProps) {
           onClick={handleStop}
           title="Stop"
         >
-          <HugeiconsIcon icon={Cancel01Icon} size={14} className="h-3.5 w-3.5" />
+          <X className="h-3.5 w-3.5" />
         </Button>
       </div>
     </div>
@@ -210,7 +209,7 @@ export function SampleList({ profileId }: SampleListProps) {
     <div className="space-y-4 pt-4">
       {samples && samples.length === 0 ? (
         <div className="flex flex-col items-center justify-center py-8 text-center border border-dashed rounded-lg">
-          <HugeiconsIcon icon={VolumeHighIcon} size={32} className="h-8 w-8 text-muted-foreground/50 mb-2" />
+          <Volume2 className="h-8 w-8 text-muted-foreground/50 mb-2" />
           <p className="text-sm text-muted-foreground">No samples yet</p>
           <p className="text-xs text-muted-foreground/70 mt-1">
             Add your first audio sample to get started
@@ -233,7 +232,7 @@ export function SampleList({ profileId }: SampleListProps) {
                   /* Edit Mode */
                   <div className="p-4 space-y-3">
                     <div className="flex items-center gap-2 text-xs text-muted-foreground mb-2">
-                      <HugeiconsIcon icon={Edit01Icon} size={12} className="h-3 w-3" />
+                      <Edit className="h-3 w-3" />
                       <span>Editing transcription</span>
                     </div>
                     <Textarea
@@ -251,7 +250,7 @@ export function SampleList({ profileId }: SampleListProps) {
                         onClick={handleCancelEdit}
                         disabled={updateSample.isPending}
                       >
-                        <HugeiconsIcon icon={Cancel01Icon} size={16} className="h-4 w-4 mr-1" />
+                        <X className="h-4 w-4 mr-1" />
                         Cancel
                       </Button>
                       <Button
@@ -260,7 +259,7 @@ export function SampleList({ profileId }: SampleListProps) {
                         onClick={() => handleSaveEdit(sample.id)}
                         disabled={updateSample.isPending}
                       >
-                        <HugeiconsIcon icon={CheckmarkCircle01Icon} size={16} className="h-4 w-4 mr-1" />
+                        <Check className="h-4 w-4 mr-1" />
                         {updateSample.isPending ? 'Saving...' : 'Save'}
                       </Button>
                     </div>
@@ -279,12 +278,12 @@ export function SampleList({ profileId }: SampleListProps) {
                       {/* Action Buttons */}
                       <div className="shrink-0 flex items-center gap-0.5 opacity-0 group-hover:opacity-100 transition-opacity">
                         <CircleButton
-                          icon={(props) => <HugeiconsIcon icon={Edit01Icon} size={14} {...props} />}
+                          icon={Edit}
                           title="Edit transcription"
                           onClick={() => handleStartEdit(sample.id, sample.reference_text)}
                         />
                         <CircleButton
-                          icon={(props) => <HugeiconsIcon icon={Delete01Icon} size={14} {...props} />}
+                          icon={Trash2}
                           title="Delete sample"
                           onClick={() => handleDeleteClick(sample.id)}
                           disabled={deleteSample.isPending}
@@ -313,7 +312,7 @@ export function SampleList({ profileId }: SampleListProps) {
         className="w-full"
         onClick={() => setUploadOpen(true)}
       >
-        <HugeiconsIcon icon={Add01Icon} size={16} className="mr-2 h-4 w-4" />
+        <Plus className="mr-2 h-4 w-4" />
         Add Sample
       </Button>
 

app/src/components/VoiceProfiles/SampleUpload.tsx

@@ -1,6 +1,5 @@
 import { zodResolver } from '@hookform/resolvers/zod';
-import { HugeiconsIcon } from '@hugeicons/react';
-import { Mic01Icon, DeskIcon, Upload01Icon } from '@hugeicons/core-free-icons';
+import { Mic, Monitor, Upload } from 'lucide-react';
 import { useEffect, useState } from 'react';
 import { useForm } from 'react-hook-form';
 import * as z from 'zod';
@@ -237,16 +236,16 @@ export function SampleUpload({ profileId, open, onOpenChange }: SampleUploadProp
                 className={`grid w-full ${platform.metadata.isTauri && isSystemAudioSupported ? 'grid-cols-3' : 'grid-cols-2'}`}
               >
                 <TabsTrigger value="upload" className="flex items-center gap-2">
-                  <HugeiconsIcon icon={Upload01Icon} size={16} className="h-4 w-4 shrink-0" />
+                  <Upload className="h-4 w-4 shrink-0" />
                   Upload
                 </TabsTrigger>
                 <TabsTrigger value="record" className="flex items-center gap-2">
-                  <HugeiconsIcon icon={Mic01Icon} size={16} className="h-4 w-4 shrink-0" />
+                  <Mic className="h-4 w-4 shrink-0" />
                   Record
                 </TabsTrigger>
                 {platform.metadata.isTauri && isSystemAudioSupported && (
                   <TabsTrigger value="system" className="flex items-center gap-2">
-                    <HugeiconsIcon icon={DeskIcon} size={16} className="h-4 w-4 shrink-0" />
+                    <Monitor className="h-4 w-4 shrink-0" />
                     System Audio
                   </TabsTrigger>
                 )}

app/src/components/VoicesTab/VoicesTab.tsx

@@ -1,6 +1,5 @@
 import { useQuery, useQueryClient } from '@tanstack/react-query';
-import { HugeiconsIcon } from '@hugeicons/react';
-import { Edit01Icon, MoreHorizontalIcon, Add01Icon, Delete01Icon } from '@hugeicons/core-free-icons';
+import { Edit, MoreHorizontal, Plus, Trash2, Mic } from 'lucide-react';
 import { useMemo, useRef } from 'react';
 import { Button } from '@/components/ui/button';
 import {
@@ -19,7 +18,6 @@ import {
   TableRow,
 } from '@/components/ui/table';
 import { ProfileForm } from '@/components/VoiceProfiles/ProfileForm';
-import { ProfileAvatar } from '@/components/VoiceProfiles/ProfileAvatar';
 import { apiClient } from '@/lib/api/client';
 import type { VoiceProfileResponse } from '@/lib/api/types';
 import { BOTTOM_SAFE_AREA_PADDING } from '@/lib/constants/ui';
@@ -81,8 +79,8 @@ export function VoicesTab() {
     setDialogOpen(true);
   };
 
-  const handleDelete = (profileId: string) => {
-    if (confirm('Are you sure you want to delete this profile?')) {
+  const handleProfileDelete = async (profileId: string) => {
+    if (await confirm('Are you sure you want to delete this profile?')) {
       deleteProfile.mutate(profileId);
     }
   };
@@ -114,7 +112,7 @@ export function VoicesTab() {
         <div className="flex items-center justify-between mb-6">
           <h1 className="text-2xl font-bold">Voices</h1>
           <Button onClick={() => setDialogOpen(true)}>
-            <HugeiconsIcon icon={Add01Icon} size={16} className="h-4 w-4 mr-2" />
+            <Plus className="h-4 w-4 mr-2" />
             New Voice
           </Button>
         </div>
@@ -149,7 +147,7 @@ export function VoicesTab() {
                 channels={channels || []}
                 onChannelChange={(channelIds) => handleChannelChange(profile.id, channelIds)}
                 onEdit={() => handleEdit(profile.id)}
-                onDelete={() => handleDelete(profile.id)}
+                onDelete={() => handleProfileDelete(profile.id)}
               />
             ))}
           </TableBody>
@@ -186,12 +184,9 @@ function VoiceRow({
     <TableRow className="cursor-pointer" onClick={onEdit}>
       <TableCell>
         <div className="flex items-center gap-2">
-          <ProfileAvatar
-            profileId={profile.id}
-            avatarPath={profile.avatar_path}
-            size="md"
-            alt={`${profile.name} avatar`}
-          />
+          <div className="h-8 w-8 rounded-lg bg-muted flex items-center justify-center shrink-0">
+            <Mic className="h-4 w-4 text-muted-foreground" />
+          </div>
           <div>
             <div className="font-medium">{profile.name}</div>
             {profile.description && (
@@ -219,16 +214,16 @@ function VoiceRow({
         <DropdownMenu>
           <DropdownMenuTrigger asChild>
             <Button variant="ghost" size="icon">
-              <HugeiconsIcon icon={MoreHorizontalIcon} size={16} className="h-4 w-4" />
+              <MoreHorizontal className="h-4 w-4" />
             </Button>
           </DropdownMenuTrigger>
           <DropdownMenuContent>
             <DropdownMenuItem onClick={onEdit}>
-              <HugeiconsIcon icon={Edit01Icon} size={16} className="h-4 w-4 mr-2" />
+              <Edit className="h-4 w-4 mr-2" />
               Edit
             </DropdownMenuItem>
             <DropdownMenuItem onClick={onDelete} className="text-destructive">
-              <HugeiconsIcon icon={Delete01Icon} size={16} className="h-4 w-4 mr-2" />
+              <Trash2 className="h-4 w-4 mr-2" />
               Delete
             </DropdownMenuItem>
           </DropdownMenuContent>

app/src/components/ui/checkbox.tsx

@@ -1,6 +1,5 @@
 import * as React from 'react';
-import { HugeiconsIcon } from '@hugeicons/react';
-import { CheckmarkCircle01Icon } from '@hugeicons/core-free-icons';
+import { Check } from 'lucide-react';
 import { cn } from '@/lib/utils/cn';
 
 export interface CheckboxProps {
@@ -35,7 +34,7 @@ const Checkbox = React.forwardRef<HTMLButtonElement, CheckboxProps>(
         )}
         {...props}
       >
-        {checked && <HugeiconsIcon icon={CheckmarkCircle01Icon} size={12} className="h-3 w-3 text-accent-foreground" />}
+        {checked && <Check className="h-3 w-3 text-accent-foreground" />}
       </button>
     );
   },

app/src/components/ui/dialog.tsx

@@ -1,6 +1,5 @@
 import * as DialogPrimitive from '@radix-ui/react-dialog';
-import { HugeiconsIcon } from '@hugeicons/react';
-import { Cancel01Icon } from '@hugeicons/core-free-icons';
+import { X } from 'lucide-react';
 import * as React from 'react';
 import { cn } from '@/lib/utils/cn';
 
@@ -43,7 +42,7 @@ const DialogContent = React.forwardRef<
     >
       {children}
       <DialogPrimitive.Close className="absolute right-4 top-4 rounded-sm opacity-70 ring-offset-background transition-opacity hover:opacity-100 focus:outline-none focus:ring-2 focus:ring-ring focus:ring-offset-2 disabled:pointer-events-none data-[state=open]:bg-accent data-[state=open]:text-muted-foreground">
-        <HugeiconsIcon icon={Cancel01Icon} size={16} className="h-4 w-4" />
+        <X className="h-4 w-4" />
         <span className="sr-only">Close</span>
       </DialogPrimitive.Close>
     </DialogPrimitive.Content>

app/src/components/ui/dropdown-menu.tsx

@@ -1,7 +1,6 @@
-import { MoreHorizontalIcon } from '@hugeicons/core-free-icons';
-import { HugeiconsIcon } from '@hugeicons/react';
-import * as DropdownMenuPrimitive from '@radix-ui/react-dropdown-menu';
 import * as React from 'react';
+import * as DropdownMenuPrimitive from '@radix-ui/react-dropdown-menu';
+import { MoreHorizontal } from 'lucide-react';
 import { cn } from '@/lib/utils/cn';
 
 const DropdownMenu = DropdownMenuPrimitive.Root;
@@ -27,7 +26,7 @@ const DropdownMenuSubTrigger = React.forwardRef<
     {...props}
   >
     {children}
-    <HugeiconsIcon icon={MoreHorizontalIcon} size={16} className="ml-auto h-4 w-4" />
+    <MoreHorizontal className="ml-auto h-4 w-4" />
   </DropdownMenuPrimitive.SubTrigger>
 ));
 DropdownMenuSubTrigger.displayName = DropdownMenuPrimitive.SubTrigger.displayName;
@@ -74,7 +73,7 @@ const DropdownMenuItem = React.forwardRef<
   <DropdownMenuPrimitive.Item
     ref={ref}
     className={cn(
-      'relative flex cursor-default select-none items-center rounded-sm px-2 py-1.5 text-sm outline-none focus:bg-accent focus:text-accent-foreground data-[disabled]:pointer-events-none data-[disabled]:opacity-50',
+      'relative flex cursor-default select-none items-center rounded-sm px-2 py-1.5 text-sm outline-none transition-colors focus:bg-accent focus:text-accent-foreground data-[disabled]:pointer-events-none data-[disabled]:opacity-50',
       inset && 'pl-8',
       className,
     )}
@@ -98,7 +97,7 @@ const DropdownMenuCheckboxItem = React.forwardRef<
   >
     <span className="absolute left-2 flex h-3.5 w-3.5 items-center justify-center">
       <DropdownMenuPrimitive.ItemIndicator>
-        <HugeiconsIcon icon={MoreHorizontalIcon} size={16} className="h-4 w-4" />
+        <MoreHorizontal className="h-4 w-4" />
       </DropdownMenuPrimitive.ItemIndicator>
     </span>
     {children}
@@ -120,7 +119,7 @@ const DropdownMenuRadioItem = React.forwardRef<
   >
     <span className="absolute left-2 flex h-3.5 w-3.5 items-center justify-center">
       <DropdownMenuPrimitive.ItemIndicator>
-        <HugeiconsIcon icon={MoreHorizontalIcon} size={8} className="h-2 w-2 fill-current" />
+        <MoreHorizontal className="h-2 w-2 fill-current" />
       </DropdownMenuPrimitive.ItemIndicator>
     </span>
     {children}
@@ -155,9 +154,7 @@ const DropdownMenuSeparator = React.forwardRef<
 DropdownMenuSeparator.displayName = DropdownMenuPrimitive.Separator.displayName;
 
 const DropdownMenuShortcut = ({ className, ...props }: React.HTMLAttributes<HTMLSpanElement>) => {
-  return (
-    <span className={cn('ml-auto text-xs tracking-widest opacity-60', className)} {...props} />
-  );
+  return <span className={cn('ml-auto text-xs tracking-widest opacity-60', className)} {...props} />;
 };
 DropdownMenuShortcut.displayName = 'DropdownMenuShortcut';
 

app/src/components/ui/multi-select.tsx

@@ -1,6 +1,5 @@
 import * as React from 'react';
-import { HugeiconsIcon } from '@hugeicons/react';
-import { ArrowDown01Icon, CheckmarkCircle01Icon } from '@hugeicons/core-free-icons';
+import { ChevronDown, Check } from 'lucide-react';
 import { cn } from '@/lib/utils/cn';
 import {
   DropdownMenu,
@@ -37,7 +36,7 @@ const MultiSelectCheckboxItem = React.forwardRef<
   >
     <span className="absolute left-2 flex h-3.5 w-3.5 items-center justify-center">
       <DropdownMenuPrimitive.ItemIndicator>
-        <HugeiconsIcon icon={CheckmarkCircle01Icon} size={16} className="h-4 w-4" />
+        <Check className="h-4 w-4" />
       </DropdownMenuPrimitive.ItemIndicator>
     </span>
     {children}
@@ -79,7 +78,7 @@ export function MultiSelect({
           )}
         >
           <span className="line-clamp-1">{displayText}</span>
-          <HugeiconsIcon icon={ArrowDown01Icon} size={16} className="h-4 w-4 opacity-50" />
+          <ChevronDown className="h-4 w-4 opacity-50" />
         </button>
       </DropdownMenuTrigger>
       <DropdownMenuContent

app/src/components/ui/radio-group.tsx

@@ -1,43 +0,0 @@
-'use client';
-
-import { CircleIcon } from '@hugeicons/core-free-icons';
-import { HugeiconsIcon } from '@hugeicons/react';
-import * as RadioGroupPrimitive from '@radix-ui/react-radio-group';
-import * as React from 'react';
-
-import { cn } from '@/lib/utils/cn';
-
-const RadioGroup = React.forwardRef<
-  React.ElementRef<typeof RadioGroupPrimitive.Root>,
-  React.ComponentPropsWithoutRef<typeof RadioGroupPrimitive.Root>
->(({ className, ...props }, ref) => {
-  return <RadioGroupPrimitive.Root className={cn('grid gap-2', className)} {...props} ref={ref} />;
-});
-RadioGroup.displayName = RadioGroupPrimitive.Root.displayName;
-
-const RadioGroupItem = React.forwardRef<
-  React.ElementRef<typeof RadioGroupPrimitive.Item>,
-  React.ComponentPropsWithoutRef<typeof RadioGroupPrimitive.Item>
->(({ className, ...props }, ref) => {
-  return (
-    <RadioGroupPrimitive.Item
-      ref={ref}
-      className={cn(
-        'aspect-square h-4 w-4 rounded-full border border-accent text-accent ring-offset-background focus:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 disabled:cursor-not-allowed disabled:opacity-50',
-        className,
-      )}
-      {...props}
-    >
-      <RadioGroupPrimitive.Indicator className="flex items-center justify-center">
-        <HugeiconsIcon
-          icon={CircleIcon}
-          size={10}
-          className="h-2.5 w-2.5 fill-current text-current"
-        />
-      </RadioGroupPrimitive.Indicator>
-    </RadioGroupPrimitive.Item>
-  );
-});
-RadioGroupItem.displayName = RadioGroupPrimitive.Item.displayName;
-
-export { RadioGroup, RadioGroupItem };

app/src/components/ui/select.tsx

@@ -1,6 +1,5 @@
 import * as SelectPrimitive from '@radix-ui/react-select';
-import { HugeiconsIcon } from '@hugeicons/react';
-import { CheckmarkCircle01Icon, ArrowDown01Icon, ArrowUp01Icon } from '@hugeicons/core-free-icons';
+import { Check, ChevronDown, ChevronUp } from 'lucide-react';
 import * as React from 'react';
 import { cn } from '@/lib/utils/cn';
 
@@ -24,7 +23,7 @@ const SelectTrigger = React.forwardRef<
   >
     {children}
     <SelectPrimitive.Icon asChild>
-      <HugeiconsIcon icon={ArrowDown01Icon} size={16} className="h-4 w-4 opacity-50" />
+      <ChevronDown className="h-4 w-4 opacity-50" />
     </SelectPrimitive.Icon>
   </SelectPrimitive.Trigger>
 ));
@@ -39,7 +38,7 @@ const SelectScrollUpButton = React.forwardRef<
     className={cn('flex cursor-default items-center justify-center py-1', className)}
     {...props}
   >
-    <HugeiconsIcon icon={ArrowUp01Icon} size={16} className="h-4 w-4" />
+    <ChevronUp className="h-4 w-4" />
   </SelectPrimitive.ScrollUpButton>
 ));
 SelectScrollUpButton.displayName = SelectPrimitive.ScrollUpButton.displayName;
@@ -53,7 +52,7 @@ const SelectScrollDownButton = React.forwardRef<
     className={cn('flex cursor-default items-center justify-center py-1', className)}
     {...props}
   >
-    <HugeiconsIcon icon={ArrowDown01Icon} size={16} className="h-4 w-4" />
+    <ChevronDown className="h-4 w-4" />
   </SelectPrimitive.ScrollDownButton>
 ));
 SelectScrollDownButton.displayName = SelectPrimitive.ScrollDownButton.displayName;
@@ -116,7 +115,7 @@ const SelectItem = React.forwardRef<
   >
     <span className="absolute left-2 flex h-3.5 w-3.5 items-center justify-center">
       <SelectPrimitive.ItemIndicator>
-        <HugeiconsIcon icon={CheckmarkCircle01Icon} size={16} className="h-4 w-4" />
+        <Check className="h-4 w-4" />
       </SelectPrimitive.ItemIndicator>
     </span>
 

app/src/components/ui/toast.tsx

@@ -1,7 +1,6 @@
 import * as ToastPrimitives from '@radix-ui/react-toast';
 import { cva, type VariantProps } from 'class-variance-authority';
-import { HugeiconsIcon } from '@hugeicons/react';
-import { Cancel01Icon } from '@hugeicons/core-free-icons';
+import { X } from 'lucide-react';
 import * as React from 'react';
 import { cn } from '@/lib/utils/cn';
 
@@ -80,7 +79,7 @@ const ToastClose = React.forwardRef<
     toast-close=""
     {...props}
   >
-    <HugeiconsIcon icon={Cancel01Icon} size={16} className="h-4 w-4" />
+    <X className="h-4 w-4" />
   </ToastPrimitives.Close>
 ));
 ToastClose.displayName = ToastPrimitives.Close.displayName;

app/src/hooks/useAutoUpdater.ts

@@ -0,0 +1,52 @@
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { usePlatform } from '@/platform/PlatformContext';
+import type { UpdateStatus } from '@/platform/types';
+
+// Re-export UpdateStatus for backwards compatibility
+export type { UpdateStatus };
+
+export function useAutoUpdater(checkOnMount = false) {
+  const platform = usePlatform();
+  const [status, setStatus] = useState<UpdateStatus>(platform.updater.getStatus());
+  const hasCheckedRef = useRef(false);
+
+  // Subscribe to updater status changes
+  useEffect(() => {
+    const unsubscribe = platform.updater.subscribe((newStatus) => {
+      setStatus(newStatus);
+    });
+    return unsubscribe;
+    // Empty dependency array - platform is stable from context
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [platform.updater.subscribe]);
+
+  const checkForUpdates = useCallback(async () => {
+    await platform.updater.checkForUpdates();
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [platform.updater.checkForUpdates]);
+
+  const downloadAndInstall = useCallback(async () => {
+    await platform.updater.downloadAndInstall();
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [platform.updater.downloadAndInstall]);
+
+  const restartAndInstall = useCallback(async () => {
+    await platform.updater.restartAndInstall();
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [platform.updater.restartAndInstall]);
+
+  useEffect(() => {
+    if (checkOnMount && platform.metadata.isTauri && !hasCheckedRef.current) {
+      hasCheckedRef.current = true;
+      checkForUpdates();
+    }
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [platform.metadata.isTauricheckOnMountcheckForUpdates]);
+
+  return {
+    status,
+    checkForUpdates,
+    downloadAndInstall,
+    restartAndInstall,
+  };
+}

app/src/hooks/useAutoUpdater.tsx

@@ -1,5 +1,4 @@
-import { Download01Icon, Refresh01Icon } from '@hugeicons/core-free-icons';
-import { HugeiconsIcon } from '@hugeicons/react';
+import { Download, RefreshCw } from 'lucide-react';
 import { useCallback, useEffect, useRef, useState } from 'react';
 import { Progress } from '@/components/ui/progress';
 import { ToastAction } from '@/components/ui/toast';
@@ -74,7 +73,7 @@ export function useAutoUpdater(options: boolean | UseAutoUpdaterOptions = false)
     }
     // Empty dependency array - only run once on mount
     // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, [platform.metadata.isTauri, checkOnMount, checkForUpdates]);
+  }, [platform.metadata.isTauricheckOnMountcheckForUpdates]);
 
   // Show toast when update is available
   useEffect(() => {
@@ -133,7 +132,7 @@ export function useAutoUpdater(options: boolean | UseAutoUpdaterOptions = false)
     toastUpdateRef.current({
       title: (
         <div className="flex items-center gap-2">
-          <HugeiconsIcon icon={Download01Icon} size={16} className="h-4 w-4 animate-pulse" />
+          <Download className="h-4 w-4 animate-pulse" />
           <span>Downloading Update</span>
         </div>
       ),
@@ -175,7 +174,7 @@ export function useAutoUpdater(options: boolean | UseAutoUpdaterOptions = false)
       duration: Infinity,
       action: (
         <ToastAction altText="Restart now" onClick={handleRestartNow}>
-          <HugeiconsIcon icon={Refresh01Icon} size={12} className="h-3 w-3 mr-1" />
+          <RefreshCw className="h-3 w-3 mr-1" />
           Restart Now
         </ToastAction>
       ),

app/src/lib/api/client.ts

@@ -2,7 +2,7 @@ import type { LanguageCode } from '@/lib/constants/languages';
 import { useServerStore } from '@/stores/serverStore';
 import type {
   ActiveTasksResponse,
-  FolderPathsResponse,
+  CudaStatus,
   GenerationRequest,
   GenerationResponse,
   HealthResponse,
@@ -58,11 +58,6 @@ class ApiClient {
     return this.request<HealthResponse>('/health');
   }
 
-  // System
-  async getSystemFolders(): Promise<FolderPathsResponse> {
-    return this.request<FolderPathsResponse>('/system/folders');
-  }
-
   // Profiles
   async createProfile(data: VoiceProfileCreate): Promise<VoiceProfileResponse> {
     return this.request<VoiceProfileResponse>('/profiles', {
@@ -205,77 +200,6 @@ class ApiClient {
     });
   }
 
-  // Providers
-  async listProviders(): Promise<{
-    providers: Array<{
-      type: string;
-      name: string;
-      installed: boolean;
-      size_mb: number | null;
-    }>;
-    installed: string[];
-  }> {
-    return this.request('/providers');
-  }
-
-  async getActiveProvider(): Promise<{
-    provider: string;
-    health: {
-      status: string;
-      provider: string;
-      version: string | null;
-      model: string | null;
-      device: string | null;
-    };
-    status: {
-      model_loaded: boolean;
-      model_size: string | null;
-      available_sizes: string[];
-      gpu_available: boolean | null;
-      vram_used_mb: number | null;
-    };
-  }> {
-    return this.request('/providers/active');
-  }
-
-  async startProvider(providerType: string): Promise<{
-    message: string;
-    provider: {
-      status: string;
-      provider: string;
-      version: string | null;
-      model: string | null;
-      device: string | null;
-    };
-  }> {
-    return this.request('/providers/start', {
-      method: 'POST',
-      body: JSON.stringify({ provider_type: providerType }),
-    });
-  }
-
-  async stopProvider(): Promise<{ message: string }> {
-    return this.request('/providers/stop', {
-      method: 'POST',
-    });
-  }
-
-  async downloadProvider(providerType: string): Promise<{
-    message: string;
-    provider_type: string;
-  }> {
-    return this.request('/providers/download', {
-      method: 'POST',
-      body: JSON.stringify({ provider_type: providerType }),
-    });
-  }
-
-  async deleteProvider(providerType: string): Promise<{ message: string }> {
-    return this.request(`/providers/${providerType}`, {
-      method: 'DELETE',
-    });
-  }
-
   // History
   async listHistory(query?: HistoryQuery): Promise<HistoryListResponse> {
     const params = new URLSearchParams();
@@ -328,9 +252,7 @@ class ApiClient {
     return response.blob();
   }
 
-  async importGeneration(
-    file: File,
-  ): Promise<{
+  async importGeneration(file: File): Promise<{
     id: string;
     profile_id: string;
     profile_name: string;
@@ -415,11 +337,22 @@ class ApiClient {
     });
   }
 
+  async cancelDownload(modelName: string): Promise<{ message: string }> {
+    return this.request<{ message: string }>('/models/download/cancel', {
+      method: 'POST',
+      body: JSON.stringify({ model_name: modelName } as ModelDownloadRequest),
+    });
+  }
+
   // Task Management
   async getActiveTasks(): Promise<ActiveTasksResponse> {
     return this.request<ActiveTasksResponse>('/tasks/active');
   }
 
+  async clearAllTasks(): Promise<{ message: string }> {
+    return this.request<{ message: string }>('/tasks/clear', { method: 'POST' });
+  }
+
   // Audio Channels
   async listChannels(): Promise<
     Array<{
@@ -493,6 +426,23 @@ class ApiClient {
     });
   }
 
+  // CUDA Backend Management
+  async getCudaStatus(): Promise<CudaStatus> {
+    return this.request<CudaStatus>('/backend/cuda-status');
+  }
+
+  async downloadCudaBackend(): Promise<{ message: string; progress_key: string }> {
+    return this.request<{ message: string; progress_key: string }>('/backend/download-cuda', {
+      method: 'POST',
+    });
+  }
+
+  async deleteCudaBackend(): Promise<{ message: string }> {
+    return this.request<{ message: string }>('/backend/cuda', {
+      method: 'DELETE',
+    });
+  }
+
   // Stories
   async listStories(): Promise<StoryResponse[]> {
     return this.request<StoryResponse[]>('/stories');

app/src/lib/api/types.ts

@@ -34,6 +34,7 @@ export interface GenerationRequest {
   language: LanguageCode;
   seed?: number;
   model_size?: '1.7B' | '0.6B';
+  engine?: 'qwen' | 'luxtts';
   instruct?: string;
 }
 
@@ -79,7 +80,29 @@ export interface HealthResponse {
   model_downloaded?: boolean;
   model_size?: string;
   gpu_available: boolean;
+  gpu_type?: string;
   vram_used_mb?: number;
+  backend_type?: string;
+  backend_variant?: string; // "cpu" or "cuda"
+}
+
+export interface CudaDownloadProgress {
+  model_name: string;
+  current: number;
+  total: number;
+  progress: number;
+  filename?: string;
+  status: 'downloading' | 'extracting' | 'complete' | 'error';
+  timestamp: string;
+  error?: string;
+}
+
+export interface CudaStatus {
+  available: boolean; // CUDA binary exists on disk
+  active: boolean; // Currently running the CUDA binary
+  binary_path?: string;
+  downloading: boolean; // Download in progress
+  download_progress?: CudaDownloadProgress;
 }
 
 export interface ModelProgress {
@@ -97,7 +120,7 @@ export interface ModelStatus {
   model_name: string;
   display_name: string;
   downloaded: boolean;
-  downloading: boolean;  // True if download is in progress
+  downloading: boolean; // True if download is in progress
   size_mb?: number;
   loaded: boolean;
 }
@@ -114,6 +137,7 @@ export interface ActiveDownloadTask {
   model_name: string;
   status: string;
   started_at: string;
+  error?: string;
 }
 
 export interface ActiveGenerationTask {
@@ -128,12 +152,6 @@ export interface ActiveTasksResponse {
   generations: ActiveGenerationTask[];
 }
 
-export interface FolderPathsResponse {
-  data_dir: string;
-  models_dir: string;
-  providers_dir: string;
-}
-
 export interface StoryCreate {
   name: string;
   description?: string;

app/src/lib/hooks/useAudioRecording.ts

@@ -20,11 +20,13 @@ export function useAudioRecording({
   const streamRef = useRef<MediaStream | null>(null);
   const timerRef = useRef<number | null>(null);
   const startTimeRef = useRef<number | null>(null);
+  const cancelledRef = useRef<boolean>(false);
 
   const startRecording = useCallback(async () => {
     try {
       setError(null);
       chunksRef.current = [];
+      cancelledRef.current = false;
       setDuration(0);
 
       // Check if getUserMedia is available
@@ -87,31 +89,34 @@ export function useAudioRecording({
       };
 
       mediaRecorder.onstop = async () => {
+        // Snapshot the cancellation flag and recorded duration immediately —
+        // cancelRecording() clears chunks and sets cancelledRef synchronously
+        // before this async handler runs, so we must check it first.
+        const wasCancelled = cancelledRef.current;
+        const recordedDuration = startTimeRef.current
+          ? (Date.now() - startTimeRef.current) / 1000
+          : undefined;
+
         const webmBlob = new Blob(chunksRef.current, { type: 'audio/webm' });
 
-        // Convert to WAV format to avoid needing ffmpeg on backend
-        try {
-          const wavBlob = await convertToWav(webmBlob);
-
-          // Pass the actual recorded duration
-          const recordedDuration = startTimeRef.current
-            ? (Date.now() - startTimeRef.current) / 1000
-            : undefined;
-          onRecordingComplete?.(wavBlob, recordedDuration);
-        } catch (err) {
-          console.error('Error converting audio to WAV:', err);
-          // Fallback to original blob if conversion fails
-          const recordedDuration = startTimeRef.current
-            ? (Date.now() - startTimeRef.current) / 1000
-            : undefined;
-          onRecordingComplete?.(webmBlob, recordedDuration);
-        }
-
-        // Stop all tracks
+        // Stop all tracks now that we have the data
         streamRef.current?.getTracks().forEach((track) => {
           track.stop();
         });
         streamRef.current = null;
+
+        // Don't fire completion callback if the recording was cancelled
+        if (wasCancelled) return;
+
+        // Convert to WAV format to avoid needing ffmpeg on backend
+        try {
+          const wavBlob = await convertToWav(webmBlob);
+          onRecordingComplete?.(wavBlob, recordedDuration);
+        } catch (err) {
+          console.error('Error converting audio to WAV:', err);
+          // Fallback to original blob if conversion fails
+          onRecordingComplete?.(webmBlob, recordedDuration);
+        }
       };
 
       mediaRecorder.onerror = (event) => {
@@ -167,9 +172,10 @@ export function useAudioRecording({
 
   const cancelRecording = useCallback(() => {
     if (mediaRecorderRef.current) {
+      cancelledRef.current = true; // Must be set before stop() triggers onstop
+      chunksRef.current = [];
       mediaRecorderRef.current.stop();
       setIsRecording(false);
-      chunksRef.current = [];
       setDuration(0);
     }
 

app/src/lib/hooks/useGenerationForm.ts

@@ -16,6 +16,7 @@ const generationSchema = z.object({
   seed: z.number().int().optional(),
   modelSize: z.enum(['1.7B', '0.6B']).optional(),
   instruct: z.string().max(500).optional(),
+  engine: z.enum(['qwen', 'luxtts']).optional(),
 });
 
 export type GenerationFormValues = z.infer<typeof generationSchema>;
@@ -47,6 +48,7 @@ export function useGenerationForm(options: UseGenerationFormOptions = {}) {
       seed: undefined,
       modelSize: '1.7B',
       instruct: '',
+      engine: 'qwen',
       ...options.defaultValues,
     },
   });
@@ -67,8 +69,14 @@ export function useGenerationForm(options: UseGenerationFormOptions = {}) {
     try {
       setIsGenerating(true);
 
-      const modelName = `qwen-tts-${data.modelSize}`;
-      const displayName = data.modelSize === '1.7B' ? 'Qwen TTS 1.7B' : 'Qwen TTS 0.6B';
+      const engine = data.engine || 'qwen';
+      const modelName = engine === 'luxtts' ? 'luxtts' : `qwen-tts-${data.modelSize}`;
+      const displayName =
+        engine === 'luxtts'
+          ? 'LuxTTS'
+          : data.modelSize === '1.7B'
+            ? 'Qwen TTS 1.7B'
+            : 'Qwen TTS 0.6B';
 
       try {
         const modelStatus = await apiClient.getModelStatus();
@@ -87,14 +95,27 @@ export function useGenerationForm(options: UseGenerationFormOptions = {}) {
         text: data.text,
         language: data.language,
         seed: data.seed,
-        model_size: data.modelSize,
-        instruct: data.instruct || undefined,
+        model_size: engine === 'luxtts' ? undefined : data.modelSize,
+        engine,
+        instruct: engine === 'luxtts' ? undefined : data.instruct || undefined,
+      });
+
+      toast({
+        title: 'Generation complete!',
+        description: `Audio generated (${result.duration.toFixed(2)}s)`,
       });
 
       const audioUrl = apiClient.getAudioUrl(result.id);
       setAudioWithAutoPlay(audioUrl, result.id, selectedProfileId, data.text.substring(0, 50));
 
-      form.reset();
+      form.reset({
+        text: '',
+        language: data.language,
+        seed: undefined,
+        modelSize: data.modelSize,
+        instruct: '',
+        engine: data.engine,
+      });
       options.onSuccess?.(result.id);
     } catch (error) {
       toast({

app/src/lib/hooks/useModelDownloadToast.tsx

@@ -1,6 +1,4 @@
-import { CancelCircleIcon, CheckmarkCircle02Icon } from '@hugeicons/core-free-icons';
-import { HugeiconsIcon } from '@hugeicons/react';
-import { Icon } from '@iconify/react';
+import { CheckCircle2, Loader2, XCircle } from 'lucide-react';
 import { useCallback, useEffect, useRef } from 'react';
 import { Progress } from '@/components/ui/progress';
 import { useToast } from '@/components/ui/use-toast';
@@ -12,7 +10,7 @@ interface UseModelDownloadToastOptions {
   displayName: string;
   enabled?: boolean;
   onComplete?: () => void;
-  onError?: () => void;
+  onError?: (error: string) => void;
 }
 
 /**
@@ -61,7 +59,7 @@ export function useModelDownloadToast({
       title: displayName,
       description: (
         <div className="flex items-center gap-2">
-          <Icon icon="svg-spinners:ring-resize" className="h-4 w-4 animate-spin" />
+          <Loader2 className="h-4 w-4 animate-spin" />
           <span>Connecting to download...</span>
         </div>
       ),
@@ -98,35 +96,19 @@ export function useModelDownloadToast({
 
           switch (progress.status) {
             case 'complete':
-              statusIcon = (
-                <HugeiconsIcon
-                  icon={CheckmarkCircle02Icon}
-                  size={16}
-                  className="h-4 w-4 text-green-500"
-                />
-              );
+              statusIcon = <CheckCircle2 className="h-4 w-4 text-green-500" />;
               statusText = 'Download complete';
               break;
             case 'error':
-              statusIcon = (
-                <HugeiconsIcon
-                  icon={CancelCircleIcon}
-                  size={16}
-                  className="h-4 w-4 text-destructive"
-                />
-              );
-              statusText = `Error: ${progress.error || 'Unknown error'}`;
+              statusIcon = <XCircle className="h-4 w-4 text-destructive" />;
+              statusText = 'Download failed. See Problems panel for details.';
               break;
             case 'downloading':
-              statusIcon = (
-                <Icon icon="svg-spinners:ring-resize" className="h-4 w-4 animate-spin" />
-              );
+              statusIcon = <Loader2 className="h-4 w-4 animate-spin" />;
               statusText = progress.filename || 'Downloading...';
               break;
             case 'extracting':
-              statusIcon = (
-                <Icon icon="svg-spinners:ring-resize" className="h-4 w-4 animate-spin" />
-              );
+              statusIcon = <Loader2 className="h-4 w-4 animate-spin" />;
               statusText = 'Extracting...';
               break;
           }
@@ -149,8 +131,7 @@ export function useModelDownloadToast({
                 )}
               </div>
             ),
-            duration: progress.status === 'complete' ? 5000 : Infinity,
-            variant: progress.status === 'error' ? 'destructive' : 'default',
+            duration: progress.status === 'complete' || progress.status === 'error' ? 5000 : Infinity,
           });
 
           // Close connection and dismiss toast on completion or error
@@ -172,11 +153,7 @@ export function useModelDownloadToast({
               toastUpdateRef.current({
                 title: (
                   <div className="flex items-center gap-2">
-                    <HugeiconsIcon
-                      icon={CheckmarkCircle02Icon}
-                      size={16}
-                      className="h-4 w-4 text-green-500"
-                    />
+                    <CheckCircle2 className="h-4 w-4 text-green-500" />
                     <span>{displayName}</span>
                   </div>
                 ),
@@ -191,7 +168,7 @@ export function useModelDownloadToast({
               onComplete();
             } else if (isError && onError) {
               console.log('[useModelDownloadToast] Download error, calling onError callback');
-              onError();
+              onError(progress.error || 'Unknown error');
             }
           }
         }

app/src/lib/hooks/useSystemFolders.ts

@@ -1,14 +0,0 @@
-import { useQuery } from '@tanstack/react-query';
-import { apiClient } from '@/lib/api/client';
-import { useServerStore } from '@/stores/serverStore';
-
-export function useSystemFolders() {
-  const serverUrl = useServerStore((state) => state.serverUrl);
-
-  return useQuery({
-    queryKey: ['system', 'folders', serverUrl],
-    queryFn: () => apiClient.getSystemFolders(),
-    staleTime: 60000, // Cache for 1 minute - folder paths don't change often
-    retry: 1,
-  });
-}

app/src/lib/utils/audio.ts

@@ -22,6 +22,11 @@ export function formatAudioDuration(seconds: number): string {
  * If the file has a recordedDuration property (from recording hooks),
  * use that instead of trying to read metadata. This fixes issues on Windows
  * where WebM files from MediaRecorder don't have proper duration metadata.
+ *
+ * For uploaded files we use AudioContext.decodeAudioData which fully decodes
+ * the audio and returns the exact duration. This is more reliable than
+ * HTMLMediaElement.duration which can return incorrect large values for VBR
+ * MP3 files that lack a proper XING/VBRI header.
  */
 export async function getAudioDuration(
   file: File & { recordedDuration?: number },
@@ -30,26 +35,39 @@ export async function getAudioDuration(
     return file.recordedDuration;
   }
 
-  return new Promise((resolve, reject) => {
-    const audio = new Audio();
-    const url = URL.createObjectURL(file);
+  // Use Web Audio API for accurate duration — avoids VBR MP3 metadata issues.
+  try {
+    const audioContext = new AudioContext();
+    try {
+      const arrayBuffer = await file.arrayBuffer();
+      const audioBuffer = await audioContext.decodeAudioData(arrayBuffer);
+      return audioBuffer.duration;
+    } finally {
+      await audioContext.close();
+    }
+  } catch {
+    // Fallback: read duration from the media element (less accurate but works for WAV).
+    return new Promise((resolve, reject) => {
+      const audio = new Audio();
+      const url = URL.createObjectURL(file);
 
-    audio.addEventListener('loadedmetadata', () => {
-      URL.revokeObjectURL(url);
-      if (Number.isFinite(audio.duration) && audio.duration > 0) {
-        resolve(audio.duration);
-      } else {
-        reject(new Error('Audio file has invalid duration metadata'));
-      }
+      audio.addEventListener('loadedmetadata', () => {
+        URL.revokeObjectURL(url);
+        if (Number.isFinite(audio.duration) && audio.duration > 0) {
+          resolve(audio.duration);
+        } else {
+          reject(new Error('Audio file has invalid duration metadata'));
+        }
+      });
+
+      audio.addEventListener('error', () => {
+        URL.revokeObjectURL(url);
+        reject(new Error('Failed to load audio file'));
+      });
+
+      audio.src = url;
     });
-
-    audio.addEventListener('error', () => {
-      URL.revokeObjectURL(url);
-      reject(new Error('Failed to load audio file'));
-    });
-
-    audio.src = url;
-  });
+  }
 }
 
 /**

app/src/platform/types.ts

@@ -10,13 +10,6 @@ export interface FileFilter {
 
 export interface PlatformFilesystem {
   saveFile(filename: string, blob: Blob, filters?: FileFilter[]): Promise<void>;
-  /**
-   * Open a folder in the native file explorer.
-   * On web, this is a no-op since browsers cannot open folders.
-   * @param path - The absolute path to the folder to open
-   * @returns true if the folder was opened, false if not supported
-   */
-  openFolder(path: string): Promise<boolean>;
 }
 
 export interface UpdateStatus {
@@ -58,6 +51,7 @@ export interface PlatformAudio {
 export interface PlatformLifecycle {
   startServer(remote?: boolean): Promise<string>;
   stopServer(): Promise<void>;
+  restartServer(): Promise<string>;
   setKeepServerRunning(keep: boolean): Promise<void>;
   setupWindowCloseHandler(): Promise<void>;
   onServerReady?: () => void;

backend/backends/__init__.py

@@ -4,6 +4,7 @@ Backend abstraction layer for TTS and STT.
 Provides a unified interface for MLX and PyTorch backends.
 """
 
+import threading
 from typing import Protocol, Optional, Tuple, List
 from typing_extensions import runtime_checkable
 import numpy as np
@@ -112,44 +113,65 @@ class STTBackend(Protocol):
 
 # Global backend instances
 _tts_backend: Optional[TTSBackend] = None
+_tts_backends: dict[str, TTSBackend] = {}
+_tts_backends_lock = threading.Lock()
 _stt_backend: Optional[STTBackend] = None
 
+# Supported TTS engines
+TTS_ENGINES = {
+    "qwen": "Qwen TTS",
+    "luxtts": "LuxTTS",
+}
+
 
 def get_tts_backend() -> TTSBackend:
     """
-    Get or create TTS backend instance based on platform.
-
+    Get or create the default (Qwen) TTS backend instance based on platform.
+    
     Returns:
         TTS backend instance (MLX or PyTorch)
-
-    Raises:
-        ImportError: If required dependencies (mlx or torch) are not available
     """
-    global _tts_backend
+    return get_tts_backend_for_engine("qwen")
 
-    if _tts_backend is None:
-        backend_type = get_backend_type()
 
-        if backend_type == "mlx":
-            try:
+def get_tts_backend_for_engine(engine: str) -> TTSBackend:
+    """
+    Get or create a TTS backend for the given engine.
+    
+    Args:
+        engine: Engine name ("qwen" or "luxtts")
+    
+    Returns:
+        TTS backend instance
+    """
+    global _tts_backends
+    
+    # Fast path: check without lock
+    if engine in _tts_backends:
+        return _tts_backends[engine]
+    
+    # Slow path: create with lock to avoid duplicate instantiation
+    with _tts_backends_lock:
+        # Double-check after acquiring lock
+        if engine in _tts_backends:
+            return _tts_backends[engine]
+        
+        if engine == "qwen":
+            backend_type = get_backend_type()
+            if backend_type == "mlx":
                 from .mlx_backend import MLXTTSBackend
-                _tts_backend = MLXTTSBackend()
-            except ImportError as e:
-                raise ImportError(
-                    f"MLX backend dependencies not available. "
-                    f"Please install mlx and mlx_audio or download a provider. Error: {e}"
-                )
-        else:
-            try:
+                backend = MLXTTSBackend()
+            else:
                 from .pytorch_backend import PyTorchTTSBackend
-                _tts_backend = PyTorchTTSBackend()
-            except ImportError as e:
-                raise ImportError(
-                    f"PyTorch backend dependencies not available. "
-                    f"Please download a TTS provider (pytorch-cpu or pytorch-cuda) from the Downloads page. Error: {e}"
-                )
-
-    return _tts_backend
+                backend = PyTorchTTSBackend()
+        elif engine == "luxtts":
+            from .luxtts_backend import LuxTTSBackend
+            backend = LuxTTSBackend()
+        else:
+            raise ValueError(f"Unknown TTS engine: {engine}. Supported: {list(TTS_ENGINES.keys())}")
+        
+        _tts_backends[engine] = backend
+        return backend
 
 
 def get_stt_backend() -> STTBackend:
@@ -176,6 +198,7 @@ def get_stt_backend() -> STTBackend:
 
 def reset_backends():
     """Reset backend instances (useful for testing)."""
-    global _tts_backend, _stt_backend
+    global _tts_backend, _tts_backends, _stt_backend
     _tts_backend = None
+    _tts_backends.clear()
     _stt_backend = None

backend/backends/luxtts_backend.py

@@ -0,0 +1,264 @@
+"""
+LuxTTS backend implementation.
+
+Wraps the LuxTTS (ZipVoice) model for zero-shot voice cloning.
+~1GB VRAM, 48kHz output, 150x realtime on CPU.
+"""
+
+import asyncio
+import logging
+from pathlib import Path
+from typing import List, Optional, Tuple
+
+import numpy as np
+
+from . import TTSBackend
+from ..utils.audio import normalize_audio, load_audio
+from ..utils.cache import get_cache_key, get_cached_voice_prompt, cache_voice_prompt
+from ..utils.progress import get_progress_manager
+from ..utils.tasks import get_task_manager
+
+logger = logging.getLogger(__name__)
+
+# HuggingFace repo for model weight detection
+LUXTTS_HF_REPO = "YatharthS/LuxTTS"
+
+
+class LuxTTSBackend:
+    """LuxTTS backend for zero-shot voice cloning."""
+
+    def __init__(self):
+        self.model = None
+        self.model_size = "default"  # LuxTTS has only one model size
+        self._device = None
+
+    def _get_device(self) -> str:
+        """Get the best available device."""
+        import torch
+
+        if torch.cuda.is_available():
+            return "cuda"
+        if hasattr(torch.backends, "mps") and torch.backends.mps.is_available():
+            return "mps"
+        return "cpu"
+
+    def is_loaded(self) -> bool:
+        return self.model is not None
+
+    @property
+    def device(self) -> str:
+        if self._device is None:
+            self._device = self._get_device()
+        return self._device
+
+    def _get_model_path(self, model_size: str) -> str:
+        return LUXTTS_HF_REPO
+
+    def _is_model_cached(self, model_size: str = "default") -> bool:
+        """Check if LuxTTS model weights are cached locally."""
+        try:
+            from huggingface_hub import constants as hf_constants
+
+            repo_cache = (
+                Path(hf_constants.HF_HUB_CACHE)
+                / ("models--" + LUXTTS_HF_REPO.replace("/", "--"))
+            )
+
+            if not repo_cache.exists():
+                return False
+
+            blobs_dir = repo_cache / "blobs"
+            if blobs_dir.exists() and any(blobs_dir.glob("*.incomplete")):
+                return False
+
+            snapshots_dir = repo_cache / "snapshots"
+            if snapshots_dir.exists():
+                has_weights = any(snapshots_dir.rglob("*.pt")) or any(
+                    snapshots_dir.rglob("*.safetensors")
+                ) or any(snapshots_dir.rglob("*.onnx")) or any(
+                    snapshots_dir.rglob("*.bin")
+                )
+                return has_weights
+
+            return False
+        except Exception as e:
+            logger.warning(f"Error checking LuxTTS cache: {e}")
+            return False
+
+    async def load_model(self, model_size: str = "default") -> None:
+        """Load the LuxTTS model."""
+        if self.model is not None:
+            return
+
+        await asyncio.to_thread(self._load_model_sync)
+
+    def _load_model_sync(self):
+        """Synchronous model loading."""
+        progress_manager = get_progress_manager()
+        task_manager = get_task_manager()
+        model_name = "luxtts"
+
+        is_cached = self._is_model_cached()
+
+        if not is_cached:
+            task_manager.start_download(model_name)
+            progress_manager.update_progress(
+                model_name=model_name,
+                current=0,
+                total=0,
+                filename="Downloading LuxTTS model...",
+                status="downloading",
+            )
+
+        try:
+            from zipvoice.luxvoice import LuxTTS
+
+            device = self.device
+            logger.info(f"Loading LuxTTS on {device}...")
+
+            # LuxTTS constructor downloads model and loads everything
+            if device == "cpu":
+                import os
+                threads = os.cpu_count() or 4
+                self.model = LuxTTS(
+                    model_path=LUXTTS_HF_REPO,
+                    device="cpu",
+                    threads=min(threads, 8),
+                )
+            else:
+                self.model = LuxTTS(
+                    model_path=LUXTTS_HF_REPO,
+                    device=device,
+                )
+
+            if not is_cached:
+                progress_manager.mark_complete(model_name)
+                task_manager.complete_download(model_name)
+
+            logger.info("LuxTTS loaded successfully")
+
+        except Exception as e:
+            logger.error(f"Failed to load LuxTTS: {e}")
+            if not is_cached:
+                progress_manager.mark_error(model_name, str(e))
+                task_manager.error_download(model_name, str(e))
+            raise
+
+    def unload_model(self) -> None:
+        """Unload model to free memory."""
+        if self.model is not None:
+            del self.model
+            self.model = None
+
+            import torch
+            if torch.cuda.is_available():
+                torch.cuda.empty_cache()
+
+            logger.info("LuxTTS unloaded")
+
+    async def create_voice_prompt(
+        self,
+        audio_path: str,
+        reference_text: str,
+        use_cache: bool = True,
+    ) -> Tuple[dict, bool]:
+        """
+        Create voice prompt from reference audio.
+
+        LuxTTS uses its own encode_prompt() which runs Whisper ASR internally
+        to transcribe the reference. The reference_text parameter is not used
+        by LuxTTS itself, but we include it in the cache key for consistency.
+        """
+        await self.load_model()
+
+        # Compute cache key once for both lookup and storage
+        cache_key = ("luxtts_" + get_cache_key(audio_path, reference_text)) if use_cache else None
+
+        if cache_key:
+            cached = get_cached_voice_prompt(cache_key)
+            if cached is not None and isinstance(cached, dict):
+                return cached, True
+
+        def _encode_sync():
+            return self.model.encode_prompt(
+                prompt_audio=str(audio_path),
+                duration=5,
+                rms=0.01,
+            )
+
+        encoded = await asyncio.to_thread(_encode_sync)
+
+        if cache_key:
+            cache_voice_prompt(cache_key, encoded)
+
+        return encoded, False
+
+    async def combine_voice_prompts(
+        self,
+        audio_paths: List[str],
+        reference_texts: List[str],
+    ) -> Tuple[np.ndarray, str]:
+        """
+        Combine multiple reference samples.
+
+        LuxTTS doesn't have native multi-prompt support, so we concatenate
+        the audio and let encode_prompt handle the combined clip.
+        """
+        combined_audio = []
+        for path in audio_paths:
+            audio, _sr = load_audio(path, sample_rate=24000)
+            audio = normalize_audio(audio)
+            combined_audio.append(audio)
+
+        mixed = np.concatenate(combined_audio)
+        mixed = normalize_audio(mixed)
+        combined_text = " ".join(reference_texts)
+
+        return mixed, combined_text
+
+    async def generate(
+        self,
+        text: str,
+        voice_prompt: dict,
+        language: str = "en",
+        seed: Optional[int] = None,
+        instruct: Optional[str] = None,
+    ) -> Tuple[np.ndarray, int]:
+        """
+        Generate audio from text using LuxTTS.
+
+        Args:
+            text: Text to synthesize
+            voice_prompt: Encoded prompt dict from encode_prompt()
+            language: Language code (LuxTTS is English-focused)
+            seed: Random seed for reproducibility
+            instruct: Not supported by LuxTTS (ignored)
+
+        Returns:
+            Tuple of (audio_array, sample_rate)
+        """
+        await self.load_model()
+
+        def _generate_sync():
+            import torch
+
+            if seed is not None:
+                torch.manual_seed(seed)
+                if torch.cuda.is_available():
+                    torch.cuda.manual_seed(seed)
+
+            wav = self.model.generate_speech(
+                text=text,
+                encode_dict=voice_prompt,
+                num_steps=4,
+                guidance_scale=3.0,
+                t_shift=0.5,
+                speed=1.0,
+                return_smooth=False,  # 48kHz output
+            )
+
+            # LuxTTS returns a tensor (may be on GPU/MPS), move to CPU first
+            audio = wav.detach().cpu().numpy().squeeze()
+            return audio, 48000
+
+        return await asyncio.to_thread(_generate_sync)

backend/backends/mlx_backend.py

@@ -379,9 +379,17 @@ class MLXTTSBackend:
         return audio, sample_rate
 
 
+WHISPER_HF_REPOS = {
+    "base": "openai/whisper-base",
+    "small": "openai/whisper-small",
+    "medium": "openai/whisper-medium",
+    "large": "openai/whisper-large-v3",
+}
+
+
 class MLXSTTBackend:
     """MLX-based STT backend using mlx-audio Whisper."""
-    
+
     def __init__(self, model_size: str = "base"):
         self.model = None
         self.model_size = model_size
@@ -402,8 +410,8 @@ class MLXSTTBackend:
         """
         try:
             from huggingface_hub import constants as hf_constants
-            model_name = f"openai/whisper-{model_size}"
-            repo_cache = Path(hf_constants.HF_HUB_CACHE) / ("models--" + model_name.replace("/", "--"))
+            hf_repo = WHISPER_HF_REPOS.get(model_size, f"openai/whisper-{model_size}")
+            repo_cache = Path(hf_constants.HF_HUB_CACHE) / ("models--" + hf_repo.replace("/", "--"))
             
             if not repo_cache.exists():
                 return False
@@ -474,7 +482,7 @@ class MLXSTTBackend:
             from mlx_audio.stt import load
 
             # MLX Whisper uses the standard OpenAI models
-            model_name = f"openai/whisper-{model_size}"
+            model_name = WHISPER_HF_REPOS.get(model_size, f"openai/whisper-{model_size}")
 
             print(f"Loading MLX Whisper model {model_size}...")
 

backend/backends/pytorch_backend.py

@@ -29,9 +29,23 @@ class PyTorchTTSBackend:
         """Get the best available device."""
         if torch.cuda.is_available():
             return "cuda"
-        elif hasattr(torch.backends, 'mps') and torch.backends.mps.is_available():
-            # MPS can have issues, use CPU for stability
-            return "cpu"
+        # Intel Arc / Intel Xe GPU via intel-extension-for-pytorch (IPEX)
+        try:
+            import intel_extension_for_pytorch  # noqa: F401
+            if hasattr(torch, 'xpu') and torch.xpu.is_available():
+                return "xpu"
+        except ImportError:
+            pass
+        # Any GPU on Windows via DirectML (torch-directml)
+        try:
+            import torch_directml
+            if torch_directml.device_count() > 0:
+                return torch_directml.device(0)
+        except ImportError:
+            pass
+        # MPS (Apple Silicon) — kept for completeness but MLX backend is preferred
+        if hasattr(torch.backends, 'mps') and torch.backends.mps.is_available():
+            return "cpu"  # MPS disabled for stability; MLX backend handles Apple Silicon
         return "cpu"
     
     def is_loaded(self) -> bool:
@@ -166,11 +180,21 @@ class PyTorchTTSBackend:
 
             # Load the model (tqdm is patched, but filters out non-download progress)
             try:
-                self.model = Qwen3TTSModel.from_pretrained(
-                    model_path,
-                    device_map=self.device,
-                    torch_dtype=torch.float32 if self.device == "cpu" else torch.bfloat16,
-                )
+                # Don't pass device_map on CPU: accelerate's meta-tensor mechanism
+                # causes "Cannot copy out of meta tensor" when moving to CPU.
+                # Instead load directly then call .to(device) if needed.
+                if self.device == "cpu":
+                    self.model = Qwen3TTSModel.from_pretrained(
+                        model_path,
+                        torch_dtype=torch.float32,
+                        low_cpu_mem_usage=False,
+                    )
+                else:
+                    self.model = Qwen3TTSModel.from_pretrained(
+                        model_path,
+                        device_map=self.device,
+                        torch_dtype=torch.bfloat16,
+                    )
             finally:
                 # Exit the patch context
                 tracker_context.__exit__(None, None, None)
@@ -345,9 +369,17 @@ class PyTorchTTSBackend:
         return audio, sample_rate
 
 
+WHISPER_HF_REPOS = {
+    "base": "openai/whisper-base",
+    "small": "openai/whisper-small",
+    "medium": "openai/whisper-medium",
+    "large": "openai/whisper-large-v3",
+}
+
+
 class PyTorchSTTBackend:
     """PyTorch-based STT backend using Whisper."""
-    
+
     def __init__(self, model_size: str = "base"):
         self.model = None
         self.processor = None
@@ -358,9 +390,22 @@ class PyTorchSTTBackend:
         """Get the best available device."""
         if torch.cuda.is_available():
             return "cuda"
-        elif hasattr(torch.backends, 'mps') and torch.backends.mps.is_available():
-            # MPS support for Whisper
-            return "cpu"  # Use CPU for stability
+        # Intel Arc / Intel Xe GPU via intel-extension-for-pytorch (IPEX)
+        try:
+            import intel_extension_for_pytorch  # noqa: F401
+            if hasattr(torch, 'xpu') and torch.xpu.is_available():
+                return "xpu"
+        except ImportError:
+            pass
+        # Any GPU on Windows via DirectML (torch-directml)
+        try:
+            import torch_directml
+            if torch_directml.device_count() > 0:
+                return torch_directml.device(0)
+        except ImportError:
+            pass
+        if hasattr(torch.backends, 'mps') and torch.backends.mps.is_available():
+            return "cpu"  # MPS disabled for stability
         return "cpu"
     
     def is_loaded(self) -> bool:
@@ -379,18 +424,18 @@ class PyTorchSTTBackend:
         """
         try:
             from huggingface_hub import constants as hf_constants
-            model_name = f"openai/whisper-{model_size}"
-            repo_cache = Path(hf_constants.HF_HUB_CACHE) / ("models--" + model_name.replace("/", "--"))
-            
+            hf_repo = WHISPER_HF_REPOS.get(model_size, f"openai/whisper-{model_size}")
+            repo_cache = Path(hf_constants.HF_HUB_CACHE) / ("models--" + hf_repo.replace("/", "--"))
+
             if not repo_cache.exists():
                 return False
-            
+
             # Check for .incomplete files - if any exist, download is still in progress
             blobs_dir = repo_cache / "blobs"
             if blobs_dir.exists() and any(blobs_dir.glob("*.incomplete")):
                 print(f"[_is_model_cached] Found .incomplete files for whisper-{model_size}, treating as not cached")
                 return False
-            
+
             # Check that actual model weight files exist in snapshots
             snapshots_dir = repo_cache / "snapshots"
             if snapshots_dir.exists():
@@ -401,12 +446,12 @@ class PyTorchSTTBackend:
                 if not has_weights:
                     print(f"[_is_model_cached] No model weights found for whisper-{model_size}, treating as not cached")
                     return False
-            
+
             return True
         except Exception as e:
             print(f"[_is_model_cached] Error checking cache for whisper-{model_size}: {e}")
             return False
-    
+
     async def load_model_async(self, model_size: Optional[str] = None):
         """
         Lazy load the Whisper model.
@@ -457,7 +502,7 @@ class PyTorchSTTBackend:
             # Import transformers
             from transformers import WhisperProcessor, WhisperForConditionalGeneration
 
-            model_name = f"openai/whisper-{model_size}"
+            model_name = WHISPER_HF_REPOS.get(model_size, f"openai/whisper-{model_size}")
             print(f"[DEBUG] Model name: {model_name}")
 
             print(f"Loading Whisper model {model_size} on {self.device}...")

backend/build_binary.py

@@ -1,8 +1,13 @@
 """
 PyInstaller build script for creating standalone Python server binary.
+
+Usage:
+    python build_binary.py           # Build default (CPU) server binary
+    python build_binary.py --cuda    # Build CUDA-enabled server binary
 """
 
 import PyInstaller.__main__
+import argparse
 import os
 import platform
 from pathlib import Path
@@ -13,15 +18,22 @@ def is_apple_silicon():
     return platform.system() == "Darwin" and platform.machine() == "arm64"
 
 
-def build_server():
-    """Build Python server as standalone binary."""
+def build_server(cuda=False):
+    """Build Python server as standalone binary.
+
+    Args:
+        cuda: If True, build with CUDA support and name the binary
+              voicebox-server-cuda instead of voicebox-server.
+    """
     backend_dir = Path(__file__).parent
 
+    binary_name = 'voicebox-server-cuda' if cuda else 'voicebox-server'
+
     # PyInstaller arguments
     args = [
         'server.py',  # Use server.py as entry point instead of main.py
         '--onefile',
-        '--name', 'voicebox-server',
+        '--name', binary_name,
     ]
 
     # Add local qwen_tts path if specified (for editable installs)
@@ -30,7 +42,7 @@ def build_server():
         args.extend(['--paths', str(qwen_tts_path)])
         print(f"Using local qwen_tts source from: {qwen_tts_path}")
 
-    # Add common hidden imports (always included)
+    # Add common hidden imports
     args.extend([
         '--hidden-import', 'backend',
         '--hidden-import', 'backend.main',
@@ -42,42 +54,47 @@ def build_server():
         '--hidden-import', 'backend.tts',
         '--hidden-import', 'backend.transcribe',
         '--hidden-import', 'backend.platform_detect',
-        '--hidden-import', 'backend.providers',
-        '--hidden-import', 'backend.providers.base',
-        '--hidden-import', 'backend.providers.bundled',
-        '--hidden-import', 'backend.providers.types',
+        '--hidden-import', 'backend.backends',
+        '--hidden-import', 'backend.backends.pytorch_backend',
         '--hidden-import', 'backend.utils.audio',
         '--hidden-import', 'backend.utils.cache',
         '--hidden-import', 'backend.utils.progress',
         '--hidden-import', 'backend.utils.hf_progress',
         '--hidden-import', 'backend.utils.validation',
-        '--hidden-import', 'numpy',
-        '--hidden-import', 'numpy.core',
-        '--hidden-import', 'numpy.core._multiarray_umath',
-        '--hidden-import', 'scipy',
-        '--hidden-import', 'scipy.signal',
+        '--hidden-import', 'backend.cuda_download',
+        '--hidden-import', 'torch',
+        '--hidden-import', 'transformers',
         '--hidden-import', 'fastapi',
         '--hidden-import', 'uvicorn',
         '--hidden-import', 'sqlalchemy',
         '--hidden-import', 'librosa',
         '--hidden-import', 'soundfile',
+        '--hidden-import', 'qwen_tts',
+        '--hidden-import', 'qwen_tts.inference',
+        '--hidden-import', 'qwen_tts.inference.qwen3_tts_model',
+        '--hidden-import', 'qwen_tts.inference.qwen3_tts_tokenizer',
+        '--hidden-import', 'qwen_tts.core',
+        '--hidden-import', 'qwen_tts.cli',
+        '--copy-metadata', 'qwen-tts',
+        '--collect-submodules', 'qwen_tts',
+        '--collect-data', 'qwen_tts',
         # Fix for pkg_resources and jaraco namespace packages
         '--hidden-import', 'pkg_resources.extern',
         '--collect-submodules', 'jaraco',
-        # Asyncio and threading support for PyInstaller
-        '--hidden-import', 'asyncio',
-        '--hidden-import', 'asyncio.subprocess',
-        '--hidden-import', 'concurrent.futures',
-        '--hidden-import', 'concurrent.futures.thread',
     ])
 
-    # Platform-specific TTS backend handling
-    system = platform.system()
-
-    if is_apple_silicon():
-        print("Building for Apple Silicon - including MLX dependencies (bundled)")
+    # Add CUDA-specific hidden imports
+    if cuda:
+        print("Building with CUDA support")
+        args.extend([
+            '--hidden-import', 'torch.cuda',
+            '--hidden-import', 'torch.backends.cudnn',
+        ])
+
+    # Add MLX-specific imports if building on Apple Silicon (never for CUDA builds)
+    if is_apple_silicon() and not cuda:
+        print("Building for Apple Silicon - including MLX dependencies")
         args.extend([
-            '--hidden-import', 'backend.backends',
             '--hidden-import', 'backend.backends.mlx_backend',
             '--hidden-import', 'mlx',
             '--hidden-import', 'mlx.core',
@@ -87,35 +104,16 @@ def build_server():
             '--hidden-import', 'mlx_audio.stt',
             '--collect-submodules', 'mlx',
             '--collect-submodules', 'mlx_audio',
-            # Collect MLX data files including Metal shader libraries (.metallib)
-            '--collect-data', 'mlx',
-            '--collect-data', 'mlx_audio',
-        ])
-    elif system == "Windows" or (system == "Darwin" and not is_apple_silicon()):
-        # Windows and Intel macOS: Bundle PyTorch CPU provider
-        print(f"Building for {system} - including PyTorch CPU provider (bundled)")
-        args.extend([
-            '--hidden-import', 'backend.backends',
-            '--hidden-import', 'backend.backends.pytorch_backend',
-            '--hidden-import', 'torch',
-            '--hidden-import', 'transformers',
-            '--hidden-import', 'qwen_tts',
-            '--hidden-import', 'qwen_tts.inference',
-            '--hidden-import', 'qwen_tts.inference.qwen3_tts_model',
-            '--hidden-import', 'qwen_tts.inference.qwen3_tts_tokenizer',
-            '--hidden-import', 'qwen_tts.core',
-            '--hidden-import', 'qwen_tts.cli',
-            '--copy-metadata', 'qwen-tts',
-            '--collect-submodules', 'qwen_tts',
-            '--collect-data', 'qwen_tts',
-        ])
-    else:
-        # Linux: No bundled provider - users download providers separately
-        print("Building for Linux - no bundled provider (users download separately)")
-        args.extend([
-            '--hidden-import', 'backend.backends',
-            '--hidden-import', 'backend.backends.pytorch_backend',
+            # Use --collect-all so PyInstaller bundles both data files AND
+            # native shared libraries (.dylib, .metallib) for MLX.
+            # Previously only --collect-data was used, which caused MLX to
+            # raise OSError at runtime inside the bundled binary because
+            # the Metal shader libraries were missing.
+            '--collect-all', 'mlx',
+            '--collect-all', 'mlx_audio',
         ])
+    elif not cuda:
+        print("Building for non-Apple Silicon platform - PyTorch only")
 
     args.extend([
         '--noconfirm',
@@ -128,8 +126,15 @@ def build_server():
     # Run PyInstaller
     PyInstaller.__main__.run(args)
     
-    print(f"Binary built in {backend_dir / 'dist' / 'voicebox-server'}")
+    print(f"Binary built in {backend_dir / 'dist' / binary_name}")
 
 
 if __name__ == '__main__':
-    build_server()
+    parser = argparse.ArgumentParser(description="Build voicebox-server binary")
+    parser.add_argument(
+        '--cuda',
+        action='store_true',
+        help="Build CUDA-enabled binary (voicebox-server-cuda)",
+    )
+    cli_args = parser.parse_args()
+    build_server(cuda=cli_args.cuda)

backend/config.py

@@ -4,8 +4,17 @@ Configuration module for voicebox backend.
 Handles data directory configuration for production bundling.
 """
 
+import os
 from pathlib import Path
 
+# Allow users to override the HuggingFace model download directory.
+# Set VOICEBOX_MODELS_DIR to an absolute path before starting the server.
+# This sets HF_HUB_CACHE so all huggingface_hub downloads go to that path.
+_custom_models_dir = os.environ.get("VOICEBOX_MODELS_DIR")
+if _custom_models_dir:
+    os.environ["HF_HUB_CACHE"] = _custom_models_dir
+    print(f"[config] Model download path set to: {_custom_models_dir}")
+
 # Default data directory (used in development)
 _data_dir = Path("data")
 

backend/cuda_download.py

@@ -0,0 +1,198 @@
+"""
+CUDA backend binary download, assembly, and verification.
+
+Downloads split parts of the CUDA-enabled voicebox-server binary from
+GitHub Releases, reassembles them, verifies integrity via SHA-256,
+and places the binary in the app's data directory for use on next
+backend restart.
+"""
+
+import hashlib
+import logging
+import os
+import sys
+from pathlib import Path
+from typing import Optional
+
+from .config import get_data_dir
+from .utils.progress import get_progress_manager
+from . import __version__
+
+logger = logging.getLogger(__name__)
+
+GITHUB_RELEASES_URL = "https://github.com/jamiepine/voicebox/releases/download"
+
+PROGRESS_KEY = "cuda-backend"
+
+
+def get_backends_dir() -> Path:
+    """Directory where downloaded backend binaries are stored."""
+    d = get_data_dir() / "backends"
+    d.mkdir(parents=True, exist_ok=True)
+    return d
+
+
+def get_cuda_binary_name() -> str:
+    """Platform-specific CUDA binary filename."""
+    if sys.platform == "win32":
+        return "voicebox-server-cuda.exe"
+    return "voicebox-server-cuda"
+
+
+def get_cuda_binary_path() -> Optional[Path]:
+    """Return path to CUDA binary if it exists."""
+    p = get_backends_dir() / get_cuda_binary_name()
+    if p.exists():
+        return p
+    return None
+
+
+def is_cuda_active() -> bool:
+    """Check if the current process is the CUDA binary.
+
+    The CUDA binary sets this env var on startup (see server.py).
+    """
+    return os.environ.get("VOICEBOX_BACKEND_VARIANT") == "cuda"
+
+
+def get_cuda_status() -> dict:
+    """Get current CUDA backend status for the API."""
+    progress_manager = get_progress_manager()
+    cuda_path = get_cuda_binary_path()
+    progress = progress_manager.get_progress(PROGRESS_KEY)
+
+    return {
+        "available": cuda_path is not None,
+        "active": is_cuda_active(),
+        "binary_path": str(cuda_path) if cuda_path else None,
+        "downloading": progress is not None and progress.get("status") == "downloading",
+        "download_progress": progress,
+    }
+
+
+async def download_cuda_binary(version: Optional[str] = None):
+    """Download the CUDA backend binary from GitHub Releases.
+
+    Downloads split parts listed in a manifest file, concatenates them,
+    and verifies the SHA-256 checksum for integrity. Atomic write
+    (temp file -> rename).
+
+    Args:
+        version: Version tag (e.g. "v0.2.0"). Defaults to current app version.
+    """
+    import httpx
+
+    if version is None:
+        version = f"v{__version__}"
+
+    progress = get_progress_manager()
+    binary_name = get_cuda_binary_name()
+    dest_dir = get_backends_dir()
+    final_path = dest_dir / binary_name
+    temp_path = dest_dir / f"{binary_name}.download"
+
+    # Clean up any leftover partial download
+    if temp_path.exists():
+        temp_path.unlink()
+
+    logger.info(f"Starting CUDA backend download for {version}")
+    progress.update_progress(
+        PROGRESS_KEY, current=0, total=0,
+        filename="Fetching manifest...", status="downloading",
+    )
+
+    base_url = f"{GITHUB_RELEASES_URL}/{version}"
+    stem = Path(binary_name).stem  # voicebox-server-cuda
+
+    try:
+        async with httpx.AsyncClient(follow_redirects=True, timeout=30.0) as client:
+            # Fetch the manifest (list of split part filenames)
+            manifest_url = f"{base_url}/{stem}.manifest"
+            manifest_resp = await client.get(manifest_url)
+            manifest_resp.raise_for_status()
+            parts = [p.strip() for p in manifest_resp.text.strip().splitlines() if p.strip()]
+
+            if not parts:
+                raise ValueError("Empty manifest — no split parts found")
+
+            logger.info(f"Found {len(parts)} split parts to download")
+
+            # Fetch expected checksum (optional — for integrity verification)
+            expected_sha = None
+            try:
+                sha_url = f"{base_url}/{stem}.sha256"
+                sha_resp = await client.get(sha_url)
+                if sha_resp.status_code == 200:
+                    # Format: "sha256hex  filename\n"
+                    expected_sha = sha_resp.text.strip().split()[0]
+                    logger.info(f"Expected SHA-256: {expected_sha[:16]}...")
+            except Exception as e:
+                logger.warning(f"Could not fetch checksum file — skipping verification: {e}")
+
+            # Download and concatenate parts
+            total_downloaded = 0
+            with open(temp_path, "wb") as f:
+                for i, part_name in enumerate(parts):
+                    part_url = f"{base_url}/{part_name}"
+                    logger.info(f"Downloading part {i + 1}/{len(parts)}: {part_name}")
+
+                    async with client.stream("GET", part_url) as response:
+                        response.raise_for_status()
+                        async for chunk in response.aiter_bytes(chunk_size=1024 * 1024):
+                            f.write(chunk)
+                            total_downloaded += len(chunk)
+                            progress.update_progress(
+                                PROGRESS_KEY, current=total_downloaded, total=0,
+                                filename=f"Part {i + 1}/{len(parts)}",
+                                status="downloading",
+                            )
+
+        # Verify integrity if checksum was available
+        if expected_sha:
+            progress.update_progress(
+                PROGRESS_KEY, current=total_downloaded, total=total_downloaded,
+                filename="Verifying integrity...", status="downloading",
+            )
+            sha256 = hashlib.sha256()
+            with open(temp_path, "rb") as f:
+                while True:
+                    chunk = f.read(1024 * 1024)
+                    if not chunk:
+                        break
+                    sha256.update(chunk)
+
+            actual = sha256.hexdigest()
+            if actual != expected_sha:
+                raise ValueError(
+                    f"Integrity check failed: expected {expected_sha[:16]}..., "
+                    f"got {actual[:16]}..."
+                )
+            logger.info(f"Integrity verified: {actual[:16]}...")
+
+        # Atomic move into place (replace handles existing target on all platforms)
+        temp_path.replace(final_path)
+
+        # Make executable on Unix
+        if sys.platform != "win32":
+            final_path.chmod(0o755)
+
+        logger.info(f"CUDA backend downloaded to {final_path}")
+        progress.mark_complete(PROGRESS_KEY)
+
+    except Exception as e:
+        # Clean up on failure
+        if temp_path.exists():
+            temp_path.unlink()
+        logger.error(f"CUDA backend download failed: {e}")
+        progress.mark_error(PROGRESS_KEY, str(e))
+        raise
+
+
+async def delete_cuda_binary() -> bool:
+    """Delete the downloaded CUDA binary. Returns True if deleted."""
+    path = get_cuda_binary_path()
+    if path and path.exists():
+        path.unlink()
+        logger.info(f"Deleted CUDA binary: {path}")
+        return True
+    return False

backend/main.py

@@ -14,6 +14,7 @@ from datetime import datetime
 import asyncio
 import uvicorn
 import argparse
+import torch
 import tempfile
 import io
 from pathlib import Path
@@ -21,14 +22,24 @@ import uuid
 import asyncio
 import signal
 import os
+from urllib.parse import quote
+
+
+def _safe_content_disposition(disposition_type: str, filename: str) -> str:
+    """Build a Content-Disposition header that is safe for non-ASCII filenames.
+
+    Uses RFC 5987 ``filename*`` parameter so that browsers can decode
+    UTF-8 filenames while the ``filename`` fallback stays ASCII-only.
+    """
+    ascii_name = "".join(
+        c for c in filename if c.isascii() and (c.isalnum() or c in " -_.")
+    ).strip() or "download"
+    utf8_name = quote(filename, safe="")
+    return (
+        f'{disposition_type}; filename="{ascii_name}"; '
+        f"filename*=UTF-8''{utf8_name}"
+    )
 
-# Optional torch import - not available on all platforms (e.g. Windows/Linux without bundled provider)
-try:
-    import torch
-    TORCH_AVAILABLE = True
-except ImportError:
-    torch = None  # type: ignore
-    TORCH_AVAILABLE = False
 
 from . import database, models, profiles, history, tts, transcribe, config, export_import, channels, stories, __version__
 from .database import get_db, Generation as DBGeneration, VoiceProfile as DBVoiceProfile
@@ -36,8 +47,18 @@ from .utils.progress import get_progress_manager
 from .utils.tasks import get_task_manager
 from .utils.cache import clear_voice_prompt_cache
 from .platform_detect import get_backend_type
-from .providers import get_provider_manager
-from .providers.types import ProviderType
+
+# Keep references to fire-and-forget background tasks to prevent GC
+_background_tasks: set = set()
+
+
+def _create_background_task(coro) -> asyncio.Task:
+    """Create a background task and prevent it from being garbage collected."""
+    task = asyncio.create_task(coro)
+    _background_tasks.add(task)
+    task.add_done_callback(_background_tasks.discard)
+    return task
+
 
 app = FastAPI(
     title="voicebox API",
@@ -59,8 +80,10 @@ app.add_middleware(
 # ROOT & HEALTH ENDPOINTS
 # ============================================
 
-# Root endpoint removed - web UI served at / instead
-# API info available at /health
+@app.get("/")
+async def root():
+    """Root endpoint."""
+    return {"message": "voicebox API", "version": __version__}
 
 
 @app.post("/shutdown")
@@ -74,76 +97,83 @@ async def shutdown():
     return {"message": "Shutting down..."}
 
 
-@app.get("/system/folders", response_model=models.FolderPathsResponse)
-async def get_system_folders():
-    """Get system folder paths for data, models, and providers."""
-    from huggingface_hub import constants as hf_constants
-    from .providers.installer import _get_providers_dir
-    
-    return models.FolderPathsResponse(
-        data_dir=str(config.get_data_dir().absolute()),
-        models_dir=str(Path(hf_constants.HF_HUB_CACHE).absolute()),
-        providers_dir=str(_get_providers_dir().absolute()),
-    )
-
-
 @app.get("/health", response_model=models.HealthResponse)
 async def health():
     """Health check endpoint."""
-    from huggingface_hub import constants as hf_constants
+    from huggingface_hub import hf_hub_download, constants as hf_constants
     from pathlib import Path
+    import os
 
-    # Try to get TTS model provider, but it may not be available if dependencies aren't installed
-    tts_model = None
-    try:
-        tts_model = await tts.get_tts_model_async()
-    except ImportError as e:
-        # Provider dependencies not available (e.g., PyTorch not bundled on this platform)
-        # This is expected on Windows/Linux builds without a bundled provider
-        print(f"Provider not available: {e}")
-
+    tts_model = tts.get_tts_model()
     backend_type = get_backend_type()
 
-    # Check for GPU availability (CUDA or MPS)
-    # PyTorch might not be available if no provider is bundled
-    has_cuda = False
-    has_mps = False
-    if TORCH_AVAILABLE and torch is not None:
-        has_cuda = torch.cuda.is_available()
-        has_mps = hasattr(torch.backends, 'mps') and torch.backends.mps.is_available()
+    # Check for GPU availability (CUDA, MPS, Intel Arc XPU, or DirectML)
+    has_cuda = torch.cuda.is_available()
+    has_mps = hasattr(torch.backends, 'mps') and torch.backends.mps.is_available()
 
-    gpu_available = has_cuda or has_mps
+    # Intel Arc / Intel Xe via intel-extension-for-pytorch (IPEX)
+    has_xpu = False
+    xpu_name = None
+    try:
+        import intel_extension_for_pytorch as ipex  # noqa: F401
+        if hasattr(torch, 'xpu') and torch.xpu.is_available():
+            has_xpu = True
+            try:
+                xpu_name = torch.xpu.get_device_name(0)
+            except Exception:
+                xpu_name = "Intel GPU"
+    except ImportError:
+        pass
+
+    # DirectML backend (torch-directml) for any Windows GPU
+    has_directml = False
+    directml_name = None
+    try:
+        import torch_directml
+        if torch_directml.device_count() > 0:
+            has_directml = True
+            try:
+                directml_name = torch_directml.device_name(0)
+            except Exception:
+                directml_name = "DirectML GPU"
+    except ImportError:
+        pass
+
+    gpu_available = has_cuda or has_mps or has_xpu or has_directml or backend_type == "mlx"
 
     gpu_type = None
-    if has_cuda and torch is not None:
+    if has_cuda:
         gpu_type = f"CUDA ({torch.cuda.get_device_name(0)})"
     elif has_mps:
         gpu_type = "MPS (Apple Silicon)"
     elif backend_type == "mlx":
         gpu_type = "Metal (Apple Silicon via MLX)"
+    elif has_xpu:
+        gpu_type = f"XPU ({xpu_name})"
+    elif has_directml:
+        gpu_type = f"DirectML ({directml_name})"
 
     vram_used = None
-    if has_cuda and torch is not None:
+    if has_cuda:
         vram_used = torch.cuda.memory_allocated() / 1024 / 1024  # MB
-
+    
     # Check if model is loaded - use the same logic as model status endpoint
     model_loaded = False
     model_size = None
-    if tts_model is not None:
-        try:
-            # Use the same check as model status endpoint
-            if tts_model.is_loaded():
-                model_loaded = True
-                # Get the actual loaded model size
-                # Check _current_model_size first (more reliable for actually loaded models)
-                model_size = getattr(tts_model, '_current_model_size', None)
-                if not model_size:
-                    # Fallback to model_size attribute (which should be set when model loads)
-                    model_size = getattr(tts_model, 'model_size', None)
-        except Exception:
-            # If there's an error checking, assume not loaded
-            model_loaded = False
-            model_size = None
+    try:
+        # Use the same check as model status endpoint
+        if tts_model.is_loaded():
+            model_loaded = True
+            # Get the actual loaded model size
+            # Check _current_model_size first (more reliable for actually loaded models)
+            model_size = getattr(tts_model, '_current_model_size', None)
+            if not model_size:
+                # Fallback to model_size attribute (which should be set when model loads)
+                model_size = getattr(tts_model, 'model_size', None)
+    except Exception:
+        # If there's an error checking, assume not loaded
+        model_loaded = False
+        model_size = None
     
     # Check if default model is downloaded (cached)
     model_downloaded = None
@@ -188,6 +218,7 @@ async def health():
         gpu_type=gpu_type,
         vram_used_mb=vram_used,
         backend_type=backend_type,
+        backend_variant=os.environ.get("VOICEBOX_BACKEND_VARIANT", "cpu"),
     )
 
 
@@ -285,12 +316,17 @@ async def add_profile_sample(
     db: Session = Depends(get_db),
 ):
     """Add a sample to a voice profile."""
-    # Save uploaded file to temporary location
-    with tempfile.NamedTemporaryFile(suffix=".wav", delete=False) as tmp:
+    # Preserve the uploaded file's extension so librosa can detect format correctly.
+    # Defaulting to .wav was causing soundfile to reject MP3/WebM content as invalid WAV.
+    _allowed_audio_exts = {'.wav', '.mp3', '.m4a', '.ogg', '.flac', '.aac', '.webm', '.opus'}
+    _uploaded_ext = Path(file.filename or '').suffix.lower()
+    file_suffix = _uploaded_ext if _uploaded_ext in _allowed_audio_exts else '.wav'
+
+    with tempfile.NamedTemporaryFile(suffix=file_suffix, delete=False) as tmp:
         content = await file.read()
         tmp.write(content)
         tmp_path = tmp.name
-    
+
     try:
         sample = await profiles.add_profile_sample(
             profile_id,
@@ -301,6 +337,8 @@ async def add_profile_sample(
         return sample
     except ValueError as e:
         raise HTTPException(status_code=400, detail=str(e))
+    except Exception as e:
+        raise HTTPException(status_code=500, detail=f"Failed to process audio file: {str(e)}")
     finally:
         # Clean up temp file
         Path(tmp_path).unlink(missing_ok=True)
@@ -421,7 +459,7 @@ async def export_profile(
             io.BytesIO(zip_bytes),
             media_type="application/zip",
             headers={
-                "Content-Disposition": f'attachment; filename="{filename}"'
+                "Content-Disposition": _safe_content_disposition("attachment", filename)
             }
         )
     except ValueError as e:
@@ -575,25 +613,18 @@ async def generate_speech(
         if not profile:
             raise HTTPException(status_code=404, detail="Profile not found")
         
-        # Create voice prompt from profile
-        voice_prompt = await profiles.create_voice_prompt_for_profile(
-            data.profile_id,
-            db,
-        )
-        
         # Generate audio
-        tts_model = await tts.get_tts_model_async()
-        # Load the requested model size if different from current (async to not block)
+        from .backends import get_tts_backend_for_engine
+
+        engine = data.engine or "qwen"
+        tts_model = get_tts_backend_for_engine(engine)
+
+        # Resolve model size (only relevant for Qwen engine)
         model_size = data.model_size or "1.7B"
 
         # Check if model needs to be downloaded first
-        model_path = tts_model._get_model_path(model_size)
-        if model_path.startswith("Qwen/"):
-            # Model not cached - check if it exists remotely or needs download
-            from huggingface_hub import constants as hf_constants
-            repo_cache = Path(hf_constants.HF_HUB_CACHE) / ("models--" + model_path.replace("/", "--"))
-            if not repo_cache.exists():
-                # Start download in background
+        if engine == "qwen":
+            if not tts_model._is_model_cached(model_size):
                 model_name = f"qwen-tts-{model_size}"
 
                 async def download_model_background():
@@ -603,19 +634,51 @@ async def generate_speech(
                         task_manager.error_download(model_name, str(e))
 
                 task_manager.start_download(model_name)
-                asyncio.create_task(download_model_background())
+                _create_background_task(download_model_background())
 
-                # Return 202 Accepted with download info
                 raise HTTPException(
                     status_code=202,
                     detail={
                         "message": f"Model {model_size} is being downloaded. Please wait and try again.",
                         "model_name": model_name,
-                        "downloading": True
-                    }
+                        "downloading": True,
+                    },
                 )
 
-        await tts_model.load_model_async(model_size)
+            # Load (or switch to) the requested model
+            await tts_model.load_model_async(model_size)
+        elif engine == "luxtts":
+            if not tts_model._is_model_cached():
+                model_name = "luxtts"
+
+                async def download_luxtts_background():
+                    try:
+                        await tts_model.load_model()
+                    except Exception as e:
+                        task_manager.error_download(model_name, str(e))
+
+                task_manager.start_download(model_name)
+                _create_background_task(download_luxtts_background())
+
+                raise HTTPException(
+                    status_code=202,
+                    detail={
+                        "message": "LuxTTS model is being downloaded. Please wait and try again.",
+                        "model_name": model_name,
+                        "downloading": True,
+                    },
+                )
+
+            await tts_model.load_model()
+
+        # Create voice prompt from profile
+        voice_prompt = await profiles.create_voice_prompt_for_profile(
+            data.profile_id,
+            db,
+            use_cache=True,
+            engine=engine,
+        )
+
         audio, sample_rate = await tts_model.generate(
             data.text,
             voice_prompt,
@@ -658,6 +721,70 @@ async def generate_speech(
         raise HTTPException(status_code=500, detail=str(e))
 
 
+@app.post("/generate/stream")
+async def stream_speech(
+    data: models.GenerationRequest,
+    db: Session = Depends(get_db),
+):
+    """
+    Generate speech and stream the WAV audio directly without saving to disk.
+
+    Returns raw WAV bytes via a StreamingResponse so the client can start
+    playing audio before the entire file has been received.  This endpoint
+    does NOT create a history entry — use /generate for that.
+    """
+    from .backends import get_tts_backend_for_engine
+
+    profile = await profiles.get_profile(data.profile_id, db)
+    if not profile:
+        raise HTTPException(status_code=404, detail="Profile not found")
+
+    engine = data.engine or "qwen"
+    tts_model = get_tts_backend_for_engine(engine)
+    model_size = data.model_size or "1.7B"
+
+    if engine == "qwen":
+        if not tts_model._is_model_cached(model_size):
+            raise HTTPException(
+                status_code=400,
+                detail=f"Model {model_size} is not downloaded yet. Use /generate to trigger a download.",
+            )
+        await tts_model.load_model_async(model_size)
+    elif engine == "luxtts":
+        if not tts_model._is_model_cached():
+            raise HTTPException(
+                status_code=400,
+                detail="LuxTTS model is not downloaded yet. Use /generate to trigger a download.",
+            )
+        await tts_model.load_model()
+
+    voice_prompt = await profiles.create_voice_prompt_for_profile(
+        data.profile_id, db, engine=engine,
+    )
+
+    audio, sample_rate = await tts_model.generate(
+        data.text,
+        voice_prompt,
+        data.language,
+        data.seed,
+        data.instruct,
+    )
+
+    wav_bytes = tts.audio_to_wav_bytes(audio, sample_rate)
+
+    async def _wav_stream():
+        # Yield in chunks so large responses don't block the event loop
+        chunk_size = 64 * 1024  # 64 KB
+        for i in range(0, len(wav_bytes), chunk_size):
+            yield wav_bytes[i : i + chunk_size]
+
+    return StreamingResponse(
+        _wav_stream(),
+        media_type="audio/wav",
+        headers={"Content-Disposition": 'attachment; filename="speech.wav"'},
+    )
+
+
 # ============================================
 # HISTORY ENDPOINTS
 # ============================================
@@ -786,7 +913,7 @@ async def export_generation(
             io.BytesIO(zip_bytes),
             media_type="application/zip",
             headers={
-                "Content-Disposition": f'attachment; filename="{filename}"'
+                "Content-Disposition": _safe_content_disposition("attachment", filename)
             }
         )
     except ValueError as e:
@@ -819,7 +946,7 @@ async def export_generation_audio(
         audio_path,
         media_type="audio/wav",
         headers={
-            "Content-Disposition": f'attachment; filename="{filename}"'
+            "Content-Disposition": _safe_content_disposition("attachment", filename)
         }
     )
 
@@ -851,7 +978,11 @@ async def transcribe_audio(
 
         # Check if Whisper model is downloaded (uses default size "base")
         model_size = whisper_model.model_size
-        model_name = f"openai/whisper-{model_size}"
+        # Map model sizes to HF repo IDs (whisper-large needs -v3 suffix)
+        whisper_hf_repos = {
+            "large": "openai/whisper-large-v3",
+        }
+        model_name = whisper_hf_repos.get(model_size, f"openai/whisper-{model_size}")
 
         # Check if model is cached
         from huggingface_hub import constants as hf_constants
@@ -867,7 +998,7 @@ async def transcribe_audio(
                     get_task_manager().error_download(progress_model_name, str(e))
 
             get_task_manager().start_download(progress_model_name)
-            asyncio.create_task(download_whisper_background())
+            _create_background_task(download_whisper_background())
 
             # Return 202 Accepted
             raise HTTPException(
@@ -1087,7 +1218,7 @@ async def export_story_audio(
             io.BytesIO(audio_bytes),
             media_type="audio/wav",
             headers={
-                "Content-Disposition": f'attachment; filename="{filename}"'
+                "Content-Disposition": _safe_content_disposition("attachment", filename)
             }
         )
     except HTTPException:
@@ -1146,8 +1277,8 @@ async def get_sample_audio(sample_id: str, db: Session = Depends(get_db)):
 async def load_model(model_size: str = "1.7B"):
     """Manually load TTS model."""
     try:
-        tts_model = await tts.get_tts_model_async()
-        await tts_model.load_model(model_size)
+        tts_model = tts.get_tts_model()
+        await tts_model.load_model_async(model_size)
         return {"message": f"Model {model_size} loaded successfully"}
     except Exception as e:
         raise HTTPException(status_code=500, detail=str(e))
@@ -1205,10 +1336,10 @@ async def get_model_status():
     except ImportError:
         use_scan_cache = False
     
-    async def check_tts_loaded(model_size: str):
+    def check_tts_loaded(model_size: str):
         """Check if TTS model is loaded with specific size."""
         try:
-            tts_model = await tts.get_tts_model_async()
+            tts_model = tts.get_tts_model()
             return tts_model.is_loaded() and getattr(tts_model, 'model_size', None) == model_size
         except Exception:
             return False
@@ -1229,29 +1360,45 @@ async def get_model_status():
         whisper_base_id = "openai/whisper-base"
         whisper_small_id = "openai/whisper-small"
         whisper_medium_id = "openai/whisper-medium"
-        whisper_large_id = "openai/whisper-large"
+        whisper_large_id = "openai/whisper-large-v3"
     else:
         tts_1_7b_id = "Qwen/Qwen3-TTS-12Hz-1.7B-Base"
         tts_0_6b_id = "Qwen/Qwen3-TTS-12Hz-0.6B-Base"
         whisper_base_id = "openai/whisper-base"
         whisper_small_id = "openai/whisper-small"
         whisper_medium_id = "openai/whisper-medium"
-        whisper_large_id = "openai/whisper-large"
+        whisper_large_id = "openai/whisper-large-v3"
     
+    # Check if LuxTTS backend is loaded
+    def check_luxtts_loaded():
+        try:
+            from .backends import get_tts_backend_for_engine
+            backend = get_tts_backend_for_engine("luxtts")
+            return backend.is_loaded()
+        except Exception:
+            return False
+
     model_configs = [
         {
             "model_name": "qwen-tts-1.7B",
             "display_name": "Qwen TTS 1.7B",
             "hf_repo_id": tts_1_7b_id,
             "model_size": "1.7B",
-            "check_loaded": lambda: check_tts_loaded("1.7B"),  # Async function
+            "check_loaded": lambda: check_tts_loaded("1.7B"),
         },
         {
             "model_name": "qwen-tts-0.6B",
             "display_name": "Qwen TTS 0.6B",
             "hf_repo_id": tts_0_6b_id,
             "model_size": "0.6B",
-            "check_loaded": lambda: check_tts_loaded("0.6B"),  # Async function
+            "check_loaded": lambda: check_tts_loaded("0.6B"),
+        },
+        {
+            "model_name": "luxtts",
+            "display_name": "LuxTTS (Fast, CPU-friendly)",
+            "hf_repo_id": "YatharthS/LuxTTS",
+            "model_size": "default",
+            "check_loaded": check_luxtts_loaded,
         },
         {
             "model_name": "whisper-base",
@@ -1389,16 +1536,7 @@ async def get_model_status():
             
             # Check if loaded in memory
             try:
-                check_func = config["check_loaded"]
-                if asyncio.iscoroutinefunction(check_func):
-                    loaded = await check_func()
-                else:
-                    result = check_func()
-                    # Handle lambdas that return coroutines
-                    if asyncio.iscoroutine(result):
-                        loaded = await result
-                    else:
-                        loaded = result
+                loaded = config["check_loaded"]()
             except Exception:
                 loaded = False
             
@@ -1421,16 +1559,7 @@ async def get_model_status():
         except Exception as e:
             # If check fails, try to at least check if loaded
             try:
-                check_func = config["check_loaded"]
-                if asyncio.iscoroutinefunction(check_func):
-                    loaded = await check_func()
-                else:
-                    result = check_func()
-                    # Handle lambdas that return coroutines
-                    if asyncio.iscoroutine(result):
-                        loaded = await result
-                    else:
-                        loaded = result
+                loaded = config["check_loaded"]()
             except Exception:
                 loaded = False
             
@@ -1453,28 +1582,23 @@ async def get_model_status():
 async def trigger_model_download(request: models.ModelDownloadRequest):
     """Trigger download of a specific model."""
     import asyncio
+    from .backends import get_tts_backend_for_engine
     
     task_manager = get_task_manager()
     progress_manager = get_progress_manager()
     
-    async def load_tts_model_1_7b():
-        """Load 1.7B TTS model."""
-        tts_model = await tts.get_tts_model_async()
-        await tts_model.load_model("1.7B")
-    
-    async def load_tts_model_0_6b():
-        """Load 0.6B TTS model."""
-        tts_model = await tts.get_tts_model_async()
-        await tts_model.load_model("0.6B")
-    
     model_configs = {
         "qwen-tts-1.7B": {
             "model_size": "1.7B",
-            "load_func": load_tts_model_1_7b,
+            "load_func": lambda: tts.get_tts_model().load_model("1.7B"),
         },
         "qwen-tts-0.6B": {
             "model_size": "0.6B",
-            "load_func": load_tts_model_0_6b,
+            "load_func": lambda: tts.get_tts_model().load_model("0.6B"),
+        },
+        "luxtts": {
+            "model_size": "default",
+            "load_func": lambda: get_tts_backend_for_engine("luxtts").load_model(),
         },
         "whisper-base": {
             "model_size": "base",
@@ -1527,175 +1651,46 @@ async def trigger_model_download(request: models.ModelDownloadRequest):
     )
 
     # Start download in background task (don't await)
-    asyncio.create_task(download_in_background())
+    _create_background_task(download_in_background())
 
     # Return immediately - frontend should poll progress endpoint
     return {"message": f"Model {request.model_name} download started"}
 
 
-# ============================================
-# PROVIDER ENDPOINTS
-# ============================================
-
-@app.get("/providers")
-async def list_providers():
-    """List all available provider types."""
-    manager = get_provider_manager()
-    installed = await manager.list_installed()
-    
-    # Get info for all known provider types
-    all_providers = [
-        "apple-mlx",
-        "bundled-pytorch",
-        "pytorch-cpu",
-        "pytorch-cuda",
-        "remote",
-        "openai",
-    ]
-    
-    providers_info = []
-    for provider_type in all_providers:
-        info = await manager.get_provider_info(provider_type)
-        providers_info.append(info)
-    
-    return {
-        "providers": providers_info,
-        "installed": installed,
-    }
-
-
-@app.get("/providers/installed")
-async def list_installed_providers():
-    """List installed provider types."""
-    manager = get_provider_manager()
-    installed = await manager.list_installed()
-    return {"installed": installed}
-
-
-@app.get("/providers/active")
-async def get_active_provider():
-    """Get information about the currently active provider."""
-    manager = get_provider_manager()
-    provider = await manager.get_active_provider()
-    
-    health = await provider.health()
-    status = await provider.status()
-    
-    return {
-        "provider": health["provider"],
-        "health": health,
-        "status": status,
-    }
-
-
-@app.post("/providers/start")
-async def start_provider(data: dict):
-    """Start a specific provider."""
-    provider_type = data.get("provider_type")
-    if not provider_type:
-        raise HTTPException(status_code=400, detail="provider_type is required")
-    
-    manager = get_provider_manager()
-    try:
-        await manager.start_provider(provider_type)
-        provider = await manager.get_active_provider()
-        health = await provider.health()
-        return {
-            "message": f"Provider {provider_type} started",
-            "provider": health,
-        }
-    except NotImplementedError as e:
-        raise HTTPException(status_code=501, detail=str(e))
-    except ValueError as e:
-        raise HTTPException(status_code=400, detail=str(e))
-    except Exception as e:
-        raise HTTPException(status_code=500, detail=str(e))
-
-
-@app.post("/providers/stop")
-async def stop_provider():
-    """Stop the currently active provider."""
-    manager = get_provider_manager()
-    await manager.stop_provider()
-    return {"message": "Provider stopped"}
-
-
-@app.post("/providers/download")
-async def download_provider_endpoint(data: dict):
-    """Download a provider binary."""
-    from .providers.installer import download_provider
-    
-    provider_type = data.get("provider_type")
-    if not provider_type:
-        raise HTTPException(status_code=400, detail="provider_type is required")
-    
-    if provider_type not in ["pytorch-cpu", "pytorch-cuda"]:
-        raise HTTPException(
-            status_code=400,
-            detail=f"Provider type {provider_type} cannot be downloaded"
-        )
-    
-    try:
-        # Start download in background
-        asyncio.create_task(download_provider(provider_type))
-        return {
-            "message": f"Provider {provider_type} download started",
-            "provider_type": provider_type,
-        }
-    except Exception as e:
-        raise HTTPException(status_code=500, detail=str(e))
-
-
-@app.get("/providers/download/progress/{provider_type}")
-async def get_provider_download_progress(provider_type: str):
-    """Get provider download progress via Server-Sent Events."""
-    from fastapi.responses import StreamingResponse
-    from .utils.progress import get_progress_manager
-    
+@app.post("/models/download/cancel")
+async def cancel_model_download(request: models.ModelDownloadRequest):
+    """Cancel or dismiss an errored/stale download task."""
+    task_manager = get_task_manager()
     progress_manager = get_progress_manager()
-    
-    async def event_generator():
-        """Generate SSE events for provider download progress."""
-        import asyncio
-        import json
-        
-        last_progress = None
-        
-        while True:
-            progress = progress_manager.get_progress(provider_type)
-            
-            if progress and progress != last_progress:
-                yield f"data: {json.dumps(progress)}\n\n"
-                last_progress = progress
-                
-                if progress.get("status") in ["complete", "error"]:
-                    break
-            
-            await asyncio.sleep(0.5)
-    
-    return StreamingResponse(event_generator(), media_type="text/event-stream")
+
+    removed = task_manager.cancel_download(request.model_name)
+
+    # Also clear progress state so the model doesn't show as downloading
+    progress_removed = False
+    with progress_manager._lock:
+        if request.model_name in progress_manager._progress:
+            del progress_manager._progress[request.model_name]
+            progress_removed = True
+
+    if removed or progress_removed:
+        return {"message": f"Download task for {request.model_name} cancelled"}
+    return {"message": f"No active task found for {request.model_name}"}
 
 
-@app.delete("/providers/{provider_type}")
-async def delete_provider_endpoint(provider_type: str):
-    """Delete an installed provider."""
-    from .providers.installer import delete_provider
-    
-    if provider_type not in ["pytorch-cpu", "pytorch-cuda"]:
-        raise HTTPException(
-            status_code=400,
-            detail=f"Provider type {provider_type} cannot be deleted"
-        )
-    
-    deleted = delete_provider(provider_type)
-    
-    if deleted:
-        return {"message": f"Provider {provider_type} deleted successfully"}
-    else:
-        raise HTTPException(
-            status_code=404,
-            detail=f"Provider {provider_type} not found"
-        )
+@app.post("/tasks/clear")
+async def clear_all_tasks():
+    """Clear all download tasks and progress state. Does not delete downloaded files."""
+    task_manager = get_task_manager()
+    progress_manager = get_progress_manager()
+
+    task_manager.clear_all()
+
+    with progress_manager._lock:
+        progress_manager._progress.clear()
+        progress_manager._last_notify_time.clear()
+        progress_manager._last_notify_progress.clear()
+
+    return {"message": "All task state cleared"}
 
 
 @app.delete("/models/{model_name}")
@@ -1717,6 +1712,11 @@ async def delete_model(model_name: str):
             "model_size": "0.6B",
             "model_type": "tts",
         },
+        "luxtts": {
+            "hf_repo_id": "YatharthS/LuxTTS",
+            "model_size": "default",
+            "model_type": "luxtts",
+        },
         "whisper-base": {
             "hf_repo_id": "openai/whisper-base",
             "model_size": "base",
@@ -1733,12 +1733,12 @@ async def delete_model(model_name: str):
             "model_type": "whisper",
         },
         "whisper-large": {
-            "hf_repo_id": "openai/whisper-large",
+            "hf_repo_id": "openai/whisper-large-v3",
             "model_size": "large",
             "model_type": "whisper",
         },
     }
-    
+
     if model_name not in model_configs:
         raise HTTPException(status_code=400, detail=f"Unknown model: {model_name}")
     
@@ -1748,9 +1748,14 @@ async def delete_model(model_name: str):
     try:
         # Check if model is loaded and unload it first
         if config["model_type"] == "tts":
-            tts_model = await tts.get_tts_model_async()
-            if tts_model.is_loaded() and getattr(tts_model, 'model_size', None) == config["model_size"]:
-                tts_model.unload_model()
+            tts_model = tts.get_tts_model()
+            if tts_model.is_loaded() and tts_model.model_size == config["model_size"]:
+                tts.unload_tts_model()
+        elif config["model_type"] == "luxtts":
+            from .backends import get_tts_backend_for_engine
+            luxtts = get_tts_backend_for_engine("luxtts")
+            if luxtts.is_loaded():
+                luxtts.unload_model()
         elif config["model_type"] == "whisper":
             whisper_model = transcribe.get_whisper_model()
             if whisper_model.is_loaded() and whisper_model.model_size == config["model_size"]:
@@ -1822,10 +1827,18 @@ async def get_active_tasks():
         progress = progress_map.get(model_name)
         
         if task:
+            # Prefer task error, fall back to progress manager error
+            error = task.error
+            if not error:
+                with progress_manager._lock:
+                    pm_data = progress_manager._progress.get(model_name)
+                    if pm_data:
+                        error = pm_data.get("error")
             active_downloads.append(models.ActiveDownloadTask(
                 model_name=model_name,
                 status=task.status,
                 started_at=task.started_at,
+                error=error,
             ))
         elif progress:
             # Progress exists but no task - create from progress data
@@ -1842,6 +1855,7 @@ async def get_active_tasks():
                 model_name=model_name,
                 status=progress.get("status", "downloading"),
                 started_at=started_at,
+                error=progress.get("error"),
             ))
     
     # Get active generations
@@ -1861,13 +1875,72 @@ async def get_active_tasks():
 
 
 # ============================================
-# WEB UI STATIC FILES
+# CUDA BACKEND MANAGEMENT
 # ============================================
 
-# Serve web UI at root if dist directory exists
-_web_dist_path = Path(__file__).parent.parent / "web" / "dist"
-if _web_dist_path.exists():
-    app.mount("/", StaticFiles(directory=str(_web_dist_path), html=True), name="web")
+@app.get("/backend/cuda-status")
+async def get_cuda_status():
+    """Get CUDA backend download/availability status."""
+    from . import cuda_download
+    return cuda_download.get_cuda_status()
+
+
+@app.post("/backend/download-cuda")
+async def download_cuda_backend():
+    """Download the CUDA backend binary. Returns immediately; track progress via SSE."""
+    from . import cuda_download
+
+    # Check if already downloaded
+    if cuda_download.get_cuda_binary_path() is not None:
+        raise HTTPException(status_code=409, detail="CUDA backend already downloaded")
+
+    async def _download():
+        try:
+            await cuda_download.download_cuda_binary()
+        except Exception as e:
+            import logging
+            logging.getLogger(__name__).error(f"CUDA download failed: {e}")
+
+    _create_background_task(_download())
+    return {"message": "CUDA backend download started", "progress_key": "cuda-backend"}
+
+
+@app.delete("/backend/cuda")
+async def delete_cuda_backend():
+    """Delete the downloaded CUDA backend binary."""
+    from . import cuda_download
+
+    if cuda_download.is_cuda_active():
+        raise HTTPException(
+            status_code=409,
+            detail="Cannot delete CUDA backend while it is active. Switch to CPU first.",
+        )
+
+    deleted = await cuda_download.delete_cuda_binary()
+    if not deleted:
+        raise HTTPException(status_code=404, detail="No CUDA backend found to delete")
+
+    return {"message": "CUDA backend deleted"}
+
+
+@app.get("/backend/cuda-progress")
+async def get_cuda_download_progress():
+    """Get CUDA backend download progress via Server-Sent Events."""
+    progress_manager = get_progress_manager()
+
+    async def event_generator():
+        async for event in progress_manager.subscribe("cuda-backend"):
+            yield event
+
+    return StreamingResponse(
+        event_generator(),
+        media_type="text/event-stream",
+        headers={
+            "Cache-Control": "no-cache",
+            "Connection": "keep-alive",
+            "X-Accel-Buffering": "no",
+        },
+    )
 
 
 # ============================================
@@ -1877,12 +1950,11 @@ if _web_dist_path.exists():
 def _get_gpu_status() -> str:
     """Get GPU availability status."""
     backend_type = get_backend_type()
-    if TORCH_AVAILABLE and torch is not None:
-        if torch.cuda.is_available():
-            return f"CUDA ({torch.cuda.get_device_name(0)})"
-        elif hasattr(torch.backends, 'mps') and torch.backends.mps.is_available():
-            return "MPS (Apple Silicon)"
-    if backend_type == "mlx":
+    if torch.cuda.is_available():
+        return f"CUDA ({torch.cuda.get_device_name(0)})"
+    elif hasattr(torch.backends, 'mps') and torch.backends.mps.is_available():
+        return "MPS (Apple Silicon)"
+    elif backend_type == "mlx":
         return "Metal (Apple Silicon via MLX)"
     return "None (CPU only)"
 
@@ -1921,14 +1993,8 @@ async def shutdown_event():
     """Run on application shutdown."""
     print("voicebox API shutting down...")
     # Unload models to free memory
-    try:
-        tts.unload_tts_model()
-    except Exception as e:
-        print(f"Warning: Failed to unload TTS model: {e}")
-    try:
-        transcribe.unload_whisper_model()
-    except Exception as e:
-        print(f"Warning: Failed to unload Whisper model: {e}")
+    tts.unload_tts_model()
+    transcribe.unload_whisper_model()
 
 
 # ============================================

backend/models.py

@@ -57,6 +57,7 @@ class GenerationRequest(BaseModel):
     seed: Optional[int] = Field(None, ge=0)
     model_size: Optional[str] = Field(default="1.7B", pattern="^(1\\.7B|0\\.6B)$")
     instruct: Optional[str] = Field(None, max_length=500)
+    engine: Optional[str] = Field(default="qwen", pattern="^(qwen|luxtts)$")
 
 
 class GenerationResponse(BaseModel):
@@ -127,6 +128,7 @@ class HealthResponse(BaseModel):
     gpu_type: Optional[str] = None  # GPU type (CUDA, MPS, or None)
     vram_used_mb: Optional[float] = None
     backend_type: Optional[str] = None  # Backend type (mlx or pytorch)
+    backend_variant: Optional[str] = None  # Binary variant (cpu or cuda)
 
 
 class ModelStatus(BaseModel):
@@ -154,6 +156,7 @@ class ActiveDownloadTask(BaseModel):
     model_name: str
     status: str
     started_at: datetime
+    error: Optional[str] = None
 
 
 class ActiveGenerationTask(BaseModel):
@@ -170,13 +173,6 @@ class ActiveTasksResponse(BaseModel):
     generations: List[ActiveGenerationTask]
 
 
-class FolderPathsResponse(BaseModel):
-    """Response model for system folder paths."""
-    data_dir: str
-    models_dir: str
-    providers_dir: str
-
-
 class AudioChannelCreate(BaseModel):
     """Request model for creating an audio channel."""
     name: str = Field(..., min_length=1, max_length=100)

backend/platform_detect.py

@@ -19,15 +19,17 @@ def is_apple_silicon() -> bool:
 def get_backend_type() -> Literal["mlx", "pytorch"]:
     """
     Detect the best backend for the current platform.
-    
+
     Returns:
-        "mlx" on Apple Silicon (if MLX is available), "pytorch" otherwise
+        "mlx" on Apple Silicon (if MLX is available and functional), "pytorch" otherwise
     """
     if is_apple_silicon():
         try:
-            import mlx
+            import mlx.core  # noqa: F401 — triggers native lib loading
             return "mlx"
-        except ImportError:
-            # MLX not installed, fallback to PyTorch
+        except (ImportError, OSError, RuntimeError):
+            # MLX not installed, or native libraries failed to load inside a
+            # PyInstaller bundle (OSError on missing .dylib / .metallib).
+            # Fall through to PyTorch.
             return "pytorch"
     return "pytorch"

backend/profiles.py

@@ -327,6 +327,7 @@ async def create_voice_prompt_for_profile(
     profile_id: str,
     db: Session,
     use_cache: bool = True,
+    engine: str = "qwen",
 ) -> dict:
     """
     Create a combined voice prompt from all samples in a profile.
@@ -335,17 +336,20 @@ async def create_voice_prompt_for_profile(
         profile_id: Profile ID
         db: Database session
         use_cache: Whether to use cached prompts
+        engine: TTS engine to create prompt for ("qwen" or "luxtts")
 
     Returns:
         Voice prompt dictionary
     """
+    from .backends import get_tts_backend_for_engine
+
     # Get all samples for profile
     samples = db.query(DBProfileSample).filter_by(profile_id=profile_id).all()
 
     if not samples:
         raise ValueError(f"No samples found for profile {profile_id}")
 
-    tts_model = get_tts_model()
+    tts_model = get_tts_backend_for_engine(engine)
 
     if len(samples) == 1:
         # Single sample - use directly

backend/providers/__init__.py

@@ -1,327 +0,0 @@
-"""
-Provider management system for TTS providers.
-"""
-
-from typing import Optional
-import asyncio
-import platform
-from pathlib import Path
-
-from .base import TTSProvider
-from .types import ProviderType
-from .bundled import BundledProvider
-from .local import LocalProvider
-from .installer import get_provider_binary_path, _get_providers_dir
-from ..config import get_data_dir
-import subprocess
-import socket
-
-
-class ProviderManager:
-    """Manages TTS provider lifecycle."""
-    
-    def __init__(self):
-        self.active_provider: Optional[TTSProvider] = None
-        self._default_provider: Optional[TTSProvider] = None
-        self._provider_process: Optional[subprocess.Popen] = None
-        self._provider_port: Optional[int] = None
-    
-    def _get_default_provider(self) -> TTSProvider:
-        """Get the default bundled provider."""
-        if self._default_provider is None:
-            self._default_provider = BundledProvider()
-        return self._default_provider
-    
-    async def get_active_provider(self) -> TTSProvider:
-        """
-        Get the currently active provider.
-        
-        Returns:
-            Active TTS provider instance
-        """
-        if self.active_provider is None:
-            # Default to bundled provider
-            self.active_provider = self._get_default_provider()
-        return self.active_provider
-    
-    async def start_provider(self, provider_type: str) -> None:
-        """
-        Start a TTS provider.
-        
-        Args:
-            provider_type: Type of provider to start
-        """
-        if provider_type == "apple-mlx":
-            # Use bundled MLX provider
-            self.active_provider = self._get_default_provider()
-        elif provider_type in ["pytorch-cpu", "pytorch-cuda"]:
-            # Try to start external provider subprocess if binary exists
-            provider_path = get_provider_binary_path(provider_type)
-            if provider_path and provider_path.exists():
-                # External downloaded provider exists, start it
-                # Find a free port
-                port = self._get_free_port()
-
-                # Start provider subprocess with stdout/stderr capture
-                from ..config import get_data_dir
-                import logging
-                logger = logging.getLogger(__name__)
-
-                logger.info(f"Starting provider {provider_type} on port {port}")
-                logger.info(f"Provider binary: {provider_path}")
-                logger.info(f"Data directory: {get_data_dir()}")
-
-                # Create log files for provider output (easier debugging on Windows)
-                logs_dir = get_data_dir() / "logs"
-                logs_dir.mkdir(exist_ok=True)
-                stdout_log = logs_dir / f"{provider_type}-stdout.log"
-                stderr_log = logs_dir / f"{provider_type}-stderr.log"
-
-                logger.info(f"Provider logs will be written to: {logs_dir}")
-
-                process = subprocess.Popen(
-                    [
-                        str(provider_path),
-                        "--port", str(port),
-                        "--data-dir", str(get_data_dir()),
-                    ],
-                    stdout=open(stdout_log, 'w'),
-                    stderr=open(stderr_log, 'w'),
-                    text=True,
-                    bufsize=1,
-                )
-
-                # Wait for provider to be ready
-                base_url = f"http://127.0.0.1:{port}"
-                try:
-                    await self._wait_for_provider_health(base_url, timeout=30)
-                except TimeoutError as e:
-                    # Read log files for debugging (works on all platforms unlike select)
-                    stdout_content = ""
-                    stderr_content = ""
-
-                    # Try to read available output (works on Windows and Unix)
-                    try:
-                        # Use non-blocking read with timeout
-                        import threading
-                        import queue
-
-                        def enqueue_output(stream, queue):
-                            try:
-                                for line in iter(stream.readline, ''):
-                                    queue.put(line)
-                            except:
-                                pass
-
-                        stdout_queue = queue.Queue()
-                        stderr_queue = queue.Queue()
-
-                        if process.stdout:
-                            t = threading.Thread(target=enqueue_output, args=(process.stdout, stdout_queue))
-                            t.daemon = True
-                            t.start()
-
-                        if process.stderr:
-                            t2 = threading.Thread(target=enqueue_output, args=(process.stderr, stderr_queue))
-                            t2.daemon = True
-                            t2.start()
-
-                        # Give threads a moment to read
-                        import time
-                        time.sleep(0.5)
-
-                        # Collect output
-                        while not stdout_queue.empty():
-                            stdout_lines.append(stdout_queue.get_nowait())
-                        while not stderr_queue.empty():
-                            stderr_lines.append(stderr_queue.get_nowait())
-                    except Exception as ex:
-                        logger.warning(f"Could not capture subprocess output: {ex}")
-
-                    logger.error(f"Provider failed to start within 30 seconds")
-                    logger.error(f"Check logs at: {logs_dir}")
-                    if stdout_content:
-                        logger.error(f"Stdout: {stdout_content[-2000:]}")  # Last 2000 chars
-                    if stderr_content:
-                        logger.error(f"Stderr: {stderr_content[-2000:]}")  # Last 2000 chars
-
-                    # Terminate the process
-                    process.terminate()
-                    try:
-                        process.wait(timeout=5)
-                    except subprocess.TimeoutExpired:
-                        process.kill()
-
-                    # Raise with log file location for user
-                    raise TimeoutError(
-                        f"Provider {provider_type} failed to start. Check logs at: {logs_dir}"
-                    )
-
-                # Create LocalProvider instance
-                self.active_provider = LocalProvider(base_url)
-                self._provider_process = process
-                self._provider_port = port
-
-                # Logs are written directly to files (stdout_log, stderr_log)
-                # No need for background task - users can check {logs_dir} for debugging
-            else:
-                # No external binary, use bundled provider (if available)
-                if provider_type == "pytorch-cpu":
-                    # PyTorch CPU can use bundled backend
-                    self.active_provider = self._get_default_provider()
-                else:
-                    raise ValueError(f"Provider {provider_type} is not installed. Please download it first.")
-        elif provider_type == "remote":
-            # Remote provider - will be implemented in Phase 5
-            raise NotImplementedError("Remote provider not yet implemented")
-        elif provider_type == "openai":
-            # OpenAI provider - will be implemented in Phase 5
-            raise NotImplementedError("OpenAI provider not yet implemented")
-        else:
-            raise ValueError(f"Unknown provider type: {provider_type}")
-    
-    async def stop_provider(self) -> None:
-        """Stop the active provider."""
-        if self.active_provider:
-            # Only stop if it's not the default bundled provider
-            if self.active_provider is not self._default_provider:
-                if hasattr(self.active_provider, 'stop'):
-                    await self.active_provider.stop()
-                self.active_provider = None
-            
-            # Stop subprocess if running
-            if self._provider_process:
-                self._provider_process.terminate()
-                try:
-                    self._provider_process.wait(timeout=5)
-                except subprocess.TimeoutExpired:
-                    self._provider_process.kill()
-                self._provider_process = None
-                self._provider_port = None
-    
-    async def list_installed(self) -> list[str]:
-        """
-        List installed provider types.
-        
-        Returns:
-            List of installed provider type strings
-        """
-        installed = []
-        
-        # Bundled providers are always available
-        system = platform.system()
-        machine = platform.machine()
-
-        if system == "Darwin" and machine == "arm64":
-            # Apple Silicon gets MLX bundled
-            installed.append("apple-mlx")
-        elif system == "Windows" or (system == "Darwin" and machine != "arm64"):
-            # Windows and Intel macOS get PyTorch CPU bundled
-            installed.append("pytorch-cpu")
-        # Linux: no bundled provider - users must download
-        
-        # Check for downloaded providers by checking if binary path exists
-        for provider_type in ["pytorch-cpu", "pytorch-cuda"]:
-            binary_path = get_provider_binary_path(provider_type)
-            if binary_path and binary_path.exists() and provider_type not in installed:
-                installed.append(provider_type)
-        
-        return installed
-    
-    async def get_provider_info(self, provider_type: str) -> dict:
-        """
-        Get information about a provider.
-        
-        Args:
-            provider_type: Type of provider
-            
-        Returns:
-            Provider information dictionary
-        """
-        if provider_type in ["apple-mlx", "bundled-pytorch"]:
-            return {
-                "type": provider_type,
-                "name": "Bundled Provider",
-                "installed": True,
-                "size_mb": None,  # Bundled, no separate size
-            }
-        elif provider_type == "pytorch-cpu":
-            return {
-                "type": provider_type,
-                "name": "PyTorch CPU",
-                "installed": provider_type in await self.list_installed(),
-                "size_mb": 300,
-            }
-        elif provider_type == "pytorch-cuda":
-            return {
-                "type": provider_type,
-                "name": "PyTorch CUDA",
-                "installed": provider_type in await self.list_installed(),
-                "size_mb": 2400,
-            }
-        else:
-            return {
-                "type": provider_type,
-                "name": provider_type,
-                "installed": False,
-                "size_mb": None,
-            }
-
-
-    def _get_free_port(self) -> int:
-        """Get a free port for the provider server."""
-        with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
-            s.bind(('', 0))
-            return s.getsockname()[1]
-    
-    async def _wait_for_provider_health(self, base_url: str, timeout: int = 30) -> None:
-        """Wait for provider to become healthy."""
-        import httpx
-        import asyncio
-
-        start_time = asyncio.get_event_loop().time()
-        while True:
-            try:
-                async with httpx.AsyncClient(timeout=2.0) as client:
-                    response = await client.get(f"{base_url}/tts/health")
-                    if response.status_code == 200:
-                        return
-            except Exception:
-                pass
-
-            if asyncio.get_event_loop().time() - start_time > timeout:
-                raise TimeoutError(f"Provider did not become healthy within {timeout} seconds")
-
-            await asyncio.sleep(0.5)
-
-    async def _log_subprocess_output(self, process: subprocess.Popen) -> None:
-        """Log subprocess stdout and stderr."""
-        import logging
-        logger = logging.getLogger(__name__)
-
-        async def read_stream(stream, prefix):
-            if stream:
-                loop = asyncio.get_event_loop()
-                while True:
-                    line = await loop.run_in_executor(None, stream.readline)
-                    if not line:
-                        break
-                    logger.info(f"{prefix}: {line.rstrip()}")
-
-        await asyncio.gather(
-            read_stream(process.stdout, "Provider stdout"),
-            read_stream(process.stderr, "Provider stderr"),
-            return_exceptions=True,
-        )
-
-
-# Global provider manager instance
-_provider_manager: Optional[ProviderManager] = None
-
-
-def get_provider_manager() -> ProviderManager:
-    """Get the global provider manager instance."""
-    global _provider_manager
-    if _provider_manager is None:
-        _provider_manager = ProviderManager()
-    return _provider_manager

backend/providers/base.py

@@ -1,97 +0,0 @@
-"""
-Base protocol for TTS providers.
-"""
-
-from typing import Protocol, Optional, Tuple
-from typing_extensions import runtime_checkable
-import numpy as np
-
-from .types import ProviderHealth, ProviderStatus
-
-
-@runtime_checkable
-class TTSProvider(Protocol):
-    """Protocol for TTS provider implementations."""
-    
-    async def generate(
-        self,
-        text: str,
-        voice_prompt: dict,
-        language: str = "en",
-        seed: Optional[int] = None,
-        instruct: Optional[str] = None,
-    ) -> Tuple[np.ndarray, int]:
-        """
-        Generate speech audio from text.
-        
-        Args:
-            text: Text to synthesize
-            voice_prompt: Voice prompt dictionary
-            language: Language code
-            seed: Random seed for reproducibility
-            instruct: Delivery instructions
-            
-        Returns:
-            Tuple of (audio_array, sample_rate)
-        """
-        ...
-    
-    async def create_voice_prompt(
-        self,
-        audio_path: str,
-        reference_text: str,
-        use_cache: bool = True,
-    ) -> Tuple[dict, bool]:
-        """
-        Create voice prompt from reference audio.
-        
-        Args:
-            audio_path: Path to reference audio file
-            reference_text: Transcript of the audio
-            use_cache: Whether to use cached prompts
-            
-        Returns:
-            Tuple of (voice_prompt_dict, was_cached)
-        """
-        ...
-    
-    async def combine_voice_prompts(
-        self,
-        audio_paths: list[str],
-        reference_texts: list[str],
-    ) -> Tuple[np.ndarray, str]:
-        """
-        Combine multiple voice prompts.
-        
-        Args:
-            audio_paths: List of audio file paths
-            reference_texts: List of reference texts
-            
-        Returns:
-            Tuple of (combined_audio_array, combined_text)
-        """
-        ...
-    
-    async def load_model_async(self, model_size: str) -> None:
-        """Load TTS model."""
-        ...
-    
-    def unload_model(self) -> None:
-        """Unload model to free memory."""
-        ...
-    
-    def is_loaded(self) -> bool:
-        """Check if model is loaded."""
-        ...
-    
-    def _get_model_path(self, model_size: str) -> str:
-        """Get model path for a given size."""
-        ...
-    
-    async def health(self) -> ProviderHealth:
-        """Get provider health status."""
-        ...
-    
-    async def status(self) -> ProviderStatus:
-        """Get provider model status."""
-        ...

backend/providers/bundled.py

@@ -1,144 +0,0 @@
-"""
-Bundled provider that wraps existing MLX/PyTorch backends.
-"""
-
-from typing import Optional, Tuple
-import numpy as np
-import platform
-
-from .base import TTSProvider
-from .types import ProviderHealth, ProviderStatus
-from ..backends import get_tts_backend, TTSBackend
-from ..platform_detect import get_backend_type
-
-
-class BundledProvider:
-    """Provider that wraps the existing bundled TTS backend."""
-    
-    def __init__(self):
-        self._backend: Optional[TTSBackend] = None
-    
-    def _get_backend(self) -> TTSBackend:
-        """Get or create backend instance."""
-        if self._backend is None:
-            self._backend = get_tts_backend()
-        return self._backend
-    
-    async def generate(
-        self,
-        text: str,
-        voice_prompt: dict,
-        language: str = "en",
-        seed: Optional[int] = None,
-        instruct: Optional[str] = None,
-    ) -> Tuple[np.ndarray, int]:
-        """Generate speech audio."""
-        backend = self._get_backend()
-        return await backend.generate(text, voice_prompt, language, seed, instruct)
-    
-    async def create_voice_prompt(
-        self,
-        audio_path: str,
-        reference_text: str,
-        use_cache: bool = True,
-    ) -> Tuple[dict, bool]:
-        """Create voice prompt from reference audio."""
-        backend = self._get_backend()
-        return await backend.create_voice_prompt(audio_path, reference_text, use_cache)
-    
-    async def combine_voice_prompts(
-        self,
-        audio_paths: list[str],
-        reference_texts: list[str],
-    ) -> Tuple[np.ndarray, str]:
-        """Combine multiple voice prompts."""
-        backend = self._get_backend()
-        return await backend.combine_voice_prompts(audio_paths, reference_texts)
-    
-    async def load_model_async(self, model_size: str) -> None:
-        """Load TTS model."""
-        backend = self._get_backend()
-        if hasattr(backend, 'load_model_async'):
-            await backend.load_model_async(model_size)
-        else:
-            await backend.load_model(model_size)
-
-    # Alias for compatibility
-    load_model = load_model_async
-    
-    def unload_model(self) -> None:
-        """Unload model to free memory."""
-        backend = self._get_backend()
-        backend.unload_model()
-    
-    def is_loaded(self) -> bool:
-        """Check if model is loaded."""
-        backend = self._get_backend()
-        return backend.is_loaded()
-    
-    def _get_model_path(self, model_size: str) -> str:
-        """Get model path for a given size."""
-        backend = self._get_backend()
-        return backend._get_model_path(model_size)
-    
-    async def health(self) -> ProviderHealth:
-        """Get provider health status."""
-        backend = self._get_backend()
-        backend_type = get_backend_type()
-
-        model_size = None
-        if backend.is_loaded():
-            # Try to get current model size from backend
-            if hasattr(backend, '_current_model_size') and backend._current_model_size:
-                model_size = backend._current_model_size
-
-        device = None
-        if backend_type == "mlx":
-            device = "metal"
-        elif hasattr(backend, 'device'):
-            device = backend.device
-
-        # Use apple-mlx for MLX backend, pytorch-cpu for PyTorch
-        provider_name = "apple-mlx" if backend_type == "mlx" else "pytorch-cpu"
-
-        return ProviderHealth(
-            status="healthy",
-            provider=provider_name,
-            version=None,  # Provider versioning not implemented yet
-            model=model_size,
-            device=device,
-        )
-    
-    async def status(self) -> ProviderStatus:
-        """Get provider model status."""
-        backend = self._get_backend()
-        backend_type = get_backend_type()
-        
-        model_size = None
-        if backend.is_loaded():
-            if hasattr(backend, '_current_model_size') and backend._current_model_size:
-                model_size = backend._current_model_size
-        
-        available_sizes = ["1.7B"]
-        if backend_type == "pytorch":
-            available_sizes.append("0.6B")
-        
-        gpu_available = None
-        vram_used_mb = None
-        
-        if backend_type == "pytorch":
-            try:
-                import torch
-                gpu_available = torch.cuda.is_available()
-                if gpu_available:
-                    vram_used_mb = torch.cuda.memory_allocated() / 1024 / 1024
-            except ImportError:
-                pass
-        
-        return ProviderStatus(
-            model_loaded=backend.is_loaded(),
-            model_size=model_size,
-            available_sizes=available_sizes,
-            gpu_available=gpu_available,
-            vram_used_mb=int(vram_used_mb) if vram_used_mb else None,
-        )

backend/providers/checksums.py

@@ -1,11 +0,0 @@
-# Provider checksums - embedded at build time for security
-# This file is auto-generated during CI builds
-# In development, checksums are empty (verification is skipped)
-
-PROVIDER_CHECKSUMS = {
-    # Populated during release builds with SHA256 checksums of provider binaries
-    # Example:
-    # "tts-provider-pytorch-cpu-windows.exe": "abc123...",
-    # "tts-provider-pytorch-cuda-windows.exe": "def456...",
-    # "tts-provider-pytorch-cuda-linux": "789xyz...",
-}

backend/providers/installer.py

@@ -1,262 +0,0 @@
-"""
-Provider download and installation manager.
-"""
-
-import asyncio
-import httpx
-import platform
-from pathlib import Path
-from typing import Optional
-
-from .types import ProviderType
-from ..utils.progress import get_progress_manager
-from ..utils.tasks import get_task_manager
-
-
-# Provider version (independent of app version)
-PROVIDER_VERSION = "1.0.0"
-
-# Base URL for provider downloads (Cloudflare R2)
-PROVIDER_DOWNLOAD_BASE_URL = "https://downloads.voicebox.sh/providers"
-
-
-def _get_providers_dir() -> Path:
-    """Get the directory where providers are stored."""
-    system = platform.system()
-    
-    if system == "Windows":
-        appdata = Path.home() / "AppData" / "Roaming"
-    elif system == "Darwin":
-        appdata = Path.home() / "Library" / "Application Support"
-    else:  # Linux
-        appdata = Path.home() / ".local" / "share"
-    
-    providers_dir = appdata / "voicebox" / "providers"
-    providers_dir.mkdir(parents=True, exist_ok=True)
-    return providers_dir
-
-
-def _get_provider_binary_name(provider_type: str) -> str:
-    """Get the local binary filename for a provider type."""
-    system = platform.system()
-    ext = ".exe" if system == "Windows" else ""
-    
-    binary_map = {
-        "pytorch-cpu": f"tts-provider-pytorch-cpu{ext}",
-        "pytorch-cuda": f"tts-provider-pytorch-cuda{ext}",
-    }
-    
-    if provider_type not in binary_map:
-        raise ValueError(f"Unknown provider type: {provider_type}")
-    
-    return binary_map[provider_type]
-
-
-def _get_provider_download_name(provider_type: str) -> str:
-    """Get the remote download filename for a provider type (includes platform suffix)."""
-    system = platform.system()
-
-    if system == "Windows":
-        platform_suffix = "windows"
-        ext = ".zip"
-    elif system == "Linux":
-        platform_suffix = "linux"
-        ext = ".tar.gz"
-    elif system == "Darwin":
-        # Detect macOS architecture
-        machine = platform.machine()
-        if machine == "arm64":
-            platform_suffix = "macos-arm64"
-        else:
-            platform_suffix = "macos-x64"
-        ext = ".tar.gz"
-    else:
-        raise ValueError(f"Provider downloads not supported on {system}")
-
-    return f"tts-provider-{provider_type}-{platform_suffix}{ext}"
-
-
-def _get_provider_download_url(provider_type: str) -> str:
-    """Get the download URL for a provider."""
-    download_name = _get_provider_download_name(provider_type)
-    return f"{PROVIDER_DOWNLOAD_BASE_URL}/v{PROVIDER_VERSION}/{download_name}"
-
-
-async def download_provider(provider_type: str) -> Path:
-    """
-    Download and extract a provider archive from Cloudflare R2.
-
-    Args:
-        provider_type: Type of provider to download (e.g., "pytorch-cpu")
-
-    Returns:
-        Path to the extracted provider binary
-
-    Raises:
-        ValueError: If provider_type is invalid
-        httpx.HTTPError: If download fails
-    """
-    if provider_type not in ["pytorch-cpu", "pytorch-cuda"]:
-        raise ValueError(f"Provider type {provider_type} cannot be downloaded")
-
-    progress_manager = get_progress_manager()
-    task_manager = get_task_manager()
-
-    archive_name = _get_provider_download_name(provider_type)
-    download_url = _get_provider_download_url(provider_type)
-    providers_dir = _get_providers_dir()
-    archive_path = providers_dir / archive_name
-
-    # Start tracking download
-    task_manager.start_download(provider_type)
-
-    # Initialize progress state
-    progress_manager.update_progress(
-        model_name=provider_type,
-        current=0,
-        total=0,  # Will be updated once we get Content-Length
-        filename=archive_name,
-        status="downloading",
-    )
-
-    try:
-        # Download archive
-        async with httpx.AsyncClient(timeout=300.0) as client:
-            async with client.stream("GET", download_url) as response:
-                response.raise_for_status()
-
-                # Get total size from Content-Length header
-                total_size = int(response.headers.get("Content-Length", 0))
-
-                if total_size > 0:
-                    progress_manager.update_progress(
-                        model_name=provider_type,
-                        current=0,
-                        total=total_size,
-                        filename=archive_name,
-                        status="downloading",
-                    )
-
-                # Download with progress tracking
-                downloaded = 0
-                with open(archive_path, "wb") as f:
-                    async for chunk in response.aiter_bytes(chunk_size=8192):
-                        f.write(chunk)
-                        downloaded += len(chunk)
-
-                        # Update progress
-                        progress_manager.update_progress(
-                            model_name=provider_type,
-                            current=downloaded,
-                            total=total_size if total_size > 0 else downloaded,
-                            filename=archive_name,
-                            status="downloading",
-                        )
-
-        # Extract archive
-        progress_manager.update_progress(
-            model_name=provider_type,
-            current=downloaded,
-            total=downloaded,
-            filename="Extracting...",
-            status="downloading",
-        )
-
-        import zipfile
-        import tarfile
-
-        if archive_name.endswith('.zip'):
-            with zipfile.ZipFile(archive_path, 'r') as zip_ref:
-                zip_ref.extractall(providers_dir)
-        elif archive_name.endswith('.tar.gz'):
-            with tarfile.open(archive_path, 'r:gz') as tar_ref:
-                tar_ref.extractall(providers_dir)
-        else:
-            raise ValueError(f"Unsupported archive format: {archive_name}")
-
-        # Remove archive after extraction
-        archive_path.unlink()
-
-        # Get path to extracted binary
-        binary_path = get_provider_binary_path(provider_type)
-        if not binary_path:
-            raise ValueError(f"Provider binary not found after extraction")
-
-        # Make executable on Unix systems
-        if platform.system() != "Windows":
-            binary_path.chmod(0o755)
-
-        # Mark as complete
-        progress_manager.update_progress(
-            model_name=provider_type,
-            current=downloaded,
-            total=downloaded,
-            filename=_get_provider_binary_name(provider_type),
-            status="complete",
-        )
-        task_manager.complete_download(provider_type)
-
-        return binary_path
-
-    except Exception as e:
-        # Clean up archive if it exists
-        if archive_path.exists():
-            archive_path.unlink()
-
-        # Mark as error
-        progress_manager.update_progress(
-            model_name=provider_type,
-            current=0,
-            total=0,
-            filename=archive_name,
-            status="error",
-        )
-        task_manager.error_download(provider_type, str(e))
-        raise
-
-
-def get_provider_binary_path(provider_type: str) -> Optional[Path]:
-    """
-    Get the path to an installed provider binary.
-
-    Args:
-        provider_type: Type of provider
-
-    Returns:
-        Path to provider binary, or None if not installed
-    """
-    providers_dir = _get_providers_dir()
-    binary_name = _get_provider_binary_name(provider_type)
-
-    # Check for --onedir structure (directory with binary inside)
-    provider_dir = providers_dir / f"tts-provider-{provider_type}"
-    if provider_dir.exists() and provider_dir.is_dir():
-        binary_path = provider_dir / binary_name
-        if binary_path.exists() and binary_path.is_file():
-            return binary_path
-
-    # Fallback: check for direct binary (legacy)
-    provider_path = providers_dir / binary_name
-    if provider_path.exists() and provider_path.is_file():
-        return provider_path
-
-    return None
-
-
-def delete_provider(provider_type: str) -> bool:
-    """
-    Delete an installed provider binary.
-    
-    Args:
-        provider_type: Type of provider to delete
-        
-    Returns:
-        True if deleted, False if not found
-    """
-    provider_path = get_provider_binary_path(provider_type)
-    
-    if provider_path and provider_path.exists():
-        provider_path.unlink()
-        return True
-    
-    return False

backend/providers/local.py

@@ -1,191 +0,0 @@
-"""
-Local provider that communicates with standalone provider servers via HTTP.
-"""
-
-from typing import Optional, Tuple
-import base64
-import io
-import numpy as np
-import httpx
-import soundfile as sf
-
-from .base import TTSProvider
-from .types import ProviderHealth, ProviderStatus
-
-
-class LocalProvider:
-    """Provider that communicates with local subprocess via HTTP."""
-    
-    def __init__(self, base_url: str):
-        """
-        Initialize local provider.
-        
-        Args:
-            base_url: Base URL of the provider server (e.g., "http://localhost:8000")
-        """
-        self.base_url = base_url.rstrip('/')
-        self.client = httpx.AsyncClient(timeout=300.0)  # 5 minute timeout for generation
-        self._current_model_size = "1.7B"  # Default model size
-    
-    async def generate(
-        self,
-        text: str,
-        voice_prompt: dict,
-        language: str = "en",
-        seed: Optional[int] = None,
-        instruct: Optional[str] = None,
-    ) -> Tuple[np.ndarray, int]:
-        """Generate speech audio."""
-        response = await self.client.post(
-            f"{self.base_url}/tts/generate",
-            json={
-                "text": text,
-                "voice_prompt": voice_prompt,
-                "language": language,
-                "seed": seed,
-                "model_size": self._current_model_size,
-            }
-        )
-        response.raise_for_status()
-        data = response.json()
-        
-        # Decode base64 audio
-        audio_bytes = base64.b64decode(data["audio"])
-        audio_buffer = io.BytesIO(audio_bytes)
-        audio, sample_rate = sf.read(audio_buffer)
-        
-        return audio, data["sample_rate"]
-    
-    async def create_voice_prompt(
-        self,
-        audio_path: str,
-        reference_text: str,
-        use_cache: bool = True,
-    ) -> Tuple[dict, bool]:
-        """Create voice prompt from reference audio."""
-        # Read audio file
-        with open(audio_path, 'rb') as f:
-            audio_data = f.read()
-        
-        # Send multipart form data
-        files = {
-            "audio": ("audio.wav", audio_data, "audio/wav")
-        }
-        data = {
-            "reference_text": reference_text,
-            "use_cache": str(use_cache).lower(),
-        }
-        
-        response = await self.client.post(
-            f"{self.base_url}/tts/create_voice_prompt",
-            files=files,
-            data=data,
-        )
-        response.raise_for_status()
-        result = response.json()
-        
-        return result["voice_prompt"], result.get("was_cached", False)
-    
-    async def combine_voice_prompts(
-        self,
-        audio_paths: list[str],
-        reference_texts: list[str],
-    ) -> Tuple[np.ndarray, str]:
-        """
-        Combine multiple voice prompts.
-        
-        Note: This is not implemented in the provider API yet.
-        For now, we'll combine locally by concatenating audio.
-        """
-        import numpy as np
-        from ..utils.audio import load_audio, normalize_audio
-        
-        combined_audio = []
-        for audio_path in audio_paths:
-            audio, sr = load_audio(audio_path)
-            audio = normalize_audio(audio)
-            combined_audio.append(audio)
-        
-        # Concatenate audio
-        mixed = np.concatenate(combined_audio)
-        mixed = normalize_audio(mixed)
-        
-        # Combine texts
-        combined_text = " ".join(reference_texts)
-        
-        return mixed, combined_text
-    
-    async def load_model_async(self, model_size: str) -> None:
-        """Load TTS model."""
-        # Track the requested model size - the provider server will load it
-        # when generate() is called with this size
-        self._current_model_size = model_size
-
-    # Alias for compatibility
-    load_model = load_model_async
-    
-    def unload_model(self) -> None:
-        """Unload model to free memory."""
-        # Model unloading is handled by the provider server
-        # This is a no-op for local providers
-        pass
-    
-    def is_loaded(self) -> bool:
-        """Check if model is loaded."""
-        # We can't know this without querying the provider
-        # Return True optimistically
-        return True
-    
-    def _get_model_path(self, model_size: str) -> str:
-        """Get model path for a given size."""
-        # For local providers, model paths are handled by the provider server
-        # Return a placeholder
-        return f"Qwen/Qwen3-TTS-12Hz-{model_size}-Base"
-    
-    async def health(self) -> ProviderHealth:
-        """Get provider health status."""
-        try:
-            response = await self.client.get(f"{self.base_url}/tts/health")
-            response.raise_for_status()
-            data = response.json()
-            return ProviderHealth(
-                status=data["status"],
-                provider=data["provider"],
-                version=data.get("version"),
-                model=data.get("model"),
-                device=data.get("device"),
-            )
-        except Exception as e:
-            return ProviderHealth(
-                status="unhealthy",
-                provider="local",
-                version=None,
-                model=None,
-                device=None,
-            )
-    
-    async def status(self) -> ProviderStatus:
-        """Get provider model status."""
-        try:
-            response = await self.client.get(f"{self.base_url}/tts/status")
-            response.raise_for_status()
-            data = response.json()
-            return ProviderStatus(
-                model_loaded=data["model_loaded"],
-                model_size=data.get("model_size"),
-                available_sizes=data.get("available_sizes", []),
-                gpu_available=data.get("gpu_available"),
-                vram_used_mb=data.get("vram_used_mb"),
-            )
-        except Exception as e:
-            return ProviderStatus(
-                model_loaded=False,
-                model_size=None,
-                available_sizes=[],
-                gpu_available=None,
-                vram_used_mb=None,
-            )
-    
-    async def stop(self) -> None:
-        """Stop the provider (close HTTP client)."""
-        await self.client.aclose()

backend/providers/types.py

@@ -1,34 +0,0 @@
-"""
-Shared types for TTS providers.
-"""
-
-from typing import Optional, TypedDict
-from enum import Enum
-
-
-class ProviderType(str, Enum):
-    """Available provider types."""
-    BUNDLED_MLX = "apple-mlx"
-    BUNDLED_PYTORCH = "bundled-pytorch"
-    PYTORCH_CPU = "pytorch-cpu"
-    PYTORCH_CUDA = "pytorch-cuda"
-    REMOTE = "remote"
-    OPENAI = "openai"
-
-
-class ProviderHealth(TypedDict):
-    """Provider health status."""
-    status: str  # "healthy", "unhealthy", "starting"
-    provider: str
-    version: Optional[str]
-    model: Optional[str]
-    device: Optional[str]
-
-
-class ProviderStatus(TypedDict):
-    """Provider model status."""
-    model_loaded: bool
-    model_size: Optional[str]
-    available_sizes: list[str]
-    gpu_available: Optional[bool]
-    vram_used_mb: Optional[int]

backend/requirements.txt

@@ -9,15 +9,26 @@ alembic>=1.13.0
 
 # ML models
 torch>=2.1.0
-transformers>=4.36.0
+transformers>=4.36.0,<=4.57.6
 accelerate>=0.26.0
 huggingface_hub>=0.20.0
 qwen-tts>=0.0.5
 
+# LuxTTS (voice cloning engine)
+# piper-phonemize needs custom index (no PyPI wheels)
+--find-links https://k2-fsa.github.io/icefall/piper_phonemize.html
+# linacodec is a git-only dep of Zipvoice (uv-only source, pip can't resolve it)
+linacodec @ git+https://github.com/ysharma3501/LinaCodec.git
+Zipvoice @ git+https://github.com/ysharma3501/LuxTTS.git
+
 # Audio processing
 librosa>=0.10.0
 soundfile>=0.12.0
 numpy>=1.24.0
+numba>=0.60.0,<0.61.0
+
+# HTTP client (for CUDA backend download)
+httpx>=0.27.0
 
 # Utilities
 python-multipart>=0.0.6

backend/server.py

@@ -64,7 +64,29 @@ if __name__ == "__main__":
             default=None,
             help="Data directory for database, profiles, and generated audio",
         )
+        parser.add_argument(
+            "--version",
+            action="store_true",
+            help="Print version and exit",
+        )
         args = parser.parse_args()
+
+        if args.version:
+            from backend import __version__
+            print(f"voicebox-server {__version__}")
+            sys.exit(0)
+
+        # Detect backend variant from binary name
+        # voicebox-server-cuda → sets VOICEBOX_BACKEND_VARIANT=cuda
+        import os
+        binary_name = os.path.basename(sys.executable).lower()
+        if "cuda" in binary_name:
+            os.environ["VOICEBOX_BACKEND_VARIANT"] = "cuda"
+            logger.info("Backend variant: CUDA")
+        else:
+            os.environ["VOICEBOX_BACKEND_VARIANT"] = "cpu"
+            logger.info("Backend variant: CPU")
+
         logger.info(f"Parsed arguments: host={args.host}, port={args.port}, data_dir={args.data_dir}")
 
         # Set data directory if provided

backend/tts.py

@@ -1,5 +1,5 @@
 """
-TTS inference module - delegates to provider abstraction layer.
+TTS inference module - delegates to backend abstraction layer.
 """
 
 from typing import Optional
@@ -7,51 +7,23 @@ import numpy as np
 import io
 import soundfile as sf
 
-from .backends import TTSBackend
-from .providers import get_provider_manager
-from .providers.base import TTSProvider
+from .backends import get_tts_backend, TTSBackend
 
 
-def get_tts_model() -> TTSProvider:
+def get_tts_model() -> TTSBackend:
     """
-    Get TTS provider instance (via ProviderManager).
+    Get TTS backend instance (MLX or PyTorch based on platform).
     
     Returns:
-        TTS provider instance
+        TTS backend instance
     """
-    manager = get_provider_manager()
-    # Note: This is async but we need sync interface for backward compatibility
-    # In practice, this will be called from async contexts
-    import asyncio
-    try:
-        loop = asyncio.get_event_loop()
-        if loop.is_running():
-            # We're in an async context, but can't await here
-            # Return a wrapper that will use the provider manager
-            return manager._get_default_provider()
-        else:
-            return loop.run_until_complete(manager.get_active_provider())
-    except RuntimeError:
-        # No event loop, return default
-        return manager._get_default_provider()
-
-
-async def get_tts_model_async() -> TTSProvider:
-    """
-    Get TTS provider instance asynchronously.
-    
-    Returns:
-        TTS provider instance
-    """
-    manager = get_provider_manager()
-    return await manager.get_active_provider()
+    return get_tts_backend()
 
 
 def unload_tts_model():
     """Unload TTS model to free memory."""
-    manager = get_provider_manager()
-    provider = manager._get_default_provider()
-    provider.unload_model()
+    backend = get_tts_backend()
+    backend.unload_model()
 
 
 def audio_to_wav_bytes(audio: np.ndarray, sample_rate: int) -> bytes:

backend/utils/progress.py

@@ -49,17 +49,11 @@ class ProgressManager:
                     queue.put_nowait(progress_data.copy())
                 except RuntimeError:
                     # Not in async context (running in background thread)
-                    # Use asyncio.run_coroutine_threadsafe for better PyInstaller compatibility
+                    # Use call_soon_threadsafe to safely put on queue
                     if self._main_loop and self._main_loop.is_running():
-                        async def put_data_async():
-                            try:
-                                queue.put_nowait(progress_data.copy())
-                            except asyncio.QueueFull:
-                                pass  # Queue full, drop update
-                        try:
-                            asyncio.run_coroutine_threadsafe(put_data_async(), self._main_loop)
-                        except Exception as e:
-                            logger.warning(f"Failed to schedule progress update: {e}")
+                        self._main_loop.call_soon_threadsafe(
+                            lambda q=queue, d=progress_data.copy(): q.put_nowait(d) if not q.full() else None
+                        )
                     else:
                         logger.debug(f"No main loop available for {model_name}, skipping notification")
             except asyncio.QueueFull:

backend/utils/tasks.py

@@ -72,6 +72,15 @@ class TaskManager:
         """Get all active generations."""
         return list(self._active_generations.values())
     
+    def cancel_download(self, model_name: str) -> bool:
+        """Cancel/dismiss a download task (removes it from active list)."""
+        return self._active_downloads.pop(model_name, None) is not None
+
+    def clear_all(self) -> None:
+        """Clear all download and generation tasks."""
+        self._active_downloads.clear()
+        self._active_generations.clear()
+
     def is_download_active(self, model_name: str) -> bool:
         """Check if a download is active."""
         return model_name in self._active_downloads

backend/voicebox-server.spec

@@ -1,11 +1,20 @@
 # -*- mode: python ; coding: utf-8 -*-
 from PyInstaller.utils.hooks import collect_data_files
 from PyInstaller.utils.hooks import collect_submodules
+from PyInstaller.utils.hooks import copy_metadata
 
 datas = []
-hiddenimports = ['backend', 'backend.main', 'backend.config', 'backend.database', 'backend.models', 'backend.profiles', 'backend.history', 'backend.tts', 'backend.transcribe', 'backend.platform_detect', 'backend.providers', 'backend.providers.base', 'backend.providers.bundled', 'backend.providers.types', 'backend.utils.audio', 'backend.utils.cache', 'backend.utils.progress', 'backend.utils.hf_progress', 'backend.utils.validation', 'fastapi', 'uvicorn', 'sqlalchemy', 'librosa', 'soundfile', 'pkg_resources.extern', 'asyncio', 'asyncio.subprocess', 'concurrent.futures', 'concurrent.futures.thread', 'backend.backends', 'backend.backends.mlx_backend', 'mlx', 'mlx.core', 'mlx.nn', 'mlx_audio', 'mlx_audio.tts', 'mlx_audio.stt']
-datas += collect_data_files('mlx')
-datas += collect_data_files('mlx_audio')
+hiddenimports = ['backend', 'backend.main', 'backend.config', 'backend.database', 'backend.models', 'backend.profiles', 'backend.history', 'backend.tts', 'backend.transcribe', 'backend.platform_detect', 'backend.backends', 'backend.backends.pytorch_backend', 'backend.utils.audio', 'backend.utils.cache', 'backend.utils.progress', 'backend.utils.hf_progress', 'backend.utils.validation', 'torch', 'transformers', 'fastapi', 'uvicorn', 'sqlalchemy', 'librosa', 'soundfile', 'qwen_tts', 'qwen_tts.inference', 'qwen_tts.inference.qwen3_tts_model', 'qwen_tts.inference.qwen3_tts_tokenizer', 'qwen_tts.core', 'qwen_tts.cli', 'pkg_resources.extern', 'backend.backends.mlx_backend', 'mlx', 'mlx.core', 'mlx.nn', 'mlx_audio', 'mlx_audio.tts', 'mlx_audio.stt']
+datas += collect_data_files('qwen_tts')
+# Use collect_all (not collect_data_files) so native .dylib and .metallib
+# files are bundled as binaries, not data. Without this, MLX raises OSError
+# when loading Metal shaders inside the PyInstaller bundle.
+from PyInstaller.utils.hooks import collect_all as _collect_all
+_mlx_datas, _mlx_bins, _mlx_hidden = _collect_all('mlx')
+_mlxa_datas, _mlxa_bins, _mlxa_hidden = _collect_all('mlx_audio')
+datas += _mlx_datas + _mlxa_datas
+datas += copy_metadata('qwen-tts')
+hiddenimports += collect_submodules('qwen_tts')
 hiddenimports += collect_submodules('jaraco')
 hiddenimports += collect_submodules('mlx')
 hiddenimports += collect_submodules('mlx_audio')
@@ -14,7 +23,7 @@ hiddenimports += collect_submodules('mlx_audio')
 a = Analysis(
     ['server.py'],
     pathex=[],
-    binaries=[],
+    binaries=_mlx_bins + _mlxa_bins,
     datas=datas,
     hiddenimports=hiddenimports,
     hookspath=[],

bun.lock

@@ -13,16 +13,12 @@
     },
     "app": {
       "name": "@voicebox/app",
-      "version": "0.1.13",
+      "version": "0.1.11",
       "dependencies": {
         "@dnd-kit/core": "^6.3.1",
         "@dnd-kit/sortable": "^10.0.0",
         "@dnd-kit/utilities": "^3.2.2",
         "@hookform/resolvers": "^3.9.0",
-        "@hugeicons/core-free-icons": "^3.1.1",
-        "@hugeicons/react": "^1.1.4",
-        "@iconify-json/svg-spinners": "^1.2.4",
-        "@iconify/react": "^6.0.2",
         "@radix-ui/react-alert-dialog": "^1.1.1",
         "@radix-ui/react-avatar": "^1.1.0",
         "@radix-ui/react-dialog": "^1.1.1",
@@ -30,7 +26,6 @@
         "@radix-ui/react-label": "^2.1.0",
         "@radix-ui/react-popover": "^1.1.1",
         "@radix-ui/react-progress": "^1.1.0",
-        "@radix-ui/react-radio-group": "^1.2.0",
         "@radix-ui/react-scroll-area": "^1.1.0",
         "@radix-ui/react-select": "^2.1.1",
         "@radix-ui/react-separator": "^1.1.0",
@@ -50,6 +45,7 @@
         "clsx": "^2.1.1",
         "date-fns": "^3.6.0",
         "framer-motion": "^12.29.0",
+        "lucide-react": "^0.454.0",
         "motion": "^12.29.0",
         "react": "^18.3.0",
         "react-dom": "^18.3.0",
@@ -72,7 +68,7 @@
     },
     "landing": {
       "name": "@voicebox/landing",
-      "version": "0.1.13",
+      "version": "0.1.11",
       "dependencies": {
         "@radix-ui/react-separator": "^1.1.8",
         "@radix-ui/react-slot": "^1.2.4",
@@ -97,7 +93,7 @@
     },
     "tauri": {
       "name": "@voicebox/tauri",
-      "version": "0.1.13",
+      "version": "0.1.11",
       "dependencies": {
         "@tauri-apps/api": "^2.0.0",
         "@tauri-apps/plugin-dialog": "^2.0.0",
@@ -120,7 +116,7 @@
     },
     "web": {
       "name": "@voicebox/web",
-      "version": "0.1.13",
+      "version": "0.1.11",
       "dependencies": {
         "@tanstack/react-query": "^5.0.0",
         "react": "^18.3.0",
@@ -129,7 +125,6 @@
         "zustand": "^4.5.0",
       },
       "devDependencies": {
-        "@tailwindcss/vite": "^4.1.18",
         "@types/react": "^18.3.0",
         "@types/react-dom": "^18.3.0",
         "@typescript-eslint/eslint-plugin": "^7.0.0",
@@ -138,7 +133,6 @@
         "eslint": "^8.57.0",
         "eslint-plugin-react-hooks": "^4.6.0",
         "eslint-plugin-react-refresh": "^0.4.0",
-        "tailwindcss": "^4.1.0",
         "typescript": "^5.6.0",
         "vite": "^5.4.0",
       },
@@ -277,22 +271,12 @@
 
     "@hookform/resolvers": ["@hookform/[email protected]", "", { "peerDependencies": { "react-hook-form": "^7.0.0" } }, "sha512-79Dv+3mDF7i+2ajj7SkypSKHhl1cbln1OGavqrsF7p6mbUv11xpqpacPsGDCTRvCSjEEIez2ef1NveSVL3b0Ag=="],
 
-    "@hugeicons/core-free-icons": ["@hugeicons/[email protected]", "", {}, "sha512-UpS2lUQFi5sKyJSWwM6rO+BnPLvVz1gsyCpPHeZyVuZqi89YH8ksliza4cwaODqKOZyeXmG8juo1ty4QtQofkg=="],
-
-    "@hugeicons/react": ["@hugeicons/[email protected]", "", { "peerDependencies": { "react": ">=16.0.0" } }, "sha512-gsc3eZyd2fGqRUThW9+lfjxxsOkz6KNVmRXRgJjP32GL0OnnLJnl3hytKt47CBbiQj2xE2kCw+rnP3UQCThcKw=="],
-
     "@humanwhocodes/config-array": ["@humanwhocodes/[email protected]", "", { "dependencies": { "@humanwhocodes/object-schema": "^2.0.3", "debug": "^4.3.1", "minimatch": "^3.0.5" } }, "sha512-DZLEEqFWQFiyK6h5YIeynKx7JlvCYWL0cImfSRXZ9l4Sg2efkFGTuFf6vzXjK1cq6IYkU+Eg/JizXw+TD2vRNw=="],
 
     "@humanwhocodes/module-importer": ["@humanwhocodes/[email protected]", "", {}, "sha512-bxveV4V8v5Yb4ncFTT3rPSgZBOpCkjfK0y4oVVVJwIuDVBRMDXrPyXRL988i5ap9m9bnyEEjWfm5WkBmtffLfA=="],
 
     "@humanwhocodes/object-schema": ["@humanwhocodes/[email protected]", "", {}, "sha512-93zYdMES/c1D69yZiKDBj0V24vqNzB/koF26KPaagAfd3P/4gUlh3Dys5ogAK+Exi9QyzlD8x/08Zt7wIKcDcA=="],
 
-    "@iconify-json/svg-spinners": ["@iconify-json/[email protected]", "", { "dependencies": { "@iconify/types": "*" } }, "sha512-ayn0pogFPwJA1WFZpDnoq9/hjDxN+keeCMyThaX4d3gSJ3y0mdKUxIA/b1YXWGtY9wVtZmxwcvOIeEieG4+JNg=="],
-
-    "@iconify/react": ["@iconify/[email protected]", "", { "dependencies": { "@iconify/types": "^2.0.0" }, "peerDependencies": { "react": ">=16" } }, "sha512-SMmC2sactfpJD427WJEDN6PMyznTFMhByK9yLW0gOTtnjzzbsi/Ke/XqsumsavFPwNiXs8jSiYeZTmLCLwO+Fg=="],
-
-    "@iconify/types": ["@iconify/[email protected]", "", {}, "sha512-+wluvCrRhXrhyOmRDJ3q8mux9JkKy5SJ/v8ol2tu4FVjyYvtEzkc/3pK15ET6RKg4b4w4BmTk1+gsCUhf21Ykg=="],
-
     "@img/colour": ["@img/[email protected]", "", {}, "sha512-A5P/LfWGFSl6nsckYtjw9da+19jB8hkJ6ACTGcDfEJ0aE+l2n2El7dsVM7UVHZQ9s2lmYMWlrS21YLy2IR1LUw=="],
 
     "@img/sharp-darwin-arm64": ["@img/[email protected]", "", { "optionalDependencies": { "@img/sharp-libvips-darwin-arm64": "1.2.4" }, "os": "darwin", "cpu": "arm64" }, "sha512-imtQ3WMJXbMY4fxb/Ndp6HBTNVtWCUI0WdobyheGf5+ad6xX8VIDO8u2xE4qc/fr08CKG/7dDseFtn6M6g/r3w=="],
@@ -423,8 +407,6 @@
 
     "@radix-ui/react-progress": ["@radix-ui/[email protected]", "", { "dependencies": { "@radix-ui/react-context": "1.1.3", "@radix-ui/react-primitive": "2.1.4" }, "peerDependencies": { "@types/react": "*", "@types/react-dom": "*", "react": "^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc", "react-dom": "^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc" }, "optionalPeers": ["@types/react", "@types/react-dom"] }, "sha512-+gISHcSPUJ7ktBy9RnTqbdKW78bcGke3t6taawyZ71pio1JewwGSJizycs7rLhGTvMJYCQB1DBK4KQsxs7U8dA=="],
 
-    "@radix-ui/react-radio-group": ["@radix-ui/[email protected]", "", { "dependencies": { "@radix-ui/primitive": "1.1.3", "@radix-ui/react-compose-refs": "1.1.2", "@radix-ui/react-context": "1.1.2", "@radix-ui/react-direction": "1.1.1", "@radix-ui/react-presence": "1.1.5", "@radix-ui/react-primitive": "2.1.3", "@radix-ui/react-roving-focus": "1.1.11", "@radix-ui/react-use-controllable-state": "1.2.2", "@radix-ui/react-use-previous": "1.1.1", "@radix-ui/react-use-size": "1.1.1" }, "peerDependencies": { "@types/react": "*", "@types/react-dom": "*", "react": "^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc", "react-dom": "^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc" }, "optionalPeers": ["@types/react", "@types/react-dom"] }, "sha512-VBKYIYImA5zsxACdisNQ3BjCBfmbGH3kQlnFVqlWU4tXwjy7cGX8ta80BcrO+WJXIn5iBylEH3K6ZTlee//lgQ=="],
-
     "@radix-ui/react-roving-focus": ["@radix-ui/[email protected]", "", { "dependencies": { "@radix-ui/primitive": "1.1.3", "@radix-ui/react-collection": "1.1.7", "@radix-ui/react-compose-refs": "1.1.2", "@radix-ui/react-context": "1.1.2", "@radix-ui/react-direction": "1.1.1", "@radix-ui/react-id": "1.1.1", "@radix-ui/react-primitive": "2.1.3", "@radix-ui/react-use-callback-ref": "1.1.1", "@radix-ui/react-use-controllable-state": "1.2.2" }, "peerDependencies": { "@types/react": "*", "@types/react-dom": "*", "react": "^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc", "react-dom": "^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc" }, "optionalPeers": ["@types/react", "@types/react-dom"] }, "sha512-7A6S9jSgm/S+7MdtNDSb+IU859vQqJ/QAtcYQcfFC6W8RS4IxIZDldLR0xqCFZ6DCyrQLjLPsxtTNch5jVA4lA=="],
 
     "@radix-ui/react-scroll-area": ["@radix-ui/[email protected]", "", { "dependencies": { "@radix-ui/number": "1.1.1", "@radix-ui/primitive": "1.1.3", "@radix-ui/react-compose-refs": "1.1.2", "@radix-ui/react-context": "1.1.2", "@radix-ui/react-direction": "1.1.1", "@radix-ui/react-presence": "1.1.5", "@radix-ui/react-primitive": "2.1.3", "@radix-ui/react-use-callback-ref": "1.1.1", "@radix-ui/react-use-layout-effect": "1.1.1" }, "peerDependencies": { "@types/react": "*", "@types/react-dom": "*", "react": "^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc", "react-dom": "^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc" }, "optionalPeers": ["@types/react", "@types/react-dom"] }, "sha512-tAXIa1g3sM5CGpVT0uIbUx/U3Gs5N8T52IICuCtObaos1S8fzsrPXG5WObkQN3S6NVl6wKgPhAIiBGbWnvc97A=="],
@@ -899,7 +881,7 @@
 
     "lru-cache": ["[email protected]", "", { "dependencies": { "yallist": "^3.0.2" } }, "sha512-KpNARQA3Iwv+jTA0utUVVbrh+Jlrr1Fv0e56GGzAFOXN7dk/FviaDW8LHmK52DlcH4WP2n6gI8vN1aesBFgo9w=="],
 
-    "lucide-react": ["lucide-react@0.316.0", "", { "peerDependencies": { "react": "^16.5.1 || ^17.0.0 || ^18.0.0" } }, "sha512-dTmYX1H4IXsRfVcj/KUxworV6814ApTl7iXaS21AimK2RUEl4j4AfOmqD3VR8phe5V91m4vEJ8tCK4uT1jE5nA=="],
+    "lucide-react": ["lucide-react@0.454.0", "", { "peerDependencies": { "react": "^16.5.1 || ^17.0.0 || ^18.0.0 || ^19.0.0-rc" } }, "sha512-hw7zMDwykCLnEzgncEEjHeA6+45aeEzRYuKHuyRSOPkhko+J3ySGjGIzu+mmMfDFG1vazHepMaYFYHbTFAZAAQ=="],
 
     "magic-string": ["[email protected]", "", { "dependencies": { "@jridgewell/sourcemap-codec": "^1.5.5" } }, "sha512-vd2F4YUyEXKGcLHoq+TEyCjxueSeHnFxyyjNp80yg0XV4vUhnDer/lvvlqM/arB5bXQN5K2/3oinyCRyx8T2CQ=="],
 
@@ -1155,6 +1137,8 @@
 
     "@typescript-eslint/typescript-estree/semver": ["[email protected]", "", { "bin": { "semver": "bin/semver.js" } }, "sha512-SdsKMrI9TdgjdweUSR9MweHA4EJ8YxHn8DFaDisvhVlUOe4BF1tLD7GAj0lIqWVl+dPb/rExr0Btby5loQm20Q=="],
 
+    "@voicebox/landing/lucide-react": ["[email protected]", "", { "peerDependencies": { "react": "^16.5.1 || ^17.0.0 || ^18.0.0" } }, "sha512-dTmYX1H4IXsRfVcj/KUxworV6814ApTl7iXaS21AimK2RUEl4j4AfOmqD3VR8phe5V91m4vEJ8tCK4uT1jE5nA=="],
+
     "@voicebox/landing/tailwind-merge": ["[email protected]", "", {}, "sha512-uSaO4gnW+b3Y2aWoWfFpX62vn2sR3skfhbjsEnaBI81WD1wBLlHZe5sWf0AqjksNdYTbGBEd0UasQMT3SNV15g=="],
 
     "@voicebox/landing/tailwindcss": ["[email protected]", "", { "dependencies": { "@alloc/quick-lru": "^5.2.0", "arg": "^5.0.2", "chokidar": "^3.6.0", "didyoumean": "^1.2.2", "dlv": "^1.1.3", "fast-glob": "^3.3.2", "glob-parent": "^6.0.2", "is-glob": "^4.0.3", "jiti": "^1.21.7", "lilconfig": "^3.1.3", "micromatch": "^4.0.8", "normalize-path": "^3.0.0", "object-hash": "^3.0.0", "picocolors": "^1.1.1", "postcss": "^8.4.47", "postcss-import": "^15.1.0", "postcss-js": "^4.0.1", "postcss-load-config": "^4.0.2 || ^5.0 || ^6.0", "postcss-nested": "^6.2.0", "postcss-selector-parser": "^6.1.2", "resolve": "^1.22.8", "sucrase": "^3.35.0" }, "bin": { "tailwind": "lib/cli.js", "tailwindcss": "lib/cli.js" } }, "sha512-3ofp+LL8E+pK/JuPLPggVAIaEuhvIz4qNcf3nA1Xn2o/7fb7s/TYpHhwGDv1ZU3PkBluUVaF8PyCHcm48cKLWQ=="],

data/.gitkeep

@@ -0,0 +1,7 @@
+# User data directory
+# This directory contains:
+# - profiles/ - Voice profile audio files
+# - generations/ - Generated audio files
+# - projects/ - Audio studio project files
+# - voicebox.db - SQLite database
+# - cache/ - Voice prompt cache files

data/cache/.gitkeep

@@ -0,0 +1 @@
+# Voice prompt cache files

docker-compose.cpu.yml

@@ -1,26 +0,0 @@
-version: '3.8'
-
-services:
-  voicebox:
-    image: ghcr.io/jamiepine/voicebox:latest
-    container_name: voicebox
-    restart: unless-stopped
-    ports:
-      - "8000:8000"
-    volumes:
-      - voicebox-data:/app/data
-      - huggingface-cache:/root/.cache/huggingface
-    environment:
-      - LOG_LEVEL=info
-    healthcheck:
-      test: ["CMD", "curl", "-f", "http://localhost:8000/health"]
-      interval: 30s
-      timeout: 10s
-      retries: 3
-      start_period: 40s
-
-volumes:
-  voicebox-data:
-    driver: local
-  huggingface-cache:
-    driver: local

docker-compose.yml

@@ -1,34 +0,0 @@
-version: '3.8'
-
-services:
-  voicebox:
-    image: ghcr.io/jamiepine/voicebox:latest-cuda
-    container_name: voicebox
-    restart: unless-stopped
-    ports:
-      - "8000:8000"
-    volumes:
-      - voicebox-data:/app/data
-      - huggingface-cache:/root/.cache/huggingface
-    environment:
-      - GPU_MEMORY_FRACTION=0.8
-      - LOG_LEVEL=info
-    deploy:
-      resources:
-        reservations:
-          devices:
-            - driver: nvidia
-              count: 1
-              capabilities: [gpu]
-    healthcheck:
-      test: ["CMD", "curl", "-f", "http://localhost:8000/health"]
-      interval: 30s
-      timeout: 10s
-      retries: 3
-      start_period: 40s
-
-volumes:
-  voicebox-data:
-    driver: local
-  huggingface-cache:
-    driver: local

docs/mint.json

@@ -40,7 +40,7 @@
     {
       "group": "Getting Started",
       "icon": "rocket",
-      "pages": ["overview/introduction", "overview/installation", "overview/docker", "overview/quick-start"]
+      "pages": ["overview/introduction", "overview/installation", "overview/quick-start"]
     },
     {
       "group": "Features",

docs/overview/docker.mdx

@@ -1,403 +0,0 @@
----
-title: "Docker Deployment"
-description: "Run Voicebox in Docker with the web UI for server deployments"
----
-
-## Overview
-
-Voicebox is available as Docker images that include both the backend API and web UI. Run the full Voicebox experience in a container with a single command.
-
-**What's included:**
-- FastAPI backend with all TTS/Whisper capabilities
-- Complete web UI (same React app as the desktop version)
-- Provider download system (downloads PyTorch on first use)
-- Multi-architecture support (amd64, arm64)
-
-## Quick Start
-
-<Tabs>
-  <Tab title="NVIDIA GPU">
-    ```bash
-    docker run --gpus all -p 8000:8000 \
-      -v voicebox-data:/app/data \
-      ghcr.io/jamiepine/voicebox:latest-cuda
-    ```
-
-    Then open http://localhost:8000 to access the web UI.
-  </Tab>
-
-  <Tab title="CPU Only">
-    ```bash
-    docker run -p 8000:8000 \
-      -v voicebox-data:/app/data \
-      ghcr.io/jamiepine/voicebox:latest
-    ```
-
-    Then open http://localhost:8000 to access the web UI.
-  </Tab>
-
-  <Tab title="Docker Compose">
-    Clone the repo or download `docker-compose.yml`:
-
-    ```bash
-    # CUDA variant (default)
-    docker compose up -d
-
-    # CPU-only variant
-    docker compose -f docker-compose-cpu.yml up -d
-    ```
-
-    Then open http://localhost:8000 to access the web UI.
-  </Tab>
-</Tabs>
-
-<Note>
-  On first launch, you'll be prompted to download a TTS provider (PyTorch CPU ~300MB or PyTorch CUDA ~2.4GB). This happens once and is cached in the `huggingface-cache` volume.
-</Note>
-
-## Available Images
-
-Images are automatically built and published to GitHub Container Registry on each release.
-
-| Image | Description | Platforms |
-|-------|-------------|-----------|
-| `ghcr.io/jamiepine/voicebox:latest` | Latest CPU-only release | linux/amd64, linux/arm64 |
-| `ghcr.io/jamiepine/voicebox:0.1.13` | Specific version (CPU) | linux/amd64, linux/arm64 |
-| `ghcr.io/jamiepine/voicebox:latest-cuda` | Latest with NVIDIA GPU support | linux/amd64 |
-| `ghcr.io/jamiepine/voicebox:0.1.13-cuda` | Specific version (CUDA) | linux/amd64 |
-
-<Tip>
-  Pin to a specific version in production to avoid unexpected updates:
-  ```yaml
-  image: ghcr.io/jamiepine/voicebox:0.1.13-cuda
-  ```
-</Tip>
-
-## Docker Compose Examples
-
-### GPU Deployment (Recommended)
-
-```yaml
-version: '3.8'
-
-services:
-  voicebox:
-    image: ghcr.io/jamiepine/voicebox:latest-cuda
-    container_name: voicebox
-    restart: unless-stopped
-    ports:
-      - "8000:8000"
-    volumes:
-      - voicebox-data:/app/data
-      - huggingface-cache:/root/.cache/huggingface
-    environment:
-      - GPU_MEMORY_FRACTION=0.8
-      - LOG_LEVEL=info
-    deploy:
-      resources:
-        reservations:
-          devices:
-            - driver: nvidia
-              count: 1
-              capabilities: [gpu]
-
-volumes:
-  voicebox-data:
-  huggingface-cache:
-```
-
-### CPU Deployment
-
-```yaml
-version: '3.8'
-
-services:
-  voicebox:
-    image: ghcr.io/jamiepine/voicebox:latest
-    container_name: voicebox
-    restart: unless-stopped
-    ports:
-      - "8000:8000"
-    volumes:
-      - voicebox-data:/app/data
-      - huggingface-cache:/root/.cache/huggingface
-    environment:
-      - LOG_LEVEL=info
-
-volumes:
-  voicebox-data:
-  huggingface-cache:
-```
-
-## Volume Mounts
-
-<CardGroup cols={2}>
-  <Card title="voicebox-data" icon="database">
-    Stores voice profiles, generated audio, and database
-  </Card>
-  <Card title="huggingface-cache" icon="download">
-    Caches downloaded TTS/Whisper models (saves re-downloading)
-  </Card>
-</CardGroup>
-
-<Warning>
-  Always mount `/app/data` to preserve your voice profiles and generations across container restarts.
-</Warning>
-
-## Environment Variables
-
-Configure Voicebox behavior with environment variables:
-
-| Variable | Default | Description |
-|----------|---------|-------------|
-| `GPU_MEMORY_FRACTION` | `0.9` | Fraction of GPU memory to use (0.0-1.0) |
-| `LOG_LEVEL` | `info` | Logging level: `debug`, `info`, `warning`, `error` |
-| `DATA_DIR` | `/app/data` | Directory for profiles and generations |
-
-Example:
-```bash
-docker run -e GPU_MEMORY_FRACTION=0.8 \
-           -e LOG_LEVEL=debug \
-           -p 8000:8000 \
-           ghcr.io/jamiepine/voicebox:latest-cuda
-```
-
-## Cloud Deployment
-
-### AWS EC2
-
-<Steps>
-  <Step title="Launch GPU Instance">
-    Use g4dn.xlarge or p3.2xlarge with NVIDIA GPU
-  </Step>
-
-  <Step title="Install Docker & NVIDIA Container Toolkit">
-    ```bash
-    # Install Docker
-    curl -fsSL https://get.docker.com -o get-docker.sh
-    sudo sh get-docker.sh
-
-    # Install NVIDIA Container Toolkit
-    distribution=$(. /etc/os-release;echo $ID$VERSION_ID)
-    curl -fsSL https://nvidia.github.io/libnvidia-container/gpgkey | sudo gpg --dearmor -o /usr/share/keyrings/nvidia-container-toolkit-keyring.gpg
-    curl -s -L https://nvidia.github.io/libnvidia-container/$distribution/libnvidia-container.list | \
-      sed 's#deb https://#deb [signed-by=/usr/share/keyrings/nvidia-container-toolkit-keyring.gpg] https://#g' | \
-      sudo tee /etc/apt/sources.list.d/nvidia-container-toolkit.list
-    sudo apt-get update
-    sudo apt-get install -y nvidia-container-toolkit
-    sudo systemctl restart docker
-    ```
-  </Step>
-
-  <Step title="Deploy">
-    ```bash
-    docker run -d --gpus all -p 8000:8000 \
-      -v voicebox-data:/app/data \
-      --restart unless-stopped \
-      ghcr.io/jamiepine/voicebox:latest-cuda
-    ```
-  </Step>
-</Steps>
-
-### DigitalOcean
-
-<Steps>
-  <Step title="Create GPU Droplet">
-    ```bash
-    doctl compute droplet create voicebox \
-      --size gpu-h100x1-80gb \
-      --image ubuntu-22-04-x64 \
-      --region nyc3
-    ```
-  </Step>
-
-  <Step title="SSH and Deploy">
-    ```bash
-    ssh root@<droplet-ip>
-    curl -fsSL https://get.docker.com | sh
-    docker run -d --gpus all -p 80:8000 \
-      ghcr.io/jamiepine/voicebox:latest-cuda
-    ```
-  </Step>
-</Steps>
-
-### Fly.io
-
-Create `fly.toml`:
-
-```toml
-app = "voicebox"
-
-[build]
-  image = "ghcr.io/jamiepine/voicebox:latest"
-
-[[services]]
-  http_checks = []
-  internal_port = 8000
-  protocol = "tcp"
-
-  [[services.ports]]
-    port = 80
-    handlers = ["http"]
-
-  [[services.ports]]
-    port = 443
-    handlers = ["tls", "http"]
-
-[mounts]
-  source = "voicebox_data"
-  destination = "/app/data"
-```
-
-Deploy:
-```bash
-fly launch
-fly deploy
-```
-
-## Updates
-
-Docker images are automatically built and published on each GitHub release.
-
-<Tabs>
-  <Tab title="Latest Tag">
-    Always get the newest version:
-
-    ```bash
-    docker pull ghcr.io/jamiepine/voicebox:latest
-    docker compose up -d
-    ```
-  </Tab>
-
-  <Tab title="Pinned Version">
-    Update to a specific version:
-
-    ```yaml
-    services:
-      voicebox:
-        image: ghcr.io/jamiepine/voicebox:0.1.13-cuda
-    ```
-
-    ```bash
-    docker compose pull
-    docker compose up -d
-    ```
-  </Tab>
-
-  <Tab title="Automatic Updates">
-    Use Watchtower for automatic updates:
-
-    ```yaml
-    services:
-      voicebox:
-        image: ghcr.io/jamiepine/voicebox:latest-cuda
-        # ... other config ...
-
-      watchtower:
-        image: containrrr/watchtower
-        volumes:
-          - /var/run/docker.sock:/var/run/docker.sock
-        command: --interval 3600 # Check hourly
-    ```
-  </Tab>
-</Tabs>
-
-## GPU Requirements
-
-### NVIDIA GPU
-
-Requires:
-- **Docker version:** 19.03+
-- **NVIDIA Driver:** 450.80.02+
-- **NVIDIA Container Toolkit:** Installed and configured
-
-Verify GPU access:
-```bash
-docker run --rm --gpus all nvidia/cuda:12.1.1-base-ubuntu22.04 nvidia-smi
-```
-
-If this works, Voicebox will detect and use your GPU automatically.
-
-### AMD GPU (ROCm)
-
-AMD GPU support via ROCm is not currently available in pre-built images. If you need ROCm support, build a custom image using the ROCm base.
-
-## Troubleshooting
-
-### GPU Not Detected
-
-<Accordion title="Check NVIDIA Docker">
-  ```bash
-  # Verify NVIDIA Container Toolkit is installed
-  docker run --rm --gpus all nvidia/cuda:12.1.1-base-ubuntu22.04 nvidia-smi
-  ```
-
-  If this fails, reinstall NVIDIA Container Toolkit.
-</Accordion>
-
-<Accordion title="Insufficient GPU Memory">
-  Reduce GPU memory usage:
-
-  ```bash
-  docker run -e GPU_MEMORY_FRACTION=0.5 \
-    --gpus all -p 8000:8000 \
-    ghcr.io/jamiepine/voicebox:latest-cuda
-  ```
-
-  Or use CPU-only mode:
-  ```bash
-  docker run -p 8000:8000 \
-    ghcr.io/jamiepine/voicebox:latest
-  ```
-</Accordion>
-
-<Accordion title="Port Already in Use">
-  Change the host port:
-
-  ```bash
-  docker run -p 8080:8000 ghcr.io/jamiepine/voicebox:latest
-  ```
-
-  Then open http://localhost:8080
-</Accordion>
-
-<Accordion title="Permission Errors">
-  Run with specific user:
-
-  ```bash
-  docker run --user $(id -u):$(id -g) \
-    -v $(pwd)/data:/app/data \
-    ghcr.io/jamiepine/voicebox:latest
-  ```
-</Accordion>
-
-## Building From Source
-
-If you need to customize the Docker image:
-
-```bash
-# Clone the repo
-git clone https://github.com/jamiepine/voicebox.git
-cd voicebox
-
-# Build web UI
-bun install
-cd web && bun run build && cd ..
-
-# Build Docker image
-docker build -t voicebox:custom .
-
-# Or CUDA variant
-docker build -f Dockerfile.cuda -t voicebox:custom-cuda .
-```
-
-## Next Steps
-
-<CardGroup cols={2}>
-  <Card title="API Reference" icon="code" href="/api/overview">
-    Integrate Voicebox into your applications
-  </Card>
-  <Card title="Remote Mode" icon="server" href="/overview/remote-mode">
-    Connect desktop app to Docker backend
-  </Card>
-</CardGroup>

docs/overview/installation.mdx

@@ -5,21 +5,15 @@ description: "Download and install Voicebox on macOS, Windows, or Linux"
 
 ## Download
 
-Voicebox is available for macOS, Windows, and Linux.
+Voicebox is available for macOS and Windows, with Linux builds coming soon.
 
-<CardGroup cols={4}>
+<CardGroup cols={2}>
   <Card title="macOS" icon="apple">
     Download for Apple Silicon or Intel Macs
   </Card>
   <Card title="Windows" icon="windows">
     Download MSI installer or Setup executable
   </Card>
-  <Card title="Linux" icon="linux">
-    Download AppImage or Deb package
-  </Card>
-  <Card title="Docker" icon="docker" href="/overview/docker">
-    Run with web UI in a container
-  </Card>
 </CardGroup>
 
 ### macOS
@@ -66,33 +60,8 @@ Voicebox is available for macOS, Windows, and Linux.
 
 ### Linux
 
-<Tabs>
-  <Tab title="AppImage">
-    Download: [voicebox_x86_64.AppImage](https://github.com/jamiepine/voicebox/releases/latest)
-
-    ```bash
-    # Make executable
-    chmod +x voicebox_x86_64.AppImage
-
-    # Run
-    ./voicebox_x86_64.AppImage
-    ```
-  </Tab>
-  <Tab title="Debian/Ubuntu">
-    Download: [voicebox_amd64.deb](https://github.com/jamiepine/voicebox/releases/latest)
-
-    ```bash
-    # Install
-    sudo dpkg -i voicebox_amd64.deb
-
-    # Run
-    voicebox
-    ```
-  </Tab>
-</Tabs>
-
 <Note>
-  For headless server deployments, use [Docker](/overview/docker) instead of the desktop app.
+  Linux builds are coming soon. Currently blocked by GitHub runner disk space limitations.
 </Note>
 
 ## First Launch

docs/plans/CUDA_BACKEND_SWAP.md

@@ -0,0 +1,581 @@
+# CUDA Backend Swap via Binary Replacement
+
+> Status: Plan | Target: v0.2.0 | Created: 2026-03-12
+
+## Problem
+
+The CUDA PyTorch backend binary is ~2.4 GB. GitHub Releases has a 2 GB asset limit. The current release ships CPU-only PyTorch on Windows and Intel Mac — NVIDIA GPU users get no acceleration from official releases. This is the #1 reported issue category (19 open issues).
+
+Users who want GPU today must clone the repo and run from source. That's not acceptable for a desktop app targeting non-technical users.
+
+## Solution
+
+Ship two backend binaries: a default CPU build (~150 MB) bundled with the app, and a downloadable CUDA build (~2.4 GB) hosted externally. When the user downloads the CUDA build, the app kills the current backend process, swaps in the CUDA binary, and relaunches — a backend-only restart. The frontend stays running, all UI state is preserved.
+
+No subprocesses. No HTTP protocol between processes. No port allocation. No provider manager. The backend is still one monolithic process — just a different binary.
+
+## Architecture
+
+### What Exists Today
+
+```
+Tauri App
+  ├── React Frontend (in-process webview)
+  └── voicebox-server (sidecar subprocess on :17493)
+        └── One PyInstaller binary: CPU PyTorch or MLX
+```
+
+**Sidecar lifecycle** (`tauri/src-tauri/src/main.rs`):
+- `start_server` command spawns `voicebox-server` sidecar (line 181)
+- Binary located at `tauri/src-tauri/binaries/voicebox-server-{platform-triple}`
+- Tauri resolves the sidecar name via `externalBin` in `tauri.conf.json` (line 16)
+- Waits up to 120s for "Uvicorn running" in stdout/stderr (line 286)
+- `stop_server` kills the process tree (line 466)
+
+**Frontend reconnection** (`app/src/lib/hooks/useServer.ts`):
+- Health check polls `GET /health` every 30 seconds
+- React Query cache retains data for 10 minutes after disconnect
+- All UI state (Zustand stores, form data, open tabs) survives disconnection
+- No active reconnect logic — just keeps polling until server responds
+
+This means a backend restart is mostly invisible to the frontend: it sees a few seconds of failed health checks, then the server comes back. The only risk is in-flight operations (generation, transcription) failing mid-request.
+
+### What Changes
+
+```
+Tauri App
+  ├── React Frontend (in-process webview)
+  └── voicebox-server (sidecar subprocess on :17493)
+        └── One of:
+            ├── voicebox-server-cpu     (bundled, ~150 MB)
+            └── voicebox-server-cuda    (downloaded, ~2.4 GB)
+```
+
+The CUDA binary is functionally identical to the CPU binary. Same FastAPI app, same endpoints, same code. The only difference is PyTorch is compiled with CUDA 12.1 support and the binary includes CUDA runtime libraries.
+
+The user downloads it once. On every subsequent app launch, Tauri checks which binary variant exists and spawns the appropriate one.
+
+## Implementation Plan
+
+### Phase 1: Build Infrastructure
+
+Build the CUDA binary in CI separately from the main release.
+
+#### 1a. CUDA PyInstaller Build
+
+Add a `build_binary_cuda.py` or parameterize the existing `build_binary.py`:
+
+```python
+# backend/build_binary.py — add flag
+def build_server(cuda=False):
+    args = [
+        'server.py',
+        '--onefile',
+        '--name', f'voicebox-server-{"cuda" if cuda else "cpu"}',
+    ]
+
+    if cuda:
+        args.extend([
+            '--hidden-import', 'torch.cuda',
+            '--hidden-import', 'torch.backends.cudnn',
+        ])
+    # ... rest of existing build
+```
+
+The `--onefile` flag is already used, which produces a single executable. This is important — `--onedir` would complicate the swap (replacing a directory vs a file).
+
+#### 1b. CI Workflow for CUDA Binary
+
+New workflow: `.github/workflows/build-cuda.yml`
+
+```yaml
+name: Build CUDA Provider
+on:
+  workflow_dispatch:
+  push:
+    tags: ["v*"]
+
+jobs:
+  build-cuda:
+    runs-on: windows-latest  # CUDA is Windows/Linux only
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with: { python-version: "3.12" }
+      - name: Install dependencies
+        run: |
+          pip install pyinstaller
+          pip install -r backend/requirements.txt
+          pip install torch --index-url https://download.pytorch.org/whl/cu121 --force-reinstall
+      - name: Build CUDA binary
+        run: python backend/build_binary.py --cuda
+      - name: Split binary for GitHub Releases
+        run: |
+          python scripts/split_binary.py backend/dist/voicebox-server-cuda.exe \
+            --chunk-size 1900MB \
+            --output release-assets/
+      - name: Upload to R2
+        # Full binary to R2 (no size limit)
+        run: |
+          aws s3 cp backend/dist/voicebox-server-cuda.exe \
+            s3://voicebox-downloads/cuda/v${{ github.ref_name }}/voicebox-server-cuda.exe \
+            --endpoint-url ${{ secrets.R2_ENDPOINT }}
+      - name: Upload split parts to GitHub Release
+        # Split parts as GitHub Release assets (each <2 GB)
+        uses: softprops/action-gh-release@v1
+        with:
+          files: release-assets/*
+```
+
+Two distribution paths for redundancy:
+- **Cloudflare R2**: Full binary, direct download, no size limit.
+- **GitHub Releases**: Split into <2 GB chunks as fallback.
+
+#### 1c. Binary Splitting Script
+
+```python
+# scripts/split_binary.py
+"""Split a large binary into chunks for GitHub Releases."""
+import hashlib
+import argparse
+from pathlib import Path
+
+def split(input_path: Path, chunk_size: int, output_dir: Path):
+    output_dir.mkdir(parents=True, exist_ok=True)
+    data = input_path.read_bytes()
+
+    # Write SHA-256 of the complete file
+    sha256 = hashlib.sha256(data).hexdigest()
+    (output_dir / f"{input_path.stem}.sha256").write_text(
+        f"{sha256}  {input_path.name}\n"
+    )
+
+    # Split into chunks
+    parts = []
+    for i in range(0, len(data), chunk_size):
+        part_name = f"{input_path.stem}.part{len(parts):02d}{input_path.suffix}"
+        part_path = output_dir / part_name
+        part_path.write_bytes(data[i:i + chunk_size])
+        parts.append(part_name)
+
+    # Write manifest
+    (output_dir / f"{input_path.stem}.manifest").write_text(
+        "\n".join(parts) + "\n"
+    )
+
+    print(f"Split into {len(parts)} parts, SHA-256: {sha256}")
+```
+
+### Phase 2: Download & Assemble in App
+
+#### 2a. Backend Download Endpoint
+
+Add to `backend/main.py`:
+
+```python
+@app.post("/backend/download-cuda")
+async def download_cuda_backend():
+    """Download the CUDA backend binary."""
+    # Returns immediately, runs download in background
+    task = asyncio.create_task(_download_cuda_binary())
+    task.add_done_callback(lambda t: logger.error(f"CUDA download failed: {t.exception()}") if t.exception() else None)
+    return {"status": "downloading"}
+
+@app.get("/backend/cuda-status")
+async def cuda_status():
+    """Check if CUDA binary is available."""
+    cuda_path = _get_cuda_binary_path()
+    return {
+        "available": cuda_path is not None and cuda_path.exists(),
+        "active": _is_cuda_active(),
+        "download_progress": progress_manager.get_progress("cuda-backend"),
+    }
+```
+
+#### 2b. Download + Assemble + Verify Logic
+
+New file: `backend/cuda_download.py`
+
+Core logic:
+
+```python
+import hashlib
+from pathlib import Path
+from backend.config import get_data_dir
+from backend.utils.progress import get_progress_manager
+
+CUDA_DOWNLOAD_URL = "https://downloads.voicebox.sh/cuda/{version}/voicebox-server-cuda{ext}"
+CUDA_CHECKSUMS = {
+    # Populated per release
+    "0.2.0-windows": "sha256:abc123...",
+    "0.2.0-linux": "sha256:def456...",
+}
+
+def get_cuda_binary_dir() -> Path:
+    """Where CUDA binaries live. Inside the app's data directory."""
+    return get_data_dir() / "backends"
+
+def get_cuda_binary_path() -> Path | None:
+    """Return path to CUDA binary if it exists and is verified."""
+    d = get_cuda_binary_dir()
+    for name in ["voicebox-server-cuda.exe", "voicebox-server-cuda"]:
+        p = d / name
+        if p.exists():
+            return p
+    return None
+
+async def download_cuda_binary(version: str):
+    """Download, assemble (if split), and verify the CUDA binary."""
+    progress = get_progress_manager()
+    dest_dir = get_cuda_binary_dir()
+    dest_dir.mkdir(parents=True, exist_ok=True)
+
+    ext = ".exe" if sys.platform == "win32" else ""
+    url = CUDA_DOWNLOAD_URL.format(version=version, ext=ext)
+
+    # Download with progress tracking
+    temp_path = dest_dir / f"voicebox-server-cuda{ext}.download"
+    async with httpx.AsyncClient(follow_redirects=True) as client:
+        async with client.stream("GET", url) as response:
+            total = int(response.headers.get("content-length", 0))
+            downloaded = 0
+            with open(temp_path, "wb") as f:
+                async for chunk in response.aiter_bytes(chunk_size=1024 * 1024):
+                    f.write(chunk)
+                    downloaded += len(chunk)
+                    progress.update("cuda-backend", downloaded, total)
+
+    # Verify checksum
+    sha256 = hashlib.sha256(temp_path.read_bytes()).hexdigest()
+    expected = CUDA_CHECKSUMS.get(f"{version}-{sys.platform}")
+    if expected and not expected.endswith(sha256):
+        temp_path.unlink()
+        raise ValueError(f"Checksum mismatch: expected {expected}, got sha256:{sha256}")
+
+    # Atomic move into place
+    final_path = dest_dir / f"voicebox-server-cuda{ext}"
+    temp_path.rename(final_path)
+
+    # Make executable on Unix
+    if sys.platform != "win32":
+        final_path.chmod(0o755)
+
+    progress.complete("cuda-backend")
+```
+
+Key points:
+- Downloads to a `.download` temp file, verifies checksum, then atomically renames. No partial binaries left on crash.
+- Progress tracked via the existing `ProgressManager` so the frontend SSE system works unchanged.
+- CUDA binary lives in the **app data directory** (`data/backends/`), not alongside the app bundle. This avoids code-signing issues on macOS (though CUDA isn't relevant on macOS) and survives app updates.
+
+#### 2c. Reassembly from Split Parts (GitHub Releases Fallback)
+
+If the R2 download fails, fall back to downloading split parts from GitHub Releases:
+
+```python
+async def download_cuda_from_github(version: str):
+    """Fallback: download split parts from GitHub Releases, reassemble."""
+    base_url = f"https://github.com/jamiepine/voicebox/releases/download/v{version}"
+
+    # Get manifest
+    manifest_url = f"{base_url}/voicebox-server-cuda.manifest"
+    async with httpx.AsyncClient(follow_redirects=True) as client:
+        manifest = (await client.get(manifest_url)).text
+        parts = [p.strip() for p in manifest.strip().splitlines()]
+
+        # Download checksum
+        sha256_url = f"{base_url}/voicebox-server-cuda.sha256"
+        expected_sha = (await client.get(sha256_url)).text.split()[0]
+
+        # Download parts
+        dest_dir = get_cuda_binary_dir()
+        dest_dir.mkdir(parents=True, exist_ok=True)
+        temp_path = dest_dir / "voicebox-server-cuda.exe.download"
+
+        total_downloaded = 0
+        with open(temp_path, "wb") as f:
+            for i, part_name in enumerate(parts):
+                part_url = f"{base_url}/{part_name}"
+                async with client.stream("GET", part_url) as response:
+                    async for chunk in response.aiter_bytes(chunk_size=1024 * 1024):
+                        f.write(chunk)
+                        total_downloaded += len(chunk)
+                        get_progress_manager().update(
+                            "cuda-backend", total_downloaded, None,
+                            message=f"Downloading part {i+1}/{len(parts)}"
+                        )
+
+    # Verify reassembled file
+    sha256 = hashlib.sha256(temp_path.read_bytes()).hexdigest()
+    if sha256 != expected_sha:
+        temp_path.unlink()
+        raise ValueError(f"Checksum mismatch after reassembly")
+
+    final_path = dest_dir / "voicebox-server-cuda.exe"
+    temp_path.rename(final_path)
+    get_progress_manager().complete("cuda-backend")
+```
+
+### Phase 3: Backend Restart (The Swap)
+
+This is the core of the feature: kill the CPU backend, launch the CUDA backend, frontend reconnects automatically.
+
+#### 3a. New Tauri Command: `restart_server`
+
+Add to `tauri/src-tauri/src/main.rs`:
+
+```rust
+#[command]
+async fn restart_server(
+    app: tauri::AppHandle,
+    state: State<'_, ServerState>,
+    use_cuda: Option<bool>,
+) -> Result<String, String> {
+    println!("restart_server: use_cuda={:?}", use_cuda);
+
+    // 1. Stop the current server
+    stop_server(state.clone()).await?;
+
+    // 2. Brief wait for port release
+    tokio::time::sleep(tokio::time::Duration::from_millis(500)).await;
+
+    // 3. Start with the appropriate binary
+    // The start_server logic needs to check for CUDA binary
+    start_server(app, state, None).await
+}
+```
+
+#### 3b. Modify `start_server` to Prefer CUDA Binary
+
+The existing `start_server` uses `app.shell().sidecar("voicebox-server")` which resolves via Tauri's `externalBin` config. For the CUDA binary (which lives in the data directory, not the app bundle), we need an alternative launch path.
+
+Modify `start_server` in `main.rs`:
+
+```rust
+// After the existing sidecar logic, before spawning:
+
+// Check for CUDA binary in data directory
+let cuda_binary = data_dir.join("backends")
+    .join(if cfg!(windows) { "voicebox-server-cuda.exe" } else { "voicebox-server-cuda" });
+
+let (mut rx, child) = if cuda_binary.exists() {
+    println!("Found CUDA backend binary at {:?}", cuda_binary);
+
+    // Launch CUDA binary directly (not as Tauri sidecar)
+    let mut cmd = app.shell().command(cuda_binary.to_str().unwrap());
+    cmd = cmd.args([
+        "--data-dir",
+        data_dir.to_str().ok_or("Invalid data dir path")?,
+        "--port",
+        &SERVER_PORT.to_string(),
+    ]);
+    if remote.unwrap_or(false) {
+        cmd = cmd.args(["--host", "0.0.0.0"]);
+    }
+    cmd.spawn().map_err(|e| format!("Failed to spawn CUDA backend: {}", e))?
+} else {
+    // Existing sidecar launch (CPU binary bundled with app)
+    sidecar.spawn().map_err(|e| format!("Failed to spawn: {}", e))?
+};
+```
+
+Key decisions:
+- CUDA binary is launched via `app.shell().command()` (arbitrary path), not `app.shell().sidecar()` (bundled path). Tauri's sidecar system only resolves binaries within the app bundle.
+- The CUDA binary gets the same args (`--data-dir`, `--port`) as the CPU binary. It's the same `server.py` entry point.
+- Preference: if CUDA binary exists, use it. Otherwise fall back to bundled CPU. No user configuration needed.
+
+#### 3c. Frontend: Trigger Restart After Download
+
+Add to the platform lifecycle interface (`app/src/platform/types.ts`):
+
+```typescript
+interface PlatformLifecycle {
+    startServer(remote?: boolean): Promise<string>;
+    stopServer(): Promise<void>;
+    restartServer(useCuda?: boolean): Promise<string>;  // new
+    // ...
+}
+```
+
+Implement in `tauri/src/platform/lifecycle.ts`:
+
+```typescript
+async restartServer(useCuda?: boolean): Promise<string> {
+    const result = await invoke<string>('restart_server', { useCuda });
+    this.onServerReady?.();
+    return result;
+}
+```
+
+#### 3d. Frontend: GPU Settings UI
+
+Add a section to the Server Settings page (or Model Management). Minimal UI:
+
+```
+┌─────────────────────────────────────────────┐
+│  GPU Acceleration                           │
+│                                             │
+│  Status: CPU only (no CUDA backend)         │
+│                                             │
+│  [Download CUDA Backend (2.4 GB)]           │
+│                                             │
+│  Requires an NVIDIA GPU with 4+ GB VRAM.    │
+│  The app will restart its backend process   │
+│  after download. Your work is preserved.    │
+└─────────────────────────────────────────────┘
+```
+
+After download:
+
+```
+┌─────────────────────────────────────────────┐
+│  GPU Acceleration                           │
+│                                             │
+│  Status: ✓ CUDA backend active (RTX 4090)   │
+│                                             │
+│  [Switch to CPU]     [Delete CUDA Backend]  │
+└─────────────────────────────────────────────┘
+```
+
+#### 3e. Frontend: Reconnection During Restart
+
+The current health poll interval is 30 seconds — too slow for a restart UX. During a restart, temporarily increase polling:
+
+```typescript
+// In the component that triggers restart:
+const restart = async () => {
+    setRestarting(true);
+    try {
+        await platform.lifecycle.restartServer(true);
+    } catch (e) {
+        // Frontend will show "reconnecting" state
+    }
+    // Aggressively poll until health check succeeds
+    const interval = setInterval(async () => {
+        try {
+            await apiClient.getHealth();
+            clearInterval(interval);
+            setRestarting(false);
+            queryClient.invalidateQueries(); // Refresh all data
+        } catch {}
+    }, 1000); // Poll every 1s during restart
+    // Safety timeout
+    setTimeout(() => clearInterval(interval), 30000);
+};
+```
+
+### Phase 4: Auto-Detection on Startup
+
+No user action needed on subsequent launches. The preference logic in `start_server` (Phase 3b) handles this:
+
+1. App launches → `start_server` called
+2. Check `data/backends/voicebox-server-cuda{.exe}`
+3. If exists → launch CUDA binary
+4. If not → launch bundled CPU binary
+
+The user downloads CUDA once, and every future app launch (including after updates) uses it automatically. The CUDA binary lives in the data directory, not the app bundle, so app updates don't overwrite it.
+
+### Phase 5: Handling Version Mismatches
+
+When the app updates but the CUDA binary is from an older version, the API might be incompatible. Handle this by:
+
+1. Add `--version` flag to `server.py`:
+
+```python
+parser.add_argument("--version", action="store_true")
+# If invoked with --version, print version and exit
+if args.version:
+    from backend import __version__
+    print(f"voicebox-server {__version__}")
+    sys.exit(0)
+```
+
+2. In `start_server` (Rust), before launching the CUDA binary:
+
+```rust
+// Quick version check
+let version_output = std::process::Command::new(cuda_binary.to_str().unwrap())
+    .arg("--version")
+    .output();
+
+match version_output {
+    Ok(output) => {
+        let version = String::from_utf8_lossy(&output.stdout);
+        let app_version = env!("CARGO_PKG_VERSION");
+        if !version.contains(app_version) {
+            println!("CUDA binary version mismatch (app: {}, cuda: {}), falling back to CPU",
+                app_version, version.trim());
+            // Fall through to CPU sidecar launch
+        }
+    }
+    Err(_) => {
+        println!("Failed to check CUDA binary version, falling back to CPU");
+    }
+}
+```
+
+3. Frontend shows a notification: "Your GPU backend needs an update. [Download latest] or [Use CPU for now]"
+
+## Files Changed
+
+### New Files
+
+| File | Purpose |
+|------|---------|
+| `backend/cuda_download.py` | Download, reassemble, verify CUDA binary |
+| `scripts/split_binary.py` | Split binary into <2 GB chunks for GitHub Releases |
+| `.github/workflows/build-cuda.yml` | CI: build + upload CUDA binary |
+
+### Modified Files
+
+| File | Change |
+|------|--------|
+| `tauri/src-tauri/src/main.rs` | Add `restart_server` command, modify `start_server` to check for CUDA binary in data dir |
+| `backend/server.py` | Add `--version` flag |
+| `backend/main.py` | Add `/backend/download-cuda`, `/backend/cuda-status`, `/backend/progress/cuda-backend` endpoints |
+| `backend/build_binary.py` | Accept `--cuda` flag to build CUDA variant |
+| `app/src/platform/types.ts` | Add `restartServer` to lifecycle interface |
+| `tauri/src/platform/lifecycle.ts` | Implement `restartServer` |
+| `app/src/components/ServerSettings/` | New GPU acceleration section |
+| `.github/workflows/release.yml` | Trigger CUDA build workflow on tag |
+
+### NOT Changed
+
+| File | Why |
+|------|-----|
+| `backend/backends/__init__.py` | No changes to the TTSBackend singleton or factory. CUDA binary runs the same code. |
+| `backend/backends/pytorch_backend.py` | Already detects CUDA at runtime (line 28-49). No changes needed. |
+| `app/src/lib/api/client.ts` | API is identical between CPU and CUDA backends. |
+| `app/src/lib/hooks/useGenerationForm.ts` | Generation flow is unchanged. |
+
+## What This Doesn't Solve
+
+- **Multi-model support** — This is purely about GPU acceleration. LuxTTS, Chatterbox, etc. need the in-process model registry, which is an independent workstream.
+- **AMD GPU support** — DirectML/ROCm needs a different PyTorch build. Same pattern applies (another binary variant) but deferred.
+- **Linux CUDA** — Same approach works, just another CI matrix entry. Can be added in the same release or shortly after.
+- **Remote server mode** — Users who want to run TTS on a different machine still need the external provider architecture. Separate concern.
+
+## What This DOES Solve
+
+- **19 "GPU not detected" issues** — Users download the CUDA backend, restart, GPU works.
+- **2 GB GitHub Release limit** — Binary splitting + R2 hosting.
+- **Update burden** — App updates don't re-download the 2.4 GB CUDA binary. It persists in the data directory.
+- **First-run experience** — App works immediately on CPU. GPU is an optional enhancement, not a setup blocker.
+
+## Rollout Plan
+
+1. Build and test CUDA binary locally on Windows with an NVIDIA GPU.
+2. Set up R2 bucket at `downloads.voicebox.sh/cuda/`.
+3. Ship the backend restart + download UI in v0.2.0.
+4. Announce: "GPU acceleration is here — one click in Settings."
+
+## Risks
+
+| Risk | Mitigation |
+|------|-----------|
+| CUDA binary doesn't work on some GPU/driver combos | `/health` endpoint reports GPU info. Fallback to CPU if CUDA init fails. Clear error message. |
+| Antivirus flags downloaded binary (Windows) | Code-sign the CUDA binary in CI. Document AV exceptions. |
+| Data dir CUDA binary survives app uninstall | Document in uninstall notes. Not a real problem — it's just a file. |
+| Version mismatch after app update | Version check on startup (Phase 5). Auto-fallback to CPU. Prompt to re-download. |
+| R2 downtime | GitHub Releases split-binary fallback. |
+| Download interrupted | Temp file with `.download` extension. Atomic rename on completion. Resume not implemented in v1 — restart download from scratch. |

docs/plans/CUDA_BACKEND_SWAP_FINAL.md

@@ -0,0 +1,133 @@
+# CUDA Backend Swap — Implementation Summary
+
+> Status: **Complete** | Branch: `feat/cuda-backend-swap` | Created: 2026-03-12
+
+## What This Is
+
+A standalone feature that lets users download a CUDA-enabled backend binary (~2.4 GB) and swap it in via a backend-only restart. The frontend stays running, all UI state is preserved. This solves the #1 user pain point: 19 open issues about "GPU not detected" caused by GitHub's 2 GB release asset limit preventing CUDA binaries from shipping in official releases.
+
+## How It Works
+
+```
+User clicks "Download CUDA Backend" in Settings
+  → Backend fetches manifest from GitHub Releases
+  → Downloads split parts (<2 GB each), concatenates them
+  → SHA-256 integrity check on reassembled binary
+  → Binary placed in {app_data_dir}/backends/voicebox-server-cuda
+  → User clicks "Switch to CUDA Backend"
+  → Tauri kills CPU process, launches CUDA binary, frontend reconnects
+  → On all future app launches, CUDA binary is auto-detected and used
+```
+
+The CUDA binary is functionally identical to the CPU binary — same FastAPI app, same endpoints, same code. The only difference is PyTorch compiled with CUDA 12.1 and bundled CUDA runtime libraries.
+
+## Architecture Decisions
+
+**Backend-only restart, not full app restart.** The Tauri shell kills the current `voicebox-server` process, waits 1 second for port release, and spawns the new binary. The React frontend stays running. Health polling detects the new backend within seconds.
+
+**No provider/subprocess architecture.** This is explicitly not the PR #33 approach (10K+ lines, 136 files, 22 bugs). One process at a time. The CUDA binary replaces the CPU binary — it doesn't run alongside it.
+
+**Data directory, not app bundle.** The CUDA binary lives in `{app_data_dir}/backends/`, which persists across app updates and avoids code-signing issues. The bundled CPU binary in the app bundle is untouched.
+
+**Version mismatch protection.** On startup, Rust runs `voicebox-server-cuda --version` and compares to the app version from `tauri.conf.json`. If they don't match (e.g., after an app update), it falls back to the bundled CPU binary silently.
+
+**GitHub Releases distribution.** The CUDA binary is split into <2 GB chunks (GitHub's asset limit) via `scripts/split_binary.py`. The app downloads a manifest, fetches each part, concatenates them, and runs a SHA-256 integrity check to verify reassembly. No external hosting needed.
+
+## Files Changed
+
+### New Files
+
+| File | Lines | Purpose |
+|------|-------|---------|
+| `backend/cuda_download.py` | ~190 | Download split parts from GitHub Releases, reassemble, verify integrity |
+| `scripts/split_binary.py` | ~80 | Split large binary into <2 GB chunks with SHA-256 manifest |
+| `.github/workflows/build-cuda.yml` | ~70 | CI workflow: build CUDA binary, split, upload to GitHub Releases |
+| `app/src/components/ServerSettings/GpuAcceleration.tsx` | 371 | GPU Acceleration UI card (status, download, restart, delete) |
+| `docs/plans/CUDA_BACKEND_SWAP.md` | 581 | Original implementation plan (5 phases with code sketches) |
+| `docs/plans/CUDA_BACKEND_SWAP_FINAL.md` | this file | Final implementation summary |
+| `docs/plans/PROJECT_STATUS.md` | 462 | Full project triage (all PRs, issues, architecture) |
+| `docs/plans/PR33_CUDA_PROVIDER_REVIEW.md` | ~350 | Detailed code review of PR #33 (22 bugs documented) |
+
+### Modified Files
+
+| File | What Changed |
+|------|-------------|
+| `backend/build_binary.py` | Added `--cuda` flag, parameterized output binary name |
+| `backend/server.py` | Added `--version` flag, auto-detect backend variant from binary name (`VOICEBOX_BACKEND_VARIANT` env var) |
+| `backend/main.py` | 4 new endpoints (`/backend/cuda-status`, `/backend/download-cuda`, `/backend/cuda`, `/backend/cuda-progress`), health endpoint returns `backend_variant` |
+| `backend/models.py` | `HealthResponse` model: added `backend_variant` field |
+| `backend/requirements.txt` | Added `httpx>=0.27.0` for async HTTP downloads |
+| `tauri/src-tauri/src/main.rs` | `restart_server` command (stop → wait → start), `start_server` checks for CUDA binary in data dir and launches via `shell().command()`, version mismatch check |
+| `app/src/platform/types.ts` | `PlatformLifecycle.restartServer()` added |
+| `tauri/src/platform/lifecycle.ts` | `restartServer()` implementation via `invoke('restart_server')` |
+| `web/src/platform/lifecycle.ts` | `restartServer()` noop for web platform |
+| `app/src/lib/api/types.ts` | `CudaStatus`, `CudaDownloadProgress` interfaces; `HealthResponse` updated with `gpu_type`, `backend_type`, `backend_variant` |
+| `app/src/lib/api/client.ts` | `getCudaStatus()`, `downloadCudaBackend()`, `deleteCudaBackend()` methods |
+| `app/src/components/ServerTab/ServerTab.tsx` | Wired in `<GpuAcceleration />` component (Tauri-only) |
+
+## Backend API Endpoints
+
+| Method | Path | Purpose |
+|--------|------|---------|
+| `GET` | `/backend/cuda-status` | Returns `{ available, active, binary_path, downloading, download_progress }` |
+| `POST` | `/backend/download-cuda` | Starts background download; returns immediately. Track via SSE. |
+| `DELETE` | `/backend/cuda` | Deletes CUDA binary (blocked if CUDA is currently active) |
+| `GET` | `/backend/cuda-progress` | SSE stream of download progress (reuses existing `ProgressManager`) |
+
+The existing `GET /health` endpoint now returns two new fields:
+- `backend_type`: `"pytorch"` or `"mlx"` (existing detection)
+- `backend_variant`: `"cpu"` or `"cuda"` (set from `VOICEBOX_BACKEND_VARIANT` env var)
+
+## Frontend UI States
+
+The `GpuAcceleration` card in Server Settings handles these states:
+
+1. **Native GPU detected** (MPS, MLX, XPU, DirectML) — Shows info message, no download needed
+2. **No CUDA binary** — Download button with size estimate, description of requirements
+3. **Downloading** — SSE-driven progress bar with bytes/total and percentage
+4. **Downloaded, not active** — "Switch to CUDA Backend" button + "Remove" option
+5. **CUDA active** — Shows CUDA badge, "Switch to CPU Backend" button
+6. **Restarting** — Spinner with phase text, 1s health polling as safety net
+7. **Error** — Red error message with details
+
+### Key UX detail: switching to CPU
+
+Since `start_server` always prefers the CUDA binary if it exists on disk, "Switch to CPU" must delete the CUDA binary first, then restart. The user can re-download later. This avoids a persistent configuration mechanism (no new state to manage, no new config file, no DB column).
+
+## Rust: Server Lifecycle
+
+```
+start_server
+  ├── Check for CUDA binary at {data_dir}/backends/voicebox-server-cuda
+  ├── If found: run --version, compare to app version
+  │   ├── Match: launch via shell().command() with --data-dir, --port
+  │   └── Mismatch: log warning, fall through to CPU
+  └── Else: launch bundled sidecar via shell().sidecar()
+
+restart_server
+  ├── stop_server (kill process tree)
+  ├── wait 1 second for port release
+  └── start_server (auto-detects CUDA)
+```
+
+## What This Doesn't Cover
+
+- **AMD GPU / ROCm / DirectML binary** — Same pattern, different PyTorch build. Future PR.
+- **Linux CUDA** — Same approach, just another CI matrix entry. Can ship same release.
+- **Multi-model support** — LuxTTS, Chatterbox, etc. are a separate architectural concern (in-process model registry). Independent of binary variant.
+- **Download resume** — If download is interrupted, it restarts from scratch. Acceptable for v1.
+- **Remote server CUDA** — Users running voicebox-server on a remote machine manage their own binaries. This feature is for the desktop app.
+
+## Testing Checklist
+
+- [ ] Build CUDA binary locally with `python backend/build_binary.py --cuda`
+- [ ] `voicebox-server-cuda --version` prints correct version
+- [ ] Place CUDA binary in `{data_dir}/backends/`, launch app → auto-detects and uses it
+- [ ] Version mismatch: rename binary to have wrong version → falls back to CPU
+- [ ] Frontend: GpuAcceleration card shows correct state for CPU, CUDA available, CUDA active
+- [ ] Download flow: POST triggers download, SSE progress works, completion updates status
+- [ ] Switch to CUDA: restart works, health endpoint shows `backend_variant: "cuda"`
+- [ ] Switch to CPU: deletes binary, restarts, health shows `backend_variant: "cpu"`
+- [ ] Delete CUDA while active: returns 409 error
+- [ ] Split binary script: `python scripts/split_binary.py` creates manifest + parts + sha256
+- [ ] Native GPU (macOS MPS): shows info message, no download section

docs/plans/DOCKER_DEPLOYMENT.md

@@ -1,31 +1,24 @@
 # Docker Deployment Guide
 
-**Status:** Implemented
-**Images:** `ghcr.io/jamiepine/voicebox`
+**Status:** In Development for v0.2.0
+**Requested By:** Reddit community ([thread](https://reddit.com/r/LocalLLaMA/...))
 
 ## Overview
 
-Voicebox is available as Docker images with the full web UI included. Images are automatically built and published to GitHub Container Registry on each release.
+Docker support makes Voicebox easier to deploy, especially for:
 
-**What's included:**
-- FastAPI backend with all TTS/Whisper capabilities
-- Complete web UI (same React app as the Tauri desktop version)
-- Provider download system (downloads TTS providers on first use, just like desktop)
-- Multi-architecture support (amd64, arm64 for CPU variant)
-
-Docker support is ideal for:
-- **Server Deployments**: Run on headless Linux servers
-- **GPU Passthrough**: Easy NVIDIA GPU access
 - **Consistent Environments**: Same setup across dev/staging/prod
-- **Cloud Platforms**: Deploy to AWS, GCP, Azure, DigitalOcean
+- **GPU Passthrough**: Easy NVIDIA/AMD GPU access
+- **Server Deployments**: Run on headless Linux servers
 - **Multi-User Setups**: Isolate instances per user/team
+- **Cloud Platforms**: Deploy to AWS, GCP, Azure, DigitalOcean
 
 ## Quick Start
 
 ### Using Pre-Built Images (Recommended)
 
 ```bash
-# CPU-only version (supports amd64 and arm64)
+# CPU-only version
 docker run -p 8000:8000 -v voicebox-data:/app/data \
   ghcr.io/jamiepine/voicebox:latest
 
@@ -33,80 +26,184 @@ docker run -p 8000:8000 -v voicebox-data:/app/data \
 docker run --gpus all -p 8000:8000 -v voicebox-data:/app/data \
   ghcr.io/jamiepine/voicebox:latest-cuda
 
-# Specific version (pinned for stability)
-docker run -p 8000:8000 -v voicebox-data:/app/data \
-  ghcr.io/jamiepine/voicebox:0.1.13
+# AMD GPU version (experimental)
+docker run --device=/dev/kfd --device=/dev/dri -p 8000:8000 \
+  -v voicebox-data:/app/data \
+  ghcr.io/jamiepine/voicebox:latest-rocm
 ```
 
 Then open: `http://localhost:8000`
 
-The web UI will load automatically. On first use, you'll be prompted to download a TTS provider (PyTorch CPU ~300MB or PyTorch CUDA ~2.4GB).
-
 ### Using Docker Compose (Easiest)
 
-Use the provided `docker-compose.yml` (CUDA) or `docker-compose.cpu.yml` in the repository root:
+Create `docker-compose.yml`:
 
-```bash
-# CUDA (default)
-docker compose up -d
-
-# Or CPU-only
-docker compose -f docker-compose.cpu.yml up -d
-```
-
-To pin to a specific version, edit the compose file:
 ```yaml
+version: '3.8'
+
 services:
   voicebox:
-    image: ghcr.io/jamiepine/voicebox:0.1.13-cuda  # Pinned version
+    image: ghcr.io/jamiepine/voicebox:latest-cuda
+    ports:
+      - "8000:8000"
+    volumes:
+      - voicebox-data:/app/data
+      - huggingface-cache:/root/.cache/huggingface
+    environment:
+      - GPU_MEMORY_FRACTION=0.8  # Use 80% of GPU memory
+      - TTS_MODE=local
+      - WHISPER_MODE=local
+    deploy:
+      resources:
+        reservations:
+          devices:
+            - driver: nvidia
+              count: 1
+              capabilities: [gpu]
+
+volumes:
+  voicebox-data:
+  huggingface-cache:
+```
+
+Run:
+```bash
+docker compose up -d
 ```
 
 ## Building From Source
 
-See `Dockerfile` and `Dockerfile.cuda` in the repository root.
+### Basic Dockerfile
+
+```dockerfile
+# Dockerfile
+FROM python:3.11-slim
+
+WORKDIR /app
+
+# Install system dependencies
+RUN apt-get update && apt-get install -y \
+    git \
+    build-essential \
+    ffmpeg \
+    && rm -rf /var/lib/apt/lists/*
+
+# Copy application
+COPY backend/ /app/backend/
+COPY requirements.txt /app/
+
+# Install Python dependencies
+RUN pip install --no-cache-dir -r requirements.txt
+RUN pip install --no-cache-dir git+https://github.com/QwenLM/Qwen3-TTS.git
+
+# Create data directory
+RUN mkdir -p /app/data
+
+# Expose port
+EXPOSE 8000
+
+# Run server
+CMD ["uvicorn", "backend.main:app", "--host", "0.0.0.0", "--port", "8000"]
+```
 
 Build and run:
 ```bash
-# Build web UI first
-bun install
-cd web && bun run build && cd ..
-
-# Build CPU image
 docker build -t voicebox .
-docker run -p 8000:8000 -v voicebox-data:/app/data voicebox
-
-# Or build CUDA image
-docker build -f Dockerfile.cuda -t voicebox:cuda .
-docker run --gpus all -p 8000:8000 -v voicebox-data:/app/data voicebox:cuda
+docker run -p 8000:8000 -v $(pwd)/data:/app/data voicebox
 ```
 
-### Architecture
+### Multi-Stage Build (Optimized)
 
-The Docker images include:
-- **Backend**: FastAPI server with TTS/Whisper endpoints
-- **Web UI**: Pre-built React app served as static files from the backend
-- **Provider System**: Downloads PyTorch CPU/CUDA providers on first use (same UX as desktop app)
+Smaller image size by separating build and runtime:
 
-Images are automatically built on release and tagged with both version number and `latest`.
+```dockerfile
+# Dockerfile.optimized
+# Stage 1: Build dependencies
+FROM python:3.11-slim AS builder
+
+WORKDIR /build
+
+RUN apt-get update && apt-get install -y \
+    git build-essential && \
+    rm -rf /var/lib/apt/lists/*
+
+COPY backend/requirements.txt .
+RUN pip install --no-cache-dir --target=/build/packages \
+    -r requirements.txt
+
+RUN pip install --no-cache-dir --target=/build/packages \
+    git+https://github.com/QwenLM/Qwen3-TTS.git
+
+# Stage 2: Runtime
+FROM python:3.11-slim
+
+WORKDIR /app
+
+# Install only runtime dependencies
+RUN apt-get update && apt-get install -y \
+    ffmpeg \
+    && rm -rf /var/lib/apt/lists/*
+
+# Copy installed packages from builder
+COPY --from=builder /build/packages /usr/local/lib/python3.11/site-packages/
+
+# Copy application code
+COPY backend/ /app/backend/
+
+# Create data directory
+RUN mkdir -p /app/data
+
+EXPOSE 8000
+
+CMD ["uvicorn", "backend.main:app", "--host", "0.0.0.0", "--port", "8000"]
+```
+
+Build:
+```bash
+docker build -f Dockerfile.optimized -t voicebox:slim .
+```
 
 ## GPU Support
 
 ### NVIDIA GPUs (CUDA)
 
-The CUDA image includes PyTorch with CUDA 12.1 support:
+**Dockerfile:**
+```dockerfile
+FROM nvidia/cuda:12.1.0-runtime-ubuntu22.04
+
+# Install Python
+RUN apt-get update && apt-get install -y \
+    python3.11 python3-pip git ffmpeg && \
+    rm -rf /var/lib/apt/lists/*
+
+WORKDIR /app
+
+# Install PyTorch with CUDA support
+COPY backend/requirements.txt .
+RUN pip3 install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu121
+
+# Install other dependencies
+RUN pip3 install -r requirements.txt
+RUN pip3 install git+https://github.com/QwenLM/Qwen3-TTS.git
+
+COPY backend/ /app/backend/
+
+EXPOSE 8000
+CMD ["uvicorn", "backend.main:app", "--host", "0.0.0.0", "--port", "8000"]
+```
 
 **Run with GPU:**
 ```bash
 docker run --gpus all -p 8000:8000 \
   -v voicebox-data:/app/data \
-  ghcr.io/jamiepine/voicebox:latest-cuda
+  voicebox:cuda
 ```
 
 **Docker Compose with GPU:**
 ```yaml
 services:
   voicebox:
-    image: ghcr.io/jamiepine/voicebox:latest-cuda
+    image: voicebox:cuda
     deploy:
       resources:
         reservations:
@@ -116,9 +213,47 @@ services:
               capabilities: [gpu]
 ```
 
-### AMD GPUs (ROCm)
+### AMD GPUs (ROCm) - Experimental
 
-ROCm support is not currently available in pre-built images. If you need ROCm, build a custom image using the ROCm base and PyTorch ROCm builds.
+**Dockerfile:**
+```dockerfile
+FROM rocm/dev-ubuntu-22.04:6.0
+
+# Install Python
+RUN apt-get update && apt-get install -y \
+    python3.11 python3-pip git ffmpeg && \
+    rm -rf /var/lib/apt/lists/*
+
+WORKDIR /app
+
+# Install PyTorch with ROCm support
+COPY backend/requirements.txt .
+RUN pip3 install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/rocm6.0
+
+# Install other dependencies
+RUN pip3 install -r requirements.txt
+RUN pip3 install git+https://github.com/QwenLM/Qwen3-TTS.git
+
+# Set ROCm environment variables
+ENV HSA_OVERRIDE_GFX_VERSION=10.3.0
+ENV ROCM_PATH=/opt/rocm
+
+COPY backend/ /app/backend/
+
+EXPOSE 8000
+CMD ["uvicorn", "backend.main:app", "--host", "0.0.0.0", "--port", "8000"]
+```
+
+**Run with AMD GPU:**
+```bash
+docker run --device=/dev/kfd --device=/dev/dri \
+  --group-add video --ipc=host --cap-add=SYS_PTRACE \
+  --security-opt seccomp=unconfined \
+  -p 8000:8000 -v voicebox-data:/app/data \
+  voicebox:rocm
+```
+
+**Note:** ROCm support varies by GPU model. Works best on Linux. See [AMD ROCm docs](https://rocm.docs.amd.com) for compatibility.
 
 ## Volume Mounts
 
@@ -599,27 +734,13 @@ docker logs -f voicebox
 docker compose logs -f voicebox
 ```
 
-## Updates
+## Next Steps
 
-Docker images are automatically built and published on each GitHub release. To update:
-
-```bash
-# Pull latest
-docker pull ghcr.io/jamiepine/voicebox:latest
-docker compose up -d
-
-# Or pin to a specific version
-docker pull ghcr.io/jamiepine/voicebox:0.1.13
-```
-
-For automatic updates, use [Watchtower](https://containrrr.dev/watchtower/).
-
-## Future Enhancements
-
-- Kubernetes Helm charts
-- Docker Desktop extension
-- Automated vulnerability scanning
-- ROCm image variant
+- [ ] Publish official images to GitHub Container Registry
+- [ ] Add Kubernetes Helm charts
+- [ ] Create Docker Desktop extension
+- [ ] Add automated vulnerability scanning
+- [ ] Support ARM64 builds for Raspberry Pi / Apple Silicon
 
 ## Contributing
 

docs/plans/PR33_CUDA_PROVIDER_REVIEW.md

@@ -0,0 +1,500 @@
+# PR #33 — CUDA Provider System Review
+
+> Branch: `external-provider-binaries` | Created: 2026-02-01 | 34 commits, 136 files, +10,266 lines
+> Reviewed: 2026-03-12
+
+---
+
+## The Problem
+
+The CUDA PyTorch binary is ~2.4 GB. GitHub Releases has a 2 GB artifact limit. This means:
+
+- Windows/Linux users with NVIDIA GPUs cannot get GPU acceleration from official releases
+- 19 open issues about "GPU not detected" — the single most reported problem category
+- Users who want GPU must clone the repo and run from source
+- Every app update forces re-download of the entire binary
+
+This is the #1 user pain point by volume.
+
+---
+
+## What PR #33 Does
+
+Splits the monolithic Voicebox binary into two layers:
+
+```
+┌──────────────────────────────────────┐
+│  Main App (~150MB Win/Lin, ~300 Mac) │
+│  Tauri + React + FastAPI + Whisper   │
+│  No PyTorch. MLX bundled on macOS.   │
+├──────────────────────────────────────┤
+│           HTTP (localhost)           │
+├──────────────────────────────────────┤
+│  Provider Binary (downloaded later)  │
+│  PyTorch CPU (~300MB)                │
+│  PyTorch CUDA (~2.4GB)              │
+│  Hosted on Cloudflare R2             │
+└──────────────────────────────────────┘
+```
+
+### New Backend Code
+
+| File | Purpose |
+|------|---------|
+| `backend/providers/__init__.py` (327 lines) | `ProviderManager` — lifecycle management, subprocess spawning, port allocation |
+| `backend/providers/base.py` (97 lines) | `TTSProvider` Protocol definition |
+| `backend/providers/bundled.py` (144 lines) | `BundledProvider` — wraps existing MLX/PyTorch backends for the new interface |
+| `backend/providers/local.py` (191 lines) | `LocalProvider` — HTTP client that talks to external provider processes |
+| `backend/providers/installer.py` (262 lines) | Download, extract, delete provider binaries |
+| `backend/providers/types.py` (34 lines) | `ProviderType` enum, `ProviderInfo` dataclass |
+| `backend/providers/checksums.py` (11 lines) | Checksum dict (currently empty) |
+
+### Provider Servers (Standalone Executables)
+
+| File | Purpose |
+|------|---------|
+| `providers/pytorch-cpu/main.py` (238 lines) | FastAPI server wrapping PyTorch CPU inference |
+| `providers/pytorch-cuda/main.py` (238 lines) | FastAPI server wrapping PyTorch CUDA inference |
+| `providers/pytorch-*/build.py` | PyInstaller build scripts |
+| `providers/pytorch-*/requirements.txt` | Isolated dependencies |
+
+### Frontend
+
+| File | Purpose |
+|------|---------|
+| `app/src/components/ServerSettings/ProviderSettings.tsx` (400 lines) | Provider download/start/stop/delete UI |
+
+### Also Included (Scope Creep)
+
+The PR bundles several unrelated changes that inflate the diff:
+
+- `docs2/` — Entire documentation site rewrite (Fumadocs migration, ~3000 lines)
+- `Dockerfile`, `Dockerfile.cuda`, `docker-compose.yml` — Docker support
+- `landing/` — Banner removal
+- UI refactors in Stories, History, Voice Profiles, Audio tab
+- Linux audio capture module
+- Various dependency bumps
+
+---
+
+## Bug Report
+
+### Critical — Will Crash at Runtime
+
+#### C1. Provider `generate` endpoint can't parse requests
+
+**`providers/pytorch-cpu/main.py:91-97`** (same in pytorch-cuda)
+
+```python
+@app.post("/tts/generate")
+async def generate(
+    text: str,
+    voice_prompt: dict,
+    language: str = "auto",
+    seed: int = None,
+    model_size: str = "1.7B"
+):
+```
+
+Parameters declared as function arguments. FastAPI interprets these as **query parameters**, not JSON body. But `LocalProvider.generate()` sends a JSON body via `httpx`:
+
+```python
+# backend/providers/local.py:33-40
+response = await self.client.post("/tts/generate", json={
+    "text": text,
+    "voice_prompt": voice_prompt,
+    ...
+})
+```
+
+**Result:** Every generation call to an external provider returns HTTP 422 (Validation Error). The generation path is completely broken for external providers.
+
+**Fix:** Use a Pydantic request body model:
+```python
+class GenerateRequest(BaseModel):
+    text: str
+    voice_prompt: dict
+    language: str = "auto"
+    seed: Optional[int] = None
+    model_size: str = "1.7B"
+
+@app.post("/tts/generate")
+async def generate(data: GenerateRequest):
+```
+
+#### C2. Timeout error handler references undefined variables
+
+**`backend/providers/__init__.py:82-90`**
+
+```python
+stdout_content = ""
+stderr_content = ""
+# ... threads write to stdout_queue / stderr_queue ...
+except TimeoutError:
+    while not stdout_queue.empty():
+        stdout_lines.append(stdout_queue.get_nowait())  # NameError
+    while not stderr_queue.empty():
+        stderr_lines.append(stderr_queue.get_nowait())  # NameError
+```
+
+`stdout_lines` and `stderr_lines` are never defined. Every provider startup timeout will throw `NameError`, masking the real failure cause. Then `stdout_content` and `stderr_content` are logged but they're still empty strings — the queue data is never assigned back.
+
+#### C3. Sync `get_tts_model()` ignores external provider in async context
+
+**`backend/tts.py:15-29`**
+
+```python
+def get_tts_model():
+    manager = get_provider_manager()
+    loop = asyncio.get_event_loop()
+    if loop.is_running():
+        # We're in an async context, but can't await here
+        return manager._get_default_provider()
+```
+
+FastAPI routes are async. This function is called from several code paths during generation. In async context it **always returns the bundled provider**, ignoring whatever external provider the user selected. The user downloads and starts a CUDA provider, but generation still runs on CPU.
+
+### Critical — Security
+
+#### C4. Path traversal via `tarfile.extractall()` (CVE-2007-4559)
+
+**`backend/providers/installer.py:115-118`**
+
+```python
+with tarfile.open(archive_path, 'r:gz') as tar_ref:
+    tar_ref.extractall(providers_dir)
+```
+
+No member path filtering. A crafted `.tar.gz` from a compromised CDN can write files anywhere on disk via `../` entries. Python 3.12+ emits a deprecation warning for exactly this pattern.
+
+**Fix:**
+```python
+tar_ref.extractall(providers_dir, filter='data')  # Python 3.12+
+```
+
+Or manually validate each member:
+```python
+for member in tar_ref.getmembers():
+    member_path = os.path.join(providers_dir, member.name)
+    if not os.path.commonpath([providers_dir, member_path]).startswith(str(providers_dir)):
+        raise ValueError(f"Path traversal attempt: {member.name}")
+tar_ref.extractall(providers_dir)
+```
+
+#### C5. No checksum verification on downloaded binaries
+
+**`backend/providers/checksums.py`**
+
+```python
+PROVIDER_CHECKSUMS = {}
+```
+
+Empty dict. `download_provider()` in `installer.py` never calls any verification function. Downloaded binaries are `chmod 0o755`'d and executed without integrity checks. A MitM or CDN compromise delivers arbitrary code.
+
+**Fix:** Populate checksums per release. Verify SHA-256 after download before extraction:
+```python
+import hashlib
+sha256 = hashlib.sha256(archive_path.read_bytes()).hexdigest()
+if sha256 != expected:
+    archive_path.unlink()
+    raise ValueError(f"Checksum mismatch for {provider_type}")
+```
+
+#### C6. Provider servers have no authentication
+
+**`providers/pytorch-cpu/main.py:18-23`**
+
+```python
+app.add_middleware(
+    CORSMiddleware,
+    allow_origins=["*"],
+    ...
+)
+```
+
+Zero auth. Any local process — including browser JavaScript via localhost — can send requests to the provider on its ephemeral port. Port is discoverable by scanning.
+
+**Fix:** Generate a random token in the parent process, pass via environment variable to the child, validate in middleware:
+```python
+# Parent (ProviderManager)
+token = secrets.token_urlsafe(32)
+env = {**os.environ, "VOICEBOX_PROVIDER_TOKEN": token}
+process = subprocess.Popen([...], env=env, ...)
+
+# Child (provider server)
+EXPECTED_TOKEN = os.environ.get("VOICEBOX_PROVIDER_TOKEN")
+
+@app.middleware("http")
+async def verify_token(request, call_next):
+    if request.headers.get("X-Provider-Token") != EXPECTED_TOKEN:
+        return JSONResponse(status_code=403, content={"error": "unauthorized"})
+    return await call_next(request)
+```
+
+### Major — Will Cause Problems in Production
+
+#### M1. Leaked file handles on subprocess stdout/stderr
+
+**`backend/providers/__init__.py:68-73`**
+
+```python
+process = subprocess.Popen(
+    [...],
+    stdout=open(stdout_log, 'w'),   # leaked handle
+    stderr=open(stderr_log, 'w'),   # leaked handle
+)
+```
+
+File handles passed directly from `open()` without storing references. They close on GC, not deterministically. On Windows the log files stay locked and unreadable until the process exits.
+
+**Fix:**
+```python
+stdout_fh = open(stdout_log, 'w')
+stderr_fh = open(stderr_log, 'w')
+try:
+    process = subprocess.Popen([...], stdout=stdout_fh, stderr=stderr_fh)
+finally:
+    stdout_fh.close()
+    stderr_fh.close()
+```
+
+#### M2. No subprocess crash detection or recovery
+
+**`backend/providers/__init__.py:56-110`**
+
+Once `start_provider()` succeeds, the `Popen` object is stored but never polled. If the provider process crashes mid-session:
+- `LocalProvider` HTTP calls fail with `httpx.ConnectError`
+- No auto-restart
+- No health-check loop
+- User sees cryptic "connection refused" errors
+- Must manually restart provider from UI
+
+**Fix:** Background asyncio task that polls `process.poll()` every few seconds. On crash, update provider status and optionally auto-restart:
+```python
+async def _watch_provider_process(self):
+    while self._provider_process and self._provider_process.poll() is None:
+        await asyncio.sleep(5)
+    if self._provider_process and self._provider_process.returncode != 0:
+        logger.error(f"Provider crashed with code {self._provider_process.returncode}")
+        self.active_provider = self._default_provider
+        # Notify frontend via next health check
+```
+
+#### M3. Port allocation race condition (TOCTOU)
+
+**`backend/providers/__init__.py:145-149`**
+
+```python
+def _get_free_port(self) -> int:
+    with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
+        s.bind(('', 0))
+        return s.getsockname()[1]
+    # Socket closed here — port is free but unprotected
+```
+
+Between this function returning and the provider process binding, another process can claim the port. On busy systems this causes "address already in use" failures.
+
+**Fix options:**
+- Pass the socket fd to the child process (complex, platform-specific)
+- Retry with a new port on bind failure (simplest)
+- Use a fixed port range and try sequentially
+
+#### M4. `delete_provider()` leaves hundreds of MB behind
+
+**`backend/providers/installer.py:155-168`**
+
+```python
+provider_path.unlink()  # Deletes just the executable
+```
+
+PyInstaller `--onedir` produces a directory with the executable plus all shared libraries. `unlink()` only removes the binary file, leaving behind hundreds of MB of `.so`/`.dll`/`.dylib` files.
+
+**Fix:**
+```python
+provider_dir = provider_path.parent
+shutil.rmtree(provider_dir)
+```
+
+#### M5. `LocalProvider.combine_voice_prompts()` bypasses the provider
+
+**`backend/providers/local.py:68-88`**
+
+This method imports from `..utils.audio` and processes locally instead of sending to the provider server. If the user chose an external provider because they lack local dependencies (e.g., no PyTorch on the machine), this will crash with `ImportError`.
+
+#### M6. Download errors silently swallowed
+
+**`backend/main.py:1640`**
+
+```python
+asyncio.create_task(download_provider(provider_type))
+```
+
+Fire-and-forget. If the download fails, the exception is logged as "Task exception was never retrieved." The frontend SSE progress stream may hang forever showing "downloading" without the error.
+
+**Fix:** Store the task, add an error callback:
+```python
+task = asyncio.create_task(download_provider(provider_type))
+task.add_done_callback(lambda t: t.exception() if not t.cancelled() else None)
+```
+And propagate errors through the progress manager so the SSE stream surfaces them.
+
+#### M7. `LocalProvider.is_loaded()` always returns `True`
+
+**`backend/providers/local.py:105-108`**
+
+```python
+def is_loaded(self) -> bool:
+    return True  # Return True optimistically
+```
+
+Health/status checks always report the model as loaded for external providers, even when the provider hasn't loaded anything yet. This breaks the "download model if not cached" logic in the generation flow.
+
+#### M8. `instruct` parameter silently dropped
+
+**`backend/providers/local.py:33-40`**
+
+The `generate()` method accepts `instruct` but never includes it in the JSON payload. The provider server also hardcodes `instruct=None`. Delivery instructions silently do nothing for external providers.
+
+### Minor
+
+| # | Issue | Location |
+|---|-------|----------|
+| m1 | `pytorch-cpu/main.py` and `pytorch-cuda/main.py` are 95% identical | Both files | 
+| m2 | `build.py` scripts also nearly identical | Both build files |
+| m3 | `navigator.platform` is deprecated | `ProviderSettings.tsx:20-23` |
+| m4 | `console.log('currentProvider', ...)` left in | `ProviderSettings.tsx:151` |
+| m5 | `ProviderType` enum defined but never used for validation | `types.py:10-15` |
+| m6 | `list_installed()` reimplements platform detection | `__init__.py:129-143` |
+| m7 | New `httpx.AsyncClient` created per health poll iteration | `__init__.py:151-165` |
+| m8 | `load_model_async()` only stores size, doesn't actually preload | `local.py:95-99` |
+
+---
+
+## Scope Creep
+
+The PR should be split. These are independent changes bundled in:
+
+| Change | Lines | Should Be Separate PR |
+|--------|-------|-----------------------|
+| `docs2/` site rewrite | ~3000 | Yes |
+| Docker support (Dockerfile, compose, docs) | ~600 | Yes — overlaps with PR #161 |
+| Landing page banner removal | ~30 | Yes |
+| UI refactors (Stories, History, Voices, Audio) | ~400 | Yes |
+| Linux audio capture module | ~10 | Yes |
+| Dependency bumps | ~100 | Yes |
+
+**Core provider system** (the actual feature) is ~2500 lines across backend + frontend + provider servers. That's the reviewable scope.
+
+---
+
+## What's Well-Designed
+
+These parts should survive any rewrite:
+
+1. **`TTSProvider` Protocol** (`base.py`) — Structural typing via `@runtime_checkable Protocol`. Right pattern. Comprehensive interface.
+
+2. **`BundledProvider` / `LocalProvider` split** — Clean separation between in-process and HTTP-based inference. The wrapper pattern in `BundledProvider` correctly delegates to existing `TTSBackend`.
+
+3. **R2 distribution strategy** — Provider binaries on Cloudflare R2, main app on GitHub Releases. Correct solution to the 2 GB limit.
+
+4. **Progress tracking** — SSE-based download progress integrated with the existing `ProgressManager`. Good UX.
+
+5. **Subprocess log files** — Writing provider stdout/stderr to log files in the data directory is pragmatic and debuggable.
+
+6. **Frontend `ProviderSettings.tsx`** — Clean component structure. Proper loading/disabled states, confirmation dialogs, platform-aware visibility.
+
+7. **CI split** — Separate `build-providers` and `release` jobs. Providers built and uploaded to R2 independently.
+
+---
+
+## Options for Moving Forward
+
+### Option A — Fix and Slim PR #33
+
+Strip the PR down to just the provider system (~2500 lines). Fix the 5 critical and 8 major bugs. Rebase onto current `main`.
+
+**Effort:** ~2-3 days focused work
+**Pros:** Full auto-managed provider lifecycle. Foundation for multi-model.
+**Cons:** Still complex. Process management is inherently fragile cross-platform.
+
+### Option B — Manual External Server Mode
+
+Skip subprocess management entirely. Ship a "Connect to External Server" feature:
+
+1. User downloads CUDA provider zip from `downloads.voicebox.sh`
+2. User runs it manually (`./tts-provider-pytorch-cuda --port 8100`)
+3. In Voicebox UI: paste `http://localhost:8100` as the TTS server URL
+4. Voicebox routes generation to that URL via `LocalProvider`
+
+This reuses `LocalProvider` from PR #33 but removes:
+- `ProviderManager` subprocess spawning (the buggiest part)
+- `installer.py` download/extract logic (the security risks)
+- Port allocation (user picks the port)
+- Process lifecycle management (user's responsibility)
+
+**Effort:** ~1 day. `LocalProvider` + a URL input field + health check.
+**Pros:** Simple, reliable, no process management bugs, no security surface.
+**Cons:** Manual setup. Not seamless. But CUDA users are already technical (they run from source today).
+
+### Option C — Hybrid (Recommended)
+
+Ship Option B first as v0.2.0. Then iterate toward auto-management:
+
+**Phase 1 (v0.2.0):** Manual external server mode
+- `LocalProvider` HTTP client (from PR #33, with the 422 bug fixed)
+- Server URL input in Settings
+- Health indicator
+- CUDA provider published as standalone zip on R2
+- One page of docs: "download, unzip, run, paste URL"
+
+**Phase 2 (v0.2.x):** Auto-download + auto-start
+- `installer.py` with checksum verification and safe extraction
+- `ProviderManager` subprocess spawning with crash detection
+- Provider settings UI with download/start/stop buttons
+
+**Phase 3 (v0.3.0):** Multi-model providers
+- Provider per model family (not just per hardware)
+- LuxTTS provider, Chatterbox provider, etc.
+- Provider marketplace / registry
+
+This gets CUDA into users' hands immediately (Phase 1 is ~1 day) while building toward the full vision incrementally. Each phase is independently shippable and testable.
+
+### Option D — GitHub Workaround
+
+Avoid the provider architecture entirely. Host CUDA binaries on R2 and add a download link in the app that opens the user's browser. User downloads the full monolithic CUDA build, replaces their existing install.
+
+**Effort:** Minimal — just hosting + a link.
+**Pros:** Zero architecture changes.
+**Cons:** Doesn't solve: multi-model, independent app updates, or the re-download-everything-on-update problem. Kicks the can.
+
+---
+
+## Recommendation
+
+**Option C (Hybrid)** is the strongest path. Specifically:
+
+1. **Now:** Close PR #33 as-is. It's too large, too buggy, and too stale to salvage as a single merge.
+
+2. **Extract:** Cherry-pick the good parts into small focused PRs:
+   - PR: `TTSProvider` Protocol + `BundledProvider` + `LocalProvider` (the abstractions)
+   - PR: Provider settings UI (the frontend)
+   - PR: `installer.py` + checksums (the download system)
+   - PR: CI changes for R2 upload (the distribution)
+
+3. **Ship Phase 1:** Manual external server mode. One small PR. Unblocks every CUDA user immediately.
+
+4. **Iterate:** Layer in auto-management once the manual mode is proven stable.
+
+The critical bugs in PR #33 (C1-C6) are all fixable, but the PR's size makes review unreliable. Splitting it ensures each piece gets proper attention and nothing ships broken.
+
+---
+
+## Bug Summary
+
+| Severity | Count | Blocks Ship? |
+|----------|-------|-------------|
+| Critical (runtime crash) | 3 | Yes — C1, C2, C3 |
+| Critical (security) | 3 | Yes — C4, C5, C6 |
+| Major | 8 | Some — M1, M2, M3 are high risk |
+| Minor | 8 | No |
+| **Total** | **22** | |

docs/plans/PROJECT_STATUS.md

@@ -0,0 +1,462 @@
+# Voicebox Project Status & Roadmap
+
+> Last updated: 2026-03-12 | Current version: **v0.1.13** | 13.1k stars | 176 open issues | 28 open PRs
+
+---
+
+## Table of Contents
+
+1. [Architecture Overview](#architecture-overview)
+2. [Current State](#current-state)
+3. [Open PRs — Triage & Analysis](#open-prs--triage--analysis)
+4. [Open Issues — Categorized](#open-issues--categorized)
+5. [Existing Plan Documents — Status](#existing-plan-documents--status)
+6. [New Model Integration — Landscape](#new-model-integration--landscape)
+7. [Architectural Bottlenecks](#architectural-bottlenecks)
+8. [Recommended Priorities](#recommended-priorities)
+
+---
+
+## Architecture Overview
+
+```
+┌─────────────────────────────────────────────────────┐
+│  Tauri Shell (Rust)                                 │
+│  ┌───────────────────────────────────────────────┐  │
+│  │  React Frontend (app/)                        │  │
+│  │  Zustand stores · API client · Generation UI  │  │
+│  │  Stories Editor · Voice Profiles · Model Mgmt │  │
+│  └──────────────────────┬────────────────────────┘  │
+│                         │ HTTP :17493                │
+│  ┌──────────────────────▼────────────────────────┐  │
+│  │  FastAPI Backend (backend/)                   │  │
+│  │  ┌─────────────┐  ┌───────────┐  ┌─────────┐ │  │
+│  │  │ TTSBackend  │  │ STTBackend│  │ Profiles│ │  │
+│  │  │ (Protocol)  │  │ (Whisper) │  │ History │ │  │
+│  │  │  ┌────────┐ │  └───────────┘  │ Stories │ │  │
+│  │  │  │PyTorch │ │                  └─────────┘ │  │
+│  │  │  │or MLX  │ │                              │  │
+│  │  │  └────────┘ │                              │  │
+│  │  └─────────────┘                              │  │
+│  └───────────────────────────────────────────────┘  │
+└─────────────────────────────────────────────────────┘
+```
+
+### Key Files
+
+| Layer | File | Purpose |
+|-------|------|---------|
+| Backend entry | `backend/main.py` | FastAPI app, all API routes (~1700 lines) |
+| TTS protocol | `backend/backends/__init__.py:14-81` | `TTSBackend` Protocol definition |
+| TTS factory | `backend/backends/__init__.py:118-137` | Singleton backend selection (MLX vs PyTorch) |
+| PyTorch TTS | `backend/backends/pytorch_backend.py` | Qwen3-TTS via `qwen_tts` package |
+| MLX TTS | `backend/backends/mlx_backend.py` | Qwen3-TTS via `mlx_audio.tts` |
+| Platform detect | `backend/platform_detect.py` | Apple Silicon → MLX, else → PyTorch |
+| API types | `backend/models.py` | Pydantic request/response models |
+| Frontend API | `app/src/lib/api/client.ts` | Hand-written fetch wrapper |
+| Frontend types | `app/src/lib/api/types.ts` | TypeScript API types |
+| Generation form | `app/src/components/Generation/GenerationForm.tsx` | TTS generation UI |
+| Model manager | `app/src/components/ServerSettings/ModelManagement.tsx` | Model download/status UI |
+| Gen form hook | `app/src/lib/hooks/useGenerationForm.ts` | Form validation + submission |
+
+### How TTS Generation Works (Current Flow)
+
+```
+POST /generate
+  1. Look up voice profile from DB
+  2. Check model cache → if missing, trigger background download, return HTTP 202
+  3. Load model (lazy): tts_backend.load_model(model_size)
+  4. Create voice prompt: profiles.create_voice_prompt_for_profile()
+       → tts_backend.create_voice_prompt(audio_path, reference_text)
+  5. Generate: tts_backend.generate(text, voice_prompt, language, seed, instruct)
+  6. Save WAV → data/generations/{id}.wav
+  7. Insert history record in SQLite
+  8. Return GenerationResponse
+```
+
+---
+
+## Current State
+
+### What's Shipped (v0.1.13)
+
+- Qwen3-TTS voice cloning (1.7B and 0.6B models)
+- MLX backend for Apple Silicon, PyTorch for everything else
+- Voice profiles with multi-sample support
+- Stories editor (multi-track DAW timeline)
+- Whisper transcription (base, small, medium, large variants)
+- Model management UI with download progress (SSE)
+- Generation history with caching
+- Streaming generation endpoint (MLX only)
+- Delivery instructions (instruct parameter)
+
+### What's NOT Shipped But Has Code
+
+| Feature | Branch | Status |
+|---------|--------|--------|
+| External provider binaries (CUDA split) | `external-provider-binaries` | PR #33, significant work done, stale since Feb |
+| Dual server binaries | `feat/dual-server-binaries` | Branch exists, no PR |
+| Multi-sample fix | `fix-multi-sample` | Branch exists, no PR |
+| Model download notification fix | `fix-dl-notification-...` | Branch exists, no PR |
+
+### Hardcoded Qwen3-TTS Assumptions
+
+These are the specific coupling points that block multi-model support:
+
+| Location | What's Hardcoded |
+|----------|-----------------|
+| `backend/models.py:58` | `model_size` regex: `^(1\.7B\|0\.6B)$` |
+| `backend/main.py:611` | Default: `model_size or "1.7B"` |
+| `backend/main.py:1322-1365` | Model status list (2 Qwen + 4 Whisper) |
+| `backend/main.py:1523-1548` | Download trigger map |
+| `backend/main.py:1597-1628` | Delete map |
+| `backend/backends/pytorch_backend.py:65-68` | HF repo ID map |
+| `backend/backends/mlx_backend.py:41-44` | MLX repo ID map |
+| `backend/backends/__init__.py:118-137` | Single global TTS backend |
+| `app/src/lib/hooks/useGenerationForm.ts:17` | `modelSize: z.enum(['1.7B', '0.6B'])` |
+| `app/src/lib/hooks/useGenerationForm.ts:70-71` | `modelName = "qwen-tts-${data.modelSize}"` |
+| `app/src/components/Generation/GenerationForm.tsx:140-141` | Hardcoded "Qwen TTS" labels |
+| `app/src/components/ServerSettings/ModelManagement.tsx:166-213` | Filters by `qwen-tts` and `whisper` prefix |
+| `backend/utils/cache.py` | Voice prompt cache uses `torch.save()` |
+
+---
+
+## Open PRs — Triage & Analysis
+
+### Merge-Ready / Near-Ready (Bug Fixes & Small Features)
+
+| PR | Title | Risk | Notes |
+|----|-------|------|-------|
+| **#250** | docs: align local API port examples | None | Docs-only |
+| **#230** | docs: fix README grammar | None | Docs-only |
+| **#243** | a11y: screen reader and keyboard improvements | Low | Accessibility, no backend changes |
+| **#175** | Fix #134: duplicate profile name validation | Low | Simple validation |
+| **#178** | Fix #168 #140: generation error handling | Low | Error handling improvements |
+| **#152** | Fix: prevent crashes when HuggingFace unreachable | Medium | Monkey-patches HF hub; solves real offline bug (#150, #151) |
+| **#218** | fix: unify qwen tts cache dir on Windows | Low | Windows-specific path fix |
+| **#214** | fix: panic on launch from tokio::spawn | Low | Rust-side Tauri fix |
+| **#210** | fix: Linux NVIDIA GBM buffer crash | Low | Linux-specific, narrowly scoped |
+| **#88** | security: restrict CORS to known local origins | Low | Security hardening |
+
+### Significant Feature PRs
+
+| PR | Title | Complexity | Dependencies | Notes |
+|----|-------|-----------|--------------|-------|
+| **#97** | fix: pass language parameter to TTS models | Medium | None | **Critical bug** — language param was silently dropped. Adds `LANGUAGE_CODE_TO_NAME` mapping to both backends. Should be high priority. |
+| **#133** | feat: network access toggle | Low | None | Wires up existing plumbing (`--host 0.0.0.0`). Clean, small. |
+| **#238** | download cancel/clear UI + error panel | Medium | None | Adds cancel buttons, VS Code-style Problems panel, fixes whisper-large repo. Quality-of-life win. |
+| **#99** | feat: chunked TTS with quality selector | Medium | None | Solves the 500-char/2048-token limit. Sentence-aware splitting, crossfade concat, 44.1kHz upsampling. Addresses #191, #203, #69, #111. |
+| **#154** | feat: Audiobook tab | Medium | Depends on #99 concepts | Full audiobook workflow — chunked gen, preview, auto-save to Stories. New route + tab. |
+| **#91** | fix: CoreAudio device enumeration | Medium | None | macOS audio device handling. |
+
+### Architectural PRs (Need Careful Review)
+
+| PR | Title | Complexity | Notes |
+|----|-------|-----------|-------|
+| **#33** | CUDA GPU Support — External Provider Binaries | **Very High** | The big one. Splits monolithic backend into main app + downloadable provider executables (PyTorch CPU, CUDA). New provider management system, CI/CD for R2 uploads, provider settings UI. Created Feb 1, significant codebase. **This is the foundation for multi-model support** but is currently Qwen-only. |
+| **#225** | feat: custom HuggingFace model support | High | Adds `custom_models.py`, `custom:<slug>` model IDs, frontend model grouping (Built-in vs Custom). **Takes a different approach than #33** — keeps single backend but allows arbitrary HF repos. These two PRs may conflict architecturally. |
+| **#194** | feat: Hebrew + Chatterbox TTS | High | **First non-Qwen TTS model.** Adds `ChatterboxTTSBackend` alongside existing backends. Routes by language (`he` → Chatterbox, else → Qwen). Adds Hebrew Whisper models. Includes a lot of cleanup. Important precedent for multi-model. |
+| **#195** | feat: per-profile LoRA fine-tuning | **Very High** | Depends on #194. Training pipeline, adapter management, SSE progress, 15 new API endpoints. New DB tables. Forces PyTorch even on MLX systems for adapter inference. |
+| **#161** | feat: Docker + web deployment | High | 3-stage Dockerfile, SPA serving from FastAPI, docker-compose. Implements the Docker deployment plan. |
+| **#124** | Add Dockerfiles + docker-compose + docs | Medium | Earlier, simpler Docker attempt. Overlaps with #161. |
+| **#123** | added docker | Low | Minimal Docker PR. Overlaps with #161 and #124. |
+| **#227** | fix: harden input validation & file safety | Medium | Follow-up to #225. Atomic writes, threading locks, input validation. Good hardening but coupled to the custom models feature. |
+
+### PRs That Need Author Action / Are Stale
+
+| PR | Title | Notes |
+|----|-------|-------|
+| **#237** | fix: bundle qwen_tts source files in PyInstaller | Solves #212 but needs review for build system impact |
+| **#215** | Update prerequisites with Tauri deps | Branch is `main` — will have conflicts |
+| **#89** | Linux Support | Branch is `main` — will have conflicts. Broad scope. |
+| **#83** | Update download links for v0.1.12 | Outdated (we're on v0.1.13) |
+
+---
+
+## Open Issues — Categorized
+
+### GPU / Hardware Detection (19 issues)
+
+The single most reported category. Users on Windows with NVIDIA GPUs frequently report "GPU not detected."
+
+**Root causes (likely):**
+- PyInstaller binary doesn't bundle CUDA correctly → falls back to CPU
+- DirectML/Vulkan path not implemented (AMD on Windows)
+- Binary size limit means CUDA can't ship in the main release
+
+**Key issues:** #239, #222, #220, #217, #208, #198, #192, #167, #164, #141, #130, #127
+
+**Fix path:** PR #33 (external provider binaries) is designed to solve this. Ship a small main app, let users download the CUDA provider separately.
+
+### Model Downloads (20 issues)
+
+Second most reported. Users get stuck downloads, can't resume, no cancel button, no offline fallback.
+
+**Key issues:** #249, #240, #221, #216, #212, #181, #180, #159, #150, #149, #145, #143, #135, #134
+
+**Fix path:** PR #238 (cancel/clear UI), PR #152 (offline crash fix). Resume support not yet addressed.
+
+### Language Requests (18 issues)
+
+Strong demand for: Hindi (#245), Indonesian (#247), Dutch (#236), Hebrew (#199), Greek (#188), Portuguese (#183), Persian (#162), and many more.
+
+**Key issues:** #247, #245, #236, #211, #205, #199, #189, #188, #187, #183, #179, #162
+
+**Fix path:** PR #97 (pass language param — currently silently dropped!) is the prerequisite. Qwen3-TTS already supports many languages; the bug is that the language code isn't forwarded. Multi-model (#194 Chatterbox for Hebrew) expands coverage further.
+
+### New Model Requests (5 explicit issues)
+
+| Issue | Model Requested |
+|-------|----------------|
+| #226 | GGUF support |
+| #172 | VibeVoice |
+| #138 | Export to ONNX/Piper format |
+| #132 | LavaSR (transcription) |
+| #76 | (General model expansion) |
+
+Community is also vocally requesting: LuxTTS, Chatterbox, XTTS-v2, Fish Speech, CosyVoice, Kokoro on social media and in issue comments.
+
+### Long-Form / Chunking (5 issues)
+
+Users hitting the ~500 character practical limit.
+
+**Key issues:** #234 (queue system), #203 (500 char limit), #191 (auto-split), #111, #69
+
+**Fix path:** PR #99 (chunked TTS + quality selector) directly addresses this. PR #154 (Audiobook tab) builds on it.
+
+### Feature Requests (23 issues)
+
+Notable requests:
+- **#234** — Queue system for batch generation
+- **#182** — Concurrent/multi-thread generation
+- **#173** — Vocal intonation/inflection control
+- **#165** — Audiobook mode
+- **#144** — Copy text to clipboard
+- **#184** — Cancel button for progress bar
+- **#242** — Seed value pinning for consistency
+- **#228** — Always use 0.6B option
+- **#233** — Transcribe audio API improvements
+- **#235** — Finetuned Qwen3-TTS tokenizer
+
+### Bugs (19 issues)
+
+| Category | Issues |
+|----------|--------|
+| Generation failures | #248 (broken pipe), #219 (unsupported scalarType), #202 (clipping error), #170 (load failed) |
+| UI bugs | #231 (history not updating), #190 (mobile landing), #169 (blank interface) |
+| File operations | #207 (transcribe file error), #168 (no such file), #142 (download audio fail) |
+| Server lifecycle | #166 (server processes remain), #164 (no auto-update) |
+| Database | #174 (sqlite3 IntegrityError) |
+| Dependency | #131 (numpy ABI mismatch), #209 (import error) |
+
+---
+
+## Existing Plan Documents — Status
+
+| Document | Target Version | Status | Relevance |
+|----------|---------------|--------|-----------|
+| `TTS_PROVIDER_ARCHITECTURE.md` | v0.1.13 | **Partially implemented** in PR #33 | Core architecture for multi-model + CUDA distribution |
+| `EXTERNAL_PROVIDERS.md` | v0.2.0 | **Not started** | Remote server support. API path inconsistency with provider arch doc (`/v1/` vs `/tts/`) |
+| `MLX_AUDIO.md` | — | **Shipped** (the only one) | MLX backend is live. 0.6B MLX model still missing. |
+| `DOCKER_DEPLOYMENT.md` | v0.2.0 | **PR exists** (#161) | Waiting on review. No official images published. |
+| `OPENAI_SUPPORT.md` | v0.2.0 | **Not started** | OpenAI-compatible API layer. Linked to issue #10. Low complexity. |
+
+### Cross-Document Conflicts
+
+1. **API path inconsistency:** Provider arch uses `/tts/generate`, External providers uses `/v1/generate`, OpenAI compat uses `/v1/audio/speech`. Need to reconcile.
+2. **Docker vs. Provider split:** Docker doc assumes monolithic backend. Provider arch splits into separate binaries. Need to decide: does Docker run the monolith or individual providers?
+3. **Version targeting:** Provider arch targets v0.1.13 (current!) but isn't merged. Everything else targets v0.2.0.
+
+---
+
+## New Model Integration — Landscape
+
+### Models Worth Supporting (2026 SOTA)
+
+| Model | Cloning | Speed | Sample Rate | Languages | VRAM | Integration Ease | Repo |
+|-------|---------|-------|-------------|-----------|------|-----------------|------|
+| **LuxTTS** | 3s zero-shot | 150x RT, CPU ok | 48 kHz | English-first | <1 GB | Easy | `ysharma3501/LuxTTS` |
+| **Chatterbox** | 5s zero-shot | Sub-200ms streaming | 24-48 kHz | 23+ | Low | Medium | `resemble-ai/chatterbox` |
+| **XTTS-v2** | 6s zero-shot | Fast mid-GPU | 24 kHz | 17+ | Medium | Medium | `coqui/XTTS-v2` |
+| **Fish Speech** | 10-30s few-shot | Real-time | 24-44 kHz | 50+ | Medium | Medium | `fishaudio/fish-speech` |
+| **CosyVoice2-0.5B** | 3-10s zero-shot | Very fast | 24 kHz | Multilingual | Low | Easy | Alibaba HF org |
+| **Kokoro-82M** | 3s instant | CPU realtime | 24 kHz | English | Tiny | Medium | Kokoro repo |
+
+### What's Needed Architecturally for Multi-Model
+
+The current codebase assumes one TTS model family (Qwen3-TTS). Adding any new model requires:
+
+1. **Model type concept** — A `model_type` field (e.g. `qwen`, `luxtts`, `chatterbox`) alongside `model_size`. The `GenerationRequest` schema, frontend form, and all model config dicts need updating.
+
+2. **Multiple backend instances** — The singleton `get_tts_backend()` needs to become a registry. Different models have different voice prompt formats, different inference APIs, different sample rates.
+
+3. **Voice prompt format abstraction** — Qwen uses `torch.save()`-serialized tensors. LuxTTS uses `encode_prompt()` returning its own format. Chatterbox uses audio-path-based cloning. The cache system (`backend/utils/cache.py`) needs to handle heterogeneous formats.
+
+4. **Sample rate normalization** — Qwen outputs 24 kHz. LuxTTS outputs 48 kHz. The Stories editor and audio pipeline need to handle mixed rates.
+
+5. **Per-model capabilities** — Not all models support `instruct` (delivery instructions), not all support streaming, not all support the same languages. The UI needs to adapt.
+
+### PR #194 as Precedent
+
+The Hebrew/Chatterbox PR (#194) is the first attempt at multi-model. It takes a pragmatic approach: route by language (`he` → Chatterbox, else → Qwen). This works for one extra model but doesn't scale — what happens when you want Chatterbox for English too?
+
+### PR #225 as Alternative Approach
+
+The custom HuggingFace models PR (#225) takes a different angle: let users register arbitrary HF repos and attempt to load them through the existing Qwen backend. This is flexible but fragile — it assumes all models have the same API as Qwen3-TTS.
+
+### PR #33 as Foundation
+
+The external provider binaries PR (#33) has the most robust architecture for multi-model, since each provider is a separate process with its own dependencies. But it's complex, currently Qwen-only, and has been stale since early February.
+
+---
+
+## Architectural Bottlenecks
+
+### 1. Single Backend Singleton
+
+**File:** `backend/backends/__init__.py:118-137`
+
+The entire TTS system runs through one global `_tts_backend` instance. You literally cannot have two models loaded. This is the #1 blocker for multi-model support.
+
+### 2. `main.py` is 1700+ Lines
+
+All API routes, all model configs, all business logic in one file. Three separate hardcoded model config dicts that must stay in sync. Any multi-model change touches this file heavily.
+
+### 3. Model Config is Scattered
+
+Model identifiers, HF repo IDs, display names, and download logic are duplicated across:
+- `main.py` (3 separate dicts)
+- `pytorch_backend.py` (HF repo map)
+- `mlx_backend.py` (MLX repo map)
+- `GenerationForm.tsx` (UI labels)
+- `useGenerationForm.ts` (validation schema)
+- `ModelManagement.tsx` (prefix filters)
+
+There is no single source of truth for "what models does Voicebox support."
+
+### 4. Voice Prompt Cache Assumes PyTorch Tensors
+
+`backend/utils/cache.py` uses `torch.save()` / `torch.load()` for caching voice prompts. Models that don't use PyTorch tensors (LuxTTS, MLX-native models) can't use this cache.
+
+### 5. Frontend Assumes Qwen Model Sizes
+
+The generation form schema (`useGenerationForm.ts:17`) validates `model_size` as `'1.7B' | '0.6B'`. The model management UI filters by string prefix `qwen-tts`. Adding any model requires touching 3-4 frontend files.
+
+---
+
+## Recommended Priorities
+
+### Tier 1 — Ship Now (Bug Fixes & Critical Improvements)
+
+These PRs fix real user pain with low risk. Can be reviewed and merged quickly.
+
+| Priority | PR | Impact | Effort |
+|----------|-----|--------|--------|
+| 1 | **#97** — Pass language param to TTS | Fixes all non-English generation (18 language issues) | Low |
+| 2 | **#238** — Download cancel/clear UI | Addresses 20 download-related issues | Low |
+| 3 | **#152** — Offline mode crash fix | Fixes #150, #151 | Low |
+| 4 | **#99** — Chunked TTS + quality selector | Removes 500-char limit, addresses 5 issues | Medium |
+| 5 | **#218** — Windows HF cache dir fix | Windows-specific pain | Low |
+| 6 | **#175, #178** — Profile validation + error handling | Small fixes | Low |
+| 7 | **#250, #230** — Docs fixes | Zero risk | None |
+| 8 | **#133** — Network access toggle | Wires up existing code | Low |
+| 9 | **#88** — CORS restriction | Security improvement | Low |
+| 10 | **#214** — Tauri window close panic fix | Stability | Low |
+
+### Tier 2 — Next Release (v0.2.0 Foundations)
+
+These require more review but unlock major capabilities.
+
+| Priority | Item | Impact | Effort | Dependencies |
+|----------|------|--------|--------|-------------|
+| 1 | **PR #33** — External provider binaries | Solves GPU distribution (19 issues), foundation for multi-model | Very High | Needs rebase, thorough review |
+| 2 | **Multi-model abstraction layer** | Required before adding LuxTTS/Chatterbox/etc. | High | Informed by #33, #194, #225 |
+| 3 | **PR #161** — Docker deployment | Server/headless users | Medium | Independent of #33 |
+| 4 | **PR #194** — Hebrew + Chatterbox | First non-Qwen model, language expansion | High | Should align with multi-model abstraction |
+| 5 | **PR #154** — Audiobook tab | Significant feature for long-form users | Medium | Benefits from #99 (chunking) |
+
+### Tier 3 — Future (v0.3.0+)
+
+| Item | Notes |
+|------|-------|
+| LuxTTS integration | 48 kHz, low VRAM, but needs multi-model arch first |
+| XTTS-v2 / Fish Speech | Multilingual powerhouses |
+| OpenAI-compatible API (plan doc exists) | Low effort once API is stable |
+| LoRA fine-tuning (PR #195) | Complex, depends on #194 |
+| External/remote providers (plan doc exists) | Depends on provider architecture |
+| GGUF support (#226) | Depends on model ecosystem maturity |
+| Queue system (#234) | Batch generation |
+| Real-time streaming synthesis | MLX-only currently, needs PyTorch path |
+
+### Decision Point: Multi-Model Architecture
+
+Before adding any new TTS model, a decision is needed on *how*:
+
+**Option A — Provider Binary Split (PR #33 approach)**
+Each model family is a separate executable/process. Most isolated, most flexible, but most complex. Solves the CUDA distribution problem simultaneously.
+
+**Option B — In-Process Model Registry**
+Keep everything in one process but replace the singleton with a registry that can instantiate multiple `TTSBackend` implementations. Simpler, but doesn't solve binary size / CUDA distribution.
+
+**Option C — Hybrid (Recommended)**
+Use Option B for lightweight models (LuxTTS, Kokoro — small, CPU-friendly) that can coexist in-process. Use Option A for heavy models (CUDA Qwen3-TTS, Fish Speech) that need their own process/dependencies. The provider architecture from PR #33 becomes the escape hatch for heavy models, while light models are built-in.
+
+This matches how PR #194 already works (Chatterbox loaded in-process alongside Qwen) while keeping the door open for PR #33's provider split.
+
+---
+
+## Branch Inventory
+
+| Branch | PR | Status | Notes |
+|--------|-----|--------|-------|
+| `external-provider-binaries` | #33 | Open, stale | Major architecture work |
+| `feat/dual-server-binaries` | — | No PR | Related to provider split? |
+| `fix-multi-sample` | — | No PR | Voice profile multi-sample fix |
+| `fix-dl-notification-...` | — | No PR | Model download UX |
+| `improvements` | — | No PR | Unknown scope |
+| `stories` | — | No PR | Stories editor work? |
+| `windows-server-shutdown` | — | No PR | Windows lifecycle |
+| `model-dl-fix` | — | No PR | Model download fix |
+| `channels` | — | No PR | Audio channels |
+| `audio-export-entitlement-fix` | — | No PR | macOS entitlements |
+| `better-docs` | — | No PR | Documentation |
+
+---
+
+## Quick Reference: API Endpoints
+
+<details>
+<summary>All current endpoints (v0.1.13)</summary>
+
+| Endpoint | Method | Purpose |
+|----------|--------|---------|
+| `/health` | GET | Health check, model/GPU status |
+| `/profiles` | POST, GET | Create/list voice profiles |
+| `/profiles/{id}` | GET, PUT, DELETE | Profile CRUD |
+| `/profiles/{id}/samples` | POST, GET | Add/list voice samples |
+| `/profiles/{id}/avatar` | POST, GET, DELETE | Avatar management |
+| `/profiles/{id}/export` | GET | Export profile as ZIP |
+| `/profiles/import` | POST | Import profile from ZIP |
+| `/generate` | POST | Generate speech |
+| `/generate/stream` | POST | Stream speech (SSE) |
+| `/history` | GET | List generation history |
+| `/history/{id}` | GET, DELETE | Get/delete generation |
+| `/history/{id}/export` | GET | Export generation ZIP |
+| `/history/{id}/export-audio` | GET | Export audio only |
+| `/transcribe` | POST | Transcribe audio (Whisper) |
+| `/models/status` | GET | All model statuses |
+| `/models/download` | POST | Trigger model download |
+| `/models/{name}` | DELETE | Delete downloaded model |
+| `/models/load` | POST | Load model into memory |
+| `/models/unload` | POST | Unload model |
+| `/models/progress/{name}` | GET | SSE download progress |
+| `/tasks/active` | GET | Active downloads/generations |
+| `/stories` | POST, GET | Create/list stories |
+| `/stories/{id}` | GET, PUT, DELETE | Story CRUD |
+| `/stories/{id}/items` | POST, GET | Story items CRUD |
+| `/stories/{id}/export` | GET | Export story audio |
+| `/channels` | POST, GET | Audio channel CRUD |
+| `/channels/{id}` | PUT, DELETE | Channel update/delete |
+| `/cache/clear` | POST | Clear voice prompt cache |
+
+</details>

docs/plans/TTS_PROVIDER_ARCHITECTURE.md

@@ -10,17 +10,14 @@
 
 Split the monolithic backend into modular components:
 
-1. **Main App**:
-   - Windows/Linux (~150MB): Tauri + FastAPI backend + Whisper + UI/profiles/history
-   - macOS (~300MB): Same + MLX bundled for simplicity
-2. **TTS Providers** (Windows/Linux only): Downloadable executables for PyTorch CPU/CUDA inference
+1. **Main App** (~150-200MB): Tauri + FastAPI backend + Whisper + UI/profiles/history
+2. **TTS Providers** (downloadable plugins): Separate executables for model inference
 
 This architecture solves:
 
 - ✅ GitHub 2GB release artifact limit
-- ✅ Frequent app updates without re-downloading large python binaries (Windows/Linux)
-- ✅ User choice of compute backend (CPU/GPU/Cloud) on Windows/Linux
-- ✅ Simplified out-of-the-box experience on macOS
+- ✅ Frequent app updates without re-downloading large python binaries
+- ✅ User choice of compute backend (CPU/GPU/Cloud)
 - ✅ External provider support (OpenAI, custom servers)
 - ✅ Future extensibility
 
@@ -28,7 +25,6 @@ This architecture solves:
 
 ## Architecture Diagram
 
-### Windows / Linux
 ```
 ┌─────────────────────────────────────────────────────────┐
 │  Voicebox App (Tauri + Backend)           ~150MB        │
@@ -43,43 +39,27 @@ This architecture solves:
                                           │
                             HTTP/IPC      │
                                           │
-                    ┌─────────────────────┴─────────────────┐
-                    │                                       │
-                    ▼                                       ▼
-       ┌─────────────────────┐              ┌─────────────────────┐
-       │ TTS Provider:       │              │ TTS Provider:       │
-       │ PyTorch CPU         │              │ PyTorch CUDA        │
-       │                     │              │                     │
-       │ ~300MB              │              │ ~2.4GB              │
-       │                     │              │                     │
-       │ Local inference     │              │ GPU inference       │
-       └─────────────────────┘              └─────────────────────┘
-                    │                                       │
-                    └───────────────┬───────────────────────┘
-                                    │
-                      ┌─────────────▼──────────────┐
-                      │  Future Providers:         │
-                      │  • Remote Server           │
-                      │  • OpenAI API              │
-                      │  • ElevenLabs              │
-                      │  • Custom Docker Container │
-                      └────────────────────────────┘
-```
-
-### macOS
-```
-┌─────────────────────────────────────────────────────────┐
-│  Voicebox App (Tauri + Backend)           ~300MB        │
-│  ├─ UI Layer (React)                                    │
-│  ├─ Backend (FastAPI)                                   │
-│  │  ├─ Voice Profiles                                   │
-│  │  ├─ Generation History                               │
-│  │  ├─ Audio Editing / Stories                          │
-│  │  └─ MLX Backend (bundled)                            │
-│  └─ Whisper (bundled, tiny ~50MB)                       │
-│                                                          │
-│  No provider downloads needed - works out of the box    │
-└─────────────────────────────────────────────────────────┘
+         ┌────────────────────────────────┼─────────────────┐
+         │                                │                 │
+         ▼                                ▼                 ▼
+┌─────────────────┐      ┌─────────────────┐   ┌──────────────────┐
+│ TTS Provider:   │      │ TTS Provider:   │   │ TTS Provider:    │
+│ PyTorch CPU     │      │ PyTorch CUDA    │   │ MLX (Apple)      │
+│                 │      │                 │   │                  │
+│ ~300MB          │      │ ~2.4GB          │   │ ~800MB           │
+│                 │      │                 │   │                  │
+│ Local inference │      │ GPU inference   │   │ Metal inference  │
+└─────────────────┘      └─────────────────┘   └──────────────────┘
+         │                        │                     │
+         └────────────────────────┴─────────────────────┘
+                                  │
+                    ┌─────────────▼──────────────┐
+                    │  Future Providers:         │
+                    │  • Remote Server           │
+                    │  • OpenAI API              │
+                    │  • ElevenLabs              │
+                    │  • Custom Docker Container │
+                    └────────────────────────────┘
 ```
 
 ---
@@ -111,20 +91,18 @@ This architecture solves:
 
 #### 1. Main App (voicebox.exe / .app / .AppImage)
 
-**Windows/Linux Size:** ~100-150MB
-**macOS Size:** ~300-350MB (includes MLX)
+**Size:** ~100-150MB
 
 **Includes:**
 
 - Tauri runtime + React UI
-- FastAPI backend (pure Python, no PyTorch on Windows/Linux)
+- FastAPI backend (pure Python, no PyTorch)
 - Whisper model (tiny, ~50MB)
 - SQLite database
 - Profile/history/audio editing logic
-- Provider management system (Windows/Linux only)
-- **MLX backend (macOS only, bundled)**
+- Provider management system
 
-**Does NOT include (Windows/Linux only):**
+**Does NOT include:**
 
 - PyTorch (CPU or CUDA)
 - TTS models (Qwen3-TTS)
@@ -169,7 +147,23 @@ This architecture solves:
 
 ---
 
-#### 4. TTS Provider: Remote
+#### 4. TTS Provider: MLX
+
+**Binary:** `tts-provider-mlx`
+**Size:** ~150MB
+
+**Includes:**
+
+- MLX framework
+- MLX-optimized Qwen3-TTS
+- Metal acceleration
+
+**Platform:** macOS only (Apple Silicon)
+**Download source:** Cloudflare R2
+
+---
+
+#### 5. TTS Provider: Remote
 
 **Binary:** None (built-in config)
 **Size:** 0MB
@@ -188,7 +182,7 @@ This architecture solves:
 
 ---
 
-#### 5. TTS Provider: OpenAI
+#### 6. TTS Provider: OpenAI
 
 **Binary:** None (API wrapper)
 **Size:** 0MB
@@ -302,10 +296,7 @@ Model status.
 
 ```python
 class ProviderManager:
-    """Manages TTS provider lifecycle (Windows/Linux only).
-
-    Note: macOS uses bundled MLX backend directly, no provider management needed.
-    """
+    """Manages TTS provider lifecycle."""
 
     def __init__(self):
         self.active_provider: Optional[Provider] = None
@@ -317,6 +308,8 @@ class ProviderManager:
             return await self._start_local_provider("tts-provider-pytorch-cpu.exe")
         elif provider_type == "pytorch-cuda":
             return await self._start_local_provider("tts-provider-pytorch-cuda.exe")
+        elif provider_type == "mlx":
+            return await self._start_local_provider("tts-provider-mlx")
         elif provider_type == "remote":
             return self.config["remote_url"]
         elif provider_type == "openai":
@@ -441,14 +434,15 @@ class OpenAIProvider(TTSProvider):
 
 ```python
 class ProviderInstaller:
-    """Handles provider download and installation (Windows/Linux only)."""
+    """Handles provider download and installation."""
 
     async def download_provider(self, provider_type: str):
         """Download provider binary from R2."""
 
         binary_name = {
             "pytorch-cpu": "tts-provider-pytorch-cpu.exe",
-            "pytorch-cuda": "tts-provider-pytorch-cuda.exe"
+            "pytorch-cuda": "tts-provider-pytorch-cuda.exe",
+            "mlx": "tts-provider-mlx"
         }[provider_type]
 
         download_url = f"https://downloads.voicebox.sh/providers/v{PROVIDER_VERSION}/{binary_name}"
@@ -531,38 +525,44 @@ export function ProviderSettings() {
 						)}
 					</div>
 
-					{/* PyTorch CPU (Windows/Linux only) */}
-					{!isMacOS && (
+					{/* PyTorch CPU */}
+					<div className="flex items-center justify-between">
+						<div className="flex items-center space-x-2">
+							<RadioGroupItem value="pytorch-cpu" id="cpu" />
+							<Label htmlFor="cpu">
+								<div className="font-medium">PyTorch CPU</div>
+								<div className="text-sm text-muted-foreground">
+									Works on any system, slower inference
+								</div>
+							</Label>
+						</div>
+						{!installedProviders?.includes("pytorch-cpu") && (
+							<Button onClick={() => downloadProvider("pytorch-cpu")} size="sm">
+								Download (300MB)
+							</Button>
+						)}
+					</div>
+
+					{/* MLX (macOS only) */}
+					{isMacOS && (
 						<div className="flex items-center justify-between">
 							<div className="flex items-center space-x-2">
-								<RadioGroupItem value="pytorch-cpu" id="cpu" />
-								<Label htmlFor="cpu">
-									<div className="font-medium">PyTorch CPU</div>
+								<RadioGroupItem value="mlx" id="mlx" />
+								<Label htmlFor="mlx">
+									<div className="font-medium">MLX (Apple Silicon)</div>
 									<div className="text-sm text-muted-foreground">
-										Works on any system, slower inference
+										Optimized for M1/M2/M3 chips
 									</div>
 								</Label>
 							</div>
-							{!installedProviders?.includes("pytorch-cpu") && (
-								<Button onClick={() => downloadProvider("pytorch-cpu")} size="sm">
-									Download (300MB)
+							{!installedProviders?.includes("mlx") && (
+								<Button onClick={() => downloadProvider("mlx")} size="sm">
+									Download (800MB)
 								</Button>
 							)}
 						</div>
 					)}
 
-					{/* MLX bundled (macOS only) */}
-					{isMacOS && (
-						<div className="p-3 bg-muted rounded-md">
-							<div className="text-sm">
-								<div className="font-medium">MLX (Apple Silicon)</div>
-								<div className="text-muted-foreground mt-1">
-									Bundled with the app - optimized for M1/M2/M3 chips
-								</div>
-							</div>
-						</div>
-					)}
-
 					{/* Remote */}
 					<div className="space-y-2">
 						<div className="flex items-center space-x-2">
@@ -608,18 +608,14 @@ export function ProviderSettings() {
 ```
 voicebox/
 ├── backend/
-│   ├── main.py                    # Main FastAPI app (no TTS on Win/Linux)
-│   ├── backends/
-│   │   ├── __init__.py            # Backend abstraction (existing)
-│   │   ├── pytorch_backend.py     # PyTorch backend (existing, for reference)
-│   │   └── mlx_backend.py         # MLX backend (bundled in macOS build only)
+│   ├── main.py                    # Main FastAPI app (no TTS code)
 │   ├── providers/
-│   │   ├── __init__.py            # ProviderManager (Windows/Linux)
-│   │   ├── base.py                # TTSProvider Protocol
+│   │   ├── __init__.py            # ProviderManager
+│   │   ├── base.py                # TTSProvider ABC
 │   │   ├── local.py               # LocalProvider (subprocess)
 │   │   ├── remote.py              # RemoteProvider (HTTP)
 │   │   ├── openai.py              # OpenAIProvider (API wrapper)
-│   │   └── installer.py           # Provider download logic (Windows/Linux)
+│   │   └── installer.py           # Provider download logic
 │   ├── profiles.py                # Voice profile management
 │   ├── history.py                 # Generation history
 │   ├── transcribe.py              # Whisper (still bundled)
@@ -632,22 +628,27 @@ voicebox/
 │   │   ├── requirements.txt       # torch (CPU), qwen-tts, transformers
 │   │   └── build.spec             # PyInstaller spec
 │   │
-│   └── pytorch-cuda/
+│   ├── pytorch-cuda/
+│   │   ├── main.py                # FastAPI server for TTS
+│   │   ├── tts_backend.py         # PyTorch TTS logic
+│   │   ├── requirements.txt       # torch+cu121, qwen-tts, transformers
+│   │   └── build.spec             # PyInstaller spec
+│   │
+│   └── mlx/
 │       ├── main.py                # FastAPI server for TTS
-│       ├── tts_backend.py         # PyTorch TTS logic
-│       ├── requirements.txt       # torch+cu121, qwen-tts, transformers
+│       ├── mlx_backend.py         # MLX TTS logic
+│       ├── requirements.txt       # mlx, qwen-tts-mlx
 │       └── build.spec             # PyInstaller spec
 │
 ├── app/                           # Frontend (Tauri + React)
 │   └── src/
 │       └── components/
 │           └── ServerSettings/
-│               └── ProviderSettings.tsx  # Only shown on Windows/Linux
+│               └── ProviderSettings.tsx
 │
 └── tauri/
     └── src-tauri/
-        └── tauri.conf.json        # No externalBin for providers (Windows/Linux)
-                                   # MLX bundled in macOS build
+        └── tauri.conf.json        # No externalBin for providers
 ```
 
 ---
@@ -670,35 +671,33 @@ voicebox/
 
 ### Phase 2: Build Provider Binaries
 
-**Goal:** Create standalone TTS provider executables (Windows/Linux only)
+**Goal:** Create standalone TTS provider executables
 
 1. Create separate PyInstaller specs for each provider
 2. Build provider executables:
    - `tts-provider-pytorch-cpu.exe` (~300MB)
    - `tts-provider-pytorch-cuda.exe` (~2.4GB)
+   - `tts-provider-mlx` (~800MB, macOS)
 3. Test subprocess communication
 4. Upload providers to Cloudflare R2
 
 **Result:** Provider binaries exist but aren't used yet
 
-**Note:** macOS keeps MLX bundled in main app - no separate provider needed
-
 ---
 
 ### Phase 3: Remove PyTorch from Main App
 
-**Goal:** Split main app from providers (Windows/Linux only)
+**Goal:** Split main app from providers
 
-1. Exclude PyTorch/Qwen3-TTS from Windows/Linux main app PyInstaller spec
-2. Windows/Linux app now requires provider download
+1. Exclude PyTorch/Qwen3-TTS from main app PyInstaller spec
+2. Main app now requires provider download
 3. Update GitHub CI to build multiple artifacts:
-   - `voicebox-{version}-windows.exe` (~150MB, no TTS)
-   - `voicebox-{version}-linux.AppImage` (~150MB, no TTS)
-   - `voicebox-{version}-macos.app` (~300MB, MLX bundled)
+   - `voicebox-{version}-{platform}.exe` (~150MB)
    - `tts-provider-pytorch-cpu-{version}.exe`
    - `tts-provider-pytorch-cuda-{version}.exe`
+   - `tts-provider-mlx-{version}` (macOS)
 
-**Result:** Windows/Linux apps are small with downloadable providers, macOS app is self-contained
+**Result:** Main app is small, providers downloaded separately
 
 ---
 
@@ -768,7 +767,7 @@ async def check_provider_compatibility(provider_version: str) -> bool:
 
 ## User Flows
 
-### First-Time Setup (Windows/Linux)
+### First-Time Setup
 
 1. User downloads and installs Voicebox (~150MB)
 2. App launches → detects no TTS provider installed
@@ -785,6 +784,10 @@ async def check_provider_compatibility(provider_version: str) -> bool:
        ✓ Works on any system
        ✗ Slower inference
 
+   [ ] MLX (800MB)             [Download]
+       ✓ Fast on Apple Silicon
+       ✗ macOS only (M1/M2/M3)
+
    [ ] Remote Server
        URL: ___________________
 
@@ -796,31 +799,19 @@ async def check_provider_compatibility(provider_version: str) -> bool:
 5. Provider installs to AppData/Application Support
 6. App starts provider → ready to use
 
-### First-Time Setup (macOS)
-
-1. User downloads and installs Voicebox (~300MB with MLX bundled)
-2. App launches → MLX backend is ready immediately
-3. No provider setup needed - works out of the box
-
 ---
 
 ### App Update Flow (No Provider Change)
 
 **Scenario:** Bug fix in UI, no backend changes
 
-**Windows/Linux:**
 1. User gets update notification: "Voicebox v0.2.1 available"
 2. Downloads update (~150MB, not 2.4GB!)
 3. Installs and restarts
 4. **Provider stays the same** (no re-download needed)
 5. App starts using existing provider
 
-**macOS:**
-1. User gets update notification: "Voicebox v0.2.1 available"
-2. Downloads update (~300MB with MLX bundled)
-3. Installs and restarts - ready to use
-
-**User experience:** Fast updates, no multi-GB downloads (especially for CUDA users)
+**User experience:** Fast updates, no multi-GB downloads
 
 ---
 
@@ -855,10 +846,9 @@ async def check_provider_compatibility(provider_version: str) -> bool:
 
 | Benefit                       | Details                                                   |
 | ----------------------------- | --------------------------------------------------------- |
-| **GitHub Releases Work**      | Main app ~150MB (Win/Linux), ~300MB (macOS) << 2GB limit  |
+| **GitHub Releases Work**      | Main app ~150MB << 2GB limit                              |
 | **Fast Updates**              | UI/feature updates don't require re-downloading providers |
-| **User Choice**               | CPU, CUDA, OpenAI, remote server (Win/Linux)              |
-| **macOS Simplicity**          | MLX bundled - works immediately, no provider setup needed |
+| **User Choice**               | CPU, CUDA, MLX, OpenAI, remote server                     |
 | **External Provider Support** | Users can run their own TTS servers                       |
 | **Bandwidth Savings**         | Only download provider once, app updates are small        |
 | **Future-Proof**              | Easy to add new providers (ElevenLabs, custom models)     |

docs2/MIGRATION.md

@@ -1,94 +0,0 @@
-# Documentation Migration: Mintlify → Fumadocs
-
-This document summarizes the migration of documentation from `/docs` (Mintlify) to `/docs2` (Fumadocs).
-
-## What Was Done
-
-### 1. Files Copied
-
-- ✅ All 29 MDX files from `/docs` folders (overview, api, developer, plans)
-- ✅ All 4 root-level markdown files (AUTOUPDATER.md, AUTOUPDATER_QUICKSTART.md, TROUBLESHOOTING.md, README.md)
-- ✅ All images (3 webp files) → `public/images/`
-- ✅ All logo files (2 png files) → `public/logo/`
-
-### 2. Component Migration
-
-Created compatibility layer in `components/mintlify-compat.tsx` that maps Mintlify components to Fumadocs equivalents:
-
-- `<Frame>` → Simple div wrapper (images are zoomable by default in Fumadocs)
-- `<CardGroup>` → `<Cards>` (Fumadocs component)
-- `<Card>` → `<Card>` (with icon string → Lucide icon mapping)
-- `<Steps>` / `<Step>` → Direct mapping to Fumadocs components
-- `<Tip>`, `<Note>`, `<Info>` → `<Callout type="info">`
-- `<Warning>` → `<Callout type="warn">`
-- `<Danger>` → `<Callout type="error">`
-- `<AccordionGroup>` / `<Accordion>` → HTML `<details>` / `<summary>` elements
-
-### 3. Navigation Structure
-
-Created `meta.json` files for each folder:
-
-- `content/docs/meta.json` - Root documentation
-- `content/docs/overview/meta.json` - Overview pages
-- `content/docs/api/meta.json` - API reference
-- `content/docs/developer/meta.json` - Developer docs
-- `content/docs/plans/meta.json` - Plans/roadmap
-
-### 4. Link Fixes
-
-- Fixed incorrect `/guides/...` paths → `/overview/...`
-- All internal links now use correct paths
-
-### 5. Branding
-
-- Updated `lib/layout.shared.tsx` to use "Voicebox" as the nav title
-
-## File Structure
-
-```
-docs2/
-├── components/
-│   └── mintlify-compat.tsx    # Mintlify → Fumadocs component mappings
-├── content/docs/
-│   ├── meta.json              # Root navigation
-│   ├── overview/              # 12 MDX files
-│   ├── api/                   # 5 MDX files
-│   ├── developer/             # 12 MDX files
-│   ├── plans/                 # 4 MD files
-│   └── *.md                   # 4 root markdown files
-├── public/
-│   ├── images/                # 3 webp files
-│   └── logo/                  # 2 png files
-└── mdx-components.tsx         # MDX component configuration
-```
-
-## Icon Mapping
-
-The following icon strings are mapped to Lucide icons:
-
-- `microphone` → Mic
-- `film` → Film
-- `code` → Code
-- `shield` → Shield
-- `download` → Download
-- `rocket` → Rocket
-- `apple` → Apple
-- `windows` → Windows
-- `server` → Server
-- `user` → User
-- `waveform` → Waveform
-
-## Next Steps
-
-1. **Test the build**: Run `npm run build` (requires Node.js >= 20.9.0)
-2. **Start dev server**: Run `npm run dev` to preview
-3. **Customize styling**: Update `app/global.css` if needed
-4. **Add more icons**: Extend `iconMap` in `mintlify-compat.tsx` as needed
-5. **Review navigation**: Adjust `meta.json` files to customize page order
-
-## Notes
-
-- Image paths (`/images/...`) work as-is since Next.js serves from `public/`
-- All Mintlify components are now compatible with Fumadocs
-- Navigation structure follows Fumadocs conventions
-- No breaking changes to content - all MDX files work with compatibility layer

docs2/content/docs/AUTOUPDATER.md

@@ -1,203 +0,0 @@
----
-title: "Auto-Updater Documentation"
-description: "How Voicebox automatic updates work for users and developers"
----
-
-Voicebox includes automatic updates powered by Tauri's updater plugin. This document explains how it works for both users and developers.
-
-## 1. Generate Signing Keys
-
-Run this command to generate your signing keypair:
-
-```bash
-cd tauri && bun tauri signer generate -w ~/.tauri/voicebox.key
-```
-
-This creates:
-
-- **Private key**: `~/.tauri/voicebox.key` (keep this secret!)
-- **Public key**: `~/.tauri/voicebox.key.pub`
-
-## 2. Update Configuration
-
-Copy the content from `~/.tauri/voicebox.key.pub` and replace the placeholder in `tauri/src-tauri/tauri.conf.json`:
-
-```json
-{
-	"plugins": {
-		"updater": {
-			"pubkey": "PASTE_PUBLIC_KEY_CONTENT_HERE",
-			"endpoints": [
-				"https://github.com/YOUR_USERNAME/voicebox/releases/latest/download/latest.json"
-			]
-		}
-	}
-}
-```
-
-Update the endpoint URL with your actual GitHub username/organization.
-
-## 3. Building with Signatures
-
-When building releases, set these environment variables:
-
-**macOS/Linux:**
-
-```bash
-export TAURI_SIGNING_PRIVATE_KEY="$(cat ~/.tauri/voicebox.key)"
-export TAURI_SIGNING_PRIVATE_KEY_PASSWORD=""
-bun run build
-```
-
-**Windows PowerShell:**
-
-```powershell
-$env:TAURI_SIGNING_PRIVATE_KEY = Get-Content ~/.tauri/voicebox.key -Raw
-$env:TAURI_SIGNING_PRIVATE_KEY_PASSWORD = ""
-bun run build
-```
-
-## 4. GitHub Release Setup
-
-When you create a GitHub release, the build process will generate:
-
-- Installers for each platform
-- `.sig` signature files
-- `latest.json` update manifest
-
-### Manual Release Process
-
-1. Build the app with signing keys set
-2. Create a new GitHub release
-3. Upload all files from `tauri/src-tauri/target/release/bundle/`
-4. Create `latest.json` in your release assets:
-
-```json
-{
-	"version": "0.2.0",
-	"notes": "Bug fixes and improvements",
-	"pub_date": "2026-01-25T12:00:00Z",
-	"platforms": {
-		"darwin-aarch64": {
-			"signature": "CONTENT_FROM_.app.tar.gz.sig",
-			"url": "https://github.com/YOUR_USERNAME/voicebox/releases/download/v0.2.0/voicebox_0.2.0_aarch64.dmg"
-		},
-		"darwin-x86_64": {
-			"signature": "CONTENT_FROM_.app.tar.gz.sig",
-			"url": "https://github.com/YOUR_USERNAME/voicebox/releases/download/v0.2.0/voicebox_0.2.0_x64.dmg"
-		},
-		"linux-x86_64": {
-			"signature": "CONTENT_FROM_.AppImage.sig",
-			"url": "https://github.com/YOUR_USERNAME/voicebox/releases/download/v0.2.0/voicebox_0.2.0_amd64.AppImage"
-		},
-		"windows-x86_64": {
-			"signature": "CONTENT_FROM_.msi.sig",
-			"url": "https://github.com/YOUR_USERNAME/voicebox/releases/download/v0.2.0/voicebox_0.2.0_x64_en-US.msi"
-		}
-	}
-}
-```
-
-### Automated GitHub Actions (Recommended)
-
-Create `.github/workflows/release.yml`:
-
-```yaml
-name: Release
-
-on:
-  push:
-    tags:
-      - "v*"
-
-jobs:
-  release:
-    strategy:
-      matrix:
-        platform: [macos-latest, ubuntu-22.04, windows-latest]
-
-    runs-on: ${{ matrix.platform }}
-
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Setup Bun
-        uses: oven-sh/setup-bun@v1
-
-      - name: Install Rust
-        uses: dtolnay/rust-toolchain@stable
-
-      - name: Install dependencies (Ubuntu)
-        if: matrix.platform == 'ubuntu-22.04'
-        run: |
-          sudo apt-get update
-          sudo apt-get install -y libwebkit2gtk-4.1-dev libappindicator3-dev librsvg2-dev patchelf
-
-      - name: Install dependencies
-        run: bun install
-
-      - name: Build
-        env:
-          TAURI_SIGNING_PRIVATE_KEY: ${{ secrets.TAURI_SIGNING_PRIVATE_KEY }}
-          TAURI_SIGNING_PRIVATE_KEY_PASSWORD: ${{ secrets.TAURI_SIGNING_PRIVATE_KEY_PASSWORD }}
-        run: bun run build
-
-      - name: Upload Release
-        uses: softprops/action-gh-release@v1
-        with:
-          files: tauri/src-tauri/target/release/bundle/**/*
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-```
-
-Add your private key to GitHub secrets:
-
-- Go to Settings → Secrets and variables → Actions
-- Add `TAURI_SIGNING_PRIVATE_KEY` with the content of `~/.tauri/voicebox.key`
-- Add `TAURI_SIGNING_PRIVATE_KEY_PASSWORD` (empty string if no password)
-
-## Frontend Integration
-
-The frontend integration is complete with automatic update notifications and manual update checks:
-
-- **Update Notification Banner** - Appears automatically when updates are available
-- **Settings Panel** - Manual "Check for Updates" button in Settings tab
-- **Update Hook** - React hook handles all update operations
-
-See `docs/AUTOUPDATER_QUICKSTART.md` for a quick setup guide.
-
-## Security Notes
-
-- Never commit your private key to version control
-- Store private keys securely (use GitHub secrets for CI/CD)
-- The public key in `tauri.conf.json` is safe to commit
-- Updates are cryptographically verified before installation
-- HTTP endpoints are blocked by default (HTTPS only)
-
-## Testing Updates
-
-1. Build version 0.1.0 and install it
-2. Update version in `tauri.conf.json` to 0.2.0
-3. Build version 0.2.0 with signatures
-4. Create a local server or GitHub release with `latest.json`
-5. Run version 0.1.0 and trigger update check
-6. Verify update downloads and installs correctly
-
-## Troubleshooting
-
-**"Invalid signature" error:**
-
-- Verify public key matches the private key used to sign
-- Ensure signature files (.sig) are uploaded correctly
-
-**"No update available" when one exists:**
-
-- Check endpoint URL is correct
-- Verify `latest.json` format matches specification
-- Ensure version in latest.json is higher than current version
-
-**Build fails with signing:**
-
-- Confirm environment variables are set correctly
-- Check private key file exists and is readable
-- Verify private key format (should start with `dW50cnVzdGVkIGNvbW1lbnQ6`)

docs2/content/docs/AUTOUPDATER_QUICKSTART.md

@@ -1,129 +0,0 @@
----
-title: "Autoupdater Quick Start"
-description: "Quick guide to activate the Tauri v2 autoupdater"
----
-
-The Tauri v2 autoupdater has been fully configured and integrated. Follow these steps to activate it.
-
-## What's Already Done
-
-✅ Rust plugin installed and initialized
-✅ Tauri configuration set up with updater settings
-✅ Permissions granted for update operations
-✅ GitHub Actions workflow updated with signing support
-✅ Frontend components created and integrated
-✅ Update notifications on app startup
-✅ Manual update check in Settings tab
-
-## Required Steps (5 minutes)
-
-### 1. Generate Signing Keys
-
-```bash
-bun run generate:keys
-```
-
-This creates:
-
-- Private key: `~/.tauri/voicebox.key` (keep secret!)
-- Public key: `~/.tauri/voicebox.key.pub` (safe to share)
-
-### 2. Update Tauri Config
-
-Open `tauri/src-tauri/tauri.conf.json` and:
-
-1. Replace `"REPLACE_WITH_YOUR_PUBLIC_KEY"` with the content from `~/.tauri/voicebox.key.pub`
-2. Update the endpoint URL with your GitHub username:
-   ```json
-   "endpoints": [
-     "https://github.com/YOUR_USERNAME/voicebox/releases/latest/download/latest.json"
-   ]
-   ```
-
-### 3. Add GitHub Secrets
-
-Go to your repo Settings → Secrets and variables → Actions:
-
-1. Add `TAURI_SIGNING_PRIVATE_KEY`:
-
-   ```bash
-   cat ~/.tauri/voicebox.key
-   ```
-
-   Copy the entire output and paste as the secret value
-
-2. Add `TAURI_SIGNING_PRIVATE_KEY_PASSWORD`:
-   Leave empty (or add your password if you set one)
-
-### 4. Test the Setup
-
-To test locally before creating a release:
-
-```bash
-bun run build:release
-```
-
-This will verify your keys are set up correctly.
-
-## How It Works
-
-### For Users
-
-1. App checks for updates on startup (only in Tauri builds)
-2. If an update is available, a banner appears at the top
-3. Users can click "Install Now" to download and install
-4. App restarts automatically after installation
-
-### For Developers
-
-1. Create a new git tag: `git tag v0.2.0 && git push --tags`
-2. GitHub Actions builds signed releases for all platforms
-3. Uploads installers and generates `latest.json` manifest
-4. Users running older versions will be notified automatically
-
-## UI Components
-
-### Update Notification Banner
-
-- Shows at top of app when update is available
-- Appears automatically on startup
-- Displays download/install progress
-
-### Settings Panel
-
-- Located in Settings tab
-- Shows current version
-- Manual "Check for Updates" button
-- Update status and progress
-
-## Troubleshooting
-
-**"Public key not configured"**
-
-- Make sure you copied the entire content from `voicebox.key.pub`
-- The key should start with `dW50cnVzdGVkIGNvbW1lbnQ6`
-
-**"Failed to check for updates"**
-
-- Endpoint URL might be incorrect
-- No releases published yet (expected for first setup)
-
-**Build fails with signing error**
-
-- Check that GitHub secrets are set correctly
-- Verify private key file exists at `~/.tauri/voicebox.key`
-
-## Next Release Workflow
-
-1. Update version in `tauri/src-tauri/tauri.conf.json`
-2. Commit changes
-3. Create and push tag: `git tag v0.2.0 && git push --tags`
-4. GitHub Actions will automatically build and create a draft release
-5. Review the release and publish it
-6. Users will be notified of the update
-
-## See Also
-
-- Full documentation: `docs/AUTOUPDATER.md`
-- Build script: `scripts/prepare-release.sh`
-- GitHub workflow: `.github/workflows/release.yml`

docs2/content/docs/README.md

@@ -1,67 +0,0 @@
----
-title: "Documentation README"
-description: "Voicebox documentation development guide"
----
-
-This directory contains the documentation for Voicebox, built with [Fumadocs](https://fumadocs.dev).
-
-## Development
-
-### Prerequisites
-
-Install Mintlify globally using bun:
-
-```bash
-bun add -g mintlify
-```
-
-Or use the helper script:
-
-```bash
-bun run install:mintlify
-```
-
-### Running Locally
-
-```bash
-bun run dev
-```
-
-This will start the Mintlify dev server.
-
-The docs will be available at `http://localhost:3000`
-
-### Structure
-
-```
-docs/
-├── mint.json           # Mintlify configuration
-├── custom.css          # Custom styles
-├── overview/           # Getting started & feature docs
-├── guides/             # User guides
-├── api/                # API reference
-├── development/        # Developer documentation
-├── logo/               # Logo assets
-└── public/             # Static assets
-```
-
-### Writing Docs
-
-- Use `.mdx` files for all documentation pages
-- Follow the existing structure in `mint.json` for navigation
-- Use Mintlify components for enhanced formatting (Card, CardGroup, Accordion, etc.)
-- Reference the [Mintlify documentation](https://mintlify.com/docs) for available components
-
-## Deployment
-
-Docs are automatically deployed when changes are pushed to the main branch.
-
-To manually deploy:
-
-```bash
-mintlify deploy
-```
-
-## Contributing
-
-See [CONTRIBUTING.md](../CONTRIBUTING.md) for contribution guidelines.

docs2/content/docs/TROUBLESHOOTING.md

@@ -1,360 +0,0 @@
----
-title: "Troubleshooting Guide"
-description: "Common issues and solutions for Voicebox"
----
-
-Common issues and solutions for Voicebox.
-
-## Installation Issues
-
-### macOS: "Voicebox cannot be opened because it is from an unidentified developer"
-
-**Solution:**
-
-1. Right-click the `.dmg` file
-2. Select "Open"
-3. Click "Open" in the security dialog
-4. Alternatively, go to System Settings → Privacy & Security → Allow Voicebox
-
-### Windows: "Windows protected your PC"
-
-**Solution:**
-
-1. Click "More info"
-2. Click "Run anyway"
-3. Windows Defender may flag new software; this is normal for unsigned apps
-
-### Linux: AppImage won't run
-
-**Solution:**
-
-```bash
-chmod +x voicebox-*.AppImage
-./voicebox-*.AppImage
-```
-
-## Runtime Issues
-
-### Server won't start
-
-**Symptoms:** App opens but shows "Server not connected"
-
-**Solutions:**
-
-1. **Check Python installation**
-
-   ```bash
-   python --version  # Should be 3.11+
-   ```
-
-2. **Check server binary exists**
-
-   - Look in `tauri/src-tauri/binaries/` for your platform
-   - Binary should match your system architecture
-
-3. **Check permissions**
-
-   ```bash
-   # macOS/Linux
-   chmod +x tauri/src-tauri/binaries/voicebox-server-*
-   ```
-
-4. **Check logs**
-   - macOS: Open Console.app and search for "voicebox"
-   - Linux: Check `~/.local/share/voicebox/` for logs
-   - Windows: Check Event Viewer
-
-### "Model download failed"
-
-**Symptoms:** First generation fails with download error
-
-**Solutions:**
-
-1. **Check internet connection**
-
-   - Models download from HuggingFace Hub (~2-4GB)
-   - First download may take several minutes
-
-2. **Check disk space**
-
-   - Models are cached in `~/.cache/huggingface/`
-   - Ensure at least 5GB free space
-
-3. **Manual download** (if automatic fails)
-   ```bash
-   pip install huggingface_hub
-   huggingface-cli download Qwen/Qwen3-TTS-12Hz-1.7B-Base
-   ```
-
-### "Out of memory" errors
-
-**Symptoms:** Generation fails with CUDA/VRAM errors
-
-**Solutions:**
-
-1. **Use smaller model**
-
-   - Switch to 0.6B model instead of 1.7B
-   - Settings → Model Management → Load 0.6B
-
-2. **Close other applications**
-
-   - Free up GPU memory
-   - Close browser tabs, other ML apps
-
-3. **Use CPU mode**
-   - Slower but works without GPU
-   - Backend automatically falls back to CPU
-
-### MLX "Failed to load the default metallib" error (Apple Silicon)
-
-**Symptoms:** Generation fails with "library not found" or "metallib" errors
-
-**Solutions:**
-
-1. **Rebuild server binary**
-
-   ```bash
-   bun run build:server
-   ```
-
-   The build script should automatically include MLX Metal shader libraries.
-
-2. **Check MLX installation**
-
-   ```bash
-   pip install -r backend/requirements-mlx.txt
-   ```
-
-3. **Verify backend detection**
-   - Check server logs for "Backend: MLX"
-   - If showing "Backend: PYTORCH", MLX may not be installed correctly
-
-### Audio playback issues
-
-**Symptoms:** Generated audio won't play
-
-**Solutions:**
-
-1. **Check audio format**
-
-   - Audio is saved as WAV files
-   - Ensure your system supports WAV playback
-
-2. **Try downloading audio**
-
-   - Right-click → Download
-   - Play in external player
-
-3. **Check browser permissions** (web version)
-   - Allow audio autoplay in browser settings
-
-### Slow generation
-
-**Symptoms:** Generation takes >30 seconds
-
-**Solutions:**
-
-1. **Check backend type** (Apple Silicon)
-
-   - Check Settings → Server Status
-   - Should show "Backend: MLX" on Apple Silicon
-   - If showing "Backend: PYTORCH", install MLX: `pip install -r backend/requirements-mlx.txt`
-   - MLX provides 4-5x faster inference on Apple Silicon
-
-2. **Use GPU** (if available)
-
-   - Check Settings → Server Status
-   - Should show "GPU available: true"
-   - Apple Silicon: Should show "Metal (Apple Silicon via MLX)"
-   - Windows/Linux: Should show "CUDA" if GPU available
-
-3. **Enable caching**
-
-   - Voice prompts are cached automatically
-   - Second generation with same voice should be faster
-
-4. **Use smaller model**
-
-   - 0.6B model is faster than 1.7B
-   - Quality difference is minimal for most voices
-
-5. **Check system resources**
-   - Close other CPU/GPU intensive apps
-   - Ensure adequate RAM (8GB+ recommended)
-
-## API Issues
-
-### "Connection refused" when using API
-
-**Solutions:**
-
-1. **Check server is running**
-
-   ```bash
-   curl http://localhost:8000/health
-   ```
-
-2. **Check remote mode**
-
-   - If connecting remotely, ensure server is started with `--host 0.0.0.0`
-   - Check firewall settings
-
-3. **Check port availability**
-   - Default port is 8000
-   - Ensure no other service is using it
-
-### CORS errors in browser
-
-**Solutions:**
-
-1. **Use desktop app** (recommended)
-
-   - Desktop app doesn't have CORS restrictions
-
-2. **Configure CORS** (for web deployment)
-   - Update `backend/main.py` CORS settings
-   - Add your domain to allowed origins
-
-## Update Issues
-
-### "Update check failed"
-
-**Solutions:**
-
-1. **Check internet connection**
-
-   - Updates are fetched from GitHub releases
-
-2. **Check GitHub access**
-
-   - Ensure `github.com` is accessible
-   - Check firewall/proxy settings
-
-3. **Manual update**
-   - Download latest release from GitHub
-   - Install manually
-
-### "Invalid signature" error
-
-**Solutions:**
-
-1. **Re-download installer**
-
-   - Signature may be corrupted
-   - Download fresh copy from GitHub
-
-2. **Check release integrity**
-   - Verify `.sig` file matches installer
-   - Report issue if signature is invalid
-
-## Data Issues
-
-### Profiles disappeared
-
-**Solutions:**
-
-1. **Check data directory**
-
-   - macOS: `~/Library/Application Support/voicebox/`
-   - Windows: `%APPDATA%/voicebox/`
-   - Linux: `~/.local/share/voicebox/`
-
-2. **Check database**
-
-   - Database: `data/voicebox.db`
-   - Ensure file exists and is readable
-
-3. **Restore from backup**
-   - Profiles can be exported/imported
-   - Check for backup files
-
-### "Database locked" error
-
-**Solutions:**
-
-1. **Close other instances**
-
-   - Ensure only one Voicebox instance is running
-
-2. **Restart app**
-
-   - Close and reopen Voicebox
-
-3. **Check file permissions**
-   - Ensure database file is writable
-   - Check directory permissions
-
-## Development Issues
-
-### Build fails
-
-**Solutions:**
-
-1. **Check Rust installation**
-
-   ```bash
-   rustc --version
-   rustup update
-   ```
-
-2. **Check Tauri dependencies**
-
-   ```bash
-   cd tauri
-   bun install
-   ```
-
-3. **Clean build**
-   ```bash
-   cd tauri/src-tauri
-   cargo clean
-   cd ../..
-   bun run build
-   ```
-
-### API client generation fails
-
-**Solutions:**
-
-1. **Start backend server**
-
-   ```bash
-   bun run dev:server
-   ```
-
-2. **Check OpenAPI endpoint**
-
-   ```bash
-   curl http://localhost:8000/openapi.json
-   ```
-
-3. **Regenerate client**
-   ```bash
-   bun run generate:api
-   ```
-
-## Still Having Issues?
-
-1. **Check existing issues**
-
-   - Search GitHub issues for similar problems
-   - Check closed issues for solutions
-
-2. **Create new issue**
-
-   - Include:
-     - OS and version
-     - Voicebox version
-     - Steps to reproduce
-     - Error messages/logs
-     - Screenshots (if applicable)
-
-3. **Get help**
-   - Check documentation in `docs/`
-   - Review `backend/README.md` for API details
-   - See `CONTRIBUTING.md` for development help
-
----
-
-For more help, open an issue on [GitHub](https://github.com/jamiepine/voicebox/issues).