title: UnlimitedMusicGen
emoji: 🎼
colorFrom: gray
colorTo: red
sdk: gradio
sdk_version: 5.49.1
python_version: 3.12.8
app_file: app.py
pinned: true
license: creativeml-openrail-m
tags:

• mcp-server-track
• musicgen
• unlimited
• user history
• metadata
  hf_oauth: true
  disable_embedding: true
  short_description: 'unlimited Audio generation with a few added features '
  thumbnail: >-
  https://cdn-uploads.huggingface.co/production/uploads/6346595c9e5f0fe83fc60444/Z8E8OaKV84zuVAvvGpMDJ.png

Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference

UnlimitedMusicGen

Charles Fettinger's modification of the Audiocraft project to enable unlimited Audio generation. I have added a few features to the original project to enable this. I have also added a few features to the gradio interface to make it easier to use.

Please review my other AI relalated spaces at https://huggingface.co/Surn

Check your video's generative metadata with https://mediaarea.net/en/MediaInfo

Also note that I wrote an extension to Gradio for the waveform in the video after v4.48.0 removed it.

The key update here is in the extend utility. We segment melody input and then condition the next segment with current tensors and tensors from the current time in the conditioning melody file.
This allows us to follow the same arraingement of the original melody.

Thank you Huggingface for the community grant to run this project!!

Key Features

• Unlimited Audio Generation: Generate music of any length by seamlessly stitching together segments
• User History: Save and manage your generated music and access it later
• File Storage: Generated files are automatically stored in a Hugging Face repository with shareable URLs
• Rich Metadata: Each generated file includes detailed metadata about the generation parameters
• API Access: Generate music programmatically using the REST API
• Background Customization: Use custom images and settings for your music videos
• Melody Conditioning: Use existing music to guide the generation process

Audiocraft

Audiocraft is a PyTorch library for deep learning research on audio generation. At the moment, it contains the code for MusicGen, a state-of-the-art controllable text-to-music model.

MusicGen

Audiocraft provides the code and models for MusicGen, a simple and controllable model for music generation. MusicGen is a single stage auto-regressive
Transformer model trained over a 32kHz EnCodec tokenizer with 4 codebooks sampled at 50 Hz. Unlike existing methods like MusicLM, MusicGen doesn't require a self-supervised semantic representation, and it generates
all 4 codebooks in one pass. By introducing a small delay between the codebooks, we show we can predict
them in parallel, thus having only 50 auto-regressive steps per second of audio.
Check out our sample page or test the available demo!

We use 20K hours of licensed music to train MusicGen. Specifically, we rely on an internal dataset of 10K high-quality music tracks, and on the ShutterStock and Pond5 music data.

Installation

Audiocraft requires Python 3.9, PyTorch 2.1.0, and a GPU with at least 16 GB of memory (for the medium-sized model). To install Audiocraft, you can run the following:

Best to make sure you have torch installed first, in particular before installing xformers.

Don't run this if you already have PyTorch installed.

pip install 'torch>=2.1'

Then proceed to one of the following

pip install -U audiocraft # stable release
pip install -U git+https://[email protected]/facebookresearch/audiocraft#egg=audiocraft # bleeding edge
pip install -e . # or if you cloned the repo locally

Usage

We offer a number of way to interact with MusicGen:

1. A demo is also available on the facebook/MusicGen HuggingFace Space (huge thanks to all the HF team for their support).
2. You can run the Gradio demo in Colab: colab notebook.
3. You can use the gradio demo locally by running python app.py.
4. You can play with MusicGen by running the jupyter notebook at demo.ipynb locally (if you have a GPU).
5. Checkout @camenduru Colab page which is regularly
   updated with contributions from @camenduru and the community.
6. Finally, MusicGen is available in 🤗 Transformers from v4.31.0 onwards, see section 🤗 Transformers Usage below.

Advanced Usage

Programmatic Generation via API

The predict_simple API endpoint allows generating music without using the UI:
import requests

Example API call

response = requests.post(
"https://huggingface.co/spaces/Surn/UnlimitedMusicGen/api/predict_simple",
json={
"model": "stereo-medium", # Choose your model
"text": "Epic orchestral soundtrack with dramatic strings and percussion",
"duration": 60, # Duration in seconds
"topk": 250,
"topp": 0, # 0 means use topk instead
"temperature": 0.8,
"cfg_coef": 4.0,
"seed": 42, # Use -1 for random seed
"overlap": 2, # Seconds of overlap between segments
"video_orientation": "Landscape" # or "Portrait"
}
)

