Run a model fully offline

View as Markdown

You'll set up the embedded provider so a model runs entirely on your device from local files — no API key, no base URL, no network call.

What you need

Steps

  1. Open Providers and add a provider of kind Local llama.cpp (embedded). It has no base URL and no API key.

The embedded provider's form — a models-folder field and a compute backend (Vulkan), with no base URL or key

  1. Set the Models directory to the folder holding your .gguf files. On desktop, browse to the folder. On Android, grant a folder through the system file picker. The folder is scanned and each model file becomes selectable.

  2. Optionally choose the Compute backendAuto lets the engine decide, or set CPU or Vulkan explicitly (ROCm as well, on Linux). It's saved per device and applied the next time a model loads.

  3. Optionally cap Decode threads for CPU generation; leave it empty for an automatic count.

  4. Create an agent, choose this provider, and pick one of the scanned models. Start a conversation — generation runs in-process, on your hardware, with nothing leaving the device.

Make it yours