feat(scripts): start.ps1 offers winget install of Python 3.11 + Node LTS; start.sh hints brew/apt

README.md

@@ -11,10 +11,19 @@ ZeroGPU-decorator-ready).
 
     ./scripts/start.sh
 
+Prereqs: Python 3.11+ and Node.js 20+. If missing, the script will tell you
+the one-line install command for your platform (`brew install python@3.11`
+on macOS, `apt install python3.11 python3.11-venv` on Debian/Ubuntu).
+
 ### Windows
 
     scripts\start.bat
 
+If Python 3.11 or Node.js LTS isn't installed, the script will detect that
+and offer to install them via `winget` (built into Windows 10 1809+ and
+Windows 11). Accept the prompt and re-run `scripts\start.bat` after install
+finishes so the new PATH takes effect.
+
 The script creates a venv, installs Python and Node deps, builds the SPA,
 and opens the studio at http://127.0.0.1:7860.
 

scripts/start.ps1

@@ -7,19 +7,65 @@ $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
+# ---------------------------------------------------------------------------
+# Prereq check + optional winget install
+# ---------------------------------------------------------------------------
+
+function Test-Py311 {
+    $py = Get-Command py -ErrorAction SilentlyContinue
+    if (-not $py) { return $false }
+    $listing = (& py -0 2>&1 | Out-String)
+    return ($listing -match "3\.11")
+}
+
+function Test-Node {
+    return [bool] (Get-Command npm -ErrorAction SilentlyContinue)
+}
+
+function Install-WithWinget($name, $id) {
+    $w = Get-Command winget -ErrorAction SilentlyContinue
+    if (-not $w) {
+        Write-Host ""
+        Write-Host "$name not found, and 'winget' is not available on this system."
+        Write-Host "Install $name manually, then re-run scripts\start.bat."
+        if ($name -eq "Python 3.11") {
+            Write-Host "  -> https://www.python.org/downloads/"
+        } elseif ($name -eq "Node.js LTS") {
+            Write-Host "  -> https://nodejs.org/"
+        }
+        exit 1
+    }
+    Write-Host ""
+    $resp = Read-Host "$name not found. Install now via winget ($id)? [Y/n]"
+    if ($resp -and ($resp -ne "y") -and ($resp -ne "Y")) {
+        Write-Host "Skipped. Install $name manually and re-run."
+        exit 1
+    }
+    Write-Host "==> Installing $name (this can take a couple of minutes)…"
+    & winget install --id $id -e --silent --accept-package-agreements --accept-source-agreements
+    if ($LASTEXITCODE -ne 0) {
+        Write-Error "winget install failed (exit $LASTEXITCODE)."
+        exit 1
+    }
+    Write-Host ""
+    Write-Host "==> $name installed."
+    Write-Host "    Close this window and run scripts\start.bat again so the new PATH takes effect."
+    exit 0
 }
 
+if (-not (Test-Py311)) { Install-WithWinget "Python 3.11" "Python.Python.3.11" }
+if (-not (Test-Node))  { Install-WithWinget "Node.js LTS" "OpenJS.NodeJS.LTS" }
+
+# ---------------------------------------------------------------------------
+# venv + Python deps
+# ---------------------------------------------------------------------------
+
 if (-not (Test-Path ".venv")) {
     Write-Host "==> Creating venv (.venv)"
     & py -3.11 -m venv .venv
 }
 
-$activate = ".venv/Scripts/Activate.ps1"
-. $activate
+. .venv/Scripts/Activate.ps1
 
 $reqHash = (Get-FileHash requirements.txt -Algorithm SHA1).Hash
 $marker = ".venv/.installed-marker"
@@ -30,6 +76,10 @@ if (-not (Test-Path $marker) -or (Get-Content $marker) -ne $reqHash) {
     Set-Content $marker $reqHash
 }
 
+# ---------------------------------------------------------------------------
+# web deps + build
+# ---------------------------------------------------------------------------
+
 if (-not (Test-Path "web/node_modules")) {
     Write-Host "==> Installing web deps"
     Push-Location web
@@ -47,6 +97,10 @@ if (-not (Test-Path "server/static/index.html")) {
     Copy-Item -Recurse "web/dist/*" "server/static/"
 }
 
+# ---------------------------------------------------------------------------
+# serve
+# ---------------------------------------------------------------------------
+
 $env:PYTORCH_ENABLE_MPS_FALLBACK = "1"
 $Url = "http://${BindHost}:$Port"
 Write-Host "==> Serving on $Url"

scripts/start.sh

@@ -10,7 +10,20 @@ if command -v python3.11 >/dev/null 2>&1; then
 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
+    echo "ERROR: python3.11 (or python3) not found." >&2
+    case "$(uname -s)" in
+        Darwin) echo "    Install with: brew install python@3.11" >&2 ;;
+        Linux)  echo "    Install with your package manager, e.g.: sudo apt install python3.11 python3.11-venv" >&2 ;;
+    esac
+    exit 1
+fi
+
+if ! command -v npm >/dev/null 2>&1; then
+    echo "ERROR: npm not found." >&2
+    case "$(uname -s)" in
+        Darwin) echo "    Install with: brew install node" >&2 ;;
+        Linux)  echo "    Install with your package manager, e.g.: sudo apt install nodejs npm" >&2 ;;
+    esac
     exit 1
 fi