URLs to the generated content

video_url, audio_url, seed = response.json()

Custom Background Images

You can use your own background images for the music video:

1. Upload an image through the UI
2. Or specify an image URL in the API call:response = requests.post(
   "https://huggingface.co/spaces/Surn/UnlimitedMusicGen/api/predict_simple",
   json={
   # ... other parameters
   "background": "https://example.com/your-image.jpg",
   "video_orientation": "Landscape"
   }
   )

More info about Top-k, Top-p, Temperature and Classifier Free Guidance from ChatGPT

Top-k: Top-k is a parameter used in text generation models, including music generation models. It determines the number of most likely next tokens to consider at each step of the generation process. The model ranks all possible tokens based on their predicted probabilities, and then selects the top-k tokens from the ranked list. The model then samples from this reduced set of tokens to determine the next token in the generated sequence. A smaller value of k results in a more focused and deterministic output, while a larger value of k allows for more diversity in the generated music.

Top-p (or nucleus sampling): Top-p, also known as nucleus sampling or probabilistic sampling, is another method used for token selection during text generation. Instead of specifying a fixed number like top-k, top-p considers the cumulative probability distribution of the ranked tokens. It selects the smallest possible set of tokens whose cumulative probability exceeds a certain threshold (usually denoted as p). The model then samples from this set to choose the next token. This approach ensures that the generated output maintains a balance between diversity and coherence, as it allows for a varying number of tokens to be considered based on their probabilities.

Temperature: Temperature is a parameter that controls the randomness of the generated output. It is applied during the sampling process, where a higher temperature value results in more random and diverse outputs, while a lower temperature value leads to more deterministic and focused outputs. In the context of music generation, a higher temperature can introduce more variability and creativity into the generated music, but it may also lead to less coherent or structured compositions. On the other hand, a lower temperature can produce more repetitive and predictable music.

Classifier-Free Guidance: Classifier-Free Guidance refers to a technique used in some music generation models where a separate classifier network is trained to provide guidance or control over the generated music. This classifier is trained on labeled data to recognize specific musical characteristics or styles. During the generation process, the output of the generator model is evaluated by the classifier, and the generator is encouraged to produce music that aligns with the desired characteristics or style. This approach allows for more fine-grained control over the generated music, enabling users to specify certain attributes they want the model to capture.

These parameters, such as top-k, top-p, temperature, and classifier-free guidance, provide different ways to influence the output of a music generation model and strike a balance between creativity, diversity, coherence, and control. The specific values for these parameters can be tuned based on the desired outcome and user preferences.

API and Storage Integration

UnlimitedMusicGen now offers enhanced API capabilities and file storage integration with Hugging Face repositories:

REST API Access

The application exposes a simple REST API endpoint through Gradio that allows you to generate music programmatically:
import requests

Basic API call example

response = requests.post(
"https://your-app-url/api/predict_simple",
json={
"model": "medium",
"text": "4/4 120bpm electronic music with driving bass",
"duration": 30,
"temperature": 0.7,
"cfg_coef": 3.75,
"title": "My API Generated Track"
}
)

The response contains URLs to the generated audio/video

video_url, audio_url, seed = response.json()
print(f"Generated music video: {video_url}")
print(f"Generated audio file: {audio_url}")
print(f"Seed used: {seed}")

File Storage

Generated files are automatically uploaded to a Hugging Face dataset repository, providing:

• Persistent storage of your generated audio and video files
• Shareable URLs for easy distribution
• Organization by user, timestamp, and metadata
• Automatic handling of file paths and naming

The storage system supports various file types including audio (.wav, .mp3), video (.mp4), and images (.png, .jpg).

Background Image Support

You can now provide custom background images for your music videos:

• Upload from your device
• Use URL links to images (automatically downloaded and processed)
• Choose between landscape and portrait orientations
• Add title and generation settings overlay with customizable fonts and colors

Python API

We provide a simple API and 10 pre-trained models. The pre trained models are:

• small: 300M model, text to music only - 🤗 Hub
• medium: 1.5B model, text to music only - 🤗 Hub
• melody: 1.5B model, text to music and text+melody to music - 🤗 Hub
• large: 3.3B model, text to music only - 🤗 Hub
• melody large (3.3B), text to music, and text+melody to music # see: 🤗 Hub
• small stereo (300M), text to music, # see: 🤗 Hub
• medium stereo (1.5B), text to music, # see: 🤗 Hub
• melody stereo (1.5B) text to music and text+melody to music, # see: 🤗 Hub
• large stereo (3.3B), text to music, # see: 🤗 Hub
• melody large stereo (3.3B), text to music, and text+melody to music # see: 🤗 Hub

