On-device models — run fully offline

Shipped

View as Markdown

Alongside the remote and local-server providers, Bring Your LM has a built-in llama.cpp inference engine. Point it at a folder of GGUF model files you supply and it runs them in-process, on the device, with nothing leaving it — no server to stand up, no URL, no API key.

Why it matters

It's the most private and the most self-contained way to run a model: fully offline, on hardware you already carry. You still bring the model — a GGUF file you downloaded or converted — but there's no service in the loop.

How it works

Add an On-device (llama.cpp) provider and give it a models directory. On desktop that's a path you type; on Android you grant a folder once and the app reads it through the system file-access framework. The directory is scanned recursively and each model file becomes selectable.

The on-device provider's form — models directory, compute backend, and decode threads, no API key

You assemble each model in the app rather than hand-editing anything. A model is built from:

The file picker only offers files that fit each slot and shows each file's size, so you don't pick a projector where a base model belongs. A model's name is derived from its components (with markers like "+ vision"), and you can override it.

Pick the compute backend per device — Auto lets llama.cpp choose, or pin CPU, Vulkan, or (on Linux) ROCm for an AMD GPU. This choice is saved on the device only, since the right hardware for a phone means nothing on a desktop. You can also set the number of decode threads (or leave it automatic, with a recommended value shown). Each reply's metrics show which backend it actually ran on.

What it doesn't do yet