Home Assistant Observer

Cron-friendly Home Assistant observer:

every 30 minutes: collect compact Home Assistant snapshots into ./data
every day at 05:00: send the last day of snapshots to AI
publish a funny local webpage at ./web/index.html
save Markdown AI reports in ./reports

Setup

cd /home/hbrain/ha
python3 -m venv .venv
. .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env
chmod 600 .env
chmod +x run_ha_observer.sh ha_observer.py install_cron.sh

Edit .env and set:

HA_URL="http://homeassistant.local:8123"
HA_TOKEN="your_long_lived_home_assistant_token"

Create the token in Home Assistant:

Profile → Security → Long-lived access tokens

AI mode for the 05:00 report

Local Ollama is recommended for privacy:

LLM_MODE="ollama"
OLLAMA_MODEL="llama3.1"

OpenAI cloud API:

LLM_MODE="openai"
OPENAI_API_KEY="..."
OPENAI_MODEL="gpt-4o-mini"

No AI, but still publish a placeholder page:

LLM_MODE="none"

Extra LLM instructions

Edit this file to change how the 05:00 AI analysis behaves:

/home/hbrain/ha/llm_instructions.md

For example, add specific questions, preferred tone, things to ignore, or extra privacy/security concerns. The file is automatically appended to the AI prompt during analyze.

You can change the path in .env:

PROMPT_FILE="./llm_instructions.md"

Test manually

Collect one snapshot:

./run_ha_observer.sh collect

Run the 05:00-style analysis/publishing step:

./run_ha_observer.sh analyze

Open the page:

xdg-open /home/hbrain/ha/web/index.html

Or serve it locally:

cd /home/hbrain/ha/web
python3 -m http.server 8088

Then browse to:

http://localhost:8088/

Install cron jobs

This installs exactly these jobs:

*/30 * * * * collect snapshots every 30 minutes
0 5 * * * analyze with AI and publish the funny local webpage

./install_cron.sh

Manual crontab equivalent:

*/30 * * * * /home/hbrain/ha/run_ha_observer.sh collect >> /home/hbrain/ha/cron.log 2>&1
0 5 * * * /home/hbrain/ha/run_ha_observer.sh analyze >> /home/hbrain/ha/cron.log 2>&1

Output locations

/home/hbrain/ha/data/       30-minute JSON snapshots
/home/hbrain/ha/reports/    daily Markdown AI reports
/home/hbrain/ha/web/        local funny webpage, index.html
/home/hbrain/ha/cron.log    cron logs

Privacy notes

Home Assistant data can reveal sleep schedule, occupancy, work patterns, visitors, location habits, and security weaknesses. Prefer LLM_MODE=ollama to keep analysis local. Use EXCLUDED_ENTITIES in .env to omit sensitive/noisy entities.

2.7 KiB Raw Blame History