README.md

metadata

title: Perry Alchemist - Comic Generator
emoji: ⚗️
colorFrom: purple
colorTo: yellow
sdk: gradio
sdk_version: 6.18.0
python_version: '3.13'
app_file: app.py
pinned: false
short_description: perry- the alchemist
license: mit
tags:
  - comics
  - gradio
  - huggingface-spaces
  - image-generation
  - story-generation
  - track:wood
  - sponsor:modal

Perri Comic Generator

Track:An Adventure in Thousand Token Wood

Retro comic strip generator built around a single-panel workflow.

blogpost: https://dev.to/meemeealm/building-perri-a-comic-strip-generator-5a91

social media: https://x.com/siniyny/status/2066659720413479294

video: https://vimeo.com/1201597662

What it does

• Takes a short story seed from the user
• Builds a single structured comic panel description
• Generates the panel image on a backend diffusion worker
• Renders dialogue directly onto the image before returning it to the frontend

Architecture

• /app.py
  • Gradio UI
  • Prompt collection
  • API request/response handling
• /orchestrator.py
  • Single-panel script generation
  • Panel image generation
  • Dialogue overlay composition
• magic_theme.py
  • Shared theme and CSS styling

Local run

python frontend/app.py

Environment

Required backend secret / env values:

• HF_TOKEN
• MODAL_ENDPOINT_URL for the frontend

Notes

• The frontend expects the backend to return a single panel object
• The backend returns JPEG bytes encoded as base64 for the frontend image component
• The UI uses a magical vintage theme with star twinkle overlays