Family XP — Home is where the host is

The easiest install you've ever done

Copy this sentence, paste it into Claude (Desktop, Code — or any capable AI agent on your Mac), and press enter. The repo carries its own runbook that tells the agent exactly what to do — it installs everything, verifies it, and hands you your family's web address and passcode.

🤖 Copy → paste → done─☐✕

Set up https://github.com/mutaaf/family-xp on this Mac for my family — get me started.

Needs: a Mac that stays home + an AI assistant that can run commands.

Every kid gets a computer of their own

Their name on the sign-in card, their avatar, their wallpaper world, their secret passcode — set up by them, in an XP-style wizard. Then the OS goes to work.

🖥 Sign in─☐✕

The front door. Pixel avatars, one card per family member, your family's name on everything.

⭐ A kid's desktop─☐✕

Kid desktop with Today's Adventure and learning games

Fresh every morning. Today's Adventure speaks a word of the day and deals three activities. Login streaks pay XP. A desktop full of icons, zero ads.

🕹 A learning arcade that talks

Reading Arcade & Spelling Bee say the word out loud — pre-readers play everything. Math Blaster, Memory Match, Robot Playground (loops → typed code!), Circuit Lab with animated electrons, a real-physics slingshot lab, basketball & football IQ. Levels scale forever — past 1000.

🌐 Real websites, really theirs

One tap scaffolds a webpage, live for the whole house. The Code Editor shows the actual HTML. Paint drawings publish straight onto their page — and Grandma can sign the guestbook.

⭐ Quests that check the code

Missions mapped to real CS standards, auto-verified against the kid's actual work. "Add a second button" ✓ → confetti. Parents can add "Read a whole book with Dad — 100 XP".

🧹 Chores → XP → prizes

Kids tap "I did it!", you approve, XP lands. The Prize Counter reserves XP until you make it official. Every price and chore is yours to edit.

🛡 Parent HQ

Up to 10 kids. Approvals, XP bonuses with an audit ledger, quest editing, one-tap data export, resets, integrity checks. Atomic writes + nightly backups mean XP is never lost.

🔒 Private by architecture

One zero-dependency Python file on your Mac. Your kids' data never leaves the house — there is nowhere for it to go.

Prefer to do it yourself? Still 5 minutes

No AI needed — you need a Mac that stays home. That's the whole shopping list.

Get the folder. Download the ZIP, unpack it, and drag family-xp into your home folder.

Double-click install.command. If macOS hesitates: right-click → Open → Open. Answer one question — your family name.

Open your new address — like http://smithfamily.local/ — on any phone, tablet or laptop on your wifi. Hand the kids their sign-in cards.

Terminal person? git clone https://github.com/mutaaf/family-xp && cd family-xp && ./install.sh

Questions parents ask

Is it safe for my kids?

Everything runs and stays on your Mac — no cloud, no accounts, no tracking, no ads, no chat with strangers. Passcodes gate the portal; the trust model is "people in your house."

Does it need the internet?

No. It's built to work with the internet down. (The read-aloud voice needs a one-time iOS voice download.)

What if a kid forgets their passcode?

The Control Panel shows it, or "Redo setup" starts them fresh — XP and pages survive.

Can I change the prizes and chores?

All of it, live, from the parent desktop: chores, cadences, prize prices, even the quest missions.

What does it cost?

Nothing. Free, open source (MIT), no subscription — it's your computer doing the work.

FamilyXP