fix(deps): pin full pyannote 3.x stack; doc uninstall audio 4.x

- Cap core/database/pipeline; use pyannote-audio==3.3.2 dist name
- README: resolve conflict with metrics 3 + numpy<2.2

Made-with: Cursor
This commit is contained in:
dosangyoon
2026-03-23 16:26:46 +09:00
parent 1c7e09ffcf
commit e74805f2fd
2 changed files with 22 additions and 3 deletions

View File

@@ -205,7 +205,17 @@ conda install -n ncue "numpy<2.2" -c conda-forge
이 저장소 `requirements.txt`에는 위와 같이 **`numpy<2.2`** 를 명시해 두었습니다. 이미 깨진 환경은 위처럼 한 번 재설치하면 됩니다.
**`pyannote-metrics 4.x` 와 NumPy 버전 경고**
`pyannote-metrics` 4.0.0 이상은 **`numpy>=2.2.2`** 를 요구해, 위 `numpy<2.2` 정책과 맞지 않습니다. `requirements-diarize.txt` 에서 **`pyannote-metrics>=3.2,<4`** 로 상한을 두어 3.x만 쓰도록 했습니다. 이미 4.x가 깔린 환경은 `git pull` `pip install -r requirements-diarize.txt` 를 다시 실행하거나 `pip install "pyannote-metrics>=3.2,<4" --force-reinstall` 하세요. (CPU가 **X86_V2를 지원**하고 NumPy 2.2+ 휠을 쓸 수 있다면, 팀 정책에 따라 `numpy` 상한을 올리고 metrics 4.x를 쓰는 선택도 가능합니다.)
`pyannote-metrics` 4.0.0 이상은 **`numpy>=2.2.2`** 를 요구해, 위 `numpy<2.2` 정책과 맞지 않습니다. `requirements-diarize.txt` 에서 **`pyannote-metrics>=3.2,<4`** 로 상한을 두고, **`pyannote-core` / `pyannote-database` / `pyannote-pipeline` 도 6대 미만 등 3.x 스택**에 맞게 캡해 두었습니다. (CPU가 **X86_V2를 지원**하고 NumPy 2.2+ 휠을 쓸 수 있다면, 팀 정책에 따라 `numpy` 상한을 올리고 metrics 4.x + `pyannote-audio` 4.x를 쓰는 선택도 가능합니다.)
**`pyannote-audio 4.x``pyannote-metrics 3.x` 충돌**
`pyannote-audio` 4.x 는 **`pyannote-metrics>=4`** 를 요구합니다. metrics 를 3.x로 두려면 **audio 도 3.3.2** 여야 합니다. 경고가 나오면:
```bash
pip uninstall -y pyannote-audio pyannote.audio
pip install -r requirements-diarize.txt
```
구형 CPU용으로 **`numpy<2.2`** 를 쓰는 경우, 위 설치 후 NumPy가 올라갔다면 `pip install "numpy>=1.26,<2.2" --force-reinstall` 로 다시 맞춥니다.
**같은 서버에서 빠른 점검**