Skip to content

voxel51/fiftyone-plugins

Repository files navigation

FiftyOne Plugins ๐Ÿ”Œ๐Ÿš€

FiftyOne provides a powerful plugin framework that allows for extending and customizing the functionality of the tool.

With plugins, you can add new functionality to the FiftyOne App, create integrations with other tools and APIs, render custom panels, and add custom buttons to menus. You can even schedule long running tasks from within the App that execute on a connected workflow orchestration tool like Apache Airflow.

For example, here's a taste of what you can do with the @voxel51/brain plugin!

brain.mp4

Table of Contents

This repository contains a curated collection of FiftyOne Plugins, organized into the following categories:

  • Core Plugins: core functionality that all FiftyOne users will likely want to install. These plugins are maintained by the FiftyOne team
  • Voxel51 Plugins: non-core plugins that are officially maintained by the FiftyOne team
  • Example Plugins: these plugins exist to inspire and educate you to create your own plugins! Each emphasizes a different aspect of the plugin system
  • Community Plugins: third-party plugins that are contributed and maintained by the community. These plugins are not officially supported by the FiftyOne team, but they're likely awesome!

๐Ÿ”Œ๐Ÿค Contribute Your Own Plugin ๐Ÿš€๐Ÿš€

Want to showcase your own plugin here? See the contributing section for instructions!

Core Plugins

Name Description
@voxel51/annotation โœ๏ธ Utilities for integrating FiftyOne with annotation tools
@voxel51/brain ๐Ÿง  Utilities for working with the FiftyOne Brain
@voxel51/evaluation โœ… Utilities for evaluating models with FiftyOne
@voxel51/io ๐Ÿ“ A collection of import/export utilities
@voxel51/indexes ๐Ÿ“ˆ Utilities working with FiftyOne database indexes
@voxel51/plugins ๐Ÿงฉ Utilities for managing and building FiftyOne plugins
@voxel51/delegated ๐Ÿ“ก Utilities for managing your delegated operations
@voxel51/runs ๐Ÿƒ Utilities for managing your custom runs
@voxel51/utils โš’๏ธ Call your favorite SDK utilities from the App
@voxel51/zoo ๐ŸŒŽ Download datasets and run inference with models from the FiftyOne Zoo, all without leaving the App

Voxel51 Plugins

Name Description
@voxel51/voxelgpt ๐Ÿค– An AI assistant that can query visual datasets, search the FiftyOne docs, and answer general computer vision questions
@voxel51/mlflow ๐Ÿ“‹ Track model training experiments on your FiftyOne datasets with MLflow!

Example Plugins

Name Description
@voxel51/hello-world ๐Ÿ‘‹ An example of JavaScript and Python components and operators in a single plugin
@voxel51/python-view ๐Ÿ”Ž Create views in the FiftyOne App with Python
@voxel51/examples ๐Ÿ“‹ Examples of how to use the operator type system to build custom FiftyOne operations

Community Plugins

๐Ÿ”Œ๐Ÿค Contribute Your Own Plugin ๐Ÿš€๐Ÿš€

Want to showcase your own plugin here? See the contributing section for instructions!

