Skip to content

chore(install): deprecate legacy installer scripts; sync zh-TW README to launcher#319

Merged
lstein merged 2 commits into
masterfrom
lstein/chore/deprecate-old-installers
Jun 8, 2026
Merged

chore(install): deprecate legacy installer scripts; sync zh-TW README to launcher#319
lstein merged 2 commits into
masterfrom
lstein/chore/deprecate-old-installers

Conversation

@lstein

@lstein lstein commented Jun 8, 2026

Copy link
Copy Markdown
Owner

What & why

The native desktop installer (INSTALL/launcher/, shipped to Releases) now supersedes the old hand-rolled installer scripts. Those scripts are orphaned — nothing referenced them except the Traditional-Chinese README. Per the migration plan we deprecate them for one cycle (rather than deleting outright) and bring the zh-TW README in line with the launcher-based English README.

Changes

  • INSTALL/install_linux_mac.sh, INSTALL/install_windows.bat, INSTALL/lib/windows.ps1 — add a DEPRECATED comment header and an on-run banner that points users at the desktop installer and the PyPI (uv tool install photomapai --torch-backend auto) path. The shell and PowerShell scripts now prompt for confirmation before proceeding, so anyone who still relies on them can opt in; nothing is removed yet.
  • README.zh-TW.md — replace the script-based Quick Start (which was the only remaining reference to install_linux_mac.sh) with the desktop-installer + PyPI flow mirroring README.md, and fix stale docs anchors (#docker-install#alternative-docker, #pypi-installation#alternative-install-from-pypi, #executable-install#manual-installation-from-source). Feature sections and the Chinese search-phrase examples are preserved.

Notes

  • bash -n passes on install_linux_mac.sh. pwsh wasn't available in the sandbox to parse-check the PS1, but the edit is a straightforward Write-Host/Read-Host/if block in the file's existing style.
  • The stale 0.3.0 plist version and the editable-install footgun the cleanup plan mentioned live inside install_linux_mac.sh; they're now moot (the script is deprecated and the launcher's macOS bundle stamps its version from Info.plist.template).
  • Follow-up: actually delete these scripts in a later release once the deprecation cycle is over.

🤖 Generated with Claude Code

… to launcher

The native desktop installer (INSTALL/launcher/) now supersedes the hand-rolled
shell/batch/PowerShell installers. Mark those scripts as deprecated rather than
removing them yet (one-cycle deprecation), and bring the Traditional-Chinese
README in line with the launcher-based English README.

- install_linux_mac.sh / install_windows.bat / lib/windows.ps1: add a
  DEPRECATED comment header and an on-run banner pointing at the desktop
  installer / PyPI; the shell and PS1 scripts prompt for confirmation before
  continuing. The legacy scripts still function for anyone who opts in.
- README.zh-TW.md: replace the script-based Quick Start with the desktop-
  installer + PyPI flow mirroring README.md, and fix stale docs anchors
  (#docker-install -> #alternative-docker, etc.). This was the only remaining
  reference to install_linux_mac.sh.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@lstein lstein merged commit 2f576ff into master Jun 8, 2026
9 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant