KidsChores is a powerful Home Assistant integration that transforms family chore management into a fun, engaging, and secure experience. Designed with both kids and parents in mind, it helps you assign tasks, track progress, and reward achievements—all while keeping your data local and private.
Important Notes:
- lease report any issues via GitHub Issues.
- Setup: The integration must be configured through the Home Assistant wizard. Follow the installation steps carefully.
- Ensure HACS is installed. If you haven't yet installed HACS, follow the HACS installation guide.
- In Home Assistant, navigate to HACS.
- Click the three-dot menu in the top-right corner and select "Custom repositories".
- Enter the repository URL:
https://github.com/ad-ha/kidschores-ha - Select "Integration" from the Category dropdown and click "ADD".
- Search for "KidsChores" in HACS and install the integration.
- Restart Home Assistant to apply the changes.
- Download the latest release from the KidsChores GitHub repository.
- Unzip the downloaded file and copy the
kidschoresdirectory to thecustom_componentsfolder in your Home Assistant configuration directory. - Restart Home Assistant to recognize the new integration.
- Go to Configuration > Integrations in Home Assistant.
- Click "+ Add Integration" and search for "KidsChores".
- Follow the setup wizard:
- Define Points Label: Choose your points name (e.g., Stars, Bucks, Coins).
- Add Kids & Parents: Create profiles for your kids and assign parents.
- Define Chores, Badges, Rewards, Penalties, Achievements, and Challenges: Provide detailed settings such as names, descriptions, points, icons, due dates, and recurring schedules.
- Finish the setup to start managing your kids’ chores and rewards directly from Home Assistant.
- Use the Options Flow to edit, add, or delete any entities as needed.
-
Profile Creation & Customization:
- Create and manage individual profiles for multiple kids and parents.
- Track each child’s progress, achievements, and performance with ease.
-
Effortless Management:
- Handle multiple kids with a single integration while monitoring individual statistics and trends.
- Personalize the points system by choosing your own name and icon (e.g., Stars, Bucks, Coins) to better resonate with your family.
-
Assign & Track Chores:
- Define chores with detailed descriptions, icons, due dates, and recurring schedules (daily, weekly, or monthly).
- Assign tasks to one or multiple kids and monitor each chore’s status (pending, claimed, approved, overdue, etc.) in real time.
-
Dynamic Chore States & Actions:
- Leverage dynamic buttons to claim, approve, or disapprove chores—completion with built-in authorization and contextual notifications.
- Monitor progress with sensors that update on a per-kid and global level.
-
Automated Rewards & Incentives:
- Award badges automatically when chore milestones are achieved.
- Enhance kids motivation with badge points multipliers.
- Track progress through streaks and cumulative totals, and even assign extra points for special achievements.
-
Reward Redemption:
- Kids can redeem rewards using their earned points. Parental approval is required to finalize any reward, ensuring accountability.
- Accountability Measures:
- Apply penalties for missed chores or behavior, automatically adjusting points and encouraging responsibility.
- Use penalty buttons for manual intervention when needed.
- Scheduled Task Management:
- Set up recurring chores with automated due date resets so that daily, weekly, or monthly tasks are always on track.
- Approval Processes:
- Both chores and reward redemptions require parental approval, adding an extra layer of oversight.
- Actionable notifications include contextual buttons (e.g., approve, disapprove and 30-minute reminder actions) to streamline the approval process.
-
Comprehensive Sensors:
- Track daily, weekly, monthly, and cumulative metrics on chore completions, points earned, rewards redeemed, badges awarded, penalties applied, and more.
-
Historical Data & Trends:
- Analyze long-term progress to identify trends, celebrate improvements, or pinpoint areas that need attention.
- Build your own statistics from the sensors available and options inside Home Assistant.
-
🛠 Dynamic Buttons & Actions:
- Manage chores and points directly from the Home Assistant UI with buttons for claiming, approving, redeeming, and adjusting points.
-
🔧 Easy Setup & Maintenance:
- Enjoy a user-friendly setup wizard and comprehensive configuration menus to add, edit, or delete kids, chores, badges, rewards, penalties, achievements, and challenges.
-
🌐 Multilingual Support:
- Currently available in English and Spanish to cater to a diverse user base.
- KidPointsSensor: Displays each kid's total points.
- KidPointsEarnedDaily/Weekly/MonthlySensor: Monitor points earned over various time frames.
- KidMaxPointsEverSensor: Shows the highest points total ever reached by a kid.
- CompletedChoresTotal/Daily/Weekly/MonthlySensor: Track chore completions over different periods.
- ChoreStatusSensor: Displays the current status (pending, claimed, approved, overdue) for each chore and kid.
- ChoreStreakSensor: Tracks the current streak (in days) for a chore per kid.
- SharedChoreGlobalStateSensor: Provides a global view of shared chore statuses.
- KidBadgesSensor & KidHighestBadgeSensor: Monitor the number of badges earned and the highest badge achieved.
- BadgeSensor: Individual sensor per badge, detailing threshold values and recipients.
- RewardClaimsSensor, RewardApprovalsSensor & RewardStatusSensor: Track reward claims, approvals, and current reward statuses per kid.
- ChoreClaimsSensor & ChoreApprovalsSensor: Count how many times a chore has been claimed or approved.
- PenaltyAppliesSensor: Logs the number of times each penalty is applied.
- PendingChore/RewardApprovalsSensor: Lists chores or rewards awaiting parental approval.
- AchievementSensor & ChallengeSensor: Provide details on specific achievements or challenges (including names, targets, rewards, and counts).
- AchievementProgressSensor & ChallengeProgressSensor: Show progress percentages toward each target per kid.
- KidHighestStreakSensor: Displays the highest current streak among streak-based achievements.
-
Chore Actions:
Claim, approve, and disapprove chores directly from the Home Assistant interface. -
Reward Actions:
Redeem rewards, with subsequent parental approval steps built in. -
Penalty & Points Adjustments:
Apply penalties or adjust points (e.g., +1, -1, +10, -10) using dedicated buttons. -
Workflow Buttons:
Utilize contextual, actionable notifications to streamline approvals.
KidsChores includes an interactive Options Flow that lets you easily manage:
- Kids & Parents
- Chores
- Badges
- Rewards
- Penalties
- Achievements
- Challenges
-
Local Data Storage:
All data is stored securely on your Home Assistant instance, ensuring your family’s information remains private. -
No External Data Sharing:
Your data never leaves your local network, keeping it safe from external access.
- Community Feedback:
Share your thoughts, feature requests, and improvements to help make KidsChores the ultimate family management tool.
KidsChores is designed to bring fun, structure, and accountability into your home. Whether you’re looking to better manage your kids’ daily routines or simply want to engage them with a rewarding system, KidsChores is here to help.
Get started today and transform how your family handles chores, rewards, and more!
Contributions are very welcome! If you have suggestions or encounter any issues:
- Open an issue.
- Submit a pull request.
This project is licensed under the GPL-3.0 license. See the LICENSE file for details.
THIS PROJECT IS NOT AFFILIATED WITH OR ENDORSED BY ANY OFFICIAL ENTITY. The information provided is for educational purposes only, and the developers assume no legal responsibility for the functionality or security of your devices.
