fiftyone

环境要求

• Python 3.10 - 3.13
• 强烈建议在虚拟环境中安装，保持工作区干净
• 源码安装需额外准备 Node.js 与 Yarn（corepack enable）
• 处理视频数据集需额外安装 FFmpeg（可选）
• Windows 上不推荐使用 Microsoft Store 版 Python，请从 python.org 下载 64 位安装包

安装与启动步骤

1. 1准备 Python 环境

   确认 Python 版本在 3.10-3.13 之间；Windows 安装时勾选加入 PATH 并建议取消路径长度限制。官方强烈建议在虚拟环境中安装。

2. 2安装 FiftyOne

   官方推荐的安装方式，一条 pip 命令即可装上最新发布版。若装到虚拟环境中请先激活对应环境。

   pip install fiftyone

   复制

3. 3跑通快速上手

   打开 Python 交互环境执行下面代码，会自动下载 quickstart 小数据集并弹出 FiftyOne App 数据看板供浏览。

   import fiftyone as fo
   import fiftyone.zoo as foz
   
   dataset = foz.load_zoo_dataset("quickstart")
   session = fo.launch_app(dataset)

   复制

4. 4脚本中阻塞等待

   若把上面的代码写进脚本运行，需补上 session.wait()，否则脚本会立即结束、App 被关闭。

   session.wait()

   复制

5. 5源码安装（可选）

   需要开发版或参与贡献时使用。先克隆仓库，再运行仓库内的安装脚本（README 未展示脚本具体命令，请查看仓库内脚本）。

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

   复制

6. 6升级源码安装

   已做源码安装的，拉取 main 分支最新代码后重新运行安装脚本即可升级到最新版。

   git checkout main
   git pull

   复制

如何确认成功

Python 中 import fiftyone 无报错，运行快速上手代码后浏览器自动打开 FiftyOne App，并能看到 quickstart 数据集样本。

常见问题

注意事项

• README 未给出源码安装脚本的具体命令，该步骤需参照仓库内脚本与官方安装指南执行。
• 源码安装还需要 Node.js 和 Yarn，安装 Node 后可用 corepack enable 启用 Yarn。
• 在 Google Colab 中源码安装，需在单元格执行克隆与安装后重启运行时。
• 常见安装问题可查阅官方 installation guide（docs.voxel51.com/installation）。