Documentation›Integrations, data, and support
38 Data and support

Understand Privacy and Data Storage

See what stays local, what can leave your PC, and how secrets are stored.

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.

Local Waifu is local-first, not “always local.” Local models, memories, and embeddings can remain on your computer, but cloud AI, cloud speech services, Telegram, and remote Ollama send selected data outside the local app.

Know what stays local and what can leave the computer

ActivityWhere data goes
Local chat through bundled OllamaProcessed on your computer
Memories and embeddingsStored locally; embeddings remain local even when chat uses a cloud provider
Local image generationProcessed on your computer
Local speech recognition and voiceProcessed on your computer
Cloud chat or image modelPrompt, relevant conversation context, and requested input go to the provider you selected
Cloud STT/TTSAudio or text required by that service goes to the selected provider
TelegramMessages and media pass through Telegram and the Local Waifu bot integration
Remote Ollama HostModel requests go to the configured network computer
Model downloads and update checksNetwork requests go to the relevant model host or update service
Screen awarenessFrames are looked at once in memory and thrown away; only her reaction is kept. With Allow a cloud vision model on and no local vision model, frames go to your cloud provider
RoutinesWeather, feeds, and search topics are fetched from their own sites. If your chat model is a cloud model, what a routine gathers goes to that provider
SongsThe lyrics, style, and theme go to fal.ai when you press Create the song
Hands-free listeningProcessed on your computer only. The audio is never saved and never leaves it
3D modelsModels you import stay on your computer

Important: Offline Mode blocks configured cloud model routes, but it does not make Telegram operate without Telegram’s servers, stop model downloads already requested, or block a custom network Ollama Host.

Locate your Local Waifu data

  • macOS: ~/Library/Application Support/com.lumizone.localwaifu/
  • Windows: %APPDATA%\com.lumizone.localwaifu\

The app data directory contains the database, character data, soul files, portraits, generated images, voice references, settings, logs, and secrets.json. Model files may occupy separate model directories shown under Settings → Performance → Storage.

Soul files containing personality, memory, and knowledge are encrypted with cocoon encryption. Their key material is tied to the original computer environment (on macOS it also uses the passphrase you set during onboarding). This is one reason a copied full data directory is not the recommended self-service migration method between computers.

The secrets.json file can contain cloud provider API keys, the Telegram bot token, and activation-related data. On Unix-like systems it is protected with owner-only file permissions, but anyone who can read your user account’s files may still read it. Protect the operating-system account and disk. Your license key is no longer readable or editable from the app window, and the app logs no longer contain her memories or the sentences she speaks.

Review and control permissions

Goal

Enable only the operating-system permissions needed for the features you use.

Before you start

Permissions are requested when a related feature is first used, not simply because the application launches.

Steps

  1. Enable microphone access only for dictation, voice calls, voice messages, or hands-free listening.
  2. Allow Screen Recording on macOS only if you turn on Screen awareness.
  3. Allow Reminders access on macOS only if you turn on the Reminder follow-up routine. macOS asks once, when you switch it on.
  4. Local Waifu does not read your calendar. The calendar feature was removed in 1.8.0.
  5. To revoke access later:
    • macOS: use System Settings → Privacy & Security and select the relevant category.
    • Windows: use Settings → Privacy & security and select the relevant permission.
  6. Keep Blur on Background enabled under Settings → General if you do not want conversation content visible when the window loses focus.

Expected result

Only the features you intentionally use have operating-system access. Disabling a permission blocks that feature but does not delete existing data.

If something goes wrong

If a feature remains denied after you change the operating-system setting, quit and reopen Local Waifu. For microphone failures, also verify the input device under voice-call settings.