Settings & Troubleshooting

Model storage

Use model controls to see what is installed, download a missing model, or remove a model you no longer use. Completed downloads should change to Ready automatically.

Theme and display

Choose the light or dark theme and use full-screen modes where available. Interface controls should remain usable at normal desktop scaling; report clipping with the affected view and display scaling.

Server status

BonzAI starts local AI services with the app. Status notifications show starting, ready, crashed, and restarting states. Automatic recovery uses limited retries rather than restarting forever.

Quick recovery checklist

1. Let the current download or generation finish.

2. Retry the operation once.

3. Choose a smaller model or lower resolution.

4. Close memory-heavy applications.

5. Restart BonzAI Desktop.

6. Confirm enough free disk space remains.

7. Open diagnostics and record the exact error if it repeats.

Keep data safe

Export important contribution packs, companion identities, memories, and generated work before removing local data or moving to another computer.