OpenL3 is an open-source Python library for computing deep audio and image embeddings.
Please refer to the documentation for detailed instructions and examples.
The audio and image embedding models provided here are published as part of [1], and are based on the Look, Listen and Learn approach [2]. For details about the embedding models and how they were trained, please see:
Look, Listen and Learn More: Design Choices for Deep Audio Embeddings
Jason Cramer, Ho-Hsiang Wu, Justin Salamon, and Juan Pablo Bello.
IEEE Int. Conf. on Acoustics, Speech and Signal Processing (ICASSP), pages 3852–3856, Brighton, UK, May 2019.
Because Tensorflow comes in CPU-only and GPU variants, we leave it up to the user to install the version that best fits their usecase.
On most platforms, either of the following commands should properly install Tensorflow:
pip install "tensorflow<1.14" # CPU-only version
pip install "tensorflow-gpu<1.14" # GPU version
Please note that Tensorflow 2.x is not yet supported. Ensure that an earlier version of Tensorflow is installed. If you run into further issues with installation, a known working dependency combination is Tensorflow 1.13, Keras 2.0, and Kapre 0.1.4.
For more detailed information, please consult the Tensorflow installation documentation.
OpenL3 depends on the pysoundfile module to load audio files, which depends on the non-Python library
libsndfile. On Windows and macOS, these will be installed via pip and you can therefore skip this step.
However, on Linux this must be installed manually via your platform's package manager.
For Debian-based distributions (such as Ubuntu), this can be done by simply running
apt-get install libsndfile1
Alternatively, if you are using conda, you can install libsndfile simply by running
conda install -c conda-forge libsndfile
For more detailed information, please consult the
pysoundfile installation documentation.
The simplest way to install OpenL3 is by using pip, which will also install the additional required dependencies
if needed. To install OpenL3 using pip, simply run
pip install openl3
To install the latest version of OpenL3 from source:
-
Clone or pull the lastest version:
git clone git@github.com:marl/openl3.git -
Install using pip to handle python dependencies:
cd openl3 pip install -e .
To help you get started with OpenL3 please see the tutorial.
Please cite the following papers when using OpenL3 in your work:
[1] Look, Listen and Learn More: Design Choices for Deep Audio Embeddings
Jason Cramer, Ho-Hsiang Wu, Justin Salamon, and Juan Pablo Bello.
IEEE Int. Conf. on Acoustics, Speech and Signal Processing (ICASSP), pages 3852–3856, Brighton, UK, May 2019.
[2] Look, Listen and Learn
Relja Arandjelović and Andrew Zisserman
IEEE International Conference on Computer Vision (ICCV), Venice, Italy, Oct. 2017.