# musicnn **Repository Path**: wang_chengbin178/musicnn ## Basic Information - **Project Name**: musicnn - **Description**: No description available - **Primary Language**: Unknown - **License**: ISC - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2025-07-13 - **Last Updated**: 2025-07-13 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # musicnn Pronounced as "musician", `musicnn` is a set of pre-trained musically motivated convolutional neural networks for music audio tagging. This repository also includes some pre-trained [vgg-like](https://github.com/jordipons/musicnn/blob/master/vgg_example.ipynb) baselines. Check the [documentation](https://github.com/jordipons/musicnn/blob/master/DOCUMENTATION.md) and our [basic](https://github.com/jordipons/musicnn/blob/master/tagging_example.ipynb) / [advanced](https://github.com/jordipons/musicnn/blob/master/musicnn_example.ipynb) examples to understand how to use `musicnn`. Do you have questions? Check the [FAQs](https://github.com/jordipons/musicnn/blob/master/FAQs.md). ## Installation ```pip install musicnn``` or, to get bigger models and all the documentation (including jupyter notebooks), install from source: ``` git clone https://github.com/jordipons/musicnn.git``` ``` python setup.py install``` ## Predict tags From within **python**, you can estimate the topN tags: ~~~~python from musicnn.tagger import top_tags top_tags('./audio/joram-moments_of_clarity-08-solipsism-59-88.mp3', model='MTT_musicnn', topN=10) ~~~~ >['techno', 'electronic', 'synth', 'fast', 'beat', 'drums', 'no vocals', 'no vocal', 'dance', 'ambient'] Let's try another song! ~~~~python top_tags('./audio/TRWJAZW128F42760DD_test.mp3') ~~~~ >['guitar', 'piano', 'fast'] From the **command-line**, you can also print the topN tags on the screen: ~~~~ python -m musicnn.tagger file_name.ogg --print python -m musicnn.tagger file_name.au --model 'MSD_musicnn' --topN 3 --length 3 --overlap 1.5 --print ~~~~~ or save to a file: ~~~~ python -m musicnn.tagger file_name.wav --save out.tags python -m musicnn.tagger file_name.mp3 --model 'MTT_musicnn' --topN 10 --length 3 --overlap 1 --print --save out.tags ~~~~ ## Extract the Taggram You can also compute the taggram using **python** (see our [basic](https://github.com/jordipons/musicnn/blob/master/tagging_example.ipynb) example for more details on how to depict it): ~~~~python from musicnn.extractor import extractor taggram, tags = extractor('./audio/joram-moments_of_clarity-08-solipsism-59-88.mp3', model='MTT_musicnn') ~~~~ ![Taggram](./images/taggram.png "Taggram") The above analyzed music clips are included in the `./audio/` folder of this repository. You can listen to those and evaluate `musicnn` yourself!