Upload README.md

README.md

@@ -0,0 +1,30 @@
+---
+title: Aviator Data Collector
+emoji: 🚀
+colorFrom: blue
+colorTo: purple
+sdk: docker
+app_port: 7860
+---
+
+# Aviator Data Collector Bot 🚁
+
+This bot is designed to run 24/7 on Hugging Face to collect live game multipliers and timestamps for future Reinforcement Learning (RL) model training.
+
+## How it Works
+- Uses **Playwright Headless** to bypass basic protections and monitor the DOM directly.
+- Saves results continuously into `game_history.csv` without missing a beat.
+- Exposes a FastAPI server on port 7860 to keep the Hugging Face Space "Alive".
+
+## Keeping It Alive 24/7
+Hugging Face puts free spaces to sleep after 48 hours of inactivity. To prevent this:
+1. Copy your Space URL (e.g., `https://your-username-aviator-collector.hf.space`).
+2. Go to [UptimeRobot](https://uptimerobot.com/) or [Cron-job.org](https://cron-job.org/).
+3. Add a new HTTPS monitor pointing to your Space URL.
+4. Set it to ping every 5 minutes.
+
+## API Endpoints
+- `/` - Healthcheck (Shows if bot is running)
+- `/results` - Returns the last 50 collected multipliers in JSON format.
+
+*(Made for RL Training data gathering)*