README.md

---
title: DreamX Creator
emoji: 🎬
colorFrom: green
colorTo: blue
sdk: docker
app_file: app.py
pinned: false
---

Docker-hosted DreamX-Creator 1.0 Space for the AI Shorts Factory backend
(engine vendored from `AMAP-ML/DreamX-Creator` / `hugging-apps/gd-ml-dreamx-creator`).

One endpoint via Gradio's `/call/generate` protocol:

- `generate(image, prompt, seconds, num_inference_steps, resolution_tokens,
  guidance_scale, negative_prompt, seed, randomize_seed)`
  → `(mp4 with jointly-denoised audio, last-frame PNG, seed)`.

`image` may be empty — a neutral keyframe is generated in-app. The last-frame
PNG is returned so each scene can feed the next one (continuity chaining).

Weights (~43 GB peak) download at first boot from the ungated
`GD-ML/DreamX-Creator` repo into `./checkpoints` (override with
`DREAMX_CKPT_DIR`, e.g. `/data/dreamx` when persistent storage is enabled).

Requires **ZeroGPU** hardware (`hardware: gpu: zero` above and/or the Space
Settings toggle) — the free CPU tier cannot denoise.