shisei README

The project's README from github.com/wquguru/shisei. As one markdown file: README.md.

Shisei

Shisei 姿勢

A free (CC0) mannequin pose reference library: 280 poses in four series × 5 camera angles, drawn as clean line art, most views also as clay, depth and normal maps, for Nano Banana, ChatGPT, ComfyUI, Midjourney and other AI image tools.

English · 简体中文 · 日本語 · 한국어

Open the gallery · Download line art (36.5 MB) · Other downloads

Poses Line art Maps Photos Languages Dependencies Images Code

Content note: the sexy and duo series are suggestive adult pose references (faceless mannequins, no nudity detail). They stay out of previews and search pages, and the gallery shows them blurred until you tap one or flip the switch.

Shisei gallery: hero with a marquee mixing line-art poses on pastel tiles with clay, depth and normal maps

Shisei is a self-made pose reference library. Every pose is a faceless mannequin drawn from five angles — front, three-quarter, side, above and below — so you can feed the same pose to an image model from whichever camera you need. Names and categories come in Japanese, Chinese, English and Korean.

All images are original to this project.

What's inside

Series Poses shown Views that passed QC On the site
Full body · standard (std, P###) 71 of 73 300 / 365 shown
Upper body (upper, U###) 80 of 80 359 / 400 shown
Full body · sexy (sexy, S###) 80 of 80 352 / 400 blurred until tapped or switched on
Duo (duo, D###) 49 of 55 201 / 275 blurred until tapped or switched on

Poses rated suggestive (the sexy and duo series, upper's Sexy and Chest emphasis) are blurred in the gallery by default and kept off the marquee, pose pages, share cards and sitemap; tap one to see it, or one switch shows them all.

Using the images

Upload a view as the pose or composition reference in your image tool. Using several angles of the same pose keeps the figure consistent across shots. Face, clothing and background come from your prompt or other references.

Tier Where Size Typical file
w300 images/*/w300/ 300 px wide ~7 KB
w600 images/*/w600/ 600 × 800 ~17 KB
w900 images/*/w900/ 900 × 1200 ~29 KB
full original zip 1344 × 1792 (photos 1120 × 2240, redrawn sets 900 × 1200) ~100 KB

The repository holds the three web tiers: about 145 MB for the poses (line art, photos and the clay, depth and normal maps), plus about 150 MB for the costume library. The full-size originals and ready-made zips are on the Releases page; most people only need a zip.

Downloads

v0.4.1, the same files the gallery's download panel offers. Every zip is the 900 px tier of the views that passed QC (the originals excepted), with LICENSE, LICENSE-images and NOTICE; a .sha256 sits next to each. Most people only need the line-art zip. Clay, depth and normal have no originals: they are 900 px to begin with.

Pack Contents Sets Images Size
Line art · all series (recommended) line art + photos 280 1301 36.5 MB
Every format · all series line art, photos, clay, depth, normal 280 4133 69.0 MB
Clay · all series clay maps 270 944 9.2 MB
Depth · all series depth maps, for ControlNet Depth 270 944 7.1 MB
Normal · all series normal maps, for ControlNet Normal 270 944 16.2 MB
Full body · standard line art + photos 71 389 9.4 MB
Upper body line art 80 359 10.0 MB
Full body · sexy (suggestive) line art 80 352 9.3 MB
Duo (suggestive) line art 49 201 7.7 MB
Originals line art + photos at full size 280 1301 152.3 MB

web/ is a zero-dependency static gallery built from the catalog: series tabs with categories inside a series, an angle filter, a line-art / photo switch, a by-pose or single-image view, a switch that unblurs the suggestive series, a lightbox with keyboard and swipe navigation and a line-art / photo / compare mode, a page per pose, four UI languages and a dark theme. The spec is in docs/DESIGN.md.

python3 tools/build_site.py --link-images      # writes site/ (images symlinked for a fast preview)
python3 -m http.server 8000 -d site            # http://localhost:8000
python3 -I tools/build_site.py --public --site https://shisei.indaloop.app   # deploy build with images and share cards

Deep links open the lightbox directly: #P001-diag, #P001-diag-photo, #P001-diag-compare; filters live in the query string (?lang=ja&series=std&cat=5&angle=1&src=photo).

Layout

data/       catalog.json, catalog.csv — the source of truth
images/     line/ and photo/, each with w300/, w600/ and w900/ tiers
web/        static gallery source (index.html, app.js, app.css, i18n.js, common.js, changelog.yaml)
tools/      build_images.py, build_site.py, verify.py, import_series.py, qc_merge.py, review_sheets.py, pack_release.py, …
docs/       DESIGN, DECISIONS, GENERATION, LICENSING, translated READMEs, logo, screenshot

Check that the catalog and the images agree:

python3 tools/verify.py

Contributions are welcome: read CONTRIBUTING.md first (coding agents also follow AGENTS.md). Please report security issues privately as described in SECURITY.md.

Status and roadmap

Shisei is at v0.4.0: four series and 280 poses; the catalog is stable and IDs never change. Release notes are in CHANGELOG.md; open questions in docs/DECISIONS.md.

Milestone State
73 standard poses × 5 angles, catalog, web tiers, verify ✅ v0.1.0
Upper body, sexy and duo series, each view reviewed ✅ v0.2.0
Photo renders, after their own QC pass (D-03) ✅ public
Public gallery at shisei.indaloop.app (Cloudflare Pages) ✅ live
43 sparse or mislabelled sets redrawn as whole sets (D-09) ✅ v0.3.0
Clay, depth and normal maps for 944 views, aligned with the line art ✅ v0.4.0
P038 and P052: the drawing is another pose ☐ open
Fill the P062 below view ☐ open

Acknowledgements

The gallery uses Inter Tight, Noto Sans SC and JetBrains Mono (SIL OFL 1.1), served by Google Fonts, and shields.io badges in this README. Licensing rules are in docs/LICENSING.md.

The pose list — which poses, their numbering (orig_id), names and categories — follows the public catalog of ai-pose-gallery by ギア (@giaaibusi); the Chinese, English and Korean names are translations of it. Thank you. Only the list is shared: every image here was made for this project. Shisei is not affiliated with or endorsed by its author.

Notes

Every image was made for this project; none are copied, traced or derived from other pose collections. The figures are mannequins or AI-generated adults and do not depict real people. Do not use them to depict real people or minors, or for explicit content. Image metadata is stripped.

License

Using the images as a pose reference puts no conditions on the images you generate.

shisei (wquguru/shisei)

Searching Database…

400 ·GitHub
Shisei
What is this?A free CC0 library of 280 mannequin pose reference sets, each drawn from five camera angles, meant to be fed to AI image tools such as Nano Banana, ChatGPT, ComfyUI and Midjourney.
Is it a program I install or just a set of pictures?Mostly pictures: a dataset of line art, photos and clay, depth and normal maps that you download and upload as reference images. It also ships a small zero-dependency static gallery for browsing.
How do I get the poses?Download the line-art zip (36.5 MB, the recommended pack) from the Releases page, or clone the repo for the web-tier images. Then upload a view as the pose reference in your image tool.
What do I need besides the files?Just an image tool that accepts a reference image, such as ComfyUI with ControlNet, Midjourney or ChatGPT. Python only matters if you run the repo's own scripts.
Are all poses ready to use?No. P038 and P052 still show a different pose from their name and stay hidden, and the P062 below view is still open. Views that failed QC or were never generated are left empty instead of being filled with bad drawings.
Does it show real people or explicit content?The figures are faceless mannequins or AI-generated adults, not real people. The sexy and duo series are suggestive and blurred by default, and the README forbids using the images for explicit content or to depict real people or minors.
Which series and how many poses are included?Four series: standard full body (71 of 73 poses shown), upper body (80), sexy full body (80) and duo (49 of 55). Each pose has up to five camera angles: front, three-quarter, side, above and below.
Are there depth and normal maps for ControlNet?Yes. Clay, depth and normal maps exist for 944 of the line views across 270 sets, pixel-aligned with the line art, so they work directly with ControlNet Depth and Normal.
Can I use these images commercially?Yes, CC0 allows commercial use with no attribution. The project notes still ban using the figures to depict real people or minors, or for explicit content.
In which languages are the pose names?Names and categories are given in Japanese, Chinese, English and Korean, and the gallery offers four UI languages plus a dark theme.
What are similar projects?RuiC-PoseAtlas, Open-Generative-AI, Stable-Diffusion, krita-ai-diffusion, remove-ai-watermarks, StableGen, awesome-nano-banana-pro-prompts, StabilityMatrix
Which topics is it in?ai-image-generation, controlnet, nano-banana, ai-art, stable-diffusion, comfyui, dataset, multilingual, python
Creator
wquguru
Size
249.9 MB
Stars
400
Updated
CommitNov 02Releasev0.4.1Nov 01
Age
6d
Commits · 90 Days