Name Description
@jacobmarks/image_issues ๐ŸŒฉ๏ธ Find common image quality issues in your datasets
@jacobmarks/concept_interpolation ๐Ÿ“ˆ Find images that best interpolate between two text-based extremes!
@jacobmarks/text_to_image ๐ŸŽจ Add synthetic data from prompts with text-to-image models and FiftyOne!
@jacobmarks/twilio_automation ๐Ÿ“ฒ Automate data ingestion with Twilio!
@wayofsamu/line2d ๐Ÿ“‰ Visualize x,y-Points as a line chart.
@jacobmarks/vqa-plugin โ” Ask (and answer) open-ended visual questions about your images!
@jacobmarks/youtube_panel_plugin ๐Ÿ“บ Play YouTube videos in the FiftyOne App!
@jacobmarks/image_deduplication ๐Ÿชž Find exact and approximate duplicates in your dataset!
@jacobmarks/keyword_search ๐Ÿ”‘ Perform keyword search on a specified field!
@jacobmarks/pytesseract_ocr ๐Ÿ‘“ Run optical character recognition with PyTesseract!
@brimoor/pdf-loader ๐Ÿ“„ Load your PDF documents into FiftyOne as per-page images
@jacobmarks/zero_shot_prediction ๐Ÿ”ฎ Run zero-shot (open vocabulary) prediction on your data!
@jacobmarks/active_learning ๐Ÿƒ Accelerate your data labeling with Active Learning!
@jacobmarks/reverse_image_search โช Find the images in your dataset most similar to an image from filesystem or the internet!
@jacobmarks/concept_space_traversal ๐ŸŒŒ Navigate concept space with CLIP, vector search, and FiftyOne!
@jacobmarks/audio_retrieval ๐Ÿ”Š Find the images in your dataset most similar to an audio file!
@jacobmarks/semantic_document_search ๐Ÿ”Ž Perform semantic search on text in your documents!
@allenleetc/model-comparison โš–๏ธ Compare two object detection models!
@ehofesmann/filter_values ๐Ÿ”Ž Filter a field of your FiftyOne dataset by one or more values.
@jacobmarks/gpt4_vision ๐Ÿค– Chat with your images using GPT-4 Vision!
@swheaton/anonymize ๐Ÿฅธ Anonymize/blur images based on a FiftyOne Detections field.
@jacobmarks/double_band_filter filter icon Filter on two numeric ranges simultaneously!
@danielgural/semantic_video_search filter icon Semantically search through your video datasets using FiftyOne Brain and Twelve Labs!
@jacobmarks/emoji_search ๐Ÿ˜ Semantically search emojis and copy to clipboard!
@danielgural/img_to_video ๐Ÿฆ‹ Bring images to life with image to video!
@ehofesmann/edit_label_attributes โœ๏ธ Edit attributes of your labels directly in the FiftyOne App!
@danielgural/audio_loader ๐ŸŽง Import your audio datasets as spectograms into FiftyOne!
@jacobmarks/albumentations_augmentation ๐Ÿชž Test out any Albumentations data augmentation transform with FiftyOne!
@jacobmarks/image_captioning ๐Ÿ–‹๏ธ Caption all your images with state of the art vision-language models!
@jacobmarks/multimodal_rag ๐Ÿฆ™ Create and test multimodal RAG pipelines with LlamaIndex, Milvus, and FiftyOne!
@danielgural/optimal_confidence_threshold ๐Ÿ” Find the optimal confidence threshold for your detection models automatically!
@danielgural/outlier_detection โŒ Find those troublesome outliers in your dataset automatically!
@danielgural/clustering_algorithms ๐Ÿ•ต๏ธ Find the clusters in your data using some of the best algorithms available!
@jacobmarks/clustering ๐Ÿ‡ Cluster your images using embeddings with FiftyOne and scikit-learn!

Using Plugins

Install FiftyOne

If you haven't already, install FiftyOne:

pip install fiftyone

Installing a plugin

In general, you can install all plugin(s) in a GitHub repository by running:

fiftyone plugins download https://github.com/path/to/repo

For instance, to install all plugins in this repository, you can run:

fiftyone plugins download https://github.com/voxel51/fiftyone-plugins

You can also install a specific plugin using the --plugin-names flag:

fiftyone plugins download \
    https://github.com/voxel51/fiftyone-plugins \
    --plugin-names <name>

๐Ÿ’ก Pro tip: Some plugins require additional setup. Click the plugin's link and navigate to the project's README for instructions.

Plugin management

You can use the CLI commands below to manage your downloaded plugins:

# List all plugins you've downloaded
fiftyone plugins list

# List the available operators
fiftyone operators list

# Disable a particular plugin
fiftyone plugins disable <name>

# Enable a particular plugin
fiftyone plugins enable <name>

Local development

If you plan to develop plugins locally, you can clone the repository and symlink it into your FiftyOne plugins directory like so:

cd /path/to/fiftyone-plugins
ln -s "$(pwd)" "$(fiftyone config plugins_dir)/fiftyone-plugins"

Contributing

Showcasing your plugin ๐Ÿค

Have a plugin you'd like to share with the community? Awesome! ๐ŸŽ‰๐ŸŽ‰๐ŸŽ‰

Just follow these steps to add your plugin to this repository:

  1. Make sure your plugin repo has a README.md file that describes the plugin and how to install it
  2. Fork this repository
  3. Add an entry for your plugin to the Community Plugins table above
  4. Submit a pull request into this repository

Contributing to this repository ๐Ÿ™Œ

You're also welcome to contribute to the plugins that live natively in this repository. Check out the contributions guide for instructions.

Join the Community

If you want join a fast-growing community of engineers, researchers, and practitioners who love computer vision, join the FiftyOne Slack community ๐Ÿš€๐Ÿš€๐Ÿš€

๐Ÿ’ก Pro tip: the #plugins channel is a great place to discuss plugins!

About FiftyOne

If you've made it this far, we'd greatly appreciate if you'd take a moment to check out FiftyOne and give us a star!

FiftyOne is an open source library for building high-quality datasets and computer vision models. It's the engine that powers this project.

Thanks for visiting! ๐Ÿ˜Š