Installing
The install command stops at step 1 or the window closes
Old copies of the install script could trip over PowerShell's Restricted
execution policy (the default on many consumer laptops). The current script
handles it automatically — just re-run the command; it's served live:
iex (irm https://yumii.me/install.ps1)The install seems frozen at step 2
Step 2 downloads a few hundred MB and can take 5–15 minutes. Two checks:
- Did you click inside the PowerShell window? Windows pauses a running program when you select text (QuickEdit mode). Click the window and press Enter — it resumes.
- Otherwise, watch Task Manager's network graph — if bytes are flowing, it's working.
Antivirus flags the app
Unsigned new executables occasionally trip heuristic scanners — a false positive common to young open-source apps. The source and build workflow are public; add an exception or build from source.
First launch
The progress bar is taking a while
First launch downloads her voice (~330 MB) and ears (~130 MB), one-time, with a live progress bar. On a slow connection this is minutes, not seconds. If a download fails she retries on her own — leave her be.
The orb says her backend couldn't start
The error card names the likely cause. Usual suspects: the install didn't finish (re-run the install command) or something unusual is blocking local ports — she tries 8000 through 8011 before giving up.
Talking
An error card appeared
That's her telling you exactly what's wrong — never a silent freeze:
| Card | Meaning → fix |
|---|---|
| Key problem | The API key is missing/invalid — the card links to the dashboard |
| Thinking limit | Free-tier quota hit (Ollama: weekly, Groq: daily). Wait for reset, or switch providers in Settings |
| Network | She can't reach the provider — check the connection |
She mishears me / cuts me off
- Mishears → switch STT to Groq Whisper (Settings → Ears) — markedly
more accurate — or raise local Whisper to
small. - Cuts you off mid-thought → she ends your turn after a brief silence; keep the sentence flowing. Background voices (TV) can steal turns — that's the mic, not a setting.
Her voice never plays
- Check the output device — she uses the system default.
- If you switched TTS providers, restart from the tray and confirm the provider's key/voice-ID are set.
A tool call failed
Free-tier models occasionally emit malformed tool calls; Yumii retries once and then apologizes out loud. Ask again — if it's constant on an exotic model, switch back to the default model name.
Tools
I connected Gmail but she says she can't access it
- Finish the browser sign-in completely (to Composio's success page).
- Give it ~10 seconds to propagate, then ask again — tools load the moment the connection lands, no restart needed.
- Confirm the toolkit shows in Dashboard → Tools.
The permission prompt never appeared
It shows on the orb window — if the orb is hidden (Ctrl+Shift+Space),
bring it back. An unanswered prompt times out as a denial; just ask again.
Settings
I changed a setting and nothing happened
Provider, model, and key changes apply at startup — quit from the tray and reopen. Personality applies live. The dashboard's save message tells you which kind you just made.
When you're stuck
Run the backend in a terminal and read the structured log — errors name
their cause (rate_limit_exceeded, stt_dropped, composio_load_failed):
yumii serverThen open an issue with the log tail — it's an experimental preview, and reports genuinely help.