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 backend — Auto 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