Six guides, grouped by what each one does. They are independent, so start wherever you like: learn to talk to her, give her a mind, add a voice if you want her to sound like somebody in particular, and teach her to do things whenever you feel like it.
How to actually talk to her — start her, send her away, speak instead of typing, set her up, and read back what you said.
Read this one first, then come back for a mind to put in her. Already set up? This is the page to come back to when you want to know why a button is there.
How to set up the AI model. She needs one of these to think — pick whichever suits you. They do not combine: one provider, one set of keys.
With an AI HAT+ 2 attached, the model runs on the NPU entirely on the Pi. Nothing leaves the machine and nothing costs per token.
The default and the easiest to start with: a free key, no account to manage, no billing. Five minutes and she starts answering.
Run her on Claude. It costs real money per token, but no key is ever written into her config and the whole setup is five commands.
How to set up text to speech. Separately from the mind: every reply she writes is also spoken.
A demo key and voice ship with the app, so she talks from the first launch. Setting up your own account is about getting your voice and not sharing a rate limit with everybody else on the free tier.
About agents — what they are and how to control them. Not setup, exactly, but the same family of job.
Including the ones that play music and video from your own folders and make the buddy dance along. The guide explains the contract, so writing your own is about thirty lines.