README.md

metadata

title: NFA Track R FLUX.2 Fun CN ZeroGPU
emoji: 🎬
colorFrom: green
colorTo: blue
sdk: gradio
sdk_version: 5.49.1
app_file: app.py
pinned: false
license: other
short_description: Real Fun depth ControlNet fp8+xlarge (NOT soft image=depth)

Track R — FLUX.2 Fun depth ControlNet (ZeroGPU)

Hard rule: This Space runs real ALIMAMA / VideoX-Fun Fun ControlNet Union depth. Soft Flux2 image=depth is banned forever on this path.

Stack (2026-07-21 host-RAM fix)

Piece	Value
Painter	FLUX.2-dev DiT streamed to float8 (never full bf16 host materialize)
CN	VideoX-Fun Flux2ControlPipeline + FLUX.2-dev-Fun-Controlnet-Union-2602
TE	Local quantized diffusers/FLUX.2-dev-bnb-4bit (NO HF remote TE)
GPU	@spaces.GPU(duration=300, size="xlarge") = 96GB @ 2× Pro minutes
Memory mode	model_cpu_offload_and_qfloat8 (weights already fp8 at load)
Weights	HF Mount /data/FLUX.2-dev + /data/Fun-CN (+ TE download/cache)
Abort	NFA_FUN_CN_LOAD_DEADLINE_SEC (default 480) if Fun CN loaded not reached

Requires Space secret HF_TOKEN (gated FLUX.2-dev license accepted on the account).

Env

Var	Default
NFA_FUN_CN_GPU_SIZE	xlarge
NFA_FUN_CN_MEM_MODE	model_cpu_offload_and_qfloat8
NFA_FLUX2_TE_MODEL_ID	diffusers/FLUX.2-dev-bnb-4bit
NFA_FUN_CN_LOAD_DEADLINE_SEC	480

API

Same client contract: /generate_still
(positive, negative, depth_image, seed, width, height, steps, guidance, cn_strength)

Depth is required. Soft depth is never used.