# 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 / refresh)

Airbnb requires a logged-in browser session saved to `state.json`. Headless servers cannot complete 2FA — run login on a machine with a display, then copy the file to the server.

### Local login (Mac)

```bash
python scripts/airbnb_login.py
```

Chromium opens. Log in, complete any 2FA, then press Enter in the terminal. Session cookies are saved to `state.json`.

### Production (automationlab @ 10.0.10.45)

Recommended: login on your Mac, then copy:

```bash
scp state.json root@10.0.10.45:/opt/atanyrate/state.json
ssh root@10.0.10.45 'chmod 600 /opt/atanyrate/state.json'
```

Or use the ansible deploy script: `ATANYRATE_STATE=~/path/to/state.json make deploy-atanyrate` (see `docs/guides/atanyrate-deploy.md` in the ansible repo).

### Session expiry

Airbnb sessions expire (weeks to months). When calendar automation fails with login/auth errors or empty calendar pages, re-run `scripts/airbnb_login.py` and push a fresh `state.json`. Weekly cron uses `--alerts-only` by default so Telegram alerts keep working if Airbnb auth is stale.

### Stealth browser (optional)

If Airbnb blocks or challenges stock Playwright Chromium, try [invisible_playwright](https://github.com/feder-cr/invisible_playwright) (patched Firefox, anti-detect):

```bash
pip install 'git+https://github.com/feder-cr/invisible_playwright.git'
python -m invisible_playwright fetch   # ~100 MB one-time

AIRBNB_STEALTH=1 python scripts/airbnb_login.py   # login + save state.json
AIRBNB_STEALTH=1 python -m src.main               # headless calendar run
```

Use **the same engine** for login and automation — `state.json` from Chromium does not work in Firefox and vice versa. Stealth mode does **not** bypass 2FA; you still log in manually in the headed window.

## 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
```

## Production deploy

Deployed on **automationlab** (`10.0.10.45`) at `/opt/atanyrate`. Full guide: ansible repo `docs/guides/atanyrate-deploy.md`.

```bash
# From ~/Documents/code/ansible
ATANYRATE_ENV=~/Documents/code/@AnyRate/.env make deploy-atanyrate
```

## 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