Backup & restore
Pyre keeps your whole library on your device, so a backup is your portability and your safety net — move to a new phone, or recover after a wipe. This is how to export it, bring it back, and do both safely.
Full export & import
You can export the entire local store as a single file — characters, chats, lorebooks, presets, personas, and settings, all in one. Importing that file restores the lot. It's the clean way to move to a new device or to keep a snapshot before you experiment.
Selective backup
You don't have to take everything every time. A backup can be scoped to the categories you pick, so you can export, say, just your characters and lorebooks without dragging along every chat.
Key handling on export
Your API keys are excluded by default. Including them is opt-in, behind an explicit confirmation dialog — Pyre asks before it ever writes a secret into a backup file.
Don't share a keys-included backup
If you opt in to include keys, the backup file holds your provider secrets in the clear. Keep that file private and never hand it to anyone — a normal, keys-stripped backup is safe to move around; a keys-included one is not.
Getting the file where you want it
When you export, Pyre hands the file to your OS share sheet, so any transport you already trust can carry it: device-to-device transfer (Quick Share / AirDrop-style), a messaging app, or cloud storage. The share sheet also handles an exported card PNG the same way. Because it's a normal file, multi-megabyte backups move fine.
Importing safely
Restore is built to be forgiving, so a hand-edited or partially-corrupt backup still gives you back what it can:
- Size-capped at 50 MB, as a guard against runaway files.
- Tolerant JSON decoding — one bad record won't wipe out everything after it. Pyre parses integers, timestamps, and string lists leniently, clamps out-of-range timestamps, and depth-limits branch trees.
Merge, don't clobber
A merge import folds the backup's records into your existing library rather than replacing it wholesale, so you can pull in content from another snapshot without losing what's already there.
The Storage screen
More → Storage shows what's actually stored and surfaces import and parse diagnostics — for example, "this card had extension data we couldn't read." It's the place to look when an import didn't bring in quite what you expected.
Factory reset
If you want to start completely clean, Pyre can reset your local data from inside the app — no filesystem spelunking required. Reset is a separate, deliberate action from the everyday backup/import flow above, so it's hard to trigger by accident.
Note
Storage (under More → Storage) is about visibility and import diagnostics; Backup & Restore is its own More entry for exporting, importing, and resetting. Keep the two straight: one shows you what's there, the other moves or clears it.