voice-remover
Local vocal removal and audio source separation.
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/.
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 |
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
Git build versioning
Let x.y.z be the new bumped version:
git tag v[x.y.z]
git push origin main --tags
License
MIT
1 maintainer
Metadata
1 maintainer
Release files for voice-remover 0.1.6
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| voice_remover-0.1.6.tar.gz | 7.9 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| voice_remover-0.1.6-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 18.4 kB
Release files / voice_remover-0.1.6.tar.gz
| Download URL | voice_remover-0.1.6.tar.gz |
|---|---|
| Size | 7.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
13dc29e23defdbe601357292ac52db2c45b337214c1ce1ef437704e3b200dc56
|
|
BLAKE2b-256 checksum How to use checksums |
903e3d7dd8640626f658671268f9dadf42d5604e1a187cd24c1454f418df8c0e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.3.2 CPython/3.11.15 Linux/6.14.0-1017-azure
|
Release files / voice_remover-0.1.6-py3-none-any.whl
| Download URL | voice_remover-0.1.6-py3-none-any.whl |
|---|---|
| Size | 10.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
317c98d0d4ec91efa5229b3cad76f92021832b0ebee79540d75bfb2dbac6206f
|
|
BLAKE2b-256 checksum How to use checksums |
495676a9e1de089864feeb6713c6f5b98ce7687635e5027d4e83861503a78993
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.3.2 CPython/3.11.15 Linux/6.14.0-1017-azure
|
Security for voice-remover 0.1.6
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
