hass-nabucasa
Home Assistant cloud integration by Nabu Casa, Inc.
Decision gist · record as of 2026-08-14
Yes, if you run Home Assistant and want cloud connectivity. The package is production-stable, actively maintained, has no known vulnerabilities, and carries low install friction. The GPL-3.0-only copyleft license is appropriate for Home Assistant's open-source ecosystem. The Python 3.14 requirement is unusually strict and should be verified against your Home Assistant version before installing.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.14 or later; intended for use within Home Assistant, not as a standalone library for direct application development.
- Low install friction with a pure-Python wheel distribution.
- Active maintenance status and no known vulnerabilities.
License · maintenance · safety
GPL-3.0-only (copyleft) — GPL-3.0-only copyleft license requires that any derivative work or distribution must also be open-source under GPL-3.0-only terms. This is a strong copyleft obligation suitable for open-source projects but may restrict use in proprietary applications.
last release 2026-03-23 (144 days)
0 known vulnerabilities (OSV.dev, 2026-08-14) · 720,852 downloads/mo, #5,233 on PyPI
Alternatives
Verify before relying
pip install hass-nabucasa==2.2.0
import hass_nabucasa
# Typically imported and used internally by Home Assistant,
# not directly by end-user code.- Whether the Python 3.14 requirement reflects actual runtime needs or is a documentation artifact, given the package's production-stable status and release history since 2019.
- Specific version constraints or compatibility ranges for the 17 runtime dependencies, which could affect integration with existing Home Assistant installations.
What it is and what it does
hass-nabucasa is Home Assistant's official cloud integration library, maintained by Nabu Casa, Inc. It abstracts the complexity of connecting Home Assistant instances to Nabu Casa's cloud platform, handling authentication, remote UI access via SniTun, ACME certificate lifecycle, and cloud-based features like voice processing and smart assistant integrations. The library manages API interactions, webhook routing, and file storage on the cloud backend.
The package is built on a substantial dependency graph including aiohttp for async HTTP, cryptography for TLS and certificate handling, grpcio for service communication, and specialized libraries like snitun for remote tunneling and pycognito for cloud authentication. It is intended for Home Assistant deployments that need cloud connectivity and is not a standalone tool for general use.
Use it for
- Enable remote access to Home Assistant instances from outside the home network via Nabu Casa cloud tunneling.
- Integrate Home Assistant with Google Assistant and Alexa voice services through cloud-managed authentication.
- Manage ACME certificate renewal and TLS lifecycle for Home Assistant's web interface.
- Route webhooks and cloud events to local Home Assistant instances.
- Store and retrieve files in cloud storage linked to a Home Assistant account.
- Authenticate Home Assistant users against Nabu Casa cloud accounts.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you run Home Assistant and want cloud connectivity.
The package is production-stable, actively maintained, has no known vulnerabilities, and carries low install friction. The GPL-3.0-only copyleft license is appropriate for Home Assistant's open-source ecosystem. The Python 3.14 requirement is unusually strict and should be verified against your Home Assistant version before installing.
Install
hass-nabucasa on PyPI
Before you install
Low install friction with a pure-Python wheel distribution. Active maintenance status and no known vulnerabilities. Requires Python 3.14 or later, which is a current-version constraint that may limit compatibility with older Home Assistant deployments.
Requires Python 3.14 or later; intended for use within Home Assistant, not as a standalone library for direct application development.
License in practice
GPL-3.0-only copyleft license requires that any derivative work or distribution must also be open-source under GPL-3.0-only terms. This is a strong copyleft obligation suitable for open-source projects but may restrict use in proprietary applications.
Quickstart
pip install hass-nabucasa==2.2.0
import hass_nabucasa
# Typically imported and used internally by Home Assistant,
# not directly by end-user code.Verify before relying
- Whether the Python 3.14 requirement reflects actual runtime needs or is a documentation artifact, given the package's production-stable status and release history since 2019.
- Specific version constraints or compatibility ranges for the 17 runtime dependencies, which could affect integration with existing Home Assistant installations.
Package facts
| License | GPL-3.0-only copyleft |
| Python support | Capped below the current Python release >=3.14 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 17 packagesacmeaiohttpatomicwrites-homeassistantattrsciso8601cryptographygrpcioicmplibjosepypycognitoPyJWTrequestssnitunvoluptuouswebrtc-modelsyarlsentence-stream |
| Maintenance | Actively maintained 144 days since the last release |
| First released | |
| Downloads | 720,852 / month, #5,233 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableIntended Audience :: DevelopersIntended Audience :: End Users/DesktopOperating System :: OS IndependentProgramming Language :: Python :: 3.14Topic :: Internet :: Proxy ServersTopic :: Software Development :: Libraries :: Python Modules |
Evidence: hass_nabucasa-2.2.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “home assistant cloud library”
- hass-nabucasahass-nabucasa is a Python library that provides Home Assistant with…
- pymielepymiele is a Python library that enables Home Assistant integration…
- pymammotionPyMammotion provides a Python API to control and monitor Mammotion…
Give your agent the search over MCP, or paste the wish link into any chat.
More Python Modules packages
Converts domain names between Unicode and ASCII-compatible encoding (Punycode) according to IDNA 2008 and Unicode Technical Standard 46, with security validation and broader script coverage than the standard library.
Install it if you work with internationalized domain names, need to validate domains, or use HTTP clients that depend on it transitively.
Setuptools is a Python build backend and package management tool that handles building, distributing, and installing Python packages, including support for C/C++ extension modules.
PyYAML parses and emits YAML 1.1 data format, enabling serialization and deserialization of configuration files and Python objects to and from human-readable YAML text.
Pydantic validates Python data structures against type hints, coercing and checking input at runtime to ensure it matches a declared schema.
Provides reusable metadata objects for use with PEP-593 `typing.Annotated` to express common constraints like bounds, collection sizes, and predicates on types.
Install it if you use or build libraries that need to express type constraints in a standardized, inspectable way—or if you want to annotate your own types with…
Provides runtime tools to inspect and introspect Python type annotations, enabling programmatic examination of type hints at execution time.
See also ha-mcp · ha-mcp-dev · home-assistant-intents · homeassistant · home-assistant-frontend · voip-utils · aiohasupervisor · hassil · hass-web-proxy-lib · livekit-plugins-cartesia