Extensions/H3 Character Sheet Designer
ComfyUI Extension

H3 Character Sheet Designer

MiniMax H3 character-sheet prompt and layout designer for ComfyUI with selectable multi-view panels, deterministic Ref2VA prompts, automatic output sizing, and a local graphical UI.

By ukr8b3g-cmyk·Created 5 days ago·Updated 3 days ago· 2
ukr8b3g-cmyk/H3-Character-Sheet-Designer
Nodes—
On cloudLocal install
Stars2
Updated3 days ago
Readme

H3 Character Sheet Designer

Recommended: H3 Character Sheet Designer Reference with Use Layout Image = OFF. OFF uses the character reference and an optimized prompt based on the original Designer, preserving its layout geometry. The layout output becomes None, so H3 automatically skips it while both image wires stay connected. ON supplies the framed mannequin sheet when closer layout matching is needed; it can also pull the result toward the mannequin's body proportions or leave mannequin parts. The original three-output node remains available.

推奨はReferenceノードの Use Layout Image = OFF です。 人物参照と旧版を基本に 最適化したプロンプトで生成します。ONは黒枠付き配置図を参照し、配置を強く指定したい 場合に使います。マネキンの体型・比率に引っ張られたり、一部が残る場合があります。 接続・画風・検証済み範囲をご覧ください。

Create character sheets using MiniMax H3's built-in reference-image conditioning and prompt understanding. No character-sheet LoRA or extra custom generation-node pack is required. This Designer is the only custom node in the bundled workflow; the remaining generation nodes are ComfyUI Core. You still need a compatible ComfyUI build and the usual H3 diffusion model, text encoder, and video VAE.

The setup is simple: load the template, choose your reference image and models, select the views you want, and generate. To generate a single view, leave only that view selected in the Designer and queue it manually.

Official template / 公式テンプレート

Download the workflow JSON / ワークフローJSONをダウンロード · View in repository / リポジトリで開く

Load this GUI workflow in ComfyUI, then choose your reference image and installed models. See template setup below.

このJSONをComfyUIへ読み込み、参照画像とお使いのモデルを選択してください。導入手順は下の公式テンプレートの使い方をご覧ください。

<img width="1191" height="803" alt="{E6449818-9833-48BF-ABB4-78E75C593EED}" src="https://github.com/user-attachments/assets/c56b09f1-f5bc-41da-84cc-18da76556691" /> <img width="2816" height="1280" alt="comfy_minimax_h3_fl2va_pruned_int8_convrot_20261004191840_00001_" src="https://github.com/user-attachments/assets/2265b1fd-3fc8-4331-b0db-5003621bf0b5" />

A standalone ComfyUI custom node for designing a multi-view character sheet and compiling a MiniMax H3 reference prompt plus output dimensions. The template is English; free-form part instructions are preserved in their original language.

  • Seven illustrated view selectors: front portrait, anatomical-left portrait, full-body front, anatomical-left body profile, full-body back, hands, and footwear
  • Five presets including the standard five-view sheet, automatic layout sizing, editable manual dimensions, and a large live layout preview
  • Layout / Part prompts / Style tabs on the Reference node; eight body-part choices and nine optional styles, with the selected style visible outside its tab
  • Reference node: 870 × 1100, matching the template; original node: 870 × 930
  • Reference default: five views, 2816 × 1280, layout reference OFF and style None; the original node retains its four-view default
  • Deterministic local Python compiler, with no LLM, external API, additional model, or Python package dependency for the designer itself
  • Versioned state_json; Reference outputs prompt / width / height / layout_image, with layout_image=None when OFF; original node retains three outputs
  • Japanese interface when ComfyUI's language is Japanese; English for other languages

The bundled low-poly, bald, gender-neutral GPT Image mannequin artwork is displayed locally in the interface, with a simple SVG fallback only if the bitmap cannot load. With Use Layout Image OFF, these mannequins are interface illustrations only. ON sends a rendered mannequin sheet as the second H3 reference. Coordinates in the prompt are semantic guidance, not hard image constraints. Identity, anatomy, unseen surfaces, clothing fidelity, exact geometry, and high-resolution generation quality are not guaranteed.

Installation

Clone this repository into your ComfyUI custom_nodes directory:

cd ComfyUI/custom_nodes
git clone https://github.com/ukr8b3g-cmyk/H3-Character-Sheet-Designer.git

Restart ComfyUI and refresh its browser page. Add H3 Character Sheet Designer Reference from the node menu, or load the official template. No pip install is required. Keep this repository as a custom-node folder; this is not a standalone image generator.

Official template setup

