---
title: Expression Pack Studio
emoji: 🎭
colorFrom: purple
colorTo: pink
sdk: docker
pinned: false
license: mit
tags:
  - gradio
  - image-to-image
  - character
  - expression-pack
short_description: Standalone character expression ZIP generator
---

# Expression Pack Studio

A standalone UI for generating downloadable expression-pack ZIP files.

## What it does

- Upload a character portrait or character card PNG.
- Optionally paste character-card text or a visual description.
- Choose Starter 8, Standard 20, Full 28, or add custom expressions.
- Download one ZIP containing root-level PNGs, `expressions/*.png`, `reference.png`, and `manifest.json`.

## Environment variables

- `HF_TOKEN`: recommended for private/rate-limited upstream calls.
- `BACKEND_SPACE`: defaults to `jblast94/Qwen-Image-Edit-NSFW`.
- `TEXT_TO_IMAGE_MODEL`: defaults to `black-forest-labs/FLUX.1-schnell` for text-only reference generation.

## Local run

```bash
pip install -r requirements.txt
python app.py
```

## Docker run

```bash
docker build -t expression-pack-studio .
docker run --rm -p 7860:7860 -e HF_TOKEN=$HF_TOKEN expression-pack-studio
```