ComfyUI Node

Bus In

Pack up to twenty-five wires into one line

By wenchengxiang·Created 3 months ago·Updated 14 days ago· 2
Bus In
  • value_0
  • value_1
  • value_2
  • value_3
  • value_4
  • value_5
  • value_6
  • value_7
  • value_8
  • value_9
  • value_10
  • value_11
  • value_12
  • value_13
  • value_14
  • value_15
  • value_16
  • value_17
  • value_18
  • value_19
  • value_20
  • value_21
  • value_22
  • value_23
  • value_24
  • 总线束

Bus In is the "bundle everything" end of a 25-channel bus: it takes up to twenty-five inputs - any types at all, 输入_1 through 输入_25 - and packs whichever ones are actually connected into a single WCX_BUS object that travels down one wire. Its twin, Bus Out, unpacks that bundle back into twenty-five outputs at the far end. In between, twenty-five wires become one.

This is the context-bundle pattern the node-plumbing doc calls the most important design in the utility layer. When a dozen values - model, clip, latent, conditioning, seeds, widths - all need to travel across a large workflow, dragging each as its own wire produces the spaghetti that everyone hates. A bus collapses them into one line. rgthree's Context is the famous version of this idea; Bus In/Bus Out is this pack's, with two differences that matter: it's strictly a pack and unpack - no merging or updating, you can't push a changed value back onto the line without unpacking and repacking - and it's any-typed, so it'll carry whatever custom types you throw at it.

The mechanics are worth knowing because they're unusually careful:

  • Only connected channels get packed. The source iterates the twenty-five slots, skips anything None, and stores the rest in a dict keyed by slot number. Empty slots cost nothing and don't corrupt the bundle.
  • It returns a copy, not a reference. The author explicitly guards against ComfyUI's caching/pollution issues by handing back bus_dict.copy() - a thoughtful touch that keeps multi-output graphs from cross-contaminating.
  • The labels are Chinese. Inputs are 输入_1…输入_25 ("input"), the single output is 总线束 ("bus bundle"). Cosmetic, but expect it on an English UI.

The critical caveat, and it's a real one: WCX_BUS is a type only this pack understands. Bus In is written to be unpacked by Bus Out, and vice versa - no other tool can read the bundle. That's lock-in by design: a workflow using the bus is married to this pack, which is the same lock-in cost the KB flags for every pack-specific context type (rgthree's Context doesn't interoperate with Efficiency's pipes, either). It's the right tool when one node pair cleanly replaces forty wires; it's the wrong tool if you might hand the workflow to someone who won't have the pack installed.

Install is pack standard: ComfyUI Manager → search ComfyUI-Practical-Tools → install → restart, or git clone https://github.com/wenchengxiang/ComfyUI-Practical-Tools into ComfyUI/custom_nodes. No dependencies, no models. If an output comes back None on the far side, check that the slot was connected at Bus In - an unconnected slot packs to nothing.

CategoryPractical-Tools/Passthrough

Inputs (25)

NameTypeDefaultDescription
value_0opt*—
value_1opt*—
value_2opt*—
value_3opt*—
value_4opt*—
value_5opt*—
value_6opt*—
value_7opt*—
value_8opt*—
value_9opt*—
value_10opt*—
value_11opt*—
value_12opt*—
value_13opt*—
value_14opt*—
value_15opt*—
value_16opt*—
value_17opt*—
value_18opt*—
value_19opt*—
value_20opt*—
value_21opt*—
value_22opt*—
value_23opt*—
value_24opt*—

Outputs (1)

NameTypeDescription
总线束WCX_BUS—