From bdf4758510257689cfb1203ddffb298e5ffe28ec Mon Sep 17 00:00:00 2001
From: teknium1 <teknium1@gmail.com>
Date: Mon, 2 Mar 2026 22:06:26 -0800
Subject: [PATCH] fix: show uv error on Python install failure, add fallback
 detection

The Windows installer was swallowing uv python install errors with
| Out-Null, making failures impossible to diagnose. Now:

- Shows the actual uv error output when installation fails
- Falls back to finding any existing Python 3.10-3.13 on the system
- Falls back to system python if available
- Shows helpful manual install instructions (python.org URL + winget)
---
 scripts/install.ps1 | 46 ++++++++++++++++++++++++++++++++++++++-------
 1 file changed, 39 insertions(+), 7 deletions(-)

diff --git a/scripts/install.ps1 b/scripts/install.ps1
index c9f65afe4..94fbd4f21 100644
--- a/scripts/install.ps1
+++ b/scripts/install.ps1
@@ -145,17 +145,49 @@ function Test-Python {
     # Python not found — use uv to install it (no admin needed!)
     Write-Info "Python $PythonVersion not found, installing via uv..."
     try {
-        & $UvCmd python install $PythonVersion 2>&1 | Out-Null
-        $pythonPath = & $UvCmd python find $PythonVersion 2>$null
-        if ($pythonPath) {
-            $ver = & $pythonPath --version 2>$null
-            Write-Success "Python installed: $ver"
+        $uvOutput = & $UvCmd python install $PythonVersion 2>&1
+        if ($LASTEXITCODE -eq 0) {
+            $pythonPath = & $UvCmd python find $PythonVersion 2>$null
+            if ($pythonPath) {
+                $ver = & $pythonPath --version 2>$null
+                Write-Success "Python installed: $ver"
+                return $true
+            }
+        } else {
+            Write-Warn "uv python install output:"
+            Write-Host $uvOutput -ForegroundColor DarkGray
+        }
+    } catch {
+        Write-Warn "uv python install error: $_"
+    }
+
+    # Fallback: check if ANY Python 3.10+ is already available on the system
+    Write-Info "Trying to find any existing Python 3.10+..."
+    foreach ($fallbackVer in @("3.12", "3.13", "3.10")) {
+        try {
+            $pythonPath = & $UvCmd python find $fallbackVer 2>$null
+            if ($pythonPath) {
+                $ver = & $pythonPath --version 2>$null
+                Write-Success "Found fallback: $ver"
+                $script:PythonVersion = $fallbackVer
+                return $true
+            }
+        } catch { }
+    }
+
+    # Fallback: try system python
+    if (Get-Command python -ErrorAction SilentlyContinue) {
+        $sysVer = python --version 2>$null
+        if ($sysVer -match "3\.(1[0-9]|[1-9][0-9])") {
+            Write-Success "Using system Python: $sysVer"
             return $true
         }
-    } catch { }
+    }
     
     Write-Err "Failed to install Python $PythonVersion"
-    Write-Info "Install Python $PythonVersion manually, then re-run this script"
+    Write-Info "Install Python 3.11 manually, then re-run this script:"
+    Write-Info "  https://www.python.org/downloads/"
+    Write-Info "  Or: winget install Python.Python.3.11"
     return $false
 }