arkennemasis Image Gen Settings (shared)

ArkImageGenSettings is the "one knob to rule them all" node for the arkennemasis image-generation family. It bundles aspect_ratio, quality, run_mode, background, output_format, moderation, timeout_seconds, api_token and max_concurrent into a single typed value, and you wire that value into every Image Gen node's settings socket to control them all from one place.

Why does this node have to exist? Because of a genuinely annoying ComfyUI limitation, and the README explains it exactly: ComfyUI rejects a STRING link into a COMBO widget, so you cannot wire a shared aspect_ratio or quality straight into the widgets of 24 Image Gen nodes. You'd have to edit 24 dropdowns by hand every time the client changes the aspect ratio. This node bundles those settings into one typed socket value instead - settings is a socket, not a widget, so one wire reaches every generator.

How it works

Every field defaults to use node's own. Leave it there and that field falls through to the target node's own widget - so you can share most settings from the central node and still override one locally, per node. timeout_seconds uses -1 for "use each node's own", 0 = wait indefinitely, and api_token blank means each node's own field, then REPLICATE_API_TOKEN from the environment or a .env file (that's the pack's key-resolution order: node field → env var → .env).

Which fields actually apply depends on the downstream node. The Codex Image Gen node's tooltip spells it out: Codex uses aspect_ratio / quality / background / run_mode / timeout_seconds; output_format, moderation and api_token do not apply and are ignored. The Replicate nodes use more of the ladder. The settings bundle is a union - each consumer picks what it understands.

One deliberate exclusion: number_of_images is not shared, and the README explains why. Multiplying it across every wired node is rarely what you want, and in a graph that names files deterministically the extra images all land on the same filename and overwrite each other. Set it per node if you need it.

When it earns its keep

The canonical use is the pack's character-dataset workflow: one Image Gen node per look (street candid, studio campaign, black-and-white editorial, festive wear...) - 24 generators all pointed at one reference person. Without this node, changing the aspect ratio means touching 24 widgets. With it, one dropdown. It also matters for rate-limit sanity: setting run_mode to one at a time centrally means every arkennemasis API node in the graph serialises through the same lock, which is the difference between a batch that 429s and a batch that doesn't.

Installing

It ships with comfyui-arkennemasis:

cd ComfyUI/custom_nodes
git clone https://github.com/Hishamahmer/comfyui-arkennemasis
pip install replicate httpx

restart, and it's under arkennemasis/Image Gen. No models, no key needed for the node itself - it just bundles values.

The trap to avoid is thinking use node's own means "this node does nothing." It's the fall-through mechanism, and it's the whole point: only the fields you actually set get shared, so you can share aspect ratio across 24 nodes while letting one node keep its own quality. Set everything and you've turned 24 generators into puppets of one panel - which is a feature, until you forget the panel is there and wonder why a local tweak isn't sticking.