Installation
How to install OpenWaggle on macOS, Windows, or Linux.
Supported Platforms
- macOS (x64 + Apple Silicon)
- Windows (x64)
- Linux (x64)
Quick Install (macOS / Linux)
curl -fsSL https://raw.githubusercontent.com/OpenWaggle/OpenWaggle/main/scripts/install.sh | bashThe script downloads the latest release, verifies the SHA-256 checksum, and installs the app:
- macOS — copies
OpenWaggle.appto/Applications - Linux — installs the AppImage to
~/.local/binand creates a.desktopentry
Pre-Built Installers
Download the latest release directly from GitHub:
| Platform | Format | Link |
|---|---|---|
| macOS (Apple Silicon) | .dmg | GitHub Releases |
| macOS (Intel) | .dmg | GitHub Releases |
| Windows | .exe | GitHub Releases |
| Linux | .AppImage | GitHub Releases |
macOS Gatekeeper Note
OpenWaggle is currently unsigned. On first launch, right-click the app and select Open to bypass Gatekeeper. If you used the install script, this step is not needed.
Building from Source
See Building from Source for instructions.
System Requirements
- A modern operating system (macOS, Windows 10+, or a recent Linux distribution)
- A Pi-supported provider authenticated through API key, OAuth, environment, or project/custom provider configuration (see Providers)
- Internet connection for hosted AI provider communication