Install Windows CUDA runtime for STT

This commit is contained in:
2026-04-30 17:59:29 +09:00
parent 60dce65b0f
commit 4c7cef8c18
4 changed files with 77 additions and 8 deletions

View File

@@ -118,13 +118,7 @@ Discord 모드에서만 필수:
- `DEBUG_TEXT_EVENTS`
- `true`면 transcript/reply를 콘솔에 같이 출력
Windows에서 STT 시작 시 `cublas64_12.dll` 같은 CUDA 오류가 나면:
```env
LOCAL_STT_DEVICE=cpu
```
로 두면 바로 우회됩니다. 최신 코드는 `auto`일 때도 가능한 경우 CPU로 자동 fallback 합니다.
Windows에서 GPU STT를 쓰려면 `LOCAL_STT_DEVICE=auto` 그대로 두고 `bun run setup:local-ai`를 다시 실행하세요. 현재 스크립트는 `faster-whisper`와 함께 CUDA 12용 `cuBLAS`, `cuDNN` 런타임 wheel도 같이 설치합니다. 그래도 `cublas64_12.dll` 또는 `cudnn` 오류가 남으면 시스템에 Visual C++ 런타임이 빠졌거나, 별도 CUDA 설치 경로가 PATH에 안 잡힌 경우입니다.
## 속도 우선 기본값
@@ -156,7 +150,7 @@ OLLAMA_MODEL=qwen3:1.7b
- Windows는 TTS를 Python 모델 대신 시스템 기본 음성 엔진으로 처리합니다.
- 출력 장치 직접 선택은 아직 미구현이라 시스템 기본 출력 장치로 재생됩니다.
- Python 탐지가 안 되면 `.env``LOCAL_AI_PYTHON=python` 또는 `LOCAL_AI_PYTHON=py -3` 를 넣으면 됩니다.
- Windows의 `setup:local-ai`는 STT 설치합니다.
- Windows의 `setup:local-ai`는 STT와 CUDA 런타임 wheel을 함께 설치합니다.
- Linux/macOS의 `setup:local-ai`는 Kokoro ONNX 모델 파일도 자동으로 내려받습니다.
## 설계 메모