chore(deploy): one-click launchers and HF Spaces Dockerfile

.dockerignore

@@ -0,0 +1,11 @@
+.venv
+__pycache__
+*.pyc
+node_modules
+web/dist
+server/static
+.pytest_cache
+.git
+docs
+*.md
+!README.md

Dockerfile

@@ -0,0 +1,23 @@
+# syntax=docker/dockerfile:1.6
+
+FROM node:20-alpine AS web
+WORKDIR /web
+COPY web/package*.json ./
+RUN npm ci --no-audit --no-fund
+COPY web/ ./
+RUN npm run build
+
+FROM python:3.11-slim
+ENV HF_HOME=/tmp/hf \
+    PYTHONUNBUFFERED=1 \
+    PORT=7860
+WORKDIR /app
+RUN apt-get update \
+    && apt-get install -y --no-install-recommends libsndfile1 ffmpeg \
+    && rm -rf /var/lib/apt/lists/*
+COPY requirements.txt ./
+RUN pip install --no-cache-dir -r requirements.txt
+COPY server/ server/
+COPY --from=web /web/dist server/static/
+EXPOSE 7860
+CMD ["uvicorn", "server.main:app", "--host", "0.0.0.0", "--port", "7860"]

scripts/start.bat

@@ -0,0 +1,2 @@
+@echo off
+powershell -ExecutionPolicy Bypass -File "%~dp0start.ps1" %*

scripts/start.ps1

@@ -0,0 +1,54 @@
+param(
+    [string]$BindHost = "127.0.0.1",
+    [int]$Port = 7860
+)
+
+$ErrorActionPreference = "Stop"
+$Root = Resolve-Path "$PSScriptRoot/.."
+Set-Location $Root
+
+$python = Get-Command py -ErrorAction SilentlyContinue
+if (-not $python) {
+    Write-Error "Python launcher 'py' not found. Install Python 3.11+ from python.org."
+    exit 1
+}
+
+if (-not (Test-Path ".venv")) {
+    Write-Host "==> Creating venv (.venv)"
+    & py -3.11 -m venv .venv
+}
+
+$activate = ".venv/Scripts/Activate.ps1"
+. $activate
+
+$reqHash = (Get-FileHash requirements.txt -Algorithm SHA1).Hash
+$marker = ".venv/.installed-marker"
+if (-not (Test-Path $marker) -or (Get-Content $marker) -ne $reqHash) {
+    Write-Host "==> Installing python deps"
+    pip install --upgrade pip
+    pip install -r requirements.txt
+    Set-Content $marker $reqHash
+}
+
+if (-not (Test-Path "web/node_modules")) {
+    Write-Host "==> Installing web deps"
+    Push-Location web
+    npm ci
+    Pop-Location
+}
+
+if (-not (Test-Path "server/static/index.html")) {
+    Write-Host "==> Building web"
+    Push-Location web
+    npm run build
+    Pop-Location
+    if (Test-Path "server/static") { Remove-Item -Recurse -Force "server/static" }
+    New-Item -ItemType Directory -Force "server/static" | Out-Null
+    Copy-Item -Recurse "web/dist/*" "server/static/"
+}
+
+$env:PYTORCH_ENABLE_MPS_FALLBACK = "1"
+$Url = "http://${BindHost}:$Port"
+Write-Host "==> Serving on $Url"
+Start-Process $Url
+uvicorn server.main:app --host $BindHost --port $Port

scripts/start.sh

@@ -0,0 +1,53 @@
+#!/usr/bin/env bash
+# One-click: venv -> install -> build SPA -> serve -> open browser.
+set -euo pipefail
+
+ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+cd "$ROOT"
+
+if command -v python3.11 >/dev/null 2>&1; then
+    PY=python3.11
+elif command -v python3 >/dev/null 2>&1; then
+    PY=python3
+else
+    echo "ERROR: python3.11 (or python3) not found. Install Python 3.11+." >&2
+    exit 1
+fi
+
+if [ ! -d .venv ]; then
+    echo "==> Creating venv (.venv) with $PY"
+    "$PY" -m venv .venv
+fi
+# shellcheck source=/dev/null
+. .venv/bin/activate
+
+REQ_HASH=$(shasum requirements.txt | awk '{print $1}')
+MARKER=".venv/.installed-marker"
+if [ ! -f "$MARKER" ] || [ "$(cat "$MARKER")" != "$REQ_HASH" ]; then
+    echo "==> Installing python deps"
+    pip install --upgrade pip
+    pip install -r requirements.txt
+    echo "$REQ_HASH" > "$MARKER"
+fi
+
+if [ ! -d web/node_modules ]; then
+    echo "==> Installing web deps"
+    (cd web && npm ci)
+fi
+
+if [ ! -d server/static ] || [ ! -f web/dist/index.html ]; then
+    echo "==> Building web"
+    (cd web && npm run build)
+    rm -rf server/static
+    mkdir -p server/static
+    cp -R web/dist/* server/static/
+fi
+
+export PYTORCH_ENABLE_MPS_FALLBACK="${PYTORCH_ENABLE_MPS_FALLBACK:-1}"
+HOST="${HOST:-127.0.0.1}"
+PORT="${PORT:-7860}"
+URL="http://$HOST:$PORT"
+
+echo "==> Serving on $URL"
+( sleep 2 && python -m webbrowser "$URL" ) &
+exec uvicorn server.main:app --host "$HOST" --port "$PORT"