π Free CC0 mannequin pose reference library for AI image tools (Nano Banana, ChatGPT, ComfyUI, Midjourney) β 250+ poses Γ 5 angles in line art, names in ja/zh/en/ko
Python ai-artai-image-generationart-referencecc0comfyuicontrolnetdatasetdrawing-referencefigure-drawingline-artmannequinmidjourneymultilingualnano-bananapose-referencereference-imagesstable-diffusion
#!/usr/bin/env python3
"""Merge one generated series (a pose-gallery-* folder) into data/catalog.json.
Usage: python3 tools/import_series.py SRC --series sexy --added 0.2.0 [--general Cute,...]
Entries of that series are replaced; others are kept. Views become bare file names (null = not generated).
--general lists class_en values rated "general"; every other category of the series is "suggestive".
Without --general the whole series is rated by --rating (default general).
Per-pose decisions in data/rating_overrides.json (docs/qc/README.md, rating check) win over the category rule.
A pose redrawn from another source (tools/import_redraws.py) keeps its `source`, views and gaps.
"""
import argparse, json, pathlib
ROOT = pathlib.Path(__file__).resolve().parent.parent
VIEWS = ("front", "diag", "side", "above", "below")
FIELDS = ("id", "orig_id", "series", "added_in", "rating", "class_jp", "class_cn", "class_en", "class_kr",
"name_jp", "name_cn", "name_en", "name_kr", "desc_en", "views", "photos")
OPTIONAL = ("bodies",) # duo: MF / FF figure pairing; kept only when the source has it
REDRAWN = ("source", "views", "gaps")
def main() -> None:
ap = argparse.ArgumentParser()
ap.add_argument("src")
ap.add_argument("--series", required=True)
ap.add_argument("--added", required=True)
ap.add_argument("--general", default="")
ap.add_argument("--rating", default="general", choices=("general", "suggestive"))
a = ap.parse_args()
general = {s for s in a.general.split(",") if s}
ov_path = ROOT / "data/rating_overrides.json"
overrides = json.loads(ov_path.read_text()) if ov_path.exists() else {}
src = json.loads((pathlib.Path(a.src).expanduser() / "catalog.json").read_text())
path = ROOT / "data/catalog.json"
old = json.loads(path.read_text())
redrawn = {p["id"]: {k: p[k] for k in REDRAWN} for p in old if p.get("series") == a.series and p.get("source")}
# Source sets after std carry no desc_en; keep the one tools/import_descs.py filled in.
descs = {p["id"]: p.get("desc_en", "") for p in old if p.get("series") == a.series}
cat = [p for p in old if p.get("series") != a.series]
for p in src:
q = dict(p)
q["series"] = a.series
q["added_in"] = a.added
q["rating"] = ("general" if p["class_en"] in general else "suggestive") if general else a.rating
q["rating"] = overrides.get(p["id"], {}).get("rating", q["rating"])
q["desc_en"] = p.get("desc_en") or descs.get(p["id"], "")
q["views"] = {v: (pathlib.Path(p["views"][v]).name if p["views"].get(v) else None) for v in VIEWS}
q.setdefault("photos", [])
cat.append({k: q.get(k) for k in FIELDS} | {k: q[k] for k in OPTIONAL if q.get(k)} | redrawn.get(p["id"], {}))
path.write_text(json.dumps(cat, ensure_ascii=False, indent=1) + "\n")
print(f"{a.series}: {len(src)} poses; catalog now {len(cat)}")
if __name__ == "__main__":
main()