---
id: hass-nabucasa
version: "2.2.0"
license: GPL-3.0-only
license_treatment: copyleft
maintenance: active
---

# hass-nabucasa — Home Assistant cloud integration by Nabu Casa, Inc.

License: copyleft · Maintenance: active · Downloads: 720.9K/mo

## 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 above — verify before relying.

hass-nabucasa is a Python library that provides Home Assistant with cloud connectivity, authentication, and integration with Nabu Casa cloud services including remote access, voice processing, and smart home assistant integrations.

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

pip install hass-nabucasa
uv add hass-nabucasa
poetry add hass-nabucasa

## Installing hass-nabucasa

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.

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.

Requires Python 3.14 or later; intended for use within Home Assistant, not as a standalone library for direct application development.

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_current
- Install friction: low
- Maintenance: active
- Downloads: 720.9K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

home assistant cloud library, nabu casa cloud integration, home assistant remote access, cloud authentication home assistant, voice processing home assistant, smart home cloud connector, home assistant certificate management, home-automation, cloud-integration, authentication

[View on SkillFed](https://skillfed.io/packages/hass-nabucasa) · [View on PyPI](https://pypi.org/project/hass-nabucasa/)