Skip to content

Troubleshooting

When something goes wrong, Pyre tries to surface the cause instead of hiding it behind a raw error.

A generation errors out or hangs

What you see: a typed error, a Retry button, or a "Generating..." bubble that stalls.

Fix:

  • Tap Retry for transient failures.
  • Check provider status, key validity, network, and model name.
  • If the provider refused or failed and you have another provider configured, use smart fallback to retry the same turn elsewhere.
  • For local models, enable warm-up/preload and allow longer first-request time.

Android keeps in-flight generation alive with a foreground service if you minimize mid-stream.

A provider refuses

Smart fallback detects likely refusals conservatively and offers to retry on another provider. It never switches silently.

If the same provider keeps refusing, try a different model/provider or adjust your active preset.

A Creator build is incomplete

The Creator now uses fixed structured build passes. If a pass comes back short, Pyre continues it a bounded number of times and then shows any remaining gap as a note.

Fix:

  • Use a model that follows structured JSON well.
  • Check the recommended-models banner in the Creator.
  • If language or style is wrong, add a standing instruction in Your additions or ask the architect to revise before saving.
  • Edit fields manually in the Sheet before saving when only a small correction is needed.

QR pairing or browser pairing fails

Fix:

  • Make sure both devices are on the same trusted network.
  • Confirm the hub/server is enabled.
  • Use manual host/port/token if camera scanning fails.
  • For browser one-click pairing, approve the request on the desktop app. Headless hubs use token pairing instead.

Sync did not carry something across

Sync merges by record. The newest edit for a record wins, and chats merge as whole chat records.

Fix:

  • Use Force sync now.
  • Check both builds are compatible.
  • Avoid editing the same chat on two devices before either one syncs.
  • Remember that deletions propagate through tombstones, so a deleted item should not return after the next successful sync.

BotBooru does not embed

Embedded Discover depends on platform support:

  • Android and Windows embed.
  • Web/PWA embeds when served by a desktop or self-host hub with the separate-origin proxy available.
  • Linux may open externally.

If embed is unavailable, import by downloaded file or supported URL.

See also