로컬 음성 인식·합성
최종 업데이트
Pocket TTS로 CPU에서 음성 만들기: 6개 언어 지원
영어·프랑스어·독일어·포르투갈어·이탈리아어·스페인어를 지원해요.
Pocket TTS1는 CPU2에서 텍스트를 음성으로 변환하는 약 100M 파라미터 모델이에요. Python API3와 CLI4가 있고, 공식 카드의 언어 목록은 영어·프랑스어·독일어·포르투갈어·이탈리아어·스페인어예요. 한국어와 일본어는 현재 목록에 없어 해당 언어의 TTS로 선택할 수 없어요.
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 -m pip install pocket-tts scipypython -m pip install "huggingface_hub[cli]"
hf download kyutai/tts-voices alba-mackenna/casual.wav --local-dir assetsfrom 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와 실행 조건을 지정한 사례이므로 내 기기의 약속된 성능은 아니에요. 내 작업에 쓸 원고 길이와 실제 하드웨어로 파일을 만들어 시작 대기와 전체 완료 시간을 따로 기록하세요.

브라우저 구현은 별도 경로로 확인해요
Pocket TTS의 공식 프로젝트에는 브라우저에서 실행하는 방법도 안내되어 있어요. CPU용 Python 설치와 웹 실행은 서로 다른 환경이므로 이 절차를 브라우저 설정으로 옮겨 쓰지 마세요. 브라우저에서 사용하려면 모델 카드의 in-browser implementations 항목에서 현재 구현과 언어 범위를 확인하세요. Pocket TTS 브라우저 구현 안내
가중치 라이선스와 사용 목적을 확인해요
현재 모델 카드에 표시된 라이선스는 CC-BY-4.0이에요. 모델 가중치와 생성물 사용 조건, 출처 표기 의무를 카드의 최신 원문으로 확인하세요. 로컬 실행은 오디오가 사용자의 기기에서 처리되도록 할 수 있지만, 입력할 음성과 목소리 사용 권한은 별도로 확인해야 해요.

용어 각주
음성 합성 — 텍스트를 발음과 운율을 가진 음성 신호로 변환하는 기술입니다.
본문으로 돌아가기CPU — 운영체제와 일반 프로그램 명령을 실행하고, AI에서는 전처리·데이터 이동 등 범용 연산을 맡는 중앙 처리 장치입니다.
본문으로 돌아가기API — 프로그램의 기능을 다른 코드에서 호출하기 위한 약속된 인터페이스입니다.
본문으로 돌아가기CLI — Command-Line Interface의 약자입니다. 터미널에 명령어를 입력해 프로그램을 조작하는 방식입니다.
본문으로 돌아가기PyTorch — AI 모델을 만들고 실행하는 소프트웨어 프레임워크입니다. 모델과 함께 호환되는 PyTorch 버전 및 하드웨어 지원도 확인해야 합니다.
본문으로 돌아가기GPU — 많은 계산을 병렬로 처리하는 프로세서입니다. AI 모델 실행에서는 모델 계산을 맡습니다.
본문으로 돌아가기Python 가상환경 — 프로젝트별로 Python 패키지를 분리해 설치하는 공간입니다. 패키지 버전 충돌을 줄이는 데 쓰입니다.
본문으로 돌아가기프롬프트 — 모델에 보내는 입력문입니다. 생성 모델에서는 만들 결과를 설명하는 문장이 되어 출력의 구성과 내용을 크게 좌우합니다.
본문으로 돌아가기
자주 묻는 질문
- 이 글에서 가장 먼저 확인할 것은 무엇인가요?
- 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)