The official GUI workflow is the maintainer-provided character-sheet template, preserved as supplied. Download the JSON using the link above, then drag it onto the ComfyUI canvas or open it with ComfyUI's workflow loader. It is a GUI workflow, not API-format JSON.

  1. Install this custom node as described above. The file records ComfyUI Core 0.38.0 / frontend 1.53.10 as its saved baseline; use a build with native MiniMaxH3ReferenceToVideo, SaveImageAdvanced, and subgraph support. If a node is missing, update ComfyUI and its frontend.
  2. In Load Image, select your own character reference. The saved krea2_00327_.webp filename is a placeholder; the image is not bundled.
  3. Open the H3 subgraph and select the H3 diffusion model, text encoder, and video VAE installed in your models/diffusion_models, models/text_encoders, and models/vae folders. The saved subgraph uses Dasiwa Hybrid V2 INT8, Qwen3-VL 32B NVFP4/AWQ, an INT8/ConvRot VAE, and Euler / simple / 20 steps. These are template choices, not a universal optimum. The Model Links note lists model files. Reselect the loaders for your filenames and platform; the saved diffusion-model name includes a Windows-style minimax\ subfolder.
  4. Keep Use Layout Image OFF to prioritize the character reference; style defaults to None. Choose views and sizes in the Designer, then queue. The saved five-view Auto selection (front/left portraits and front/left/back full-body views) compiles to 2816 × 1280 with the current compiler. Hands and footwear detail panels are unselected in this template. Connected Designer outputs supply the prompt and dimensions; stored downstream widget values are not a fixed output-size setting. The graph uses 5 frames, selects the first decoded frame, and saves a PNG through SaveImageAdvanced.

The saved connections and state are checked by local tests. The current Reference OFF node has run on native H3 after restart; actual prompts and reference bypass were verified. Controlled GPU comparisons retained five views, but later-frame darkening and narrow foot margins remain. The template saves frame 0. See the test scope and limits; large sheets can require substantial VRAM and time.

公式テンプレートの使い方

上のリンクからJSONをダウンロードし、ComfyUIのキャンバスへドラッグ＆ドロップするか、ワークフロー読み込み機能で開いてください。添付されたシート用ワークフローをそのまま収録しています（API形式ではありません）。

  1. このカスタムノードを導入してください。保存時の基準は ComfyUI Core 0.38.0／frontend 1.53.10 です。ネイティブの MiniMaxH3ReferenceToVideo、SaveImageAdvanced とサブグラフに対応する環境が必要です。ノードが見つからない場合はComfyUI本体とfrontendを更新してください。
  2. Load Image でご自身の参照画像を選択してください。保存済みの krea2_00327_.webp は仮のファイル名で、画像は同梱していません。
  3. H3サブグラフを開き、導入済みの拡散モデル・テキストエンコーダー・動画用VAEを各ローダーで選び直してください。配置先はそれぞれ models/diffusion_models、models/text_encoders、models/vae です。保存済み設定はDasiwa Hybrid V2 INT8、Qwen3-VL 32B NVFP4/AWQ、INT8/ConvRot VAE、Euler／simple／20 stepsです。共通の最適設定を保証するものではありません。ワークフロー内の Model Links に候補があります。保存済みの拡散モデル名にはWindows形式の minimax\ サブフォルダーが含まれています。
  4. 人物参照を優先する通常用途では Use Layout ImageをOFF、画風は 指定なしから始めます。Designerでビューとサイズを選んで実行します。保存済みの5面（正面・左横顔、全身の正面・左側面・背面）のAuto設定は現行コンパイラーで 2816×1280 です。このテンプレートでは手と足・履物の拡大ビューは未選択です。プロンプトと寸法はDesignerの接続から渡されます。下流ウィジェットに保存された数値で固定されるわけではありません。5フレーム生成し、デコード後の先頭フレームを SaveImageAdvanced でPNG保存します。

保存状態と接続をローカル試験で確認しています。再起動後の実Reference OFFノードで、実行プロンプトと配置参照のバイパスも確認済みです。GPU比較では5ビューを維持しましたが、後半フレームの暗化と足元の余白は未解決です。このテンプレートは先頭フレームを保存します。検証範囲と制約をご確認ください。

Connect to native H3

Connect the Designer's prompt, width, and height outputs to the matching inputs on ComfyUI's native MiniMaxH3ReferenceToVideo node. Use Convert widget to input on the receiving node where necessary. Provide one character reference image separately, through Load Image, as the native node's first image reference (<Picture 1>). Use a compatible H3 Ref2VA model and your normal H3 model loading, sampling, decoding, and saving workflow.

