Update README.md

README.md

@@ -11,16 +11,42 @@ license: mit
 short_description: Keep MCP-birthday hackathon spaces availble
 ---
 
-# 🔄 Space Keeper
+---
+title: Space Keeper
+emoji: 🔄
+colorFrom: blue
+colorTo: green
+sdk: gradio
+sdk_version: 4.44.0
+app_file: app.py
+pinned: false
+---
+
+# 🔄 Space Keeper v2
 
 Keeps HuggingFace Spaces alive during hackathon evaluation by pinging them on a schedule.
 
-## What it does
+## Features
+
+- **Live Progress** — See real-time updates as Spaces are being pinged
+- **Parallel Pinging** — Pings 10 Spaces simultaneously for speed
+- **Run History** — View logs of all past runs with success/failure counts
+- **Auto-Scheduler** — Automatically runs every 12 hours (configurable)
+- **Statistics** — Track total pings, success rates, and uptime
 
-- Automatically pings all Spaces in a specified organization every N hours
-- Prevents Spaces from sleeping due to inactivity
-- Logs all runs with success/failure status
-- Provides a manual "Run Now" button for immediate pings
+## How It Works
+
+1. **Manual Run:** Click "🚀 Run Now" to immediately ping all Spaces
+2. **Scheduled Run:** A background thread automatically runs every N hours
+3. **What happens:** For each Space, we send an HTTP GET to wake it up
+
+### Important: Scheduler Limitations
+
+The scheduler runs as a background thread. **If this Space sleeps, the scheduler stops.**
+
+To keep the scheduler running reliably:
+- Visit this Space at least once every 48 hours, OR
+- Set this Space to "Running" mode in settings (costs money)
 
 ## Configuration
 
@@ -28,19 +54,25 @@ Set these environment variables in your Space settings:
 
 | Variable | Default | Description |
 |----------|---------|-------------|
-| `ORG_NAME` | `mcp-hackathon` | The HuggingFace organization to monitor |
-| `PING_INTERVAL_HOURS` | `6` | How often to ping (in hours) |
-| `REQUEST_TIMEOUT` | `30` | Timeout for each ping request (in seconds) |
+| `ORG_NAME` | `MCP-1st-Birthday` | HuggingFace organization to monitor |
+| `PING_INTERVAL_HOURS` | `12` | Hours between automatic runs |
+| `PARALLEL_REQUESTS` | `10` | Spaces to ping simultaneously |
+| `REQUEST_TIMEOUT` | `30` | Seconds before a ping times out |
+| `HF_TOKEN` | *(optional)* | Only needed for private Spaces |
 
-## Usage
+## Files
 
-1. Create a new Space with this code
-2. Set the `ORG_NAME` environment variable to your hackathon org
-3. The Space will automatically ping all Spaces in that org every 6 hours
-4. Check the logs in the UI to verify everything is working
+```
+space-keeper-v2/
+├── app.py              # Main application
+├── requirements.txt    # Python dependencies
+└── README.md          # This file (also contains HF Space metadata)
+```
 
-## Notes
+## Usage
 
-- For ZeroGPU Spaces, you may want to reduce `PING_INTERVAL_HOURS` to 3 or 4
-- The Space stores logs in `run_logs.json` (kept for last 100 runs)
-- Logs persist as long as the Space is running
+1. Create a new Space at https://huggingface.co/new-space (SDK: Gradio)
+2. Upload all 3 files
+3. Optionally set `ORG_NAME` environment variable
+4. Click "🚀 Run Now" to test
+5. Keep the Space awake for automatic scheduling