gitwtfhub

wtf is chore-champion?

galaxl74/chore-champion — explained in plain English

Analysis updated 2026-05-18

16Audience · ops devopsComplexity · 4/5LicenseSetup · hard

TL;DR

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

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

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

REASON 2

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

REASON 3

Generate varied WhatsApp reminder messages with Claude via the Anthropic API

REASON 4

Tailor a daily mission list from recurring Google Calendar events

What's in the stack?

Home AssistantYAMLAnthropicWhatsAppGoogle Calendar

How it stacks up

galaxl74/chore-champion920linjerry-stack/capital-studioaahonarmand/neticu
Stars161616
LanguagePythonSwift
Setup difficultyhardeasyeasy
Complexity4/53/52/5
Audienceops devopsresearchergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

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.

Wtf does this do

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.

Yoink these 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

Frequently asked questions

wtf is chore-champion?

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

What license does chore-champion use?

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

How hard is chore-champion to set up?

Setup difficulty is rated hard, with roughly 1day+ to a first successful run.

Who is chore-champion for?

Mainly ops devops.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.