<img src="img/logo.png" style="vertical-align: -10px;" :height="40px" width="40px"> SongComposer

This repository is the official implementation of SongComposer.

<!-- **[SongComposer: A Large Language Model for Lyric and Melody Generation in Song Composition](https://arxiv.org/abs/2402.17645)** </br> --> <p align="center" style="font-size: 1.5em; margin-top: -1em"> <a href="https://arxiv.org/pdf/2402.17645"><b>SongComposer: A Large Language Model for Lyric and Melody Composition in Song Generation</b></a></p> <p align="center" style="font-size: 1.1em; margin-top: -1em"> <a href="https://mark12ding.github.io/">Shuangrui Ding^*1</a>, <a href="https://scholar.google.com/citations?user=iELd-Q0AAAAJ">Zihan Liu^*2,3</a>, <a href="https://scholar.google.com/citations?user=FscToE0AAAAJ">Xiaoyi Dong³</a>, <a href="https://panzhang0212.github.io/">Pan Zhang³</a>, <a href="https://shvdiwnkozbw.github.io/">Rui Qian¹</a>, <a href="https://conghui.github.io/">Conghui He³</a>, <a href="http://dahua.site/">Dahua Lin³</a>, <a href="https://myownskyw7.github.io/">Jiaqi Wang^&dagger;3</a> </p> <p align="center" style="font-size: 1em; margin-top: -1em">¹The Chinese University of Hong Kong, ²Beihang University, ³Shanghai AI Laboratory</p> <p align="center" style="font-size: 1em; margin-top: -1em"> ^* Equal Contribution. ^&dagger;Corresponding authors. </p> <p align="center" style="font-size: em; margin-top: 0.5em"> <a href="https://arxiv.org/pdf/2402.17645"><img src="https://img.shields.io/badge/arXiv-<color>"></a> <a href="https://github.com/pjlab-songcomposer/songcomposer"><img src="https://img.shields.io/badge/Code-red"></a> <a href="https://pjlab-songcomposer.github.io"><img src="https://img.shields.io/badge/Demo-yellow"></a> <a href="https://huggingface.co/datasets/Mar2Ding/songcompose_data"><img src="https://img.shields.io/badge/HFdata🤗-<color>"></a> </p>

<img align="center" src="img/framework.png" style=" display: block; margin-left: auto; margin-right: auto; width: 100%;" />

📜 News

🚀 [2025/5/31] We release the SongCompose data link on Hugging Face🤗.

🎉 [2025/5/16] SongComposer is accepted by ACL 2025 main!

🚀 [2024/6/12] We enhanced SongComposer to a whole-song level and the demo page is updated!

🚀 [2024/3/21] The finetune code of SongComposer are publicly available and the weights of SongComposer_pretrain and SongComposer_sft are publicly available on Hugging Face🤗.

🚀 [2024/2/28] The paper and demo page are released!

💡 Highlights

• 🔥 SongComposer composes melodies and lyrics with symbolic song representations, with the benefit of better token efficiency, precise representation, flexible format, and human-readable output.
• 🔥 SongCompose-PT, a comprehensive pretraining dataset that includes lyrics, melodies, and paired lyrics and melodies in either Chinese or English, will be released.
• 🔥 SongComposer outperforms advanced LLMs like GPT-4 in tasks such as lyric-to-melody generation, melody-to-lyric generation, song continuation, and text-to-song creation.

🛠️ Usage

Requirements

• python 3.9 and above
• pytorch 2.0 and above
• CUDA 12.0 and above are recommended (this is for GPU users)

Installation

Before running the code, make sure you have setup the environment and installed the required packages. Make sure you meet the above requirements, and then install the dependent libraries. Please refer to the installation section of finetune scripts.

Quickstart

We provide a simple example to show how to use SongComposer-SFT with 🤗 Transformers.

<details> <summary> <b>🤗 Transformers</b> </summary>

from transformers import AutoTokenizer, AutoModelForCausalLM
ckpt_path = "Mar2Ding/songcomposer_sft"
tokenizer = AutoTokenizer.from_pretrained(ckpt_path, trust_remote_code=True)
model = AutoModel.from_pretrained(ckpt_path, trust_remote_code=True).cuda().half()
prompt = 'Create a song on brave and sacrificing with a rapid pace.'
model.inference(prompt, tokenizer)

</details>

Finetune

Please refer to our finetune scripts.

Inference

We have provide a notebook (inference.ipynb) for the inference stage.

⭐ Samples

Audio samples, including our SongComposer and other baselines, are available on our Demo Page. The samples span four tasks related to song generation, covering both English and Chinese.

<!-- ## ❤️ Acknowledgments -->

✒️ Citation

If you find our work helpful for your research, please consider giving a star ⭐ and citation 📝

@misc{ding2024songcomposer,
      title={SongComposer: A Large Language Model for Lyric and Melody Generation in Song Composition}, 
      author={Shuangrui Ding and Zihan Liu and Xiaoyi Dong and Pan Zhang and Rui Qian and Junhao Huang and Conghui He and Dahua Lin and Jiaqi Wang},
      year={2024},
      eprint={2402.17645},
      archivePrefix={arXiv},
      primaryClass={cs.SD}
}

<!-- ## License -->