We provide docker images for the latest version of Essentia, which contain examples (command-line feature extractors), python bindings and vamp plugins.
As of April 2023 these images are hosted on Github Container Registry. Previously they were hosted on Docker Hub
at mtgupf/essentia and mtgupf/essentia-nightly. Images on Docker Hub are no longer maintained.
For a more up-to-date version of essentia we provide the nightly tag of the ghcr.io/mtg/essentia image. This is updated periodically
based on the most recent commit on the master branch of essentia.
This tag is based on Ubuntu 22.04 LTS:
latest(Dockerfile.ubuntu22.04-nightly)
Images using the following base images are available:
- ubuntu:20.04 (latest ubuntu LTS supported by this release)
- debian:bullseye (debian "stable")
The current available tags are:
ubuntu20.04-v2.1_beta5(Dockerfile.ubuntu20.04-v2.1_beta5)bullseye-v2.1_beta5(Dockerfile.bullseye-v2.1_beta5)
These images are based off the v2.1_beta5 release of the main essentia source tree.
We no longer provide a dedicated docker image with support for tensorflow included. Instead, you should use any base docker image with Python available and install our essentia-tensorflow, python wheel, e.g.,
FROM ubuntu:22.10
RUN pip install --no-cache-dir essentia-tensorflow
We no longer officially support Python 2, however we include a Dockerfile to build Essentia with Python 2 on Ubuntu 18.04 LTS in the python2 directory.
Analyze a file audio.wav located in the current directory and write results to the same directory:
docker run -ti --rm -v `pwd`:/essentia ghcr.io/mtg/essentia essentia_streaming_extractor_music audio.wav audio.sig
Run a python script using Essentia located in the current directory:
docker run -ti --rm -v `pwd`:/essentia ghcr.io/mtg/essentia python3 test.py
You can rebuild an image and tag it locally using Make:
make <tag>
make ubuntu20.04-v2.1_beta5
make build # to build all images
make push # to push all images