Suggested experimental downstream settings are length=5 frames, not five seconds, and ref_image_size=match. The Designer does not modify those settings. To save a still, choose a decoded frame downstream. Even at five frames, H3 uses its audiovisual model generation path; this is not a promise of ordinary still-model memory or speed.

Using the designer

  1. Select views or a preset. Every view click immediately commits the saved node input, even while the preview is loading
  2. In Auto mode choose the requested full-body panel height directly from its full-width dropdown. Choose Custom… for any other 32-pixel-grid height; press Enter or leave the custom field to commit. Escape discards an unfinished edit. Dimensions are calculated in Python and rounded upward to a 32-pixel grid
  3. To edit width and height, switch to Manual once the current preview has returned. The current Auto dimensions are copied first. Presets preserve Manual dimensions
  4. Press Enter or leave a number field to commit a valid edit. Uncommitted drafts are not saved or queued
  5. Optionally open Part prompts, select a body part, and enter a free-form instruction. It saves as you type; Enter adds a line. Switch parts to keep separate instructions. The dot and count show which parts have saved instructions. Clear a field to remove that instruction
  6. Queue your normal H3 workflow. Preview networking is optional for execution: the node independently validates and compiles the current saved JSON

The Reference node starts with the standard five views. The original node's default Basic preset stays at the original four views and 2208 × 1280. The optional Left portrait is a head-to-chest anatomical-left profile. Detail now selects all seven views and produces 2816 × 1280 at the default panel height (1696 × 768 at 672). Existing saved six-view selections retain their geometry and display as Custom; they are never automatically expanded.

The final view cannot be deselected. Either portrait alone, both portraits, hands-only, feet-only, left-body-profile-only, and hands-plus-feet layouts are supported. A missing or invalid saved value remains visible as an error; it is never silently reset. A failed preview can be retried without losing the committed selection.

Experimental appears above 1,032,192 pixels. This is a warning, not an artificial H3 size cap. ComfyUI's runtime axis limit is still enforced. Large outputs may require substantial VRAM and time.

Part prompts

<img width="1325" height="646" alt="{A223588C-EEB3-453F-8654-B27084426E4D}" src="https://github.com/user-attachments/assets/519bd600-f0cd-408c-8d30-8181a83d8b0a" />

The eight parts are Head / hair, Face, Upper-body clothing, Back of clothing, Lower body, Hands / gloves, Feet / footwear, and Overall / other. The part dropdown is separate from the seven view selectors. There are no clothing presets, change modes, lettering switches, or separate text fields: describe shape, color, patterns, text, and placement in the same prompt.

Short English examples

English is recommended for part prompts, based on the reported successful result. Start with a short instruction in the matching part field. If an attribute is ignored, add only the missing detail and try again. These are copy-ready examples, not inserted defaults or guaranteed results.

| Part field | Example | | --- | --- | | Upper-body clothing | Change the jacket to silver-gray. Keep its design and material. | | Hands / gloves | Bare hands with natural skin and short nails in every view. | | Feet / footwear | Black high-heeled pumps, consistent in every view. | | Lower body (upper-body-only reference) | Complete the unseen lower body with black tailored trousers. | | Back of clothing (matching the jacket) | Keep the jacket silver-gray on the back as well. | | Back of clothing (optional pattern) | Add a floral pattern only to the back of the jacket. |

Use the back examples separately or combine them only if both changes are wanted. For an upper-body-only reference, specify missing lower clothing and footwear in their respective fields. This supplies a design for unseen areas; it cannot recover details absent from the image.

If the short prompt is not enough, try a more specific version:

  • Upper-body clothing: Change only the jacket color to silver-gray. Keep its shape, material, seams, and fasteners unchanged in every view.
  • Hands / gloves: Show bare hands with natural skin and short nails in every view. No gloves, hand coverings, or glove-like cuffs.

Add detail when needed rather than starting with a long list of constraints. Check every generated view: color, clothing, hands, footwear, and rear patterns may still be ignored or vary between views. There is no measured success rate for these examples or controlled English-versus-Japanese comparison.

The compiled prompt gives explicit instructions precedence for the named part and asks to preserve unspecified reference details. Hands / gloves and Feet / footwear instructions still apply in selected full-body views when the separate Hands and Footwear detail panels are off. Back-of-clothing instructions apply only to the rear garment surface in back/side views, never the front or portraits. A specific part wins over Overall / other; Back of clothing wins over Upper-body clothing on the rear surface. Instructions stay saved when views, presets, sizes, or tabs change; an instruction with no related selected view is kept but does not affect that prompt.

