Add ARM builds and fix GitHub Actions deprecation notices

Expand portable binary builds to Linux/Windows ARM and macOS universal outputs, parameterize AppImage arch handling, update docs, and upgrade workflow actions to current majors to address Node runtime deprecation warnings.

Co-Authored-By: Oz <oz-agent@warp.dev>

Author: harrypm

.github/workflows/build-binaries.yml

@@ -20,56 +20,77 @@ jobs:
       fail-fast: false
       matrix:
         include:
-          - target: linux-appimage
+          - target: linux-appimage-x86_64
+            platform: linux
             os: ubuntu-22.04
-            artifact_name: ia-interact-linux-appimage
+            linux_appimage_arch: x86_64
+            artifact_name: ia-interact-linux-x86_64-appimage
             artifact_path: release/ia-interact-linux-x86_64.AppImage
-          - target: windows-exe
+          - target: linux-appimage-aarch64
+            platform: linux
+            os: ubuntu-24.04-arm
+            linux_appimage_arch: aarch64
+            artifact_name: ia-interact-linux-aarch64-appimage
+            artifact_path: release/ia-interact-linux-aarch64.AppImage
+          - target: windows-exe-x86_64
+            platform: windows
             os: windows-latest
-            artifact_name: ia-interact-windows-exe
+            windows_arch_suffix: x86_64
+            artifact_name: ia-interact-windows-x86_64-exe
             artifact_path: release/ia-interact-windows-x86_64.exe
-          - target: macos-app
-            os: macos-13
-            artifact_name: ia-interact-macos-app
-            artifact_path: release/ia-interact-macos.app.zip
-    defaults:
-      run:
-        shell: bash
+          - target: windows-exe-arm64
+            platform: windows
+            os: windows-11-arm
+            windows_arch_suffix: arm64
+            artifact_name: ia-interact-windows-arm64-exe
+            artifact_path: release/ia-interact-windows-arm64.exe
+          - target: macos-app-universal
+            platform: macos
+            os: macos-14
+            artifact_name: ia-interact-macos-universal-app
+            artifact_path: release/ia-interact-macos-universal.app.zip
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
 
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: "3.11"
-
-      - name: Install build dependencies
+      - name: Install build dependencies (Linux/macOS)
+        if: matrix.platform != 'windows'
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -r requirements-build.txt
+      - name: Install build dependencies (Windows)
+        if: matrix.platform == 'windows'
+        shell: pwsh
         run: |
           python -m pip install --upgrade pip
           python -m pip install -r requirements-build.txt
       - name: Build Linux AppImage
-        if: matrix.target == 'linux-appimage'
+        if: matrix.platform == 'linux'
         run: |
           chmod +x scripts/build-appimage.sh
-          scripts/build-appimage.sh
+          APPIMAGE_ARCH=${{ matrix.linux_appimage_arch }} scripts/build-appimage.sh
 
       - name: Build Windows .exe
-        if: matrix.target == 'windows-exe'
+        if: matrix.platform == 'windows'
+        shell: pwsh
         run: |
           pyinstaller --clean --onefile --name ia-interact ia-interact.py
-          mkdir -p release
-          cp dist/ia-interact.exe release/ia-interact-windows-x86_64.exe
+          New-Item -ItemType Directory -Path release -Force | Out-Null
+          Copy-Item dist/ia-interact.exe "release/ia-interact-windows-${{ matrix.windows_arch_suffix }}.exe"
 
-      - name: Build macOS .app bundle archive
-        if: matrix.target == 'macos-app'
+      - name: Build macOS universal .app bundle archive
+        if: matrix.platform == 'macos'
         run: |
-          pyinstaller --clean --onedir --windowed --name ia-interact ia-interact.py
+          pyinstaller --clean --onedir --windowed --target-architecture universal2 --name ia-interact ia-interact.py
           mkdir -p release
-          ditto -c -k --sequesterRsrc --keepParent dist/ia-interact.app release/ia-interact-macos.app.zip
+          ditto -c -k --sequesterRsrc --keepParent dist/ia-interact.app release/ia-interact-macos-universal.app.zip
 
       - name: Upload portable artifact
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v7
         with:
           name: ${{ matrix.artifact_name }}
           path: ${{ matrix.artifact_path }}
@@ -85,15 +106,15 @@ jobs:
       contents: write
     steps:
       - name: Download artifacts
-        uses: actions/download-artifact@v4
+        uses: actions/download-artifact@v8
         with:
           path: release-assets
 
       - name: Show release assets
         run: find release-assets -type f
 
       - name: Attach assets to GitHub Release
-        uses: softprops/action-gh-release@v2
+        uses: softprops/action-gh-release@v3
         with:
           files: |
             release-assets/**/*.AppImage

README.md

