# Pocket TTS 100M (음성 모델)

> Kyutai의 Pocket TTS 100M을 로컬에서 실행합니다: 영어, 프랑스어, 독일어, 스페인어, 이탈리아어, 포르투갈어용 체크포인트가 각각 하나씩, 언어별 프리셋 음성 15개 또는 대본 없이 짧은 클립으로 음성 복제가 가능합니다. audio.cpp로 CPU에서 실시간보다 빠릅니다. CC-BY-4.0: 저작자 표시를 조건으로 상업적 사용이 가능하며, Kyutai의 사용 약관을 따릅니다.

- Id: `aigd.tts-pocket`
- 소스: 공식 (자사 `aigd.*`)
- 카테고리: 오디오
- 게시자: AI Game Dev (`aigd`), 인증됨
- 최신 버전: 1.0.2 (2026-11-22 게시)
- 라이선스: CC-BY-4.0
- AI Game Dev 앱 필요: `>=0.32.0-beta.6`
- 네이티브 코드: 아니요
- 평점: 아직 평가 없음
- HTML 페이지: https://ai-game.dev/ko/packages/aigd.tts-pocket

## 설치

gamedev CLI를 사용한다면 프로젝트 폴더에서:

```bash
gamedev pkg add aigd.tts-pocket
```

데스크톱 앱에서 Packages 창을 열고(상태 표시줄의 패키지 아이콘) **Browse**를 선택한 뒤 `aigd.tts-pocket`를 검색하고 **Add to Project**를 클릭합니다. 자세히: https://ai-game.dev/docs/wiki/app/packages

## 버전

| 버전 | 게시일 | 앱 필요 | 참고 |
|---|---|---|---|
| 1.0.2 | 2026-11-22 | `>=0.32.0-beta.6` | 최신 |
| 1.0.1 | 2026-11-21 | `>=0.32.0-beta.6` | - |

## 설명

````markdown
# Pocket TTS 100M (`aigd.tts-pocket`)

Pocket TTS 100M은 Kyutai의 소형 텍스트-음성 변환 모델로, 언어별로 체크포인트가 하나씩 있습니다: 영어, 프랑스어, 독일어, 스페인어, 이탈리아어, 포르투갈어. 각 언어에는 Kyutai의 프리셋 음성 15개가 함께 제공되며, 짧은 클립만으로 대본 없이 음성을 복제할 수 있습니다. AI Game Dev에서는 **Local audio generation**(`aigd.audiocpp`, audio.cpp)을 통해 어떤 컴퓨터에서든 실행되고, CPU에서도 실시간보다 빠릅니다. CC-BY-4.0 라이선스는 저작자 표시를 조건으로 상업적 사용을 허용하므로, 일반 하드웨어에서 주요 유럽 언어로 현지화하는 게임에 적합합니다.

## 만들 수 있는 것

- NPC 대사와 내레이션을 영어, 프랑스어, 독일어, 스페인어, 이탈리아어, 포르투갈어로 만들 수 있습니다.
- 언어별 프리셋 음성 15개, 또는 3–30초 클립에서 복제한 음성(화자의 동의 필요)으로 캐릭터 캐스트를 구성할 수 있습니다.
- CPU에서 빠르게 생성되는 현지화된 튜토리얼 대사와 UI 안내 멘트를 만들 수 있습니다.

## 요청 예시

- "대장장이의 대사를 프랑스어로 `marius` 음성으로 읽어 주세요."
- "`Audio/ref/me.wav`를 복제해서 인트로의 독일어 버전을 읽어 주세요."
- "튜토리얼 힌트의 스페인어와 이탈리아어 버전을 `alba`로 만들어 주세요."

## 주요 특징

|  |  |
|---|---|
| 모델 id | `aigd.tts-pocket.en-q8-0`, `.fr-q8-0`, `.de-q8-0`, `.es-q8-0`, `.it-q8-0`, `.pt-q8-0` (각각 별도 다운로드) |
| 언어 | en, fr, de, es, it, pt (각각 하나의 체크포인트) |
| 음성 | 언어별 프리셋 15개(기본 `alba`), 또는 3–30초 클립 복제(대본 불필요) |
| 출력 | 24 kHz |
| 요청당 텍스트 | 최대 4,000자 |
| 실행 환경 | 모든 컴퓨터: CPU(Kyutai 기준 2코어에서 실시간 대비 약 6배) 또는 GPU |
| 다운로드 | 언어당 0.23 GB, 파일 16개 |
| 라이선스 | CC-BY-4.0, 저작자 표시를 조건으로 상업적 사용 가능, Kyutai 이용 약관 적용 |

## 실행 방식

이 패키지는 데이터만 담고 있으며 모델 파일을 지정합니다. 라이선스에 동의하면 앱이 Hugging Face에서 파일을 내려받고, 각 파일을 sha256으로 검증한 뒤, 사용자의 컴퓨터에서 **Local audio generation**(`aigd.audiocpp`, audio.cpp)으로 실행합니다.

## 다운로드

