arizuko › products › Personal assistant (Fiu) › setup

Personal assistant setup

1. Prerequisites

A running instance (getting started).
TELEGRAM_BOT_TOKEN — the product declares it required, because a personal assistant with no channel is a directory.

2. Seed the instance from it

arizuko create fiu --product personal

That seeds the default group from the product tree. To add it to an existing instance as one more group instead:

arizuko group <instance> add telegram:user/12345678 me --product personal

3. Set the token

TELEGRAM_BOT_TOKEN=...
OPENAI_API_KEY=...   # optional: web search and oracle research

4. Seed what it should already know

facts/preferences.md is the difference between a generic assistant and yours. Write the things you would otherwise repeat: how you like drafts, what you are working on, timezone, who the recurring names are. It is a file — edit it whenever it is wrong.

Memory is per folder. The diary and facts/ belong to the group, so a second group is a second memory with nothing shared. That is the containment guarantee, not a limitation to work around: see scopes.

5. Verify

arizuko send <instance> me "what do you know about how I like drafts?" --wait

A correct answer quotes your preferences file. A generic answer means the seed did not land — check groups/me/facts/preferences.md.

6. Tuning

Voice — edit SOUL.md.
What it remembers — the agent appends to facts/ itself; prune it when it drifts. Stale preferences are the main failure mode of a memory product.
Reminders — ask it to schedule one and it creates a scheduled task. Tasks are DB rows, not a file in the folder.