Skip to content

Install Pyre

Pyre has no account signup. Install the app for your platform, open it, and connect a provider when you are ready.

Android

  1. Download the Android APK from the latest release.
  2. Open it on your device.
  3. Allow install from that source if Android asks.
  4. Launch Pyre and continue through the welcome screen.

Android is the primary mobile experience. It supports chat, Creator, imports, Discover, sync client pairing, and foreground generation keep-alive.

Windows

  1. Download the Windows zip from the latest release.
  2. Unzip it and keep the folder together.
  3. Run pyre.exe.
  4. If SmartScreen warns, choose More info -> Run anyway if you trust the build.

Windows includes desktop features such as tray behavior, shortcuts, completion toasts, window persistence, LAN/web hub, and embedded BotBooru Discover through WebView2.

Linux

Download the Linux tarball from the latest release, extract it, and keep the folder together. Desktop features such as the hub, shortcuts, window state, and wide layout apply. Discover may open externally instead of embedded.

macOS

There is no packaged macOS build in the current public release, and macOS is not listed as a supported public target yet.

Web / PWA through your hub

Pyre's web app is served by a desktop or self-host hub. Open the hub address in a browser on your trusted network, pair it, and use Pyre without installing a native app on that machine.

The browser stores no API keys. Chat requests go through the hub's provider.

Self-host hub

For always-on web/sync access, run the headless hub. This path is experimental and intended for trusted networks or a server behind your own TLS reverse proxy/private tunnel.

When using the source tree that includes Dockerfile and pyre_server, the minimal Docker path is:

docker compose up -d --build
docker compose logs -f pyre

Then open http://<host>:6767 on your trusted network and pair the browser/client with the token shown in the logs.

The self-host hub defaults to port 6767. BotBooru embed uses a separate-origin proxy on 6768 by default. Put public deployments behind your own TLS reverse proxy or private tunnel rather than exposing the raw port.

Build from source

You need Flutter and the target platform toolchain.

flutter pub get
flutter run
flutter build apk --release
flutter build windows --release
flutter build linux --release

macOS is not a supported public target unless a release build is published.

Updating

Pyre checks for updates and shows an informational notice. It does not auto-update. Install the new build the same way you installed the first one; your local data stays in place.

See also