ComfyUI > Nodes > ComfyUI-KEEP > KEEP Single Image

ComfyUI Node: KEEP Single Image

Class Name

KEEP_FaceUpscaleImage

Category
ComfyUI-KEEP
Author
wildminder (Account age: 4890days)
Extension
ComfyUI-KEEP
Latest Updated
2025-07-04
Github Stars
0.07K

How to Install ComfyUI-KEEP

Install this extension via the ComfyUI Manager by searching for ComfyUI-KEEP
  • 1. Click the Manager button in the main menu
  • 2. Select Custom Nodes Manager button
  • 3. Enter ComfyUI-KEEP in the search bar
After installation, click the Restart button to restart ComfyUI. Then, manually refresh your browser to clear the cache and access the updated list of nodes.

Visit ComfyUI Online for ready-to-use ComfyUI environment

  • Free trial available
  • 16GB VRAM to 80GB VRAM GPU machines
  • 400+ preloaded models/nodes
  • Freedom to upload custom models/nodes
  • 200+ ready-to-run workflows
  • 100% private workspace with up to 200GB storage
  • Dedicated Support

Run ComfyUI Online

KEEP Single Image Description

Enhances facial image resolution using advanced upscaling, detection, and alignment techniques.

KEEP Single Image:

The KEEP_FaceUpscaleImage node is designed to enhance the resolution and quality of facial images by applying advanced upscaling techniques. This node is particularly beneficial for AI artists and designers who wish to improve the clarity and detail of faces in their digital artwork. By leveraging sophisticated image processing algorithms, the node can upscale facial features while maintaining or even enhancing the original quality. This is achieved through a combination of face detection, alignment, and upscaling processes that ensure the final output is both visually appealing and true to the original image. The node is capable of handling various scenarios, such as upscaling only the central face or drawing bounding boxes around detected faces, providing flexibility and control over the upscaling process. Overall, the KEEP_FaceUpscaleImage node is an essential tool for anyone looking to refine and upscale facial images with precision and ease.

KEEP Single Image Input Parameters:

image

The image parameter is a tensor representing the input image that you wish to upscale. This parameter is crucial as it serves as the base for all subsequent processing. The quality and resolution of the input image can significantly impact the final output, so it is recommended to use the highest quality image available for best results.

keep_model

The keep_model parameter requires an instance of the KEEPModelPack, which contains the necessary models and configurations for the upscaling process. This parameter is essential as it dictates the specific algorithms and techniques used to enhance the image. Providing an incorrect model pack will result in an error, so ensure that the correct model is loaded.

final_upscale_factor

The final_upscale_factor parameter determines the scale by which the image will be upscaled. This factor directly influences the size and detail of the output image. A higher upscale factor will result in a larger and more detailed image, but it may also increase processing time. It is important to choose a factor that balances quality and performance based on your needs.

has_aligned_face

The has_aligned_face parameter is a boolean that indicates whether the faces in the image are already aligned. If set to True, the node will skip the alignment process, which can save time if you are certain that the faces are properly aligned. If unsure, it is safer to set this to False to ensure optimal results.

only_center_face

The only_center_face parameter is a boolean that specifies whether to upscale only the central face in the image. This can be useful if the image contains multiple faces but you are only interested in enhancing the most prominent one. Setting this to True will focus the upscaling efforts on the central face, potentially improving performance and output quality.

draw_bounding_box

The draw_bounding_box parameter is a boolean that determines whether to draw bounding boxes around detected faces in the output image. This can be helpful for visualizing which faces have been detected and processed, especially in images with multiple subjects or complex backgrounds.

KEEP Single Image Output Parameters:

output_image_single

The output_image_single parameter is the resulting upscaled image, returned as a tensor. This output represents the enhanced version of the input image, with improved resolution and detail, particularly in the facial regions. The quality of this output is dependent on the input parameters and the effectiveness of the upscaling process.

KEEP Single Image Usage Tips:

  • Ensure that the input image is of high quality to achieve the best upscaling results.
  • Use the final_upscale_factor judiciously to balance between image quality and processing time.
  • If you are certain that the faces in the image are aligned, set has_aligned_face to True to speed up processing.
  • Utilize the only_center_face option if you are only interested in enhancing the main subject in images with multiple faces.

KEEP Single Image Common Errors and Solutions:

Invalid KEEP Model Pack provided. Expected KEEPModelPack, got <type>

  • Explanation: This error occurs when the keep_model parameter is not an instance of KEEPModelPack.
  • Solution: Ensure that you provide a valid KEEPModelPack instance for the keep_model parameter.

Error processing single image: <error_message>

  • Explanation: This error indicates that an exception occurred during the image processing phase.
  • Solution: Check the input parameters and ensure that the image and model are correctly configured. Review the error message for specific details and adjust the parameters accordingly.

KEEP Single Image Related Nodes

Go back to the extension to check out more related nodes.
ComfyUI-KEEP
RunComfy
Copyright 2025 RunComfy. All Rights Reserved.

RunComfy is the premier ComfyUI platform, offering ComfyUI online environment and services, along with ComfyUI workflows featuring stunning visuals. RunComfy also provides AI Models, enabling artists to harness the latest AI tools to create incredible art.