로컬 음성 인식·합성

최종 업데이트

Pocket TTS로 CPU에서 음성 만들기: 6개 언어 지원

영어·프랑스어·독일어·포르투갈어·이탈리아어·스페인어를 지원해요.

Pocket TTS1는 CPU2에서 텍스트를 음성으로 변환하는 약 100M 파라미터 모델이에요. Python API3와 CLI4가 있고, 공식 카드의 언어 목록은 영어·프랑스어·독일어·포르투갈어·이탈리아어·스페인어예요. 한국어와 일본어는 현재 목록에 없어 해당 언어의 TTS로 선택할 수 없어요.

실행 조건과 핵심 내용
  • 현재 지원 언어는 영어·프랑스어·독일어·포르투갈어·이탈리아어·스페인어예요.
  • 가벼운 CPU 중심 TTS로 Python API와 CLI를 제공해요.
  • 한국어·일본어는 아직 지원 언어에 포함되지 않아요.

CPU로 텍스트 음성을 만들어 파일로 저장해요

Pocket TTS는 Kyutai의 경량 TTS예요. Python 3.10 이상과 PyTorch5 2.5 이상을 요구하며 GPU6용 PyTorch 없이 CPU에서 실행할 수 있다고 문서가 안내해요. CLI 또는 Python API로 텍스트를 넣고 WAV를 저장하면 돼요. 공식 모델 카드와 설명서

펼쳐진 책과 작은 컴퓨터, 스피커가 놓인 책상
입력 언어를 정하고 짧은 문장으로 합성해요.

사용할 언어가 지원되는지 먼저 봐요

지원 언어는 영어, 프랑스어, 독일어, 포르투갈어, 이탈리아어, 스페인어예요. 한국어 안내 음성이나 일본어 내레이션이 필요하다면 Supertonic 3나 VoxCPM2를 비교하세요. 현재 언어 목록

Python API로 한 문장을 WAV에 저장해요

가상환경7에 pocket-tts와 WAV 저장용 scipy를 설치하고 Hugging Face에서 공식 음성 자산을 내려받아요. 아래 코드를 generate.py로 저장해 실행하면 assets/alba-mackenna/casual.wav를 음성 프롬프트8로 사용하고 output.wav를 현재 폴더에 저장합니다.

Python 패키지 설치
python -m pip install pocket-tts scipy
예제 음성 자산 다운로드
python -m pip install "huggingface_hub[cli]"
hf download kyutai/tts-voices alba-mackenna/casual.wav --local-dir assets
영어 음성 WAV 생성 예제
from pocket_tts import TTSModel
import scipy.io.wavfile

model = TTSModel.load_model()
voice = model.get_state_for_audio_prompt("assets/alba-mackenna/casual.wav")
audio = model.generate_audio(voice, "Hello, this is a short test.")
scipy.io.wavfile.write("output.wav", model.sample_rate, audio.numpy())
스크립트 실행
python generate.py

모델 카드의 속도 수치는 장비 조건과 함께 읽어요

카드는 MacBook Air M4 CPU에서 실시간보다 빠른 생성과 첫 오디오 대기 시간을 측정해 공개했어요. 측정값은 CPU와 실행 조건을 지정한 사례이므로 내 기기의 약속된 성능은 아니에요. 내 작업에 쓸 원고 길이와 실제 하드웨어로 파일을 만들어 시작 대기와 전체 완료 시간을 따로 기록하세요.

마이크와 헤드폰, 파형이 표시된 모니터가 있는 작업대
WAV에서 문장 흐름과 숫자 읽기를 점검해요.

브라우저 구현은 별도 경로로 확인해요

Pocket TTS의 공식 프로젝트에는 브라우저에서 실행하는 방법도 안내되어 있어요. CPU용 Python 설치와 웹 실행은 서로 다른 환경이므로 이 절차를 브라우저 설정으로 옮겨 쓰지 마세요. 브라우저에서 사용하려면 모델 카드의 in-browser implementations 항목에서 현재 구현과 언어 범위를 확인하세요. Pocket TTS 브라우저 구현 안내

가중치 라이선스와 사용 목적을 확인해요

현재 모델 카드에 표시된 라이선스는 CC-BY-4.0이에요. 모델 가중치와 생성물 사용 조건, 출처 표기 의무를 카드의 최신 원문으로 확인하세요. 로컬 실행은 오디오가 사용자의 기기에서 처리되도록 할 수 있지만, 입력할 음성과 목소리 사용 권한은 별도로 확인해야 해요.

헤드폰과 오디오 플레이어, 펼쳐진 노트가 놓인 책상
먼저 언어 목록을 보고 한국어 지원 여부를 확인해요.

용어 각주

  1. 음성 합성 — 텍스트를 발음과 운율을 가진 음성 신호로 변환하는 기술입니다.

    본문으로 돌아가기
  2. CPU — 운영체제와 일반 프로그램 명령을 실행하고, AI에서는 전처리·데이터 이동 등 범용 연산을 맡는 중앙 처리 장치입니다.

    본문으로 돌아가기
  3. API — 프로그램의 기능을 다른 코드에서 호출하기 위한 약속된 인터페이스입니다.

    본문으로 돌아가기
  4. CLI — Command-Line Interface의 약자입니다. 터미널에 명령어를 입력해 프로그램을 조작하는 방식입니다.

    본문으로 돌아가기
  5. PyTorch — AI 모델을 만들고 실행하는 소프트웨어 프레임워크입니다. 모델과 함께 호환되는 PyTorch 버전 및 하드웨어 지원도 확인해야 합니다.

    본문으로 돌아가기
  6. GPU — 많은 계산을 병렬로 처리하는 프로세서입니다. AI 모델 실행에서는 모델 계산을 맡습니다.

    본문으로 돌아가기
  7. Python 가상환경 — 프로젝트별로 Python 패키지를 분리해 설치하는 공간입니다. 패키지 버전 충돌을 줄이는 데 쓰입니다.

    본문으로 돌아가기
  8. 프롬프트 — 모델에 보내는 입력문입니다. 생성 모델에서는 만들 결과를 설명하는 문장이 되어 출력의 구성과 내용을 크게 좌우합니다.

    본문으로 돌아가기

자주 묻는 질문

이 글에서 가장 먼저 확인할 것은 무엇인가요?
Pocket TTS는 CPU에서 텍스트를 음성으로 변환하는 약 100M 파라미터 모델이에요. Python API와 CLI가 있고, 공식 카드의 언어 목록은 영어·프랑스어·독일어·포르투갈어·이탈리아어·스페인어예요. 한국어와 일본어는 현재 목록에 없어 해당 언어의 TTS로 선택할 수 없어요.
조건과 출처는 어디서 확인하나요?
Pocket TTS는 Kyutai의 경량 TTS예요. Python 3.10 이상과 PyTorch 2.5 이상을 요구하며 GPU용 PyTorch 없이 CPU에서 실행할 수 있다고 문서가 안내해요. CLI 또는 Python API로 텍스트를 넣고 WAV를 저장하면 돼요. [공식 모델 카드와 설명서](https://huggingface.co/kyutai/pocket-tts)