Nodes/Avatar Graph/Object Call Shape Key Clear
ComfyUI Node

Object Call Shape Key Clear

Object Call Shape Key Clear — ComfyUI Node from Avatar Graph

By avatechai·Created 3 years ago·Updated 2 years ago· 264
Object Call Shape Key Clear
  • BPY_OBJ
  • BPY_OBJ

Shape keys are the whole game in Avatar Graph, Avatech AI's pack for turning a single character portrait into a real-time interactive 2D avatar - eye blinks, lip sync, all of it is shape keys driven live by the pack's own "Shape Flow" runtime, running on top of Blender's Python engine (bpy). Object Call Shape Key Clear sits in the large ObjectCall_* family of auto-generated Blender-Object-API wrappers, none of which get an individual mention in the README's own node table, but unlike a lot of its siblings this one operates directly on the mechanism this pack is built around, rather than being incidental Blender plumbing.

It wraps object.shape_key_clear() - the blunt-instrument version of shape key removal. Where Shape Key Remove takes a specific key out one at a time, this call strips every shape key off the object in one shot, including the Basis key, resetting the mesh back to a plain, keyless state. There's no confirmation step and nothing to configure - it's exactly as destructive as it sounds, which is worth internalizing before you drop it into a workflow you're actively iterating on.

Reach for this node when you want a clean slate - starting a fresh rigging pass on a mesh that's accumulated a pile of test shape keys you don't want to carry forward, for instance - rather than as a routine step in a working pipeline. The schema reflects how simple the underlying call is: just BPY_OBJ in (optional per the schema, though there's nothing to clear without one wired in from upstream) and BPY_OBJ out, the same object handle passed through, now with all its shape keys gone.

Installing it means installing the whole Avatar Graph pack. Via ComfyUI Manager: search "Avatar Graph" and install. Manually: cd ComfyUI/custom_nodes && git clone https://github.com/avatechai/avatar-graph-comfyui, then cd avatar-graph-comfyui && pip install -r requirements.txt, and restart. The requirement worth planning around: bpy needs Python 3.10.x exactly - the README's own advice to build a dedicated conda create --name comfyui python=3.10 environment, rather than layering this onto whatever env you've got running Flux or SDXL, is worth following rather than skipping. Restart with --enable-cors-header (--force-fp16 too on macOS) so the live avatar preview via Avatech's editor works.

Troubleshooting: the failure you're statistically most likely to hit is bpy refusing to import at startup because ComfyUI's Python isn't exactly 3.10.x - a genuinely common, recurring problem across Blender-Python-based ComfyUI nodes broadly, not specific to this one. The node-specific gotcha is entirely about placement in the graph: since it wipes every shape key unconditionally, putting it after your Create Shape Flow setup, or anywhere it can accidentally run more than once in a loop-heavy graph, will quietly delete work you meant to keep. Skipping --enable-cors-header doesn't affect this node at all - you just lose the live preview panel, while the graph and .glb/.gltf export from Avatar Main Output keep working.

Categoryblender

Inputs (1)

NameTypeDefaultDescription
BPY_OBJoptBPY_OBJ

Outputs (1)

NameTypeDescription
BPY_OBJBPY_OBJ