Install WhosWhoZoo

Self-hosted personal AI memory. You'll create a few free or low-cost accounts, then paste your keys into a short web wizard — no download, nothing to run — and a couple of minutes later you'll have your own private copy running in your own Cloudflare account.

What you're setting up

You own everything. All your data stays in your Cloudflare account.

Step 1 — Create a Cloudflare account

1. Go to cloudflare.com and click Sign Up
2. Sign up with your email — you don't need a domain. No credit card is required for the base app (Workers and KV are both on Cloudflare's free tier).

Want to attach photos to people? Photos use Cloudflare R2 object storage — free tier is 10 GB/month, which is more than enough. However, Cloudflare requires a credit card on file to activate R2, even at $0. You can skip this now and add it later in the Cloudflare dashboard under R2 Object Storage. If R2 isn't set up, the app works normally and photo features stay hidden.

Step 2 — Create a Cloudflare API token

1. Log in to the Cloudflare dashboard
2. Click your profile icon (top right) → My Profile → API Tokens
3. Click Create Token
4. Click Get started next to Create Custom Token (do not use a template — they don't include all the permissions the setup wizard needs)
5. Name it whoszoo
6. Under Permissions, add these five rows:
   • Account → Workers Scripts → Edit
   • Account → Workers KV Storage → Edit
   • Account → Workers R2 Storage → Edit (optional — enables photo attachments; requires CC on your Cloudflare account)
   • Account → Cloudflare Pages → Edit
   • User → API Tokens → Edit
7. Under Account Resources, select Include → your account name
8. Continue to summary → Create Token
9. Copy the token — you'll only see it once. Paste it somewhere safe.

Step 3 — Anthropic API key

1. Go to console.anthropic.com and sign up
2. Add a payment method (you'll need at least $5 in prepaid credits to start)
3. Go to API Keys → Create Key, name it "whoszoo"
4. Copy the key — it starts with sk-ant-

Step 4 — OpenAI API key

1. Go to platform.openai.com and sign up
2. Add a payment method
3. API Keys → Create new secret key, name it "whoszoo"
4. Copy the key — starts with sk-

Step 5 — ElevenLabs (optional)

Adds two extra voices: Brittney and Callum. Skip if you're happy with Marin and Onyx.

1. Go to elevenlabs.io and create a free account
2. Click Developers in the left sidebar → API Keys → Create API Key
3. Name it whoszoo
4. Under Restrict Key, turn the toggle on, then set:
   • Text to Speech → Access
   • Everything else → No Access
5. Click Create and copy the key
6. Add some credit: your account menu (top right) → Subscription → ElevenAPI tab → Add credits

Step 6 — Run the setup wizard

Go to whoszoo.app/setup and paste your license key to begin. Then step through one screen per item you collected above: your Cloudflare API token, your first name, your Anthropic key, your OpenAI key, and (optionally) your ElevenLabs key. Each key has a Test this key button — it validates live before you can move on, so a typo shows up on the spot, not after deploy.

On the last step you'll see the Access Key screen — on a fresh install there's nothing to do here, a new Access Key is generated automatically. Tap Deploy and the wizard creates your KV storage, deploys your Worker, stores your API keys as secrets, and creates your 12 memory files — all inside your own Cloudflare account. Takes about a minute.

You're set up.

App URL:       https://whoszoo-worker.xxx.workers.dev
Access Key:    abc123xyz...

Step 7 — Connect the app

1. Open the App URL printed at the end of setup
2. Paste your Worker URL and Access Key
3. Choose a passphrase (12+ characters — this is what you'll type every time you open the app)
4. Tap Set Up

On future visits, just enter your passphrase. Chrome/Safari will offer to save it for Face ID or Touch ID after first login.

After setup — delete your Cloudflare token

Recommended, not required. Once the app is running, your Cloudflare API token has no further job — the Worker reaches your memory through internal bindings wired up during setup, not through the Cloudflare API. Delete it and everything keeps working exactly as it does now.

You'll need to create a fresh token (same steps, same permissions, about a minute) the next time you run the setup wizard to update. Please don't skip updates to avoid this — running an old version is a bigger risk than briefly holding a token. Your memory, passphrase, and Access Key are untouched either way.

Step 8 — Start adding memory

The app starts empty. Just talk to it. Tell it about someone you know:

I met Jamie Chen today. Product manager at Figma, been there 3 years. We met at the design conference.

The app proposes saving it to your memory; confirm and it's stored. Type /help in the chat any time to see all available commands.

Costs

At normal use (10-30 questions/day):

Run /costs in the app any time to see your actual Anthropic spend. There's also a Daily spend cap in Settings — defaults to $1/day, so a runaway loop can't burn through your credits.

Troubleshooting

"Could not load memories" — Check your Worker URL (no trailing slash) and Access Key match what setup printed. Open /diagnostics in the app.

The wizard says your Cloudflare token didn't validate — Make sure your token has Workers Scripts: Edit and Workers KV Storage: Edit permissions. Try creating a new token with the Custom Token option (Step 2 above) rather than a built-in template.

Deleted your token after setup, as recommended, and now need to update? Create a fresh one first — same steps and permissions as Step 2. It takes about a minute, and you can delete it again once the update finishes.

The wizard says "Setup didn't finish" or a key won't test — Usually transient. The error screen has a Retry button, and it's safe to retry without losing anything you've already entered. A corporate VPN or firewall can occasionally block the check — try disconnecting and testing again.

Forgot your passphrase — On the login screen, tap "Forgot passphrase? Use access key to reset →". You'll need your Access Key.