빠른 시작
현재 설치된 Mac에서 서버를 실행하고, 아바타가 한국어로 말하는 첫 화면을 확인합니다.
이미 이 Mac에 VisionAI, Wav2Lip 모델과 샘플 아바타가 설치되어 있습니다. 기존 설치를 다시 내려받을 필요 없이 아래 순서로 시작하세요.
서버 실행
Finder에서 LiveTalking/run-mac.command를 실행합니다. 터미널에서는 다음 명령을 사용합니다. 작업 디렉터리는 GithubDev 기준입니다.
cd LiveTalking
./run-mac.command실행 파일은 .venv/bin/python app.py --config config-mac.yaml을 호출합니다. 서버가 이미 실행 중이라면 새 서버를 추가로 실행하지 말고 아래 주소로 접속하세요. 첫 시작에는 모델 준비 시간이 걸립니다.
연결하고 말하게 하기
- VisionAI 재생 화면을 엽니다.
- Avatar ID에
person_camera_20260917을 입력합니다. - Ref Audio에
ko-KR-InJoonNeural을 입력합니다. - Connect를 누르고 영상이 나타날 때까지 기다립니다.
- Text 칸에 아래 문장을 입력하고 Echo → Send를 누릅니다.
안녕하세요. 실시간으로 한국어를 말하는 아바타입니다.Echo는 입력 문장을 그대로 TTS로 읽습니다. Chat은 LLM이 만든 답변을 읽는 모드이므로 별도 LLM 설정이 필요합니다. 처음 확인할 때는 Echo를 사용하세요.
영상이 보이지만 정지해 있으면 영상의 재생 버튼을 누르세요. 소리가 들리지 않으면 탭과 재생 요소의 음소거 상태를 확인하세요. 브라우저의 자동 재생 정책에 따라 사용자 클릭이 필요할 수 있습니다.
음성 파일로 구동
텍스트 대신 이미 만들어진 WAV 또는 MP3를 사용할 수도 있습니다. Audio Driver → 파일 선택 → Upload & Play를 누릅니다. 이 경로는 업로드 음성을 사용하며 TTS 합성을 거치지 않습니다.
테스트 음성 파일은 LiveTalking/output/mac-test/korean-test.wav에 있습니다. 외부 TTS를 먼저 시험하려면 해당 서비스에서 음성 파일을 만들고 여기서 재생하면 됩니다. 파일 업로드는 지속적인 PCM 스트리밍 입력과 다른 방식입니다.
인물 변경과 종료
아바타 또는 연결 음성을 변경할 때는 Disconnect → 값 변경 → Connect 순서로 재접속합니다. 연결 설정을 입력하는 것만으로 현재 세션이 바뀌지는 않습니다.
현재 max_session: 1 설정이므로 연결 가능한 탭은 한 개입니다. 사용을 마치면 Disconnect를 눌러 세션을 해제하세요. 서버까지 종료하려면 서버 터미널에서 Ctrl+C를 누릅니다.
검증한 환경
| 항목 | 실제 확인값 |
|---|---|
| Mac | Apple M3 Pro, 18코어 GPU, 통합 메모리 18GB |
| 운영체제 | macOS 26.5.2 |
| Python / PyTorch | 3.12.13 / 2.9.1 |
| 립싱크 추론 | Wav2Lip, PyTorch MPS |
| 아바타 생성 전처리 | S3FD 얼굴 검출, CPU |
| 출력 | WebRTC, 1280×720, 약 25fps |
| 음성 | Edge TTS 한국어 InJoon / SunHi |
수치는 짧은 로컬 테스트의 결과입니다. 장시간 안정성, 동시 접속, MuseTalk, STT, LLM과 원격 접속은 이 테스트로 검증하지 않았습니다.
새 환경에 설치할 때
이 가이드의 빠른 시작 명령은 이미 구성된 현재 Mac에 적용됩니다. 다른 장비에서는 공식 설치 안내를 따라 의존성, 모델 가중치와 아바타를 먼저 준비해야 합니다.
Windows의 RTX 3090 24GB에서는 WSL 없이 Windows에 바로 설치해 CUDA로 실행되는 것을 확인했습니다. 설치 순서와 측정 결과는 Windows 실행을 참고하세요. 이 Mac용 가상 환경은 Windows에 복사해서 사용할 수 없으므로 새로 만들어야 합니다.