@@ -17,6 +17,9 @@ Use this script to list files, upload files, download files, delete files, move
     - [2. Setting Up the Script](#2-setting-up-the-script)
     - [3. Installing Python Libraries](#3-installing-python-libraries)
     - [4. Configuring Environment Variables](#4-configuring-environment-variables)
+    - [5. Build Local Portable Binaries](#5-build-local-portable-binaries)
+    - [6. GitHub Actions: Portable Releases](#6-github-actions-portable-releases)
+    - [7. Windows Python Mode Notes (from issue #1)](#7-windows-python-mode-notes-from-issue-1)
 - [Usage](#usage)
 - [Running the Script](#running-the-script)
     - [Script Options](#script-options)
@@ -154,28 +157,64 @@ The binary will be output to:
 On Windows, the file will be:
 
     dist/ia-interact.exe
-Build a Linux `.AppImage`:
+
+Build a Linux `.AppImage` (x86_64):
 
     chmod +x scripts/build-appimage.sh
     ./scripts/build-appimage.sh
-
-The AppImage will be output to:
+The x86_64 AppImage will be output to:
 
     release/ia-interact-linux-x86_64.AppImage
 
-# GitHub Actions: Portable Releases
+Build a Linux `.AppImage` (arm64):
+
+    APPIMAGE_ARCH=aarch64 ./scripts/build-appimage.sh
+
+The arm64 AppImage will be output to:
+
+    release/ia-interact-linux-aarch64.AppImage
+### 6. GitHub Actions: Portable Releases
 
 This repository includes:
 
     .github/workflows/build-binaries.yml
 
 The workflow builds portable release artifacts for:
-- Linux: `.AppImage`
-- Windows: `.exe`
-- macOS: `.app` packaged as `.app.zip`
+- Linux x86_64: `ia-interact-linux-x86_64.AppImage`
+- Linux arm64: `ia-interact-linux-aarch64.AppImage`
+- Windows x86_64: `ia-interact-windows-x86_64.exe`
+- Windows arm64: `ia-interact-windows-arm64.exe`
+- macOS universal (arm64 + x86_64): `ia-interact-macos-universal.app.zip`
 
 Each run uploads these as workflow artifacts.
 When you push a tag matching `v*` (for example `v1.0.0`), the workflow also publishes these files to the GitHub Release for that tag.
+### 7. Windows Python Mode Notes (from issue #1)
+Issue reference: `https://github.com/harrypm/IA-Interact/issues/1`
+
+The issue confirms the script can be run directly on Windows with Python.
+
+Recommended flow:
+1. Install Python on Windows and enable **Add Python to PATH** during install.
+2. Open `cmd` in the folder containing `ia-interact.py` (File Explorer address bar -> type `cmd`).
+3. Install dependencies:
+
+       python -m pip install requests tqdm
+
+4. Run the tool:
+
+       python -m ia-interact
+
+   Alternative:
+
+       python ia-interact.py
+
+5. Configure S3 keys before use (recommended: environment variables rather than hardcoding keys in the script).
+   - The issue notes also mention replacing `os.getenv("S3_ACCESS_KEY")` and `os.getenv("S3_SECRET_KEY")` inline in the script.
+   - If you do that for troubleshooting, keep it local-only and do not commit secrets.
+
+Large upload note from the issue:
+- In the upload flow, choosing **new folder** is more reliable for large uploads.
+- Using existing folder with `./` may return a `400` error.
 
 
 # Usage

scripts/build-appimage.sh

@@ -6,8 +6,25 @@ DIST_DIR="$ROOT_DIR/dist"
 BUILD_DIR="$ROOT_DIR/build"
 RELEASE_DIR="$ROOT_DIR/release"
 APPDIR="$ROOT_DIR/AppDir"
-APPIMAGE_TOOL="$ROOT_DIR/appimagetool-x86_64.AppImage"
-OUTPUT_APPIMAGE="$RELEASE_DIR/ia-interact-linux-x86_64.AppImage"
+APPIMAGE_ARCH="${APPIMAGE_ARCH:-x86_64}"
+
+case "$APPIMAGE_ARCH" in
+  x86_64)
+    APPIMAGE_TOOL_ARCH="x86_64"
+    ;;
+  aarch64|arm64)
+    APPIMAGE_ARCH="aarch64"
+    APPIMAGE_TOOL_ARCH="aarch64"
+    ;;
+  *)
+    printf 'Unsupported APPIMAGE_ARCH: %s\n' "$APPIMAGE_ARCH" >&2
+    printf 'Supported values: x86_64, aarch64 (or arm64)\n' >&2
+    exit 1
+    ;;
+esac
+
+APPIMAGE_TOOL="$ROOT_DIR/appimagetool-${APPIMAGE_TOOL_ARCH}.AppImage"
+OUTPUT_APPIMAGE="$RELEASE_DIR/ia-interact-linux-${APPIMAGE_ARCH}.AppImage"
 
 pyinstaller \
   --clean \
@@ -55,11 +72,11 @@ fi
 cp "$APPDIR/ia-interact.png" "$APPDIR/usr/share/icons/hicolor/256x256/apps/ia-interact.png"
 
 if [[ ! -x "$APPIMAGE_TOOL" ]]; then
-  curl -fsSL -o "$APPIMAGE_TOOL" "https://github.com/AppImage/AppImageKit/releases/download/continuous/appimagetool-x86_64.AppImage"
+  curl -fsSL -o "$APPIMAGE_TOOL" "https://github.com/AppImage/AppImageKit/releases/download/continuous/appimagetool-${APPIMAGE_TOOL_ARCH}.AppImage"
   chmod +x "$APPIMAGE_TOOL"
 fi
 
 mkdir -p "$RELEASE_DIR"
-ARCH=x86_64 APPIMAGE_EXTRACT_AND_RUN=1 "$APPIMAGE_TOOL" "$APPDIR" "$OUTPUT_APPIMAGE"
+ARCH="$APPIMAGE_ARCH" APPIMAGE_EXTRACT_AND_RUN=1 "$APPIMAGE_TOOL" "$APPDIR" "$OUTPUT_APPIMAGE"
 
 printf 'AppImage created at %s\n' "$OUTPUT_APPIMAGE"