Guide to installing a free, open-source AI music separator that runs on your own computer. Separate vocals, drums, bass, and instruments from songs (MP3, WAV) or YouTube links to create karaoke/instrumental tracks. No APIs or subscriptions needed. Simple setup with Docker or Python.

how-to-install-ai-vocal-remover-and-instrument-separator.md

Quick Start: AI Vocal Remover & Instrument Separator

A free and open-source tool that turns your computer into an AI-powered audio separation studio. It runs entirely on your local machine, meaning no external APIs, no subscriptions, and no costs. Separate vocals, drums, bass, and other instruments from any song file or YouTube link using Meta's powerful Demucs AI model.

Full documentation and source code: https://github.com/paladini/voice-separator-demucs

---

🚀 Easiest Installation (Docker)

This is the recommended method. It requires Docker to be installed.

Step 1: Clone the Repository

Open your terminal and run:

git clone [https://github.com/paladini/voice-separator-demucs.git](https://github.com/paladini/voice-separator-demucs.git)
cd voice-separator-demucs

Step 2: Run with Docker Compose

This single command will build and start the application in the background.

docker compose up -d

Step 3: Open the Web Interface

Once it's running, open your web browser and go to: http://localhost:7860

---

🎵 How to Use

1. Select Stems: Choose which parts you want to separate (e.g., vocals, drums).
2. Provide Source:
   • Option A: Upload an audio file (MP3, WAV, FLAC, etc.).
   • Option B: Paste a YouTube video URL.
3. Separate: Click the "Separate" button and wait for the processing to finish.
4. Download: Your separated audio files will appear, ready for download.

Your output files will be saved locally in the static/output/ folder inside the project directory.

---

🔧 Alternative: Python Setup (No Docker)

If you prefer not to use Docker, you can run it directly with Python.

Prerequisites:

• Python 3.8+
• FFmpeg

# 1. Install FFmpeg
# On Ubuntu/Debian:
sudo apt-get update && sudo apt-get install ffmpeg
# On macOS (using Homebrew):
brew install ffmpeg

# 2. Navigate to the cloned project folder
cd voice-separator-demucs

# 3. Install Python dependencies
pip install -r requirements.txt

# 4. Run the application
python main.py

Then, access the interface at http://localhost:7860.