Function runFullSetup

electron/main/python-setup.ts:295–336

(win: BrowserWindow, userData: string)

// ─── Public orchestrator ──────────────────────────────────────────────────────

export async function runFullSetup(win: BrowserWindow, userData: string): Promise<void> {
  try {
    const requirementsPath = getRequirementsPath()
    const venvDir = getVenvDir(userData)

    if (process.platform === 'linux' && app.isPackaged) {
      // AppImage: process.resourcesPath is ephemeral — copy Python to stable userData path first
      const pythonExe = await ensureStableEmbeddedPython(userData, win)
      await createVenv(pythonExe, venvDir, win)
      const venvPython = getVenvPythonExe(userData)
      await installRequirements(venvPython, requirementsPath, win)
    } else if (process.platform === 'win32' || app.isPackaged) {
      // Windows (dev + packaged) or macOS packaged: bundled Python path is stable
      const pythonExe = getEmbeddedPythonExe()
      if (!existsSync(pythonExe)) {
        throw new Error(
          'Bundled Python runtime not found.\n' +
          'Please reinstall the application.\n' +
          `(expected: ${pythonExe})`
        )
      }
      await createVenv(pythonExe, venvDir, win)
      const venvPython = getVenvPythonExe(userData)
      await installRequirements(venvPython, requirementsPath, win)
    } else {
      // Linux / macOS dev: use system Python
      win.webContents.send('setup:progress', { step: 'venv', percent: 5 })
      const python3 = findSystemPython()
      await createVenv(python3, venvDir, win)
      const venvPython = getVenvPythonExe(userData)
      await installRequirements(venvPython, requirementsPath, win)
    }

    win.webContents.send('setup:complete')
    console.log('[PythonSetup] Setup complete')
  } catch (err) {
    const message = err instanceof Error ? err.message : String(err)
    console.error('[PythonSetup] Error:', message)
    win.webContents.send('setup:error', { message })
    throw err
  }
}