explaingit

galaxl74/chore-champion

17Audience · ops devopsComplexity · 4/5ActiveLicenseSetup · hard

TLDR

Home Assistant package that turns kids' chores into a gamified daily mission list with XP, streaks, weekly cash allowance, and WhatsApp confirmations.

Mindmap

mindmap
  root((Chore Champion))
    Inputs
      Google Calendar events
      HA helpers and toggles
      WhatsApp replies
    Outputs
      Daily mission list
      XP and streaks
      Weekly cash allowance
      WhatsApp reminders
    Use Cases
      Family chore tracking
      Allowance automation
      Themed seasons
    Tech Stack
      Home Assistant
      YAML
      Anthropic API
      WhatsApp bridge
      Google Calendar

Things people build with this

USE CASE 1

Run a gamified chore tracker for your kids on a family Home Assistant setup

USE CASE 2

Pay a weekly allowance in euros based on a streak and completion table

USE CASE 3

Generate varied WhatsApp reminder messages with Claude via the Anthropic API

USE CASE 4

Tailor a daily mission list from recurring Google Calendar events

Tech stack

Home AssistantYAMLAnthropicWhatsAppGoogle Calendar

Getting it running

Difficulty · hard Time to first run · 1day+

Needs a working Home Assistant install plus button-card, mushroom cards, Google Calendar, an Anthropic API key, and a WhatsApp bridge.

MIT, free to use, modify, and redistribute with attribution.

In plain English

Chore Champion is a chore tracker for kids built on top of Home Assistant, the open-source home automation platform. The README describes it as gamified: the child sees a daily mission list on a phone dashboard, taps tasks to mark them done, earns experience points, builds streaks, and gets a weekly cash allowance in euros based on how much of the week they finished. The task list is not static. Each morning the system reads the family Google Calendar to figure out what kind of day it is, looking for specific recurring events titled swim_champ_morning, swim_champ_afternoon, or maths_teacher, plus a day-type selector for weekday, early school, weekend, or public holiday. From that, it picks the right combination of tasks from a fixed catalog like Empty lunchboxes, Homework, Prepare uniform, Pack school bag, Wash hair, and Charge and pack laptop, each with a fixed XP value of 10, 15, or 20. The reward math is laid out in tables. Streaks of 3 to 6 days multiply XP by 1.25, 7 to 13 by 1.5, and 14 or more by 2. Weekly completion of 100 percent pays 8 euros, 90 percent pays 7, dropping to zero below 50 percent. Two consecutive 90 percent weeks raise the cap to 10 euros, three or more to 12. Reminders and confirmation flow through WhatsApp using an HA WhatsApp bridge. The reminder text is generated by Claude through the Anthropic API so the messages vary instead of sounding robotic. When all tasks are marked done, the parent receives a WhatsApp message and replies champ approved to confirm, which triggers the XP award and streak update. The dashboard rotates through 12 themed 28-day seasons with custom hero images. Installation is involved. The README walks through creating about thirty Home Assistant helpers, input booleans for each task, input numbers for points and streaks, input text and datetime helpers, registering a Lovelace dashboard, copying YAML files for automations and scripts, and uploading 12 season images. It also lists prerequisites: button-card, card-mod, mushroom cards, Google Calendar integration, an Anthropic API key, and a WhatsApp bridge. License is MIT.

Copy-paste prompts

Prompt 1
Walk me through creating the thirty Home Assistant helpers Chore Champion needs and uploading the season images
Prompt 2
Show me how Chore Champion picks the daily task list from swim_champ_morning and day-type calendar events
Prompt 3
Help me wire the WhatsApp bridge plus an Anthropic API key so reminder messages get sent each morning
Prompt 4
Help me adjust the XP and allowance tables in Chore Champion to match a smaller weekly budget
Open on GitHub → Explain another repo

Generated 2026-05-22 · Model: sonnet-4-6 · Verify against the repo before relying on details.