Tasks

Image-to-Text

Image to text models output a text from a given image. Image captioning or optical character recognition can be considered as the most common applications of image to text.

Inputs
Image-to-Text Model
Output
Detailed description

a herd of giraffes and zebras grazing in a field

About Image-to-Text

Use Cases

Image Captioning

Image Captioning is the process of generating textual description of an image. This can help the visually impaired people to understand what's happening in their surroundings.

Optical Character Recognition (OCR)

OCR models convert the text present in an image, e.g. a scanned document, to text.

Inference

Image Captioning

You can use the 🤗 Transformers library's image-to-text pipeline to generate caption for the Image input.

from transformers import pipeline

captioner = pipeline("image-to-text", model="Salesforce/blip-image-captioning-base")
captioner("https://huggingface.co/datasets/Narsil/image_dummy/resolve/main/parrots.png")
## [{'generated_text': 'two birds are standing next to each other '}]

OCR

This code snippet uses Microsoft’s TrOCR, an encoder-decoder model consisting of an image Transformer encoder and a text Transformer decoder for state-of-the-art optical character recognition (OCR) on single-text line images.

from transformers import TrOCRProcessor, VisionEncoderDecoderModel

processor = TrOCRProcessor.from_pretrained('microsoft/trocr-base-handwritten')
model = VisionEncoderDecoderModel.from_pretrained('microsoft/trocr-base-handwritten')
pixel_values = processor(images="image.jpeg", return_tensors="pt").pixel_values

generated_ids = model.generate(pixel_values)
generated_text = processor.batch_decode(generated_ids, skip_special_tokens=True)[0]

You can use huggingface.js to infer image-to-text models on Hugging Face Hub.

import { HfInference } from "@huggingface/inference";

const inference = new HfInference(HF_TOKEN);
await inference.imageToText({
    data: await (await fetch("https://picsum.photos/300/300")).blob(),
    model: "Salesforce/blip-image-captioning-base",
});

Useful Resources

This page was made possible thanks to efforts of Sukesh Perla and Johannes Kolbe.

Compatible libraries

Image-to-Text demo
Models for Image-to-Text
Browse Models (716)

Note A powerful and accurate image-to-text model that can also localize concepts in images.

Note A powerful model that lets you have a conversation with the image.

Datasets for Image-to-Text
Browse Datasets (1,277)

No example dataset is defined for this task.

Note Contribute by proposing a dataset for this task !

Spaces using Image-to-Text

Note An application that compares various image captioning models.

Note A robust image captioning application.

Note An application that transcribes handwritings into text.

Note An application that can caption images and answer questions about a given image.

Note An application that can caption images and answer questions with a conversational agent.

Note An image captioning application that demonstrates the effect of noise on captions.

Metrics for Image-to-Text

No example metric is defined for this task.

Note Contribute by proposing a metric for this task !