FPL Guardian

A Telegram bot that watches your Fantasy Premier League team and warns you before deadlines if any of your players are injured, doubtful, or suspended. No FPL login required — only your public Team ID.

Use it now: search @fpl_2026_bot in Telegram, DM it, and run /setteam <your_team_id>. Multi-user, free, no setup needed.

What it does

• Deadline reminders — a team status digest at 24h, 6h, 1h and 30m before each gameweek deadline.
• Injury/status alerts — pinged immediately when a player in your squad becomes doubtful/injured/suspended.
• Suggestions — bench cover for flagged starters, vice-captain swap if your captain is flagged, and fixture/form-aware scout picks when no fit cover exists.
• /done to silence reminders once you've sorted your team for the week (injury alerts still come through); /trending for the most transferred-in players.

Rule-based, not automatic — it never touches your actual FPL squad, only tells you what it sees.

Self-hosting

1. Create a bot via @BotFather for your token.
2. Copy .env.example to .env, fill in TELEGRAM_BOT_TOKEN.
3. docker compose up -d --build

Or without Docker: pip install -r requirements.txt && python main.py.

Architecture

fpl_bot/
  fpl_api.py    — public FPL API client (bootstrap-static, entry, picks)
  analysis.py   — builds a team report: flagged players, captain check, suggestions
  formatting.py — turns a report into a Telegram message
  checker.py    — fetches one user's squad + report on demand
  jobs.py       — scheduled tick: deadline reminders + status-change alerts
  db.py         — SQLite (users, sent reminders, player status, dedup)
  bot.py        — Telegram command handlers + job scheduling

All state lives in one SQLite file. No external services needed.