Whisper-Diarization项目在macOS Sequoia上的安装指南

在macOS Sequoia系统上安装Whisper-Diarization项目时，开发者可能会遇到一些依赖问题。本文详细介绍了完整的安装流程，帮助开发者顺利搭建项目环境。

环境准备

首先需要确保系统已安装Homebrew包管理器。通过Homebrew安装必要的依赖项：

brew install python@3.10 ffmpeg

这里选择Python 3.10版本是因为项目对该版本有较好的兼容性。FFmpeg是处理音频文件必不可少的工具。

创建虚拟环境

使用Python 3.10创建独立的虚拟环境可以避免与其他项目的依赖冲突：

python3.10 -m venv .venv
source .venv/bin/activate

安装基础依赖

在激活虚拟环境后，首先升级pip、setuptools和wheel这三个基础工具：

pip install --upgrade pip setuptools wheel

然后安装Cython，这是编译某些Python扩展模块所需的工具：

pip install Cython

安装项目依赖

安装项目requirements.txt文件中列出的所有依赖：

pip install -r requirements.txt

解决特定依赖冲突

目前项目中存在一个已知的依赖冲突问题，需要手动降级huggingface_hub库的版本：

pip uninstall huggingface_hub
pip install huggingface_hub==0.20.3

这个步骤是临时的解决方案，等待上游NeMo项目更新后可能就不再需要。

验证安装

完成上述步骤后，建议运行项目提供的示例脚本或测试用例来验证安装是否成功。如果遇到其他问题，可以检查虚拟环境是否激活正确，以及所有依赖项是否安装完整。

通过遵循这些步骤，开发者应该能够在macOS Sequoia系统上成功搭建Whisper-Diarization项目的开发环境。记得定期检查项目更新，以获取最新的依赖解决方案和功能改进。