explaingit

deezer/spleeter

Analysis updated 2026-06-20

28,203PythonAudience · generalComplexity · 3/5LicenseSetup · moderate

TLDR

Spleeter is an AI tool from Deezer that splits any finished song into separate instrument tracks, vocals, drums, bass, piano, using pretrained deep learning models, without needing the original studio files.

Mindmap

mindmap
  root((spleeter))
    What it does
      Separates audio stems
      Vocals extraction
      Drums isolation
      Bass isolation
    Models
      2-stem model
      4-stem model
      5-stem model
    Tech Stack
      Python
      TensorFlow
      ffmpeg
      Docker
    Use Cases
      Karaoke creation
      Stem sampling
      Music transcription
      DJ software input
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Create a karaoke version of any song by removing the vocals from the final stereo recording.

USE CASE 2

Isolate drum or bass lines from a track for sampling, remixing, or transcription.

USE CASE 3

Feed clean stem files (vocals, drums, bass) into DJ software or other music production tools.

USE CASE 4

Batch-process a folder of songs to extract instrument stems automatically from the command line.

What is it built with?

PythonTensorFlowffmpegDocker

How does it compare?

deezer/spleetergoogle/python-firestanford-oval/storm
Stars28,20328,18228,162
LanguagePythonPythonPython
Setup difficultymoderateeasymoderate
Complexity3/52/53/5
Audiencegeneraldeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires ffmpeg and libsndfile installed, a GPU is optional but provides roughly 100x faster processing than CPU.

Free to use for any purpose including commercial projects, as long as you keep the copyright notice.

In plain English

Spleeter is a music source separation library from Deezer that takes a finished song and pulls it apart into its individual instrument tracks. Feed in an MP3 or WAV, and it can output the vocals on one file and the rest of the mix on another, or split it further into separate vocal, drums, bass, piano, and "other" tracks. This kind of unmixing used to require the original studio session files, Spleeter does it from the final stereo recording using pretrained deep learning models. Under the hood it is written in Python and uses TensorFlow, and the project ships three pretrained models out of the box: a 2-stem model (vocals and accompaniment), a 4-stem model (vocals, drums, bass, other), and a 5-stem model that also isolates piano. The 2 and 4-stem models perform well on the standard musdb benchmark, and on a GPU the separation runs roughly 100 times faster than the actual length of the audio. You can use it from the command line or import it as a Python library, install it with pip, run it inside Docker, or try it without installing anything through a hosted Google Colab notebook. It depends on ffmpeg and libsndfile for audio handling. You would reach for this when you want a karaoke version of a track, want to isolate a drum or bass line for sampling or transcription, or want to feed clean stems into another music tool. The README notes that Spleeter is already used inside professional audio software like iZotope RX 8, Steinberg SpectralLayers, Acon Digital Acoustica, VirtualDJ, and Algoriddim's NeuralMix and djayPRO apps. The code is MIT licensed, and Deezer also offers a paid Spleeter Pro version with faster processing and support.

Copy-paste prompts

Prompt 1
Use Spleeter to separate the vocals from this MP3 and save the vocal and accompaniment as separate WAV files.
Prompt 2
Run Spleeter's 4-stem model on a batch of songs to extract vocals, drums, bass, and other tracks into separate files.
Prompt 3
How do I run Spleeter in a Docker container so I don't have to install ffmpeg and TensorFlow manually?
Prompt 4
Integrate Spleeter into my Python script to automatically extract vocal stems from uploaded audio files and save them to a folder.

Frequently asked questions

What is spleeter?

Spleeter is an AI tool from Deezer that splits any finished song into separate instrument tracks, vocals, drums, bass, piano, using pretrained deep learning models, without needing the original studio files.

What language is spleeter written in?

Mainly Python. The stack also includes Python, TensorFlow, ffmpeg.

What license does spleeter use?

Free to use for any purpose including commercial projects, as long as you keep the copyright notice.

How hard is spleeter to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is spleeter for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub deezer on gitmyhub

Verify against the repo before relying on details.