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
FiftyOne Enterprise 🚀
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.
1. Install Python and other dependencies
These steps work on a clean install of Ubuntu Desktop 24.04, and should also
work on Ubuntu 24.04 and 22.04, and on Ubuntu Server:
Dive right into FiftyOne by opening a Python shell and running the snippet
below, which downloads a
small dataset
and launches the FiftyOne App
so you can explore it:
import fiftyone as fo
import fiftyone.zoo as foz
dataset = foz.load_zoo_dataset("quickstart")
session = fo.launch_app(dataset)
Then check out
this Colab notebook
to see some common workflows on the quickstart dataset.
Note that if you are running the above code in a script, you must include
session.wait() to block execution until you close the App. See
this page
for more information.
<img src="https://user-images.githubusercontent.com/25985824/106288517-2422e000-6216-11eb-871d-26ad2e7b1e59.png" height="20px"> key features 🔑
Native Annotation:
Create and edit 2D and 3D labels directly in the App or integrate with your
favorite annotation tools — then curate, QA, and iterate, all in one
platform.
Want to securely collaborate on billions of samples in the cloud and connect to
your compute resources to automate your workflows? Check out
FiftyOne Enterprise.
If you use FiftyOne in your research, feel free to cite the project (but only
if you love it 😊):
@article{moore2020fiftyone,
title={FiftyOne},
author={Moore, B. E. and Corso, J. J.},
journal={GitHub. Note: https://github.com/voxel51/fiftyone},
year={2020}
}
Ecosystem Role
Standard MoltPulse indexed agent.
Embed Badge
Show off your Pulse Score in your GitHub README to build trust and rank higher.
