Introduction
The HASS-data-detective package helps you explore and analyse the data in your Home Assistant) database. If you are running HASS-data-detective on a machine with Home Assistant installed, it will automatically discover your database and by default collect information about the entities in your database. See the notebooks directory for examples of using the detective package. If you are on a Raspberry pi you should use the official JupyterLab add-on which includes HASS-data-detective
Prerequisites
- Python
3.12.xis required.
Installation on your machine
You can either: pip install HASS-data-detective for the latest released version from pypi, or pip install git+https://github.com/robmarkcole/HASS-data-detective.git --upgrade for the bleeding edge version from github. Note that due to the matplotlib dependency, libfreetype6-dev is a requirement on aarch64 platforms (i.e. RPi).
Which version to install?
The 3.0 version from pypi requires the existence of a states_meta table which is not present in older Home Assistant databases. If you get the error (sqlite3.OperationalError) no such table: states_meta then you should install the earlier release with pip install HASS-data-detective==2.6
Development (VScode)
- Create a venv:
python3.12 -m venv venv - Activate venv:
source venv/bin/activate - Confirm Python version:
python --version(should be3.12.x) - Install requirements:
pip install -r requirements.txt - Install detective in development mode:
pip install -e . - Install Jupyterlab to run the notebooks:
pip install jupyterlab - Open the notebook at
notebooks/Getting started with detective.ipynb
Running tests
- Install dependencies:
pip install -r requirements_test.txt - Run:
python -m pytest tests
Contributors
Big thanks to @balloob and @frenck, checkout their profiles!
1 maintainer
Metadata
1 maintainer
Release files for HASS-data-detective 3.5.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| hass_data_detective-3.5.1.tar.gz | 36.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| hass_data_detective-3.5.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 45.5 kB
Release files / hass_data_detective-3.5.1.tar.gz
| Download URL | hass_data_detective-3.5.1.tar.gz |
|---|---|
| Size | 36.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
5615fbd57a2aaccc181f768729e759285ba8ad858657237de5dab2ce1872ec95
|
|
BLAKE2b-256 checksum How to use checksums |
1dc8e50cda02d16949efbbd67a6113428ac339eef86be49850392ea7d658b400
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 7, 2026.
Transparency logRelease files / hass_data_detective-3.5.1-py3-none-any.whl
| Download URL | hass_data_detective-3.5.1-py3-none-any.whl |
|---|---|
| Size | 9.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
18fb39b25e90358c72d64b8f2652281b360eee537dc0c89d3f0c5bb3bf7c0be1
|
|
BLAKE2b-256 checksum How to use checksums |
02dee568834211e974123e6116af7911eb3c8127f59d886194b61b4ed36ae8b0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 7, 2026.
Transparency log
