StyleTTS2 설치 및 사용 가이드 (Mac)

1# 1. Conda 가상환경 생성 (Python 3.10 권장)2conda create -n styletts2 python=3.103conda activate styletts24 5# 2. espeak-ng 설치 (phonemizer 의존성)6brew install espeak-ng7 8# 3. PyTorch 설치 (MPS 지원 포함)9pip install torch torchaudio10 11# 4. styletts2 패키지 설치12pip install styletts213 14# 5. pycrfsuite 아키텍처 호환성 문제 해결 (Mac 전용)15conda install -c conda-forge python-crfsuite

1# 1. 저장소 클론2git clone https://github.com/yl4579/StyleTTS2.git3cd StyleTTS24 5# 2. Conda 가상환경 생성6conda create -n styletts2 python=3.107conda activate styletts28 9# 3. espeak-ng 설치10brew install espeak-ng11 12# 4. PyTorch 설치 (Apple Silicon용 — CUDA 버전 설치 금지)13pip install torch torchaudio14 15# 5. 나머지 의존성 설치16pip install -r requirements.txt17 18# 6. pycrfsuite 호환성 수정19conda install -c conda-forge python-crfsuite

1# huggingface_hub 설치2pip install huggingface_hub3 4# Python으로 다운로드5python - <<'EOF'6from huggingface_hub import hf_hub_download, snapshot_download7 8# LJSpeech 모델 전체 다운로드9snapshot_download(10    repo_id="yl4579/StyleTTS2-LJSpeech",11    local_dir="./Models/LJSpeech"12)13print("LJSpeech 모델 다운로드 완료")14EOF

1python - <<'EOF'2from huggingface_hub import snapshot_download3 4snapshot_download(5    repo_id="yl4579/StyleTTS2-LibriTTS",6    local_dir="./Models/LibriTTS"7)8print("LibriTTS 모델 다운로드 완료")9EOF

1import torch2 3print(f"PyTorch 버전: {torch.__version__}")4print(f"MPS 사용 가능: {torch.backends.mps.is_available()}")5print(f"MPS 빌드 포함: {torch.backends.mps.is_built()}")6 7if torch.backends.mps.is_available():8    device = torch.device("mps")9    x = torch.ones(3, device=device)10    print(f"MPS 테스트 성공: {x}")11else:12    device = torch.device("cpu")13    print("MPS 불가 — CPU 모드로 실행됩니다.")

1import torch2from styletts2 import tts3 4# TTS 객체 초기화 (초기에는 CPU로 로드됨)5my_tts = tts.StyleTTS2()6 7# MPS 장치로 이동8if torch.backends.mps.is_available():9    device = torch.device("mps")10    # 내부 모델 컴포넌트를 MPS로 이동11    for key in my_tts.model:12        if hasattr(my_tts.model[key], 'to'):13            my_tts.model[key] = my_tts.model[key].to(device)14    print("모델을 MPS 장치로 이동 완료")

1from styletts2 import tts2 3# TTS 초기화 (첫 실행 시 모델 자동 다운로드)4my_tts = tts.StyleTTS2()5 6# 기본 음성으로 텍스트 합성7out = my_tts.inference(8    "Hello, this is a test of StyleTTS2 on Apple Silicon.",9    output_wav_file="output.wav"10)11 12print("음성 파일 생성 완료: output.wav")

1# 세밀한 제어를 위한 파라미터 설정2out = my_tts.inference(3    text="The quick brown fox jumps over the lazy dog.",4    output_wav_file="output_tuned.wav",5    alpha=0.3,            # 음색 제어 (높을수록 텍스트에 가까움, 기본값 0.3)6    beta=0.7,             # 운율 제어 (높을수록 텍스트에 가까움, 기본값 0.7)7    diffusion_steps=5,    # 품질/속도 트레이드오프 (높을수록 느리지만 고품질)8    embedding_scale=1.0   # 감정 강도 (높을수록 더 표현적)9)

1from styletts2 import tts2 3my_tts = tts.StyleTTS2()4 5# 음성 복제 — 참조 음성 파일 경로를 지정6out = my_tts.inference(7    text="이 문장은 참조 화자의 목소리로 합성됩니다.",8    target_voice_path="/path/to/reference_voice.wav",  # 참조 음성 경로9    output_wav_file="cloned_output.wav",10    diffusion_steps=10,   # 복제 품질을 위해 steps 증가 권장11    alpha=0.3,12    beta=0.7,13    embedding_scale=1.014)15 16print("음성 복제 완료: cloned_output.wav")

1# conda-forge에서 ARM64 네이티브 빌드로 재설치2conda install -c conda-forge python-crfsuite

1# espeak-ng 설치2brew install espeak-ng3 4# 설치 확인5espeak-ng --version6 7# 환경변수로 경로 지정 (필요 시)8export PHONEMIZER_ESPEAK_PATH=$(brew --prefix)/bin/espeak-ng9export PHONEMIZER_ESPEAK_LIBRARY=$(brew --prefix)/lib/libespeak-ng.dylib

1pip uninstall torch torchaudio2pip install torch torchaudio  # 기본 설치 = CPU+MPS 지원

1# 환경변수로 MPS 미지원 연산을 CPU에서 실행2import os3os.environ["PYTORCH_ENABLE_MPS_FALLBACK"] = "1"4 5import torch6# 이후 코드 실행