Object Vertex Parent Set
Bind Your Mesh to an Armature With One Node
- BPY_OBJ
- BPY_OBJ
Everything in Avatar Graph funnels toward a rigged, animatable avatar - and a mesh that isn't bound to a skeleton is just a pretty statue. Object Vertex Parent Set is the binding step: it parents the incoming mesh to the armature using the active vertex group, which is the "vertex parent" method in Blender. The mesh follows the bone that the group is named after.
It's the node that turns "a mesh" into "part of a rig." In a facial avatar pipeline, that's how an eye mesh, a mouth mesh, or a whole head mesh gets hooked to the bones that will move it.
How it works
An auto-generated wrapper around Blender's bpy.ops.object.vertex_parent_set. Inputs:
- BPY_OBJ - the mesh to parent.
- confirm - a boolean, default
true. It's the operator's confirmation flag; you can practically leave it alone.
The actual mechanics depend on state outside the node: there needs to be a target object (the armature) active in the Blender context, and the mesh's active vertex group determines which bone drives it. Because the pack's nodes manage that context for you, the reliable pattern is to make sure the right group is active (via Object Vertex Group Set Active) before this runs, and that an armature is present in the scene from the earlier rigging steps.
Output is the same BPY_OBJ, ready to flow into the Shape Flow or export side of the graph.
Installing it
It rides in the Avatar Graph pack:
cd ComfyUI/custom_nodes
git clone https://github.com/avatechai/avatar-graph-comfyui
cd avatar-graph-comfyui
python -m pip install -r requirements.txt
Restart ComfyUI, or grab "Avatar Graph" from ComfyUI Manager. Pack-wide install notes: bpy==3.6.0 requires Python 3.10 (dedicated conda env per the README), and bpy is a full headless Blender, so the install is a heavy one.
Common issues
This node is more state-dependent than most in the pack, and that's where people get bitten. No armature in the scene, or the wrong group active, and you get a parent that binds to the wrong thing - or nothing at all. Confirm the active group is the one matching the bone you intend.
Also remember: vertex parenting ties the mesh to one bone through a group. If you're expecting full automatic skinning across many bones, that's a different (and much bigger) feature - this is the simple, one-bone binding.
Inputs (2)
| Name | Type | Default | Description |
|---|---|---|---|
| BPY_OBJopt | BPY_OBJ | — | |
| confirmopt | BOOLEAN | true | — |
Outputs (1)
| Name | Type | Description |
|---|---|---|
| BPY_OBJ | BPY_OBJ | — |