Stemify - The Audio Splitter

A web application for audio track separation. This application allows you to upload an audio file and separate it into its components: vocals, drums, bass, and other instruments.

🚀 Features

• Intuitive web interface
• Real-time track separation using AI
• Audio preview of separated tracks
• Download individual tracks
• Support for various audio formats
• Fast processing with Demucs v4

📋 Prerequisites

• Python 3.12 or higher
• uv (Python package manager) - install it with: curl -LsSf https://astral.sh/uv/install.sh | sh
• npm (Node Package Manager)
• Git

💻 Installation

Quick Installation for Linux and macOS

1. Clone the repository:

git clone https://github.com/huchukato/stemify-audio-splitter.git
cd stemify-audio-splitter

2. Run the installation script:

chmod +x linux_mac_install_run.sh
./linux_mac_install_run.sh

3. Open your browser and navigate to http://localhost:5173

Manual Installation

1. Backend Setup:

cd demucs-backend
uv sync
mkdir -p temp separated
uv run python -m gunicorn --bind 0.0.0.0:5001 --workers 1 --timeout 120 app:app

2. Frontend Setup (in another terminal):

cd demucs-gui
npm install
npm run dev

3. Open your browser and navigate to http://localhost:5173

🎵 How to Use

1. Upload an audio file (MP3, WAV, FLAC, etc.)
2. Wait for the AI to process and separate the tracks
3. Preview each separated track
4. Download the individual tracks you want

🛠️ Technology Stack

• Backend: Flask + Demucs v4
• Frontend: React + Vite + Tailwind CSS
• Audio Processing: Facebook's Demucs v4 model
• Package Management: uv (Python), npm (Node.js)

Windows Installation

1. Clone the repository:

git clone https://github.com/huchukato/stemify-audio-splitter.git
cd stemify-audio-splitter

2. Run the installation script:

.\win_install_run.bat

3. Open your browser and navigate to http://localhost:5173

🎵 How to Use

1. Upload an audio file (MP3, WAV, FLAC, etc.)
2. Wait for the AI to process and separate the tracks
3. Preview each separated track
4. Download the individual tracks you want

🔧 Troubleshooting

• Backend not starting: Make sure port 5001 is not in use
• Frontend not loading: Check that npm installed successfully
• Audio processing fails: Ensure the audio file is under 20MB

�️ Security

This project maintains a strong security posture with regular vulnerability assessments and prompt patching.

Recent Security Fixes:

• ✅ March 2026: Complete security audit resolution
  • Fixed all 15+ vulnerabilities via npm audit
  • Updated rollup (CVE-2026-27606), tar (CVE-2026-26960), minimatch (CVE-2026-27903)
  • Resolved all HIGH and MODERATE severity alerts
  • Status: 0 vulnerabilities (npm audit)

Security Practices:

• 🔍 Regular Audits: Automated Dependabot monitoring
• 🚀 Prompt Updates: Security patches applied immediately
• 📋 Vulnerability Disclosure: Transparent security reporting
• 🔒 Secure Dependencies: All packages kept up-to-date

�📝 License

This project is open source and available under the MIT License.

👥 Author

• huchukato
  • 🐙 GitHub
  • 🐦 X (Twitter)
  • 🎨 Civitai - Check out my AI art models!

🙏 Acknowledgments

• Facebook Research for the Demucs v4 model
• The open-source community for the amazing tools and libraries used in this project