This project provides a docker image to run a jupyter notebook server with essentia, freesound-python and a set of python dependencies commonly used in Music Information Retrieval (MIR).
You can build the image by running
make build
This will build the image and tag it as mtgupf/mir-toolbox
.
Alternatively, you can pull the latest version of the image from docker hub.
Run the image with no arguments to start a Notebook server as root:
docker run --rm -p 8888:8888 mtgupf/mir-toolbox
You can access the notebook at http://localhost:8888, use the password mir to log in.
If you want to access a notebook from your host machine, mount a volume pointing
to /notebooks
inside the container
docker run --rm -p 8888:8888 --mount type=bind,source=$(pwd),target=/notebooks mtgupf/mir-toolbox
ensure that the source
location in the --mount
option is an absolute path.
On linux, running jupyter-notebook as root means that any new files that you
create will be owned by root. To prevent this from happening, you can set an
environment variable, JUPYTER_USER_ID
to a UID which will be used to run
the notebook in the container. You can set this to the UID of your local user:
docker run --rm -e JUPYTER_USER_ID=$(id -u) -p 8888:8888 --mount type=bind,source=$(pwd),target=/notebooks mtgupf/mir-toolbox