Frequently Asked Questions.
The basics
-
Is Rolo free?
Yes — Project Rolo is completely free and open source. Explore the GitHub Repo.
-
What operating systems does Rolo support?
Project Rolo currently only runs on Mac. The GitHub Repo is open source if you'd like to help expand to Windows and Linux!
-
Does Rolo send my data anywhere?
Nope. All files from chat, memory, and dreams are stored locally on your machine. The one exception is weather — Rolo does a one-time lookup of your approximate location from your IP address, then fetches weather from Open-Meteo using the coordinates. You can set your location manually or turn weather off entirely in Rolo's Command Center.
-
What files can Rolo eat?
Anything and everything. All eaten files go to Trash and are recoverable.
-
Does Rolo speak other languages?
Rolo currently only responds in English. If you'd like Rolo to learn new languages, you can add TranslateGemma to your repo.
-
Does running Rolo affect my battery life?
A little — similar to other always-on apps. The bigger variable is Rolo's brain: when he speaks, thinks, or dreams, Ollama runs the language model locally and briefly pegs CPU/GPU until the response finishes. If you're low on battery, hold off chatting until you're plugged in.
-
Can Rolo launch automatically?
Not built in yet — you have to open Rolo manually each time. To start him with your Mac in the meantime, add him as a login item: System Settings → General → Login Items & Extensions → Open at Login → +, and pick Rolo.app.
-
I have multiple monitors — where does Rolo live?
Rolo spawns in the bottom-right corner of your primary monitor when he first opens. From there he's a normal floating window — drag him onto any monitor or screen you like.
Setting up Rolo's brain
-
What is a "brain" and why does Rolo need one?
Rolo's brain is powered by a language model, which lets him understand your context and respond. The recommended default is the fine-tuned Gemma 3 4B model, pulled via Ollama (ollama pull hf.co/larawashington/rolo-brain). The file is ~3 GB and only downloads once.
-
How do I install Rolo's brain? (non-developer walkthrough)
No terminal required. Rolo's Command Center will also guide you through on first launch.
- Install Ollama. Download from ollama.com, open the
.dmg, drag Ollama into Applications, and launch it once. A llama icon appears in your menu bar — that means it's running. You can close the window. - Open Rolo. On first launch, Rolo detects his brain is missing and prompts: "Rolo needs to download his brain (~3 GB)." Click Download.
- Wait for the progress bar. Download takes 5–15 minutes on home wifi. Keep Rolo and Ollama open while it runs.
- Done. The window closes when the download finishes. To confirm: right-click Rolo → Open Command Center → Perception tab. The Ollama row should be green.
- Install Ollama. Download from ollama.com, open the
-
Can I use Rolo offline?
Yes — once his brain is downloaded, everything runs locally on your machine and doesn't require WiFi.
Using your own model or API
-
Can I use a different model?
Yes. Right-click Rolo → open Rolo's Command Center → Brain tab. Pick a provider (Ollama, OpenAI-compatible, Anthropic, Gemini, Hugging Face, DeepInfra), paste an API key if needed, hit Test Connection, then Save.
-
Are my API keys safe?
Yes. Keys are stored locally on your machine and only ever sent to the provider you chose. Rolo doesn't log them anywhere.
-
Will all features work with a different brain?
Most do — but tool use (weather, files, time) and idle speech bubbles currently only work with Ollama. You'll have to do a bit of tinkering in Rolo's codebase after switching brains.
Memory and dreams
-
How does Rolo remember things about me?
Rolo remembers in two ways. First, anything you directly enter in the Memory tab of Rolo's Command Center — hit Save and Rolo takes a quick nap, dreams, and transfers it into his long-term memory. Second, through chat: Rolo stores important details you share (names, events, preferences) and compiles them into memory while he sleeps.
-
Can I delete what Rolo remembers?
Yes. Open Rolo's Command Center → Memory tab → Clear User Profile to completely wipe Rolo's memory of you. (He'll be sad about it.)
Troubleshooting
-
Why is the Ollama row red?
Rolo can't reach his brain. Open the Ollama app from Applications (you should see the llama icon in your menu bar), then click Refresh all in Rolo's Perception tab. If it stays red, your firewall may be blocking it — or switch to a cloud brain in the Brain tab.
-
Why is my weather wrong, or showing the wrong city?
Open Rolo's Command Center → Weather tab → turn on Set my location manually and enter your coordinates. You can also switch weather providers there.