Add GitHub Actions workflows for automatic Hugging Face Space sync

.github/workflows/README.md

@@ -0,0 +1,48 @@
+# GitHub Actions Workflows
+
+This repository uses GitHub Actions to automatically sync changes to Hugging Face Spaces.
+
+## Workflows
+
+### 1. sync-to-huggingface.yml
+- **Trigger**: Push to main branch or manual dispatch
+- **Method**: Direct git push to Hugging Face Space
+- **Speed**: Fast, simple approach
+
+### 2. sync-hf-space.yml
+- **Trigger**: Push to main, PR to main, or manual dispatch
+- **Method**: Uses huggingface_hub Python library
+- **Features**: More control over file uploads, ignore patterns
+
+## Setup Instructions
+
+### Step 1: Get Hugging Face Token
+1. Go to: https://huggingface.co/settings/tokens
+2. Click "New token"
+3. Name: `github-actions`
+4. Role: `write`
+5. Copy the token
+
+### Step 2: Add Token to GitHub Secrets
+1. Go to your GitHub repo: https://github.com/crosse712/fastvlm-screen-observer
+2. Navigate to: Settings → Secrets and variables → Actions
+3. Click "New repository secret"
+4. Name: `FASTVLM_API`
+5. Value: Paste your Hugging Face token
+6. Click "Add secret"
+
+### Step 3: Enable Workflow
+The workflows will automatically run when you:
+- Push to the main branch
+- Create a pull request
+- Manually trigger from Actions tab
+
+## Manual Trigger
+1. Go to: https://github.com/crosse712/fastvlm-screen-observer/actions
+2. Select a workflow
+3. Click "Run workflow"
+4. Select branch and run
+
+## Monitoring
+- Check workflow runs: https://github.com/crosse712/fastvlm-screen-observer/actions
+- View Space build logs: https://huggingface.co/spaces/crosse712/fastvlm-screen-observer

.github/workflows/sync-hf-space.yml

@@ -0,0 +1,63 @@
+name: Sync to HF Space (Official Action)
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
+  workflow_dispatch:
+
+env:
+  HF_SPACE_ID: crosse712/fastvlm-screen-observer
+
+jobs:
+  sync:
+    runs-on: ubuntu-latest
+    
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          lfs: true
+      
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.9'
+      
+      - name: Install huggingface_hub
+        run: pip install huggingface_hub
+      
+      - name: Sync to Hugging Face Space
+        env:
+          HF_TOKEN: ${{ secrets.FASTVLM_API }}
+        run: |
+          python -c "
+          from huggingface_hub import HfApi
+          import os
+          
+          api = HfApi()
+          space_id = '${{ env.HF_SPACE_ID }}'
+          token = os.environ.get('HF_TOKEN')
+          
+          # Upload all files to the Space
+          api.upload_folder(
+              folder_path='.',
+              repo_id=space_id,
+              repo_type='space',
+              token=token,
+              commit_message='Sync from GitHub: ${{ github.event.head_commit.message }}',
+              ignore_patterns=['*.git*', '.github/**', '__pycache__/**', '*.pyc', 'venv/**', 'node_modules/**']
+          )
+          
+          print(f'✅ Successfully synced to {space_id}')
+          "
+      
+      - name: Display Space URL
+        run: |
+          echo "🚀 Deployment triggered!"
+          echo "🔗 Space URL: https://huggingface.co/spaces/${{ env.HF_SPACE_ID }}"
+          echo "📊 Check the Space for build status and logs"

.github/workflows/sync-to-huggingface.yml

@@ -0,0 +1,34 @@
+name: Sync to Hugging Face Space
+
+on:
+  push:
+    branches:
+      - main
+  workflow_dispatch:  # Allows manual triggering
+
+jobs:
+  sync-to-space:
+    runs-on: ubuntu-latest
+    
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          lfs: true
+      
+      - name: Push to Hugging Face Space
+        env:
+          HF_TOKEN: ${{ secrets.FASTVLM_API }}
+        run: |
+          # Add Hugging Face as a remote
+          git remote add space https://crosse712:$HF_TOKEN@huggingface.co/spaces/crosse712/fastvlm-screen-observer
+          
+          # Force push to the Space (this will overwrite the Space with the GitHub repo)
+          git push --force space main
+      
+      - name: Verify deployment
+        run: |
+          echo "✅ Successfully synced to Hugging Face Space!"
+          echo "🔗 View your Space: https://huggingface.co/spaces/crosse712/fastvlm-screen-observer"
+          echo "📊 Check build logs in the Space UI for deployment status"