GitHub Publishing Cheat Sheet

发布到 github.com/aadebuger/ComfyUI-AgeShift 时的素材模板。

Repository About (一行描述)

Face age detection and identity-preserved age-shift portraits for ComfyUI — pairs with PuLID-Flux

(或更短:ComfyUI nodes for face age detection and age-shifted portraits via PuLID-Flux)

Topics(逗号分隔)

comfyui, comfyui-nodes, age-detection, age-progression, face-aging, pulid, flux, vit, huggingface, image-generation, ai

Release v0.1.1 notes(复制到 GitHub Release 描述)

## ComfyUI-AgeShift v0.1.1 — Documentation release

Documentation polish + complete prompt reference. No code changes; existing installs need no action.

### What's new
- 📖 **New PROMPTS.md** — every auto-generated prompt across all 20 age ranges, with full positive/negative examples at ages 5/15/25/45/65/80 and an explanation of the anti-drift negative logic.
- 🩹 **Troubleshooting section** added to README covering the four bugs commonly hit during first install: missing PuLID-Flux deps, InsightFace `antelopev2` path quirks, `websocket` vs `websocket-client` naming, and identity-drift tuning.
- 📝 **INSTALL_NOTES.md expanded** with the `antelopev2` manual placement step — the InsightFace lib requires a double `models/` directory (`models/insightface/models/antelopev2/`) which is not obvious.
- 🎯 **Identity preservation tuning guide** in README: when to bump `--pulid-weight`, when to drop guidance, and how to handle aging-down to child direction.

### Background

This release captures the lessons from the first end-to-end deployment on Ubuntu 22.04 + dual RTX 3090. See INSTALL_NOTES.md for the full record.

Release v0.1.0 notes(初始发布,可选)

## ComfyUI-AgeShift v0.1.0 — Initial release

Four ComfyUI nodes plus a CLI for face age detection and age-shifted portrait generation. Designed to pair with ComfyUI-PuLID-Flux for identity preservation.

### Nodes
- 🎂 **AgeDetectorLoader** — caches a HuggingFace ViT age classifier (default: `nateraw/vit-age-classifier`)
- 🎂 **AgeDetect** — continuous age estimation via weighted mean over bin midpoints
- 🎂 **AgePromptBuilder** — translates target age into concrete feature prompts ("deep nasolabial folds, salt-and-pepper hair") plus anti-drift negatives
- 🎂 **AgeRangeBatch** — JSONL output for batch age-progression sequences

### CLI
- End-to-end `age_shift_cli.py`: upload → detect → PuLID-Flux generation
- Supports `--detect-only`, single `--target-age`, or batched `--target-ages 5,15,25,45,65`
- PEP 723 inline metadata — no manual `pip install` needed when invoked with `uv run --script`

### Requirements
- ComfyUI
- (Optional, for image generation) ComfyUI-PuLID-Flux + Flux 1 dev/schnell weights

See README.md for full installation and quick-start.

发布步骤(沿用 aadebuger 节奏)

cd /path/to/local/ComfyUI-AgeShift

git init
git add .
git commit -m "v0.1.1: Documentation release with complete PROMPTS.md

- Add PROMPTS.md listing every auto-generated prompt across 20 age ranges
- Add troubleshooting section to README (PuLID deps, antelopev2 paths,
  websocket-client naming, identity drift tuning)
- Expand INSTALL_NOTES.md with InsightFace antelopev2 manual placement
- Add identity preservation tuning guide"

# 在 github.com/new 创建 aadebuger/ComfyUI-AgeShift
git remote add origin git@github.com:aadebuger/ComfyUI-AgeShift.git
git branch -M main
git push -u origin main

git tag v0.1.1
git push origin v0.1.1

发布后:

仓库 About 粘上面那行
Topics 粘上面那串
Release 用 v0.1.1 那段 markdown
第一个 star 后考虑提 PR 到 https://github.com/ltdrdata/ComfyUI-Manager 的 custom-node-list.json

ComfyUI-Manager 注册条目模板

提 PR 时往 custom-node-list.json 加这个对象:

{
  "author": "aadebuger",
  "title": "ComfyUI-AgeShift",
  "id": "comfyui-ageshift",
  "reference": "https://github.com/aadebuger/ComfyUI-AgeShift",
  "files": [
    "https://github.com/aadebuger/ComfyUI-AgeShift"
  ],
  "install_type": "git-clone",
  "description": "Face age detection (ViT) and age-conditioned prompt building. Pairs with PuLID-Flux for identity-preserving age-shift portraits — from infant to 90+."
}

Screenshots TODO

README.md 现在没有截图。发布时强烈建议放上:

docs/example_progression.png — 一张源图 + 5/15/25/45/65 五张生成的拼图
docs/node_palette.png — ComfyUI 节点 palette 截图,显示 4 个 🎂 节点
docs/workflow_screenshot.png — age_shift_pulid_flux.json 加载到 UI 的样子

可以放 docs/ 目录,然后在 README 的 Features 章节后面 / Quick start 章节前面插入:

![Age progression example](docs/example_progression.png)

Hua 跑出第一张满意的样图后,扔进 docs/ 直接 push,这页就完整了。

4.8 KiB Raw Permalink Blame History