# Chatterbox Turbo (음성 모델)

> Resemble AI의 빠른 로컬 영어 텍스트 음성 변환(350M)입니다. 모델 자체 음성 또는 5-30초 클립에서 복제한 음성을 쓰며, 텍스트에 \[laugh\], \[chuckle\], \[cough\] 같은 사운드 태그를 넣을 수 있습니다. 캐릭터 대사와 내레이션에 적합합니다. GPU 또는 CPU에서 llama.cpp로 실행됩니다. MIT, 상업적 사용 허용.

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

## 설치

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

```bash
gamedev pkg add aigd.tts-chatterbox-turbo
```

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

## 버전

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

## 설명

````markdown
# Chatterbox Turbo (`aigd.tts-chatterbox-turbo`) 음성 모델

Chatterbox Turbo는 Resemble AI의 [Chatterbox Turbo](https://huggingface.co/ResembleAI/chatterbox-turbo)(350M)입니다. 모델 자체 음성 또는 짧은 클립에서 복제한 음성으로 빠른 영어 텍스트 음성 변환을 제공합니다. 텍스트에 `[laugh]`, `[chuckle]`, `[cough]` 같은 태그를 넣으면 해당 소리가 추가됩니다. AI Game Dev에서는 **Local speech**(`aigd.llamacpp`, llama.cpp)를 통해 GPU 또는 CPU에서 내 컴퓨터로 실행됩니다. 원하는 음성으로 생생한 캐릭터 대사를 원하는 영어 게임에 적합합니다.

## 만들 수 있는 것

- 5–30초 클립(예: 본인 음성 또는 이에 동의한 배우의 음성)에서 복제한 음성으로 영어 캐릭터 대사를 만들 수 있어, 등장인물들이 많은 대사에서도 일관된 목소리를 유지합니다.
- 웃음, 낄낄거림, 기침 같은 비언어적 소리를 대사 안에 인라인으로 적어 넣은 대사.
- 클립을 제공하지 않으면 모델에 내장된 음성으로 내레이션과 보이스오버를 만들 수 있습니다.

## 요청 예시

- “`Audio/ref/captain.wav`을 음성으로 사용해 ‘Hold the line! [cough] They're coming.’라고 말해 주세요.”
- “선술집 주인의 인사말을 마지막에 낄낄거리는 소리를 넣어 음성으로 만들어 주세요.”
- “복제한 음성으로 악당의 도발 대사를 말해 주세요: ‘You call that a sword? [laugh]’”

## 주요 특징

|  |  |
|---|---|
| 모델 ID | `aigd.tts-chatterbox-turbo.q8-0` |
| 언어 | 영어 |
| 음성 | 자체 음성 또는 5–30초 참조 클립을 복제한 음성(대본 불필요) |
| 사운드 태그 | `[laugh]`, `[chuckle]`, `[cough]` 등 |
| 출력 | 24 kHz, 모노; 실행당 최대 약 40초 |
| 요청당 텍스트 | 최대 500자 |
| 실행 환경 | NVIDIA(CUDA), Vulkan, Mac(Metal) GPU 또는 CPU |
| 다운로드 | 1.04 GB, 파일 2개 |
| 라이선스 | MIT, 상업적 사용 허용 |

## Turbo 또는 Multilingual V3

AI Game Dev는 두 가지 Chatterbox 패키지를 제공합니다:

- **Chatterbox Turbo**(이 패키지): 영어 전용이며 사운드 태그를 지원하고, llama.cpp를 통해 GPU 또는 CPU에서 실행됩니다(16스레드 x86 CPU에서는 실시간보다 약 1.2–1.7배 빠름). 영어 게임에는 이것을 선택하세요.
- **[Chatterbox Multilingual V3](https://ai-game.dev/packages/aigd.tts-chatterbox-multilingual-v3)**: 20개 언어와 Exaggeration(감정) 제어를 지원하며, 앱에 번들된 ONNX 런타임의 CPU에서 실행되고 실시간보다 느립니다. 영어 외의 언어가 필요할 때 선택하세요. Resemble AI는 더 이상 이를 유지 관리하지 않습니다.

## 실행 방식

이 패키지는 데이터만 포함합니다. 모델 파일을 지정할 뿐입니다. 라이선스에 동의하면 앱이 Hugging Face에서 파일을 다운로드하고, 각 파일을 sha256으로 확인한 뒤, 내 컴퓨터에서 **Local speech**(`aigd.llamacpp`, llama.cpp)로 실행합니다.

## 다운로드

- **Chatterbox Turbo 350M (English)**(`aigd.tts-chatterbox-turbo.q8-0`): 1.04 GB, [`ggml-org/chatterbox-turbo-GGUF`](https://huggingface.co/ggml-org/chatterbox-turbo-GGUF/tree/66f0393558d0ac1e0337e23a4d15f26e8eca0e12)에서 가져온 파일 2개(해당 커밋에 고정): Q8_0으로 양자화된 음성 토큰 모델(`chatterbox-turbo-Q8_0.gguf`)과 음성 인코더, 플로 디코더, 보코더가 포함된 오디오 프로젝터(`mmproj-chatterbox-turbo-F16.gguf`).

## 지원 컴퓨터

CUDA 또는 Vulkan을 사용하려면 VRAM이 3 GiB 이상인 GPU를 사용하세요. Windows RTX 4090에서 긴 음성 요청은 CUDA에서 기준 대비 2.9 GiB, Vulkan에서 2.5 GiB를 추가로 사용했습니다. 16스레드 x86 CPU에서는 2.5 GB 메모리로 실시간보다 약 1.2–1.7배 빠르게 실행됩니다.

## 음성 복제

깨끗한 음성으로 된 5~30초 길이의 참조 클립을 제공하세요. 대본은 필요하지 않습니다. 클립이 없으면 모델은 자체 음성으로 말합니다. 한 번 실행하면 최대 약 40초 분량의 음성(1000프레임)을 만들 수 있으므로 텍스트는 500자로 제한됩니다.

## 라이선스

MIT. 상업적 사용이 허용됩니다. 모델 파일을 공유할 때는 Resemble AI의 저작권 고지와 MIT 고지를 유지하세요.

- Resemble AI의 Chatterbox Turbo: [모델 카드](https://huggingface.co/ResembleAI/chatterbox-turbo)(MIT); 라이선스 텍스트: [LICENSE](https://github.com/resemble-ai/chatterbox/blob/master/LICENSE), “Copyright (c) 2025 Resemble AI”.
- 두 파일 모두 [`ggml-org/chatterbox-turbo-GGUF`](https://huggingface.co/ggml-org/chatterbox-turbo-GGUF)(MIT)에서 가져왔습니다: llama.cpp가 커밋 `749d1c1a46eb10492095d68fbcf55691ccf137cd`에서 `ResembleAI/chatterbox-turbo`을 자동 변환한 결과입니다.

필수 저작자 표시: "Chatterbox Turbo, Copyright (c) 2025 Resemble AI, MIT licence."

제한 사항:

- 모델 파일을 공유하는 경우 "Copyright (c) 2025 Resemble AI" 고지와 MIT 라이선스 텍스트를 유지하세요.
- Resemble AI의 자체 Python 패키지는 모든 출력에 들리지 않는 PerTh 워터마크를 표시합니다. llama.cpp는 그렇게 하지 않으므로, 여기서 만든 음성에는 워터마크가 없습니다.
- 사용 권한이 있는 음성만 복제하세요. 모델 카드는 해를 끼치는 데 사용하지 말 것을 요청합니다.

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