---
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.