README.md

---
title: STARFlow
emoji: 🎨
colorFrom: blue
colorTo: purple
sdk: gradio
sdk_version: 6.0.2
app_file: app.py
pinned: false
license: apache-2.0
---

# STARFlow: Text-to-Image & Video Generation

Generate high-quality images and videos from text prompts using STARFlow models.

## Usage

1. Upload a model checkpoint (.pth file)
2. Enter your text prompt
3. Adjust settings (CFG scale, aspect ratio, etc.)
4. Click "Generate"

## Models

- **STARFlow 3B**: Text-to-image generation (256x256)
- **STARFlow-V 7B**: Text-to-video generation (480p, ~5 seconds)

## Hardware

This Space requires GPU. Select GPU T4 small (free) or GPU A10 (paid) in Space settings.

## Configuration

- **Config files**: Located in `configs/` directory
- **Requirements**: See `requirements.txt`
- **App**: `app.py` (Gradio interface)