Nodes/Avatar Graph/Object Collection Remove
ComfyUI Node

Object Collection Remove

ComfyUI Node Guide

By avatechai·Created 3 years ago·Updated 2 years ago· 264
Object Collection Remove
  • BPY_OBJ
  • BPY_OBJ

Object Collection Remove is scene-organization housekeeping, not avatar-specific magic - but it's a fair one to know about if you're building complex rigs with Avatar Graph, Avatech's node pack for turning static character illustrations into real-time interactive avatars inside ComfyUI.

It's a direct wrapper of Blender's bpy.ops.object.collection_remove operator. In Blender, "collections" are the organizational groupings you see in the Outliner - folders, essentially, that objects can belong to (and an object can belong to more than one at once). This operator removes the currently active object from whichever collection is currently active, without deleting the object itself. Think of it as "un-file this object from this folder," not "delete this object."

There's not much to configure - this node has a single input:

  • BPY_OBJ - the object you want removed from its active collection.

Output is the same BPY_OBJ, now de-grouped from that collection, everything else about it (mesh data, transforms, modifiers) untouched.

Where this actually comes up in an avatar-rigging workflow: as you build a rig out of multiple layered mesh parts (eyes, mouth, body, accessories), it's common for organizational tooling in the pack - or your own graph logic - to group things into collections for clarity or for batch operations. If a part needs to be pulled out of one grouping (say, to move it into a different rig hierarchy, or exclude it from a batch export step that operates per-collection), this is the node that does the "removing" half of that reshuffle. It doesn't add the object anywhere else - pairing it with whatever collection-add equivalent exists elsewhere in the pack is on you.

Installing it: no standalone install - this comes bundled with the whole Avatar Graph pack. Easiest route is ComfyUI Manager, searching "Avatar Graph" or avatar-graph-comfyui. Manual install: cd ComfyUI/custom_nodes, then git clone https://github.com/avatechai/avatar-graph-comfyui, cd into it, pip install -r requirements.txt, then restart ComfyUI.

The install issue that actually gets people: Avatar Graph needs Python 3.10.x, specifically, because its bpy dependency - Blender's Python API packaged as a standalone library - only ships wheels for that exact version. On a newer Python, which is what most fresh ComfyUI environments run today, the install fails rather than half-working. The README's own recommendation is a dedicated environment: conda create --name comfyui python=3.10, activate it, install ComfyUI's requirements first, then this pack's. If you want the live avatar preview inside Avatech's web editor, also launch with --enable-cors-header (Mac users add --force-fp16); without it, everything still functions, you just export .glb/.gltf and view results in Blender instead of getting a live in-browser update.

Worth knowing: if this node seems to have no visible effect, that's actually expected - removing something from a collection doesn't change how it looks or where it sits in 3D space, only how it's organized in the Outliner. Don't confuse "nothing changed" with "it didn't work."

Categoryblender

Inputs (1)

NameTypeDefaultDescription
BPY_OBJoptBPY_OBJ

Outputs (1)

NameTypeDescription
BPY_OBJBPY_OBJ