Add Curve To Parameter Group

A Parameter Group is exactly what it sounds like: a collection of curves that you work with as one object. And this is the node that puts curves into one. Add Curve To Parameter Group takes a single KEYFRAMED_CURVE, optionally an existing PARAMETER_GROUP, and returns the group with your curve added. First curve in? It creates the group for you.

Why bother? Two reasons, both genuinely useful. First, carrying multiple curves around on one wire instead of a fan of connections - your animation's whole set of parameters (prompt weight, motion amount, whatever) rides through the graph as a single bundle. Second, the pack's drawing utilities: KfPGroupDraw plots every curve in a group on one chart, with the curve labels as the legend. That's the workflow the README's "parameter groups and curve drawing utilities" example demonstrates - collect your curves, label them, plot them together, see the whole animation at a glance.

How it works

The key detail is labels. A group stores curves by their label, and the README is explicit: if you want to attach a curve to a parameter group, it needs a label. Curves created by the constructors get one (the YAML node even lets you set it explicitly), and the plotting utilities fall back to a random label if you never set one. When you add a curve whose label already exists in the group, the new one replaces the old at that label - worth knowing before you add two curves that both default to the same name. The source curve is deep-copied, so the original stays untouched.

The inputs

• curve (required, forceInput) - the curve to add.
• parameter_group (optional) - the group to add it to. Leave empty to start a new group.

The output

PARAMETER_GROUP - chain it into the next Add Curve To Parameter Group, or into KfPGroupDraw to visualize the whole set.

How to install it

Part of ComfyUI-Keyframed, so it comes with the pack: ComfyUI Manager → search ComfyUI-Keyframed, or

cd ComfyUI/custom_nodes
git clone https://github.com/dmarx/ComfyUI-Keyframed

then restart ComfyUI. No models; the only real dependency is keyframed (plus toolz), auto-installed on first import.

Troubleshooting

The label trap is the one that bites. Add two curves with the same label and the second silently overwrites the first in the group - no error, just a missing line in your plot. If a curve vanishes from a group's drawing, check its label. And a heads-up for beginners: a Parameter Group is not a single curve. You can't feed it straight into Apply Curve to Conditioning; you'd pull a specific curve back out with the pack's Get Curve From Parameter Group node first. Think of the group as the suitcase and the individual curves as the contents.