Add stable release install flow

.github/workflows/release.yml

@@ -20,7 +20,7 @@ jobs:
           python-version: "3.13"
 
       - name: Install build dependencies
-        run: python -m pip install --upgrade pip pyinstaller pytest
+        run: python -m pip install --upgrade pip build pyinstaller pytest
 
       - name: Install package
         run: python -m pip install .
@@ -70,12 +70,55 @@ jobs:
             throw "Executable smoke test failed with exit code $($process.ExitCode)"
           }
 
+      - name: Build stable Python install asset
+        shell: pwsh
+        run: |
+          $dist = Join-Path $env:GITHUB_WORKSPACE 'dist'
+          Push-Location $env:RUNNER_TEMP
+          try {
+            python -m build $env:GITHUB_WORKSPACE --sdist --outdir $dist
+          }
+          finally {
+            Pop-Location
+          }
+
+          $sdist = @(Get-ChildItem -LiteralPath $dist -Filter '*.tar.gz')
+          if ($sdist.Count -ne 1) { throw "Expected 1 sdist, found $($sdist.Count)" }
+          Move-Item -LiteralPath $sdist[0].FullName -Destination (Join-Path $dist 'win-search-aliases-python.tar.gz') -Force
+          Get-Item -LiteralPath 'dist\win-search-aliases-python.tar.gz' | Format-List Name,Length,FullName
+
+      - name: Verify stable Python install asset
+        shell: pwsh
+        run: |
+          $installHome = Join-Path $env:RUNNER_TEMP 'release-python-asset-smoke'
+          python -m venv $installHome
+
+          $venvPython = Join-Path $installHome 'Scripts\python.exe'
+          & $venvPython -m pip install --upgrade 'dist\win-search-aliases-python.tar.gz'
+
+          $command = Join-Path $installHome 'Scripts\win-search-aliases.exe'
+          $uiCommand = Join-Path $installHome 'Scripts\win-search-aliases-ui.exe'
+          if (-not (Test-Path -LiteralPath $command)) {
+            throw "Installed command was not found: $command"
+          }
+          if (-not (Test-Path -LiteralPath $uiCommand)) {
+            throw "Installed UI command was not found: $uiCommand"
+          }
+
+          & $command --help
+
       - uses: actions/upload-artifact@v4
         with:
           name: win-search-aliases-ui-${{ github.ref_name }}-windows
-          path: dist/win-search-aliases-ui-${{ github.ref_name }}.exe
+          path: |
+            dist/win-search-aliases-ui-${{ github.ref_name }}.exe
+            dist/win-search-aliases-python.tar.gz
+            install.ps1
 
       - uses: softprops/action-gh-release@v2
         if: startsWith(github.ref, 'refs/tags/')
         with:
-          files: dist/win-search-aliases-ui-${{ github.ref_name }}.exe
+          files: |
+            dist/win-search-aliases-ui-${{ github.ref_name }}.exe
+            dist/win-search-aliases-python.tar.gz
+            install.ps1

CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## v0.1.2 - 2026-06-04
+
+### Changed
+
+- Switched the Python install flow to stable GitHub Release assets instead of installing from the `main` branch.
+- Release builds now publish a fixed-name `win-search-aliases-python.tar.gz` asset for `pip install` and include `install.ps1` next to the Windows `.exe`.
+- Updated the README and PowerShell installer so one-liner and manual installs both use the latest stable release.
+
 ## v0.1.1 - 2026-06-03
 
 ### Fixed

README.md

@@ -47,13 +47,13 @@ No Python is required, and after generation finishes you can start using Windows
 Installs the tool, adds it to `PATH`, runs automatic alias generation, and leaves everything ready to use:
 
 ```powershell
-powershell -ExecutionPolicy Bypass -c "iwr -useb https://raw.githubusercontent.com/mbv06/win-search-aliases/main/install.ps1 | iex"
+powershell -ExecutionPolicy Bypass -c "irm https://github.com/mbv06/win-search-aliases/releases/latest/download/install.ps1 | iex"
 ```
 
 ### Manual
 
-```bash
-python -m pip install --upgrade https://github.com/mbv06/win-search-aliases/archive/refs/heads/main.zip
+```powershell
+python -m pip install --upgrade https://github.com/mbv06/win-search-aliases/releases/latest/download/win-search-aliases-python.tar.gz
 ```
 
 Then run `win-search-aliases auto` or open the UI with `win-search-aliases-ui`.

install.ps1

@@ -14,7 +14,7 @@
 
 $ErrorActionPreference = 'Stop'
 
-$DefaultProjectSpec = 'https://github.com/mbv06/win-search-aliases/archive/refs/heads/main.zip'
+$DefaultProjectSpec = 'https://github.com/mbv06/win-search-aliases/releases/latest/download/win-search-aliases-python.tar.gz'
 $ProjectSpec = if ($env:WIN_SEARCH_ALIASES_PROJECT_SPEC) { $env:WIN_SEARCH_ALIASES_PROJECT_SPEC } else { $DefaultProjectSpec }
 $AppName = 'win-search-aliases'
 $MinMajor = 3

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "win-search-aliases"
-version = "0.1.1"
+version = "0.1.2"
 description = "Add managed app-search aliases to the internal Windows Search AppsIndex database (Windows 11 only)."
 readme = "README.md"
 requires-python = ">=3.11"