---
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)*