gitwtfhub

wtf is charsheet?

animede/charsheet — explained in plain English

Analysis updated 2026-05-18

29PythonAudience · designerComplexity · 4/5Setup · hard

TL;DR

A web app that turns one uploaded character image into 8 different-angle views using AI image editing, then assembles them into a downloadable character sheet.

Mindmap

mindmap
  root((charsheet))
    What it does
      Upload one image
      Generate 8 angle views
      Build character sheet
      Download ZIP
    Tech stack
      FastAPI backend
      Diffusers models
      OpenCV split detection
    Use cases
      Character turnarounds
      Background removal
      Multi character split
    Audience
      Character artists
      Game asset creators
    Requirements
      GPU with VRAM
      Model downloads

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Generate a full turnaround set of views for a character from one reference image.

REASON 2

Automatically remove backgrounds from generated character views.

REASON 3

Split a multi-character reference sheet into individual character crops.

REASON 4

Fix a single generated view with a plain-English edit instruction.

What's in the stack?

PythonFastAPIDiffusersOpenCVPIL

How it stacks up

animede/charsheetadityasharmadotai-hash/docs-reader-rag-agentahang008/ah-talent-finder
Stars292929
LanguagePythonPythonPython
Setup difficultyhardeasyeasy
Complexity4/52/52/5
Audiencedesignervibe codergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · hard Time to first run · 1h+

Needs a capable GPU, ideally 24GB+ VRAM, and downloads multi-gigabyte AI models on first run.

Wtf does this do

Charsheet is a small web app that turns one picture of a character into a full character reference sheet showing that character from eight different angles: front, back, left, right, and the four diagonals in between. You upload a single image and the app uses an image editing AI model called Qwen-Image-Edit to generate each new view, then combines all eight into one sheet you can download as a ZIP file alongside the sheet image itself. The app is built with FastAPI as the backend and serves a Japanese language web interface. Behind the scenes it depends on Diffusers, a library for running image generation and editing models, plus two smaller helper models: one that speeds up generation and one trained to handle multiple viewing angles. If you already run ComfyUI, the app reuses its downloaded model files, otherwise it fetches them automatically from Hugging Face the first time you run it, which can take a while depending on your connection since the main model file is several gigabytes. Beyond the basic eight view generation, the app can detect and separate multiple characters if you upload a sheet that already contains several of them, letting you pick one to process. Individual views can also be corrected afterward: you type a plain instruction like remove the hair and the app redraws just that one image, with an undo option to switch back. There is also a one click background removal feature powered by a separate model. Running this requires real hardware. The README describes VRAM requirements ranging from under 24 gigabytes up to 65 gigabytes or more, with the app automatically choosing a slower offloading strategy on smaller GPUs. Generation itself, once the model is loaded, takes roughly forty seconds for a full set of eight views on a high end card. Only one generation or edit job can run at a time. Job state is kept in memory, so restarting the server clears the current job list, though the actual image files remain on disk.

Yoink these prompts

Prompt 1
Help me set up a Python virtual environment and install the dependencies for the charsheet app with CUDA support.
Prompt 2
Walk me through configuring COMFYUI_DIR so charsheet reuses my existing ComfyUI model files instead of re-downloading them.
Prompt 3
Show me how to call the /api/generate endpoint with curl to create a character sheet from an image file.
Prompt 4
Explain what VRAM offload mode I should use for a GPU with 24GB of memory.

Frequently asked questions

wtf is charsheet?

A web app that turns one uploaded character image into 8 different-angle views using AI image editing, then assembles them into a downloadable character sheet.

What language is charsheet written in?

Mainly Python. The stack also includes Python, FastAPI, Diffusers.

How hard is charsheet to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is charsheet for?

Mainly designer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.