---
title: "Install Fabricator"
description: "Download Fabricator for Windows or macOS, handle platform prompts, and understand app updates."
url: https://spatney.github.io/rayfin-fabricator/docs/start/install
markdown_url: https://spatney.github.io/rayfin-fabricator/docs/start/install.md
app_version: "1.20.1"
section: start
product: Fabricator
last_updated: 2026-10-14T22:09:52-07:00
source: start/install.mdx
---

# Install Fabricator

> Download Fabricator for Windows or macOS, handle platform prompts, and understand app updates.

Download Fabricator from the latest GitHub release, then launch it and complete setup.

## Windows

Fabricator ships a Windows NSIS installer. The installer mode is current-user, so it installs for your Windows account instead of requiring a machine-wide install.

1. Open the [latest Fabricator release](https://github.com/spatney/rayfin-fabricator/releases/latest).
2. Download `Rayfin Fabricator_<version>_x64-setup.exe`.
3. Run the installer.
4. If Windows SmartScreen appears, choose **More info → Run anyway**.
5. Launch **Rayfin Fabricator**.

The Windows release workflow signs the installer when the signing configuration is available. The expected publisher is Sachin Patney. SmartScreen can still warn for new or low-reputation downloads.

## macOS

Fabricator's macOS build is for Apple Silicon.

1. Open the [latest Fabricator release](https://github.com/spatney/rayfin-fabricator/releases/latest).
2. Download `Rayfin Fabricator_<version>_aarch64.dmg`.
3. Open the DMG and drag **Rayfin Fabricator.app** to **Applications**.
4. If macOS says the app is damaged or cannot be opened, clear the download quarantine flag once:

   ```bash
   xattr -dr com.apple.quarantine "/Applications/Rayfin Fabricator.app"
   ```

The release workflow builds an Apple Silicon DMG. When Apple notarization is not configured, macOS can quarantine the downloaded app even though it is the expected release artifact. Removing the quarantine flag lets macOS open the app.

## First launch

On first launch, Fabricator opens setup. Setup checks local tools, then asks you to sign in to GitHub Copilot and the Azure CLI. Continue with [Set up and sign in](https://spatney.github.io/rayfin-fabricator/docs/start/setup).

## Updates

Fabricator checks GitHub Releases for signed updater artifacts when the app starts, every 4 hours while it's open, and as soon as your internet connection comes back after a check failed. If a newer signed release exists, Fabricator downloads it in the background. To check right away, restart Fabricator.

When the check at startup finds an update, Fabricator shows **Update available** with **Update now** and **Later**. If you choose **Later**, Fabricator opens normally and keeps the ready-update banner visible. An update found while you work goes straight to the banner.

While an update is downloading or ready to install, the banner can show a `Downloading update <version>…` status, an `Update <version> is ready to install` status, **Later**, and **Restart & update**. Installing an update restarts Fabricator. Selecting **Later** on the banner puts the update off until Fabricator starts again.

A required-update screen exists in the app, but the normal startup check is optional.

## Uninstall

Uninstall **Rayfin Fabricator** with your operating system's app removal flow:

- On Windows, use **Installed apps** or **Apps & features**.
- On macOS, remove **Rayfin Fabricator.app** from **Applications**.

Uninstalling the app does not necessarily remove projects, settings, logs, or CLI credentials. See [Files and folders](https://spatney.github.io/rayfin-fabricator/docs/reference/files) for leftover data locations.