GPT-SoVITS - RuntimeError: Could not load libtorchcodec 에러관해

1. python webui.py 명령어로 Web UI를 실행한 뒤, TTS(음성 합성)를 시도하는 과정에서 오류가 발생.

 

발생 시점: 참고 오디오 파일을 로드하는 과정 (torchaudio.load 함수 호출 시)

Traceback (most recent call last):
  ...
  File "/hdd2/GPT-SoVITS/GPT_SoVITS/inference_webui.py", line 524, in get_spepc
    audio, sr0 = torchaudio.load(filename, backend="soundfile")
  ...
  File "/hdd2/GPT-SoVITS/yes/envs/GPTSoVits/lib/python3.10/site-packages/torchcodec/_core/ops.py", line 69, in load_torchcodec_shared_libraries
    raise RuntimeError(
RuntimeError: Could not load libtorchcodec.

 

 

2. 진단: FFmpeg 설치 문제로 추정

오류 로그에 FFmpeg version 5: Could not load this library...라는 내용이 포함되어 있어, FFmpeg 라이브러리 설치 또는 가상환경 경로 문제로 생각.

 

이에 (GPTSoVits) 가상환경에서 ffmpeg -version 명령어를 실행하였고, ffmpeg version 5.0.1이 정상적으로 설치 및 인식됨을 확인했습니다.

 

결론: FFmpeg 자체의 설치 문제는 아니었습니다.

 

3. 두번째 진단: torchcodec와 PyTorch 2.9.0 비호환성

PyTorch가 FFmpeg를 사용하기 위해 호출하는 torchcodec 라이브러리 로드 실패?

 

torchcodec란?
PyTorch 2.9.0 및 torchaudio 2.9.0 버전부터 도입된 새로운 미디어(오디오/비디오) 로딩 라이브러리입니다.
시스템에 설치된 FFmpeg를 사용하여 오디오 파일을 디코딩하는 인터페이스 역할을 합니다.

 

오류 로그는 문제의 원인을 다음과 같이 명시
The PyTorch version (2.9.0+cu126) is not compatible with this version of TorchCodec.

 

4. 해결 조치: PyTorch 2.8.0으로 다운그레이드

 

기존 PyTorch 및 관련 패키지 삭제:

pip uninstall torch torchaudio torchvision torchcodec -y

 

호환되는 PyTorch 2.8.0 버전 설치 (CUDA 12.6 기준):

pip install torch==2.8.0 torchvision==0.23.0 torchaudio==2.8.0 --index-url [https://download.pytorch.org/whl/cu126](https://download.pytorch.org/whl/cu126)

 

5. 결론: torchcodec 우회를 통한 문제 해결
PyTorch를 2.8.0 버전으로 다운그레이드한 후, TTS 기능이 정상적으로 작동함을 확인했습니다.

성공 원인:
torchaudio 2.8.0 버전은 torchcodec 라이브러리를 사용하지 않습니다.
대신 soundfile과 같은 기존의 안정적인 오디오 백엔드를 사용하여 오디오 파일을 로드합니다.
즉, PyTorch 버전을 낮춤으로써 문제가 발생한 torchcodec 모듈의 실행 자체를 우회하여 문제를 해결했습니다.
pip show torchcodec 실행 시 Package(s) not found라는 메시지가 뜨는 것은, PyTorch 2.8.0 환경에서는 torchcodec가 필요 없으므로 정상적인 상태입니다.