# Deploy to Hugging Face Spaces

1. **HuggingFace auth** (once, before deploy):
   - `uv tool install 'huggingface_hub[cli]'` (if not already installed)
   - Create a token at https://huggingface.co/settings/tokens with **WRITE** permission
   - `hf auth login --token YOUR_TOKEN`
   - Add `HF_TOKEN=hf_xxx` to `.env`

2. **Deploy** from this directory:
   ```bash
   uv run gradio deploy
   ```
   Follow prompts: specify `app.py`, choose hardware (e.g. cpu-basic), add secrets (`OPENAI_API_KEY`, `PUSHOVER_TOKEN`, `PUSHOVER_USER`), decline GitHub Actions if you prefer.

3. If you redeploy later, delete any `README.md` that Gradio created in this folder so it prompts again.