feat: describe your change

README.md

@@ -11,3 +11,19 @@ pinned: false
 ---
 
 AI Puppet Theater is a public Gradio Space for building short interactive puppet shows from a user premise.
+
+## Updating the hackathon Space
+
+The org Space may **reject `git push`** (even on a new branch) when your role must contribute via **Pull Requests** on the Hub. That shows up as `You are not authorized to push to this repo`.
+
+Use the Hub API with a PR instead (uses `hf auth login`, not Git’s keychain):
+
+```bash
+hf auth login   # token with access to this Space
+./scripts/push-space-via-pr.sh "feat: your change summary"
+```
+
+Then open the PR link printed in the terminal and **merge** it on Hugging Face so `main` updates and the Space rebuilds.
+
+To point at another Space, set `HF_SPACE_REPO` (for example `YourUser/your-space-name`).
+

scripts/push-space-via-pr.sh

@@ -0,0 +1,20 @@
+#!/usr/bin/env bash
+# Push local tree to the hackathon Space using a Hub Pull Request (required when
+# direct git push is disabled for org Spaces). Uses `hf` auth, not Git credentials.
+set -euo pipefail
+cd "$(dirname "$0")/.."
+
+REPO_ID="${HF_SPACE_REPO:-build-small-hackathon/AI-Puppet-Theater}"
+MSG="${1:-chore: update Space}"
+
+exec hf upload "$REPO_ID" . . --repo-type space \
+  --exclude ".git/**" \
+  --exclude ".venv/**" \
+  --exclude ".uv-cache/**" \
+  --exclude "__pycache__/**" \
+  --exclude "*.py[cod]" \
+  --exclude ".pytest_cache/**" \
+  --exclude ".ruff_cache/**" \
+  --exclude ".DS_Store" \
+  --create-pr \
+  --commit-message "$MSG"