Initial commit: EventRate pipeline, fuzzy dedup, Airbnb retries

Wire up Ticketmaster, SeatGeek, Telegram, scoring, Playwright stubs.
Deduplicate events with fuzzy venue/name matching. Retry calendar
updates on transient failures. Backlog tasks marked complete.

Made-with: Cursor

README.md

@@ -0,0 +1,70 @@
+# EventRate
+
+Local Python application that identifies upcoming Toronto events likely to increase Airbnb demand, sends Telegram alerts, and optionally adjusts nightly prices via Playwright automation.
+
+## Quick start
+
+```bash
+# 1. Clone and enter
+git clone https://git.levkin.ca/ilia/AtAnyRate.git
+cd AtAnyRate
+
+# 2. Create a virtual environment
+python3 -m venv .venv
+source .venv/bin/activate
+
+# 3. Install dependencies
+pip install -r requirements.txt
+playwright install chromium
+
+# 4. Configure
+cp .env.example .env
+# Edit .env with your API keys (see below)
+
+# 5. Run
+python -m src.main --dry-run        # preview only, no side effects
+python -m src.main --alerts-only    # fetch events + send Telegram
+python -m src.main                  # full flow (alerts + Airbnb update)
+```
+
+## Environment variables
+
+| Variable | Required | Description |
+|---|---|---|
+| `TICKETMASTER_KEY` | Yes | Ticketmaster Discovery API key (free tier) |
+| `SEATGEEK_CLIENT_ID` | Yes | SeatGeek API client ID (free tier) |
+| `TELEGRAM_BOT_TOKEN` | Yes | Telegram bot token from @BotFather |
+| `TELEGRAM_CHAT_ID` | Yes | Your Telegram chat/user ID |
+| `AIRBNB_LISTING_ID` | No | Airbnb listing ID for calendar automation |
+| `AIRBNB_BASE_PRICE` | No | Base nightly price (CAD) |
+| `PRICE_INCREASE_PCT` | No | Price increase percentage for event dates (default: 20) |
+| `LOOKAHEAD_DAYS` | No | Days ahead to scan for events (default: 30) |
+| `LOG_LEVEL` | No | Logging level (default: INFO) |
+
+## Airbnb session setup (one-time)
+
+```bash
+python scripts/airbnb_login.py
+```
+
+This opens a headed browser. Log in manually, complete any 2FA, then press Enter in the terminal. Your session is saved to `state.json` for reuse in headless runs.
+
+## Running on cron
+
+```bash
+# Weekly Monday 8 AM
+0 8 * * 1 cd /path/to/AtAnyRate && .venv/bin/python -m src.main --alerts-only >> /var/log/eventrate.log 2>&1
+```
+
+## Docker
+
+```bash
+docker build -t eventrate .
+docker run --rm --env-file .env -v $(pwd)/state.json:/app/state.json eventrate
+```
+
+## Project docs
+
+- [PROJECT.md](PROJECT.md) — goals, scope, constraints
+- [ARCHITECTURE.md](ARCHITECTURE.md) — system design and module map
+- [BACKLOG.md](BACKLOG.md) — feature backlog and task breakdown