X-AnyLabeling的安装、配置指南

X-AnyLabeling的官方安装

官方安装教程：https://github.com/CVHub520/X-AnyLabeling/blob/main/docs/zh_cn/get_started.md

一、安装前的准备工作

1.1 前置条件

在开始之前，请确保您已安装以下前置条件：

步骤 0. 从官方网站下载并安装 Miniconda。

步骤 1. 创建一个 Python 3.8+ 版本的 conda 环境，并激活它。

conda create --name x-anylabeling python=3.9 -y
conda activate x-anylabeling

1.1.2 安装

可选功能安装

Note

如需使用以下高级功能，请参考相应文档安装额外依赖。

基于 Segment-Anything-2 的视频目标追踪：安装指南
基于 UPN 的目标候选框生成：安装指南
基于视觉和文本提示的交互式目标检测和分割：安装指南

步骤 0. 安装 ONNX Runtime。

# Install ONNX Runtime CPU
pip3 install onnxruntime

# Install ONNX Runtime GPU (CUDA 11.x)
pip3 install onnxruntime-gpu==x.x.x

# Install ONNX Runtime GPU (CUDA 12.x)
pip3 install onnxruntime-gpu --extra-index-url https://aiinfra.pkgs.visualstudio.com/PublicPackages/_packaging/onnxruntime-cuda-12/pypi/simple/

Important

对于 GPU 加速，请按照以下说明，确保您本地的 CUDA 和 cuDNN 版本与 ONNX Runtime 版本兼容，并安装需要依赖库，以确保 GPU 加速推理正常：
Ⅰ. CUDA Execution Provider
Ⅱ. Get started with ONNX Runtime in Python
Ⅲ. ONNX Runtime Compatibility

Note：
\quad
请注意，ONNX Runtime 的版本需大于等于 1.16.0。

步骤 1. 克隆代码仓库。

git clone https://github.com/CVHub520/X-AnyLabeling.git

1.1.3 启动

完成必要步骤后，使用以下命令生成资源：

pyrcc5 -o anylabeling/resources/resources.py anylabeling/resources/resources.qrc

为避免冲突，请执行以下命令卸载第三方相关包。

pip uninstall anylabeling -y

设置环境变量：

# Linux 或 macOS
export PYTHONPATH=/path/to/X-AnyLabeling
# Windows
set PYTHONPATH=C:\path\to\X-AnyLabeling

1.4 要运行应用程序，请执行以下命令：

您可以通过传递 --help 参数随时查看可用的选项。

python anylabeling/app.py

二、X-AnyLabeling在MacOS中实操遇到的问题

2.1：执行安装Git下载的第三方依赖包时，需先切换至Git下载文件的路径下

步骤 1. 克隆代码仓库。

git clone https://github.com/CVHub520/X-AnyLabeling.git

步骤 2: 安装 requirements.txt 文件。

对于不同的配置，X-AnyLabeling 提供了以下依赖文件：

依赖文件	操作系统	运行环境	可编译
requirements.txt	Windows/Linux	CPU	否
requirements-dev.txt	Windows/Linux	CPU	是
requirements-gpu.txt	Windows/Linux	GPU	否
requirements-gpu-dev.txt	Windows/Linux	GPU	是
requirements-macos.txt	MacOS	CPU	否
requirements-macos-dev.txt	MacOS	CPU	是

• 对于开发者，您应选择带有 *-dev.txt 后缀的选项进行安装。
• 如需启用 GPU 加速，您应选择带有 *-gpu.txt 后缀的选项进行安装。

使用以下命令安装必要的包，将 [xxx] 替换为适合您需求的安装包名称：

pip3 install -r requirements-[xxx].txt

问题一：执行安装第三方依赖包时，需要先将当前的路径切换至“/…/X-AnyLabeling”文件夹下

说明：在使用pip3 install -r requirements-[xxx].txt命令，执行安装第三方依赖包时，需要先将当前的路径切换至“/.../X-AnyLabeling”文件夹下，因为requirements-macos-dev.txt的文件均在Git复制后的X-AnyLabeling文件夹下。，以本电脑为例：

pwd   # 显示当前路径
(base) /Users/yangyang/X-AnyLabeling

ls
cd X-AnyLabeling  # 切换至其子文件夹下
/Users/leo/X-AnyLabeling

此外，对于 macOS 用户，你需要额外运行以下命令从 conda-forge 源安装特定版本的版本：

conda install -c conda-forge pyqt=5.15.9

2.2：启动运行应用程序时，Mac需切换至X-AnyLabeling下，并指定Python版本

正常情况下，在安装Python3.8以上版本的虚拟环境中，直接输入以下命令行即可成功启动程序。

python anylabeling/app.py

但是，由于Mac中本身既有python2.7又有python3.8以上版本，此时命令行执行运行脚本命令时，需要指定python版本的类型。

# 第一步：切换至X-AnyLabeling的安装文件夹下
cd /Users/yangyang/X-AnyLabeling
# 第二步：命令启动程序
python3 anylabeling/app.py