{"library":"pedalboard","title":"Pedalboard","description":"Pedalboard is a Python library for working with audio: reading, writing, rendering, adding effects, and more. Built by Spotify's Audio Intelligence Lab, it supports most popular audio file formats, a number of common audio effects out of the box, and also allows the use of VST3® and Audio Unit formats for loading third-party software instruments and effects. It's designed for high-performance audio processing, including use in machine learning workflows with TensorFlow. The current version is 0.9.22 and it is actively maintained.","language":"python","status":"active","last_verified":"Fri May 15","install":{"commands":["pip install pedalboard"],"cli":null},"imports":["from pedalboard import Pedalboard","from pedalboard.io import AudioFile"],"auth":{"required":false,"env_vars":[]},"quickstart":{"code":"import numpy as np\nfrom pedalboard import Pedalboard, Chorus, Reverb, Gain\nfrom pedalboard.io import AudioFile\n\n# Generate a 1-second sine wave at 44.1 kHz\nsamplerate = 44100\nduration = 1.0 # seconds\nfrequency = 440.0 # Hz\nt = np.linspace(0., duration, int(samplerate * duration), endpoint=False)\naudio = 0.5 * np.sin(2 * np.pi * frequency * t)\n\n# Ensure audio is float32 for Pedalboard\naudio = audio.astype(np.float32)\n\n# Create a Pedalboard with some effects\nboard = Pedalboard([\n    Chorus(rate_hz=1.0, depth=0.5, mix=0.5),\n    Reverb(room_size=0.7, dampening=0.5, wet_level=0.2, dry_level=0.8),\n    Gain(gain_db=3.0)\n])\n\n# Process the audio\neffected_audio = board(audio, samplerate, reset=False)\n\n# Write the output to a WAV file\noutput_filename = 'output_effected_audio.wav'\nwith AudioFile(output_filename, 'w', samplerate, effected_audio.shape[0]) as f:\n    f.write(effected_audio)\n\nprint(f\"Processed audio saved to {output_filename}\")","lang":"python","description":"This quickstart generates a simple sine wave, applies a chorus, reverb, and gain effect using a `Pedalboard` object, and then saves the processed audio to a WAV file. It demonstrates the basic workflow of creating a pedalboard and processing audio buffers.","tag":null,"tag_description":null,"last_tested":null,"results":[]},"compatibility":{"tag":null,"tag_description":null,"last_tested":"2026-05-15","installed_version":"0.9.19","pypi_latest":"0.9.22","is_stale":true,"summary":{"python_range":"3.10–3.9","success_rate":90,"avg_install_s":4.1,"avg_import_s":0.27,"wheel_type":"wheel"},"results":[{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"pedalboard","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.24,"mem_mb":7,"disk_size":"103.1M"},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"pedalboard","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":3.8,"import_time_s":null,"mem_mb":null,"disk_size":"97M"},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"pedalboard","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.33,"mem_mb":7.4,"disk_size":"117.6M"},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"pedalboard","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":3.7,"import_time_s":null,"mem_mb":null,"disk_size":"104M"},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"pedalboard","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.3,"mem_mb":7.3,"disk_size":"99.0M"},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"pedalboard","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":3.6,"import_time_s":null,"mem_mb":null,"disk_size":"93M"},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"pedalboard","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":"pedalboard","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":3.8,"import_time_s":null,"mem_mb":null,"disk_size":"92M"},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"pedalboard","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.22,"mem_mb":6.7,"disk_size":"117.9M"},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"pedalboard","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":5.4,"import_time_s":null,"mem_mb":null,"disk_size":"107M"}]}}