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 Sep 5, 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:
Latest release

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 Sep 5, 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.54.0.tar.gz (2.9 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.54.0-py3-none-any.whl (3.2 MB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for hassette-0.54.0.tar.gz
Algorithm Hash digest
SHA256 2fc2a62cb5a09b939df42ec80438aa947be6a3835cf616870cb43b84760f83ce
MD5 e41833d82531efed1229cceb7179865e
BLAKE2b-256 a1cfe9f2d932ad8ab2c8ecf5f9c75ca66b8c39869458a6bcd147c8c7b8b54c63

See more details on using hashes here.

Provenance

The following attestation bundles were made for hassette-0.54.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.54.0-py3-none-any.whl.

File metadata

  • Download URL: hassette-0.54.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.54.0-py3-none-any.whl
Algorithm Hash digest
SHA256 dc5bcee0ee5fc73e01eed27cb96323a3f04ff24299b094f01616a3162b423fcc
MD5 19bf3caf12cf472d1be073b09af2aa5b
BLAKE2b-256 f5486093aaa1a22467703dc9efe8a4020b48500abfb7715a00949aaed3f50b42

See more details on using hashes here.

Provenance

The following attestation bundles were made for hassette-0.54.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

This release

0.54.0 This release

2 files

0.53.0

2 files

0.52.0

2 files

0.51.0

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

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page