# ComfyUI-Image-Captioner

**Repository Path**: nnn/ComfyUI-Image-Captioner

## Basic Information

- **Project Name**: ComfyUI-Image-Captioner
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-21
- **Last Updated**: 2025-08-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ComfyUI ImageCaptioner

<div align="center">
    <img src="assets/icon.png" style="width: 20%;" />
</div>

A [ComfyUI](https://github.com/comfyanonymous/ComfyUI) extension for generating captions for your images. Runs on your own system, no external services used, no filter.

Uses various VLMs with APIs to generate captions for images. You can give instructions or ask questions in natural language. 

Try asking for:

* captions or long descriptions
* whether a person or object is in the image, and how many
* lists of keywords or tags
* a description of the opposite of the image

![workflow](assets/workflow.png)

## Installation

1. `git clone https://github.com/neverbiasu/ComfyUI-ImageCaptioner` into your `custom_nodes` folder 
    - e.g. `custom_nodes\ComfyUI-ImageCaptioner`  
2. Open a console/Command Prompt/Terminal etc
3. Change to the `custom_nodes/ComfyUI-ImageCaptioner` folder you just created 
    - e.g. `cd C:\ComfyUI_windows_portable\ComfyUI\custom_nodes\ComfyUI-ImageCaptioner` or wherever you have it installed
4. Run `pip install -r requirements.txt`

## Usage

Add the node via `image` -> `ImageCaptioner`  

Supports tagging and outputting multiple batched inputs.  
- **image**: The image you want to make captions. 
- **api**: The API of dashscope.
- **use_prompt**: The prompt to drive the VLMs.

## Requirements

U need to get the API of dashscope from the [document](https://help.aliyun.com/zh/dashscope/developer-reference/acquisition-and-configuration-of-api-key?spm=a2c4g.11186623.0.0.7a32fa70GIg3tt)

## See also

* [ComfyUI-WD14-Tagger](https://github.com/pythongosssss/ComfyUI-WD14-Tagger)
* [ComfyUI-LLaVA-Captioner](https://github.com/ceruleandeep/ComfyUI-LLaVA-Captioner)
* [IELTSDuck](https://github.com/neverbiasu/IELTSDuck)