Skip to main content

Deep audio and image embeddings, based on Look, Listen, and Learn approach

Project description


Open-source deep audio and image embeddings.

PyPI MIT license Build Status Coverage Status Documentation Status

Please refer to the documentation for detailed instructions and examples.

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
Under review, 2018.

Installing OpenL3



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 # CPU-only version
pip install tensorflow-gpu # GPU version

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

For more detailed information, please consult the pysoundfile installation documentation.

Installing openl3

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:

  1. Clone or pull the lastest version:

     git clone
  2. Install using pip to handle python dependencies:

     cd openl3
     pip install -e .

Using OpenL3

To help you get started with openl3, please see the tutorial.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for openl3, version 0.1.0rc5
Filename, size File type Python version Upload date Hashes
Filename, size openl3-0.1.0rc5.tar.gz (10.3 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page