Nodes/二次元角色选择器 / Anime Character Selector/二次元角色选择器(中文)
ComfyUI Node

二次元角色选择器(中文)

The WAI character dropdown that understands Chinese names (and pinyin shorthand)

By R0smontis·Created 2 months ago·Updated about a month ago· 0
二次元角色选择器(中文)
    • prompt
    • info
    character
    random_action_seed1024
    character_weight1.00
    insert_before_characterfalse
    custom_prompt

    What it is

    If you run WAI-illustrious - or any Illustrious-family anime checkpoint - you already know the ritual. You want 胡桃, the model doesn't speak Chinese, so you type hu tao (genshin impact) into the positive prompt. Every single time. AnimeCharacterSelectorCN is that ritual turned into a dropdown: pick a Simplified Chinese name from a 5,721-entry list and it hands back the exact WAI model tag. No dictionary, no "what was that tag again" browser tabs.

    It's the Chinese half of the comfyui_anime_character_selector pack, a clean MIT fork of mirabarukaso/ComfyUI_Mira's WAI selector. The roster is bundled, not downloaded: a CSV mapping Chinese display names to the English tags WAI actually knows, kept current with verified additions for Arknights, Wuthering Waves, Zenless Zone Zero, Blue Archive, NIKKE and Genshin, plus a layer of classic anime characters. The author ships it as version 1.45.0 and iterates quickly - the changelog in the source docstring reads like a weekly "added N more characters, checked against the wiki" log.

    How it works

    The node loads data/wai_characters.csv at startup into a name→tag map. character is a plain combo box with 5,721 choices plus random; select one and the node emits the matching English tag - parentheses backslash-escaped so the (tag:weight) syntax can't break it, comma-terminated, then merged with your weight and optional custom prompt. The whole string comes out of the prompt output, which is what you wire into a CLIP Text Encode (positive). That's the entire pipeline.

    The interesting part is the frontend. A 5,700-item dropdown is unusable raw, so the pack ships a web extension that takes over ComfyUI's combo filter box and adds pinyin search: type ht and it jumps to 胡桃, type hutao for full pinyin, and it even tolerates typos with fuzzy matching. That's the feature that makes this node genuinely pleasant - and honestly the reason to use the CN node over the EN one instead of keeping a translate tab open.

    The inputs that matter

    • character - the dropdown. This is the whole node.
    • character_weight - 0.1 to 2.0, default 1.0. At 1.0 the tag is emitted bare; anything else wraps it as (tag:1.25). Leave it alone unless the character keeps getting drowned out of the image.
    • insert_before_character - flips the order so your custom_prompt lands before the character tag.
    • custom_prompt - optional. Where masterpiece or a pose tag goes; appended after the character by default.
    • random_action_seed - only matters when character is random: the pick is seed % roster, so the same seed always yields the same character.

    Both outputs are strings. prompt goes into your text encoder. info is a human-readable audit line (Character: 胡桃(原神) [hu tao (genshin impact)]) - handy for checking what the node resolved, not something the graph needs.

    Install

    One pack, both nodes - install once and you get the EN sibling too. In ComfyUI Manager, search comfyui_anime_character_selector (display name "二次元角色选择器 / Anime Character Selector") and hit install. Or manually:

    cd ComfyUI/custom_nodes
    git clone https://github.com/R0smontis/comfyui_anime_character_selector
    

    then restart ComfyUI. The good news is unusual for this ecosystem: zero Python dependencies (pure stdlib) and no model files - the roster ships inside the repo. There's no README to follow and none needed; the code is the documentation here. After install, hard-refresh your browser once so the pinyin extension's web assets load.

    Where people get burned

    • It's a WAI/Illustrious-family tool. On a Pony or natural-language checkpoint the tags quietly degrade - the vocabulary is specific to the Danbooru-trained family, not universal.
    • random isn't random in the dice sense; it's deterministic per seed. That's a feature when you're A/B-ing prompts, a trap if you expected a fresh character on every rerun without touching the seed.
    • The two nodes in this pack are the same roster. Think in Chinese names, use this one; the EN sibling shows the raw tags. Same character, either way.
    Category二次元角色选择器

    Inputs (5)

    NameTypeDefaultDescription
    characterCOMBO5722 options: random, 25时miku, 2B(尼尔:机械纪元), 2k娘(windows 2000), 3.1娘(windows 3.1), 35(樱巫女)(Hololive), +5716
    random_action_seedINT10240–18446744073709550000
    character_weightFLOAT1.000.1–2
    insert_before_characterBOOLEANfalse
    custom_promptoptSTRING

    Outputs (2)

    NameTypeDescription
    promptSTRING
    infoSTRING