Florence 2 Large

🚀 Florence-2: Advancing a Unified Representation for a Variety of Vision Tasks

Florence-2 is an advanced vision foundation model that can handle a wide range of vision and vision - language tasks using a prompt - based approach.

📚 Documentation

This Hub repository contains a HuggingFace's transformers implementation of Florence - 2 model from Microsoft.

Florence - 2 is an advanced vision foundation model that uses a prompt - based approach to handle a wide range of vision and vision - language tasks. Florence - 2 can interpret simple text prompts to perform tasks like captioning, object detection, and segmentation. It leverages our FLD - 5B dataset, containing 5.4 billion annotations across 126 million images, to master multi - task learning. The model's sequence - to - sequence architecture enables it to excel in both zero - shot and fine - tuned settings, proving to be a competitive vision foundation model.

Resources and Technical Documentation:

• Florence - 2 technical report.
• [Jupyter Notebook for inference and visualization of Florence - 2 - large](https://huggingface.co/microsoft/Florence - 2 - large/blob/main/sample_inference.ipynb)

🚀 Quick Start

Use the code below to get started with the model.

import requests

from PIL import Image
from transformers import AutoProcessor, AutoModelForCausalLM 

model = AutoModelForCausalLM.from_pretrained("microsoft/Florence-2-large", trust_remote_code=True)
processor = AutoProcessor.from_pretrained("microsoft/Florence-2-large", trust_remote_code=True)

prompt = "<OD>"

url = "https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/transformers/tasks/car.jpg?download=true"
image = Image.open(requests.get(url, stream=True).raw)

inputs = processor(text=prompt, images=image, return_tensors="pt")

generated_ids = model.generate(
    input_ids=inputs["input_ids"],
    pixel_values=inputs["pixel_values"],
    max_new_tokens=1024,
    num_beams=3,
    do_sample=False
)
generated_text = processor.batch_decode(generated_ids, skip_special_tokens=False)[0]

parsed_answer = processor.post_process_generation(generated_text, task="<OD>", image_size=(image.width, image.height))

print(parsed_answer)

💻 Usage Examples

Basic Usage

First, let's define a function to run a prompt.

import requests

from PIL import Image
from transformers import AutoProcessor, AutoModelForCausalLM 

model = AutoModelForCausalLM.from_pretrained("microsoft/Florence-2-large", trust_remote_code=True)
processor = AutoProcessor.from_pretrained("microsoft/Florence-2-large", trust_remote_code=True)

url = "https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/transformers/tasks/car.jpg?download=true"
image = Image.open(requests.get(url, stream=True).raw)

def run_example(task_prompt, text_input=None):
    if text_input is None:
        prompt = task_prompt
    else:
        prompt = task_prompt + text_input
    inputs = processor(text=prompt, images=image, return_tensors="pt")
    generated_ids = model.generate(
      input_ids=inputs["input_ids"],
      pixel_values=inputs["pixel_values"],
      max_new_tokens=1024,
      num_beams=3
    )
    generated_text = processor.batch_decode(generated_ids, skip_special_tokens=False)[0]

    parsed_answer = processor.post_process_generation(generated_text, task=task_prompt, image_size=(image.width, image.height))

    print(parsed_answer)

Here are the tasks Florence - 2 could perform:

prompt = "<CAPTION>"
run_example(prompt)

prompt = "<DETAILED_CAPTION>"
run_example(prompt)

prompt = "<MORE_DETAILED_CAPTION>"
run_example(prompt)

task_prompt = "<CAPTION_TO_PHRASE_GROUNDING>"
results = run_example(task_prompt, text_input="A green car parked in front of a yellow building.")

prompt = "<OD>"
run_example(prompt)

prompt = "<DENSE_REGION_CAPTION>"
run_example(prompt)

prompt = "<REGION_PROPOSAL>"
run_example(prompt)

prompt = "<OCR>"
run_example(prompt)

prompt = "<OCR_WITH_REGION>"
run_example(prompt)

🔧 Technical Details

Florence - 2 Zero - shot performance

The following table presents the zero - shot performance of generalist vision foundation models on image captioning and object detection evaluation tasks. These models have not been exposed to the training data of the evaluation tasks during their training phase.

The following table continues the comparison with performance on other vision - language evaluation tasks.

Florence - 2 finetuned performance

We finetune Florence - 2 models with a collection of downstream tasks, resulting two generalist models Florence - 2 - base - ft and Florence - 2 - large - ft that can conduct a wide range of downstream tasks.

The table below compares the performance of specialist and generalist models on various captioning and Visual Question Answering (VQA) tasks. Specialist models are fine - tuned specifically for each task, whereas generalist models are fine - tuned in a task - agnostic manner across all tasks. The symbol "▲" indicates the usage of external OCR as input.

📄 License

This project is licensed under the MIT License.