Update README.md

README.md

@@ -1,13 +1,46 @@
----
-title: Certificate Generator Agent
-emoji: 🌍
-colorFrom: pink
-colorTo: red
-sdk: gradio
-sdk_version: 5.41.1
-app_file: app.py
-pinned: false
-license: apache-2.0
----
+# HawkFranklin Certificate Agent (Gradio)
+
+Generate polished **Certificates of Experience** with a fixed baseline template, optional letterhead, and one-click **HTML → PDF** export. Includes an optional **AI style assistant** powered by `openai/gpt-oss-20b` to suggest color palettes and tone tweaks.
+
+## Modes
+- **CPU Basic + Docker (Recommended for PDF):** full HTML→PDF via WeasyPrint. Set hardware to *CPU Basic*, Space SDK to *Docker*, and keep the Dockerfile.
+- **ZeroGPU (No Docker):** exposes a `@spaces.GPU` palette helper and disables server-side PDF. Set Space SDK to *Gradio (Python)*, set `ZERO_GPU=1` in Space Secrets, and **remove the Dockerfile** from the repo.
+
+## Quick Start (Local)
+```bash
+python -m venv .venv && source .venv/bin/activate
+pip install -r requirements.txt
+python app.py
+```
+Then open the Gradio URL.
+
+> **macOS**: If WeasyPrint complains about Cairo/Pango, install via Homebrew:
+> ```bash
+> brew install cairo pango gdk-pixbuf
+> ```
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+## Hugging Face Space
+### CPU Basic + Docker
+- Keep Dockerfile, push repo, set hardware to **CPU Basic**.
+- Optional: set `USE_OSS_MODEL=1` to enable the style assistant without GPU.
+
+### ZeroGPU (Gradio SDK)
+- Remove Dockerfile from repo.
+- Add Space Secret `ZERO_GPU=1` (and `USE_OSS_MODEL=1` if you want the OSS model).
+- The app includes `@spaces.GPU` function `suggest_palette_with_gpu` and calls it when you click **Suggest Palette (AI)**.
+- PDF export is disabled (no system libs). Download HTML and print-to-PDF client-side or use an external API.
+
+## Usage
+1. Upload your `HawkFranklin_letterhead_may.jpg` (optional).
+2. Fill recipient, project, duration, signer, etc.
+3. Click **Build Preview**.
+4. Click **Export** to download HTML (and PDF on CPU Basic + Docker).
+5. Use **AI Style Assistant** to get palettes.
+
+## Roadmap
+- CSV batch generation
+- Signature image field
+- External HTML→PDF API fallback for ZeroGPU
+
+---
+**License**: MIT