Skip to content

Install Pyre

Pyre runs on Android, Windows, Linux, and in a browser. Pick your platform below. Whatever you choose, nothing happens until you connect a provider — Pyre is bring-your-own-key.

Beta builds

Pyre is in public beta. Release builds live on the project's Releases page. Desktop builds are unsigned for now, so your OS may cry "unknown publisher" — the source is open, so you can always build it yourself and trust no one but you.

Android

  1. Download app-release.apk from the latest release.
  2. Your browser or files app will ask permission to install from this source. Allow it, then tap the APK.
  3. Open Pyre and head to More → API Connections to add your provider and key.

Why sideload?

Sideloading is the normal way to install a beta you trust. Pyre disables Android auto-backup, so your data and keys never quietly wander off into a cloud backup, and it asks for only the permissions it needs (internet + network state).

Windows

  1. Download the Windows .zip from the latest release and unzip it. Keep the whole folder together — pyre.exe needs its sibling DLLs and the data/ folder right next to it.
  2. Run pyre.exe. SmartScreen may warn on an unsigned app — choose More info → Run anyway.
  3. Open More → API Connections to add your provider and key.

Windows also gets the embedded BotBooru browser, plus system tray, shortcuts, and completion toasts.

Linux

Build from source for now — prebuilt Linux binaries are coming via CI. See Build from source below. Linux gets the desktop niceties (tray, shortcuts, window-state); the BotBooru browser opens in your external browser.

Web / browser

The web build runs through a desktop hub: turn on the LAN server on a desktop install, then open its address in any browser on your network. The desktop makes the AI calls with its securely-stored key, so the browser never sees yours. Full setup in Cross-device sync.

Build from source

Prerequisites: Flutter and the toolchain for your target (Android SDK + Java 17 for the APK; the Visual Studio C++ workload for Windows; standard build tooling for Linux).

flutter pub get
flutter run                     # debug, on any connected device
flutter test                    # unit tests
flutter build apk --release     # Android
flutter build windows --release # Windows
flutter build linux --release   # Linux

Updating

Pyre checks for a newer version on startup and tells you when one's out — it never auto-updates behind your back. Grab the new build the same way you got the first one; your local data stays exactly where it is.

See also