본문으로 건너뛰기

Whisper WebUI 설치 및 서비스 등록 가이드

등록일: 2025-06-10 3:36 수정일: 2026-05-05


1. 디렉토리 구조 및 준비​

  • Whisper WebUI 설치 경로: /app001/whisper-webui
  • 외장 HDD (음성 및 텍스트 데이터): /ext001/data001
  • 서버 내장 SSD (웹소스 및 기타 속도 민감 리소스): /data001
  • 통화 녹음 저장 위치: /ext001/data001/syncthing/data1/s23zz/Recordings
  • 변환된 텍스트 결과물:
    • 속도 중요 시: /data001/whisper/output
    • 그렇지 않다면: /ext001/data001/whisper/output ​

2. 의존 패키지 설치 (Ubuntu 기준)​

sudo apt update
sudo apt install python3-venv ffmpeg -y

​

3. 디렉토리 생성 및 권한 설정​

sudo mkdir -p /app001/whisper-webui
sudo mkdir -p /ext001/data001/whisper/output
sudo chown -R sleepzz:sleepzz /app001 /ext001/data001/whisper

​

4. Whisper WebUI 클론​

cd /app001
git clone [https://github.com/aadnk/whisper-webui.git](https://github.com/aadnk/whisper-webui.git)
cd whisper-webui

​

5. 가상환경 생성 및 활성화​

python3 -m venv venv-whisper
source venv-whisper/bin/activate

​

6. pip 최신화 및 requirements 설치 (가상환경 내)​

pip install --upgrade pip
pip install -r requirements.txt

​

7. Whisper WebUI 수동 실행 테스트 (가상환경 내)​

python app.py --server_port 7860 --output_dir /ext001/data001/whisper/output

​

8. 가상환경 비활성화​

deactivate

​

9. systemd 서비스 등록​

sudo nano /etc/systemd/system/whisper-webui.service

​

whisper-webui.service 내용:​

[Unit]
Description=Whisper WebUI Service
After=network.target
​
[Service]
User=sleepzz
WorkingDirectory=/app001/whisper-webui
ExecStart=/app001/whisper-webui/venv-whisper/bin/python /app001/whisper-webui/app.py --server_port 7860 --output_dir /ext001/data001/whisper/output
Restart=on-failure
RestartSec=5
​
[Install]
WantedBy=multi-user.target

​

10. 서비스 등록 및 시작​

sudo systemctl daemon-reexec
sudo systemctl daemon-reload
sudo systemctl enable whisper-webui
sudo systemctl start whisper-webui

​

11. 서비스 상태 확인​

sudo systemctl status whisper-webui

​

12. 추후 가상환경 재진입 시​

cd /app001/whisper-webui
source venv-whisper/bin/activate