Hassette

PyPI version Python 3.11+ License: MIT Documentation Status codecov

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

Documentation: https://hassette.readthedocs.io

✨ Why Hassette?

  • Type Safe: Full type annotations with Pydantic models and comprehensive IDE support
  • Async-First: Built for modern Python with async/await throughout
  • Dependency Injection: Clean handler signatures with FastAPI style dependency injection
  • Persistent Storage: Built-in disk cache for storing data across restarts, intelligent rate-limiting, and more
  • Simple & Focused: Just Home Assistant automations - no complexity creep
  • Web UI: Monitor and manage your automations from the browser
  • Developer Experience: Clear error messages, proper logging, hot-reloading, and intuitive APIs

See the Getting Started guide for detailed instructions.

🖥️ Web UI

Hassette includes a web UI for monitoring and managing your automations: Apps (app status, health, and detailed per-app views), Handlers (registered event handlers across all apps), Logs (real-time log streaming with filtering), and Config (runtime configuration and diagnostics).

Hassette Web UI — Apps page

The web UI is enabled by default at http://<host>:8126/. See the Web UI documentation for details.

Terminal CLI

Query a running Hassette instance from the terminal — no browser required:

# Check system health
hassette status

# List all apps and their status
hassette app

# Investigate a specific app
hassette app health my-app
hassette listener --app my-app --since 1h
hassette log --app my-app --since 1h --limit 20

# Pipe structured output to jq
hassette listener --app my-app --json | jq '.[] | select(.failed > 0)'

See the CLI documentation for the full command reference, scripting patterns, and shell completion setup.

🤔 Is Hassette Right for You?

New to automation frameworks?

Coming from AppDaemon?

📖 Examples

Check out the examples/ directory for complete working examples:

Configuration examples:

🛣️ Status

Hassette is under active development. We follow semantic versioning and recommend pinning a minor version (e.g., hassette~=0.x.0) while the API stabilizes.

Open an issue or PR if you'd like to contribute!

Recent Highlights

  • Typed state models - Generated Python models for 45+ Home Assistant entity domains
  • Entity classes - Rich entity objects with built-in async methods (e.g., await light.turn_on())
  • Test harness - AppTestHarness for writing tests against your automations with simulated state and time control

🤝 Contributing

Contributions are welcome! Whether you're:

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

See CONTRIBUTING.md for guidelines on getting started.

⭐ Star History

Star History Chart

📄 License

MIT

Project links

Data verified by PyPI on Aug 1, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.52.0)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for NodeJSmith from gravatar.com NodeJSmith

Credits

Author: Jessica

GitHub Statistics

Data verified by PyPI on Aug 1, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python <3.15, >=3.11

Provides Extra

test

Tags

home-assistant automation async typed framework smart-home iot

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

hassette-0.51.0.tar.gz (2.8 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

hassette-0.51.0-py3-none-any.whl (3.2 MB view details)

Uploaded Python 3

File details

Details for the file hassette-0.51.0.tar.gz.

File metadata

  • Download URL: hassette-0.51.0.tar.gz
  • Upload date:
  • Size: 2.8 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for hassette-0.51.0.tar.gz
Algorithm Hash digest
SHA256 535bfa88eca3745e8d6c9aeb35d56492d3509376bfcd9fb88e9a20d5613a55ef
MD5 733e2ced2465ace707b381ce3f5ee031
BLAKE2b-256 bd8703a69935e9086f53096ce67d3edf27bfc6190379ad9ed3147b30b066a086

See more details on using hashes here.

Provenance

The following attestation bundles were made for hassette-0.51.0.tar.gz:

Publisher: release-please.yml on NodeJSmith/hassette

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file hassette-0.51.0-py3-none-any.whl.

File metadata

  • Download URL: hassette-0.51.0-py3-none-any.whl
  • Upload date:
  • Size: 3.2 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for hassette-0.51.0-py3-none-any.whl
Algorithm Hash digest
SHA256 c55ab147f452d1b013abb9f65b044ea9e4458d55699bd0db279ac27646469c36
MD5 490e4be4be5d61e30e56ace063c57012
BLAKE2b-256 5fb0029a5f99b455886f74080060cb30ea7f325836d8bc3134befbb2d7700f1a

See more details on using hashes here.

Provenance

The following attestation bundles were made for hassette-0.51.0-py3-none-any.whl:

Publisher: release-please.yml on NodeJSmith/hassette

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.52.0

2 files

This release

0.51.0 This release

2 files

0.50.0

2 files

0.49.0

2 files

0.48.0

2 files

0.47.0

2 files

0.46.0

2 files

0.45.0

2 files

0.44.0

2 files

0.43.0

2 files

0.42.0

2 files

0.41.0

2 files

0.40.0

2 files

0.39.1

2 files

0.39.0

2 files

0.38.0

2 files

Yanked

0.37.0

2 files

Yanked reason: missing frontend spa

Yanked

0.36.0

2 files

Yanked reason: missing frontend spa

Yanked

0.35.0

2 files

Yanked reason: missing frontend spa

0.34.0

2 files

0.33.0

2 files

0.32.0

2 files

0.31.0

2 files

0.30.2

2 files

Yanked

0.30.1

2 files

Yanked reason: v0.30.1 was published without frontend assets — use v0.30.2 instead

0.30.0

2 files

0.29.0

2 files

0.28.0

2 files

0.27.0

2 files

0.26.0

2 files

0.25.0

2 files

0.24.0

2 files

0.23.0

2 files

0.22.1

2 files

0.22.0

2 files

0.21.0

2 files

0.20.4

2 files

0.20.3

2 files

0.20.2

2 files

0.20.1

2 files

0.20.0

2 files

0.19.2

2 files

0.19.1

2 files

0.19.0

2 files

0.18.1

2 files

Pre-release

0.18.0.dev3

2 files

Pre-release

0.18.0.dev2

2 files

Pre-release

0.18.0.dev1

2 files

0.17.0

2 files

0.16.0

2 files

0.15.5

2 files

0.15.4

2 files

0.15.3

2 files

0.15.2

2 files

0.15.1

2 files

0.15.0

2 files

0.14.0

2 files

0.13.0

2 files

0.12.1

2 files

0.12.0

2 files

0.11.0

2 files

0.10.0

2 files

0.9.0

2 files

0.8.1

2 files

0.8.0

2 files

0.7.2

2 files

0.7.1

2 files

0.7.0

2 files

0.6.2

2 files

0.6.1

2 files

0.6.0

2 files

0.5.0

2 files

0.4.2

2 files

0.4.1

2 files

0.4.0

2 files

0.3.3

2 files

0.3.2

2 files

0.3.1

2 files

0.3.0

2 files

0.2.1

2 files

0.2.0

2 files

0.1.1

2 files

0.1.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page