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 4, 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.54.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 Sep 4, 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.53.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.53.0-py3-none-any.whl (3.2 MB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: hassette-0.53.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.53.0.tar.gz
Algorithm Hash digest
SHA256 2cc341c31fc1ffda5e1a7f675eaa5c35ae40469cd289e58b820677ec5d5ee268
MD5 2727e06ce246f6b9258e4ddf80d303e9
BLAKE2b-256 52ff1233d1e57e0c3ceed68356e5caf1366ecac364e4e0c439f4967c119052ab

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: hassette-0.53.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.53.0-py3-none-any.whl
Algorithm Hash digest
SHA256 a9ccd9b57094b75e679c51aae4bbc3677051e6d6199fcee4a10f6c98764512bb
MD5 b76bd4c0286193718d2e2dfbf89baaa1
BLAKE2b-256 deca70a0efd4507bf311b3035956c003e536f825e569ccc40004de39bbd983f4

See more details on using hashes here.

Provenance

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

2 files

This release

0.53.0 This release

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