Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

librosa logo

librosa

librosa is a Python library for audio and music signal processing. It provides the foundational algorithms and tools required for building music information retrieval (MIR) systems.

PyPI Anaconda-Server Badge License DOI

CI codecov Docs Scientific Python Ecosystem Coordination

Documentation

Full documentation is available at:

If you're new to librosa, we recommend starting with the tutorials.

If you're looking for API details, head directly to the API reference.

To see what's new, check out the change log.

Installation

Using PyPI

The latest stable release is available on PyPI, and you can install it by the command

pip install librosa

Using conda

Anaconda users can install using conda-forge:

conda install -c conda-forge librosa

For optional dependencies and advanced setup, see the guide in the documentation.


Citing

There are two ways to cite librosa in scholarly work, depending on whether you are citing it for its use in your work or for its design and motivation.

We additionally encourage you to cite the original publications describing the methods implemented in librosa, in addition to citing librosa itself. References can often be found within function documentation.

Citing for use

If you are citing for use in your own work, please cite the version you used by retrieving the appropriate DOI and citation information from Zenodo.

DOI

This ensures that all contributing authors are credited for the work you are building on.

From librosa version 0.10.2 or later, you can also use librosa.cite() to get the DOI link for any version of librosa:

import librosa
librosa.cite()

And from 1.0 onward, you can directly retrieve the BibTeX entry for the version you are using:

print(librosa.cite(bib=True))

Citing for design

If you wish to cite librosa for its design, motivation, etc., please cite the paper published at SciPy 2015:

McFee, Brian, Colin Raffel, Dawen Liang, Daniel PW Ellis, Matt McVicar, Eric Battenberg, and Oriol Nieto.
"librosa: Audio and music signal analysis in python."
In Proceedings of the 14th python in science conference, pp. 18-25. 2015.

As a rule of thumb:

  • Use a versioned librosa citation to document the software implementation used in your experiments.
  • Cite the original methodological papers for the algorithms that are central to your work.
  • Cite the SciPy paper when discussing librosa itself, its design, or its contribution as a software library.

Metadata

Release files for librosa 1.0.0rc0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for librosa 1.0.0rc0
File Size Uploaded
librosa-1.0.0rc0.tar.gz 377.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for librosa 1.0.0rc0
File Interpreter ABI Platform
librosa-1.0.0rc0-py3-none-any.whl Python 3 none any Details

Total release size: 672.0 kB

Release files / librosa-1.0.0rc0.tar.gz

Download URL librosa-1.0.0rc0.tar.gz
Size 377.4 kB
Tags Source
SHA-256 checksum
How to use checksums
4fc8a0c9ac5022e5300d87beae74169754c7606822a2916febec36feafa28c56
BLAKE2b-256 checksum
How to use checksums
201aeb4058bb4965fc518e45a12bfc430fdc1934201f451d26883a70ed37d95b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jul 31, 2026.

Transparency log

Release files / librosa-1.0.0rc0-py3-none-any.whl

Download URL librosa-1.0.0rc0-py3-none-any.whl
Size 294.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
0ba27e2c5baa484b2d47bb9cd86954332dfd71c539c5dbe3bd515f8edf3754e6
BLAKE2b-256 checksum
How to use checksums
dadcfc291fe9578bfb4292cdb5d93bdd4ade3bcd00a91ae4d2943874840fd21c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jul 31, 2026.

Transparency log

Release history Release notifications | RSS feed

1.0.0

2 release files

This release

1.0.0rc0 This release

2 release files

0.11.0

2 release files

0.10.1

2 release files

0.10.0

2 release files

0.9.2

2 release files

0.9.1

2 release files

0.9.0

2 release files

0.8.1

2 release files

0.8.0

1 release file

0.7.2

1 release file

0.7.1

1 release file

0.7.0

1 release file

0.6.3

1 release file

0.6.2

1 release file

0.6.1

1 release file

0.6.0

1 release file

0.5.1

1 release file

0.5.0

1 release file

0.4.3

1 release file

0.4.2

1 release file

0.4.1

1 release file

0.4.0

1 release file

0.4.0-pre

0.3.1

1 release file

0.3.0

1 release file

0.2.1

2 release files

0.2.0

3 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page