Installation

Use ComfyUI v0.37.0 as the initial reference. The package requires the V3 node API. Install dependencies with the Python that starts ComfyUI; a different system Python will not update that environment.

Windows Portable

Open PowerShell in the portable folder containing python_embeded and ComfyUI:

git clone https://github.com/ceroomedia/DMAI-NODES.git ComfyUI/custom_nodes/DMAI-NODES
.\python_embeded\python.exe -m pip install -r .\ComfyUI\custom_nodes\DMAI-NODES\requirements.txt

Without Git, extract the GitHub or Hugging Face release ZIP into ComfyUI/custom_nodes. The final path must be ComfyUI/custom_nodes/DMAI-NODES/__init__.py, with exactly one package folder.

Close and restart ComfyUI. Refresh the browser with Ctrl+F5. Search DMAI in the node library.

Local Python environment

Activate the environment used by ComfyUI. From the ComfyUI folder:

git clone https://github.com/ceroomedia/DMAI-NODES.git custom_nodes/DMAI-NODES
python -m pip install -r custom_nodes/DMAI-NODES/requirements.txt
python main.py

For ComfyUI Desktop, use the installation directory shown in Desktop's settings and its managed Python environment. Do not install another GPU build of PyTorch just for DMAI NODES; this package uses ComfyUI's existing runtime.

Runpod

Start your chosen ComfyUI Pod using your normal template and persistent volume. GPU availability, model licenses and Pod cost are separate from this package.
Open the Pod terminal and find the actual ComfyUI folder. Common examples are /workspace/ComfyUI and /workspace/runpod-slim/ComfyUI; templates differ.
Activate the same environment as the running ComfyUI server. Check its launcher if unsure.
Run the commands below, adjusting the path when needed.

cd /workspace/ComfyUI
git clone https://github.com/ceroomedia/DMAI-NODES.git custom_nodes/DMAI-NODES
python -m pip install -r custom_nodes/DMAI-NODES/requirements.txt

Store the model files and output directory on persistent storage. Match the files to MODELS.md.
Restart ComfyUI through the template's existing launcher and refresh its browser page. Use the template's authenticated access method; do not add an unauthenticated public endpoint for this package.
Import a starter workflow, choose installed files and generate one small image first.

The instructions do not start a Pod or buy compute. No Runpod template installation has been certified by this release's local CPU checks.

Optional Krea enhancement

The DMAI Krea Enhancer, Manual sampling with Enhancer set to krea2t, and any preset enabling that enhancer require the upstream extension. The historical Krea / Original recipe also enables it. New nodes and starter workflows leave enhancement at none. From the ComfyUI directory:

git clone https://github.com/capitan01R/ComfyUI-Krea2T-Enhancer.git custom_nodes/ComfyUI-Krea2T-Enhancer
git -C custom_nodes/ComfyUI-Krea2T-Enhancer checkout e1f60f79e168c62b1cb1cf773dfb3ae4ee2292e2

Restart ComfyUI. The adapter recognizes reviewed upstream versions 1.1.0 and 1.4.2 and verifies their implementation. An unknown modification is rejected with a clear error. The original workflow used 1.1.0; the command above pins 1.4.2. Settings match the original recipe; visual equivalence between enhancer versions has not been established.

RES4LYF is optional and installed separately. Follow its upstream instructions and the integration guide.

Update and remove

Update only when no job is running. To install 0.2.0 preview, including from a checkout pinned to an older release, run from the ComfyUI directory with its Python environment active:

git -C custom_nodes/DMAI-NODES fetch origin tag v0.2.0
git -C custom_nodes/DMAI-NODES checkout v0.2.0
python -m pip install -r custom_nodes/DMAI-NODES/requirements.txt
git -C custom_nodes/DMAI-NODES describe --tags --exact-match

For Windows Portable, run from the portable folder instead:

