Repository navigation
v1.0.0 - Initial Release
Smart Comfort Climate v1.0.0 - Initial Release
🎉 First stable release of Smart Comfort Climate!
Transform your oversized AC unit into an intelligent comfort system that prioritizes how the air actually feels rather than just temperature.
✨ Key Features
🧠 Intelligent Comfort Control
- Feels-like temperature targeting - Set the comfort level you want (e.g., "I want it to feel like 72°F")
- Dew point science - Uses the most accurate humidity comfort metric
- Humidity-first logic - Prioritizes dehumidification to prevent muggy conditions
- Smart mode selection - Automatically chooses dry, cool, fan, or off modes
🏠 Complete Integration
- Main climate entity with feels-like temperature control
- Comfort sensors - dew point, feels-like temp, comfort status
- UI configuration - No YAML needed, configure through Home Assistant interface
- Intelligent logging - Clear explanations of every decision in the logbook
🌡️ Perfect For
- Oversized AC units that short-cycle
- Humid climates where temperature alone isn't enough
- Anyone who wants real comfort over simple temperature control
- Energy efficiency through smarter humidity management
📋 Requirements
- External temperature sensor - For accurate room readings
- External humidity sensor - Critical for dew point calculations
- Compatible climate entity - Your existing AC/heat pump
- Home Assistant 2023.4+ - For modern integration features
🚀 Installation
Via HACS (Custom Repository)
- HACS → Integrations → ⋮ → Custom repositories
- Repository:
https://github.com/yourusername/smart-comfort-climate - Category: Integration
- Install "Smart Comfort Climate"
- Restart Home Assistant
- Add Integration: Settings → Devices & Services → Smart Comfort Climate
Manual Installation
- Download and extract to
custom_components/smart_comfort_climate/ - Restart Home Assistant
- Add integration via UI
🎯 What's New in v1.0.0
Core Features
- ✅ Feels-like temperature control with dew point calculations
- ✅ Automatic humidity vs temperature prioritization
- ✅ UI-based configuration with entity selection
- ✅ Comprehensive comfort sensors and status tracking
- ✅ Intelligent climate mode selection logic
- ✅ Full Home Assistant integration standards compliance
Comfort Science
- ✅ Magnus formula dew point calculations
- ✅ Heat index for hot conditions
- ✅ Comfort zones: Oppressive (65°F+) → Perfect (45-55°F) → Dry (<45°F)
- ✅ Smart mode explanations in logbook
Entity Support
- ✅ Climate entity with Auto/Off modes
- ✅ Dew point sensor with temperature device class
- ✅ Feels-like temperature sensor
- ✅ Comfort status sensor with human-readable states
💡 Pro Tip
Want the perfect interface? Install the companion [Smart Comfort Thermostat Card](https://github.com/yourusername/smart-comfort-thermostat-card) for a beautiful, intuitive dashboard experience that makes the comfort science visual and easy to understand.
🐛 Known Issues
- None currently reported
📚 Documentation
- [Full README](README.md) - Complete setup and usage guide
- [Configuration Guide](README.md#configuration) - Step-by-step setup
- [Comfort Science Explained](info.md) - Why this works better
🤝 Support
- 🐛 [Report Issues](https://github.com/yourusername/smart-comfort-climate/issues)
- 💬 [Discussions](https://github.com/yourusername/smart-comfort-climate/discussions)
- 📧 Questions? Open an issue!
Enjoy perfect comfort control! 🌡️✨