librosa：Python 音频与音乐信号处理库｜部署与使用全指南
项目仓库： https://github.com/librosa/librosa
文档：librosa.org/doc ·
许可证：ISC · 形态：Python 库 · PyPI：librosa ·
DOI：10.5281/zenodo.591533
1 项目简介
librosa 是 Python 音频与音乐信号处理库：提供构建音乐信息检索（MIR）系统所需的基础算法与工具，是学术界与工业界最常用的音频特征提取库之一。
1.1 核心信息一览
| 项目项 | 内容 |
|---|---|
| 项目名称 | librosa |
| 仓库地址 | github.com/librosa/librosa |
| 文档 | librosa.org/doc |
| 许可证 | ISC |
| PyPI | librosa |
| DOI | 10.5281/zenodo.591533 |
1.2 适用场景
- 音频特征提取（Mel、MFCC、chroma、tonnetz）。
- 节拍/ onset 检测。
- MIR 研究教学。
2 功能特性
- 加载与保存：
librosa.load。 - 特征：Mel spectrogram、MFCC、chroma、tonnetz、spectral centroid。
- 节拍/onset：beat tracking、onset detection。
- 时频表示：STFT、CQT、MFCC。
3 官方跳转链接汇总
| 类别 | 链接 | 说明 |
|---|---|---|
| 仓库 | github.com/librosa/librosa | 源码 |
| 文档 | librosa.org/doc | API |
| 教程 | auto_tutorials | 入门 |
| API | librosa.org/doc/latest/api | 参考 |
4 前置要求
- Python 3.9+。
5 方式一：pip 安装
pip install librosa6 方式二：conda 安装
conda install -c conda-forge librosa7 基础用法
import librosa
y, sr = librosa.load("audio.wav")
mfcc = librosa.feature.mfcc(y=y, sr=sr)8 常见故障排查
- 可选依赖：参考文档"可选依赖与高级设置"。
- 解码失败：装 ffmpeg/avconv 支持更多格式。
9 风险与合规说明
- ISC 许可（类 BSD）。
- 库本身无内容风险。
本文基于官方 README 整理，仅供学习与部署参考；以仓库最新说明为准。