Object Quick Smoke
ComfyUI Node Guide
- BPY_OBJ
- BPY_OBJ
This one's a genuine oddball, and worth calling out as such: Object Quick Smoke sets up a full smoke/fire simulation around a mesh, which is not something you'd expect to find in a pack built for rigging 2.5D character avatars. It's part of Avatar Graph, Avatech's node pack for turning static illustrations into real-time interactive avatars in ComfyUI - but this particular node is here because the pack wraps a huge swath of Blender's operator surface wholesale (the README documents the generator script, generate_blender_types.py, that produces this node list from Blender's own API), not because smoke sims are part of the avatar-rigging workflow.
It's a direct wrapper of bpy.ops.object.quick_smoke - Blender's "Quick Effects > Quick Smoke" tool. In Blender, this automatically configures a smoke/fire simulation around the selected mesh: it creates a domain object (the bounding volume the simulation runs inside) and sets the source mesh up as a flow emitter, saving you from wiring up the Physics panel by hand.
The inputs:
- style -
SMOKE,FIRE, orBOTH. This picks which simulation type gets configured. - show_flows - a debug visualization toggle, showing the flow emitter geometry in the viewport. Mostly useful while setting things up interactively; less relevant in a headless graph run.
Output is the same BPY_OBJ.
Realistically, if you're building an avatar rig with this pack, you almost certainly don't want this node - it's not part of the standard mesh-layer-and-shape-key pipeline the README walks through, and simulation setup is a heavyweight operation that expects a live Blender simulation context (bake caches, domain resolution settings, and so on) that a headless ComfyUI graph run isn't really set up to drive interactively. It's included because it's a real Blender operator, not because it's a recommended tool for this pack's actual use case. If you clicked into this page expecting an avatar-specific fire/smoke effect node, this probably isn't it - it's closer to "every Blender operator got a node" completeness than a curated feature.
Installing it: no standalone install - you get this as part of the full Avatar Graph pack regardless of whether you'll ever use it. Easiest path is ComfyUI Manager, searching "Avatar Graph" or avatar-graph-comfyui. Manual install: cd ComfyUI/custom_nodes, git clone https://github.com/avatechai/avatar-graph-comfyui, cd in, pip install -r requirements.txt, restart ComfyUI.
The install snag that actually causes problems: Avatar Graph needs Python 3.10.x, exactly, because its bpy dependency only ships wheels for that version. Anything newer and the install fails outright - the README's fix is a dedicated environment: conda create --name comfyui python=3.10, activate, install ComfyUI's requirements first, then this pack's. For the live avatar preview inside Avatech's web editor, launch with --enable-cors-header (Mac: add --force-fp16); without it, everything still runs, you just export .glb/.gltf and view results elsewhere instead of getting a live in-browser update.
If you're specifically here for actual VFX/simulation work in ComfyUI, you'd be better served digging into that dedicated space than this pack - Avatar Graph's real strength is character rigging, not fluid sims.
Inputs (3)
| Name | Type | Default | Description |
|---|---|---|---|
| BPY_OBJopt | BPY_OBJ | — | |
| styleopt | COMBO | 3 options: SMOKE, FIRE, BOTH | |
| show_flowsopt | BOOLEAN | false | — |
Outputs (1)
| Name | Type | Description |
|---|---|---|
| BPY_OBJ | BPY_OBJ | — |