README.md

---
title: MovieGen Demo
emoji: 🚀
colorFrom: gray
colorTo: blue
sdk: docker
sdk_version: 5.30.0
app_file: Dockerfile
pinned: false
license: mit
short_description: A demo space for MovieGen1.1.
---

Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference

## Hardware Requirements
See [HARDWARE.md](./HARDWARE.md) for detailed hardware requirements and recommendations for running this app efficiently on CPU or GPU.

## Running with Docker

You can run this app in a containerized environment using Docker. The provided `Dockerfile` will automatically detect if a GPU is available and install GPU-specific dependencies (like `flash-attn`) if needed.

### 1. Build the Docker image
```bash
docker build -t moviegen-demo .
```

### 2. Run the container
```bash
docker run --rm -p 7860:7860 moviegen-demo
```

- The app will be available at http://localhost:7860
- By default, the container runs in CPU mode. If a compatible GPU is available and Docker is configured for GPU access (e.g., with `--gpus all`), GPU dependencies will be installed and used automatically.

#### To run with GPU (if available):
```bash
docker run --rm --gpus all -p 7860:7860 moviegen-demo
```

> **Note:**
> - For GPU support, you must have the [NVIDIA Container Toolkit](https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/install-guide.html) installed and a CUDA-compatible GPU.
> - See [HARDWARE.md](./HARDWARE.md) for more details on requirements.