Run initial Hermes backup sooner

README.md

@@ -41,6 +41,8 @@ Optional backup settings:
 - `HF_BACKUP_TOKEN`: fine-grained Hugging Face token with read/write access to
   the private backup Dataset. Set this as a Space secret, not a public variable.
 - `HERMES_BACKUP_INTERVAL_SECONDS`: backup interval, default `1800`.
+- `HERMES_BACKUP_INITIAL_DELAY_SECONDS`: first backup delay after container
+  start, default `300`.
 - `HERMES_RESTORE_ON_START`: set to `0` to disable automatic restore on boot.
 - `HERMES_FORCE_RESTORE`: set to `1` once if you want to overwrite local state
   from the backup archive on the next boot.

scripts/hermes-backup-loop.sh

@@ -2,6 +2,7 @@
 set -euo pipefail
 
 interval="${HERMES_BACKUP_INTERVAL_SECONDS:-1800}"
+initial_delay="${HERMES_BACKUP_INITIAL_DELAY_SECONDS:-300}"
 
 case "$interval" in
   ''|*[!0-9]*)
@@ -10,7 +11,21 @@ case "$interval" in
     ;;
 esac
 
+case "$initial_delay" in
+  ''|*[!0-9]*)
+    echo "WARNING: invalid HERMES_BACKUP_INITIAL_DELAY_SECONDS=$initial_delay; using 300."
+    initial_delay=300
+    ;;
+esac
+
+echo "Hermes backup loop started. First backup in ${initial_delay}s, then every ${interval}s."
+
+if [[ "$initial_delay" != "0" ]]; then
+  sleep "$initial_delay"
+fi
+
 while true; do
-  sleep "$interval"
+  echo "Running Hermes state backup at $(date -u +%Y-%m-%dT%H:%M:%SZ)."
   /usr/local/bin/hermes-state-backup backup || echo "WARNING: Hermes state backup failed; will retry later."
+  sleep "$interval"
 done

scripts/hermes-state-backup.py

@@ -53,6 +53,25 @@ def state_has_content(root: Path) -> bool:
     return False
 
 
+def state_stats(root: Path) -> tuple[int, int]:
+    files = 0
+    bytes_total = 0
+    if not root.exists():
+        return files, bytes_total
+    for child in root.rglob("*"):
+        if not child.is_file():
+            continue
+        rel = child.relative_to(root)
+        if should_exclude(rel):
+            continue
+        files += 1
+        try:
+            bytes_total += child.stat().st_size
+        except OSError:
+            pass
+    return files, bytes_total
+
+
 def add_tree(tar: tarfile.TarFile, root: Path) -> None:
     for item in root.rglob("*"):
         rel = item.relative_to(root)
@@ -81,8 +100,10 @@ def backup() -> None:
     token = required_env("HF_BACKUP_TOKEN")
     root = Path(env("HERMES_BACKUP_DIR", "/home/hermeswebui/.hermes")).resolve()
     filename = env("HERMES_BACKUP_FILENAME", "hermes-state.tar.gz")
+    file_count, byte_count = state_stats(root)
+    print(f"Hermes state backup source: {root} ({file_count} files, {byte_count} bytes).")
 
-    if not state_has_content(root):
+    if file_count == 0:
         print("Hermes state backup skipped: no meaningful local state yet.")
         return
 
@@ -96,6 +117,7 @@ def backup() -> None:
 
         with tarfile.open(archive, "w:gz") as tar:
             add_tree(tar, root)
+        archive_size = archive.stat().st_size
 
         manifest.write_text(
             json.dumps(
@@ -103,6 +125,9 @@ def backup() -> None:
                     "created_at": timestamp,
                     "source": "Acrabohan/hermes-webui",
                     "path_in_repo": filename,
+                    "file_count": file_count,
+                    "source_bytes": byte_count,
+                    "archive_bytes": archive_size,
                 },
                 indent=2,
             )
@@ -127,7 +152,7 @@ def backup() -> None:
             commit_message=f"Update Hermes backup manifest {timestamp}",
         )
 
-    print(f"Hermes state backup uploaded to dataset {repo}.")
+    print(f"Hermes state backup uploaded to dataset {repo} ({archive_size} bytes).")
 
 
 def restore() -> None:

space-entrypoint.sh

@@ -55,11 +55,13 @@ if [[ "${HERMES_BACKUP_DISABLE_LOOP:-0}" != "1" && -n "${HERMES_BACKUP_REPO:-}"
     HERMES_BACKUP_REPO="${HERMES_BACKUP_REPO}" \
     HERMES_BACKUP_DIR="${HERMES_HOME:-/home/hermeswebui/.hermes}" \
     HERMES_BACKUP_INTERVAL_SECONDS="${HERMES_BACKUP_INTERVAL_SECONDS:-1800}" \
+    HERMES_BACKUP_INITIAL_DELAY_SECONDS="${HERMES_BACKUP_INITIAL_DELAY_SECONDS:-300}" \
     HERMES_BACKUP_FILENAME="${HERMES_BACKUP_FILENAME:-hermes-state.tar.gz}" \
     /usr/local/bin/hermes-backup-loop &
 fi
 
 unset HF_BACKUP_TOKEN HERMES_BACKUP_REPO HERMES_FORCE_RESTORE HERMES_RESTORE_ON_START
-unset HERMES_BACKUP_INTERVAL_SECONDS HERMES_BACKUP_FILENAME HERMES_BACKUP_DISABLE_LOOP
+unset HERMES_BACKUP_INTERVAL_SECONDS HERMES_BACKUP_INITIAL_DELAY_SECONDS
+unset HERMES_BACKUP_FILENAME HERMES_BACKUP_DISABLE_LOOP
 
 exec /hermeswebui_init.bash