A comprehensive Home Assistant package that uses AI-powered image and video analysis to provide gentle, ADHD-friendly reminders for household tasks and dog walking. Features smart notifications via speakers, displays, and mobile devices with positive reinforcement and clear guidance.
- Gentle Reminders: Encouraging language instead of nagging
- Specific Tasks: AI provides actionable, detailed instructions
- Positive Reinforcement: Celebrates completed tasks with enthusiasm
- Multi-Modal Notifications: Audio (speakers) + Visual (displays) + Mobile
- Smart Timing: Context-aware reminders that adapt to activity patterns
- Kitchen Monitoring: Detects when kitchen needs cleaning with specific tasks
- Family Room Tracking: Identifies tidying needs with detailed task lists
- Dog Walk Detection: Video analysis for walk start/completion detection
- Enhanced Walk Returns: Specialized detection for low-light/obscured scenarios
- Multi-Camera Support: Primary + secondary camera angles for better coverage
- Targeted Messaging: Different notifications for family members vs. parents
- UNotify Integration: Rich notifications with audio, display, and mobile delivery
- Walk-in-Progress Awareness: Suppresses duplicate reminders during active walks
- Notification Cooldowns: Prevents ADHD-triggering notification spam
- Interactive Confirmations: Action buttons for unclear situations
- Dual-Sensor Logic: Requires both person and pet detection for reliability
- Video-Based Analysis: 30-second recordings with 15-second lookback
- Direction Detection: Distinguishes between starting and ending walks
- Walk-in-Progress Monitoring: Enhanced return detection during active walks
- Manual Override: User confirmation for ambiguous situations
The package uses a modular architecture with automated build system:
src/
├── automations/ # 15 automation components
├── sensors/ # Template sensors for status tracking
├── helpers/ # Input helpers for configuration
└── header.yaml # Package metadata
build-deploy.ps1 # Automated build and deployment
- 15 Automation Files: Each handling specific functionality
- Template Sensors: AI analysis status and system monitoring
- Input Helpers: Configurable settings and thresholds
- Variable Sensors: Unlimited storage for AI analysis results
- Build System: Automated concatenation and deployment
- Home Assistant 2025.8+
- AI Tasks integration (Google AI, OpenAI, or compatible)
- Variables + History integration (from HACS)
- UNotify integration for enhanced notifications
- Camera entities for monitoring areas
- Motion sensors for person/pet detection
This package uses the Variables + History integration for unlimited AI analysis storage. Create these variable sensors:
# Variable Sensor: sensor.kitchen_clean_status
# Purpose: Unlimited storage for kitchen AI analysis results
# Attributes: tasks, timestamp, analysis_details# Variable Sensor: sensor.family_room_tidy_status
# Purpose: Unlimited storage for family room AI analysis results
# Attributes: tasks, timestamp, analysis_details- Install Variables + History from HACS
- Go to Settings > Devices & Services > Variables
- Create variable sensors with the exact names above
- The automations will automatically populate them with AI results
-
Install Required Integrations:
# Install from HACS: - AI Tasks (Google AI/OpenAI/compatible) - Variables + History - UNotify -
Clone the repository:
git clone https://github.com/markaggar/ai-image-reminders.git cd ai-image-reminders
-
Create required variable sensors:
- Install Variables + History integration
- Create
sensor.kitchen_clean_status - Create
sensor.family_room_tidy_status
-
Configure entity names in Home Assistant:
- Update
input_texthelpers with your actual entity names:- Camera entities (
camera.kitchen,camera.family_room,camera.driveway) - Motion sensors (
binary_sensor.kitchen_person_motion, etc.) - AI Tasks entity (
ai_task.google_ai_task)
- Camera entities (
- Update
-
Deploy the package:
.\build-deploy.ps1 -
Import the dashboard:
- Copy contents of
dashboard-config.yaml - Go to Home Assistant > Settings > Dashboards
- Create new dashboard and paste the YAML configuration
- Copy contents of
-
Enable monitoring:
- Turn on
input_boolean.ai_detection_enabled - Enable specific monitoring:
kitchen_monitoring_enabled,family_room_monitoring_enabled,dog_walk_monitoring_enabled - Set notification target:
input_text.notification_target(liam/parents) - Configure notification settings
- Turn on
A comprehensive Home Assistant dashboard is included for easy system management:
- System Status: AI detection system overview and controls
- Kitchen Monitoring: Status, variable sensor data, and manual controls
- Family Room Monitoring: Status, analysis results, and configuration
- Dog Walk Tracking: Walk status, completion times, and manual overrides
- System Configuration: Entity settings, cooldowns, and integration setup
- Setup Guide: Built-in requirements and variable sensor creation instructions
- History Graphs: Visual timeline of analysis results
- Activity Log: Recent system events and changes
- Copy the contents of
dashboard-config.yaml - Go to Home Assistant Settings > Dashboards
- Click + Add Dashboard
- Choose "Take control" and paste the YAML configuration
- Save as "AI Image Reminders Control Center"
The dashboard provides a single control center for all system monitoring, configuration, and troubleshooting.
- Camera Entities: Configure your actual camera entity names
- Motion Sensors: Set up person and pet detection sensors
- AI Tasks: Ensure AI integration is configured and working
- UNotify: Set up for multi-modal notification delivery
- Notification Cooldown: 10-240 minutes (default: 30)
- Walk Completion Window: Auto-detect timeouts and thresholds
- Analysis Triggers: Motion-based timing for room analysis
- Message Targeting: Configure
liamvsparentsnotifications
- 🎵 Audio: Encouraging reminders via speakers
- 📺 Display: Visual notifications on TV/displays
- 📱 Mobile: Full notification experience
- 🎯 Content: Task reminders, walk prompts, positive reinforcement
- 📱 Mobile Only: Silent text notifications
- 📊 Status Updates: Completion confirmations and system status
- ❓ Decision Points: Unclear situations requiring input
- 🔕 No Audio/Display: Appropriate for remote/work situations
input_boolean.force_kitchen_checkinput_boolean.force_family_room_check
input_boolean.walk_in_progressinput_datetime.morning_walk_doneinput_datetime.evening_walk_done
input_boolean.ai_detection_enabled- Master system toggleinput_boolean.notifications_enabled- All notifications- Individual monitoring enables for each area
The modular build system automatically:
- Combines all source components
- Validates YAML syntax
- Deploys to Home Assistant
- Reloads configurations
- Archives previous versions
.\build-deploy.ps1 # Full build and deploy- Each automation is a separate file for easy development
- Template sensors provide system status and AI analysis
- Input helpers offer user-configurable settings
- Automated dependency management and validation
- AI Detection Status: Active, monitoring, checking, disabled
- Last Analysis Times: Kitchen, family room, driveway
- Walk Status: In progress, completion times, duration tracking
- Notification Cooldowns: Current status and remaining time
- Check entity availability in Developer Tools > States
- Verify AI Tasks integration is responding
- Confirm camera entities are accessible
- Test motion sensor triggering
This project is designed for ADHD-friendly home automation. Contributions should maintain:
- Gentle, encouraging language in all notifications
- Clear, specific task instructions
- Positive reinforcement patterns
- Accessible configuration options
This project is licensed under the MIT License - see the LICENSE file for details.
- Home Assistant community for the foundation
- AI Tasks integration developers
- UNotify integration for enhanced notifications
- ADHD community for guidance on supportive technology design
Version 1.0.0 - Complete ADHD-friendly home automation with AI-powered analysis, smart notifications, and comprehensive walk tracking. Ready for production use! 🎉