---

name: comfyui description: "Install and operate the MAGI-1 ComfyUI custom node and bundled workflows." metadata: disco-role: operating disable-model-invocation: true license: Apache 2.0

MAGI-1 ComfyUI operating skill

Use this sub-skill when a user wants to install, recognize, run, adapt, or troubleshoot the MAGI-1 ComfyUI custom node and its example workflows.

Do not use this sub-skill for source-code CLI inference commands or direct MagiPipeline API usage; route those questions to the MAGI-1 inference sub-skill. ComfyUI itself is an external host application dependency; this skill captures MAGI node behavior and workflow adaptation, not a verified ComfyUI host import.

Fast operating path

1. Install ComfyUI, then install the MAGI-1 node by one of these choices:
   • Registry install from inside the ComfyUI directory: comfy node registry-install MAGI-1.
   • Source install by placing the MAGI-1 source tree under ComfyUI/custom_nodes/MAGI-1 and installing MAGI-1 runtime dependencies into the same Python environment used by ComfyUI.
2. After either install method, ensure ComfyUI sees a plugin-root __init__.py: move or copy the repository's comfyui/__init__.py to the MAGI-1 plugin root if it is not already there. The plugin root must still contain the comfyui/, inference/, and example/assets/ subtrees expected by that initializer.
3. Download model weights and edit the selected MAGI JSON config so checkpoint paths are absolute for load, t5_pretrained, and vae_pretrained. Use absolute paths for the ComfyUI node's config_path, T5 path, input media, and save path fields.
4. Launch ComfyUI with comfy launch or python main.py from the ComfyUI directory.
5. Add nodes from Add Node → Magi or import one of the bundled workflows, then replace every placeholder path before queueing the graph:
   • Text to video workflow
   • Image to video workflow
   • Video continuation workflow

Detailed references

• Node roles, inputs, outputs, task-mode behavior, installation notes, and workflow adaptation: references/comfyui-nodes-and-workflows.md
• Troubleshooting path, import failures, absolute-path errors, GPU/memory issues, and output-saving issues: references/troubleshooting.md
• Offline workflow inspection helper: scripts/inspect_workflow_nodes.py

Guardrails for future agents

• State that imported workflow JSONs contain placeholders and must be reassigned inside the user's ComfyUI runtime.
• State that MAGI's ComfyUI MagiProcess node sets single-node/single-GPU distributed environment variables internally before inference.
• Do not claim ComfyUI host imports were verified unless the user has actually run ComfyUI with the MAGI node in their environment.
• Keep all workflow links generated-skill-relative; do not link to source checkout files.