- **Pocket TTS 100M (영어)** (`aigd.tts-pocket.en-q8-0`): 0.23 GB, [`audio-cpp/audio.cpp-gguf`](https://huggingface.co/audio-cpp/audio.cpp-gguf/tree/b7b9aa1f16c819c3b2d69a602b51786bdfb361a3)에서 받은 파일 16개, 해당 커밋에 고정.
- **Pocket TTS 100M (프랑스어)** (`aigd.tts-pocket.fr-q8-0`): 0.23 GB, [`audio-cpp/audio.cpp-gguf`](https://huggingface.co/audio-cpp/audio.cpp-gguf/tree/b7b9aa1f16c819c3b2d69a602b51786bdfb361a3)에서 받은 파일 16개, 해당 커밋에 고정.
- **Pocket TTS 100M (독일어)** (`aigd.tts-pocket.de-q8-0`): 0.23 GB, [`audio-cpp/audio.cpp-gguf`](https://huggingface.co/audio-cpp/audio.cpp-gguf/tree/b7b9aa1f16c819c3b2d69a602b51786bdfb361a3)에서 받은 파일 16개, 해당 커밋에 고정.
- **Pocket TTS 100M (스페인어)** (`aigd.tts-pocket.es-q8-0`): 0.23 GB, [`audio-cpp/audio.cpp-gguf`](https://huggingface.co/audio-cpp/audio.cpp-gguf/tree/b7b9aa1f16c819c3b2d69a602b51786bdfb361a3)에서 받은 파일 16개, 해당 커밋에 고정.
- **Pocket TTS 100M (이탈리아어)** (`aigd.tts-pocket.it-q8-0`): 0.23 GB, [`audio-cpp/audio.cpp-gguf`](https://huggingface.co/audio-cpp/audio.cpp-gguf/tree/b7b9aa1f16c819c3b2d69a602b51786bdfb361a3)에서 받은 파일 16개, 해당 커밋에 고정.
- **Pocket TTS 100M (포르투갈어)** (`aigd.tts-pocket.pt-q8-0`): 0.23 GB, [`audio-cpp/audio.cpp-gguf`](https://huggingface.co/audio-cpp/audio.cpp-gguf/tree/b7b9aa1f16c819c3b2d69a602b51786bdfb361a3)에서 받은 파일 16개, 해당 커밋에 고정.

## 지원 컴퓨터

어떤 컴퓨터에서든 실행됩니다. CPU에서도 실시간보다 빠르게 말합니다(Kyutai 기준 2코어에서 실시간 대비 약 6배). 언어마다 별도로 다운로드합니다.

## 음성과 언어

- 여섯 개 체크포인트(영어 `en`, 프랑스어 `fr`, 독일어 `de`, 스페인어 `es`, 이탈리아어 `it`, 포르투갈어 `pt`)는 각각 자기 언어 하나를 동일한 15개 음성으로 말합니다: alba, anna, azelma, bill_boerst, caro_davy, charles, eponine, estelle, eve, george, jane, marius, mary, michael, paul. 클립에서 음성 복제도 가능합니다.

이 패키지에는 녹음이 CC-BY-4.0 또는 CC0인 프리셋 음성만 포함됩니다(라이선스 항목 참고). Kyutai의 음성 cosette(Expresso)와 jean(EARS)은 비상업용이므로 포함되지 않습니다.

## 라이선스

CC-BY-4.0. Kyutai에 대한 저작자 표시를 하면 상업적 사용이 허용됩니다. Kyutai는 화자의 동의 없는 음성 복제와 기타 유해한 사용을 금지합니다. Kyutai의 자체 저장소는 해당 약관에 동의할 것을 요구하지만, 이 패키지가 다운로드하는 미러는 그렇지 않으므로 앱이 다운로드 전에 동의를 요청합니다.

- Kyutai의 Pocket TTS: [모델 카드](https://huggingface.co/kyutai/pocket-tts), CC-BY-4.0; 라이선스 전문: [CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/legalcode).
- 이 패키지의 모든 파일은 [`audio-cpp/audio.cpp-gguf`](https://huggingface.co/audio-cpp/audio.cpp-gguf)에서 가져왔습니다: CC-BY-4.0 (상위 라이선스; audio.cpp의 Kyutai 체크포인트 및 음성 상태 변환물). audio.cpp의 계열별 라이선스 표: [model_licenses.md](https://github.com/0xShug0/audio.cpp/blob/v0.9.5/docs/model_licenses.md).
- Pocket TTS GGUF(audio.cpp 변환): CC-BY-4.0 ([출처](https://github.com/0xShug0/audio.cpp/blob/v0.9.5/docs/model_licenses.md)).
- 프리셋 음성: VCTK(anna, azelma, charles, eponine, eve, george, jane, mary, michael, paul) 및 Alba MacKenna(alba): CC-BY-4.0 ([출처](https://huggingface.co/kyutai/tts-voices)).
- 프리셋 음성: Voice-Zero/LibriVox(bill_boerst, caro_davy), Kyutai 녹음(estelle), 음성 기증(marius): CC0 ([출처](https://huggingface.co/kyutai/tts-voices)).

필수 저작자 표시: "Pocket TTS by Kyutai (kyutai/pocket-tts), CC-BY-4.0; GGUF conversion by audio.cpp (audio-cpp/audio.cpp-gguf)."

제한 사항:

- 모델 파일이나 수정본을 배포하는 경우 Kyutai(Pocket TTS)와 음성 출처를 명시하고 CC-BY-4.0 고지를 유지해야 합니다.
- Kyutai의 약관은 화자의 동의 없는 음성 복제, 사칭, 사기 및 기타 유해한 사용을 금지합니다.

다운로드한 모델의 라이선스를 준수할 책임은 사용자에게 있습니다. 모든 파일은 Hugging Face에서 다운로드되며, AI Game Dev는 이를 호스팅하지 않습니다.
````
