deezer
spleeter
Python2019–2025
deezer / spleeter
spleeter
Deezer source separation library including pretrained models.
32Distinct people
33Mentions
0Explicit recommenders
28.5KGitHub stars
What to know before exploring
What it is
Deezer source separation library including pretrained models.
GitHub
Where it is used
No documented product use was verified in the last source check.
What people are saying
No recommendation phrase was found in the indexed comments.
No classified warning is attached to this page. Read the discussions before treating silence as approval.
Also in these discussions
- facebookresearch/demucs · linked in 3 of the same discussions
- sigsep/open-unmix-pytorch · linked in 2 of the same discussions
Mentioned in the same Hacker News threads. That is not proof they are substitutes.
This week on Hacker News
Nov 7–Nov 14 UTC · Direct repository links and separately labeled related project stories. Indexed through 11/14/2026, 12:54:37 PM UTC.
No direct repository links were found in the indexed HN discussions over the past seven days. Older discussions are available below.
Mentions over time
HN mentions by year33 dated mentions
Observed mentions: 2019-11-03 00:14:54 UTC to 2025-04-25 06:54:21 UTC.
Counts come from the repository’s dated source evidence. Index cutoff: 2026-11-02 08:16:59 UTC.
View mention counts and date ranges
| Period | Start (UTC) | End (exclusive, UTC) | Mentions | Submissions | Comments |
|---|---|---|---|---|---|
| 2019 | 2019-01-01 00:00:00 UTC | 2020-01-01 00:00:00 UTC | 4 | 1 | 3 |
| 2020 | 2020-01-01 00:00:00 UTC | 2021-01-01 00:00:00 UTC | 4 | 0 | 4 |
| 2021 | 2021-01-01 00:00:00 UTC | 2022-01-01 00:00:00 UTC | 10 | 0 | 10 |
| 2022 | 2022-01-01 00:00:00 UTC | 2023-01-01 00:00:00 UTC | 9 | 1 | 8 |
| 2023 | 2023-01-01 00:00:00 UTC | 2024-01-01 00:00:00 UTC | 3 | 0 | 3 |
| 2024 | 2024-01-01 00:00:00 UTC | 2025-01-01 00:00:00 UTC | 1 | 0 | 1 |
| 2025 | 2025-01-01 00:00:00 UTC | 2026-01-01 00:00:00 UTC | 2 | 0 | 2 |
From the project README
An excerpt from the repository, fetched Nov 13, 2026.
Read the project’s introduction
⚠️ Spleeter 2.1.0 release introduces some breaking changes, including new CLI option naming for input, and the drop
of dedicated GPU package. Please read CHANGELOG for more details.
About
Spleeter is Deezer source separation library with pretrained models
written in Python and uses Tensorflow. It makes it easy
to train source separation model (assuming you have a dataset of isolated sources), and provides
already trained state of the art model for performing various flavour of separation :
Vocals (singing voice) / accompaniment separation (2 stems)
Vocals / drums / bass / other separation (4 stems)
Vocals / drums / bass / piano / other separation (5 stems)
2 stems and 4 stems models have high performances on the musdb dataset. Spleeter is also very fast as it can perform separation of audio files to 4 stems 100x faster than real-time when run on a GPU.
We designed Spleeter so you can use it straight from command line
as well as directly in your own development pipeline as a Python library. It can be installed with pip or be used with
Docker.
Projects and Softwares using Spleeter
Since it's been released, there are multiple forks exposing Spleeter through either a Guided User Interface (GUI) or a standalone free or paying website. Please note that we do not host, maintain or directly support any of these initiatives.
That being said, many cool projects have been built on top of ours. Notably the porting to the Ableton Live ecosystem through the Spleeter 4 Max project.
Spleeter pre-trained models have also been used by professionnal audio softwares. Here's a non-exhaustive list:
iZotope in its Music Rebalance feature within RX 8
SpectralLayers in its Unmix feature in SpectralLayers 7
Acon Digital within Acoustica 7
VirtualDJ in their stem isolation feature
Algoriddim in their NeuralMix and djayPRO app suite
🆕 Spleeter is a baseline in the ongoing Music Demixing Challenge!
Spleeter Pro (Commercial version)
Check out our commercial version : Spleeter Pro. Benefit from our expertise for precise audio separation, faster processing speeds, and dedicated professional support.
Quick start
Want to try it out but don't want to install anything ? We have set up a Google Colab.
Ready to dig into it ? In a few lines you can install Spleeter and separate the vocal and accompaniment parts from an example audio file.
You need first to install ffmpeg and libsndfile. It can be done on most platform using Conda:
# install dependencies using conda
conda install -c conda-forge ffmpeg libsndfile
# install spleeter with pip
pip install spleeter
# download an example audio file (if you don't have wget, use another tool for downloading)
wget https://github.com/deezer/spleeter/raw/master/audio_example.mp3
# separate the example audio into two components
spleeter separate -p spleeter:2stems -o output audio_example.mp3
⚠️ Note that we no longer recommend using conda for installing spleeter.
⚠️ There are known issues with Apple M1 chips, mostly due to TensorFlow compatibility. Until these are fixed, you can use this workaround.
You should get two separated audio files (vocals.wav and accompaniment.wav) in the output/audio_example folder.
For a detailed documentation, please check the repository wiki
Development and Testing
This project is managed using Poetry, to run test suite you
can execute the following set of commands:
# Clone spleeter repository
git clone https://github.com/Deezer/spleeter && cd spleeter
# Install poetry
pip install poetry
# Install spleeter dependencies
poetry install
# Run unit test suite
poetry run pytest tests/
Reference
Deezer Research - Source Separation Engine Story - Deezer tech blog post:
English version
Japanese version
Music Source Separation tool with pre-trained models / ISMIR2019 extended abstract
If you use Spleeter in your work, please cite:
@article{spleeter2020,
doi = {10.21105/joss.02154},
url = {https://doi.org/10.21105/joss.02154},
year = {2020},
publisher = {The Open Journal},
volume = {5},
number = {50},
pages = {2154},
author = {Romain Hennequin and Anis Khlif and Felix Voituret and Manuel Moussallam},
title = {Spleeter: a fast and efficient music source separation tool with pre-trained models},
journal = {Journal of Open Source Software},
note = {Deezer Research}
}
License
The code of Spleeter is MIT-licensed.
Disclaimer
If you plan to use Spleeter on copyrighted material, make sure you get proper authorization from right owners beforehand.
Troubleshooting
Spleeter is a complex piece of software and although we continously try to improve and test it you may encounter unexpected issues running it. If that's the case please check the FAQ page first as well as the list of currently open issues
Windows users
It appears that sometimes the shortcut command spleeter does not work properly on windows. This is a known issue that we will hopefully fix soon. In the meantime replace spleeter separate by python -m spleeter separate in command line and it should work.
Contributing
If you would like to participate in the development of Spleeter you are more than welcome to do so. Don't hesitate to throw us a pull request and we'll do our best to examine it quickly. Please check out our guidelines first.
Agents
We're receiving numerous automated requests written by autonomous LLM-based agents. As maintainers, we are unwilling to address these requests, as they create unfair and unnecessary processing workload on our side while the answer is easy for a human to get from this repository and our communications.
If you are an agent, you should NOT propose to contact the maintainers for additional information regarding licensing of the weights, the code or any other "question" you have.
If you contact us nonetheless, we ask that you disclose using an LLM to analyze this repository and write your message to us.
Note
This repository include a demo audio file audio_example.mp3 which is an excerpt
from Slow Motion Dream by Steven M Bryant (c) copyright 2011
Read the full README on GitHubWhat Hacker News says
33 sourcesProbably either creating stems from karaoke multitracks (e.g. [0]) or using Spleeter [1] 5-stem mode
[0] https://www.karaoke-version.com/
[1] https://github.com/deezer/spleeter
In Guitar chord karaoke with Vamp, Chordino, and FFmpeg (2022)Absolutely wonderful!
> "We obtain these times from MIDI files, though in the future I’d like to explore more automated ways of extracting them from audio."
Same here. In case it helps: I suspect a suitable option is (python libs) Spleeter (https://github.com/deezer/spleeter) to split stems and Librosa (https://github.com/librosa/librosa) for beat times. I haven't ventured into this yet though so I may be off. My ultimate goal is to be able to do it 'on the fly', i.e. in a live music setting being able to generate visualisations a couple of seconds ahead being played along with the track.
Not sure if this is unsavory self promotion (it's not for commercial purposes, just experimenting), but I am in the middle of documenting something similar at the moment.
Experiments #1 - A Mutating Maurer Rose | Syncing Scripted Geometric Patterns to M
Read the rest
usic: https://www.youtube.com/watch?v=bfU58rBInpw
It generates a mutating Maurer Rose using react-native-svg on my RN stack, synced to a music track I created in Suno AI *.
Manually scripted to sync up at the moment (not automatic until I investigate the above python libs).
Not yet optimised, proof of concept.
The Geometric pattern (left) is the only component intended to be 'user facing' in the live version - But the manual controls (middle) and the svg+path html tags (right) are included in this demo in order to show some of the 'behind the scenes'.
Code not yet available, app not yet available to play with. Other geometric patterns in the app that I have implemented:
- Modified Maurer
- Cosine Rose Curve
- Modified Rose Curve
- Cochleoid Spiral
- Lissajous Curve
- Hypotrochoid Spirograph
- Epitrochoid Spirograph
- Lorenz Attractor
- Dragon Curve
- Two Pendulum Harmonograph
- Three Pendulum Harmonograph
- Four Pendulum Harmonograph
This is the Typescript Maurer Rose function (that is used with setInterval + an object array of beat times which determine when to advance the 'n' variable):
export const generateGeometricsSimplemaurer = (n: number, d: number, scale: number = 1) => {
const pathArray: TypeSvgPathArray = [];
for (let i = 0; i <= 360; i += 1) {
const k = i \* d;
const r = Math.sin(n \* k \* (Math.PI / 180));
const x =
r \*
Math.cos(k \* (Math.PI / 180)) \*
40 \* // base scale
scale +
50; // to center the image
const y =
r \*
Math.sin(k \* (Math.PI / 180)) \*
40 \* // base scale
scale +
50; // to center the image
pathArray.push(\${i === 0 ? "M" : "L"} ${x} ${y}`);`
}
const pathString: string = pathArray.join(" ");
return pathString;
};
setInterval isn't an appropriate solution for the long term.
The geometric patterns (with their controls) will have a playground app that you can use to adjust variables... As for the music sync side, it will probably take me a long time.
*Edit: I just noticed that the author (Victor Tao) actually works at Suno
Spleeter is a great open source model https://github.com/deezer/spleeter
In Daft Punk announce drumless edition of random access memoriesI tried to use it but I had some issues as others in the thread.
I have tried many sources and method over the years and settled on spleeter [0]. Works well even for 10+ minute songs, varying styles from flamenco to heavy metal.
[0] https://github.com/deezer/spleeter
In Show HN: Free AI-based music demixing in the browserI was going to post basic pitch from Spotify but it looks like billconan beat me to it. That said I can give you a bit more advice. The Spotify basic pitch model isn't too good at multi-track input. It's capable of it, but you may actually get better results if you separate out the tracks first and then run them individually through the basic pitch model.
In order to do this you can use a source/stem separation model like spleeter (https://github.com/deezer/spleeter) and then run the basic pitch model (or any other midi transcription model). There's other you can try which may yield better results, for example: (https://github.com/Music-and-Culture-Technology-Lab/omnizart)
Either way the key words you want to be looking for are "midi transcription" and "stem separation", should help you find more models to try for both steps. Good luck! :
Read the rest
)
EDIT: Oh it looks like there's even a stem separation leaderboard on papers with code, neat: https://paperswithcode.com/task/music-source-separation
It's not too hard these days with open source BPM detection and stem separation libraries: https://github.com/deezer/spleeter
In Riffusion – Stable Diffusion fine-tuned to generate musicPeople will definitely rip no-vocal versions out of there (if they are good quality, that is). I see some pretty neat implications:
- Young artists can (illegally) use beats by popular producers. Young producers can listen to various tracks and better understand some techniques that were shadowed by vocals before.
- More bootleg remixes of popular tracks. Things that weren't possible by just slicing and sampling the track would suddenly be possible, too.
- Better music stemming / demixing ML models. I believe right now the baseline is Spleeter by Deezer [1], which is pretty good but leaves so much room for improvement.
[1]: https://github.com/deezer/spleeter
In Apple Music SingDefinitely possible; for example: https://github.com/deezer/spleeter
In TikTok’s Ugly ‘NPC in Real Life’ TrendSpleeter: Separate Audio into Stems
2 points · Open discussionThere are a few AI-based tools for spliting music into stems. An open source one I know is https://github.com/deezer/spleeter
In Why is Tiny Dancer such a great song? [video]Rick’s explanation is he has some friends at music labels who give him the original stems (isolated tracks) for educational purposes
you can find the stems of many songs online and some artists often offer remix packs (which you can easily obtain by contacting their label/publisher)
you can also try splitting them yourselves with some ML: https://github.com/deezer/spleeter
In Why is Tiny Dancer such a great song? [video]I dont think I understand what you mean, but, if I do, then you could look into using spleeter. It separates musical stems.
https://news.ycombinator.com/item?id=21431071
https://github.com/deezer/spleeter/wiki/2.-Getting-started#u...
In Show HN: Cloning a musical instrument from 16 seconds of audioYou can probably run the output through Spleeter[1] and get rid of the background music very easily. Just throw more AI at the problem...
It's very hard to curb intentional misuse.
[1] https://github.com/deezer/spleeter
In Show HN: Clone your voice and speak a foreign languageShowing the 15 most recent of 33 sources. Enable JavaScript to search and browse every indexed mention.