Theloomvale commited on
Commit
44f9d14
·
verified ·
1 Parent(s): 9e387fc

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +18 -23
README.md CHANGED
@@ -5,36 +5,31 @@ colorFrom: blue
5
  colorTo: gray
6
  sdk: gradio
7
  sdk_version: 5.49.1
8
- python_version: '3.10'
9
- torch_version: 2.1.2
10
- cuda_version: '12.1'
11
  app_file: app.py
12
  pinned: false
13
  ---
14
 
15
  ## Loomvale Image Lab — SDXL cinematic generator
16
 
17
- - Paste **Ambience + 5 Scenes** or **Pull from Google Sheet** (row’s `ImagePrompt_Ambience` + `ImagePrompt_Scenes`).
18
- - Generates **5 images** per run on **ZeroGPU** and (optionally) writes the image URLs to the sheet column **“AI generated images”** and marks **Assistant = Done**.
19
 
20
- **Follow us on Instagram** → [@theloomvale](https://instagram.com/theloomvale)
21
- Shop the template / automation kit → https://loomvale.gumroad.com/l/social-app
22
 
23
- ### Secrets to set (Settings → Variables & secrets → “New secret”)
24
- - `SHEET_ID` — your Google Sheet ID
25
- - `SHEET_NAME` `Pipeline` (or leave default)
26
- - `GOOGLE_CREDENTIALS_JSON` — service account JSON
27
- - `HF_TOKEN` optional (only needed for private models). Public SDXL works without it.
28
 
29
- ### ZeroGPU tips
30
- - First run can take longer (model download). Subsequent runs reuse cached weights.
31
- - If you see **HfHubHTTPError**, just try again the app retries and uses local snapshots after the first success.
32
- - Runtime is configured for **Gradio 5.49.1** with **PyTorch 2.1.2 / CUDA 12.1**, matching the combinations that the [ZeroGPU guide](https://huggingface.co/docs/hub/spaces-zerogpu) lists as available and the [framework matrix](https://huggingface.co/docs/hub/spaces-gpus#frameworks) documents.
33
- - Additional dependency pins live in [`requirements.txt`](./requirements.txt); keep them in sync when upgrading the Space SDK (notably `huggingface_hub==0.39.4` to satisfy Gradio’s requirement and `spaces==0.42.0` for Space helpers).
34
- - Avoid `torch.compile` in this environment — the [PyTorch compilation tutorial](https://docs.pytorch.org/tutorials/intermediate/torch_compile_tutorial.html) highlights GPU warm-up costs that are prohibitive for short ZeroGPU jobs.
35
 
36
- ### Space file layout
37
- - [`app.py`](./app.py) the Gradio entrypoint referenced by `app_file` in the metadata frontmatter. Keep this filename unless you also update the frontmatter.
38
- - [`requirements.txt`](./requirements.txt) Python dependency pins installed automatically by the Space runtime.
39
- - [`README.md`](./README.md) doubles as the Space “Configuration” tab; the YAML frontmatter above must stay at the top of the file.
40
- - [`.gitattributes`](./.gitattributes) optional but recommended for line-ending normalisation and future Large File Storage hooks.
 
5
  colorTo: gray
6
  sdk: gradio
7
  sdk_version: 5.49.1
 
 
 
8
  app_file: app.py
9
  pinned: false
10
  ---
11
 
12
  ## Loomvale Image Lab — SDXL cinematic generator
13
 
14
+ - Paste **Ambience + 5 Scenes** or **Pull from Google Sheet** (`ImagePrompt_Ambience` + `ImagePrompt_Scenes`).
15
+ - Generates **5 images** per run on **ZeroGPU** and (optionally) writes the image URLs back to column **“AI generated images”** and marks **Assistant = Done**.
16
 
17
+ **Follow [@theloomvale](https://instagram.com/theloomvale)**
18
+ Shop the template → [loomvale.gumroad.com/l/social-app](https://loomvale.gumroad.com/l/social-app)
19
 
20
+ ### 🔐 Secrets
21
+ - `SHEET_ID`
22
+ - `SHEET_NAME` = `Pipeline`
23
+ - `GOOGLE_CREDENTIALS_JSON`
24
+ - `HF_TOKEN` (optional, only for private models)
25
 
26
+ ### ZeroGPU tips
27
+ - First run downloads weights; later runs are fast.
28
+ - If you hit `HfHubHTTPError`, retry oncecached models load instantly after.
29
+ - No manual Torch/CUDA pins are needed; ZeroGPU provides optimized PyTorch automatically.
 
 
30
 
31
+ ### 📁 Space layout
32
+ - `app.py` Gradio UI entrypoint
33
+ - `requirements.txt` Python deps
34
+ - `README.md` Space metadata + config
35
+ - `.gitattributes` line-ending normalization / LFS future-proofing