The open-source tool for building high-quality datasets and computer vision models

---

Website • Docs • Try it Now • Getting Started Guides • Tutorials • Blog • Community

👋 hey there!

We created FiftyOne to supercharge your visual AI development by enabling you to visualize and label your data, evaluate your models, and maximize data and model quality more efficiently than ever before 🤝

If you're looking to scale to production-grade, collaborative, cloud-native enterprise workloads, check out Voxel51 🚀

  installation   💻

As simple as:

pip install fiftyone

Installation options

FiftyOne supports Python 3.10 - 3.13.

For most users, we recommend installing the latest release version of FiftyOne via pip as shown above.

If you want to contribute to FiftyOne or install the latest development version, then you can also perform a source install.

See the prerequisites section for system-specific setup information.

We strongly recommend that you install FiftyOne in a virtual environment to maintain a clean workspace.

Consult the installation guide for troubleshooting and other information about getting up-and-running with FiftyOne.

Source installations

Follow the instructions below to install FiftyOne from source and build the App.

You'll need the following tools installed:

• Python (3.10 - 3.13)
• Node.js - on Linux, we recommend using nvm to install an up-to-date version.
• Yarn - once Node.js is installed, you can enable Yarn via corepack enable

We strongly recommend that you install FiftyOne in a virtual environment to maintain a clean workspace.

If you are working in Google Colab, skip to here.

First, clone the repository:

git clone https://github.com/voxel51/fiftyone
cd fiftyone

Then run the install script:

# Mac or Linux
bash install.sh

# Windows
.\install.bat

If you run into issues importing FiftyOne, you may need to add the path to the cloned repository to your PYTHONPATH:

export PYTHONPATH=$PYTHONPATH:/path/to/fiftyone

Note that the install script adds to your nvm settings in your ~/.bashrc or ~/.bash_profile, which is needed for installing and building the App.

Upgrading your source installation

To upgrade an existing source installation to the bleeding edge, simply pull the latest main branch and rerun the install script:

git checkout main
git pull

# Mac or Linux
bash install.sh

# Windows
.\install.bat

Rebuilding the App

When you pull in new changes to the App, you will need to rebuild it, which you can do either by rerunning the install script or just running yarn build in the ./app directory.

Developer installation

If you would like to contribute to FiftyOne, you should perform a developer installation using the -d flag of the install script:

# Mac or Linux
bash install.sh -d

# Windows
.\install.bat -d

Although not required, developers typically prefer to configure their FiftyOne installation to connect to a self-installed and managed instance of MongoDB, which you can do by following these simple steps.

Source installs in Google Colab

You can install from source in Google Colab by running the following in a cell and then restarting the runtime:

%%shell

git clone --depth 1 https://github.com/voxel51/fiftyone.git
cd fiftyone

# Mac or Linux
bash install.sh

# Windows
.\install.bat

Generating documentation

See the docs guide for information on building and contributing to the documentation.

Uninstallation

You can uninstall FiftyOne as follows:

pip uninstall fiftyone fiftyone-brain fiftyone-db

System-specific setup

Follow the instructions for your operating system or environment to perform basic system setup before installing FiftyOne.

If you're an experienced developer, you've likely already done this.

This is the beginning of the README. Read the rest at the original. Read the full README ↗