# ComfyUI SAA Character Selector

ComfyUI custom node that:

1. Downloads Chinese/English character list and matching character thumbs from SAA sources.
2. Shows image cards in-node, supports click selection, and outputs selected character data.
3. Groups characters by origin.
4. Adds search box for Chinese/English/origin text.
5. Shows loading progress while downloading/parsing data.

## Install

Copy this folder into your ComfyUI custom nodes directory:

`ComfyUI/custom_nodes/ComfyUI_SAA_Character_Selector`

Then restart ComfyUI.

## Node

- Display name: `SAA Character Selector`
- Category: `SAA/Character`
- Outputs:
  - `character_zh`
  - `character_en`
  - `origin`
  - `character_json`

## Data Sources

- Character CSV:
  - `https://raw.githubusercontent.com/mirabarukaso/character_select_stand_alone_app/refs/heads/main/data/wai_characters.csv`
- Character thumbs:
  - `https://huggingface.co/datasets/flagrantia/character_select_stand_alone_app/resolve/main/wai_character_thumbs_v160.json?download=true`

Downloaded files are cached under:

`ComfyUI_SAA_Character_Selector/cache`