Skip to main content

Home Assistant cloud integration by Nabu Casa, Inc.

Project description

hass-nabucasa

hass-nabucasa is the underlying library that enables Home Assistant to connect to and utilize Nabu Casa cloud services.

This library handles a range of cloud-related functionality including:

  • Authentication and account management
  • Remote UI connections via SniTun
  • API interactions with Nabu Casa cloud services
  • Voice processing capabilities
  • ACME certificate management
  • Google Assistant and Alexa integration
  • Cloud webhook management
  • Cloud file storage and management

Installation

python3 -m pip install hass-nabucasa==x.y.z

Release process

hass-nabucasa is released through GitHub and published to PyPI. The release process is automated and triggered through the GitHub UI:

  1. Go to the GitHub Releases page.
  2. Find the draft release created by release-drafter.
  3. Verify that the tag and name are the expected ones (e.g., 1.2.3)
  4. Publish the release (and set it as the latest release)

Once published, GitHub Actions workflows automatically:

  • Build the package
  • Publish to PyPI

There is no need to manually update version information in the codebase.

Development and contributing

Development environment

We recommend using Visual Studio Code with the official Dev Container extension for development. This provides a consistent, pre-configured environment with all dependencies installed.

This will automatically set up a development environment with all required dependencies.

Running tests

scripts/test

Code quality

This project uses pre-commit hooks for code quality checks:

scripts/lint

Updating voice data

To update the voice data with the latest from Azure:

python3 -m scripts.update_voice_data

You will need to fetch an Azure TTS token. You can generate one by running the sample key generator server and visiting http://localhost:3001/api/get-speech-token.

Project details


Release history Release notifications | RSS feed

Download files

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

Source Distribution

hass_nabucasa-2.0.0.tar.gz (118.4 kB view details)

Uploaded Source

Built Distribution

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

hass_nabucasa-2.0.0-py3-none-any.whl (90.6 kB view details)

Uploaded Python 3

File details

Details for the file hass_nabucasa-2.0.0.tar.gz.

File metadata

  • Download URL: hass_nabucasa-2.0.0.tar.gz
  • Upload date:
  • Size: 118.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for hass_nabucasa-2.0.0.tar.gz
Algorithm Hash digest
SHA256 9ca8ba285ccae338180c9cd9b89f060391138cc732e642399f258195e142dc5c
MD5 f18748ac01b0c9e0910e6dda35db4c69
BLAKE2b-256 ededa23facb37b8f064fcd9a7f71ca7573a4fcadc7adfdd168204b4b18e11b6f

See more details on using hashes here.

Provenance

The following attestation bundles were made for hass_nabucasa-2.0.0.tar.gz:

Publisher: pythonpublish.yml on NabuCasa/hass-nabucasa

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

File details

Details for the file hass_nabucasa-2.0.0-py3-none-any.whl.

File metadata

  • Download URL: hass_nabucasa-2.0.0-py3-none-any.whl
  • Upload date:
  • Size: 90.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for hass_nabucasa-2.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 c1c9d26c964410c8785653b4ad9d863d3d2cca52ff1b6ca1b24de0ee180bb83c
MD5 a2de63d40837d3316bf18c19e411b76b
BLAKE2b-256 760456d862ba3073a896e266a4e9b7752ead354fd64dbead12cdf9e697d952cd

See more details on using hashes here.

Provenance

The following attestation bundles were made for hass_nabucasa-2.0.0-py3-none-any.whl:

Publisher: pythonpublish.yml on NabuCasa/hass-nabucasa

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

Supported by

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