Registry / ai-ml / comfyui-workflow-templates-media-image

comfyui-workflow-templates-media-image

library0.3.118pypypiunverified

This package provides workflow templates and associated assets specifically designed for image processing and generation tasks within ComfyUI. It is part of the broader `comfyui-workflow-templates` ecosystem, delivering pre-configured JSON workflow files and their corresponding preview assets for easy integration and use directly within the ComfyUI graphical interface. The project maintains an active development cycle, frequently updating its collection of templates and underlying infrastructure to support new ComfyUI features and models.

ai-ml llm-agents

pip install comfyui-workflow-templates-media-image

package ↗

INSTALL

IMPORT

SIG · COMFYUI-WORKFLOW-T

comfyui-workflow-templates-media-image

ai-mlpythonv0.3.118

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

This library provides workflow templates for ComfyUI, which are loaded and utilized directly within the ComfyUI web interface, not via Python code imports. The quickstart outlines the steps to access and run these templates within the ComfyUI application.

# This library provides workflow templates for ComfyUI. # It does not have a direct Python API for programmatic use. # The templates are accessed and loaded within the ComfyUI application itself. print("To use comfyui-workflow-templates-media-image:") print("1. Ensure ComfyUI is installed and running.") print(" You can typically start ComfyUI by running 'python main.py' in its directory.") print("2. In the ComfyUI web interface, navigate to 'Workflow' -> 'Browse Templates' (or click the Templates icon in the sidebar).") print("3. Locate and select an image-related workflow template from the browser.") print("4. ComfyUI will prompt you to download any missing models required by the template.") print("5. Once models are ready, adjust parameters and click 'Queue Prompt' to run the workflow.")

Debug

Known issues

breakingComfyUI workflows, especially those relying on specific custom nodes, can become incompatible or produce different results after updates to ComfyUI or its extensions. This means older saved workflows may not function identically or at all on newer installations.

fix

Always back up critical workflows. When encountering issues, try updating ComfyUI and custom nodes. If problems persist, manually recreate or adapt the workflow to current node versions. Consider documenting the specific ComfyUI and custom node versions used for complex workflows to aid future reproduction.

affects: <0.3.x

gotchaMany workflow templates require external large language models (LLMs), VAEs, or other checkpoint files. ComfyUI will prompt for these downloads, but users must manually ensure they are placed in the correct `ComfyUI/models` subdirectories (e.g., `ComfyUI/models/checkpoints`, `ComfyUI/models/vae`) for non-desktop versions to function correctly.

fix

Carefully follow ComfyUI's prompts for model downloads and ensure correct file placement. Consult ComfyUI documentation for the expected model directory structure.

affects: All versions

gotchaThis library is primarily an asset package, providing JSON workflow files and preview images. It does not expose a direct Python API for programmatic interaction (e.g., `import comfyui_workflow_templates_media_image` will not provide functions to call for image generation). Its utility is solely through in-app template loading within ComfyUI.

fix

Do not attempt to use this package as a traditional Python library for code execution. Its purpose is to augment the ComfyUI application with pre-built workflows.

affects: All versions

gotchaWhile ComfyUI embeds workflow metadata into generated images, relying solely on this for long-term workflow reproducibility can be problematic. Significant changes to ComfyUI's core architecture or custom nodes can render older metadata-embedded workflows non-functional or produce unintended results, even if the image is re-dragged into ComfyUI.

fix

For critical workflows, consider explicitly saving the `.json` workflow file and making notes of the ComfyUI version and any custom node versions used at the time of creation. Regularly test and update workflows for compatibility.

affects: All versions

Errors

Common errors & fixes

Red Box Error in Workflow / Missing Custom Nodes

The workflow you loaded requires custom nodes that are not installed in your ComfyUI environment, causing the nodes to appear in red.

fix

Install ComfyUI Manager if you haven't already. Then, within the ComfyUI interface, open the Manager and click 'Install Missing Custom Nodes'. After installation, restart ComfyUI. If a node is still missing, you may need to manually install it by cloning its GitHub repository into your `ComfyUI/custom_nodes` directory.

Prompt execution failed Prompt outputs failed validation: CheckpointLoaderSimple: - Value not in list: ckpt_name: 'model-name.safetensors' not in []

The workflow is configured to use a specific model (e.g., checkpoint, VAE, LoRA) that is either missing from your `ComfyUI/models` directory or is incorrectly named/located.

fix

Download the required model file and place it in the appropriate subdirectory within `ComfyUI/models/` (e.g., `models/checkpoints/` for checkpoints, `models/vae/` for VAEs). Ensure the filename in the workflow matches the downloaded file exactly, or select an available model from the node's dropdown list.

Error fetching workflow templates: Object { stack: "AxiosError...", message: "Request failed with status code 404", ... } / New Templates not appearing in comfyui

ComfyUI is unable to retrieve or locate the workflow template files, possibly due to an outdated installation, a network issue preventing access to the template repository, or incorrect file paths.

fix

Update your ComfyUI installation to the latest version. If the problem persists, check your internet connection and ensure there are no firewall or proxy settings blocking access to the template server. For locally hosted setups, verify that the template files (like `index.json`) are present in the expected `ComfyUI/web/templates/` or relevant custom node template folders.

SyntaxError: JSON.parse: unexpected character (when loading workflow from PNG)

The workflow data embedded in the PNG image metadata is malformed or contains invalid JSON characters (e.g., 'NaN' values), preventing ComfyUI from correctly parsing the workflow when the image is dragged onto the canvas.

fix

Try saving workflows directly from ComfyUI using the 'Save' button instead of relying solely on PNG metadata. Ensure all custom nodes used in the workflow are updated, as older versions might produce invalid JSON. If the issue is with a shared image, the original creator might need to resave the workflow with a corrected or updated ComfyUI/custom node setup.

Upgrade

Version history

0.3.118latest on PyPI · released Apr 10, 2026

Audit

Dependencies

pythonrequiredRuntime environment requirement.

Agent activity

65 hits · last 30 days

node

OpenAI (training)

Amazon

Resources

packagehttps://pypi.org/project/comfyui-workflow-templates-media-image/ ↗