Skip to content

Fix: “Failed to load the model file”

This is not a crash — it's the bundled Understand AI server (undaiserver) failing to load the local GGUF model used for AI overviews and search.

What it means

The model file couldn't be loaded because it isn't a valid GGUF file or its format doesn't match what the loader expects (bad/incomplete download, wrong file, or signature mismatch).

Fix

  1. Re-download the model and make sure it's a complete GGUF file (not truncated, not a different format). Then point Understand at it again and retry.
  2. If you supplied a custom model, confirm it's GGUF — MLX/CoreML models are not supported directly; use a GGUF build, or run it through an LM Studio provider instead.

The same startup path can report:

  • Out of memory — the model is too large for available RAM/VRAM. Choose a smaller local model (see Choose a local LLM).
  • Context window too large — the configured context window is too large for the model or your system resources; reduce the context window size.

Get the diagnostics

On failure, Understand saves a diagnostics file and shows “AI generation failed: … For assistance, please contact [email protected].” The startup diagnostics are written to:

<user data dir>/undai/undaiserver/logs/startup_error_<timestamp>.txt

That directory (%LOCALAPPDATA%\undai\undaiserver\logs on Windows, ~/Library/Application Support/undai/undaiserver/logs on macOS, ~/.local/share/undai/undaiserver/logs on Linux) also holds the server's runtime logs. Attach the startup_error_*.txt file when you contact support.

To reproduce the failure directly — and see the model path and backend the server resolves — run the server's self-test from the Understand program directory:

undaiserver --self-test

See Run the Understand AI server for more on running and inspecting undaiserver (including the /healthz and /api/status checks and --log-level DEBUG).