Local vocal removal / audio source separation
Project description
voice-remover
Local vocal removal and audio source separation.
Install
pip install voice-remover
Usage
voice-remover "track.mp3" ./outputs/
voice-remover "track.mp3" ./outputs/ --device cuda
voice-remover "track.mp3" ./outputs/ --device mps
Output files are saved as <track>_no_vocals.mp3 in the specified directory.
Arguments
| Argument | Description |
|---|---|
input_file |
Path to the input audio file |
output_dir |
Directory where the output MP3 will be saved |
Options
| Flag | Default | Description |
|---|---|---|
--device |
cpu |
Inference device: cpu, cuda, mps |
Requirements
- Python 3.11–3.14
- FFmpeg (
brew install ffmpeg/apt install ffmpeg)
Model weights download automatically on first run from Hugging Face (
felipeinfantino/voice-remover). Cached at~/.cache/voice-remover/models/.
Development
git clone https://github.com/felipeinfantino/voice-remover
cd voice-remover
poetry install
poetry run voice-remover "track.mp3" ./outputs/
Extending with new pagackage
poetry add [packagename]
#check the cli is still working
poetry run voice-remover "track.mp3" ./outputs/
# Verify lockfile is clean
poetry lock
# Bump version
poetry version patch # or minor / major
License
MIT
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file voice_remover-0.1.1.tar.gz.
File metadata
- Download URL: voice_remover-0.1.1.tar.gz
- Upload date:
- Size: 7.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/2.3.2 CPython/3.11.14 Darwin/24.3.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
12caf4c2c055059a6a45e35edb4fd17981f852e7635bcffeaf2327b636b05242
|
|
| MD5 |
325e8a344574c88c5ac699b35eeac4d1
|
|
| BLAKE2b-256 |
4c3006b7b6b3daabb1b3f37c019e8143018c4b5b3adb5021bcad20d320f8a588
|
File details
Details for the file voice_remover-0.1.1-py3-none-any.whl.
File metadata
- Download URL: voice_remover-0.1.1-py3-none-any.whl
- Upload date:
- Size: 10.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/2.3.2 CPython/3.11.14 Darwin/24.3.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
60613bf50392c6ee6aefbdbbbb6e50e80c8bc9a350fd6b86b402652dd4212443
|
|
| MD5 |
914ef4e48335ab728a38748ec9253727
|
|
| BLAKE2b-256 |
e4f6b89c593a54500c3f639a7d62033d9efd9d3873ccbf78a18e99d9b4efd932
|
