ComfyUI > Nodes > ComfyUI Deepface > Deepface Analyze

ComfyUI Node: Deepface Analyze

Class Name

DeepfaceAnalyze

Category
deepface
Author
jordoh (Account age: 5658days)
Extension
ComfyUI Deepface
Latest Updated
2026-02-01
Github Stars
0.04K

How to Install ComfyUI Deepface

Install this extension via the ComfyUI Manager by searching for ComfyUI Deepface
  • 1. Click the Manager button in the main menu
  • 2. Select Custom Nodes Manager button
  • 3. Enter ComfyUI Deepface 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

Deepface Analyze Description

Facial analysis node for age, gender, race, and emotion insights in images.

Deepface Analyze:

The DeepfaceAnalyze node is a powerful tool designed to perform facial analysis on images, providing insights into various attributes such as age, gender, race, and emotion. This node leverages advanced facial recognition and analysis techniques to extract meaningful data from images, making it an invaluable asset for AI artists and developers who wish to incorporate facial attribute analysis into their projects. By utilizing this node, you can gain a deeper understanding of the subjects in your images, enabling more personalized and context-aware applications. The node's ability to handle multiple images and perform analysis using different detection backends ensures flexibility and adaptability to various use cases, enhancing the overall user experience.

Deepface Analyze Input Parameters:

images

This parameter accepts a list of images that you want to analyze. Each image is processed to extract facial attributes based on the selected actions. The quality and resolution of the images can impact the accuracy of the analysis, so it's recommended to use clear and well-lit images for optimal results.

actions

The actions parameter allows you to specify which facial attributes you want to analyze. You can choose from "age," "gender," "race," and "emotion," and you have the flexibility to select multiple actions simultaneously. The default setting includes all four actions, providing a comprehensive analysis of the facial attributes. This parameter directly influences the type of data returned in the analysis results.

detector_backend

This parameter determines the facial detection backend used during the analysis. Options include "opencv," "ssd," "dlib," "mtcnn," "retinaface," "mediapipe," "yolov8," "yunet," and "fastmtcnn," with "retinaface" set as the default. The choice of backend can affect the speed and accuracy of face detection, with some backends being more suitable for specific scenarios or hardware configurations.

Deepface Analyze Output Parameters:

analysis_results

The output parameter analysis_results provides the results of the facial analysis in JSON format. This output contains detailed information about the analyzed attributes for each image, such as estimated age, predicted gender, identified race, and detected emotions. The JSON structure allows for easy parsing and integration into other applications or systems, enabling you to utilize the analysis data effectively.

Deepface Analyze Usage Tips:

  • Ensure that the images provided are of high quality and well-lit to improve the accuracy of the facial analysis.
  • Experiment with different detector backends to find the one that offers the best performance and accuracy for your specific use case.
  • Utilize the multiselect feature of the actions parameter to tailor the analysis to your needs, focusing only on the attributes that are relevant to your project.

Deepface Analyze Common Errors and Solutions:

{"error": "No face detected"}

  • Explanation: This error occurs when the node is unable to detect any faces in the provided image, possibly due to poor image quality or unsuitable detector backend.
  • Solution: Ensure that the images are clear and well-lit, and consider trying a different detector backend that might be more effective for the given images.

{"error": "Invalid image format"}

  • Explanation: This error indicates that the provided image is not in a supported format or is corrupted.
  • Solution: Verify that the images are in a compatible format (e.g., JPEG, PNG) and are not corrupted before passing them to the node.

{"error": "Backend not supported"}

  • Explanation: This error suggests that the specified detector backend is not supported or incorrectly specified.
  • Solution: Double-check the spelling and availability of the chosen backend, and ensure it is one of the supported options listed in the input parameters.

Deepface Analyze Related Nodes

Go back to the extension to check out more related nodes.
ComfyUI Deepface
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.