Asynchronous python client for Home Assistant Supervisor.

These details have been verified by PyPI

Project links

GitHub Statistics

Maintainers

mdegat01

These details have not been verified by PyPI

Project links

Project description

Home Assistant Supervisor Client

Client Library for Home Assistant Supervisor

Python client for interfacing with the Home Assistant Supervisor via its REST API. Currently used in the Home Assistant Supervisor integration in Home Assistant.

Add-ons which interface with Supervisor can also leverage it. The library expects to find the access token in the SUPERVISOR_TOKEN env which is set automatically by Supervisor for add-ons. Currently there is no way to get a long-lived access token for Supervisor outside these use cases so the library's usage is limited to these.

Installation

The library is published on pip and can be installed that way:

pip install aiohasupervisor

And then used via import

import asyncio
import supervisor_client

asyncio.run(supervisor_client.info())

Output would look like the example response in /info from here

Developing & contributing

Prerequisites

The client can interact remotely with the Home Assistant Supervisor using the remote_api add-on from the developer add-ons repository.

After installing and starting the add-on, a token is shown in the remote_api add-on log, which is needed for further development.

It is also recommended you use Visual Studio Code for development with the devcontainer extension. This will read the published devcontainer configuration and setup the development environment for you.

Get the source code

Fork (https://github.com/home-assistant-libs/python-supervisor-client/fork) or clone this repository.

Using it in development

From within the devcontainer, open terminal and do the following:

uv pip install -e .
export SUPERVISOR_API_URL=http://192.168.1.2
export SUPERVISOR_TOKEN=replace_this_with_remote_api_token
python examples/connectivity_test.py

Output should match the example response in /info as shown/linked above in Installation.

Note: Replace the 192.168.1.2 with the IP address of your Home Assistant instance running the remote_api add-on and use the token provided.

Contributing a change

Create a feature branch on your fork/clone of the git repository.
Commit your changes.
Rebase your local changes against the main branch.
Run test suite with the pytest tests command or use Test Explorer and confirm that it passes.
Use ruff to format your code with the rules configured in this project
Create a new Pull Request

Release

Any time the API changes for Home Assistant Supervisor a corresponding release should be published here. Once that release is available on pip a PR should be created to Home Assistant Core updating its Home Assistant Supervisor integration. Follow the directions for updating Requirements in the Integration manifest.

Project details

These details have been verified by PyPI

Project links

GitHub Statistics

Maintainers

mdegat01

These details have not been verified by PyPI

Project links

Release history Release notifications | RSS feed

This version

0.3.3

Oct 1, 2025

0.3.3b0 pre-release

Sep 23, 2025

0.3.2

Aug 26, 2025

0.3.2b0 pre-release

Aug 19, 2025

0.3.1

Apr 24, 2025

0.3.1b1 pre-release

Apr 11, 2025

0.3.1b0 pre-release

Apr 9, 2025

0.3.0

Feb 5, 2025

0.3.0b0 pre-release

Feb 4, 2025

0.2.2b6 pre-release

Jan 28, 2025

0.2.2b5 pre-release

Dec 21, 2024

0.2.2b4 pre-release

Dec 20, 2024

0.2.2b3 pre-release

Dec 20, 2024

0.2.2b2 pre-release

Dec 17, 2024

0.2.2b1 pre-release

Dec 17, 2024

0.2.2b0 pre-release

Dec 9, 2024

0.2.1

Oct 31, 2024

0.2.0

Oct 28, 2024

0.2.0b0 pre-release

Oct 11, 2024

0.1.0

Sep 26, 2024

0.1.0b1 pre-release

Sep 19, 2024

0.1.0b0 pre-release

Aug 30, 2024

Download files

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

Source Distribution

aiohasupervisor-0.3.3.tar.gz (44.7 kB view details)

Uploaded Oct 1, 2025 Source

Built Distribution

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

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

aiohasupervisor-0.3.3-py3-none-any.whl (40.5 kB view details)

Uploaded Oct 1, 2025 Python 3

File details

Details for the file aiohasupervisor-0.3.3.tar.gz.

File metadata

Download URL: aiohasupervisor-0.3.3.tar.gz
Upload date: Oct 1, 2025
Size: 44.7 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for aiohasupervisor-0.3.3.tar.gz
Algorithm	Hash digest
SHA256	`24e268f58f37f9d8dafadba2ef9d860292ff622bc6e78b1ca4ef5e5095d1bbc8`
MD5	`ea0f7d1a202afbfe7bdce986199fdaed`
BLAKE2b-256	`e4e0f8865efa28ce22e44e3526f18654c7a69a6f0d0e8523e2aaf743f2798fd8`

See more details on using hashes here.

Provenance

The following attestation bundles were made for aiohasupervisor-0.3.3.tar.gz:

Publisher: release.yaml on home-assistant-libs/python-supervisor-client

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

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: aiohasupervisor-0.3.3.tar.gz
- Subject digest: 24e268f58f37f9d8dafadba2ef9d860292ff622bc6e78b1ca4ef5e5095d1bbc8
- Sigstore transparency entry: 575759799
- Sigstore integration time: Oct 1, 2025
Source repository:
- Permalink: home-assistant-libs/python-supervisor-client@505003519b4a073e7921b55e1e2696802cdc1406
- Branch / Tag: refs/tags/0.3.3
- Owner: https://github.com/home-assistant-libs
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yaml@505003519b4a073e7921b55e1e2696802cdc1406
- Trigger Event: release

File details

Details for the file aiohasupervisor-0.3.3-py3-none-any.whl.

File metadata

Download URL: aiohasupervisor-0.3.3-py3-none-any.whl
Upload date: Oct 1, 2025
Size: 40.5 kB
Tags: Python 3
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for aiohasupervisor-0.3.3-py3-none-any.whl
Algorithm	Hash digest
SHA256	`bc185dbb81bb8ec6ba91b5512df7fd3bf99db15e648b20aed3f8ce7dc3203f1f`
MD5	`c54fe7514cbd17ff4040aa2329c8cd82`
BLAKE2b-256	`f097b811d22148e7227e6f02a1f0f13f60d959bb163c806feab853544da07c3e`

See more details on using hashes here.

Provenance

The following attestation bundles were made for aiohasupervisor-0.3.3-py3-none-any.whl:

Publisher: release.yaml on home-assistant-libs/python-supervisor-client

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

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: aiohasupervisor-0.3.3-py3-none-any.whl
- Subject digest: bc185dbb81bb8ec6ba91b5512df7fd3bf99db15e648b20aed3f8ce7dc3203f1f
- Sigstore transparency entry: 575759802
- Sigstore integration time: Oct 1, 2025
Source repository:
- Permalink: home-assistant-libs/python-supervisor-client@505003519b4a073e7921b55e1e2696802cdc1406
- Branch / Tag: refs/tags/0.3.3
- Owner: https://github.com/home-assistant-libs
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yaml@505003519b4a073e7921b55e1e2696802cdc1406
- Trigger Event: release

aiohasupervisor 0.3.3

Navigation

Verified details

Project links

GitHub Statistics

Maintainers

Unverified details

Project links

Meta

Project description

Home Assistant Supervisor Client

Client Library for Home Assistant Supervisor

Installation

Developing & contributing

Prerequisites

Get the source code

Using it in development

Contributing a change

Release

Project details

Verified details

Project links

GitHub Statistics

Maintainers

Unverified details

Project links

Meta

Release history Release notifications | RSS feed

Download files

Source Distribution

Built Distribution

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance