Installation

Download the latest Braide build for your platform. Each link points at GitHub's releases/latest redirect, so it always fetches the newest version.

Download

PlatformArchitectureDownload
macOSApple Silicon (arm64)braide-mac-arm64.dmg
Windowsx64Installer (.exe) · Portable (.zip)
Windowsarm64Installer (.exe) · Portable (.zip)
Linuxx86_64AppImage (recommended) · Debian (.deb)
Linuxarm64AppImage (recommended) · Debian (.deb)

Linux: AppImage or .deb?

AppImage is the recommended Linux download, on arm64 in particular. It updates itself in place when you install an update from the toolbar's update button — no administrator privileges and no system package manager involved — so the one-click update path always works. See Software Updates for how the in-app updater works.

AppImage is a portable single file that runs from anywhere and self-updates without elevation. It requires FUSE 2 at runtime; on Ubuntu 24.04 (and other recent distributions) FUSE 2 is not installed by default. Install it with sudo apt install libfuse2t64, or run the AppImage once with --appimage-extract-and-run.

.deb is the better choice if you want full desktop integration — an application-menu entry, icon, and management through apt/dpkg. Its in-app update requires elevation: electron-updater installs the downloaded package with dpkg -i through pkexec, which depends on a running polkit authentication agent in your desktop session. Minimal, tiling-window-manager, headless, and SSH sessions often have no such agent, so the update fails with Command pkexec exited with code 127. When that happens, install the new package manually — the leading ./ is required so apt treats it as a local file rather than a repository package name:

sudo apt install ./braide-linux-arm64.deb

Supported Platforms

Braide runs on macOS, Linux, and Windows across x86_64 and arm64 architectures. See the Supported Platforms reference for the full compatibility matrix and platform-specific notes.

After Installation

Once Braide is installed, continue to the Quick Start to create your first project and run an agent session.