로컬 오디오 생성 (audio.cpp)
gamedev pkg add aigd.audiocpp개요
AI Game Dev에서 로컬 음악, 효과음, 음성을 만들기 위한 런타임으로, CUDA, Vulkan, Metal 또는 CPU에서 audio.cpp(C++, ggml)를 사용합니다. ACE-Step 1.5, MiniMax-Music3, Magenta RealTime 2, MOSS-SoundEffect v2, Qwen3-TTS, VoxCPM2 및 기타 음성 모델을 실행합니다. 모델은 별도 패키지입니다.
로컬 오디오 생성은 AI Game Dev 앱이 여러분의 컴퓨터에서, GPU 또는 CPU로, 음악과 효과음, 음성을 만들 수 있게 해 주는 런타임입니다. ggml 위에 만들어진 순수 C++ 오디오 모델 추론 엔진인 audio.cpp를 사용하며 Python 의존성이 없습니다. 모든 것이 여러분의 컴퓨터에서 만들어지고, 비용도 들지 않습니다. 하나의 런타임이 여러 오픈 모델을 지원합니다. 노래와 연주곡, 환경 효과음, 그리고 여러 언어의 캐릭터 음성입니다. 설치한 다음 원하는 모델 패키지를 추가하세요.
주요 기능
- 컴퓨터에 맞는 audio.cpp 릴리스를 다운로드하고(Windows는 CUDA, Vulkan 또는 CPU, Apple silicon Mac은 Metal, Linux는 프리뷰로 Vulkan 또는 CPU), sha256으로 검증한 뒤 실행합니다.
- 설치된 모든 audio.cpp 모델 패키지를 세션의 Audio 도구를 통해 기본 제공 음성 모델처럼 실행하므로, 여러분과 에이전트가 평범한 말로 음악, 효과음, 음성을 요청할 수 있습니다.
- 사운드마다
audiocpp_cli을 한 번씩 실행하므로 생성 사이에 메모리에 남는 것이 없습니다. - 백엔드를 선택할 수 있습니다. Auto가 컴퓨터에 맞지 않을 때
backend설정으로 CUDA, Vulkan, Metal 또는 CPU를 고릅니다. - 새로 다운로드한 모델을 에이전트가 사용할 수 있는지 결정할 수 있습니다(
newModelsDefault설정, 이미 다운로드한 모델은 자체 설정을 유지합니다).
이 패키지는 데이터만 포함합니다(aigd-package.json, 코드 없음). AI Game Dev에 어떤 audio.cpp 릴리스를 컴퓨터에 맞게 다운로드할지 알려 줍니다. 앱이 프로그램을 직접 다운로드하고, 검증하고, 실행합니다.
모델은 별도 패키지입니다
이 패키지에는 모델이 들어 있지 않습니다. 각 오디오 모델 패키지(음악, 효과음, 음성)는 필요한 파일과 audio.cpp에서의 실행 방법을 정의합니다. 확인 없이는 아무것도 다운로드되지 않으며, 크기와 모델의 라이선스를 먼저 볼 수 있습니다. 다음 모델 패키지가 이 런타임에서 실행됩니다:
| 종류 | 패키지 | 생성 결과 |
|---|---|---|
| 음악 | ACE-Step 1.5 | 보컬 또는 연주곡, 50개 언어의 가사, 최대 10분 |
| 음악 | MiniMax-Music3 | 노래 가사가 있는 완곡, 최대 5분 |
| 음악 | Magenta RealTime 2 | 연주 음악, 최대 3분; Small은 CPU에서도 실행됩니다 |
| 효과음 | MOSS-SoundEffect v2 | 환경음, 자연, 도시, 생물 및 사람 동작 소리, 최대 30초 |
| 음성 | Qwen3-TTS 0.6B Base | 10개 언어 음성 복제, 소형 GPU에서 실행 |
| 음성 | Qwen3-TTS 1.7B Base | 10개 언어 음성 복제 |
| 음성 | Qwen3-TTS 1.7B CustomVoice | 감정 지시가 가능한 9개의 내장 음성 |
| 음성 | Qwen3-TTS 1.7B VoiceDesign | 텍스트 설명으로 새 음성 생성 |
| 음성 | VoxCPM2 | 30개 언어: 음성 복제, 음성 디자인, 감정 |
| 음성 | Fun-CosyVoice3 | 9개 언어와 광둥어 음성 복제 |
| 음성 | Fish Audio S2 Pro | 음성 복제 및 80개 이상 언어; 비상업적 라이선스 |
| 음성 | IndexTTS 2.5 | 감정 제어가 가능한 음성 복제 |
| 음성 | Magpie TTS Multilingual | 13개 언어와 방언, 5개 음성 |
| 음성 | Ming-3.0 TTS 0.5B | 7개 언어, 음성 복제 및 음성 디자인 |
| 음성 | OmniVoice | 600개 이상 언어, 음성 복제; 비상업적 라이선스 |
| 음성 | Phonon 31M | 초소형 영어 모델, 노트북 CPU에서 실시간 |
| 음성 | Pocket TTS 100M | 6개 언어, 프리셋 음성 또는 복제, CPU에서 빠름 |
| 음성 | ZONOS3-Mini | 8개 언어, 프리셋 음성 또는 복제 |
Stable Audio 3 모델은 별도 런타임인 로컬 효과음 및 음악(aigd.sa3cpp)에서 실행됩니다.
요청 예시
런타임과 모델을 설치했다면, 에이전트에게 평범한 말로 요청하면 됩니다:
- "숲 레벨용으로 60초짜리 차분한 앰비언트 트랙을 만들어 줘."
- "양철 지붕에 비 내리는 10초짜리 앰비언스를 생성해 줘."
- "
dialogue/shop.txt에 나오는 상점 주인의 대사를 따뜻하고 친근한 목소리로 읽어 줘."
다운로드되는 항목
업스트림 릴리스로, 태그로 고정되고 sha256으로 검증됩니다: 0xShug0/audio.cpp v0.9.5(커밋 61c7838baf1f7f34769b5b7bd369c0d78edf9535). 앱이 컴퓨터에 맞는 변형을 하나 선택합니다.
| 변형 | 컴퓨터 | 다운로드 |
|---|---|---|
win-x64-cuda12 | Windows, NVIDIA GPU(드라이버 551.61 이상) | 1.08 GB(프로그램 + NVIDIA CUDA 12.4 런타임) |
win-x64-vulkan | Windows, AMD / Intel / 기타 GPU | 86 MB |
win-x64-cpu | 지원되는 GPU가 없는 Windows(느림) | 34 MB |
darwin-arm64-metal | Apple silicon Mac, macOS 13.3 이상 | 39 MB |
linux-x64-vulkan | Vulkan GPU가 있는 Linux x64, glibc 2.43 이상. libgomp.so.1 및 libvulkan.so.1 필요 | 119 MB |
linux-x64-cpu | 지원되는 GPU가 없는 Linux x64, glibc 2.43 이상(느림) | 67 MB |
Linux는 프리뷰입니다. audio.cpp v0.9.5의 유일한 Linux CUDA 빌드는 Colab용 서버이지, 앱이 실행하는 명령줄 프로그램이 아닙니다. 따라서 NVIDIA GPU가 있는 Linux에서는 Vulkan 변형이 실행됩니다.
앱은 드라이버나 시스템 라이브러리를 설치하지 않습니다. 무언가 빠져 있으면 무엇을 설치해야 하는지 알려 줍니다. audio.cpp는 일부 음성 계열을 위해 시스템에서 eSpeak-ng를 불러옵니다. 이 패키지는 eSpeak-ng를 포함하지 않으며, AI Game Dev가 제공하는 모델에는 필요하지 않습니다.
라이선스
- audio.cpp — Apache-2.0, © 2026 ShugoAI LLC(라이선스).
- 내장: ggml(MIT), SentencePiece(Apache-2.0), cJSON, cpp-httplib, libyaml 및 utf8proc(MIT), LZ4(BSD-2-Clause) —
external/참고. - Windows 변형에 포함된 Microsoft Visual C++ 런타임 DLL — 업스트림이 Visual C++ 재배포 가능 패키지 라이선스 조건에 따라 재배포합니다.
- Windows CUDA 변형에만 포함된 NVIDIA CUDA 런타임(cudart, cuBLAS, cuBLASLt, cuFFT) — 업스트림이 NVIDIA CUDA EULA에 따라 재배포합니다.
- 이 패키지 — MIT. 각 모델 패키지는 자체 라이선스를 명시하며, 모델 가중치는 원래 릴리스의 라이선스를 따릅니다.
모든 파일은 업스트림 GitHub 릴리스에서 다운로드됩니다. AI Game Dev는 이 파일들을 호스팅하지 않습니다.
버전
| 버전 | 출시일 | 앱 필요 |
|---|---|---|
| 1.0.2최신 | 0.32.0-beta.6 이상 | |
| 1.0.1 | 0.32.0-beta.6 이상 |
설치
데스크톱 앱에서
Packages 창을 열고(상태 표시줄의 패키지 아이콘) Browse를 선택한 다음 aigd.audiocpp를 검색하고 Add to Project를 클릭합니다.
앱이 아직 없나요? Windows, macOS, Linux용 AI Game Dev 무료 다운로드를 받아보세요.
터미널에서
gamedev CLI를 사용해 프로젝트 폴더에서 실행합니다:
gamedev pkg add aigd.audiocpp요구 사항
- AI Game Dev 0.32.0-beta.6 이상
gamedev pkg add aigd.audiocpp