Skip to content
Node packVerifiedExternal
Open source

ComfyUI_SageUtils

A set of custom nodes for ComfyUI

Maintainer@arcum42Bgrade

Package profile

Status
Verified
Publisher
@arcum42
Source
GitHub
Stars
35

README

Sage Utils for ComfyUI

Sage Utils is a comprehensive suite of custom nodes and integrated UI features for ComfyUI. It provides:

  • Custom Nodes: Simplify metadata creation, model and LoRA management, and other frequent tasks
  • LLM Integration: Built-in LLM chat interface with vision support for generating and refining prompts
  • Prompt Builder: Tag-based prompt construction system with LLM enhancement capabilities
  • Cross-Tab Integration: Seamless data flow between workflows, LLM chat, and prompt builder

The node suite supports A1111/Civitai metadata formats, while the UI features provide modern, accessible interfaces for AI-assisted workflow creation.

Model information downloaded from Civitai is cached locally in sage_cache_hash.json and sage_cache_info.json for fast access and reporting. These are located in comfyui/user/default/SageUtils/.

UI Features

LLM Chat Tab

Access AI language models directly within ComfyUI for prompt generation, refinement, and creative assistance:

  • Multi-Provider Support: LM Studio and Ollama (local providers for privacy and unlimited usage)
  • Vision Capabilities: Upload up to 10 images for vision-enabled models with drag-and-drop support
  • Streaming Responses: Real-time text generation with SSE (Server-Sent Events)
  • Conversation History: Maintain context across multiple exchanges
  • Preset System: Save and reuse complete LLM configurations (model, settings, system prompts)
  • System Prompt Management: Create, save, and manage custom system prompts
  • Advanced Options: Temperature, top-p, max tokens, presence/frequency penalties, keep-alive, system prompts
  • Keyboard Shortcuts: Ctrl+Enter to send, Escape to blur textareas
  • Accessibility: Full screen reader support with ARIA labels

📖 Complete LLM Tab Guide

Prompt Builder Tab

Wildcard and tag-based system for constructing complex prompts with LLM enhancement:

  • Wildcard System: Use __category__ syntax for dynamic, randomized prompt generation
  • Tag Library: Pre-organized tag collections across multiple categories for quick insertion
  • Saved Prompts: Save and manage complete prompt collections with descriptions
  • Seed-Based Generation: Control randomization with fixed or random seeds for reproducibility
  • LLM Integration: Send prompts to LLM for expansion, refinement, or creative variations
  • Cross-Tab Messaging: Receive enhanced prompts back from LLM tab automatically
  • Positive/Negative Prompts: Separate construction for better control
  • Keyboard Shortcuts: Ctrl+Enter to generate, Escape to blur fields
  • Performance Optimized: Debounced updates and rate-limited cross-tab messaging

📖 Complete Prompt Builder Guide

Cross-Tab Integration

Seamless data flow between all components:

  • Gallery to LLM: Send images from gallery to LLM for vision analysis
  • LLM to Prompt Builder: Enhanced prompts flow automatically to prompt builder
  • Prompt Builder to LLM: Send constructed prompts for AI refinement
  • Rate Limited: Intelligent throttling prevents system overload
  • Visual Feedback: Clear notifications for all transfers

Key Nodes

  • Save Image w/ Added Metadata
    An enhanced Save Image node with extra inputs for param_metadata and extra_metadata, allowing you to embed custom metadata under parameters (A1111 style) and extra. Includes switches to control inclusion of standard ComfyUI metadata.

  • Construct Metadata / Construct Metadata Lite
    Nodes for assembling metadata strings from various workflow inputs. The "Lite" version writes a more minimal set of metadata.

  • Load Checkpoint w/ Metadata
    Loads a checkpoint and outputs model_info, including hash and Civitai data. Model info is cached for quick access and reporting.

  • Load Diffusion Model w/ Metadata
    For loading UNET models with metadata support.

  • **Simple

Nodes in this pack

