Upload 4 files

Dockerfile

@@ -0,0 +1,21 @@
+FROM ghcr.io/home-assistant/home-assistant:stable
+
+USER root
+
+RUN apk add --no-cache git bash \
+    && git clone --depth 1 https://github.com/al-one/hass-xiaomi-miot.git /tmp/hass-xiaomi-miot \
+    && mkdir -p /opt/ha-custom-components \
+    && cp -a /tmp/hass-xiaomi-miot/custom_components/xiaomi_miot /opt/hass-custom-components/xiaomi_miot \
+    && rm -rf /tmp/hass-xiaomi-miot \
+    && python3 -m pip install --no-cache-dir --disable-pip-version-check huggingface_hub \
+    && mkdir -p /data/home-assistant /config
+
+COPY scripts/start-homeassistant /usr/local/bin/start-homeassistant
+COPY scripts/backup-homeassistant.py /usr/local/bin/backup-homeassistant.py
+RUN chmod +x /usr/local/bin/start-homeassistant
+
+ENV HOME_ASSISTANT_CONFIG=/data/home-assistant
+ENV PORT=7860
+
+EXPOSE 7860
+ENTRYPOINT ["/usr/local/bin/start-homeassistant"]

README.md

@@ -0,0 +1,37 @@
+---
+title: Home Assistant Mi Home
+emoji: 🏠
+colorFrom: blue
+colorTo: green
+sdk: docker
+app_port: 7860
+suggested_hardware: cpu-basic
+---
+
+# Home Assistant on Hugging Face Spaces
+
+This Space runs Home Assistant with the Xiaomi Miot custom integration pre-installed.
+
+## Required Space secrets
+
+The web interface works without backup secrets, but the free Space disk is ephemeral.
+For configuration recovery after a Space rebuild, create a private Dataset on the
+Hugging Face Hub and add these Space secrets:
+
+- `HF_TOKEN`: a token with write access to the private Dataset
+- `BACKUP_REPO_ID`: Dataset id, for example `your-name/home-assistant-backup`
+
+The startup script restores `homeassistant-latest.tar.gz` when it exists and uploads a
+new snapshot every 10 minutes. The backup includes Home Assistant's `.storage` folder,
+so integrations and onboarding state are retained. It excludes the recorder database,
+logs, cache, and media to keep the backup small.
+
+## First use
+
+Open the Space at its public URL and complete the Home Assistant onboarding flow. In
+**Settings -> Devices & services**, add **Xiaomi Miot Auto** and sign in with the Mi
+Home account. This integration generally requires the Xiaomi cloud region that owns
+ the devices; it does not require the Home Assistant container to be on the same LAN.
+
+Do not put `HF_TOKEN` in this repository or in `README.md`; use Space Settings ->
+Repository secrets.

scripts/backup-homeassistant.py

