HomeAutomationRepo

Home Assistant deployment for Ila's apartment, centered on the Zero-Willpower Wake-Up Protocol: lights ramp on, a phone-only alarm starts, and an AI morning briefing generates concurrently — the whole thing only stops when the phone is physically removed from its kitchen charger, forcing a walk out of bed.

Full design, discovery findings, and every documented assumption/tradeoff live in docs/wakeup-protocol.md — read that before making changes, especially before touching homeassistant/packages/wakeup_protocol.yaml.

Repository layout

compose.yaml              Production Compose stack (Portainer Git-deployed)
.env.example               Template for Portainer stack / local .env
homeassistant/              Git-tracked Home Assistant configuration
  configuration.yaml
  automations.yaml / scripts.yaml / scenes.yaml   (reserved — see docs)
  secrets.yaml.example      Copy to secrets.yaml on the host, fill in real values
  packages/
    wakeup_protocol.yaml     Everything for the wake-up subsystem
  dashboards/
    wakeup.yaml
  www/briefing/              Briefing audio published here at runtime (gitignored)
services/
  briefing/                  xAI (Grok) LLM + TTS microservice for the morning briefing
  hass-agent-installer/       Pinned HASS.Agent companion-integration installer
  healthsync-installer/       Pinned HealthSync custom-integration installer
  localtuya-installer/        Pinned LocalTuya custom-integration installer
  mira-home-mcp/              Read-only semantic Home Assistant tools for Mira
  mosquitto/                  Authenticated MQTT broker (HASS.Agent, MQTT integration)
  wake-gateway/               Standalone Python webhook server for iOS Shortcuts (wake/undock)
  xiaomi-miot-installer/       Pinned Xiaomi Miot custom-integration installer
data/                        Runtime data (recorder DB, .storage, briefing cache) — gitignored
docs/
  integrations.md             Provisioning runbook for WiZ and LocalTuya
  integration-shortlist.md    Living evaluation list for optional integrations
  mira-home-mcp.md             Native HA MCP plus Mira's narrow semantic adapter
  mira-voice.md                Finnish-first speech and xAI rendering controls
  wakeup-protocol.md          Design doc, assumptions, setup steps

Quick start (Portainer)

See docs/wakeup-protocol.md §10 for the full walkthrough. Short version: point a Portainer stack at this repo/branch with compose path compose.yaml, set the environment variables from .env.example, deploy, then copy homeassistant/secrets.yaml.example to homeassistant/secrets.yaml on the host and fill in real values (that file is intentionally not managed by git — see docs/wakeup-protocol.md §2 "Persistence").

To add the apartment's WiZ, LocalTuya, Xiaomi Miot, HealthSync, and MQTT/HASS.Agent integrations, follow docs/integrations.md. Device entries are provisioned in the Home Assistant UI; do not add credentials to the tracked YAML files.

To connect explicitly authorized agents to semantic Home Assistant state, including precise phone location when available, follow docs/mira-home-mcp.md.

History

This repo previously held four standalone Flask microservices (WiZ lights, LG webOS TV, Apple TV, sunrise time) driven by a bare docker-compose.yaml. They were retired in favor of Home Assistant's native integrations for the same devices — see docs/wakeup-protocol.md §1 for why.