comfyui_gr85

comfyui_gr85 – Custom Nodes for ComfyUI

This repository provides a small collection of GR85-flavoured custom nodes for ComfyUI. It includes utilities for working with image dimensions, randomization, prompt manipulation, and seed utilities.

The implementation is being migrated from the legacy INPUT_TYPES / RETURN_TYPES API to the modern comfy_api.latest schema-based API (io.ComfyNode, define_schema, execute, and ComfyExtension).

Currently Simple Wildcard Picker has been migrated fully to the new API; other nodes still use the classic style.

---

Node overview

Resolution helpers

• GR85_ImageDimensionResizer (ImageDimensionResizer, category GR85/Resolution)

  • Computes new width/height based on a selected target resolution while preserving the original pixel count and aspect ratio.

• GR85_ImageSizer (ImageSizer, category GR85/Resolution)

  • Rescales to a target aspect ratio with orientation (original / landscape / portrait) and snaps the result to a given tolerance (e.g. multiples of 16).

• GR85_ImageSizerAll (ImageSizerAll, category GR85/Resolution)

  • Takes a pixel budget and aspect ratio components and returns new dimensions that match the pixel count and orientation, adjusted to a given tolerance.

• GR85_RandomRatio (RandomRatio, category GR85/Resolution)

  • Given two width/height pairs, samples a random aspect ratio between their ratios and returns it as integer width/height components.

Prompt helpers

• GR85_SeedBasedOutputSelector (SeedBasedOutputSelector, category GR85/Prompt/Selection)

  • Selects one string from up to 10 inputs based on a seed. Only non-None inputs are considered, and the seed is used with modulo to choose the index.

• GR85_SimpleWildcardPicker (SimpleWildcardPicker, category GR85/Prompt/Wildcards)

  • New implementation (v3 API):
    • Implemented as an io.ComfyNode using define_schema and execute.
    • Inputs:
      • prompt (multiline string)
      • seed (integer)
    • Behavior: expands {a|b|c}-style wildcards (with support for nested braces) using a seeded RNG so results are reproducible.

• Tag injector nodes (all classic API for now, category GR85/Prompt/Tags)

  • TagInjectorSingle – injects a single tag into a template using placeholder names like __elements__.
  • TagInjectorDuo – same idea, but for two tags (e.g. elements and stuff).
  • TagInjectorLarge – larger template that injects multiple semantic placeholders such as __location__, __weather__, __style__, etc.

Random / utility nodes

• GR85_NextSeed (NextSeed, category GR85/Random/Seed)

  • Given a seed, produces a new random seed in the full 64‑bit range.

• GR85_RandomFloat (RandomFloat, category GR85/Random/Numbers)

  • Generates a random float in [min_value, max_value], with configurable decimal precision, seeded for reproducibility.

• GR85_RandomInt (RandomInt, category GR85/Random/Numbers)

  • Generates a random integer in [min_value, max_value], seeded for reproducibility.

---

Architecture and loading

This extension supports both:

• Legacy discovery via NODE_CLASS_MAPPINGS / NODE_DISPLAY_NAME_MAPPINGS in __init__.py (for most nodes).
• Modern discovery via comfy_api.latest and a ComfyExtension entrypoint (for SimpleWildcardPicker).

The root __init__.py provides:

• NODE_CLASS_MAPPINGS and NODE_DISPLAY_NAME_MAPPINGS for the classic nodes.
• GR85Extension(ComfyExtension) with:
  • get_node_list() returning the list of new io.ComfyNode nodes.
• async def comfy_entrypoint() which ComfyUI calls to load the extension.

---

Migration guide

1. Simple Wildcard Picker

What changed

• Previously, SimpleWildcardPicker was a classic custom node defined with:
  • INPUT_TYPES
  • RETURN_TYPES, RETURN_NAMES, FUNCTION, CATEGORY
  • Registration via NODE_CLASS_MAPPINGS["GR85_SimpleWildcardPicker"] in __init__.py.
• That legacy implementation and registration have been removed.
• A new implementation now exists:
  • Class: SimpleWildcardPicker(io.ComfyNode) in nodes/prompt/simple_wildcard_picker.py.
  • Schema: define_schema() using io.Schema, io.String.Input, io.Int.Input, io.String.Output.
  • Execution: execute() returns an io.NodeOutput.
  • Registration: via GR85Extension.get_node_list() and comfy_entrypoint().
  • Node ID: still GR85_SimpleWildcardPicker (no v3 suffix), display name "Simple Wildcard Picker".

Behavior compatibility

• The wildcard expansion logic has been preserved:
  • Same {a|b|c} syntax.
  • Nested braces are supported.
  • A seeded RNG (Random(seed)) is used for reproducible choices.
• The internals were refactored into a helper function (_process_wildcards) used by the new execute() method.

Impact on existing workflows

• Graphs that reference node ID GR85_SimpleWildcardPicker should continue to work, but they now use the new schema-based node.

• Code or tooling that relied on:

  • NODE_CLASS_MAPPINGS["GR85_SimpleWildcardPicker"], or
  • the legacy INPUT_TYPES/FUNCTION shape of SimpleWildcardPicker

  will need to be updated to work with the new io.ComfyNode API and extension-based discovery.

How to update custom integrations

• Instead of importing and introspecting the legacy class, treat it as a standard io.ComfyNode:
  • Use its schema via SimpleWildcardPicker.define_schema().
  • Expect execute(prompt, seed) to be a classmethod returning io.NodeOutput.
• Do not rely on NODE_CLASS_MAPPINGS for this node anymore; it is no longer present there.

2. Other nodes (classic API)

• All other GR85 nodes still use the classic:
  • INPUT_TYPES
  • RETURN_TYPES / RETURN_NAMES
  • FUNCTION / instance methods
  • NODE_CLASS_MAPPINGS / NODE_DISPLAY_NAME_MAPPINGS
• They will continue to behave as before.

Planned direction

• Over time, these nodes can be migrated in the same style as SimpleWildcardPicker:
  • Introduce an io.ComfyNode implementation with define_schema + execute.
  • Register it via GR85Extension.get_node_list().
  • Optionally remove the old mapping entry once you are comfortable with the migration.

If you want to migrate another specific node (e.g. GR85_SeedBasedOutputSelector or one of the latent utilities), follow the same pattern as SimpleWildcardPicker and update the extension’s get_node_list() accordingly.