scriptoriumadmin/fabro
1
0
Fork 0
mirror of https://github.com/fabro-sh/fabro.git synced 2026-08-28 05:27:41 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 4
fabro/apps/marketing/public/install.md
Bryan Helmkamp a8599a924f
feat(install): pivot happy path to fabro server start web wizard 
The primary install flow is now to start the server, complete setup in a
browser-based wizard, and restart. fabro install is retained as the
headless CLI-only alternative.

- Auto-open the install URL in the user's browser when fabro server start
  enters install mode; print a manual-open fallback when open::that fails
- Rewrite install.md so agents drive the full start → wait → restart loop
- Retarget install.sh Y/n prompt from fabro install to fabro server start
- Update README, quick-start, deploy-server, cli reference, and marketing
  captions to point at fabro server start as the next step after download
- Add troubleshooting entries for "wizard didn't open" and "server exited
  after wizard"

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-21 16:02:49 -04:00

2.4 KiB
Raw Blame History

fabro

AI-powered workflow orchestration platform. Workflows are defined as Graphviz graphs and executed by the Fabro engine.

I want you to install Fabro for me. Execute the steps below autonomously.

OBJECTIVE: Install the Fabro binary, then start the server so the user can finish setup in a web wizard, then restart the server in configured mode.

DONE WHEN: The Fabro server has been restarted after the wizard and is running in configured (non-install) mode.

1. Install the binary

Check whether Homebrew is available:

command -v brew

If brew is present, install via Homebrew (preferred — brew manages updates automatically):

brew install fabro-sh/tap/fabro-nightly

Otherwise, use the install script:

curl -fsSL https://fabro.sh/install.sh | bash

2. Verify the binary

fabro --version

This must print a version string like fabro 0.x.y before continuing.

3. Start the server to open the install wizard

Start the server in the foreground and capture its output:

fabro server start

The server will:

  • Detect that Fabro is unconfigured and enter install mode
  • Print a URL that looks like http://127.0.0.1:<port>/install?token=…
  • Attempt to open that URL in the user's default browser

Your job:

  • Read the server's stderr and find the http://…/install?token=… line
  • Open that URL in the user's default browser yourself as a safety net (the server also tries). Use open on macOS, xdg-open on Linux, or start on Windows. Duplicate opens are harmless.
  • Tell the user: "The Fabro install wizard is open in your browser. Complete it there; I'll restart the server when you're done."
  • Keep the fabro server start process running and watch for it to exit. The server exits on its own a moment after the user finishes the wizard.

4. Restart the server in configured mode

When the fabro server start process exits, start it again:

fabro server start

This time it will boot in configured (non-install) mode.

5. Confirm completion

Verify the server is running and no longer in install mode:

curl -fsS http://127.0.0.1:<port>/health

The response should not contain "mode": "install". If it does, the wizard wasn't completed — tell the user to finish it and wait for the server to restart again.

EXECUTE NOW: Complete steps 1–5. You are done when the restarted server reports a non-install health status.