# MeetMe automation bots (Python workspace)

Hybrid MeetMe scraping / conversational bots leveraging `meetme-backend-api`, `enhanced_*_bot.py`, `run_bots.py`, and supporting docs (`HYBRID_SETUP_GUIDE.md`, API analyses).

### Quick setup

```bash
python -m venv .venv && source .venv/bin/activate  # adjust for PowerShell if needed
pip install -r requirements.txt
copy env_template_enhanced.txt .env               # populate secrets offline
pwsh ./quick_start.ps1                            # Windows helper script
python run_bots.py                                # after env configured
```

### Docs index

| File | Focus |
|------|-------|
| `HYBRID_SETUP_GUIDE.md` | End-to-end stack walkthrough |
| `API_V2_ANALYSIS.md` / `api_analysis.md` | API surface notes |
| `ENHANCEMENTS_SUMMARY.md` | Behavioral improvements |
| `setup_local_backend.md` | Lightweight backend mocking |

### Security

- **`/.env`** is ignored — never commit OAuth keys, JWTs, or MeetMe passwords.
- If any secrets were staged previously, rotate them before publishing remotely.
- `__pycache__/` and `*.log` stay out of version control thanks to `.gitignore`.