feat: improve HF deployment workflow with proper configuration

- Add configurable environment variables for HF username and space name
- Include comprehensive setup instructions in workflow comments
- Add error checking for missing HF_TOKEN secret
- Update README with step-by-step deployment setup guide
- Make deployment workflow generic and reusable

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

.github/workflows/deploy.yml

@@ -1,5 +1,11 @@
 name: Deploy to Hugging Face Spaces
 
+# To enable this workflow:
+# 1. Create a Hugging Face account and create a Space at https://hf.co/new-space
+# 2. Get your HF token from https://hf.co/settings/tokens (with write access)
+# 3. Add HF_TOKEN as a repository secret in GitHub Settings > Secrets and variables > Actions
+# 4. Update the environment variables below with your HF username and space name
+
 on:
   workflow_run:
     workflows: ["CI"]
@@ -8,6 +14,10 @@ on:
     branches: [ main ]
   workflow_dispatch:
 
+env:
+  HF_USERNAME: "thompsonson"
+  HF_SPACE_NAME: "bayesian_game"
+
 jobs:
   deploy:
     runs-on: ubuntu-latest
@@ -23,7 +33,11 @@ jobs:
       env:
         HF_TOKEN: ${{ secrets.HF_TOKEN }}
       run: |
+        if [ -z "$HF_TOKEN" ]; then
+          echo "Error: HF_TOKEN secret not set. Please add your Hugging Face token to repository secrets."
+          exit 1
+        fi
         git config --global user.email "action@github.com"
         git config --global user.name "GitHub Action"
-        git remote add hf https://thompsonson:$HF_TOKEN@hf.co/spaces/thompsonson/bayesian_game
+        git remote add hf https://${{ env.HF_USERNAME }}:$HF_TOKEN@hf.co/spaces/${{ env.HF_USERNAME }}/${{ env.HF_SPACE_NAME }}
         git push hf main --force

README.md

@@ -275,9 +275,24 @@ Round 3: Evidence "same" (dice roll = target)
 
 ## 🚀 Deployment
 
-Ready for deployment on:
-- **Hugging Face Spaces**: Direct deployment support
-- **Local Server**: Built-in Gradio server
+### Hugging Face Spaces (Automated)
+
+The repository includes automated deployment to Hugging Face Spaces via GitHub Actions. To set this up:
+
+1. **Create a Hugging Face Space**: Go to [hf.co/new-space](https://hf.co/new-space) and create a new Gradio space
+2. **Get your HF Token**: Visit [hf.co/settings/tokens](https://hf.co/settings/tokens) and create a token with write access
+3. **Add GitHub Secret**: In your GitHub repository, go to Settings > Secrets and variables > Actions, and add:
+   - Name: `HF_TOKEN`
+   - Value: Your Hugging Face token
+4. **Update workflow**: Edit `.github/workflows/deploy.yml` and replace:
+   - `HF_USERNAME`: Your Hugging Face username
+   - `HF_SPACE_NAME`: Your space name
+
+The deployment will automatically trigger after successful CI runs on the main branch.
+
+### Other Deployment Options
+
+- **Local Server**: Built-in Gradio server (`python app.py`)
 - **Cloud Platforms**: Standard Python web app deployment
 
 ---