This is a deterministic local compiler, not image analysis or an LLM translator. Input is passed through verbatim, with no automatic translation. Japanese is accepted and retained, as are literal quotes, braces, backslashes, and requested lettering. It does not detect what is visible in the reference or interpret quoted text into a separate field. The mannequin preview shows layout only; it does not visualize the requested appearance. Broad model adherence, exact lettering, and GPU quality have not been systematically evaluated.

When to add Hands and Footwear detail panels

Usually start with the portrait/full-body views you need and leave Hands and Footwear off, as in the official five-view template. Add either panel when you need a separate close-up. These panels can be useful when specifying hand or shoe details missing from an upper-body-only reference; describe the intended design in the corresponding part field.

The Hands selector adds a hand-detail panel; it does not ask the character to wear gloves. Unwanted gloves have been reported, even with a kimono reference. This is a user observation, not a measured failure rate. Use a bare-hands instruction when needed and inspect both the full-body and detail views. Leaving detail panels off is a practical starting point, not a guarantee of better results.

Footwear detail behavior

Footwear selects a separate enlarged detail panel; shoes already visible in a full-body panel do not replace it. Without a relevant part instruction, the prompt preserves the reference's footwear, visible boot shafts, open-toed footwear, or bare feet as applicable. It cannot recover a shoe design absent from the reference. A Feet / footwear instruction can explicitly supply or change that design. The UI mannequin is only an illustration, not evidence of the generated result.

Local regression tests confirm selection reaches the saved input, layout, prompt and Designer output. The stronger detail instructions have not been evaluated on a GPU, so improved model compliance is not yet established. If a generated result omits the panel, retain the current workflow/API input, actual reference image and output for diagnosis.

API and reproducibility

The only input is state_json:

{"schema_version":1,"views":["face_front","body_front","body_left","body_back"],"size":{"mode":"auto","body_height":1120,"manual_width":2240,"manual_height":1280}}

Existing version-1 data remains supported without automatic rewriting. The first nonempty part edit explicitly upgrades the saved state to version 2, adding a required part_prompts object. For example:

{"schema_version":2,"views":["face_front","body_front","body_left","body_back"],"size":{"mode":"auto","body_height":1120,"manual_width":2240,"manual_height":1280},"part_prompts":{"lower_body":"黒いロングパンツ","footwear":"黒いブーツ","back_clothing":"背中に花柄とFLOWERの文字"}}

Allowed part IDs, in canonical order: head_hair, face, upper_clothing, back_clothing, lower_body, hands, footwear, other. Keys are optional inside the required object. Values must be strings, at most 1000 UTF-16 code units per part (matching the browser counter); whitespace-only values normalize away, while nonblank text is not trimmed. State JSON is limited to 64 KiB; the bounded preview HTTP envelope allows 192 KiB for escaping. Empty version-2 instructions generate the same prompt and geometry as version 1. Unknown versions are retained as visible errors, never silently downgraded or reset.

The compiler rejects missing or unknown keys, duplicate JSON keys, unknown versions/views, empty selections, non-integer dimensions, non-32-grid values, oversize inputs, and values above ComfyUI's runtime maximum. View duplicates are normalized into a fixed order. Equivalent states generate identical prompt bytes regardless of UI language or JSON formatting. Prompt text is not subject to dynamic prompt expansion.

The GUI uses same-server POST /h3_character_sheet_designer/preview with {"state_json":"..."}. This read-only endpoint performs no file writes, model execution, or external requests. Its response is advisory and never overwrites saved state. API/headless workflows do not call it.

Tests and verification

# Development-only dependencies; not needed to use the custom node
python -m pip install -r requirements-dev.txt
npm install --ignore-scripts
python -m unittest discover -s tests -p 'test_*.py' -v
npm test

Node.js is needed only for developer tests, not installation or normal use. Without the optional development dependencies, standard-library Python and dependency-free JavaScript tests still run; HTTP/DOM tests explicitly report skips. npm run test:js runs the dependency-free frontend suite. To inspect the actual DOM renderer in a standalone browser harness:

python tests/serve_demo.py
# Open http://127.0.0.1:8765/tests/browser/

The harness uses the production compiler and UI renderer with a simulated ComfyUI boundary. It does not demonstrate ComfyUI installation, real frontend Undo/Redo, downstream queue acceptance, or GPU generation. See verification details for tested and untested stages. Legacy frontends, Nodes 2.0, and unspecified ComfyUI versions are not claimed compatible. On unsupported DOM-widget environments, the node retains a standard STRING input and headless compilation.

