Skip to content
Node packVerifiedExternal
Open source

Comfy-UmiAI

A Logic Engine for ComfyUI Prompts: Variables, Conditionals, and Wildcards

Maintainer@Tinuva88Unratedgrade

Package profile

Status
Verified
Publisher
@Tinuva88
Source
GitHub

README

UmiAI Reference Manual

UmiAI is a modular ComfyUI custom-node toolkit. Its small core provides prompt expansion, prompt inspection, wildcard management, LoRA prompt handling, and metadata-aware image saving. Krea 2 ideation, Anima/editing tools, the memory/split-nibble system, and asset-management UI tools are independently installable overlays.

This manual is written for public release users. It describes the current lean build: the active nodes, supported prompt language, editable files, optional browser panels, and common workflow patterns.

What UmiAI Provides

  • A seeded wildcard processor for repeatable prompt variation.
  • A prompt language with wildcards, inline choices, variables, conditionals, negative prompt extraction, prompt presets, profiles, sections, and settings.
  • Inline LoRA references that can load LoRAs and optionally inject trigger text.
  • Prompt linting, prompt diff output, and explain JSON for debugging.
  • A metadata-aware save node plus settings, wildcard, and run-inspection UI.
  • Optional Krea 2 prompt ideation using the model's already-loaded Qwen3-VL text encoder, without loading a second LLM.
  • Optional Anima wildcard cohesion, artist-chain splitting, prompt ordering, sampling, and editing helpers.
  • Optional FLUX.2 Klein 9B role-aware references, precision masks, and exact source compositing.
  • Optional image, LoRA, Danbooru, and series-management browser panels.
  • Optional memory diagnostics, MiniMax H3 patches, and split-nibble runtimes.

Modular Bundles

C-UMI ships as one core archive and five optional overlay archives. Release filenames include the package version; the current release is 0.5.0:

  • C-UMI-0.5.0-core.zip: prompt processing, linting, profiles, metadata saves, bypass nodes, and the core settings/wildcard frontend.
  • C-UMI-0.5.0-krea.zip: Krea 2 ideation, style DNA, and semantic novelty.
  • C-UMI-0.5.0-anima_edit.zip: Anima prompt/sampling helpers and image editing.
  • C-UMI-0.5.0-klein_edit.zip: precision-edit helpers and a corrected Klein 9B workflow.
  • C-UMI-0.5.0-memory.zip: memory diagnostics, MiniMax H3 patches, and split-nibble.
  • C-UMI-0.5.0-ui_tools.zip: image, LoRA, Danbooru, and series browser tools.

All archives contain the same top-level C-UMI folder. Install core first, then merge any optional archive into ComfyUI/custom_nodes and restart. Missing optional overlays are treated as normal and do not affect core startup. See MODULAR_PACKAGING.md for release-building and installation details.

Each overlay has a sidecar manifest declaring its compatible core API range. An incompatible overlay is skipped with a warning instead of being imported.

Installation

  1. Extract C-UMI-0.5.0-core.zip into ComfyUI/custom_nodes.

  2. Install the Python requirements from this folder:

    pip install -r requirements.txt
    
  3. Optionally extract one or more overlay archives into ComfyUI/custom_nodes, merging their C-UMI folder with the core folder.

  4. If installing ui_tools, also run pip install -r requirements-ui-tools.txt with ComfyUI's Python.

  5. Restart ComfyUI.

  6. In ComfyUI, look for nodes under UmiAI, UmiAI/prompt, and the categories contributed by installed overlays.

The core requirement is pyyaml. The UI-tools overlay additionally requires requests and curl_cffi. UmiAI also uses ComfyUI's own model, LoRA, image, sampler, and web-server APIs.

Development Checks

The backend tests use only the Python standard-library runner and provide small ComfyUI/web stubs, so they can run without starting ComfyUI:

python -m unittest discover -s tests -v

The frontend prompt renderer has a separate structure and round-trip check:

node tests/check_prompt_structure.mjs

Active Nodes

UmiAI Wildcard Processor

Main prompt-processing node.

Inputs:

  • text: source prompt using UmiAI syntax.
  • seed: controls seeded wildcard and choice expansion.
  • model, clip: opti

Nodes in this pack

20 nodes
  • CameraAngleSelector
  • UmiAIWildcardNode
  • UmiAIWildcardNodeLite
  • UmiBypassModelSwitch
  • UmiCharacterCreator
  • UmiDatasetGenerator
  • UmiEmotionGenerator
  • UmiEmotionStudio
  • UmiModelManager
  • UmiModelSelector
  • UmiPoseGenerator
  • UmiPositionControl
  • UmiPromptInspector
  • UmiPromptPreset
  • UmiPromptProfile
  • UmiPromptSyntaxLint
  • UmiSaveImage
  • UmiSpriteGenerator
  • UmiTextBypass
  • UmiVisualCameraControl

Sources

3 sources
GitHubSource
github.com/Tinuva88/Comfy-UmiAI

Verified Oct 3

GitHubSourceVersion 825112c6d13362d415bfc3dcec8e52980cce0fef
github.com/Tinuva88/Comfy-UmiAI

Verified Oct 3

Source excerpts

1 excerpt

Source context: Repo Tinuva88/Comfy-UmiAI