shisei README

项目的 README,来自 github.com/wquguru/shisei。合并为一个 markdown 文件: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)

正在搜索数据库…

542 ·GitHub
这是什么?这是一个免费的 CC0 资源库,包含 280 套人偶姿势参考图,每套都从五个镜头角度绘制,可用于 Nano Banana、ChatGPT、ComfyUI 和 Midjourney 等 AI 图像工具。
这是需要安装的程序,还是只是一组图片?主要是图片:一个数据集,包含线稿、照片、黏土图、深度图和法线图,你可以下载后作为参考图上传。它还附带一个体积很小、无需依赖的静态画廊,用于浏览。
怎样获取这些姿势?从 Releases 页面下载线稿压缩包(36.5 MB,推荐使用的压缩包),或克隆仓库以获取网页版图片。然后在你的图像工具中,将某个视角作为姿势参考图上传。
除了这些文件,还需要什么?只需要一个支持参考图的图像工具,例如带 ControlNet 的 ComfyUI、Midjourney 或 ChatGPT。只有在运行仓库自带的脚本时才需要 Python。
所有姿势都能直接使用吗?不能。P038 和 P052 的姿势仍与其名称不符,因此保持隐藏;P062 的仰视图仍未完成。未通过质检或从未生成的视角会留空,而不是用劣质图填充。
图中是否包含真实人物或色情内容?图中人物是无面部特征的人偶,或 AI 生成的成年人,并非真实人物。性感系列和双人系列带有暗示性,默认经过模糊处理;README 禁止将图片用于色情内容,或用于描绘真实人物或未成年人。
包含哪些系列,共有多少个姿势?共四个系列:标准全身(展示 73 个中的 71 个)、上半身(80 个)、性感全身(80 个)和双人(展示 55 个中的 49 个)。每个姿势最多有五个镜头角度:正面、四分之三侧面、侧面、俯视和仰视。
是否提供用于 ControlNet 的深度图和法线图?是的。在 270 套姿势中,944 个线稿视角都有对应的黏土图、深度图和法线图,并与线稿像素对齐,因此可直接用于 ControlNet Depth 和 Normal。
这些图片可以用于商业用途吗?可以,CC0 允许商业使用且无需署名。项目说明仍禁止使用这些人物描绘真实人物或未成年人,或用于色情内容。
姿势名称使用哪些语言?名称和分类提供日语、中文、英语和韩语,画廊提供四种界面语言以及深色主题。
作者
wquguru
大小
252.7 MB
星标
542
时长
20天
提交 · 90 天