Object Clear Override Library

This node lives at the intersection of two Blender features most ComfyUI users will never have touched: linked libraries (referencing objects that actually live in a different .blend file) and library overrides (a local, editable layer on top of a linked object so you can tweak it without breaking the link back to the source file). This node clears that override - it's the scripted equivalent of Blender's "Clear Library Override" action, detaching an object from the override system it was participating in.

Where it fits in Avatar Graph

Avatar Graph (avatechai/avatar-graph-comfyui) is the pack behind this node - it rigs a flat character image into an interactive avatar via segmentation, mesh layers, and a "Shape Flow" runtime graph, exported through Avatar Main Output. None of that documented pipeline touches linked libraries or overrides; this node is part of the much larger undocumented family the pack generates by wrapping most of Blender's Object operators 1:1. Realistically, this is a node you'd only reach for if you're building a more advanced pipeline on top of Avatar Graph that links assets in from other .blend files - not something the standard character-rigging tutorial ever needs.

How it works

Library overrides let you link an object from another file (say, a shared rig or prop library) and still make local edits to it, without those edits getting wiped every time the source file updates. Clearing the override removes that local editable layer - the object either reverts fully to the linked source's state or stops being tracked as an override, depending on how it was set up. If you were relying on local tweaks staying in place, they're gone after this runs.

Inputs and outputs

• BPY_OBJ (optional) - the object whose library override gets cleared. Unwired, it falls back to Blender's currently active object.

Output: BPY_OBJ - the same object, passed through for chaining, matching every other node in this family.

How to install it

ComfyUI Manager: search "avatar-graph-comfyui", install, restart. Manual install:

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

bpy requires Python 3.10.x specifically, which is the actual install blocker most people hit. Windows gets a prebuilt Python 3.10 ComfyUI zip from the README for exactly this reason; on Mac/Linux, set up a dedicated conda env (conda create --name comfyui python=3.10) instead of trying to bolt it onto an existing one. Restart with --enable-cors-header if you want the live avatar preview panel talking to editor.avatech.ai - exports work without it regardless.

Common issues & troubleshooting

The install, not the node, is where most people get stuck - a 3.11/3.12 Python environment, the default on most current ComfyUI setups, simply can't load bpy. There's also a real report of Avatar Graph leaving a ComfyUI Desktop install badly broken after installation (an oversized UI logo, a stray audio-permission popup) severely enough that a full reinstall didn't fully undo it - try a spare, portable ComfyUI instance first if you're not already sandboxed on 3.10.

For this node specifically: if you're not deliberately working with linked libraries and overrides elsewhere in your Blender file, you almost certainly don't need it - running it on an ordinary local object (which is most objects Avatar Graph's own rigging pipeline creates) has nothing to clear and is effectively a no-op.