git404hub

what is ml-ferret fr?

apple/ml-ferret — explained in plain English

Analysis updated 2026-06-24

8,687PythonAudience · researcherComplexity · 5/5LicenseSetup · hard

tl;dr

Apple research AI model that can accept a drawn region in an image as input and return answers that refer back to specific image locations, designed for spatial visual reasoning and UI understanding.

vibe map

mindmap
  root((Ferret))
    What it does
      Visual grounding
      Region-based QA
      Spatial references
    Components
      Ferret model
      GRIT dataset
      Ferret-Bench eval
      Ferret-UI variant
    Requirements
      Multiple 80GB GPUs
      Local server setup
      Research license
    Use Cases
      Spatial AI research
      UI understanding
      Grounding evaluation

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

what do people make with this?

VIBE 1

Research fine-grained visual grounding where a model answers questions about a specific drawn region

VIBE 2

Evaluate how well a vision model handles spatial references using Ferret-Bench

VIBE 3

Train or fine-tune a grounding model using the GRIT dataset of 1.1 million region-text examples

VIBE 4

Study AI understanding of UI screenshots and interface elements with Ferret-UI

what's the stack?

PythonPyTorch

how it stacks up fr

apple/ml-ferretpwr-solaar/solaarhardikvasa/google-images-download
Stars8,6878,6918,670
LanguagePythonPythonPython
Setup difficultyhardmoderateeasy
Complexity5/53/52/5
Audienceresearchergeneraldata

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

how do i run it?

Difficulty · hard time til it works · 1day+

Training requires 8 GPUs with 80 GB VRAM each, even the demo needs a compatible GPU and multiple running server processes.

Released for non-commercial research use only, cannot be used in commercial products or services.

in plain english

Ferret is a research project from Apple that explores a specific capability in AI vision models: the ability to point at a specific region of an image and ask questions about it, and to receive answers that also point back to specific locations in the image. Most AI image models can describe a whole image or answer general questions about it, but Ferret is designed to work with fine-grained references, such as a drawn box, a dot, or a freehand scribble, and respond by identifying where specific things are in the image. The project includes three components. The Ferret model is the core research model that accepts image regions as input and produces responses that refer to image locations. GRIT is a large dataset of about 1.1 million examples used to train the model on this type of grounding and referring task. Ferret-Bench is an evaluation dataset for testing how well models handle this combination of visual reasoning, knowledge, and spatial grounding. A follow-on version called Ferret-UI applies the same ideas specifically to user interface screenshots, enabling the model to understand and reason about buttons, menus, and other UI elements in a screen image. Using or running Ferret requires significant GPU resources. Training was done on 8 GPUs with 80 GB of memory each. To run the interactive demo, you need to download the model weights, set up several server processes locally, and have a compatible GPU available. The code and data are released for research use only under non-commercial licenses. The model was published at ICLR 2024 as a spotlight paper. This is an academic research release, not a finished product.

prompts (copy fr)

prompt 1
How do I set up the Ferret model locally to run the interactive demo, what GPU and server processes are required?
prompt 2
Walk me through how to use a freehand scribble as input to the Ferret model and get a spatially grounded response.
prompt 3
How does Ferret-UI differ from the base Ferret model, and what kinds of UI questions can it answer?
prompt 4
What is the GRIT dataset used for in Ferret, and how was it created?
prompt 5
How do I evaluate a vision model on Ferret-Bench to measure spatial grounding performance?

Frequently asked questions

what is ml-ferret fr?

Apple research AI model that can accept a drawn region in an image as input and return answers that refer back to specific image locations, designed for spatial visual reasoning and UI understanding.

What language is ml-ferret written in?

Mainly Python. The stack also includes Python, PyTorch.

What license does ml-ferret use?

Released for non-commercial research use only, cannot be used in commercial products or services.

How hard is ml-ferret to set up?

Setup difficulty is rated hard, with roughly 1day+ to a first successful run.

Who is ml-ferret for?

Mainly researcher.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.