Comfy-UmiAI
A Logic Engine for ComfyUI Prompts: Variables, Conditionals, and Wildcards
Profil du package
- Statut
- Vérifié
- Éditeur
- @Tinuva88
- Source
- GitHub
LIREMOI
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
-
Extract
C-UMI-0.5.0-core.zipintoComfyUI/custom_nodes. -
Install the Python requirements from this folder:
pip install -r requirements.txt -
Optionally extract one or more overlay archives into
ComfyUI/custom_nodes, merging theirC-UMIfolder with the core folder. -
If installing
ui_tools, also runpip install -r requirements-ui-tools.txtwith ComfyUI's Python. -
Restart ComfyUI.
-
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
Nœuds dans ce pack
Nœuds 20
Nœuds dans ce pack
Nœuds 20- CameraAngleSelector
- UmiAIWildcardNode
- UmiAIWildcardNodeLite
- UmiBypassModelSwitch
- UmiCharacterCreator
- UmiDatasetGenerator
- UmiEmotionGenerator
- UmiEmotionStudio
- UmiModelManager
- UmiModelSelector
- UmiPoseGenerator
- UmiPositionControl
- UmiPromptInspector
- UmiPromptPreset
- UmiPromptProfile
- UmiPromptSyntaxLint
- UmiSaveImage
- UmiSpriteGenerator
- UmiTextBypass
- UmiVisualCameraControl
Sources
3 sources
Sources
3 sourcesVérifié 3 oct.
Vérifié 3 oct.
Extraits de sources
1 extrait
Extraits de sources
1 extraitSource context: Repo Tinuva88/Comfy-UmiAI
