> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-feat-openapi-i18n.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# SDPose: Pose Detection in ComfyUI

> Learn how to extract pose keypoints and maps from images and videos using SDPose, natively supported in ComfyUI

<Tip>
  <Tabs>
    <Tab title="Portable or self deployed users">
      Make sure your ComfyUI is updated.

      * [Download ComfyUI](https://www.comfy.org/download)
      * [Update Guide](/installation/update_comfyui)

      Workflows in this guide can be found in the [Workflow Templates](/interface/features/template).
      If you can't find them in the template, your ComfyUI may be outdated. (Desktop version's update will delay sometime)

      If nodes are missing when loading a workflow, possible reasons:

      1. You are not using the latest ComfyUI version (Nightly version)
      2. Some nodes failed to import at startup
    </Tab>

    <Tab title="Desktop or Cloud users">
      * The Desktop is base on ComfyUI stable release, it will auto-update when there is a new Desktop stable release available.
      * [Cloud](https://cloud.comfy.org) will update after ComfyUI stable release.

      So, if you find any core node missing in this document, it might be because the new core nodes have not yet been released in the latest stable version. Please wait for the next stable release.
    </Tab>
  </Tabs>
</Tip>

SDPose is a whole-body pose detection model that extracts human keypoints from images and videos. Combined with the RT-DETRv4 object detector, it supports multi-person detection and out-of-domain (OOD) pose estimation, making it a versatile tool for animation pipelines, pose-driven generation, and motion tracking workflows.

SDPose + RT-DETRv4 are natively supported in ComfyUI (PR [#12748](https://github.com/Comfy-Org/ComfyUI/pull/12748)). The model weights are available on Hugging Face.

[SDPose Model on Hugging Face](https://huggingface.co/Comfy-Org/SDPose) | [RT-DETRv4 Paper (arXiv)](https://arxiv.org/abs/2504.05731) | [SDPose Paper (arXiv)](https://arxiv.org/abs/2503.07740)

### Key strengths

* **Whole-body keypoints** — detects body, hands, face, and feet keypoints in a unified model
* **Multi-person support** — detects and labels multiple people in a single image or video
* **Configurable outputs** — choose which body parts to visualize (body, hands, face, feet) and control stick/font size
* **Bounding box detection** — includes object detection with tunable thresholds and class selection
* **Image and video support** — dedicated workflows for single images, videos, and OOD pose estimation

> **Limitations:** Detection accuracy depends on image resolution and subject visibility. Extremely occluded or very small subjects may produce fewer keypoints.

## SDPose Workflows

Four workflows are available depending on your use case:

| Workflow              | Input        | Output                      | Use Case                       |
| --------------------- | ------------ | --------------------------- | ------------------------------ |
| Multi-Person (Image)  | Single image | Pose map + BBoxes           | Photos with multiple people    |
| Multi-Person (Video)  | Video        | Per-frame pose map + BBoxes | Video pose tracking            |
| OOD Image to Pose     | Single image | Pose map                    | Style transfer / image-to-pose |
| OOD Video to Pose Map | Video        | Per-frame pose map          | Video-to-pose animation        |

### 1. Download Workflows

Update your ComfyUI to the latest version, then go to `Workflow` -> `Browse Templates` and find SDPose workflows under the Utility category.

<CardGroup cols={2}>
  <Card title="Multi-Person (Image)" icon="image" href="https://cloud.comfy.org/?template=utility_sdpose_multi_person&utm_source=docs&utm_medium=referral&utm_campaign=sdpose">
    Run in Comfy Cloud
  </Card>

  <Card title="Download Image Workflow" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/utility_sdpose_multi_person.json">
    Download JSON
  </Card>
</CardGroup>

<CardGroup cols={2}>
  <Card title="Multi-Person (Video)" icon="video" href="https://cloud.comfy.org/?template=utility_sdpose_multi_person_video&utm_source=docs&utm_medium=referral&utm_campaign=sdpose">
    Run in Comfy Cloud
  </Card>

  <Card title="Download Video Workflow" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/utility_sdpose_multi_person_video.json">
    Download JSON
  </Card>
</CardGroup>

<CardGroup cols={2}>
  <Card title="OOD Image to Pose" icon="image" href="https://cloud.comfy.org/?template=utility_sdpose_ood_image_to_pose&utm_source=docs&utm_medium=referral&utm_campaign=sdpose">
    Run in Comfy Cloud
  </Card>

  <Card title="Download OOD Image Workflow" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/utility_sdpose_ood_image_to_pose.json">
    Download JSON
  </Card>
</CardGroup>

<CardGroup cols={2}>
  <Card title="OOD Video to Pose Map" icon="video" href="https://cloud.comfy.org/?template=utility_sdpose_ood_video_to_pose_map&utm_source=docs&utm_medium=referral&utm_campaign=sdpose">
    Run in Comfy Cloud
  </Card>

  <Card title="Download OOD Video Workflow" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/utility_sdpose_ood_video_to_pose_map.json">
    Download JSON
  </Card>
</CardGroup>

### 2. Download Models

The SDPose and RT-DETRv4 model checkpoints are hosted on the [Comfy-Org SDPose model repository](https://huggingface.co/Comfy-Org/SDPose).

**checkpoints** (SDPose model):

* [sdpose\_wholebody\_fp16.safetensors](https://huggingface.co/Comfy-Org/SDPose/resolve/main/checkpoints/sdpose_wholebody_fp16.safetensors)

**diffusion\_models** (RT-DETRv4 detector):

* [rt\_detr\_v4-x-hgnet\_fp16.safetensors](https://huggingface.co/Comfy-Org/SDPose/resolve/main/diffusion_models/rt_detr_v4-x-hgnet_fp16.safetensors) (recommended)
* [rt\_detr\_v4-x-hgnet\_fp32.safetensors](https://huggingface.co/Comfy-Org/SDPose/resolve/main/diffusion_models/rt_detr_v4-x-hgnet_fp32.safetensors) (full precision, larger)

Place them in the following directory structure:

```
📂 ComfyUI/
└── 📂 models/
    ├── 📂 checkpoints/
    │   └── sdpose_wholebody_fp16.safetensors
    └── 📂 diffusion_models/
        ├── rt_detr_v4-x-hgnet_fp16.safetensors
        └── rt_detr_v4-x-hgnet_fp32.safetensors
```

### 3. Using the Workflows

#### Multi-Person (Image)

* **Input** — Load an image via the `Load Image` node. Use an image with one or more people (example: `group_photo.png`).
* **Detection** — The `Image to Pose Map (SDPose Multi-Person)` subgraph processes the image and outputs:
  * **IMAGE** — pose skeleton visualization overlaid on the image
  * **keypoints** — raw whole-body keypoint data
  * **bboxes** — bounding box coordinates
* **Drawing Options** — Configure which body parts to draw:
  * `draw_body`, `draw_hands`, `draw_face`, `draw_feet` — toggle visibility
  * `stick_width`, `face_point_size` — adjust visual style
  * `score_threshold` — minimum confidence for displaying keypoints
* **Detection Options**:
  * `resize_type.longer_size` — scale the longer dimension before detection
  * `max_detections` — maximum number of people to detect
  * `detect_threshold` — detection confidence threshold
  * `detect_class` — object class to detect (default: person)

#### Multi-Person (Video)

Same as the image workflow but processes video frames sequentially. Use `Load Video` to input a video file and `Save Video` to export the result.

#### OOD Image to Pose

Uses the SDPose model to generate a clean pose map from an image, without bounding box visualization. This is useful for style transfer where you want to extract the skeleton pose from one image and apply it to another.

#### OOD Video to Pose Map

Generates per-frame pose maps from a video. The output is a video file where each frame contains the extracted pose skeleton, suitable for downstream animation or ControlNet workflows.

<Card title="Learn about Subgraph" icon="book-open" href="/interface/features/subgraph">
  These workflows use Subgraph nodes for modular processing. Check out the Subgraph documentation to learn how to customize and extend the workflows.
</Card>

## Additional Notes

* **Model directory** — the SDPose checkpoint goes in `models/checkpoints/`, and the RT-DETRv4 detector goes in `models/diffusion_models/`
* **Input image example** — the `group_photo.png` file is available in the workflow template's `input/` directory for testing
* **Keypoint output** — the POSE\_KEYPOINT type can be connected to downstream nodes that accept pose data for conditional generation
* **Update required** — SDPose + RT-DETRv4 support is available in recent ComfyUI versions. Make sure your ComfyUI is up to date.