Kokoro TTS

Kokoro TTS 은 다음을 기반으로 하는 오프라인 TTS 엔진입니다 Kokoro-82M 모델입니다. 영어, 일본어, 중국어를 포함한 여러 언어를 지원하며 GPU 없이 CPU에서 실행됩니다.

Kokoro TTS를 설치하는 방법은 두 가지가 있습니다: UV (권장) 또는 PIP.

UV로 설치하기 (권장)

UV는 모든 종속성을 격리된 환경에서 자동으로 처리하는 빠른 Python 패키지 관리자입니다.

1단계 - UV 설치

열기 PowerShell 그리고 다음 명령을 실행하세요:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

대체 설치 방법은 UV 설치 가이드.

2단계 - 설치 확인

설치가 완료되면 PowerShell을 다시 시작하고 다음을 실행하여 UV가 올바르게 설치되었는지 확인하세요:

uv --version

터미널에 설치된 UV 버전이 출력되어야 합니다.

3단계 - 리포지토리 클론 또는 다운로드

Git으로 클론 (권장)

만약 Git 이 설치되어 있다면 PowerShell을 열고 다음을 실행하세요:

git clone https://github.com/remsky/Kokoro-FastAPI.git
cd Kokoro-FastAPI

ZIP으로 다운로드

Git이 설치되어 있지 않은 경우 리포지토리를 수동으로 다운로드할 수 있습니다:

cd path\to\Kokoro-FastAPI

4단계 - Kokoro TTS 실행

CPU용 제공된 시작 스크립트를 사용하여 Kokoro TTS 서버를 시작하세요:

.\start-cpu.ps1

UV는 첫 실행 시 필요한 모든 종속성을 자동으로 설치합니다.

PIP로 설치하기

PIP를 사용하여 Kokoro TTS를 수동으로 설치하려면 다음 단계를 따르세요.

1단계 - 리포지토리 클론 또는 다운로드

Git으로 클론 (권장)

git clone https://github.com/remsky/Kokoro-FastAPI.git
cd Kokoro-FastAPI

ZIP으로 다운로드

Git이 설치되어 있지 않은 경우 리포지토리를 수동으로 다운로드할 수 있습니다:

cd path\to\Kokoro-FastAPI

2단계 - 종속성 설치

PIP를 사용하여 필요한 Python 패키지를 설치하세요:

pip install -r requirements.txt

3단계 - Kokoro TTS 실행

종속성이 설치되면 Kokoro TTS 서버를 시작하세요:

python -m uvicorn api.src.main:app --host 0.0.0.0 --port 8880

서버가 실행되면 웹 인터페이스에 다음에서 접속할 수 있습니다:

http://localhost:8880/web

API 문서는 다음에서도 확인할 수 있습니다:

http://localhost:8880/docs

Kokoro TTS 서버가 실행된 후 VNTranslator와 연결하려면 다음 단계를 따르세요:

로 이동 설정 -> 확장 기능 -> 텍스트 음성 변환
스크롤하여 Kokoro TTS 설정 섹션으로 이동
다음 항목을 입력하세요: 호스트 및 포트 실행 중인 Kokoro TTS 서버의 주소입니다. 기본값은 이미 다음으로 설정되어 있습니다:
- 호스트: http://localhost
- 포트: 8880

Kokoro TTS 서버가 실행 중인지 확인하세요 게임을 VNTranslator에서 실행하기 전에. 서버가 실행되지 않으면 TTS 재생이 작동하지 않습니다.