chore: import local project into Gitea

README.md

@@ -0,0 +1,28 @@
+# 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`.