Documentation

FAQ & troubleshooting

Quick answers to the most common questions and hiccups.

Windows says it "protected your PC"

Windows SmartScreen shows this for new, independently published apps until they build a reputation. If you downloaded the installer from llamaboss.com, choose More info → Run anyway. The app is open source, so you can inspect exactly what it does.

A model won't load, or loading fails partway

This is almost always memory. The model needs more VRAM (or RAM) than your machine has free. Try a smaller model from the curated list — the table there shows what each one needs. Closing other GPU-heavy apps (games, video editors, browsers with many tabs) also frees memory.

Responses are slow

Speed depends on your hardware and the model's size. If a model barely fits in VRAM, parts of it spill over to the much slower system RAM — stepping down one size usually makes a dramatic difference. On machines without a dedicated GPU, stick to the lightweight models; they're surprisingly capable.

The model doesn't understand my image

Only vision-capable models can see images — they're marked in the model list. If you're running a text-only model, images can't be interpreted. Download one of the vision models and the companion it needs comes along automatically.

How do updates work?

LlamaBoss checks for new versions and lets you know when one is available — you choose when to install. Updates replace the app only; your models, conversations, projects, and skills are untouched.

Where is my data?

Everything is on your own machine under C:\Users\<you>\AppData\Local\LlamaBoss — conversations, settings, models, and workspaces. Nothing is synced or sent anywhere. There's no account, and no telemetry.

Uninstalling

Remove LlamaBoss from Windows Settings → Apps like any other program. Downloaded models and your data folder may remain on disk so you don't lose gigabytes of downloads by accident — delete AppData\Local\LlamaBoss manually if you want everything gone.

Something else?

Open an issue on GitHub — bug reports and feature requests are both welcome.