From d78a08009a62aacb622f6e5c018e83007643a193 Mon Sep 17 00:00:00 2001 From: Rolando Santamaria Maso Date: Sun, 8 Nov 2026 12:58:08 +0100 Subject: [PATCH] Landing page: load release details reliably, add CLI-only install steps The page reads the latest release from GitHub's API in the browser. Its one request went to /releases/latest, which timed out or returned 504 for minutes at a time on Nov 8 while the release list answered in under a second, so visitors saw the placeholders in the file table and the commands. - Ask the release list first (first non-draft, non-prerelease entry), fall back to /latest, and give up on each request after 8 s. - Keep the last release seen in localStorage: repeat visits show it at once and keep it when GitHub can't be reached or rate-limits. - Filling the page twice (saved copy, then fresh data) is safe. - New "Only the CLI" steps (curl, tar, install into /usr/local/bin), linked from the download card and the CLI section, with the quarantine fix for browser downloads. README matches. - The verify steps fetch SHA256SUMS and its signature from the same release as the file. - site.js and site.css are versioned in index.html so the new HTML never runs against an hour-old cached script. Co-Authored-By: Claude Opus 5.5 --- README.md | 11 ++++- site/index.html | 29 ++++++++--- site/site.css | 3 ++ site/site.js | 127 ++++++++++++++++++++++++++++++++---------------- 4 files changed, 121 insertions(+), 49 deletions(-) diff --git a/README.md b/README.md index 6832ef7..5ddef70 100644 --- a/README.md +++ b/README.md @@ -28,7 +28,16 @@ A native macOS app for discovering, downloading and chatting with **MLX models f Later versions arrive through **MLX Runner → Check for Updates…**. The app checks GitHub at launch and every 6 hours; turn that off in Settings. -The CLI: unpack `mlxr--macos-arm64.tar.gz` and put `mlxr` on your `PATH`. +The CLI on its own (no app needed; [the landing page](https://mlx-runner.21no.de/#cli-install) fills in the latest version): + +```bash +curl -LO https://github.com/BackendStack21/mlx-runner/releases/download/v/mlxr--macos-arm64.tar.gz +tar -xzf mlxr--macos-arm64.tar.gz +sudo mkdir -p /usr/local/bin +sudo install -m 755 mlxr--macos-arm64/mlxr /usr/local/bin/mlxr +``` + +A browser download is quarantined by macOS and the binary won't start until you run `xattr -d com.apple.quarantine /usr/local/bin/mlxr`. The CLI doesn't update itself: repeat the steps for a new version. ### Verifying a download diff --git a/site/index.html b/site/index.html index 589ef95..9a2e06e 100644 --- a/site/index.html +++ b/site/index.html @@ -33,9 +33,9 @@ - + - + @@ -290,6 +290,7 @@

mlxr, the same engine in your terminal.

  • mlxr serve <model> --port 1234
  • mlxr bench <model>
  • +

    No app needed: install only the CLI.

    zsh · M2 Pro
    @@ -403,7 +404,7 @@

    Get MLX Runner

    For Apple silicon Macs running macOS 15 or newer. Free and open source, MIT licensed.

    @@ -424,7 +425,23 @@

    Get MLX Runner

    First launch

    Drag MLX Runner to Applications. It is ad-hoc signed, not notarized by Apple, so macOS blocks the first launch: right-click it and choose Open, or run:

    xattr -dr com.apple.quarantine "/Applications/MLX Runner.app"
    -

    Updates then arrive through Check for Updates…, verified before they install. For the CLI, copy mlxr from the archive to a directory on your PATH.

    +

    Updates then arrive through Check for Updates…, verified before they install.

    +

    Only the CLI

    +

    mlxr is a single binary and doesn't need the app. In Terminal:

    +
    curl -LO https://github.com/BackendStack21/mlx-runner/releases/download/<tag>/mlxr-<version>-macos-arm64.tar.gz
    +tar -xzf mlxr-<version>-macos-arm64.tar.gz
    +sudo mkdir -p /usr/local/bin
    +sudo install -m 755 mlxr-<version>-macos-arm64/mlxr /usr/local/bin/mlxr
    +mlxr   # prints its usage line
    +

    Use curl as shown: macOS quarantines an archive downloaded in a browser, and the binary won't start until you run xattr -d com.apple.quarantine /usr/local/bin/mlxr. It uses the same model library as the app. To update, run the commands again (the CLI doesn't update itself). To check the archive first, see Verify.

    @@ -433,8 +450,8 @@

    Verify before you run it

    Every release is built by GitHub Actions from a tagged commit. Three independent checks prove the file you have is that build.

    1. Download the app, the checksum list and its signature

      curl -LO https://github.com/BackendStack21/mlx-runner/releases/download/<tag>/MLX-Runner-<version>-macos-arm64.dmg
      +curl -LO {url:sums}
      +curl -LO {url:sig}">
      curl -LO https://github.com/BackendStack21/mlx-runner/releases/download/<tag>/MLX-Runner-<version>-macos-arm64.dmg
       curl -LO https://github.com/BackendStack21/mlx-runner/releases/latest/download/SHA256SUMS
       curl -LO https://github.com/BackendStack21/mlx-runner/releases/latest/download/SHA256SUMS.sig