Load Value From Request
What it's for, and the bug you'll actually hit
- value
I'll lead with the useful part rather than bury it: as currently shipped in the open-source repo, this node has a real bug that will bite anyone trying to use it as a plain float slider on self-hosted ComfyUI, comfy.icu included. Here's what's going on and how to work around it.
What it's supposed to do
The intent is clear from its name and its neighbors in the codebase (it lives alongside a LoadImageFromRequest sibling with the same shape): give it a key name, and something external - presumably Avatech's own hosted runtime - pushes a live value in under that name, letting an outside system drive a number in your graph without editing the graph itself. That's a genuinely useful pattern for an interactive avatar tool: imagine live audio volume or a timer driving a blink or lip-sync blend value from outside ComfyUI's normal request/response cycle.
The inputs and output - and the actual behavior
name(STRING, required, default"key_name") - the key. On self-hosted ComfyUI, this field does not look anything up externally; nothing is listening for it. What it actually does: whenevernameis non-empty (which it is by default), the node overwrites thevalueoutput with the literal text ofnameitself - not the number on your slider.value(FLOAT, optional, default1.0, range -10 to 10, step 0.01) - this is the field you actually want to control the output with, and on plain ComfyUI it only takes effect whennameis an empty string.
Output is a single value, typed FLOAT - but per the above, what actually comes out depends entirely on whether name is empty.
The practical fix: clear the name field to an empty string, and use value as a normal, working float slider. Leave name filled in, and the value output becomes that text string instead of your number - almost certainly not what you want unless you're running inside an Avatech-hosted environment that patches this behavior underneath you (which comfy.icu and a standard local install are not).
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 hard blocker: bpy==3.6.0 is pinned in requirements.txt, and it only builds on Python 3.10.x. Windows users get a bundled Python 3.10 ComfyUI zip via the README; Mac/Linux users should build a dedicated conda environment (conda create --name comfyui python=3.10) rather than fighting an existing 3.11/3.12 setup. It's a heavier install overall - segment-anything, mediapipe, and OpenCV come along with it.
Common issues & troubleshooting
Slider doesn't seem to do anything. This is the bug above - as long as name has text in it, your value slider is being ignored and overwritten. Clear the name field and it starts behaving like a normal float input.
Downstream node errors on a type mismatch, or gets a weird non-numeric value. If something downstream expects a real float and name is non-empty, you're actually feeding it a string. Depending on what's downstream, this can surface as a confusing type error rather than an obviously wrong number - worth checking this node first if a value-driven part of your graph is behaving strangely.
You're trying to actually drive this from an external request. That machinery isn't present in a plain self-hosted install - it's built for Avatech's own hosted product. On comfy.icu or a standard local ComfyUI, treat this node as a float input with an unfortunate default state, not a live request-injection point.
Inputs (2)
| Name | Type | Default | Description |
|---|---|---|---|
| name | STRING | key_name | — |
| valueopt | FLOAT | 1.00-10–10 | — |
Outputs (1)
| Name | Type | Description |
|---|---|---|
| value | FLOAT | — |