# 로컬 사운드 효과와 음악 (Stable Audio 3)

> AI Game Dev에서 로컬 사운드 효과와 음악을 만들기 위한 런타임입니다. Stable Audio 3의 C++/ggml 포팅인 sa3.cpp를 사용하며 CUDA, Vulkan, Metal 또는 CPU에서 Python 없이 동작합니다. Stable Audio 3 Small SFX, Small Music, Medium 모델을 실행하며, 이 모델들은 별도 패키지입니다.

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

## 설치

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

```bash
gamedev pkg add aigd.sa3cpp
```

데스크톱 앱에서 Packages 창을 열고(상태 표시줄의 패키지 아이콘) **Browse**를 선택한 뒤 `aigd.sa3cpp`를 검색하고 **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
# 로컬 사운드 효과와 음악 (`aigd.sa3cpp`)

로컬 사운드 효과와 음악은 AI Game Dev 앱이 Stable Audio 3 모델로 여러분의 컴퓨터에서 직접 사운드 효과와 기악 음악을 만들 수 있게 해 주는 런타임입니다. Python이 필요 없는 Stability AI의 Stable Audio 3 C++/ggml 포팅인 [sa3.cpp](https://github.com/betweentwomidnights/sa3.cpp)를 사용합니다. 모든 작업은 여러분의 컴퓨터에서 이루어지며 비용도 들지 않습니다. 클라우드 서비스 없이 SFX, 폴리, UI 사운드, 배경 음악을 만들고 싶은 게임 개발자에게 적합합니다.

## 주요 기능

- 컴퓨터에 맞는 sa3.cpp 릴리스를 내려받고(Windows, Apple silicon Mac, 또는 프리뷰로 Intel Mac과 Linux, CUDA·Vulkan·Metal·CPU), sha256으로 검증한 뒤 실행합니다.
- 세션의 Tools 바에 **SFX & Music** 스위치를 추가합니다. 이 스위치는 세션에서 직접 켜기 전까지 꺼져 있습니다.
- 사운드마다 `sa3-generate`을 한 번 실행하며 서버를 계속 띄워 두지 않습니다.

이 패키지는 데이터만 담고 있습니다(`aigd-package.json`, 코드 없음). AI Game Dev에 컴퓨터에 맞는 sa3.cpp 릴리스가 무엇인지 알려 주는 역할을 합니다. 프로그램의 다운로드와 검증, 실행은 앱이 직접 수행합니다.

## 모델은 별도 패키지입니다

이 패키지에는 모델이 들어 있지 않습니다. Packages 브라우저에서 모델 패키지를 설치한 다음 Models 패널에서 해당 파일을 내려받으세요:

| 패키지 | 생성 결과 |
|---|---|
| [Stable Audio 3 Small SFX](https://ai-game.dev/packages/aigd.audio-stable-audio-3-small-sfx) (`aigd.audio-stable-audio-3-small-sfx`) | 사운드 효과와 폴리, 최대 60초 |
| [Stable Audio 3 Small Music](https://ai-game.dev/packages/aigd.audio-stable-audio-3-small-music) (`aigd.audio-stable-audio-3-small-music`) | 기악 음악, 최대 2분 |
| [Stable Audio 3 Medium](https://ai-game.dev/packages/aigd.audio-stable-audio-3-medium) (`aigd.audio-stable-audio-3-medium`) | 기악 음악, 최대 6분 20초 |

확인 없이는 아무것도 내려받지 않습니다. 먼저 크기와 모델의 라이선스를 확인할 수 있습니다. Stable Audio 3 모델은 자체 라이선스를 가지며, 매출 한도, 등록 의무, "Powered by Stability AI" 고지 조항이 있습니다. 각 모델 패키지의 README에 이 조건들이 명시되어 있습니다.

다른 로컬 음악, 사운드 효과, 음성 모델은 [Local audio generation](https://ai-game.dev/packages/aigd.audiocpp)(`aigd.audiocpp`)에서 실행됩니다.

## 요청 예시

**SFX & Music**을 켜고 모델을 설치한 상태에서 에이전트에게 자연스러운 말로 요청하면 됩니다.

- "플레이어 총에 쓸 짧은 레이저 발사 소리를 만들어 주세요."
- "눈 위를 걷는 발소리를 4초 길이로 생성해 주세요."
- "메인 메뉴에 쓸 90초짜리 편안한 lo-fi 기악 음악을 만들어 주세요."

## 내려받는 항목

앱은 태그로 고정하고 sha256으로 검증한 업스트림 릴리스를 내려받습니다: `betweentwomidnights/sa3.cpp` [`v0.2.4`](https://github.com/betweentwomidnights/sa3.cpp/releases/tag/v0.2.4) (커밋 `3152253`). 업스트림은 이를 프리릴리스로 표시하고 있습니다. 앱이 컴퓨터에 맞는 변형 하나를 선택합니다.

| 변형 | 컴퓨터 | 다운로드 |
|---|---|---|
| `win-x64-cuda12` | Windows, NVIDIA GPU (드라이버 572.61 이상, 컴퓨트 기능 6.1 이상) | 752 MB (프로그램 + NVIDIA CUDA 12.8 런타임) |
| `win-x64-vulkan` | Windows, AMD / Intel / 기타 GPU | 19 MB (코어 + Vulkan 백엔드) |
| `win-x64-cpu` | Windows, 사용할 수 있는 GPU 없음 (느림, Medium은 GPU 필요) | 7 MB |
| `darwin-arm64-metal` | Apple silicon Mac, macOS 13.3 이상 | 11 MB (업스트림에서 서명 및 공증) |
| `darwin-x64-cpu` | Intel Mac, macOS 13.3 이상 (CPU 전용) | 11 MB |
| `linux-x64-vulkan` | Vulkan GPU가 있는 Linux x64, **glibc 2.38 이상** (Ubuntu 24.04+, Debian 13+). `libgomp.so.1` 및 `libvulkan.so.1` 필요 | 22 MB |
| `linux-x64-cpu` | 사용할 수 있는 GPU가 없는 Linux x64, glibc 2.38 이상. `libgomp.so.1` 필요 | 12 MB |

Windows CUDA 변형은 업스트림의 독립 실행형 아카이브를 사용합니다. CUDA 런타임(`cudart64_12`, `cublas64_12`, `cublasLt64_12`)을 담고 있는 유일한 아카이브입니다. 분리된 `cuda` 아카이브는 `ggml-cuda.dll`만 담고 있으며 시스템 전역 CUDA 12.8 런타임을 전제로 합니다.

**프리뷰.** Linux와 Intel Mac 변형은 아직 실제 하드웨어에서 테스트되지 않았으며, 업스트림에서도 CPU 생성 결과를 검증하지 않습니다. 선택할 수는 있지만 "preview"로 표시됩니다.

앱은 드라이버나 시스템 라이브러리를 설치하지 않습니다. 무언가 빠져 있으면 무엇을 설치해야 하는지 알려 줍니다.

## 라이선스

- sa3.cpp — MIT, © 2026 betweentwomidnights ([라이선스](https://github.com/betweentwomidnights/sa3.cpp/blob/3152253622d8b54deec14bfb0938371a5bd20439/LICENSE)).
- ggml — MIT, © The ggml authors ([ggml-org/ggml](https://github.com/ggml-org/ggml)).
- cpp-httplib (MIT, © yhirose), yyjson (MIT, © YaoYuan), Signalsmith Stretch 및 Signalsmith Linear (MIT, © Signalsmith Audio). 해당 라이선스 파일은 아카이브 안에 포함되어 있습니다.
- RoyalCities RC-stable-audio-tools 프롬프트 엔진 (MIT, © 2023 Stability AI) — `sat-*` 도구에 맞게 변형되었습니다 ([소스](https://github.com/RoyalCities/RC-stable-audio-tools)). AI Game Dev는 이 도구들을 실행하지 않으며, 라이선스는 아카이브의 `THIRD_PARTY_NOTICES.md`에 있습니다.
- Microsoft Visual C++ 런타임 (`msvcp140`, `vcruntime140`, `vcruntime140_1`, `vcomp140`), Windows 변형에만 포함됩니다. 업스트림은 배포 가능한 코드에 대한 Visual Studio 2022 조건에 따라 이를 재배포합니다.
- NVIDIA CUDA 런타임 (cudart, cuBLAS), Windows CUDA 변형에만 포함됩니다. 업스트림은 [NVIDIA CUDA EULA](https://docs.nvidia.com/cuda/eula/)에 따라 이를 재배포하며, `NVIDIA-CUDA-EULA.txt`이 아카이브에 포함되어 있습니다.
- 이 패키지 — MIT. 런타임에는 모델 가중치가 포함되지 않습니다. 각 모델 패키지는 자체 라이선스를 명시합니다.

모든 파일은 업스트림 GitHub 릴리스에서 내려받습니다. AI Game Dev는 파일을 직접 호스팅하지 않습니다.
````