@@ -0,0 +1,79 @@
+"""Restore and upload a compact Home Assistant configuration snapshot."""
+from __future__ import annotations
+import argparse
+import os
+import sys
+import tarfile
+import tempfile
+from pathlib import Path
+
+ARCHIVE_NAME = "homeassistant-latest.tar.gz"
+
+
+def hub_api():
+    from huggingface_hub import HfApi
+    token = os.environ.get("HF_TOKEN")
+    repo_id = os.environ.get("BACKUP_REPO_ID")
+    if not token or not repo_id:
+        raise RuntimeError("HF_TOKEN and BACKUP_REPO_ID are required for Hub backups")
+    api = HfApi(token=token)
+    repo_type = os.environ.get("BACKUP_REPO_TYPE", "dataset")
+    try:
+        api.repo_info(repo_id=repo_id, repo_type=repo_type)
+    except Exception:
+        api.create_repo(repo_id=repo_id, repo_type=repo_type, private=True, exist_ok=True)
+    return api, repo_id, repo_type, token
+
+
+def archive_config(config: Path, archive: Path) -> None:
+    with tarfile.open(archive, "w:gz") as tar:
+        for path in config.rglob("*"):
+            if not path.is_file() or path.is_symlink(): continue
+            relative = path.relative_to(config).as_posix()
+            if relative in {"home-assistant_v2.db", "home-assistant.log"}: continue
+            if relative.endswith((".db-wal", ".db-shm")): continue
+            if relative.startswith((".cloud/", "tts/")): continue
+            tar.add(path, arcname=relative, recursive=False)
+
+
+def backup(config: Path) -> None:
+    api, repo_id, repo_type, token = hub_api()
+    with tempfile.TemporaryDirectory() as temp_dir:
+        archive = Path(temp_dir) / ARCHIVE_NAME
+        archive_config(config, archive)
+        api.upload_file(path_or_fileobj=str(archive), path_in_repo=ARCHIVE_NAME,
+                        repo_id=repo_id, repo_type=repo_type, token=token,
+                        commit_message="Update Home Assistant configuration backup")
+    print(f"Uploaded {ARCHIVE_NAME} to {repo_type}/{repo_id}", flush=True)
+
+
+def restore(config: Path) -> None:
+    try:
+        _, repo_id, repo_type, token = hub_api()
+        from huggingface_hub import hf_hub_download
+        archive = hf_hub_download(repo_id=repo_id, filename=ARCHIVE_NAME,
+                                  repo_type=repo_type, token=token, force_download=True)
+    except Exception as exc:
+        print(f"No Hub backup restored: {exc}", file=sys.stderr, flush=True)
+        return
+    config.mkdir(parents=True, exist_ok=True)
+    with tarfile.open(archive, "r:gz") as tar:
+        root = config.resolve()
+        for member in tar.getmembers():
+            target = (config / member.name).resolve()
+            if root not in target.parents: raise RuntimeError(f"Unsafe backup path: {member.name}")
+        tar.extractall(config)
+    print(f"Restored {ARCHIVE_NAME} into {config}", flush=True)
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser()
+    parser.add_argument("action", choices=("backup", "restore"))
+    parser.add_argument("--config", required=True, type=Path)
+    args = parser.parse_args()
+    if not os.environ.get("HF_TOKEN") or not os.environ.get("BACKUP_REPO_ID"): return 0
+    (backup if args.action == "backup" else restore)(args.config)
+    return 0
+
+
+if __name__ == "__main__": raise SystemExit(main())

scripts/start-homeassistant

@@ -0,0 +1,46 @@
+#!/usr/bin/env bash
+set -Eeuo pipefail
+
+CONFIG_DIR="${HOME_ASSISTANT_CONFIG:-/data/home-assistant}"
+CUSTOM_COMPONENT="/opt/hass-custom-components/xiaomi_miot"
+
+mkdir -p "$CONFIG_DIR/custom_components"
+if [[ ! -f "$CONFIG_DIR/configuration.yaml" ]]; then
+  python3 /usr/local/bin/backup-homeassistant.py restore --config "$CONFIG_DIR" || true
+fi
+
+if [[ ! -d "$CONFIG_DIR/custom_components/xiaomi_miot" ]]; then
+  cp -a "$CUSTOM_COMPONENT" "$CONFIG_DIR/custom_components/xiaomi_miot"
+fi
+
+if [[ ! -f "$CONFIG_DIR/configuration.yaml" ]]; then
+  cat > "$CONFIG_DIR/configuration.yaml" <<'YAML'
+default_config:
+
+http:
+  server_port: 7860
+YAML
+fi
+
+if [[ -n "${HF_TOKEN:-}" && -n "${BACKUP_REPO_ID:-}" ]]; then
+  (
+    while sleep 600; do
+      python3 /usr/local/bin/backup-homeassistant.py backup --config "$CONFIG_DIR" || true
+    done
+  ) &
+  BACKUP_PID=$!
+else
+  BACKUP_PID=""
+fi
+
+cleanup() {
+  if [[ -n "$BACKUP_PID" ]]; then kill "$BACKUP_PID" 2>/dev/null || true; fi
+  if [[ -n "${HF_TOKEN:-}" && -n "${BACKUP_REPO_ID:-}" ]]; then
+    python3 /usr/local/bin/backup-homeassistant.py backup --config "$CONFIG_DIR" || true
+  fi
+}
+trap cleanup EXIT TERM INT
+
+hass --config "$CONFIG_DIR" --port 7860 &
+HA_PID=$!
+wait "$HA_PID"