| Name | hass-nabucasa JSON |
| Version |
1.4.0
JSON |
| download |
| home_page | None |
| Summary | Home Assistant cloud integration by Nabu Casa, Inc. |
| upload_time | 2025-10-16 08:33:34 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.13 |
| license | GPL v3 |
| keywords |
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# 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](https://www.github.com/NabuCasa/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
```bash
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][releases].
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
```bash
scripts/test
```
### Code quality
This project uses pre-commit hooks for code quality checks:
```bash
scripts/lint
```
### Updating voice data
To update the voice data with the latest from Azure:
```bash
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](https://github.com/Azure-Samples/cognitive-services-speech-sdk/tree/master/samples/js/browser/server) and visiting `http://localhost:3001/api/get-speech-token`.
[releases]: https://github.com/NabuCasa/hass-nabucasa/releases
[PyPI]: https://pypi.org/project/hass-nabucasa/
Raw data
{
"_id": null,
"home_page": null,
"name": "hass-nabucasa",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.13",
"maintainer_email": null,
"keywords": null,
"author": null,
"author_email": "\"Nabu Casa, Inc.\" <opensource@nabucasa.com>",
"download_url": "https://files.pythonhosted.org/packages/7f/94/92ff363bc8adc6b613916e19eb0b4ee012b08de6c7bf2fbd6047a6be91be/hass_nabucasa-1.4.0.tar.gz",
"platform": "any",
"description": "# hass-nabucasa\n\n`hass-nabucasa` is the underlying library that enables Home Assistant to connect to and utilize Nabu Casa cloud services.\n\nThis library handles a range of cloud-related functionality including:\n\n- Authentication and account management\n- Remote UI connections via [SniTun](https://www.github.com/NabuCasa/snitun)\n- API interactions with Nabu Casa cloud services\n- Voice processing capabilities\n- ACME certificate management\n- Google Assistant and Alexa integration\n- Cloud webhook management\n- Cloud file storage and management\n\n## Installation\n\n```bash\npython3 -m pip install hass-nabucasa==x.y.z\n```\n\n## Release process\n\n`hass-nabucasa` is released through GitHub and published to [PyPI].\nThe release process is automated and triggered through the GitHub UI:\n\n1. Go to the [GitHub Releases page][releases].\n2. Find the draft release created by release-drafter.\n3. Verify that the tag and name are the expected ones (e.g., `1.2.3`)\n4. Publish the release (and set it as the latest release)\n\nOnce published, GitHub Actions workflows automatically:\n\n- Build the package\n- Publish to [PyPI]\n\nThere is no need to manually update version information in the codebase.\n\n## Development and contributing\n\n### Development environment\n\nWe recommend using Visual Studio Code with the official Dev Container extension for development. This provides a consistent, pre-configured environment with all dependencies installed.\n\nThis will automatically set up a development environment with all required dependencies.\n\n### Running tests\n\n```bash\nscripts/test\n```\n\n### Code quality\n\nThis project uses pre-commit hooks for code quality checks:\n\n```bash\nscripts/lint\n```\n\n### Updating voice data\n\nTo update the voice data with the latest from Azure:\n\n```bash\npython3 -m scripts.update_voice_data\n```\n\nYou will need to fetch an Azure TTS token. You can generate one by running the [sample key generator server](https://github.com/Azure-Samples/cognitive-services-speech-sdk/tree/master/samples/js/browser/server) and visiting `http://localhost:3001/api/get-speech-token`.\n\n[releases]: https://github.com/NabuCasa/hass-nabucasa/releases\n[PyPI]: https://pypi.org/project/hass-nabucasa/\n",
"bugtrack_url": null,
"license": "GPL v3",
"summary": "Home Assistant cloud integration by Nabu Casa, Inc.",
"version": "1.4.0",
"project_urls": null,
"split_keywords": [],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "c4d732e44579a99c0258be0fd425a1bcbdda9576508ef68612424a632fe8c23f",
"md5": "6db3abca0a2aa71e6e789a0bf5c98562",
"sha256": "e5ef5d828aaf1dc3211c834970355d41da831190637b725a2a1655983d15c58c"
},
"downloads": -1,
"filename": "hass_nabucasa-1.4.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "6db3abca0a2aa71e6e789a0bf5c98562",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.13",
"size": 73439,
"upload_time": "2025-10-16T08:33:32",
"upload_time_iso_8601": "2025-10-16T08:33:32.856247Z",
"url": "https://files.pythonhosted.org/packages/c4/d7/32e44579a99c0258be0fd425a1bcbdda9576508ef68612424a632fe8c23f/hass_nabucasa-1.4.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "7f9492ff363bc8adc6b613916e19eb0b4ee012b08de6c7bf2fbd6047a6be91be",
"md5": "880077bf4a2f3522589fa15333301ba7",
"sha256": "b4a9cb1439f370e1cfaf0b3ae00b011d52b636d40750b49cd6e4e359aba40b84"
},
"downloads": -1,
"filename": "hass_nabucasa-1.4.0.tar.gz",
"has_sig": false,
"md5_digest": "880077bf4a2f3522589fa15333301ba7",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.13",
"size": 91521,
"upload_time": "2025-10-16T08:33:34",
"upload_time_iso_8601": "2025-10-16T08:33:34.757801Z",
"url": "https://files.pythonhosted.org/packages/7f/94/92ff363bc8adc6b613916e19eb0b4ee012b08de6c7bf2fbd6047a6be91be/hass_nabucasa-1.4.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-16 08:33:34",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "hass-nabucasa"
}
