CoolFace
Modelpublic

hubertsiuzdak/snac_32khz

sourceHugging Facemitupdated 2y agoView on Hugging Face
12likes1.8kdownloads
Model Card

SNAC ๐Ÿฟ

Multi-Scale Neural Audio Codec (SNAC) compressess audio into discrete codes at a low bitrate.

๐Ÿ‘‰ This model was primarily trained on music data, and its recommended use case is music (and SFX) generation. See below for other pretrained models.

๐Ÿ”— GitHub repository: https://github.com/hubertsiuzdak/snac/

Overview

SNAC encodes audio into hierarchical tokens similarly to SoundStream, EnCodec, and DAC. However, SNAC introduces a simple change where coarse tokens are sampled less frequently, covering a broader time span.

This model compresses 32 kHz audio into discrete codes at a 1.9 kbps bitrate. It uses 4 RVQ levels with token rates of 10, 21, 42, and 83 Hz.

Pretrained models

Currently, all models support only single audio channel (mono).

ModelBitrateSample RateParamsRecommended use case
hubertsiuzdak/snac_24khz0.98 kbps24 kHz19.8 M๐Ÿ—ฃ๏ธ Speech
hubertsiuzdak/snac_32khz (this model)1.9 kbps32 kHz54.5 M๐ŸŽธ Music / Sound Effects
hubertsiuzdak/snac_44khz2.6 kbps44 kHz54.5 M๐ŸŽธ Music / Sound Effects

Usage

Install it using:

bash
pip install snac

To encode (and decode) audio with SNAC in Python, use the following code:

python
import torch
from snac import SNAC

model = SNAC.from_pretrained("hubertsiuzdak/snac_32khz").eval().cuda()
audio = torch.randn(1, 1, 32000).cuda()  # B, 1, T

with torch.inference_mode():
    codes = model.encode(audio)
    audio_hat = model.decode(codes)

You can also encode and reconstruct in a single call:

python
with torch.inference_mode():
    audio_hat, codes = model(audio)

โš ๏ธ Note that codes is a list of token sequences of variable lengths, each corresponding to a different temporal resolution.

>>> [code.shape[1] for code in codes]
[12, 24, 48, 96]

Acknowledgements

Module definitions are adapted from the Descript Audio Codec.