Object Set Show Axis

Object Set Show Axis toggles show_axis, the Blender viewport flag that draws the object's local XYZ axes as little colored arrows at its origin. If you're rigging an avatar and need to see which direction a mesh layer is actually pointing - say, to confirm an empty is facing the camera, or to check the local axes before you set a track axis or parent it to a bone - this node turns the arrows on.

How it works

Like every ObjectSet_* node in the pack, this one is generated from Blender's bpy.types.Object property list and does one setattr(object, "show_axis", value) inside the embedded bpy instance, returning the same BPY_OBJ. The value input is a BOOLEAN with default false; set it true and the axis arrows appear around the object in the viewport.

Two things worth knowing. First, it's a pure viewport aid - no effect on render, export, or the final avatar; you enable it to debug, then disable it for a clean preview. Second, it pairs naturally with Object Set Track Axis (which decides which local axis points at a target). If a tracked part points the wrong way, you'll usually want to see the axes first to understand what "wrong" means, then fix the track axis - these two setters are a debugging duo.

The inputs

• BPY_OBJ - the object from Create Mesh Layer, a Mesh_ primitive, or an Object_ op.
• value - boolean, default false.

Output: the same BPY_OBJ for chaining.

Install & gotchas

Ships inside the Avatar Graph pack:

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

Or via ComfyUI Manager → "Avatar Graph". Pack-level requirement to know about: bpy==3.6.0 pins you to Python 3.10 - there's no bpy wheel for 3.11+, so on a newer Python the whole pack refuses to load. Conda with python=3.10 is the README's recommendation. First launch auto-downloads a ~2.5 GB SAM model plus mediapipe landmarker files.

The usual gotchas apply: the flag is viewport-only, so don't expect it in the render; it only works when wired downstream of object creation (the bpy scene resets each queue run); and the pack's live preview requires starting ComfyUI with --enable-cors-header, otherwise you lose the realtime editor but can still export via Save File on Avatar Main Output. On ComfyUI Desktop there are reports of the pack's embedded editor overlay breaking the UI after install - the browser build is the workaround, and it doesn't affect node behavior.