Skip to content

feat: one-line curl|sh installer#13

Merged
sunrunnerfire merged 1 commit into
mainfrom
feat/curl-installer
May 31, 2026
Merged

feat: one-line curl|sh installer#13
sunrunnerfire merged 1 commit into
mainfrom
feat/curl-installer

Conversation

@sunrunnerfire
Copy link
Copy Markdown
Contributor

Adoption: gives non-Homebrew users a single-command install, shoring up the install story as the outreach posts start landing.

curl -fsSL https://raw.githubusercontent.com/Cerid-AI/quenchforge/main/install.sh | sh

What it does: resolves the latest release → downloads the universal darwin_all tarball (bundles both binaries) → verifies SHA-256 against checksums.txt → installs to /usr/local/bin (sudo only if needed) → gates on quenchforge-preflight (status=ok) → writes the LaunchAgent + prestart port guard via quenchforge install. Prints copy-paste next-steps (pull a model + bootstrap).

Design notes:

  • macOS-only; installs a per-user LaunchAgent on purpose — a system LaunchDaemon would be denied Metal GPU access (the daemon needs an Aqua session, ProcessType Interactive).
  • Doesn't auto-pull a model or auto-bootstrap a model-less daemon — those are explicit next-steps, since model choice is VRAM-dependent.
  • Knobs: QUENCHFORGE_VERSION (pin), QUENCHFORGE_PREFIX (relocate), QUENCHFORGE_NO_SERVICE=1 (binaries only).

Also: README Quickstart now leads with the one-liner; fixed the GitHub-release footer that pointed at a non-existent quenchforge-preflight_*_darwin_universal.tar.gz (real asset is quenchforge_<ver>_darwin_all.tar.gz).

Testing: shellcheck-clean, sh -n OK, goreleaser YAML parses; ran end-to-end against the live v0.8.1 release into a temp prefix with QUENCHFORGE_NO_SERVICE=1 — version resolution, download, checksum verify, extract, and preflight gate all confirmed (binaries land + quenchforge version = 0.8.1). The service-setup path is covered by TestInstall_WritesPlistAndPrestartGuard + was verified live earlier.

Add install.sh (served from main) so non-Homebrew users get a single-command
path:

  curl -fsSL https://raw.githubusercontent.com/Cerid-AI/quenchforge/main/install.sh | sh

It resolves the latest release, downloads the universal darwin_all tarball,
verifies SHA-256 against checksums.txt, installs both binaries to
/usr/local/bin, gates on quenchforge-preflight (status=ok), and writes the
LaunchAgent + prestart guard via `quenchforge install`. Knobs:
QUENCHFORGE_VERSION / QUENCHFORGE_PREFIX / QUENCHFORGE_NO_SERVICE. macOS-only;
per-user LaunchAgent on purpose (Metal needs an Aqua session).

Also: lead the README Quickstart with the one-liner; fix the GitHub-release
footer, which referenced a non-existent quenchforge-preflight_*_darwin_universal
asset (real artifact is quenchforge_<ver>_darwin_all.tar.gz).

shellcheck-clean; tested end-to-end against the live v0.8.1 release into a
temp prefix (download + checksum + extract + preflight all verified).
@sunrunnerfire sunrunnerfire merged commit 4eba606 into main May 31, 2026
6 checks passed
@sunrunnerfire sunrunnerfire deleted the feat/curl-installer branch May 31, 2026 20:02
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