git -C .\ComfyUI\custom_nodes\DMAI-NODES fetch origin tag v0.2.0
git -C .\ComfyUI\custom_nodes\DMAI-NODES checkout v0.2.0
.\python_embeded\python.exe -m pip install -r .\ComfyUI\custom_nodes\DMAI-NODES\requirements.txt
git -C .\ComfyUI\custom_nodes\DMAI-NODES describe --tags --exact-match

The final command should print v0.2.0. Git's detached HEAD message is expected when selecting a fixed release tag. If Git reports local changes, preserve those changes before retrying; the commands above do not discard them.

Restart ComfyUI afterward, then hard-refresh with Ctrl+F5. For ZIP installations, replace package files from the new release while preserving your workflows and output. To uninstall, remove only the custom-node folder after stopping ComfyUI. Saved originals and the gallery index are in output/DMAI-NODES and are not removed by package updates.

What changes in 0.2.0

The larger interface adds readable Canvas socket captions and minimum node sizes. Saved nodes may grow to the new minimum dimensions on load; their IDs and connections remain unchanged. Manual is the default for new Engines and starter workflows. Existing workflows retain their saved sampling settings and any selected historical preset.

For new prepared settings, switch to DMAI Enhanced and choose Upload JSON. Upload is available only in that mode. The old preset export control is removed. Keep your original preset files; existing imported presets remain saved in the workflow. See sampling modes and legacy preset compatibility.

Updating from 0.1.2 or earlier

Since 0.1.3, the new Prompter registers as DMAINodesPrompter. Its visible name remains DMAI Prompter, under DMAI NODES, with the DMAI-NODES package badge. Older DMAI Suite and standalone Prompter installations use DMAIPrompter; they can remain enabled alongside this package. Version 0.2.0 keeps that separation.

To install exactly this release from an existing Git checkout, including a checkout pinned to an older tag, run inside custom_nodes/DMAI-NODES:

git fetch origin tag v0.2.0
git checkout v0.2.0
python -m pip install -r requirements.txt
git describe --tags --exact-match

Use ComfyUI's Python environment for the dependency command; Windows Portable uses ..\..\..\python_embeded\python.exe from that node directory. Restart ComfyUI, then hard-refresh the browser with Ctrl+F5.

UI workflows saved by DMAI NODES 0.1.0-0.1.2 are upgraded on load only when their Prompter data and output identify this package. Save the workflow after loading it. Legacy Suite/standalone Prompters keep their original IDs and connections. Ambiguous or damaged records are left for manual correction.

For API JSON sent directly to /prompt, use the new DMAINodesPrompter class type. The included API helper and offline conversion tool handle identifiable older DMAI NODES API workflows; see API migration. The server does not register the conflicting old ID as an alias.

Troubleshooting

No DMAI nodes: inspect the ComfyUI console for import errors; check the Python environment and one-level ZIP extraction.
Prompter missing when older DMAI nodes are installed: update to 0.2.0 using the commands above, restart ComfyUI and hard-refresh. The coexistence fix was introduced in 0.1.3. Search DMAINodesPrompter or select DMAI Prompter with the DMAI-NODES badge. The new node has a request output of type DMAI_PROMPT, captioned Prompt in Canvas.
Missing model: select the exact catalog entry, including subfolder. Refresh the model list after adding files.
Enhancer unavailable: install the pinned dependency or use Manual with Enhancer set to none.
Enhanced asks for a preset: choose Upload JSON in DMAI Enhanced and upload matching settings, or switch to Manual.
LoRA has no matching patches: verify the LoRA family and selected base model; this is deliberately an error.
Gallery missing original: restore the file from your backup. An export will not silently omit a selected missing file.
Frontend layout issue: hard-refresh first, then test Comfy's Canvas renderer. Socket captions are drawn outside the node; leave room between neighboring nodes. Keep the exact Core and Frontend versions in your issue report.

Official references: Portable, manual installation, Runpod ComfyUI guide.