Object Select Grouped

Object Select Grouped is how you grab a whole family of objects at once. It wraps bpy.ops.object.select_grouped, Blender's "select grouped" operator, which expands the selection outward from the active object along whatever relationship you pick - parenting, siblings, same collection, same type, and more. In an avatar graph where the head, hair, ears, and accessories are separate objects that belong together, this is the "grab the whole head" move.

The input that matters

Beyond BPY_OBJ and extend (add to selection vs. replace), the type dropdown is the whole node. The options:

• CHILDREN / CHILDREN_RECURSIVE - select the active object's children (recursive digs through the whole hierarchy). This is the workhorse: parent your avatar parts to a root, then grab everything.
• PARENT, SIBLINGS - climb or sidestep the hierarchy.
• COLLECTION - everything in the same collection as the active object.
• TYPE - everything of the same object type.
• HOOK, PASS, COLOR, KEYINGSET, LIGHT_TYPE - the deeper Blender relationship options, which you'll rarely touch in avatar work.

Output is a single BPY_OBJ, the active object. The selection change is the point; the wire is how it stays in your chain.

Why it's worth knowing

Most Blender ops act on the selection, and this pack leans on that hard - Join Meshes, bulk transforms, and shading ops all consume the current selection. Group selection is the clean way to say "everything that belongs to this character" instead of hand-wiring a chain of Select By Type + Select More. And because the headless scene resets between runs, that grouping step has to happen inside every execution, right before the op that consumes it.

One real-world gotcha: CHILDREN vs CHILDREN_RECURSIVE. If you parented parts into a nested hierarchy and pick plain CHILDREN, you only get the first level and silently miss grandchildren. When in doubt, use the recursive option.

Installing it

Part of the Avatar Graph pack. 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

Pack-wide caveats: bpy==3.6.0 requires Python 3.10, first import auto-downloads the SAM checkpoint and mediapipe models. And remember: if "grab the group" selects nothing, the object you wired in probably isn't parented the way you think - check the hierarchy, not the node.