---
title: AI Spot Sniper
emoji: 🎯
colorFrom: green
colorTo: blue
sdk: gradio
sdk_version: 6.16.0
app_file: app.py
pinned: false
---

# 🎯 AI Spot Sniper Terminal (Email Auto-Scanner)

This is an automated, institutional-grade cryptocurrency market scanner. It uses XGBoost machine learning, live order book imbalance data, and macroeconomic flow indicators (USDT Dominance) to find high-probability spot setups and email them directly to you.

## ⚙️ Setup Instructions

1. **Configure Email Credentials:**
   - Open `app.py` and input your Gmail address into `SENDER_EMAIL` and `RECEIVER_EMAIL`.
   - **Crucial:** Do not use your actual Google password. Go to your Google Account Security settings, search for "App Passwords", generate a 16-character password, and paste it into the `SENDER_PASSWORD` variable.

2. **Prevent Server Sleep (24/7 Uptime):**
   - Free Hugging Face Spaces will go to sleep after 48 hours of inactivity.
   - To keep the scanner running 24/7, go to [UptimeRobot](https://uptimerobot.com/).
   - Create a free HTTP(s) monitor pointing to your Hugging Face Space URL and set it to ping every 5 minutes.

## 🛡️ Risk Management (Manual Execution)
This bot **does not** have API access to your exchange wallet. It will only send you email alerts containing the entry, take-profit, and stop-loss targets. You must manually execute the trades on your exchange app to protect your capital.