gitwtfhub

wtf is forge-neo-image2prompt?

adeliox/forge-neo-image2prompt — explained in plain English

Analysis updated 2026-05-18

1PythonAudience · vibe coderComplexity · 3/5Setup · moderate

TL;DR

An add-on for the SD WebUI Forge Neo image generator that looks at any picture and writes a text description of it, which you can then feed back into Forge Neo to create a new image.

Mindmap

mindmap
  root((repo))
    What it does
      Describes images in words
      Sends prompts to image tools
      Goes image to text to image
    Tech stack
      Python
      Qwen2 vision models
      Florence-2 models
      Hugging Face model hub
    Use cases
      Recreate similar images
      Tag images with keywords
      Describe reference images
    Audience
      AI image hobbyists
      Forge Neo users
      People with AI GPUs

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Upload a reference photo to get a text prompt that recreates a similar style image.

REASON 2

Generate Danbooru-style keyword tags from an image for AI art communities.

REASON 3

Reverse-engineer an existing image into a prompt you can tweak and remix.

REASON 4

Use lighter AI models to automatically caption folders of images on a modest GPU.

What's in the stack?

PythonTransformersPyTorchQwen2-VLFlorence-2Hugging Face Hub

How it stacks up

adeliox/forge-neo-image2prompt0xustaz/streamgatea-bissell/unleash-lite
Stars111
LanguagePythonPythonPython
Setup difficultymoderatehardhard
Complexity3/54/54/5
Audiencevibe coderdeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires a Forge Neo installation and a GPU with at least 5 GB of video memory, first use triggers a multi-gigabyte model download from Hugging Face.

No license information is provided in the repository, so terms of use are unknown.

Wtf does this do

This repository is an extension for SD WebUI Forge Neo, which is a popular interface for generating images from text using AI. The extension adds a new tab called Image2Prompt. You upload an image, and the extension uses a vision-language model to describe that image in words. You can then send the generated text description directly into the image generation tools built into Forge Neo, creating a way to go from an image to a text prompt and back to a new image. The extension supports several AI models for understanding images. The recommended model is Qwen2-VL-2B-Instruct, which needs about 5 GB of video memory and offers a good balance between quality and resource usage. A larger 7B version exists for maximum quality but requires around 16 GB of video memory. There are also lighter Florence-2 models from Microsoft that focus on simple image captions. On first use, the chosen model downloads from Hugging Face, which can be several gigabytes. The extension caches these models so you only download once. You can choose how the output is formatted. Options include a natural Stable Diffusion prompt, Danbooru-style tags, or a detailed or short description. For the Qwen models, you can also write custom instructions to guide how the model describes your image. After generating a prompt, you get buttons to copy the text or send it directly to the txt2img or img2img tabs in Forge Neo. The extension also includes a button to free up video memory after each generation, which helps if your GPU has limited capacity. Installation involves copying the extension folder into the extensions directory of your Forge Neo setup and doing a full restart. On first launch, the extension checks for and installs required dependencies like transformers, accelerate, and einops. A graphics card is recommended for reasonable speed, though the extension does offer a forced CPU mode that works on any machine but runs slowly. The documentation includes a troubleshooting table for common issues like missing dependencies or running out of memory.

Yoink these prompts

Prompt 1
I installed the Image2Prompt extension in Forge Neo. Write a custom instruction for the Qwen2 model so it describes my uploaded images as short Stable Diffusion prompts focusing on lighting and color.
Prompt 2
I want to use Image2Prompt with Florence-2 on a machine with only 4 GB of video memory. Give me step-by-step instructions to configure the extension for CPU mode and generate a simple caption from an image.
Prompt 3
Help me troubleshoot the Image2Prompt extension in Forge Neo. It downloads a model from Hugging Face but then throws an out-of-memory error when I upload a large image. What settings should I change?
Prompt 4
Create a workflow for using Image2Prompt to turn a photo of a real product into a Danbooru-tag style prompt, then send that prompt to Forge Neo's txt2img tab to generate a stylized version of the product.

Frequently asked questions

wtf is forge-neo-image2prompt?

An add-on for the SD WebUI Forge Neo image generator that looks at any picture and writes a text description of it, which you can then feed back into Forge Neo to create a new image.

What language is forge-neo-image2prompt written in?

Mainly Python. The stack also includes Python, Transformers, PyTorch.

What license does forge-neo-image2prompt use?

No license information is provided in the repository, so terms of use are unknown.

How hard is forge-neo-image2prompt to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is forge-neo-image2prompt for?

Mainly vibe coder.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.