{"library":"openunmix","title":"Open-Unmix","description":"Open-Unmix is a PyTorch-based music source separation toolkit that provides pre-trained models and a flexible framework for separating audio into its constituent parts (vocals, drums, bass, other). The current version is 1.3.0, and the library is actively maintained with regular updates addressing bug fixes, performance improvements, and new model releases.","language":"python","status":"active","last_verified":"Fri May 15","install":{"commands":["pip install openunmix"],"cli":{"name":"umx","version":""}},"imports":["from openunmix.separate import separate_audio"],"auth":{"required":false,"env_vars":[]},"quickstart":{"code":"import torch\nimport numpy as np\nfrom openunmix.separate import separate_audio\n\n# Simulate stereo audio data (e.g., 10 seconds at 44.1 kHz)\nsr = 44100\nduration = 10  # seconds\nnum_frames = sr * duration\n\n# Create a dummy audio tensor: (channels, samples)\n# In a real scenario, load an audio file using torchaudio.load() or similar.\naudio_data_np = np.random.randn(2, num_frames).astype(np.float32)\naudio_tensor = torch.from_numpy(audio_data_np)\n\n# Separate the audio into stems\n# By default, 'umxl' model is used from v1.2.1 onwards\nestimates = separate_audio(audio_tensor, rate=sr)\n\n# 'estimates' is a dictionary with keys like 'vocals', 'drums', 'bass', 'other'\n# Each value is a torch.Tensor representing the separated stem.\nprint(\"Separated stems and their shapes:\")\nfor stem_name, stem_tensor in estimates.items():\n    print(f\"  {stem_name}: {stem_tensor.shape}\")\n\n# Example: access vocals\nvocals = estimates['vocals']\n# print(f\"Vocals stem shape: {vocals.shape}\")","lang":"python","description":"This quickstart demonstrates how to use the `separate_audio` function to perform music source separation. It simulates loading a stereo audio signal and outputs a dictionary of separated stems, each as a PyTorch tensor. The `umxl` model is used by default for inference from version 1.2.1 onwards.","tag":null,"tag_description":null,"last_tested":null,"results":[]},"compatibility":{"tag":null,"tag_description":null,"last_tested":"2026-05-15","installed_version":"1.3.0","pypi_latest":"1.3.0","is_stale":false,"summary":{"python_range":"3.10–3.9","success_rate":40,"avg_install_s":66.8,"avg_import_s":null,"wheel_type":"wheel"},"results":[{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"openunmix","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"openunmix","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":76.6,"import_time_s":null,"mem_mb":null,"disk_size":"4.7G"},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"openunmix","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"openunmix","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":68.9,"import_time_s":null,"mem_mb":null,"disk_size":"4.8G"},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"openunmix","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"openunmix","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":64.9,"import_time_s":null,"mem_mb":null,"disk_size":"4.7G"},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"openunmix","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"openunmix","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":56.9,"import_time_s":null,"mem_mb":null,"disk_size":"4.7G"},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"openunmix","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"openunmix","exit_code":1,"wheel_type":null,"failure_reason":"timeout","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null}]}}