ComfyUI-BodyRatioMapper

中文 | English

A project for pose alignment and human body proportion mapping based on SDPose.

Introduction

The core goal of ComfyUI-BodyRatioMapper is to match the "target motion" to the "reference body shape," then align and rescale the target pose relative to the reference. This project is also the first of its kind to support multi-person scenarios.

Typical use cases:

• Preprocessing for human motion transfer in images or videos
• Generating keypoint sequences with consistent body proportions

Features

• Pose Alignment
• Body Ratio Mapping
• Multi-person support with identity-based tracking (nearest-neighbor + sliding-window voting)
• Built-in keypoint rendering nodes for visual inspection
• Per-bone FK chain scaling (SDPose Bone Scale node)
• Global keypoint translation (SDPose Translate node)
• Match-original-ear-scale mode for consistent ear width output

Results

Single-Image Examples

• Workflow example:

• Comparison result:

Video Examples

Single-person comparison:

video_001.mp4

video_002.mp4

Multi-person comparison:

video_003.mp4

Comparison Summary

Tests show that aligning body skeletons to a reference significantly improves character consistency in motion transfer.
Compared with similar methods (such as One To All animation and ProportionChanger), this project performs better.
All tests were run with SteadyDancer under identical settings, including random seed.

Installation

Clone this repository into ComfyUI's custom_nodes directory and install dependencies:

cd ComfyUI/custom_nodes
git clone https://github.com/wuwukaka/ComfyUI-BodyRatioMapper.git
cd ComfyUI-BodyRatioMapper
pip install -r requirements.txt

Restart ComfyUI after installation.

Quick Start

1. Launch ComfyUI and make sure this plugin is loaded.
2. Example workflows require ComfyUI 0.16.1 or newer.
3. Import the example workflows: example_workflows/bodyratiomapper_officail_sdpose_image.json example_workflows/bodyratiomapper_officail_sdpose_video.json

Node Description

1. BodyRatioMapper Proportion Transfer

• Node name: BodyRatioMapperProportionTransfer
• Purpose: Performs pose alignment and body proportion mapping, then outputs transformed keypoints and anchor keypoints.
• Main inputs: pose_keypoint ref_pose_keypoint manual_anchor_pose manual_first_frame
• Common parameters: enable_rpca, hand_scaling, foot_scaling, offset_stabilizer_y, offset_stabilizer_x, best_hand_search, best_neck_search, final_offset_alignment, base_offset_mode, head_fixed_mode, match_original_ear_scale, confidence_threshold, output_absolute_coordinates
• Outputs: changed_pose_keypoint, anchor_pose_keypoint, first_frame_output

2. BodyRatioMapper SDPose Bone Scale

• Node name: BodyRatioMapperSDPoseBoneScale
• Purpose: Per-bone FK chain scaling on SDPose keypoints. All scales default to 1.0 (no change).
• Parameters: person_idx (-1 = all persons), scale_head_x, scale_head_y, scale_neck, scale_shoulder_width, scale_upper_arm, scale_lower_arm, scale_torso, scale_hip_width, scale_upper_leg, scale_lower_leg, scale_foot
• Output: POSE_KEYPOINT

3. BodyRatioMapper SDPose Translate

• Node name: BodyRatioMapperSDPoseTranslate
• Purpose: Apply a global XY offset to all keypoints of an SDPose person.
• Parameters: person_idx (-1 = all persons), translate_x, translate_y
• Output: POSE_KEYPOINT

4. BodyRatioMapper SDPose Render

• Node name: BodyRatioMapperSDPoseRender
• Purpose: Renders keypoints as a skeleton image.
• Common parameters: resolution_x, score_threshold, stick_width, face_point_size, draw_face, draw_hands, draw_feet
• Output: IMAGE

5. pose_keypoint input

• Node name: PoseJSONToPoseKeypoint
• Purpose: Converts a JSON string into POSE_KEYPOINT, useful for manual debugging or external keypoint input.

6. pose_keypoint preview

• Node name: PoseKeypointPreview
• Purpose: Converts POSE_KEYPOINT into JSON text and displays it in-node for copying, inspection, and round-tripping.

Project Structure

ComfyUI-BodyRatioMapper/
├─ body_ratio_mapper/
│  ├─ core_modules/
│  │  ├─ multi_person_tracker.py
│  │  ├─ frame_ops.py
│  │  ├─ global_rpca.py
│  │  ├─ scale_solver.py
│  │  ├─ wscs_anchor.py
│  │  └─ matrix_ops.py
│  ├─ proportion_transfer_node.py
│  ├─ render_nodes.py
│  └─ bone_scale_node.py
├─ web/js/poseKeypointPreview.js
├─ example_workflows/
├─ docs/
├─ nodes.py
├─ requirements.txt
├─ pyproject.toml
└─ __init__.py

FAQ

1. Nodes do not appear after installation

• Confirm the repository path is ComfyUI/custom_nodes/ComfyUI-BodyRatioMapper
• Check whether dependencies were installed successfully
• Restart ComfyUI and check startup logs for errors

2. Keypoints are empty or look abnormal

• Verify the input is valid POSE_KEYPOINT
• Lower confidence_threshold if needed
• Use pose_keypoint preview to inspect whether the keypoint JSON is complete

Acknowledgements

• Some code is derived from grmchn/ComfyUI-ProportionChanger (pose_keypoint input and pose_keypoint preview): https://github.com/grmchn/ComfyUI-ProportionChanger
• Special thanks to my friends 望星铭 (https://space.bilibili.com/13066617) and 阿临 (https://space.bilibili.com/20848068) for providing OC test assets.

Contact

• Bilibili: @wuwukasi
• Email: wuwukawayi@gmail.com

Sponsor

If you find this project useful, consider buying me a coffee! Your support is my greatest motivation. Every bit of encouragement keeps this project going. Thank you for being part of the journey!

    

License

Since part of the code is derived from the GPL v3.0 project ComfyUI-ProportionChanger, this project is also released under GPL v3.0.

When redistributing, publishing, or modifying this project's code, you must preserve the copyright notices and follow the attribution and modification-marking requirements in NOTICE.