# OmniVoice (음성 모델, 비상업용)

> k2-fsa의 OmniVoice를 로컬에서 실행합니다. 600개 이상의 언어로 텍스트 음성 변환을 하며, 자체 기본 음성이나 클립과 전사문으로 복제한 음성을 사용합니다. 비상업적 프로젝트에서 희귀 언어에 유용합니다. GPU에서 가장 좋으며 audio.cpp를 사용합니다. 비상업적 라이선스(CC-BY-NC)입니다.

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

## 설치

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

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

데스크톱 앱에서 Packages 창을 열고(상태 표시줄의 패키지 아이콘) **Browse**를 선택한 뒤 `aigd.tts-omnivoice`를 검색하고 **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
# OmniVoice (`aigd.tts-omnivoice`)

OmniVoice는 600개 이상의 언어를 지원하는 k2-fsa의 텍스트-음성 변환 모델로, 자체 기본 음성을 쓰거나 클립과 그 대본으로 복제한 음성을 사용합니다. AI Game Dev에서는 **Local audio generation**(`aigd.audiocpp`, audio.cpp)을 통해 사용자 컴퓨터에서 실행되며, GPU에서 가장 좋은 성능을 냅니다. **라이선스가 비상업용(CC-BY-NC)**이므로 연구, 프로토타입, 모드, 개인 프로젝트에 적합하며, 특히 다른 음성 모델이 지원하지 않는 언어가 필요할 때 유용합니다.

## 만들 수 있는 것

- 비상업적 프로젝트를 위한 희귀 언어 및 저자원 언어의 음성 대사.
- 3–30초 클립과 그 대본으로 복제한 음성으로 만드는 대화.
- 여러 언어로 된 프로토타입을 위한 기본 음성 내레이션.

## 요청 예시

- "기본 음성으로 마을 원로의 대사를 태국어로 읽어 줘."
- "`Audio/ref/guide.wav`을 복제하고(대본은 `guide.txt`), 우크라이나어로 환영 대사를 말해 줘."
- "튜토리얼 음성을 인도네시아어와 폴란드어로 만들어 줘."

## 주요 특징

|  |  |
|---|---|
| 모델 id | `aigd.tts-omnivoice.q8-0` |
| 언어 | 600개 이상이며, 앱에는 일반적인 언어가 표시됩니다: en, zh, ja, ko, de, fr, es, it, pt, ru, ar, hi, tr, nl, pl, vi, th, id, uk, sv |
| 음성 | 기본 음성 또는 3–30초 클립과 그 대본으로 복제한 음성 |
| 출력 | 24 kHz |
| 요청당 텍스트 | 최대 2,000자 |
| 실행 환경 | 약 4 GB의 GPU(추정): NVIDIA(CUDA), Vulkan 또는 Mac(Metal). CPU에서도 동작하지만 느립니다 |
| 다운로드 | 1.35 GB, 1개 파일 |
| 라이선스 | CC-BY-NC: **비상업적 사용만 가능** |

## 실행 방식

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

## 다운로드

- **OmniVoice**(`aigd.tts-omnivoice.q8-0`): 1.35 GB, [`audio-cpp/audio.cpp-gguf`](https://huggingface.co/audio-cpp/audio.cpp-gguf/tree/b7b9aa1f16c819c3b2d69a602b51786bdfb361a3)에서 받는 1개 파일이며 해당 커밋에 고정되어 있습니다.

## 어떤 컴퓨터에서 실행되나

GPU(약 4 GB)에서 가장 좋으며, CPU에서도 동작하지만 느립니다.

## 음성과 언어

- OmniVoice: 언어 en, zh, ja, ko, de, fr, es, it, pt, ru, ar, hi, tr, nl, pl, vi, th, id, uk, sv; 클립과 그 대본으로 음성 복제를 지원합니다.

OmniVoice는 2026-07-03까지 Apache-2.0이었으나, 제작진이 학습 데이터 문제로 가중치를 CC-BY-NC로 변경했습니다. 코드는 여전히 Apache-2.0입니다. GGUF 내부의 오디오 토크나이저는 bosonai/higgs-audio-v2-tokenizer(Boson Higgs Audio 2 Community License)에서 가져왔습니다.

## 라이선스

CC-BY-NC. **비상업적 사용만 가능합니다.** 가중치는 학습 데이터 때문에 CC-BY-NC(비상업적, 저작자 표시 조건)이며, 코드는 Apache-2.0입니다.

- k2-fsa의 OmniVoice: [모델 카드](https://huggingface.co/k2-fsa/OmniVoice), CC-BY-NC; 라이선스 전문: [CC-BY-NC](https://huggingface.co/k2-fsa/OmniVoice#license).
- 이 패키지의 모든 파일은 [`audio-cpp/audio.cpp-gguf`](https://huggingface.co/audio-cpp/audio.cpp-gguf)에서 가져왔습니다: CC-BY-NC(업스트림 라이선스이며, Higgs Audio v2 토크나이저를 포함하는 audio.cpp의 변환물). audio.cpp의 모델 계열별 라이선스 표: [model_licenses.md](https://github.com/0xShug0/audio.cpp/blob/v0.9.5/docs/model_licenses.md).
- Higgs Audio v2 토크나이저(GGUF 내부): Boson Higgs Audio 2 Community License([출처](https://huggingface.co/k2-fsa/OmniVoice/blob/3fc979d1cd72492cd679c5ac2611e0d7ac047ba1/audio_tokenizer/LICENSE)).

필수 저작자 표시: "OmniVoice by k2-fsa (k2-fsa/OmniVoice), CC-BY-NC. Built with Higgs Materials licensed from Boson AI USA, Inc. and Meta Llama 3 licensed under the Meta Llama 3 Community License."

제한 사항:

- 비상업적 사용만 가능(CC-BY-NC, 2026-07-03부터).
- 모델을 공유할 경우 k2-fsa OmniVoice를 표시해야 하며, 함께 포함된 Higgs 오디오 토크나이저는 Meta Llama 3 고지와 함께 "Built with Higgs Materials licensed from Boson AI USA, Inc."을 표시하고 두 라이선스를 모두 담은 Notice 파일을 제공해야 합니다.
- 제작진은 무단 음성 복제, 사칭, 사기 및 스캠을 금지하며, 토크나이저의 라이선스는 Meta Llama 3 Acceptable Use Policy를 추가로 적용합니다.
- Higgs 토크나이저의 라이선스는 이를 다른 대규모 언어 모델 개선에 사용하는 것을 금지하며, 연간 활성 사용자 100,000명을 초과하면 확장 라이선스가 필요합니다.

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