We observe the best trade-off between quality and compute with the medium or melody model.
In order to use MusicGen locally you must have a GPU. We recommend 16GB of memory, but smaller
GPUs will be able to generate short sequences, or longer sequences with the small model.

Note: Please make sure to have ffmpeg installed when using newer version of torchaudio.
You can install it with:apt-get install ffmpeg
See after a quick example for using the API.
import torchaudio
from audiocraft.models import MusicGen
from audiocraft.data.audio import audio_write

model = MusicGen.get_pretrained('melody')
model.set_generation_params(duration=8) # generate 8 seconds.
wav = model.generate_unconditional(4) # generates 4 unconditional audio samples
descriptions = ['happy rock', 'energetic EDM', 'sad jazz']
wav = model.generate(descriptions) # generates 3 samples.

melody, sr = torchaudio.load('./assets/bach.mp3')

generates using the melody from the given audio and the provided descriptions.

wav = model.generate_with_chroma(descriptions, melody[None].expand(3, -1, -1), sr)

for idx, one_wav in enumerate(wav):
# Will save under {idx}.wav, with loudness normalization at -14 db LUFS.
audio_write(f'{idx}', one_wav.cpu(), model.sample_rate, strategy="loudness", loudness_compressor=True)## 🤗 Transformers Usage

MusicGen is available in the 🤗 Transformers library from version 4.31.0 onwards, requiring minimal dependencies
and additional packages. Steps to get started:

1. First install the 🤗 Transformers library from main:
   pip install git+https://github.com/huggingface/transformers.git
2. Run the following Python code to generate text-conditional audio samples:
   from transformers import AutoProcessor, MusicgenForConditionalGeneration

processor = AutoProcessor.from_pretrained("facebook/musicgen-small")
model = MusicgenForConditionalGeneration.from_pretrained("facebook/musicgen-small")

inputs = processor(
text=["80s pop track with bassy drums and synth", "90s rock song with loud guitars and heavy drums"],
padding=True,
return_tensors="pt",
)

audio_values = model.generate(**inputs, max_new_tokens=256)
3. Listen to the audio samples either in an ipynb notebook:
from IPython.display import Audio

sampling_rate = model.config.audio_encoder.sampling_rate
Audio(audio_values[0].numpy(), rate=sampling_rate)
Or save them as a .wav file using a third-party library, e.g. scipy:
import scipy

sampling_rate = model.config.audio_encoder.sampling_rate
scipy.io.wavfile.write("musicgen_out.wav", rate=sampling_rate, data=audio_values[0, 0].numpy())
For more details on using the MusicGen model for inference using the 🤗 Transformers library, refer to the
MusicGen docs or the hands-on
Google Colab.

User History

User History is a plugin that you can add to your Spaces to cache generated images for your users.

Key features:

• 🤗 Sign in with Hugging Face
• Save generated image, video, audio and document files with their metadata: prompts, timestamp, hyper-parameters, etc.
• Export your history as zip.
• Delete your history to respect privacy.
• Compatible with Persistent Storage for long-term storage.
• Admin panel to check configuration and disk usage .

Useful links:

• Demo: https://huggingface.co/spaces/Wauplin/gradio-user-history
• README: https://huggingface.co/spaces/Wauplin/gradio-user-history/blob/main/README.md
• Source file: https://huggingface.co/spaces/Wauplin/gradio-user-history/blob/main/user_history.py
• Discussions: https://huggingface.co/spaces/Wauplin/gradio-user-history/discussions

Model Card

See the model card page.

FAQ

Will the training code be released?

Yes. We will soon release the training code for MusicGen and EnCodec.

I need help on Windows

@FurkanGozukara made a complete tutorial for Audiocraft/MusicGen on Windows

I need help for running the demo on Colab

Check @camenduru tutorial on Youtube.

Citation@article{copet2023simple,

  title={Simple and Controllable Music Generation},
  author={Jade Copet and Felix Kreuk and Itai Gat and Tal Remez and David Kant and Gabriel Synnaeve and Yossi Adi and Alexandre Défossez},
  year={2023},
  journal={arXiv preprint arXiv:2306.05284},

}

License

• The code in this repository is released under the MIT license as found in the LICENSE file.
• The weights in this repository are released under the CC-BY-NC 4.0 license as found in the LICENSE_weights file.
  arxiv: https://arxiv.org/abs/2306.05284

Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference