Documentation›Chat, memory, and characters
15 Everyday use

Export and Import a Character

Move one character between computers without mixing her data.

Local Waifu 1.8.0 macOS Windows
plain English first

Follow the bold button names and numbered steps. Technical names are included only when you need to recognize a model or file inside the app.

Character export is the recommended self-service method for moving a companion to another installation.

Export a character

Goal

Create a portable JSON file for one character.

Steps

  1. Open Settings → Characters.
  2. Find the character row.
  3. Select the export button (Export as JSON).
  4. Save the suggested file, named like localwaifu-character-YYYY-MM-DD.json.
  5. Store the JSON securely because it can contain private messages and memories.

Expected result

A JSON package contains the character and associated data such as messages, memories, relationship state, and knowledge entities.

Import a character

Goal

Create a new character from an exported JSON file.

Steps

  1. Open Settings → Characters.
  2. Select Import JSON.
  3. Choose the exported character file.
  4. Wait for the summary of imported messages, memories, and entities.
  5. Select the imported character.
  6. Send a message and confirm that she recalls the imported memories.

Expected result

The import creates a new character; it does not overwrite an existing one.

On macOS the export carries the stored semantic vectors, so recall works immediately after the import. On Windows the import stores the memories without vectors, so only memories created after the import take part in semantic recall; older ones stay reachable through the Memory Book and keyword matching.

If something goes wrong

  • Import failed: the JSON is damaged, incomplete, or incompatible. Export it again from the source installation.
  • Weaker recall right after an import is expected, and on Windows it is permanent for the imported memories rather than temporary. Keep the required memory model installed, and let the conversation continue so new memories do get vectors; keyword matching still finds the older ones.
  • Character export does not carry installed models, API keys, Telegram credentials, global preferences, or a Direct license activation.
  • Character export carries knowledge entities, not the relationships between them. Those are re-extracted as you keep chatting.
  • For a whole-app recovery, also keep a full backup. Version 1.8.0 has no button that restores a backup over your live data (Chapter 39).

Delete a character

Deleting a character is destructive and requires confirmation (Delete permanently). All memories, conversations, mood, knowledge, and XP are removed, and she is taken out of every group chat. A two-person group becomes a normal chat with the other character, keeping the messages you wrote there. The last remaining character cannot be deleted. If the deleted character was active, Local Waifu selects another available character. Export first if you may need the character later.