Object Vertex Group Remove

Every avatar pipeline ends with a pile of vertex groups you don't need - the placeholder groups, the experimental weights, the ones you created "just to see." Object Vertex Group Remove is the broom: it deletes vertex groups off the incoming mesh, either one at a time or in bulk.

It's destructive, so it's the kind of node you put late in the graph, after everything that needed those groups has already run.

How it works

An auto-generated wrapper around Blender's bpy.ops.object.vertex_group_remove. BPY_OBJ in, edit mode, operator runs, same object out. Three behaviors to choose from:

• all - default false. When on, removes every vertex group on the object.
• all_unlocked - default false. When on, removes every group except locked ones. This is the safe bulk option: lock the groups you want to keep with Object Vertex Group Lock, then nuke the rest.
• Neither flag → removes just the active group.

The all_unlocked path is the one you'll actually use. It's the "clean house but keep the face" move: lock your eyes and mouth groups, remove everything else in one pass.

Output is the same BPY_OBJ, so it chains cleanly toward the export.

Installing it

It ships with Avatar Graph:

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" via ComfyUI Manager. Standard pack notes apply: bpy==3.6.0 requires Python 3.10 (dedicated conda env per the README), and bpy is a heavy headless-Blender dependency.

Common issues

The failure mode here is being too thorough. Flipping all on when you meant all_unlocked deletes every group, and there's no undo in a graph that already executed. If your shape keys suddenly stop working, you removed the groups they target. Verify which groups are locked before you run the bulk version.

Also: this removes the group itself, not vertices from a group. For the latter, you want Object Vertex Group Remove From.