pedalboard
A Python library for adding effects to audio.
Decision gist · record as of 2026-08-14
Yes, if you need to process audio with effects in Python. The library is actively maintained, well-documented, and widely used (top 5000 on PyPI). GPLv3 is a significant constraint: only install if your project can be GPLv3 or if you're using it internally. No known vulnerabilities. Medium install friction is acceptable for a compiled audio library.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10 or later.
- Platform wheels are provided for macOS (Intel and ARM), Linux (x86_64 and aarch64), and Windows (amd64); other platforms require compilation.
- Medium install friction due to compiled wheels for multiple platforms and Python versions (3.10–3.14).
License · maintenance · safety
copyleft license (copyleft) — GPLv3 copyleft license: any derivative work or distribution must also be GPLv3. If you modify pedalboard or bundle it into a proprietary application, you must open-source that work under the same license.
last release 2026-07-08 (37 days)
0 known vulnerabilities (OSV.dev, 2026-08-14) · 4,363,778 downloads/mo, #2,320 on PyPI
Alternatives
Verify before relying
pip install pedalboard
from pedalboard import Pedalboard, Reverb
from pedalboard.io import AudioFile
import numpy as np
with AudioFile('input.wav') as f:
audio = f.read(f.frames)
board = Pedalboard([Reverb(room_size=0.25)])
effected = board(audio, f.samplerate)
with AudioFile('output.wav', 'w', f.samplerate, effected.shape[0]) as o:
o.write(effected)- Whether VST3 and Audio Unit plugin loading works reliably across all supported platforms in production use.
- Performance characteristics of GIL release and multi-threaded audio processing in real-world workloads.
What it is and what it does
pedalboard is a Python audio processing library built by Spotify's Audio Intelligence Lab that lets you read, write, and apply effects to audio files and streams. It provides built-in effects—reverb, distortion, compression, equalization, pitch shifting, and others—and can load third-party VST3 plugins (on macOS, Windows, and Linux) and Audio Units (on macOS). The library is designed for speed and thread-safety, releasing Python's GIL to enable multi-core processing without multiprocessing overhead.
The package is commonly used for audio data augmentation in machine learning pipelines, content creation without a Digital Audio Workstation, and real-time audio processing. It integrates with TensorFlow's tf.data pipelines and supports most common audio formats (WAV, FLAC, MP3, OGG, AIFF) natively on all platforms, with additional format support depending on the OS.
Use it for
- Augment audio datasets for machine learning by applying random effects (reverb, compression, pitch shift) to training data.
- Build a guitar effects chain in Python by stacking effects like distortion, chorus, and reverb without a DAW.
- Load and automate VST3 plugins from Python to process audio in batch or real-time workflows.
- Resample and process large audio files efficiently with minimal memory overhead using on-the-fly resampling.
- Integrate audio processing into TensorFlow pipelines for end-to-end ML workflows with augmentation.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you need to process audio with effects in Python.
The library is actively maintained, well-documented, and widely used (top 5000 on PyPI). GPLv3 is a significant constraint: only install if your project can be GPLv3 or if you're using it internally. No known vulnerabilities. Medium install friction is acceptable for a compiled audio library.
Install
pedalboard on PyPI
Before you install
Medium install friction due to compiled wheels for multiple platforms and Python versions (3.10–3.14). Active maintenance with recent release (37 days ago). Requires only numpy as a runtime dependency.
Requires Python 3.10 or later. Platform wheels are provided for macOS (Intel and ARM), Linux (x86_64 and aarch64), and Windows (amd64); other platforms require compilation.
License in practice
GPLv3 copyleft license: any derivative work or distribution must also be GPLv3. If you modify pedalboard or bundle it into a proprietary application, you must open-source that work under the same license.
Quickstart
pip install pedalboard
from pedalboard import Pedalboard, Reverb
from pedalboard.io import AudioFile
import numpy as np
with AudioFile('input.wav') as f:
audio = f.read(f.frames)
board = Pedalboard([Reverb(room_size=0.25)])
effected = board(audio, f.samplerate)
with AudioFile('output.wav', 'w', f.samplerate, effected.shape[0]) as o:
o.write(effected)Verify before relying
- Whether VST3 and Audio Unit plugin loading works reliably across all supported platforms in production use.
- Performance characteristics of GIL release and multi-threaded audio processing in real-world workloads.
Package facts
| License | copyleft license copyleft |
| Python support | Supports the current Python release >=3.10 |
| Install friction | Medium. Platform-specific wheel |
| Runtime dependencies | 1 packagenumpy |
| Maintenance | Actively maintained 37 days since the last release |
| First released | |
| Downloads | 4,363,778 / month, #2,320 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 4 - BetaLicense :: OSI Approved :: GNU General Public License v3 (GPLv3)Operating System :: MacOSOperating System :: Microsoft :: WindowsOperating System :: POSIX :: LinuxProgramming Language :: C++Programming Language :: PythonProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Topic :: Multimedia :: Sound/Audio |
Evidence: pedalboard-0.9.24-cp310-cp310-macosx_10_14_x86_64.whl; pedalboard-0.9.24-cp310-cp310-macosx_11_0_arm64.whl; pedalboard-0.9.24-cp310-cp310-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl; pedalboard-0.9.24-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl; pedalboard-0.9.24-cp310-cp310-musllinux_1_2_aarch64.whl; pedalboard-0.9.24-cp310-cp310-musllinux_1_2_x86_64.whl; pedalboard-0.9.24-cp310-cp310-win_amd64.whl; pedalboard-0.9.24-cp311-cp311-macosx_10_14_x86_64.whl; pedalboard-0.9.24-cp311-cp311-macosx_11_0_arm64.whl; pedalboard-0.9.24-cp311-cp311-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl; pedalboard-0.9.24-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl; pedalboard-0.9.24-cp311-cp311-win_amd64.whl; pedalboard-0.9.24-cp312-cp312-macosx_10_14_universal2.whl; pedalboard-0.9.24-cp312-cp312-macosx_10_14_x86_64.whl; pedalboard-0.9.24-cp312-cp312-macosx_11_0_arm64.whl; pedalboard-0.9.24-cp312-cp312-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl; pedalboard-0.9.24-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl; pedalboard-0.9.24-cp312-cp312-musllinux_1_2_aarch64.whl; pedalboard-0.9.24-cp312-cp312-musllinux_1_2_x86_64.whl; pedalboard-0.9.24-cp312-cp312-win_amd64.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “audio effects processing python”
- pedalboardpedalboard reads, writes, and processes audio files with built-in…
- soxPython wrapper that exposes SoX audio processing…
- audiolabaudiolab loads, processes, and saves audio files in multiple formats…
Give your agent the search over MCP, or paste the wish link into any chat.
More Sound/Audio packages
Reads and writes audio files in formats like WAV, FLAC, OGG, and MAT through libsndfile, exposing audio data as NumPy arrays.
Pydub provides a high-level Python interface for loading, manipulating, and exporting audio files with simple operations like slicing, concatenation, and format conversion.
However, the abandoned status since 2021-03-10 means no future fixes or compatibility updates—use it only if you can tolerate potential issues with newer Python…
Mutagen reads and writes audio metadata (tags) across many audio formats including MP3, FLAC, OGG, MP4, WavPack, and others, supporting ID3v2 and APEv2 tag editing.
Install it if you need to read or edit audio tags programmatically.
Provides PyTorch-based audio processing, transforms, and dataloaders for machine learning tasks, with GPU acceleration and autograd support for trainable audio features.
MoviePy is a Python library for video editing that reads, processes, and writes video and audio files by converting them to numpy arrays for frame-level manipulation and effect application.
Reads metadata (artist, title, duration, bitrate, and more) from audio files in formats including MP3, MP4, FLAC, OGG, WAV, and others, without writing or modifying tags.
Install it if you need to extract metadata from audio files without the overhead of a heavier library.
See also audiomentations · audiofile · audiolab · sox · torch-audiomentations · descript-audiotools · SoundCard · fmod-toolkit · miniaudio