README.md

---
title: YapStation Backend
emoji: 🚀
colorFrom: blue
colorTo: purple
sdk: docker
app_port: 7860
pinned: false
---

# ⚡ YapStation backend

FastAPI backend for YapStation: REST endpoints + WebSockets, backed by Supabase (Postgres + Storage).

## ▶️ Run (recommended)

From the repo root on Windows:

- `run-backend.bat` (starts FastAPI on `http://localhost:7860/docs`)

Or run directly:

```bash
cd backend
pip install -r requirements.txt
python -m uvicorn server:app --host 0.0.0.0 --port 7860 --reload
```

## 🔐 Environment variables

The backend loads environment variables from the **repo root** `.env` (see `server.py`).

**Required**

- `SUPABASE_URL`
- `SUPABASE_KEY` (anon/publishable key)

**Optional**

- `SUPABASE_SERVICE_KEY` (privileged server operations; keep secret)
- `JWT_SECRET` (session cookie signing)
- `FRONTEND_URL` (CORS + password reset link base)

**📧 Email (password reset)**

- `SMTP_HOST`, `SMTP_PORT`, `SMTP_USER`, `SMTP_PASSWORD`, `MAIL_FROM`

**🤖 BitAI (optional)**

- `GROQ_API_KEY`

## 🧠 Notes

- **Port**: this project uses **7860** (not 8000).
- **Auth cookie**: local dev runs on HTTP so cookies default to non-secure. In production behind HTTPS, set `SESSION_COOKIE_SECURE=true`.