Object Set Hide Render
Keep the rig scaffolding out of your final render
- BPY_OBJ
- BPY_OBJ
A rigged avatar is never just the avatar. Somewhere in the scene there's an armature, a stack of empties acting as pivots, maybe a helper plane or a shadow-catcher floor - all of it scaffolding you'd rather not ship in the final render. ObjectSet Hide Render is the node that tells Blender to exclude an object from the render output entirely.
It maps to Blender's hide_render property, and it's the big hammer of scene hygiene: when you set it to true, the object stops being rendered at all - it won't appear in the embedded Avatar View preview, and it won't be part of anything you export from Avatar Main Output. Everything else keeps working: the object still exists, still holds its transforms and data, still participates in the scene. It's just invisible to the renderer.
This is the node you reach for when the exported .GLB shows a stray empty or the backdrop plane is showing up in your avatar preview. The default is false, and if you're unsure whether something is a helper or part of the character, leave it alone - hiding the wrong object gives you a surprisingly empty export.
How it works
Standard ObjectSet_* plumbing: the nodes are auto-generated from a dump of Blender's bpy.types.Object properties, and each is a one-property setter that mutates the BPY_OBJ passing through and returns it unchanged. Wire your mesh into BPY_OBJ, set value to true, and chain on.
Inputs that matter:
BPY_OBJ- the object you want excluded from renderingvalue- boolean, defaultfalse;truehides from render
Output is the same BPY_OBJ, so you can hide-render a helper and keep feeding the main mesh chain without a fork in the graph.
Installing Avatar Graph
This node ships inside the whole pack - install once:
cd ComfyUI/custom_nodes
git clone https://github.com/avatechai/avatar-graph-comfyui
cd avatar-graph-comfyui && pip install -r requirements.txt
Or ComfyUI Manager → Install Custom Nodes → search Avatar Graph → restart. The catch: the pack pins bpy==3.6.0, which needs Python 3.10 (Windows users get a bundled 3.10 environment from the README; macOS/Linux, use conda). First launch also auto-downloads the SAM ViT-H model and the mediapipe face/pose landmarkers.
Common issues
hide_render and viewport visibility are independent. If you set ObjectSet Hide Viewport instead, the object disappears from your working view but still renders - the classic "I hid it, why is it in the export?" surprise. The inverse gotcha applies here: a render-hidden object is still fully visible while you work, so a helper you hid from render can still get in the way of your preview. And as always with this pack, the Blender scene resets to factory settings on every run, so the hide flag is rebuilt from your graph each execution - the graph is the source of truth, not saved Blender state.
Inputs (2)
| Name | Type | Default | Description |
|---|---|---|---|
| BPY_OBJopt | BPY_OBJ | — | |
| valueopt | BOOLEAN | false | — |
Outputs (1)
| Name | Type | Description |
|---|---|---|
| BPY_OBJ | BPY_OBJ | — |