| Name | hass-nabucasa JSON |
| Version |
1.0.0
JSON |
| download |
| home_page | None |
| Summary | Home Assistant cloud integration by Nabu Casa, Inc. |
| upload_time | 2025-08-14 07:43:02 |
| 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/ea/95/0c5bb462371581c3d347ff0db7a6f20ec61b678d29db453a0d14c9294e79/hass_nabucasa-1.0.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.0.0",
"project_urls": null,
"split_keywords": [],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "20632ac25cc20d66b3a4f0a0f3c7bb10dc57af5f3382a6349930a8c67f536d38",
"md5": "425608240670c588de2aff9542563748",
"sha256": "b4d44c3de5ce370be2d8df881fc3654330faeb055ac09a3fb87b4b08cbd0c0d1"
},
"downloads": -1,
"filename": "hass_nabucasa-1.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "425608240670c588de2aff9542563748",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.13",
"size": 73078,
"upload_time": "2025-08-14T07:43:00",
"upload_time_iso_8601": "2025-08-14T07:43:00.696646Z",
"url": "https://files.pythonhosted.org/packages/20/63/2ac25cc20d66b3a4f0a0f3c7bb10dc57af5f3382a6349930a8c67f536d38/hass_nabucasa-1.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "ea950c5bb462371581c3d347ff0db7a6f20ec61b678d29db453a0d14c9294e79",
"md5": "f75d3b369d0d20b701baa3557f5796d8",
"sha256": "7c379e9abc8c535e20538cb203827e3273e2ec2288da9505e67a92bc81e631dc"
},
"downloads": -1,
"filename": "hass_nabucasa-1.0.0.tar.gz",
"has_sig": false,
"md5_digest": "f75d3b369d0d20b701baa3557f5796d8",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.13",
"size": 91313,
"upload_time": "2025-08-14T07:43:02",
"upload_time_iso_8601": "2025-08-14T07:43:02.430996Z",
"url": "https://files.pythonhosted.org/packages/ea/95/0c5bb462371581c3d347ff0db7a6f20ec61b678d29db453a0d14c9294e79/hass_nabucasa-1.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-14 07:43:02",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "hass-nabucasa"
}