100 nodes
  • Sage_Ace15AudioEncode
  • Sage_AceAdvOptions
  • Sage_AdvSamplerInfo
  • Sage_AnythingToStr
  • Sage_AverageConditioning
  • Sage_CheckLorasForUpdates
  • Sage_CheckpointSelector
  • Sage_ChromaCLIPLoaderFromInfo
  • Sage_CleanText
  • Sage_CLIPLoaderFromInfo
  • Sage_CLIPSelector
  • Sage_CollectKeywordsFromLoraStack
  • Sage_CombineCLIPMultilineTextEncode
  • Sage_CombineCLIPTextEncode
  • Sage_CombineConditioning
  • Sage_ConstructLLMPrompt
  • Sage_ConstructLLMPromptExtra
  • Sage_ConstructMetadataFlexible
  • Sage_CropImage
  • Sage_CubiqImageResize
  • Sage_DualCLIPSelector
  • Sage_DualCLIPTextEncode
  • Sage_DualCLIPTextEncodeLumina2
  • Sage_DualCLIPTextEncodeQwen
  • Sage_DynamicJoinText
  • Sage_EmptyAceStep15LatentAudio
  • Sage_EmptyLatentImagePassthrough
  • Sage_EnhancerPrompt
  • Sage_ErniePromptEnhancerPrompt
  • Sage_FlexibleCLIPSelector
  • Sage_FreeMemory
  • Sage_FreeU2
  • Sage_GuessResolutionByRatio
  • Sage_HiDreamE1_Instruction
  • Sage_JoinText
  • Sage_KSampler
  • Sage_KSamplerAudioDecoder
  • Sage_KSamplerTiledDecoder
  • Sage_LLMPromptText
  • Sage_LLMPromptVision
  • Sage_LLMPromptVisionRefine
  • Sage_LMStudioLLMPromptText
  • Sage_LMStudioLLMPromptVision
  • Sage_LMStudioLLMPromptVisionRefine
  • Sage_Load_Dataset_From_Folder
  • Sage_LoadImage
  • Sage_LoadModelFromInfo
  • Sage_LogicalSwitch
  • Sage_LoraStack
  • Sage_LoraStackInfoDisplay
  • Sage_LoraStackLoader
  • Sage_ModelInfo
  • Sage_ModelInfoDisplay
  • Sage_ModelLoraStackLoader
  • Sage_ModelShiftOnly
  • Sage_ModelShifts
  • Sage_MultiModelPicker
  • Sage_MultiplyConditioningStrength
  • Sage_MultiSelectorDoubleClip
  • Sage_MultiSelectorFlexibleClip
  • Sage_MultiSelectorQuadClip
  • Sage_MultiSelectorSingleClip
  • Sage_MultiSelectorTripleClip
  • Sage_NormalizeConditioningStrength
  • Sage_NumberToStr
  • Sage_OllamaAdvancedOptions
  • Sage_OllamaLLMPromptText
  • Sage_OllamaLLMPromptVision
  • Sage_OllamaLLMPromptVisionRefine
  • Sage_ParseMetadataFlexible
  • Sage_PercentageToFloat
  • Sage_PonyPrefix
  • Sage_PonyRatingv6
  • Sage_PonyRatingv7
  • Sage_PonyScore
  • Sage_PonySource
  • Sage_PonyStyle
  • Sage_PonyStyleCluster
  • Sage_PromptText
  • Sage_QuadCLIPSelector
  • Sage_QuickLoraStack
  • Sage_QuickResPicker
  • Sage_ReferenceImage
  • Sage_SamplerInfo
  • Sage_SamplerInfoNoCFG
  • Sage_SamplerSelector
  • Sage_SaveImageWithMetadata
  • Sage_SaveText
  • Sage_SchedulerSelector
  • Sage_SetText
  • Sage_SetTextWithNum
  • Sage_SetTextWithoutComments
  • Sage_SingleCLIPTextEncode
  • Sage_SingleCLIPTextImageEncode
  • Sage_StackLoraStack
  • Sage_StylePromptFromConfig
  • Sage_SystemPrompt
  • Sage_TextRandomLine
  • Sage_TextSelectLine
  • Sage_TextSubstitution

Related resources

1 connection

Sources

3 sources
GitHubSource
github.com/arcum42/ComfyUI_SageUtils

Verified Oct 9

GitHubSourceVersion 0d4fb076af124eb9b0c8b6ae96ff03aff5503d85
github.com/arcum42/ComfyUI_SageUtils

Verified Sep 12

Source excerpts

1 excerpt

Source context: Repo arcum42/ComfyUI_SageUtils