akhaliq HF Staff commited on
Commit
164ddf4
·
verified ·
1 Parent(s): 5150b7b

README: ZeroGPU setup and quota notes

Browse files
Files changed (1) hide show
  1. README.md +10 -4
README.md CHANGED
@@ -30,15 +30,21 @@ Three modes in one model:
30
  - **Subject-driven generation** — place a subject from a photo into a new scene
31
  - **Canny-to-image** — generate from an edge map (auto-extraction available)
32
 
33
- ## Running it (hardware requirements)
34
 
35
- This demo loads a video-generation backbone plus a 7B text encoder and several
36
- vision encoders. Recommended: **A100 (40 GB+)**. For smaller GPUs, set the
37
- environment variable `FF_OFFLOAD=true` (much slower, CPU offloading).
 
 
38
 
39
  **First run downloads ~60 GB of checkpoints.** On Spaces, attach persistent
40
  storage and set `FF_CKPT_DIR=/data/ckpts` so this happens once.
41
 
 
 
 
 
42
  Required secret: `HF_TOKEN` — the pipeline pulls the **gated**
43
  [FLUX.1-Redux-dev](https://huggingface.co/black-forest-labs/FLUX.1-Redux-dev)
44
  vision encoder, so the token's account must have accepted its license.
 
30
  - **Subject-driven generation** — place a subject from a photo into a new scene
31
  - **Canny-to-image** — generate from an edge map (auto-extraction available)
32
 
33
+ ## Running it
34
 
35
+ Built for **ZeroGPU** (`xlarge` slices, 96 GB): generation functions are
36
+ decorated with `@spaces.GPU`, and torch is pinned to **2.8.0** (the closest
37
+ ZeroGPU-supported version to the authors' 2.6.0 pin). It also runs unchanged
38
+ on a persistent GPU (A100 40 GB+ recommended; `FF_OFFLOAD=true` for smaller
39
+ GPUs at a large speed cost) — the decorator is a no-op off ZeroGPU.
40
 
41
  **First run downloads ~60 GB of checkpoints.** On Spaces, attach persistent
42
  storage and set `FF_CKPT_DIR=/data/ckpts` so this happens once.
43
 
44
+ **Quota note:** a 50-step generation takes a few minutes of GPU time and
45
+ `xlarge` consumes 2× daily quota — free accounts (5 min/day) get roughly one
46
+ image per day, PRO accounts (40 min/day) get several.
47
+
48
  Required secret: `HF_TOKEN` — the pipeline pulls the **gated**
49
  [FLUX.1-Redux-dev](https://huggingface.co/black-forest-labs/FLUX.1-Redux-dev)
50
  vision encoder, so the token's account must have accepted its license.