Object Posemode Toggle

Blender won't let you pose a rigged character unless it's in pose mode, and Object Posemode Toggle is your one-input, one-output switch for that. It wraps bpy.ops.object.posemode_toggle, which flips the active object between object mode and pose mode. In the Avatar Graph world - where every character is a static image being turned into a real-time interactive avatar - that matters the moment you add an armature and want to bend a bone.

How it fits the pipeline

The pack's whole point is building a riggable avatar from image layers: mesh layers get created from segmented parts, joined, and driven by shape keys for blink and lipsync. Pose mode is the mode you need when you're working with the armature itself - rotating an arm or tilting a head through bones - rather than shape keys. In a plain blink-and-mouth avatar you can skip it; once you start posing a skeleton, it's the gate you have to walk through.

Inputs and outputs

There's exactly one input, BPY_OBJ - the object to toggle (an armature, usually). The single output is BPY_OBJ again, the same object, so it slots into any chain without changing the data type. There's no "state" param; the operator just flips whatever mode the object is currently in, which is exactly what the toggle in the name says.

That toggle behavior is the one thing that'll bite you if you're not thinking about it: the node doesn't say "set to pose mode," it says "swap modes." Feed it an object that's already in pose mode and it'll kick you back to object mode. In practice you place it right before your pose/transform nodes and trust the ordering.

Installing it

Part of the Avatar Graph pack. In ComfyUI Manager, search "Avatar Graph" → install → restart, or:

cd ComfyUI/custom_nodes
git clone https://github.com/avatechai/avatar-graph-comfyui
cd avatar-graph-comfyui
python -m pip install -r requirements.txt

Remember the caveats that apply to every node in this pack: bpy==3.6.0 needs Python 3.10, first launch auto-downloads the SAM and mediapipe models, and the headless Blender scene resets between runs - so pose mode never "sticks" across queue runs. You toggle it fresh every time you execute the graph. Annoying, but consistent, and it's why every Avatar Graph template rebuilds the whole character in a single pass.