Object Call User Clear

This one's a straight wrap of Blender's ID.user_clear() - it tells Blender "stop counting this object as used by whatever's currently referencing it." It doesn't delete anything and it doesn't unlink the object from your scene. It just zeroes out the internal reference count Blender uses to decide whether a datablock is orphaned and safe to purge.

Where it fits in Avatar Graph

Avatar Graph (avatechai/avatar-graph-comfyui) rigs a flat character image into a real-time interactive avatar - segment the face, mesh each piece, wire it into a "Shape Flow" graph, export through Avatar Main Output. The README documents a small set of nodes for that pipeline (Segmentation, Create Mesh Layer, Join Meshes, Create Shape Flow, Avatar Main Output); Object Call User Clear isn't one of them. It's part of the much larger undocumented family the pack generates by exposing most of Blender's own Object/ID API as nodes. In practice this is cleanup-and-memory-management plumbing, not something the rigging tutorial ever asks you to touch.

How it works

Blender's data model is reference-counted: a mesh, image, or object datablock stays alive in the file as long as something points to it, and Blender's own garbage-collection ("Purge") only removes zero-user datablocks. user_clear() forces that count to zero regardless of what's actually still pointing at the object, which is a deliberate override - useful right before a scripted delete or a user_remap() swap, dangerous if something you still need was quietly depending on that reference existing.

Inputs and outputs

One optional field:

• BPY_OBJ - the object whose user count gets cleared. Unwired, it falls back to Blender's currently-active object, same as every sibling node in this family.

Output is BPY_OBJ, the same object passed back through - this node family chains rather than branches, so you keep wiring further Object_* nodes off the output instead of the input.

How to install it

Through ComfyUI Manager, search "avatar-graph-comfyui" and restart, or clone it manually:

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

The requirement that actually bites: bpy needs Python 3.10.x, nothing later. Windows gets a prebuilt Python 3.10 ComfyUI zip from the README; on Mac/Linux, spin up a dedicated conda env (conda create --name comfyui python=3.10) rather than reuse an existing one. Restart with --enable-cors-header if you want the live avatar preview to talk to editor.avatech.ai - without it you still get file exports, just no live panel.

Common issues & troubleshooting

The Python 3.10 pin is where people actually get stuck, not this node - installing the pack into a 3.11/3.12 environment (the common default now) fails to import. There's also at least one report of Avatar Graph leaving a ComfyUI Desktop install in a bad state after install (an oversized UI logo, an unexpected audio-permission popup) severe enough that a full reinstall didn't clean it up - worth testing in a throwaway ComfyUI instance first if you're not already on a dedicated 3.10 setup.

For this node specifically: because it silently overrides Blender's own reference count, the failure mode isn't an error message - it's something you expected to stay referenced quietly disappearing on a later purge or save/reload. If objects seem to vanish from a .blend after a graph run that included this node, that's the mechanism to suspect first.