README.md

---
title: PepBielsa Monitor Bot
emoji: ⚽
colorFrom: green
colorTo: blue
sdk: docker
app_port: 7860
pinned: false
license: mit
---

# ⚽ PepBielsa Monitor Bot

A Telegram channel monitor and forwarder with AI-powered deduplication (Groq llama-3.1-8b-instant).

## Health Check

A lightweight web server runs alongside the bot at `/health` — used by UptimeRobot to prevent the Space from sleeping.

```
GET https://<your-space>.hf.space/health
```

## Environment Variables

Set these as **Secrets** in your HF Space settings (`Settings → Repository secrets`):

| Variable | Description |
|----------|-------------|
| `API_ID` | Telegram API ID |
| `API_HASH` | Telegram API Hash |
| `PHONE_NUMBER` | Your Telegram phone number |
| `SESSION_STRING` | Generated by `session_export.py` |
| `SOURCE_CHANNELS` | Comma-separated channel usernames |
| `DESTINATION_CHANNEL` | Target channel username |
| `GROQ_API_KEY` | Groq API key (free at console.groq.com) |
| `HF_TOKEN` | HF write token (for persistent store) |
| `HF_DATASET_REPO` | e.g. `yourname/pepbielsa-processed` |

## UptimeRobot Setup

1. Create a **HTTP(s)** monitor
2. URL: `https://<your-space-name>.hf.space/health`
3. Monitoring interval: **5 minutes**
4. Keyword monitor (optional): set keyword to `Online`