日本語

ComfyUI用の独立ノードです。7種類のビュー、5つのプリセット、Auto／Manual寸法をGUIで選び、ネイティブH3へ渡すプロンプトと幅・高さを作ります。固定テンプレートは英文、部位の自由入力は日本語も原文のまま保持します。ComfyUIの言語設定が日本語の場合だけ日本語UIになります。

custom_nodes にcloneしてComfyUIを再起動してください。Designerの3出力を MiniMaxH3ReferenceToVideo に接続し、参照画像は別のLoad Imageから最初の画像参照へ渡します。H3モデルと通常の生成ワークフローは別途必要です。

既定の基本4面は2208×1280のままです。新しい「横顔・左」は人物の解剖学的左側から見た顔～胸のポートレイトです。7面・ディテールは2816×1280になります。保存済みの6面は配置を維持し、カスタムとして表示されます。基本4面の基準高を672にすると1344×768になります（7面は1696×768）。旧版ノードとReferenceのOFFでは画面のマネキンは操作用です。ReferenceのONでは黒枠付き配置画像をH3の2枚目の参照へ送ります。5フレーム設定も通常のH3 AV生成経路なので、軽量な静止画生成と同じ負荷ではありません。

「足・履物」は全身内の靴とは別の拡大枠を要求します。関連する部位指定がない場合は、参照の靴・見えているブーツの筒・素足を保持し、見えない靴の意匠は発明しない指示です。選択が出力プロンプトへ届くことはローカル試験済みですが、GPUで効きが改善したかは未検証です。

下部の「レイアウト｜部位指定」（Reference版は「画風」も追加）を切り替え、部位ドロップダウンと自由入力1欄で指示を保存できます。頭・髪、顔、上半身の服、背面の服、下半身、手・手袋、足・履物、全体・その他の8部位です。柄・文字・位置も同じ欄に書きます。部位ごとに保持され、関連する選択ビューへ共通反映します。手・足の拡大ビューが未選択でも、手・手袋と足・履物の指示は全身図のプロンプトへ届きます。 背面の柄は背面のみに指定されますが、生成結果での再現を保証するものではありません。未入力の旧ワークフローと配置は維持します。プレビューは配置確認用で、指定した服や柄には変わりません。

短い英語プロンプトから始める

英語で反映できた報告を踏まえ、部位指定は短い英語での入力をおすすめします。日本語も入力できますが、自動翻訳はせず原文のまま渡します。まず必要な変更だけを短く書き、反映されなかった属性があれば具体的な説明を追加してください。

| 入力する部位 | そのまま使える英語の例 | | --- | --- | | 上半身の服 | Change the jacket to silver-gray. Keep its design and material. | | 手・手袋 | Bare hands with natural skin and short nails in every view. | | 足・履物 | Black high-heeled pumps, consistent in every view. | | 下半身（上半身だけの参照） | Complete the unseen lower body with black tailored trousers. | | 背面の服（色をそろえる） | Keep the jacket silver-gray on the back as well. | | 背面の服（柄を追加する場合） | Add a floral pattern only to the back of the jacket. |

背面の2例は目的に合わせて選び、両方必要な場合だけ組み合わせます。上半身しか写っていない参照では、下半身と履物をそれぞれの欄で指定できます。見えない部分のデザインを補う指示であり、元画像にない情報を復元する機能ではありません。

短い指定で足りない場合は、上の詳しい指定例のように形・素材・縫い目を維持する条件や、手袋・手の覆いを付けない条件を追加してください。長い指示が常に優れるわけではありません。変更が反映されない場合やビュー間で色・服・手・靴・背面の柄がそろわない場合もあるため、各ビューを確認してください。成功率や英語と日本語の比較は測定していません。

手・足の拡大ビューを追加する目安

通常は公式5面テンプレートと同様に、必要な顔・全身ビューを選び、「両手」と「足・履物」の拡大ビューはオフから試すのがおすすめです。細部の独立した拡大図が必要になったら追加してください。上半身だけの参照から手や靴の細部を指定したい場合にも役立ちます。対応する部位欄に、描いてほしいデザインを書いてください。

「両手」の選択は拡大枠の追加であり、手袋を着ける指定ではありません。ただし、着物の参照でも意図しない手袋が出たという利用者の報告があります。発生率を測った結果ではありません。必要に応じて素手を明記し、全身図と拡大図の両方を確認してください。拡大ビューをオフにすれば必ず改善する、という意味ではありません。

詳細な入力契約と配置ルールは日本語仕様書、検証済み範囲と未検証事項は検証記録をご覧ください。