Sign In

CaptainCaption: GPT-4-Vision Based Image Caption Generator

CaptainCaption: GPT-4-Vision Based Image Caption Generator

Tagging always was a chore and even with WD14 or BLIP it always took a lot of manual editing to get it right. With GPT-4-Vision it got a lot easier and because I haven't seen a UI around a wrote a small Gradio wrapper for the API.


  • Prompt Engineering: Customize the prompt for image description to get the most accurate and relevant captions.

  • Batch Processing: Ability to process an entire folder of images with customized pre and post prompts.


Clone repository

git clone

Install requirements

pip install -r requirements.txt



  1. Setting Up API Key: Enter your OpenAI API key in the provided textbox.

  2. Uploading Images: In the "Prompt Engineering" tab, upload the image for which you need a caption.

  3. Customizing the Prompt: Customize the prompt, detail level, and max tokens according to your requirements.

  4. Generating Captions: Click on "Generate Caption" to receive the image description.

  5. Batch Processing: In the "GPT4-Vision Tagging" tab, you can process an entire folder of images. Set the folder path, prompt details, and the number of workers for processing.

Running the Application

Run the script and navigate to the provided URL (Standard by Gradio to access the interface.

Limitations and Considerations

  • The accuracy of captions depends on the quality of the uploaded images and the clarity of the provided prompts.

  • The OpenAI API is rate-limited, so consider this when processing large batches of images.

  • Internet connectivity is required for API communication.