FastDup 项目安装指南：跨平台详细教程-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00807/article/details/148970606

FastDup 项目安装指南：跨平台详细教程

fastdup fastdup is a powerful free tool designed to rapidly extract valuable insights from your image & video datasets. Assisting you to increase your dataset images & labels quality and reduce your data operations costs at an unparalleled scale. 项目地址: https://gitcode.com/gh_mirrors/fa/fastdup

项目简介

FastDup 是一个高效的计算机视觉工具，专注于大规模图像和视频数据集的分析与处理。它能够在多种操作系统上运行，包括 Ubuntu、MacOS、CentOS、Amazon Linux 和 Windows 等。本文将详细介绍在不同平台上的安装方法和常见问题解决方案。

系统要求

FastDup 支持以下平台：

Ubuntu 20.04/18.04 LTS
Mac OS X（Intel 和 M1/M2 芯片）
CentOS 7.9
Amazon Linux 2
Windows 10 Server（通过 WSL）

硬件要求：

仅需 CPU（无需 GPU 支持）
建议使用 Python 3.7、3.8 或 3.9 版本

各平台安装指南

Ubuntu 20.04/18.04 安装

更新系统软件包：

sudo apt update

安装必要依赖：

sudo apt -y install software-properties-common
sudo add-apt-repository -y ppa:deadsnakes/ppa
sudo apt update

安装 Python 3.8 和相关工具：

sudo apt -y install python3.8 python3-pip libgl1-mesa-glx
python3.8 -m pip install --upgrade pip

安装 FastDup：

python3.8 -m pip install fastdup

Mac OS 安装

安装必要依赖：

brew install ffmpeg@4

注意事项：

使用 conda 时，确保安装对应芯片架构的版本（M1/M2 芯片需安装 ARM 版本）
使用 pyenv 时，推荐使用 Python 3.8 或更高版本

CentOS 7/Amazon Linux 2 安装

安装基础开发工具：

sudo yum -y install epel-release
sudo yum -y update
sudo yum -y groupinstall "Development Tools"

安装必要依赖：

sudo yum -y install openssl-devel bzip2-devel libffi-devel xz-devel wget
sudo yum install redhat-lsb-core ffmpeg ffmpeg-devel

对于 Amazon Linux 2 额外需要：

sudo yum install mesa-libGL -y

下载并安装 FastDup 的 whl 包：

python3.7 -m pip install <下载的whl文件路径>

Windows 10 Server 安装（通过 WSL）

启用 WSL 功能（以管理员身份运行 PowerShell）：

Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux
Enable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform

重启系统后，安装 Ubuntu 20.04
在 Ubuntu 环境中安装 Python 和 FastDup：

sudo apt update
sudo apt -y install python3.9 python3-pip libgl1-mesa-glx
python3.9 -m pip install fastdup

安装方法选择

通过 PyPI 安装（推荐）

适用于大多数平台（除 CentOS 7.9/RedHat 4.8）：

python3.8 -m pip install -U pip
python3.8 -m pip install fastdup

通过稳定版本安装

适用于 CentOS 7.9/RedHat 4.8 等特殊系统：

python3.8 -m pip install *.whl

Debian 包安装

sudo dpkg -i fastdup-<版本号>-ubuntu-20.04.deb

容器化安装方式

从公共镜像仓库拉取镜像

docker pull karpadoni/fastdup-ubuntu-20.04

自行构建容器镜像

docker build -f Dockerfile -t fastdup-ubuntu .

常见问题及解决方案

不支持的平台错误：
- 确认系统版本是否符合要求
- 确保使用正确的 Python 版本（3.8 或 3.9）
- 更新 pip 工具：python3.8 -m pip install -U pip
Ubuntu 上的 libGL 错误：
```
sudo apt -y install libgl1-mesa-glx
```

Mac 上的 OpenMP 冲突：

安装无 MKL 支持的包：

conda install nomkl numpy scipy pandas tensorflow
conda remove mkl mkl-service

Mac M1 上的 cv2 导入错误：
- 降级 OpenCV 版本：
```
python3.8 -m pip install -U opencv-python==4.5.5.64
```

Mac 上的 ffmpeg 库错误：

brew remove ffmpeg
brew install ffmpeg@4

最佳实践建议

对于生产环境，建议使用 Ubuntu 20.04 LTS 系统
优先使用 PyPI 安装方式，除非系统特殊要求
在 Mac 平台上，推荐使用 Homebrew 管理依赖
对于 Windows 用户，WSL 2 能提供更好的性能
定期检查并更新 FastDup 到最新版本以获得最佳性能和功能

通过遵循上述指南，您应该能够顺利地在各种平台上安装并运行 FastDup 工具。如果在安装过程中遇到任何问题，可以参考常见问题部分或查阅相关文档获取更多帮助。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考