README.md

---
title: my-realesrgan-api
emoji: 🚀
colorFrom: yellow
colorTo: red
sdk: gradio
sdk_version: 4.39.0
app_file: app.py
pinned: false
---

# my-realesrgan-api (starter)

This Space is a minimal Gradio app that you can use as an API.

- Replace `app.py` with a real upscaler (e.g., Real-ESRGAN) when ready.
- Click "View API" on the Space page to see the `/predict` schema.
- Keep secrets out of the repo. Use the Space Settings → Secrets.

## Local files in this repo
- `app.py`: Gradio app entrypoint (Interface /predict).
- `requirements.txt`: Python dependencies (minimal for now).
- `packages.txt`: Optional Debian packages (useful for cv2/libgl when you add OpenCV or Real-ESRGAN).

## Notes
- If you add Real‑ESRGAN later, consider starting with GPU hardware (e.g. T4 Small).
- For heavy CV stacks, you may need to add: `opencv-python-headless`, `torch`, `realesrgan`, `basicsr`, `gfpgan`, `facexlib` to `requirements.txt` and `libgl1` to `packages.txt`.
- For private Spaces, set `HF_TOKEN` (and other keys) in Secrets, not in code.