Use Logs, Diagnostics, and Reset
Read logs, create a support report, and reset the app safely.
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.
Open the app log
Goal
Collect recent technical details after reproducing a failure.
Before you start
Logs may include filenames, device information, model names, error text, and other context. In 1.8.0 they no longer contain her memories or the sentences she speaks, but do not post them publicly without review.
Steps
- Reproduce the problem once.
- Open Settings → Advanced → Developer Options.
- Under App Logs, select Open Logs.
- Note the approximate time of the failure and copy only the relevant section when possible.
Expected result
The detailed application log opens in the system’s default text viewer.
If something goes wrong
If the log is empty or does not open, use Diagnostics report → Save report instead. The app log and audit log serve different purposes; the app log is normally more useful for chat, voice, and startup failures.
Check the AI engine
Under Settings → Advanced → Developer Options, the AI engine row shows which Ollama version is answering and where it came from: built in, updated, GPU runtime (Windows), or your own Ollama. Select Check for engine update to look for a newer signed engine. The app downloads it from Ollama’s official release host and checks it before use. Switching restarts the AI engine, so an answer in progress stops. There is no update button for your own Ollama, because it is not ours to update. If a model download fails with a message that the model needs a newer Ollama, this row is where to look.
Save a diagnostics report
Goal
Create one text file describing the build, configuration, hardware, runtime state, and recent log activity for support.
Before you start
Privacy warning: Review the report before sending it. Local Waifu redacts license values, API keys, and Telegram tokens, but the report includes audio-device names and an app-log tail that is not fully content-filtered. Do not assume the UI phrase “No keys, no chat text” makes every line safe to publish.
Steps
- Reproduce the issue.
- Open Settings → Advanced → Developer Options.
- Under Diagnostics report, select Save report.
- Locate the revealed file named like
diagnostics-YYYYMMDD-HHMMSS.txt. - Open it in a text editor.
- Review every section, especially the recent app-log tail.
- Remove or redact private text, usernames, paths, device names, prompts, or other details you do not want to share.
- Attach the reviewed file to a private support message.
Expected result
A reviewed diagnostic text file is ready to send without exposing information you chose to remove.
If something goes wrong
If report creation fails, send the app version, platform, edition, exact error message, reproduction steps, and a reviewed excerpt from App Logs instead.
Reset all application data
Goal
Return the main application database and local content to a fresh state when repair is impossible or when intentionally starting over.
Before you start
Destructive action: Reset All is irreversible from within Local Waifu. Create a backup and export any characters you want to keep.
The reset deletes the database, characters, conversations, memories, and soul files. On macOS it also deletes portraits, generated images, voice references, and the natural voice engine’s working data. On Windows those folders (portraits, images, voice references) are left on disk, so delete the app data directory as well if you want them gone. It does not automatically remove the Direct license/trial record, cloud provider keys, connected-account credentials, or Telegram token from the secret store.
Steps
- Create a full backup and verify its folder, file count, and size.
- Export important characters separately.
- If you also want credentials removed, delete provider keys and use Settings → Telegram → Forget token + pin first.
- Open Settings → Advanced → Developer Options.
- Find Reset Database and select Reset All.
- At Sure?, select Yes, delete.
- Wait for All data deleted.
- Quit and restart Local Waifu as instructed.
Expected result
The main app data is cleared, and the application starts in a fresh state after restart. License, trial, provider, or Telegram credentials may remain unless removed separately.
If something goes wrong
- Do not repeat the reset if the app appears partially initialized; quit and reopen it first.
- On Windows, if you also want portraits, generated images, and voice references removed, delete
%APPDATA%\com.lumizone.localwaifu\with the app closed. - Do not attempt to copy a backup into the live data directory while Local Waifu is running.
- There is no complete Restore UI in version 1.8.0. Preserve the backup and contact support for a full restore procedure.