← Back

🦉 Install WhosWhoZoo

Self-hosted personal AI memory. You'll create a few accounts, paste some API keys into a small installer, and ~5 minutes later you'll have your own copy running in your own Cloudflare account.

Total time: 20-30 minutes (mostly waiting for signup emails). The installer itself takes 2-3 minutes once you have your keys.

What you're setting up

PieceWhat it doesTypical cost
Cloudflare WorkerHosts the app and runs every requestFree tier
Cloudflare KVStores your memory files (plain markdown)Free tier
Anthropic ClaudeThe AI that answers from your memory~$1-3 / month
OpenAI TTSVoice responses (Marin + Onyx)< $1 / month
ElevenLabs (optional)Two extra voices (Brittney + Callum)Free tier ~10 min/mo

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 or a credit card

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. Find the Edit Cloudflare Workers template and click Use template
  5. Under Account Resources, set it to Include → All accounts
  6. Add one more permission: R2 Storage: Edit (for the installer self-distribution feature; setup continues without it but you lose the R2 integration)
  7. Continue to summary → Create Token
  8. 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.

Good news: ElevenLabs' free tier gives ~10 minutes of TTS per month for Brittney + Callum — enough for occasional use. No subscription required.
  1. Go to elevenlabs.io and create a free account
  2. Profile → API Key → copy

Step 6 — Download and run the installer

Pick your platform — single binary, no dependencies.
Windows .exe Mac Apple Silicon

Windows: Double-click whoszoo-setup.exe. SmartScreen will warn — click More info → Run anyway (the binary is unsigned because there's no central publisher).

Mac: Open Terminal (search "Terminal" in Spotlight) and run:

chmod +x ~/Downloads/whoszoo-setup-mac-arm64
codesign --sign - ~/Downloads/whoszoo-setup-mac-arm64
~/Downloads/whoszoo-setup-mac-arm64

If macOS still blocks it, go to System Settings → Privacy & Security and click Open Anyway.

The installer will ask for the things you collected above (Cloudflare token first, then your name, then API keys). It then deploys everything to your Cloudflare account automatically:

[1/4] Creating your memory storage...       ✓ whoszoo-memory
[2/4] Deploying your worker...              ✓ https://whoszoo-worker.xxx.workers.dev
[3/4] Storing your API keys securely...     ✓ 4 keys stored securely
[4/4] Creating your memory files...         ✓ 12 created

Setup Complete!

App URL:       https://whoszoo-worker.xxx.workers.dev
Access Key:    abc123xyz...
Save your App URL and Access Key. The Access Key is the master key to your install — needed to recover access if you forget your passphrase later. Screenshot it or write it down.

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 (8+ 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.

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):

ServiceEstimated monthly cost
Anthropic (Claude)$1-3
OpenAI (TTS, if used daily)< $1
CloudflareFree
ElevenLabs (optional)Free tier covers normal use

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.

Installer fails with SSL errors — You may be on a corporate VPN. Disconnect and try again.

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

← Back to whoszoo.app