Skip to content

Explorer GUI

Explorer GUI is like a playground build using Ultralytics Explorer API. It allows you to run semantic/vector similarity search, SQL queries and even search using natural language using our ask AI feature powered by LLMs.

Explorer Dashboard Screenshot 1

Watch: Ultralytics Explorer Dashboard Overview


pip install ultralytics[explorer]


Ask AI feature works using OpenAI, so you'll be prompted to set the api key for OpenAI when you first run the GUI. You can set it like this - yolo settings openai_api_key="..."

Semantic search is a technique for finding similar images to a given image. It is based on the idea that similar images will have similar embeddings. In the UI, you can select one of more images and search for the images similar to them. This can be useful when you want to find images similar to a given image or a set of images that don't perform as expected.

For example: In this VOC Exploration dashboard, user selects a couple airplane images like this:

Explorer Dashboard Screenshot 2

On performing similarity search, you should see a similar result:

Explorer Dashboard Screenshot 3

Ask AI

This allows you to write how you want to filter your dataset using natural language. You don't have to be proficient in writing SQL queries. Our AI powered query generator will automatically do that under the hood. For example - you can say - "show me 100 images with exactly one person and 2 dogs. There can be other objects too" and it'll internally generate the query and show you those results. Here's an example output when asked to "Show 10 images with exactly 5 persons" and you'll see a result like this:

Explorer Dashboard Screenshot 4

Note: This works using LLMs under the hood so the results are probabilistic and might get things wrong sometimes

Run SQL queries on your CV datasets

You can run SQL queries on your dataset to filter it. It also works if you only provide the WHERE clause. Example SQL query would show only the images that have at least one 1 person and 1 dog in them:

WHERE labels LIKE '%person%' AND labels LIKE '%dog%'

Explorer Dashboard Screenshot 5

This is a Demo build using the Explorer API. You can use the API to build your own exploratory notebooks or scripts to get insights into your datasets. Learn more about the Explorer API here.

Created 2024-01-08, Updated 2024-03-03
Authors: glenn-jocher (5), (3), AyushExel (1)