Image Bridge

Don't spend time debugging this one - it's not broken, it's just not supposed to do anything visible. Image Bridge takes an image in and hands the exact same image back out, unchanged. No processing, no filtering, nothing. If you're looking at your graph wondering why this node "isn't working," the honest answer is: it's working exactly as designed, which is to relay.

What it's actually for

Avatar Graph is built around a live, interactive avatar runtime - Shape Flow - and Avatech's own web viewer at editor.avatech.ai, which can talk to your local ComfyUI over postMessage when you start it with --enable-cors-header. For that kind of integration to work, something in the graph needs to be a stable, named "wire point": a socket the external system can reach into and swap a value at execution time without you needing to restructure your whole graph around it. Image Bridge is exactly that - a fixed point in the pipeline that exists so an image can be substituted in from outside ComfyUI's normal execution, while everything downstream of it stays wired the same way regardless of whether that substitution happens.

On plain self-hosted ComfyUI, with no Avatech backend behind it, none of that substitution machinery is present - so functionally, all Image Bridge does for you locally is pass the image through untouched.

The input and output that matter

• image (optional) - whatever image you feed in.

Output is a single image, identical to the input. That's the whole node.

How to install it

Via ComfyUI Manager: search "Avatar Graph" (avatar-graph-comfyui), install, restart. Manually:

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

The pack's install has one real blocker: bpy==3.6.0 is pinned in requirements.txt, and that only builds on Python 3.10.x - nothing newer. Windows users get a bundled Python 3.10 ComfyUI zip via the README; on Mac/Linux, build a dedicated conda environment (conda create --name comfyui python=3.10) rather than trying to force an existing 3.11/3.12 setup to accept it. The requirements file also pulls in segment-anything, mediapipe, and OpenCV - a heavier install than most node packs, so give it time and disk space.

Common issues & troubleshooting

"It's not changing my image." Correct, by design - see above. If you were expecting a transform, you want a different node; Image Bridge is a relay point, not a filter.

Wondering why it's even in your graph. If you didn't add it deliberately, it's likely part of a template workflow built around Avatech's own hosted viewer integration. It's harmless to leave in a purely local workflow, but you can also just remove it and wire the image directly if you're not using the --enable-cors-header live-preview path - the end result on plain ComfyUI is identical either way.

No image coming through at all. Since image is optional, if nothing's wired into it, nothing comes out - check the actual connection rather than the node's logic, there's nothing here to misconfigure.