Quickstart

First launch to first conversation, in about two minutes.

You've installed Yumii. Her first launch sets itself up — you make exactly one decision: which key powers her thinking.

She downloads her voice and ears

On first launch the orb shows a progress bar while her local models download — the voice (~330 MB) and the ears (~130 MB). One-time; after this they run offline on your CPU.

One key wakes her up

A card appears: "I just need a mind to think with." Click Get a free Ollama key (opens in your browser), paste it, and hit Wake her up. She restarts herself — no quitting, no digging through settings. (Prefer Groq or another provider? "more options" opens the dashboard.)

Tap the orb and talk

Allow microphone access and say hello. She listens continuously — no wake word, no push-to-talk. Try interrupting her mid-sentence: she stops and listens. That's not a bug, that's the point.

Things to try in your first five minutes

"Switch to tsundere." — her whole personality changes on the spot.
Tell her something about yourself. "I've got an interview Friday." Ask her about it tomorrow — she'll remember.
"Search the web for…" — a permission prompt appears before she acts. That gate guards every external action she ever takes.
"What did we talk about yesterday?" — she searches your past conversations and tells you.
Press Ctrl+Shift+Space — the hotkey hides and summons the orb from anywhere.

Where everything lives

Surface	What it's for
The orb	The conversation — tap to start, talk, interrupt freely. Drag it by grabbing it.
The dashboard	⚙ gear or tray → Dashboard: settings, keys, past chats, memory, tools
The tray icon	Show/hide, dashboard, quit

Free tiers have limits

Ollama's free tier has a weekly quota, Groq's a daily one. Normal conversation fits comfortably; if she hits a limit she says so with a clear error card — switch providers in the dashboard or wait for the reset. See Troubleshooting.

Next: Talking to Yumii, or Tools & Permissions to connect Gmail.