hassette 0.15.0

Hassette is a simple, modern, async-first Python framework for building Home Assistant automations.

Hassette

A simple, modern, async-first Python framework for building Home Assistant automations.

Documentation: https://hassette.readthedocs.io

Why Hassette?

• 🌟 Modern developer experience with typed APIs, Pydantic models, and IDE-friendly design
• ⚡ Async-first architecture designed for modern Python from the ground up
• 🔍 Simple, transparent framework with minimal magic and clear extension points
• 🎯 Focused mission: does one thing well — run user-defined apps that interact with Home Assistant

AppDaemon User?

We have a dedicated comparison guide for AppDaemon users considering Hassette:

• AppDaemon Comparison

📖 Examples

Check out the examples/ directory for more complete examples:

• Based on AppDaemon's examples:
  • Battery monitoring
  • Presence detection
  • Sensor notifications
• Cleaned up versions of my own apps:
  • Office Button App
  • Laundry Room Lights
• docker-compose.yml example: docker-compose.yml
• hassette.toml example: hassette.toml

🛣️ Status & Roadmap

Hassette is brand new and under active development. We follow semantic versioning and recommend pinning a minor version while the API stabilizes.

Hassette development is tracked in this project (still a slight work-in-progress) - open an issue or PR if you'd like to contribute or provide feedback!

Current Focus Areas

• 📚 Comprehensive documentation
• 🔐 Enhanced type safety: Service calls/responses, additional state types
• 🏗️ Entity classes: Include state data and service functionality (e.g. LightEntity.turn_on())
• 🔄 Enhanced error handling: Better retry logic and error recovery
• 🧪 Testing improvements:
  • 📊 More tests for core and utilities
  • 🛠️ Test fixtures and framework for user apps
  • 🚫 No more manual state changes in HA Developer Tools for testing!

🤝 Contributing

Hassette is in active development and contributions are welcome! Whether you're:

• 🐛 Reporting bugs
• 💡 Suggesting features
• 📝 Improving documentation
• 🔧 Contributing code

Early feedback and contributions help shape the project's direction.

📄 License

MIT