ComfyUI-SP-Nodes Introduction
ComfyUI-SP-Nodes is a collection of nodes for ComfyUI workflows. The examples provided by the author show tools for working with prompts, text, image metadata, model merging, and connections to a Telegram bot and a KoboldCPP API.
Rather than serving one specific image-generation task, the extension offers building blocks you can add where you need them. For example, you might use a prompt-related node while preparing an image, extract information from an existing image before a hires workflow, or split and rejoin text as part of a larger prompt-building setup.
How ComfyUI-SP-Nodes Works
In ComfyUI, a workflow is made of connected nodes: each node performs a task and passes its result to the next part of the workflow. ComfyUI-SP-Nodes adds more tasks you can place in that chain. The linked workflow images below show how the author connects the nodes in practice.
The Prompt Checker also uses a wildcards directory. Think of this directory as a place the node looks for reusable prompt material. The author documents the following search order:
- The node looks for a directory named
wildcardsnext to the location associated with the launched ComfyUI.batfile. - If it does not find that directory, it looks for
wildcardsin the node’s own folder. - You can specify the full path yourself in
config.iniinstead.
If the Prompt Checker is not finding the wildcard material you expect, checking those locations is a useful first step.
ComfyUI-SP-Nodes Features
The original README identifies the following features. For most of them, it provides a workflow image rather than a written list of controls, so the examples are the best reference for their connections and available settings.
- Prompt Checker — A prompt-related node with wildcard-directory support. The author credits ImpactPack for this feature. See the Prompt Checker workflow and the Prompt Checker screenshot.
- Send Images In To Telegram Bot — An example workflow for sending images to a Telegram bot. This may be useful when you want a workflow that includes image delivery outside ComfyUI. See the Telegram bot workflow.
- KoboldCPP API — A workflow example titled KoboldCPP LLM Prompt Generator. It shows how this extension can be used in a prompt-generation workflow involving KoboldCPP. See the KoboldCPP workflow.
- Extract Image MetaInfo for Hires — An example for extracting prompt and seed information from an image for use in a hires workflow. This is relevant when you want to build on an existing image and need information associated with it. See the image metadata workflow.
- CivitAI Prompts Parser — A prompt-parsing feature illustrated in the CivitAI Prompts Parser workflow.
- Text Split Join — Text-handling nodes for splitting and joining text within a workflow. The author credits comfyui-mixlab-nodes for this feature. See the Text Split Join workflow.
- Model Merging — An example of model merging based on controlled randomization. See the model-merging workflow.
- Other nodes — The author also provides an additional nodes example.
The examples show what each workflow is intended to do, but the provided documentation does not specify every adjustable setting or how particular values change the result. When trying a feature, inspect its node controls in ComfyUI and use the linked example as a guide to where it fits in your workflow.
Troubleshooting ComfyUI-SP-Nodes
Prompt Checker cannot find your wildcards
- Locate the
wildcardsdirectory you want the node to use. - Check whether it is in the location associated with your launched ComfyUI
.batfile, which the node searches first. - If it is not there, check for a
wildcardsdirectory in the node’s folder. - If you keep your wildcards somewhere else, specify their full path in
config.ini. - Compare your setup with the Prompt Checker workflow.
A feature is difficult to connect in your workflow
Open its linked example image in the features section and follow the connections shown there. The original README supplies visual examples for these features but does not provide step-by-step setup instructions or documented fixes for other errors.
Learn More about ComfyUI-SP-Nodes
The author’s ComfyUI-SP-Nodes repository contains the workflow images linked throughout this README. If you prefer learning visually, start with the example closest to your goal—such as prompt checking, image metadata extraction, or text splitting and joining—and compare its node connections with your own ComfyUI workflow.
